YourGrails Docs
Everything you need to know about collecting, trading, and battling with real graded cards on the blockchain.
Welcome to YourGrails
The tokenized graded card exchange on Avalanche.
YourGrails is a platform where real, professionally graded trading cards — from Pokémon to One Piece — are stored in insured vaults and represented as NFTs on the Avalanche blockchain. Buy packs, reveal cards, trade on the marketplace, battle other collectors, or request specific cards through our concierge sourcing service.
Real Cards
PSA, BGS & CGC graded cards in secure vault storage
Ship Anytime
Request physical delivery of any card you own
90% Buyback
Guaranteed buyback within 7 days of reveal
Getting Started
Up and running in under a minute.
Connect Your Wallet
Get Test USDC (Testnet)
Browse & Buy Packs
Reveal & Collect
Packs & Opening
Multiple tiers with transparent odds and finite supply.
Pack Tiers
How Buying Works
1. Approve USDC — grant the GachaPacks contract permission to spend the pack price.
2. Buy Pack — call buyPack on-chain. A commit hash is stored.
3. Receive Pack NFT — an ERC-721 PackNFT is minted to your wallet, representing an unrevealed pack.
Reveal Flow
We use a commit-reveal randomness scheme:
• On purchase, a commit is recorded with the current block info.
• When revealing, you provide a salt that is combined with the blockhash of the commit block.
• This produces a verifiably random card assignment — preventing front-running and miner manipulation.
Odds & Transparency
Each pack tier has clearly displayed odds based on value tiers. Higher-tier packs have better chances at rare, high-value graded cards.
Odds are shown on each pack's detail page before purchase so you always know what you're getting into.
Finite Supply
Every pack has a limited inventory. Once a pack tier sells out, it's gone.
Each pack contains 1 graded card (configurable per pack tier). The inventory is tracked on-chain.
Cards & Grading
Real graded cards, tokenized and verifiable.
Every card on YourGrails is a real, professionally graded card authenticated by PSA, BGS, or CGC. Cards are stored in our insured, climate-controlled vault and represented as ERC-721 NFTs on Avalanche C-Chain.
Card Metadata
• TCG: Pokémon, One Piece, and more
• Set Name: The card's set (e.g., Base Set, Scarlet & Violet)
• Card Number: Collector number within the set
• Grade: PSA 10, BGS 9.5, CGC 9, etc.
• Cert Number: Verifiable certification ID
Vault Storage
All physical cards are stored in a secure, insured vault.
Cards are protected against theft, damage, and environmental factors.
You can request shipment at any time — once shipped, the NFT is burned.
Card Images
Each card NFT includes high-resolution images:
• Front — the card face
• Back — the card reverse
• Slab — the full graded slab photo
Marketplace
Buy and sell graded cards with escrow-based security.
The YourGrails marketplace uses an escrow-based smart contract. When you list a card, the NFT is transferred to the marketplace contract and held securely until the card is sold or you cancel the listing.
For Sellers
• List a card — set your price in USDC. The NFT moves to escrow.
• Update price — change your asking price anytime.
• Cancel listing — get your NFT back instantly.
• A platform fee (configurable BPS) is deducted from sale proceeds.
For Buyers
• Browse listings on the Market page.
• Approve USDC for the marketplace contract.
• Buy — USDC is sent to the seller (minus fee), NFT is sent to you.
• All transactions are on-chain and verifiable.
Buyback Guarantee
Don't like your pull? Get 90% back.
90% Buyback Protection
Within 7 days of revealing a pack, you can sell any card back to the platform for 90% of its appraised value. This is funded by the platform's USDC reserve and executed entirely on-chain.
How It Works
Approve NFT
Execute Buyback
executeBuyback on-chain. The contract verifies the 7-day window and card eligibility.Receive USDC
Card Sourcing (Concierge Service)
Request any card. We'll find it for you.
Can't find the card you want? Our Concierge Service lets you create a sourcing request with a wishlist and USDC budget. Our team scours eBay, PWCC, and other marketplaces to find exactly what you're looking for.
Sourcing Flow
Create Request
Receive Quotes
Accept or Reject
Card Delivered
Budget Management
• Unused funds can be withdrawn anytime.
• Cancel your request to get all unallocated funds back.
• Budget is held in the SourcingEscrow smart contract.
Quote Expiry
Quotes have an expiry period to prevent your funds from being locked indefinitely.
If a quote expires without fulfillment, the locked funds are released back to your budget.
Pack Battles (PvP)
Head-to-head pack opening competitions.
Battle Arena
Create a battle lobby, choose a pack tier, and deposit an entry fee. Share the link with a friend (or rival!) — both players open packs simultaneously in a split-screen arena. The higher value card wins the prize pool bonus!
How Battles Work
1. Create Lobby — pick a pack tier & deposit entry fee.
2. Opponent Joins — they deposit their entry fee too.
3. Reveal Together — both packs open simultaneously.
4. Winner Takes Bonus — higher value card wins the prize pool.
Prize Pool
• Prize pool = entry fees from both players.
• Platform takes a small cut.
• Tie? Prize pool is split 50/50.
• Both players keep their cards regardless of outcome!
Leaderboard
• Wins — total battle victories
• Win Streak — current consecutive wins
• Total Winnings — lifetime USDC earned
• Best Pull — highest value card from battles
• Weekly and all-time rankings
Profiles & Social
Show off your collection and battle stats.
Customizable Profiles
• Username & Display Name — your identity on the platform.
• Bio — tell the world about your collection.
• Avatar — upload a custom profile picture.
• Win Streak Badges — flex your battle record.
Public Profile Pages
Every user has a public profile page showing:
• Card collection
• Marketplace activity
• Battle stats & history
• Win streak & badges
Notifications
Stay in the loop with real-time updates.
YourGrails uses Server-Sent Events (SSE) for real-time notifications. You'll never miss an important event.
Notification Types
• 🃏 Pack Revealed — your card has been assigned
• 💰 Card Sold — a marketplace sale completed
• 📋 Quote Received — a sourcing quote is ready
• ✅ Quote Fulfilled — your sourced card has arrived
• ⚔️ Battle Results — battle outcome and prize info
Notification Controls
• Bell Icon — shows unread count in the header.
• Mark as Read — dismiss individual notifications.
• Mark All as Read — clear all unread notifications at once.
Live Activity Feed
Watch the platform come alive in real-time.
The homepage features a live activity feed showing real-time platform events — pack openings, marketplace sales, and battle results. High-value reveals trigger a special "BIG PULL" golden glow animation.
Pack Openings
See what others are pulling
Sales
Live marketplace transactions
Battles
Battle outcomes & winners
BIG PULL Alerts
High-value reveals get a special golden glow animation visible to everyone on the platform, plus a viewer count badge showing how many people witnessed the pull.
Smart Contracts
Transparent, auditable on-chain infrastructure.
Contract Architecture
CardNFT
ERC-721 — tokenized graded cards
GachaPacks
Pack purchasing & commit-reveal
PackNFT
ERC-721 — unrevealed pack tokens
MarketplaceEscrow
Listing, buying, cancelling with escrow
Buyback
Guaranteed buyback execution
SourcingEscrow
Budget management for sourcing
PackBattleV2
PvP pack battle system
Contract Addresses (Fuji)
0xd59cFd2Cf50e7A0c510F2A544542B976889Bc0360xDbA51f93689E4cED8aE9Cb024e4D848938475ce10x5f6ef8013A5972Be23C4Ea2E8eC43a72fC7eFfC20x34BcDD89e08E93226d0f7b8d5f0Bb30AF9a36cb10xfcd56331E3757D3549749Cf02FC6aED34A7721D30xF70239574FC9D6C928bf92f037B458C5173d6e4fSecurity Standards
Security
Built with safety as a first principle.
Escrow Marketplace
When you list a card, the NFT is held by the smart contract — not another user. This eliminates counterparty risk entirely.
Commit-Reveal Randomness
Pack reveals use a commit-reveal scheme to prevent front-running. The outcome can't be predicted or manipulated before the reveal transaction.
Reentrancy Guards
All contracts that handle fund transfers use OpenZeppelin's ReentrancyGuard to prevent reentrancy attacks.
Access Control
Admin operations use OpenZeppelin AccessControl with role-based permissions. No single key has unrestricted access.
Wallet Authentication
Admin actions require wallet signature authentication, ensuring only authorized wallets can perform privileged operations.
Quote Expiry
Sourcing quotes have expiry periods so your funds are never locked indefinitely. Expired quotes automatically release locked funds.
Frequently Asked Questions
Are the cards real?
Yes. Every card on YourGrails is a real, professionally graded card (PSA, BGS, or CGC) stored in our insured, secure vault. The NFT you hold represents 1:1 ownership of that physical card.
Can I get my physical card shipped to me?
Yes. You can request shipment of any card you own at any time. Once shipped, the NFT is burned and the physical card is sent to your address via insured shipping.
What blockchain is YourGrails on?
YourGrails runs on Avalanche C-Chain. We currently operate on the Fuji Testnet during our beta phase, with mainnet launch planned.
What wallet do I need?
We support MetaMask, Core Wallet, and embedded wallets via Privy. You can even sign up with email and a wallet will be created for you automatically.
How does the buyback work?
Within 7 days of revealing a pack, you can sell any card back to the platform for 90% of its appraised value. This is executed on-chain — simply approve the NFT transfer and the USDC is sent directly to your wallet.
How is pack randomness ensured?
We use a commit-reveal scheme based on blockhashes. When you buy a pack, a commit is recorded. When you reveal, you provide a salt that combines with the blockhash to determine your card. This prevents front-running and manipulation.
What are Pack Battles?
Pack Battles are PvP contests where two players each open a pack simultaneously. The player whose card has a higher value wins a bonus from the prize pool. Both players keep their revealed cards regardless of the outcome.
Is there a fee for marketplace sales?
Yes, there is a small platform fee on marketplace sales (configured in basis points). The fee is deducted from the sale proceeds automatically by the smart contract.
What is Card Sourcing?
Our Concierge Service lets you request specific cards. Deposit a USDC budget, and our team will source the card from eBay, PWCC, and other marketplaces. Once found, you approve the purchase and the card is minted as an NFT to your wallet.
What happens if I lose a Pack Battle?
You still keep the card you revealed! The only thing at stake is the entry fee bonus. The "loser" simply doesn't receive the prize pool bonus, but their card is theirs forever.
Built on Avalanche · Powered by YourGrails