User Flow

This document provides a comprehensive explanation of the user journey, features, and interactions on our site, detailing the flow from onboarding to the forging of the Medals. Each section is expanded to include the relevant checks, processes, and modals involved in the experience.

The flow is designed around access, provenance, recognition, and project-specific perks. It does not create holder economics, holder payments, company ownership, or governance control.

User Journey Overview#

Step 1: Accessing the Website#

Entry Page

• On entering the site, users are presented with a Cookies Modal to approve or decline.
• The modal includes direct links to the Privacy Policy and Terms of Service for transparency and compliance.

Homepage

• Users land on the Homepage, greeted by an interactive UI centered on the theme of “THE FORGE – Medals of Honor”.
• A Connect Wallet button is displayed in the forging area.

Step 2: Wallet Connection#

Connect Wallet Options

• Supported Wallets: MetaMask, WalletConnect, and local wallets.
• A Thirdweb modal is used for wallet selection.
• Upon successful wallet connection:
  • The wallet address is not openly displayed, helping protect user privacy.
  • The system checks for an existing holder profile in the database to determine access level.
  • Access to core features is unlocked, including:
    • Forging Medals.
    • Interacting with the Transak Widget for Fiat-to-Crypto onboarding.
    • Using the collection management tools.
    • Creating a guest wallet for users without an external wallet.
  • The holder profile and wallet balances are fetched in real time, so holders can manage their collection and track their tier status and perks.

Wallet Check Outcomes

• New User: redirected to create a holder profile.
• Returning User: the holder profile and wallet balances are fetched, including BNB and XDRIP Token balances.

Guest Wallet Creation

• Overview:
  • Users without an external wallet can create a guest wallet during onboarding.
  • The guest wallet is a temporary solution tied to the user’s email or phone number.
• Usage:
  • Fully functional for Medal forging and collection features.
  • Users are encouraged to migrate to a permanent wallet for better security.
• Migration Process:
  • Export the guest wallet’s private key or transfer assets to a permanent wallet.
  • Step-by-step guidance is provided in the Holder Dashboard.

Step 3: Profile Creation and Verification#

Profile Page#

Fields include “Full Name”, “Email”, and “KYC Status”.

Dynamic Adjustments by Territory#

During profile creation, the system dynamically adjusts the presented agreements and compliance requirements based on the user’s geographical location.

Examples:

• UK Users: shown any additional compliance disclosures required by local regulations.
• EU Users: data-privacy and GDPR-compliant agreements are highlighted.
• Other Regions: custom agreements tailored to regional regulations are dynamically fetched and shown.

These adjustments ensure all users view the relevant legal and compliance material based on their location.

KYC Verification#

• For General Medals KYC is optional.
• For Forging the Eternal Medal KYC approval is mandatory.
• Statuses:
  • Approved: full access to all Medals, including Eternal.
  • In Review: user notified that the Eternal Medal cannot be forged until approval.
  • Rejected: clear instructions to contact support for assistance.

Step 4: Accessing Features#

Holder Dashboard#

• Available Features:

  • View Medals forged.
  • Check Wallet Balances (BNB, XDRIP).
  • View tier status and the perks tied to each Medal.

• Wallet checks dynamically enable or disable specific actions based on eligibility. For example:

  • Forging higher-tier Medals requires the prerequisite Medals to be owned.
  • Access to the Transak widget for Fiat-to-Crypto onboarding requires a connected wallet and a created holder profile.
  • These checks also determine whether users can initiate direct forging transactions or need to complete additional steps, such as KYC verification for specific Medals.

Vault Actions Dropdown#

• Options include:
  • Holder Profile: display profile details.
  • KYC Verification: quick link to the KYC page.
  • Access Transak: Fiat-to-Crypto onboarding.
  • Collection Wallet: a detailed view of your holdings.

Step 5: Forging Medals#

The Forge Section#

An interactive carousel showcases all Medal types available for forging. Each Medal displays dynamic information fetched directly from the blockchain, including:

• Price: displayed in BNB, with a real-time conversion to USD for convenience.
• Tier & Perks: the tier of the Medal and the documented perks it unlocks.
• XDRIP Bonuses: any additional recognition perk tied to the specific Medal.
• Inventory Status: the number of Medals forged and remaining availability, in real time.

Eligibility Checks#

The system runs prerequisite checks to enforce the Medal forging rules:

