This document provides a comprehensive explanation of the user journey, features, and interactions on our site, detailing the flow from user onboarding to the forging of the medals. Each section has been expanded to ensure clarity and to include all relevant checks, processes, and modals involved in the experience.
User Journey Overview #
Step 1: Accessing the Website #
Entry Page
- Upon entering the site, users are presented with a Cookies Modal requiring approval 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 and visually appealing 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.
- Thirdweb modal is used for wallet selection.
- Upon successful wallet connection:
- Wallet address is not openly displayed, ensuring user privacy.
- System checks for user profile existence in the database to determine the user’s access level.
- Access to core features is unlocked, including:
- Forging medals.
- Interacting with the Transak Widget for Fiat-to-Crypto onboarding.
- Utilizing advanced investor tools.
- Creating a guest wallet for users without an external wallet.
- Profile and wallet balances are fetched in real-time, enabling users to manage their investments and track revenue share metrics effectively.
Wallet Check Outcomes
- New User: redirected to create an investor profile.
- Returning User: User’s 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 investment features.
- Users are encouraged to migrate to a permanent wallet for better security.
- Migration Process:
- Export guest wallet’s private key or transfer assets to a permanent wallet.
- Step-by-step guidance provided in the Investor 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 additional compliance disclosures required by UK financial regulations.
- Specific agreements tied to UK compliance laws are displayed, ensuring adherence to local regulatory standards.
- 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 #
Investor Dashboard #
- Available Features:
- View medals forged.
- Check Wallet Balances (BNB, XDRIP).
- Access revenue share metrics for applicable medals.
- Wallet checks dynamically enable or disable specific actions based on eligibility criteria. For example:
- Forging higher-tier medals requires prerequisite medals to be owned.
- Access to the Transak widget for seamless Fiat-To-Crypto onboarding is contingent on a connected wallet and created investor 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 #
- Includes Options Like:
- Investors Profile: display profile details.
- KYC Verification: Quick link to the KYC page.
- Access Transak: Seamless Fiat-to-Crypto Onboarding.
- Investor Wallet: A detailed view of holding and investments.
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 user convenience.
- Revenue Share Percentage: indicates the user’s share of the revenue pool.
- XDRIP Bonuses: any additional reward tied to the specific medal.
- Inventory Status: tracks the number of medals forged and remaining availability in real-time.
Eligibility Checks #
The system conducts prerequisite checks to ensure compliance with 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 (200 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 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 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.
Upon Medal selection 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 requiring additional users steps.
Transak Integration #
Why Transak #
Transak is integrated into the platform to simplify the process of acquiring the required cryptocurrency for forging medals. This feature is particularly beneficial for:
- New Users: those unfamiliar with cryptocurrencies who need a seamless way to onboard Fiat to BNB.
- Experienced Users: streamlining their crypto acquisition process for faster medal forging.
Integration Details #
Transak Widget:
This widget supports Fiat-to-BNB conversion, which users can access manually through the “Vault Actions” dropdown. Users can use this feature to onboard funds and manually initiate forging.
Transak One Future Integration:
Blockchain Communication: Transak One will directly interact with blockchain protocols, automating Fiat-to-crypt onboarding and forging processes.
Smart Contract Interactions:
- Automates Medal forging by:
- Sending converted BNB directly to the forging smart contract.
- Passing required metadata (Medal type, IPFS hash, price) for DOT (Digital Ownership Token) 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 medals as a new DOT.
- Update the inventory count and the user’s medal balance.
- Emit events for transaction tracking and transparency.
Future Integration with Transak One: #
Once implemented, Transak One will automate the Fiat-to-BNB conversion and seamlessly pass the required payment details to the smart contract. This integration will:
- Eliminate the need for manual crypto purchases.
- Provide a streamlined, user-friendly experience.
- Ensure secure, transparent interactions directly with the blockchain.
User Flow #
Option 1: Vault Actions Dropdown (Transak Widget) #
Access the Transak Widget via the vault Actions dropdown.
Steps:
- Specify the BNB amount required.
- Select a payment method (credit card, bank transfer, etc.).
- Transak processes the transaction, and the acquired BNB is credited to the user’s wallet.
- The user can then manually proceed to forge medals using their acquired BNB.
Option 2: Transak One (Future Integration) #
Integrated directly with the Forge button.
Steps:
- The user selects a Medal and clicks “Forge”.
- Chooses the “Pay with Transak One” option in the payment modal.
- Transak One will automatically:
- Convert Fiat to BNB in real time.
- Execute the forging transaction via the smart contract.
- Forge the Medal and deposit it directly into the user’s wallet.
Benefits of Transak Integration #
Accessibility: removes the need for external exchanges (CEXs) enabling users to acquire BNB directly on the platform.
Streamlined Process: combines payment and forging into a single, seamless action.
Secure and Transparent: ensures 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.
- UK Compliance Modal
- Triggered for UK-based users accessing investor sections.
- Content:
- Legal disclosures.
- Regulatory compliance requirements.
Error Handling #
Common Errors
- Insufficient Funds:
- Users are notified if BNB or XDRIP balance is insufficient.
- Option to onboard funds via Transak.
- Prerequisite Medals Missing:
- Clear message indicating 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 post-action.
Additional Notes #
- The Eternal Medal serves as a unique offering, emphasizing exclusivity and compliance.
- All actions are secured via blockchain transactions, ensuring transparency and traceability.
- Transak One is expected to seamlessly integrate with wallet connection and forging processes to enhance the user journey once introduced, providing a streamlined experience. Upon connecting their wallet, users can leverage this feature to eliminate the manual steps of acquiring cryptocurrency. Transak One will be designed to automatically convert Fiat to BNB, process the forging transaction, and deposit the forged Medal directly into the user’s wallet once implemented. This streamlined experience ensures accessibility for new users unfamiliar with crypto while offering a faster, hassle-free solution for experienced users. By reducing complexity and integrating payment directly with forging actions, Transak One makes Medal acquisition both efficient and user-friendly.
- The site’s design prioritizes user experience, with intuitive navigation and helpful prompts.
