📚Reference

Complete User Journey, Visual Logic, and Integration Framework

This section provides a bird’s-eye view of the Xtrends ecosystem — how users move through the platform, how pages connect behind the scenes, and how external tools or partners can integrate with the system.

It combines:

  • End-to-end User Journeys

  • Visual Flowcharts & UX Maps

  • High-level API & Integration architecture

🧭 1️⃣ End-to-End User Journeys

A. Trader Journey

Goal: Discover and trade trending coins.

Step
Action
Outcome

1️⃣

Connect Solana wallet

Enables account linking and permissions

2️⃣

Browse Trending Hub

View all trends — Available, Owned, or Launched

3️⃣

Buy or Make Offer

Acquire trend NFT or bid via escrow

4️⃣

Trade after Launch

Swap trend coins via integrated DEX

5️⃣

Track Portfolio

View PnL, balances, and holdings in real time

6️⃣

Repeat & Monitor

Follow Leaderboard and pin favorite trends

Traders experience a fully on-chain, zero-trust flow — from discovery to trade to analytics.

B. Creator Journey

Goal: Launch, earn, and manage trend coins.

Step
Action
Outcome

1️⃣

Buy Trend NFT

Acquire ownership rights for 1 SOL

2️⃣

Verify & Configure

Upload image, confirm name

3️⃣

Add Liquidity (≥1 SOL)

Sets launch price and depth

4️⃣

Choose Launch Type

Instant or scheduled

5️⃣

Confirm Launch

Coin deploys, dynamic fees start

6️⃣

Claim Rewards

SOL earnings accumulate and are claimable anytime

7️⃣

Track in #Owned → Active

Monitor volume, burns, and bids

Every creator action is on-chain — transparent, traceable, and revenue-generating.

C. Reseller Journey

Goal: Resell trend NFTs to new creators.

Step
Action
Outcome

1️⃣

Set Ask Price

Auto-lists NFT on Pre-Owned tab

2️⃣

Receive Offers

Buyers bid through escrow

3️⃣

Accept Offer

Ownership transfers instantly

4️⃣

SOL Credited

Escrow releases payment on acceptance

No listing fees, no middlemen — resale logic is entirely smart-contract-driven.

🔄 2️⃣ Flowcharts & UX Maps

Below are simplified flow representations of Xtrends’ major user actions and smart contract logic.

A. Buying / Ownership Flow

Search → Buy Trend (1 SOL) → NFT Minted → Added to Wallet → Appears in #Owned (Inactive)

B. Launch Flow

Own Trend NFT
     ↓
Verify & Upload Image
     ↓
Add Liquidity (≥1 SOL)
     ↓
Confirm Launch
     ↓
Dynamic Fee Phase (50%→1%)
     ↓
Coin Live & Tradable

C. Offer Flow

Buyer → Makes Offer (SOL → Escrow)
          ↓
Owner → Accepts / Declines
          ↓
If Accepted → NFT + SOL Swap Automatically
If Declined → SOL Refunded

D. Trading Fee Cycle

Trade Occurs
   ↓
Fee Collected (Variable %)
   ↓
50% → Creator Wallet (SOL)
50% → Burn Wallet (Trend Token)

E. Claim Cycle

Trading Volume ↑ → Creator Fee Balance ↑
       ↓
Creator Clicks “Claim”
       ↓
SOL Sent Instantly to Wallet

F. Anti-Snipe / Fair Launch Flow

Launch Initiated
   ↓
Randomized 99% Fee (0–6s)
   ↓
Random 3–6 Block 100% Fee Window
   ↓
Gradual Decay to 1%
   ↓
Fair Entry for All Traders

These visual flows can be converted into UX diagrams or system maps for GitBook illustrations.

🧩 3️⃣ API & Integration Overview

Xtrends’ architecture is designed to allow future integration with analytics tools, Solana explorers, and DEX frontends via secure, read-only endpoints.

Layer
Function
Example Integration

Smart Contracts (On-Chain)

Core logic for launch, trade, claim, and burn

Verified via Solana RPC & Explorer

Public APIs (Read-Only)

Retrieve data for leaderboards, burns, and creator fees

Used for external dashboards

Webhook Layer (Future)

Notify creators of volume spikes or bids

Optional push notifications

DEX Integration

In-app swaps via Solana liquidity pools

Jupiter / Raydium connectors

Explorer Links

On-chain proof for all transactions

Solscan / Solana.fm URLs

The API layer is modular — third parties (trackers, analytics, influencers) can integrate easily without backend access.

💡 Developer & Integration Notes

  • Network: Solana mainnet

  • Wallets Supported: Phantom, Backpack, Solflare, OKX Wallet

  • Data Source: Direct RPC + WebSocket feeds for real-time events

  • Explorer Proof: Every launch, claim, and burn tied to a verifiable transaction

  • Smart Contract Model: Immutable, auditable, and non-upgradeable

Developers can build leaderboards, charts, or watchlists directly using on-chain calls — no permission required.

✅ Summary

Component
Purpose

End-to-End Journeys

Explain user flow from discovery to trading

Flowcharts & UX Maps

Visualize system logic and smart contract flow

API & Integration Layer

Enable third-party tools and analytics access

The Reference Section connects everything — bridging user experience, system logic, and technical transparency.

Whether you’re a creator, trader, or developer, this is your complete blueprint for understanding how Xtrends operates — end-to-end.

PreviousSecurity, Fairness & Anti-exploit

Last updated