• To forge an Uncommon Medal, users must already own at least one Common Medal.
• For the Eternal Medal, additional criteria include:
  • KYC Approval.
  • Sufficient BNB balance (50 BNB).

Payment Modal#

Pay with Crypto#

• The modal calculates the BNB required for the selected Medal and displays it.
• Real-time gas estimation is fetched to ensure transaction feasibility.
• Upon confirmation, the system sends the transaction data (Medal type and IPFS hash) to the forging smart contract.
• The contract forges the Medal, deducts the required BNB, and deposits the forged Medal into the user’s connected wallet.
• A receipt is generated and emailed to the user for their records.

Transak Widget Integration#

This widget provides Fiat-to-Crypto onboarding where users can acquire BNB to manually initiate forging. Users:

• Select the required amount of BNB for Medal forging.
• Complete the Fiat-to-Crypto conversion using supported payment methods.
• Use the acquired BNB to proceed with the manual forging process.

Transak One (Future Integration)#

When implemented, Transak One will automate the Fiat-to-BNB conversion directly tied to the forging process. On Medal selection and clicking “Pay with Transak One”, the system will:

• Automatically calculate and process the BNB conversion required for the transaction.
• Send the transaction data (Medal type, IPFS hash, payment details) to the smart contract.
• Forge the Medal and deposit it directly into the user’s wallet, without additional steps.

Transak Integration#

Why Transak#

Transak simplifies acquiring the cryptocurrency required to forge Medals. It is especially useful for:

• New Users: those unfamiliar with cryptocurrencies who need a seamless way to onboard Fiat to BNB.
• Experienced Users: streamlining crypto acquisition for faster Medal forging.

Integration Details#

Transak Widget: supports Fiat-to-BNB conversion, accessible manually through the “Vault Actions” dropdown. Users can onboard funds and manually initiate forging.

Transak One (Future Integration):

• Blockchain Communication: Transak One will interact directly with blockchain protocols, automating Fiat-to-crypto onboarding and forging.
• Smart Contract Interactions automate Medal forging by:
  • Sending converted BNB directly to the forging smart contract.
  • Passing required metadata (Medal type, IPFS hash, price) for DOT forging.
• User Experience: eliminates manual steps by integrating payment and forging into a single, streamlined transaction.

Technical Flow When the Forge Is Triggered#

When a user confirms forging a Medal:

Data Sent to the Contract:

• Medal type (e.g., Common, Uncommon, Rare, …).
• IPFS hash containing metadata for the specific Medal.
• Payment amount (in BNB or other specified token).

Smart Contract Actions:

• Validate user eligibility based on prerequisites (e.g., ownership of previous Medals).
• Deduct payment and forge the Medal as a new DOT.
• Update the inventory count and the user’s Medal balance.
• Emit events for transaction tracking and transparency.

Benefits of Transak Integration#

• Accessibility: removes the need for external exchanges (CEXs), letting users acquire BNB directly on the platform.
• Streamlined Process: combines payment and forging into a single, seamless action.
• Secure and Transparent: all transactions are processed securely on the blockchain, with clear notifications at every step.

---

Compliance Modals#

• Privacy Policy & Terms of Service: displayed during wallet connection and payment processes.
• Cookies Modal: shown on the entry page; users can approve or decline cookies; includes links to Privacy Policy and Terms of Service.
• Regional Compliance Modal: triggered for users in regions with specific requirements, presenting the applicable legal disclosures and compliance requirements.

Error Handling#

Common Errors

• Insufficient Funds: users are notified if BNB or XDRIP balance is insufficient, with an option to onboard funds via Transak.
• Prerequisite Medals Missing: a clear message indicates which Medal(s) are required.
• KYC Status: users are guided on how to resolve KYC issues (e.g., incomplete or rejected applications).

Real-Time Updates

• Notifications inform users of transaction success or failure.
• Wallet and profile data auto-refresh after each action.

---

Additional Notes#

• The Eternal Medal is a unique, premium collectible, emphasizing exclusivity and recognition.
• All actions are secured via blockchain transactions, ensuring transparency and traceability.
• Once introduced, Transak One is expected to integrate with wallet connection and forging to enhance the journey: it will convert Fiat to BNB, process the forging transaction, and deposit the forged Medal directly into the user’s wallet. This reduces complexity for new users while offering a faster path for experienced ones.
• The site’s design prioritizes user experience, with intuitive navigation and helpful prompts.