Trophies
Gifting trophies
Send cash or trophies to another user, or claim a trophy as an NFT.
You can send value to another Rivalizer user three ways — cash, a trophy you already own, or a trophy you buy for them — all from the Gift a user card on the Wallet page (/wallet). You can also move trophies on-chain as NFTs.
Who you can gift
Recipients are identified by wallet address (0x…, 42 chars) or exact username (display name). You can't gift yourself, and you can't gift a suspended account.
The three gift types
| Gift type | What it does | Cost to you |
|---|---|---|
| Gift cash | Sends a whole-dollar amount from your in-app balance to theirs. | The cash amount (min $1). |
| Gift owned trophy | Moves a trophy you already hold to the recipient's case. | The trophy(ies) leave your case. No payment. |
| Buy & gift trophy | Buys a trophy from the store (paid from your balance) and delivers it straight to the recipient. | The trophy's face value × quantity, from your balance. Consumes store supply. |
All trophy gifts transfer at face value and are recorded for both sender and recipient; both parties see an activity entry.
How to gift
- Go to /wallet and find the Gift a user card.
- Pick a tab: Gift cash, Gift owned trophy, or Buy & gift trophy.
- Enter the recipient's wallet address or username.
- Then either:
- Cash — enter a whole-dollar amount (min $1), or
- Trophy — pick a trophy (your owned trophies for Gift owned, the store catalog for Buy & gift) and a quantity.
- Click Send gift. You'll see confirmation naming the recipient.
Backed by POST /trophies/gift (kind = CASH / TROPHY / BUY_TROPHY).
Claiming a trophy as an NFT (on-chain)
Beyond in-app gifting, trophies can move onto the blockchain as real ERC-1155 NFTs (the RivalizerTrophy contract on Base). Each trophy type maps to a token ID (1–20). This is a high-level, two-way bridge.
Claim (in-app → NFT)
- Link a wallet to your account.
- Choose a trophy and quantity to claim.
- Rivalizer debits that holding from your in-app case and queues an operator mint of the matching ERC-1155 token to your wallet.
- Once minted, the NFT is yours on-chain — transferable, viewable in marketplaces, etc.
If a claim fails, the reserved in-app holding is automatically refunded.
Re-deposit (NFT → in-app)
- Burn your trophy NFT(s) on-chain (send to the zero address) from your linked wallet.
- Submit the transaction hash to Rivalizer.
- Rivalizer verifies the burn came from your wallet for valid trophy token IDs, then credits the trophies back into your in-app case at the right quantities.
Each transaction hash is processed once, so a burn can't be double-credited.
Availability
NFT claim and re-deposit only work when the chain and trophy contract are configured (Base). The app exposes whether it's available, plus the contract address and chain ID. NFT metadata (name, tier, face value, supply, art) is served per token for marketplaces.
Implemented in trophies/trophy-nft.service.ts.