WHITEPAPER · AGENT AVATAR
JAGENT Agent Avatar Whitepaper
- Version
- 1.5
- Date
- November 2026
- Chain
- BNB Smart Chain (ERC-721)
- Rules
- exec-v1.4
Changelog: 1.5: the quota is now every share minted to the Agent ID: V1 paid, V1 compensation and V2 paid all count (the V2 migration import is the same shares as V1 and is not counted twice), and the first mint serial is the earliest of those shares; this applies from round 1. Round 0's quota root was written on-chain when it opened, so it keeps its snapshot of paid mints only (rules exec-v1.4). 1.4: the script opened the first round on November 21 at 23:24 (UTC+8); the multisig then cleared the opener, so only the multisig opens rounds now. 1.3: both contracts are source-verified on BscScan; on November 21 the deployed contracts had a second internal audit (automated scan and line-by-line review), and there will be no third-party audit; the risks section now spells out what a stolen opener key could do. 1.2: the contracts are on mainnet (section 16); the auction gains an opener that can only open rounds, and a script opens the first round by itself at 1,000,000 minted shares: all 1,000 S1 avatars, with locking from 1 hour after the round opens; the first round no longer waits for the third-party audit or the testnet rehearsal (rules exec-v1.3). 1.1: each avatar's tier is now drawn only at the reveal and published together with its image; the provenance is committed once by the multisig before the reveal instead of at deployment; tier counts are unchanged (rules exec-v1.2). 1.0: first version, matching rules exec-v1.1.
1. Summary
JAGENT Agent Avatar is the on-chain PFP of the $JAGENT ecosystem: 4,444 avatars you can equip to your Binance Agent ID (.ai).
- Free. Claiming costs no USDT and takes no $JAGENT. You only pay gas.
- Lock to rank. Hold a
.aiwith at least 10 mint shares, and you can lock $JAGENT in the auction contract to rank. The top N of each round claim. - Full withdrawals. Every $JAGENT you lock comes back in the same amount: any time once you are pushed off the board, and for everyone after the round ends.
- One per .ai. Each
.aican claim at most one public avatar in total. - On-chain rarity draw at the reveal. Locking more raises the odds of a rarer tier, but nothing is guaranteed. Tier counts are public now; each avatar's tier is drawn only at the reveal. The contract computes the result and the team cannot change it.
- Trading after the reveal. All avatars are revealed once $JAGENT reaches 4,440,000 minted shares or on 2027-06-30 08:00 (UTC+8), and trading opens after that. Sales on the official market pay a 2% royalty, all of it to the treasury.
Four things to know before you lock
- The NFT is free; you only pay gas.
- You withdraw the $JAGENT you lock yourself, in the same amount; it is not sent back automatically, and its price can move meanwhile.
- Locking more raises the odds of a rarer tier; nothing is guaranteed.
- Each .ai can win at most one avatar in total.
2. Supply and segments
4,444 avatars in 6 segments. The first 5 are public and go to the lock board; segment 6 is the team Gift. Public segments unlock with the minted shares of the $JAGENT Fair Mint:
| Segment | Token IDs | Count | Unlocks at | Unlock price |
|---|---|---|---|---|
| Season 1 | #0001–#1000 | 1,000 | 1,000,000 shares minted | 5.50 USDT |
| Season 2 | #1001–#2000 | 1,000 | 2,000,000 shares minted | 6.25 USDT |
| Season 3 | #2001–#3000 | 1,000 | 3,000,000 shares minted | 7.00 USDT |
| Season 4 | #3001–#4000 | 1,000 | 4,000,000 shares minted | 7.75 USDT |
| Sprint | #4001–#4400 | 400 | 4,200,000 shares minted and Season 4 closed | 7.90 USDT |
| Team Gift | #4401–#4444 | 44 | Gifted by the multisig only | — |
- The unlock price is the Mint V2 price of the share at the unlock (
priceCents). Each round fixes the mint price at the moment it opens, so later rounds in the same segment can have a higher price. The price only converts shares into $JAGENT to lock (section 5); claiming is free. - A segment can be released over several rounds. Once full, anyone can close it; otherwise the multisig can close it between rounds. Token IDs left over when a segment closes are never minted.
- Sprint unlocks only after Season 4 has closed and 4,200,000 shares are minted.
3. Timeline
| Milestone | Action |
|---|---|
| 900,000 shares minted | Rules (this paper), sample art and the fallback reveal date are published |
| November 21, 2026 | Contracts deployed on mainnet; addresses in section 16 |
| 1,000,000 shares minted | S1 unlocks and a script opens the first round by itself: all 1,000 S1 avatars, with locking from 1 hour after the round opens. The quota table is built and published when the round opens (section 12) |
| Every round | 3 days of locking, then 3 days to claim; all locked tokens come back |
| Before the reveal | All 4,444 2D images and the tier table are final; the multisig commits their provenance hash on-chain (once only) |
| 4,440,000 shares or 2027-06-30 08:00 (UTC+8) | Reveal, then the draw 10 blocks later, so each avatar’s tier and image go public together; then trading opens and the official market goes live |
4. Who can take part
You need all four:
- A valid
.ai. - At least 10 mint shares on this Agent ID: every share minted to it, counted once. That is V1
Minted(paid) andCompensated(compensation) plus V2Minted. Shares imported into V2 during the migration are the same shares as V1 and are not counted twice; tokens bought in the pool do not count. Round 0's quota root was written on-chain when it opened, so it counts paid mints only; V1 compensation counts from round 1. - This
.aihas not claimed a public avatar before. - One wallet per
.aiper round, and a wallet with a lock cannot switch to another.ai.
The quota belongs to the Agent ID. If the .ai moves to another wallet, the quota moves with it; a .ai that has already claimed cannot claim again from a new wallet.
5. Locking
Locks are counted in shares. When a round opens, the contract fixes two numbers for the whole round:
- Quota: the most shares you can lock, equal to your mint shares as of the round's snapshot.
- Tokens per share (
tokensPerShare): the $JAGENT one share would mint at this round's price, using the pool's 24-hour average before the round. The contract checks it is within ±20% of the mint contract's spot formula to catch typos. If the average is outside that range, the spot value is used instead, and the round announcement says which one.
| Rule | Value |
|---|---|
| Minimum | 10 shares (your total after the lock) |
| Maximum | Your quota |
| Adding | At least 1 share at a time, as often as you like |
| Tokens moved in | Shares × tokens per share |
| Above quota or below the minimum | The transaction fails |
Example: S1 price 5.50 USDT, quota 100 shares → lock at least 10 and at most 100 shares → 100 shares ≈ 550 USDT worth of $JAGENT (at the price when the round opens)
Moving $JAGENT from your wallet into the auction contract is not taxed. Buying from the pool to lock pays the 1% buy tax, and selling later pays the 2% sell tax (1% of it burned); see the $JAGENT whitepaper.
6. Ranking and claiming
| Rule | Value |
|---|---|
| Format | One lock board per round; the top N get a spot, where N is the number released this round |
| Length | Fixed 3 days, no extension at the end |
| Order | More shares first; on equal shares, the earlier first mint goes first. Locking early gives no edge, so there is no need to rush |
| Getting on | While the board has room you are in; once full you must rank above the last entry, or the transaction fails and nothing is locked |
| Pushed off | Lock more to get back on, or withdraw everything right away |
| Claim | Within 3 days after the round, call claim while still on the board with the same .ai |
| Unfilled or unclaimed | Not minted; the spot stays in the segment for the next round and is void once the segment closes |
Token flow
approve → lock $JAGENT held by the auction contract pushed off withdraw any time, in full round ends everyone withdraws, in full claim free sealed avatar; no $JAGENT taken
- Claiming and withdrawing are independent: you can withdraw first and claim later, and the weight is still your locked shares.
- The auction contract takes no fee, no cut and burns nothing. Tokens leave it in only two ways: back to the person who locked them, or through
rescueExcess, which lets the multisig move only what exceeds the total locked (tokens sent in by mistake) and never touches a lock. - Claimed avatars are sealed: they show the same sealed image until the reveal and cannot be transferred. If your
.aihas no avatar equipped yet, the claim equips it.
7. Rarity
The 4,400 public avatars come in ten tiers, with a fixed count per segment:
| Tier | Name | Total | S1 | S2 | S3 | S4 | Sprint |
|---|---|---|---|---|---|---|---|
| 10 | Myth | 100 | 23 | 23 | 23 | 22 | 9 |
| 9 | Legend | 200 | 46 | 46 | 45 | 45 | 18 |
| 8 | Epic+ | 300 | 69 | 68 | 68 | 68 | 27 |
| 7 | Epic | 350 | 80 | 80 | 79 | 79 | 32 |
| 6 | Rare+ | 400 | 91 | 91 | 91 | 91 | 36 |
| 5 | Rare | 450 | 103 | 102 | 102 | 102 | 41 |
| 4 | Uncommon+ | 500 | 114 | 114 | 114 | 113 | 45 |
| 3 | Uncommon | 600 | 137 | 136 | 136 | 136 | 55 |
| 2 | Common+ | 700 | 159 | 159 | 159 | 159 | 64 |
| 1 | Common | 800 | 178 | 181 | 183 | 185 | 73 |
| Total | 4,400 | 1,000 | 1,000 | 1,000 | 1,000 | 400 |
The 44 team Gift avatars are not part of this table (section 9).
8. On-chain draw
weight = shares locked in the round seed = keccak(hash of the draw block, provenance, segment) key per token = −log2(u) ÷ weight, u from seed and tokenId, uniform in (0, 1) places = keys sorted ascending: 0, 1, 2 … image at place p = first image of the segment + p (each segment's images run Myth → Common)
- This is a weighted draw without replacement: the chance that place 1 goes to an avatar is its weight divided by the segment's total weight, and so on for later places.
- More shares mean better odds, not a guarantee. In a simulation with 100 avatars at weight 100 and 900 at weight 1, 22 of the 23 Myth places went to high-weight avatars, yet 17 of the top 100 places still had weight 1.
- Weight is proportional to shares: spreading the same shares over several .ai keeps the total weight, so splitting does not buy better odds.
- The reveal sets the draw block: 10 blocks after the reveal for segments already closed, and 10 blocks after the close for segments that close later. Once that block has passed, anyone can call
draw. The block hash comes from the chain for the last 256 blocks, then from the EIP-2935 block hash history contract for the last 8,191 blocks (about an hour at current BSC block times). The team draws as soon as the block has passed. - Only if nobody draws within that window does a fixed seed
keccak(provenance, segment, block number)apply. The block is never re-picked, so waiting cannot buy a redraw. - The contract does not draw before the reveal, so nobody, the team included, can know any avatar's tier in advance. After the draw, every avatar's place, tier and image are public together and can be recomputed with a script.
- If a segment is not filled, only the n avatars minted get places 0 to n−1, which use the first n images of the table. Common shrinks first; Myth and Legend shrink only if the segment mints fewer avatars than those two tiers combined.
- Provenance is the hash of all 4,444 2D images and the tier table. The multisig commits it on-chain with
commitProvenancebefore the reveal, once only, and it cannot change afterwards; the reveal is impossible without it. The draw block comes after the commit, so nobody knows the draw result when the table is fixed.
9. Team Gift
- The 44 avatars #4401–#4444 are a separate Gift series outside the ten tiers. They are gifted, never sold.
- The multisig gifts them with
teamMint; recipients and dates are published on the website. A gift does not count as claiming a public avatar. - All have weight 1. When they are all given out, or the team decides to stop, the multisig closes segment 6; like the public segments, it is drawn on-chain at the reveal (or after its close, if it closes later), which orders the 44 Gift images.
10. Looks and equipping
| Layer | Form | Used in |
|---|---|---|
| Flat | 1:1 2D anime PFP | On-chain image, wallets, market |
| Solid | 3D model with the same traits | AI Pro, animation_url |
- You can equip an avatar to a
.aiyou hold (equip/unequip). Transferring the avatar unequips it, and the binding stops counting as soon as the.aileaves your wallet. - Whether you see 2D or 3D is a website setting; AI shows 3D by default.
- The 3D models are meant to be done before the reveal, written into the frozen metadata (
animation_url), with a hash list of the 3D files published before the reveal. If they are not ready, the reveal is not delayed and 3D is served through the website API first. We do not promise 3D in the on-chain metadata.
11. Reveal and trading
- The reveal needs 4,440,000 minted $JAGENT shares or 2027-06-30 08:00 (UTC+8), and a committed provenance. It happens once, and the metadata is frozen afterwards.
- Every transfer fails before the reveal.
- The multisig opens trading after the reveal; if it has not after 30 days, anyone can. The contract has no function to close trading.
- Transfers you make yourself always work. Approvals (
approve/setApprovalForAll) and transfers on your behalf only work for whitelisted operators. Adding or removing an operator is proposed first and takes effect after 2 days, can be cancelled meanwhile and is announced in advance; a removed operator loses the approvals it had. - Royalty: ERC-2981, fixed at 2%, paid to the treasury (the multisig can change the address).
Official market
- Listing moves the avatar into the market contract, priced in USDT; sellers can reprice or cancel. Listing unequips the avatar.
- Buyers must pass the price they saw. If the seller reprices first, the purchase fails instead of filling at the new price.
- On a sale, 2% goes to the treasury and the rest straight to the seller. The market takes no fee, keeps no USDT and has no owner: it cannot be paused, reconfigured or touch listed avatars.
- 100% of royalties go to the treasury. There is no buyback or burn for now.
- Limits: only whitelisted markets can sell on your behalf. Transfers you make yourself have no price and pay no royalty, and the contract cannot stop off-market payments or wrapping an avatar in another contract to trade it.
12. Quota proofs
- Before each round, every Agent ID's mint shares and first mint serial are totalled at a snapshot block into a full table and a Merkle root. Each leaf is
(auction contract, chain ID, round, Agent ID, quota, first mint serial). - The full table is published at
jager.live/avatar/quota/round-{round}.json, and the recompute script is open-sourced with the contracts. Anyone can rebuild the root and compare it withquotaRooton-chain. - Public nodes sometimes drop logs silently, so every 4,000-block range is checked: its log shares must equal the increase in total minted shares, or the range is fetched again.
- The website API compares the table's root with the on-chain root first and stops serving proofs if they differ.
- Tokens per share is published with the table: pool reserves sampled every 4,000 blocks over the 24 hours before the snapshot, averaged, then converted at the round's price.
13. Permissions
| Role | Can | Cannot |
|---|---|---|
| Avatar owner (multisig) | Change the sealed image before the reveal; commit the provenance once before the reveal; reveal once when allowed; open trading once; gift #4401–#4444; close the team segment; change the minter (after 2 days, cancellable); add or remove trading operators (after 2 days, cancellable); change the royalty address | Close trading; change the art table once committed; change images after the reveal; draw before the reveal; mint public avatars; pick token IDs or places; change draw results; block transfers you make yourself |
| Auction contract (minter) | Mint public avatars for free, in order, to those on the board; close an unlocked public segment between rounds | Skip unlock conditions; give a second public avatar to the same .ai; mint to an address without a .ai |
| Auction owner (multisig) | Open a round (quota root and tokens per share, the latter within ±20% of spot); cancel it before it starts; close a segment between rounds; move tokens sent in by mistake; replace or clear the opener | Change a running round; lock for someone else; use or hold back anyone’s locked tokens |
| Opener (0x46A6EDFab162584C3077AD285ff14E0eb9566243, cleared) | Nothing now: the multisig cleared it on November 21, after the first round opened. Before that it could only open rounds, under the same checks as the multisig: segment unlocked, places available, tokens per share within ±20% of spot | Cancel rounds; close segments; move any tokens; change the owner or the opener |
| Official market | Fill sales at the listed price and pay the 2% royalty to the royalty address | Pause; change settings; touch listed avatars; take more or less royalty |
| Anyone | Close a full segment; draw after the reveal; open trading 30 days after the reveal; withdraw their own tokens; finish a round | — |
Two things rely on the team: the quota root and tokens per share, submitted by the multisig (by the opener script for the first round). That is why every round publishes the full table and the recompute script (section 12).
14. AI Pro and API
The main path is Binance AI Pro. Every state change is signed by your own wallet: the AI shows a transaction preview first and sends only after you confirm.
| Endpoint | Returns |
|---|---|
| GET /api/avatar/config | Segment status, the current round and the rules |
| GET /api/avatar/me?address= | Your .ai, quota, locks, whether you can add, claim or withdraw, and the avatars you hold |
| GET /api/avatar/board?round= | The lock board and the lowest entry |
| GET /api/avatar/approve-tx?address=&shares= | Approval only |
| GET /api/avatar/lock-tx?address=&shares= | Lock more shares, with the approval if needed |
| GET /api/avatar/withdraw-tx?address=&round= | Withdraw; latest round if round is empty |
| GET /api/avatar/claim-tx?address= | Claim |
| GET /api/avatar/equip-tx?address=&tokenId= | Equip; action=unequip to unequip |
| GET /api/agent/avatar?id={name}.ai | The avatar equipped to a .ai |
The API only returns transaction data and never holds funds. If a condition is not met it returns the reason instead of a transaction bound to fail.
15. Risks
- You get back the same number of $JAGENT, not the same USDT value. The price moves while you are locked and can fall a lot.
- Buying may bunch up before a round and unlocks may bunch up after it. We make no promise about the price of $JAGENT or the avatars.
- Rarity is odds, not a guarantee.
- The images and each image's tier are fixed and committed only before the reveal, so you cannot see them when you claim. The number of avatars per tier in each segment is fixed in this paper; the committed table must match it, and anyone can check after the reveal.
- Randomness comes from block hashes. The team cannot change the result, but the validator producing a block can in theory influence its hash; this is not VRF-grade randomness.
- The multisig submits the quota root and tokens per share (the opener script did it for the first round); the contract only catches typos (±20%). Check them against the published table and script.
- The first round was opened by the opener, a hot wallet key kept on an operator machine. It could only open rounds and could not touch any locked tokens, but it could set a round's start to the current time, so a stolen key could have opened a wrong round at once, before the multisig could cancel it. That is why the multisig cleared the opener on November 21, after the first round opened; only the multisig opens rounds now. The multisig can set an opener again, and every change leaves an OpenerSet record on chain.
- Royalties are only collected on whitelisted market sales; see section 11 for what cannot be stopped.
- Smart contracts can have bugs. The contracts had internal audits (November 20 and 21: automated scan and line-by-line review), not a third-party audit. Unit tests, a mainnet-fork rehearsal, a site end-to-end test and the testnet locking rehearsal are done; the testnet claim and reveal rehearsal is not, and the first round does not wait for it. The source is verified on BscScan; read it before taking part.
- The avatars are free digital collectibles. They carry no right to income or dividends and may have no resale value.
- This document is not investment advice or a promise of returns. Check the laws where you live and judge the risks yourself.
16. Contract addresses
| Contract | Address |
|---|---|
| JagentAgentAvatar | 0xdfC92233990ff4BddBf831098a11259672b071c8 |
| JagentAvatarAuction | 0x9c7CD44dA30116F5191E5043b7fA2F1170000609 |
| JagentAvatarMarket (official market) | Published after deployment |
| $JAGENT token | 0x8e6442663A4F8C50b6132c68d42A30E7DFE4Ae15 |
| $JAGENT mint (V2) | 0x3643A907f875fA9B740e1C0747E91b5aA5222aB8 |
Deployed on November 21, 2026, and source-verified on BscScan the same day (Solidity 0.8.24), so anyone can read the code. The opener 0x46A6EDFab162584C3077AD285ff14E0eb9566243 was cleared after the first round opened. Open-sourcing to jagent-contracts together with the recompute script follows.