⚒ ADMIN ACCESS REQUIRED
ADMIN
PANEL
PANEL
Connect your authorized admin Xaman wallet
to access the claims dashboard.
to access the claims dashboard.
Click CONNECT to generate sign-in QR
📱 Open in Xaman app
⚒ COMIC CLAIMS DASHBOARD
—
TOTAL CLAIMS
—
PENDING SHIP
—
FULFILLED
| # | Date | Name | X Handle | Wallet | Token ID | Comic | Shipping Address | Ship TX | Status | Action | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Loading... | |||||||||||
🎬 CLAIM PORTAL — USER WALKTHROUGH
💡 This is a preview of exactly what a comic holder experiences when they visit claim-comics.html. Use this to demo the flow to anyone without needing a real wallet.
1
CONNECT XAMAN WALLET
The page opens to a lock screen. The user clicks CONNECT XAMAN. A Xaman sign-in QR appears — they scan it with the Xaman mobile app and approve the SignIn request. No transaction is signed at this step; it only proves wallet ownership.
Backend: POST /api/comics/signin → poll GET /api/comics/signin/:uuid → issues a 7-day JWT
2
VIEW THEIR UGA-BUGA COMIC NFTs
The XRP Ledger is scanned for NFTs issued by rUGAXgsomgn6S375dBnP5vtgmZkLbPLs95. Each one appears as a card showing the comic cover image, serial number, and a banner preview they can download. Already-claimed NFTs show a green ✓ stamp.
Backend: GET /api/comics/nfts/:account
3
CLICK “CLAIM THIS COMIC”
A modal opens. The user enters their full shipping address. They click GET SHIPPING ESTIMATE — the server fetches the live XRP/USD price from CoinGecko and returns a rate based on their country.
Backend: POST /api/comics/shipping-rate (no auth)
4
REVIEW SHIPPING ESTIMATE
Step 2 of the modal shows the estimated cost in USD and XRP (carrier + +1 XRP safety buffer). Rates are based on real FedEx / UPS published rates for a 1 lb comic mailer:
• US Domestic — $9.99 (FedEx Home Delivery)
• Canada / Mexico — $22.99 (FedEx Intl Economy)
• Europe — $32.99 (FedEx / UPS Standard)
• International — $42.99 (FedEx Intl Priority)
• US Domestic — $9.99 (FedEx Home Delivery)
• Canada / Mexico — $22.99 (FedEx Intl Economy)
• Europe — $32.99 (FedEx / UPS Standard)
• International — $42.99 (FedEx Intl Priority)
5
PAY SHIPPING IN XRP VIA XAMAN
Clicking PAY SHIPPING & CLAIM creates a Xaman XRP payment payload to the admin wallet. A QR appears — the user scans it and approves the XRP payment in Xaman. Once signed, the claim is submitted automatically.
Backend: POST /api/comics/shipping-pay → poll GET /api/comics/shipping-pay/:uuid
6
CLAIM CONFIRMED + NFT UPDATED ON-CHAIN
The backend runs NFTokenModify using the minter wallet to update the NFT’s URI to the claimed variant image. The claim record (name, address, wallet, token ID, shipping TX hash) is saved to the server. The user sees a success screen. Their NFT now shows the ✓ CLAIMED stamp permanently.
Backend: POST /api/comics/claim (JWT auth) → NFTokenModify on XRPL → saved in comics-claims.json
7
ADMIN: MARK AS SHIPPED (THIS PANEL)
Once you physically ship the comic, come back to the CLAIMS tab above and click ✓ Mark Shipped on that row. It logs the fulfillment timestamp and moves the claim to FULFILLED status.
Backend: POST /api/comics/admin/claims/:id/fulfill (admin JWT required)
🎨 IMAGE GEN TEST
Test meme generation as admin — no $UGA charge. Uses the same fal.ai Seedream pipeline as real users.