# Relay

**Relay** is a free-mint NFT collection for holders of a Binance Agent ID. Each
Relay is a signal beacon. Mint one free, fuse two into a stronger one.

Built for the **Binance Wallet Agent ID Hackathon** (BNB Chain). The project is
open source: contract source is verified on BscScan.

## Contract

- **Network:** BNB Chain (chain id 56)
- **Contract:** `0xDb514D1a00662fdA0Dc531a4Cf69Cd908B7E84a9` (Relay / RELAY, ERC-721)
- **Agent ID registry:** `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F`
- **Website:** https://bonusan12.github.io/relay/
- **Max supply:** 2,222
- **Free mint:** 1 per wallet, only for Agent ID holders (gas only)
- **Paid mint:** 0.001 BNB each, max 7 per wallet, open to any wallet
- **Fuse:** burn 2 beacons you own to mint 1 of the next higher tier

## Tiers

| Tier | Chance on mint |
|---|---|
| Common | 50% |
| Rare | 25% |
| Epic | 15% |
| Legendary | 8% |
| Mythic | 2% |

Fuse ladder: Common + Common -> Rare, Rare + Rare -> Epic, Epic + Epic ->
Legendary, Legendary + Legendary -> Mythic. Fusing two Mythics is not
possible. A fused beacon keeps the higher of the two input tiers, +1.

## How to mint (for AI agents with a Binance Agentic Wallet)

You need a claimed Agent ID (`*.ai`) on the wallet you mint from. The free
mint checks the Agent ID registry on-chain: `balanceOf(your wallet) > 0`.

1. Confirm your Agent ID is claimed (check `ownerOf(keccak256(bytes(handle)))`
   on the registry above equals your wallet).
2. Call `freeMint()` on the Relay contract, value 0:

```
baw contract-call preview --to 0xDb514D1a00662fdA0Dc531a4Cf69Cd908B7E84a9 --chain bsc \
  --function freeMint --args '[]' --value 0 --json
```

3. Review the preview, then execute it with the returned `requestId`:

```
baw contract-call execute --requestId <requestId> --json
```

4. Confirm the receipt. Your token id and tier are in the `FreeMint` event.
   The metadata is at `https://bonusan12.github.io/relay/nft/tier-&lt;tier&gt;.json`
   (one static file per tier, 0 = Common … 4 = Mythic).

### Paid mint

Same flow with `mint(uint256 quantity)` and value `0.001 * quantity` BNB
(e.g. quantity 1 -> value 0.001 BNB). Max 7 paid mints per wallet.

### Fuse

```
baw contract-call preview --to 0xDb514D1a00662fdA0Dc531a4Cf69Cd908B7E84a9 --chain bsc \
  --function fuse --args '[<tokenId1>, <tokenId2>]' --value 0 --json
```

Both tokens must belong to your wallet. The two input tokens are burned and
one new beacon of the next tier is minted to you.

## What Relay is NOT

- Not an investment. No token, no yield, no promised returns. Beacons are
  collectibles.
- The contract has no admin mint. Only `setBaseURI` and `withdraw` (paid-mint
  proceeds) are owner-only. Ownership belongs to the project creator's wallet.

## Copy-paste prompt for your agent

```
Mint a free Relay beacon for my Binance Agent ID.
Contract: 0xDb514D1a00662fdA0Dc531a4Cf69Cd908B7E84a9 on BNB Chain.
Call freeMint() with value 0 from my Agentic Wallet, confirm the preview,
execute, and report the token id and tier.
```

## Source

Contract: `contracts/Relay.sol` (Solidity 0.8.26, OpenZeppelin 5.0.2).
Verified on BscScan: https://bscscan.com/address/0xDb514D1a00662fdA0Dc531a4Cf69Cd908B7E84a9
