YourGrails Docs

Each revealed card is represented by a CardNFT tied to a real graded card. The app stores cert data, grading company, images, current market value, and ownership state.

Packs, battles, marketplace purchases, buybacks, and lending use Avalanche smart contracts. The backend indexes events and keeps the app state readable for users.

Users see normal product language like fair draw, market value, instant buyback, offer, and extra time. The technical details stay available here for anyone who wants to understand the system.

Pokemon Pro Pack is the lower-priced pack tier.

Pokemon Master Pack is the higher-priced pack tier.

Pack pages show current expected pull value, buyback percentage, and compact value-tier odds based on the cards currently seeded into that pack.

Users can buy multiple packs in one checkout on Avalanche. After purchase, the reveal session opens pack 1 of N, then pack 2 of N, until the whole session is complete.

At the end, users see a clean summary of all pulled cards, total market value, and available buyback amounts.

Pack odds and expected value are based on the seeded cards and market prices stored by the platform. Admin tools monitor EV, pull risk, and pack health so inventory can be reseeded before the user experience degrades.

Pack credits and one-time coupon codes can redeem free packs when enabled. Coupon codes are issued for a specific pack and are protected by backend reservation plus on-chain one-time redemption.

Circle CCTP burns source-chain USDC, waits for Circle attestation, then mints USDC on Avalanche. The Avalanche receiver contract uses the message hook to buy packs or enter battles for the user.

The app polls status automatically and recovers from already-processed destination messages by looking up receiver logs.

Cross-chain checkout is wired for pack purchases, multi-pack orders, battle creation, and battle joining where the UI offers the route.

Coupon redemptions are Avalanche-only because the user pays gas for the free-pack redemption transaction.

When enabled, users with low Avalanche gas can choose to include a small AVAX gas credit with a cross-chain purchase. The receiver contract uses its AVAX balance and configured rules to send the user gas.

The app should switch to the source chain before source-chain approval or burn, then switch back to Avalanche for reveal and collection actions. It should not reload the page for normal chain changes.

Instant buyback is intended for original qualifying purchasers. It can apply to normal pack pulls, CCTP pack pulls, coupon pulls when the campaign allows it, and battle participant cards when the purchase path is verified.

Marketplace purchases and transferred cards are not treated as original pack purchases for instant buyback.

The buyback window is 7 days after reveal. The app shows days, hours, and minutes remaining where buyback is available.

The standard payout is 90% of the appraised market value, subject to reserve, voucher, and eligibility checks.

The user approves the card NFT if needed, confirms the buyback, receives USDC, and the card returns to platform inventory. The same physical card can become eligible again if it is later seeded, pulled by a qualifying buyer, and sold back again through a new eligible purchase path.

Buyback vouchers and contract state are tied to the card, owner, purchase path, timing, and settlement status. A completed buyback burns or transfers the relevant ownership path so the same eligible pull cannot be sold back repeatedly.

A user creates a battle for a specific pack. Another player or the YG Battle Bot joins. Each side reveals a pack through the Chainlink fair draw flow.

Both players keep their own revealed battle card. The higher market value wins the bonus pack.

After both battle cards are revealed, the system resolves the winner and requests the bonus pack reveal. The UI shows the bonus pack opening flow and then slides the bonus card to the winner side.

If a player does not reveal in time, the battle can continue through the timeout reveal process. The UI should show that the missed reveal is being handled and keep the pack animation visible instead of leaving users at a silent countdown.

Battle participants can use instant buyback for cards they own when eligibility is confirmed. Buyback actions should be available directly from the battle result view for the card owner.

Sellers list a card at a buy-now price. The card NFT is approved and moved into marketplace escrow so the buyer can receive it when the purchase settles.

Sellers can cancel active listings and get the card back from escrow.

The app uses offer language instead of bid language. Buyers deposit USDC into their offer balance and place offers on listed cards.

If an offer is above the buy-now price, the UI warns the buyer before placing it.

Offer notifications should take sellers directly to the card detail view where they can review and accept the offer. Listed cards in collection should remain clickable for details.

Marketplace filters include grading company options such as PSA, BGS, and CGC, plus other listing filters as configured in the UI.

The navbar shows USDC balance only when a wallet is connected. The wallet page shows USDC and native AVAX balances for the configured Avalanche network.

Users can copy their address for deposits, send USDC, and send AVAX. Transfers happen from the connected wallet and should be confirmed in the wallet prompt.

Referral codes grant invite access when redeemed. User-unlocked referral codes are single-use and can be shared from the profile page with copy and social sharing tools.

Admin settings control unlock thresholds and how many codes are unlocked per threshold.

Paid pack opens, battles, coupon pulls, and completed lending repayments can award points depending on configured rules. Lending points are based on principal amount at an admin-configured rate.

Free pack rewards are based on the configured paid opens per free pack setting.

Admin-created KOL coupon codes are one-time use, pack-specific, HMAC-hashed in storage, and redeemed with an EIP-712 voucher. The contract marks coupon ids used on-chain to prevent replay.

Pack credits let users redeem a free pack from supported reward flows. They are tracked separately from paid pack volume so referral unlock math stays clean.