contracts.ai · permissions
The four contracts and the admin key Four cream blocks labelled GAME, PET, PACKETS and VAULT are linked by dashed lines on a faint grid. A black key tile floats beside them for the admin's upgrade power, and a pointing hand taps the GAME block. GAME PET PACKETS VAULT

Contracts & permissions

What runs the game, and who can change it.

IDPuzz contracts run on BNB Chain, and each published address below links to its BscScan page. The game, pet, red-packet and reward-vault contracts are upgradeable by the project admin so that issues can be fixed. The reward vault's assets can be managed by the project admin for maintenance and emergency handling. The admin starts the game once, after the token launch, which fixes the start time and the holding requirement (500,000 $IDPUZZ); it cannot be started again. Player-created red packets can only be claimed by eligible players or refunded to their creator. $IDPUZZ follows the Flap tax-token template; its permissions are listed below.

Addresses and admin powers

IDPuzz game

—

Does
Rounds, draws, welcome letters, gifts, wishes and round achievements; checks the Agent ID and the holding requirement.
Admin can
Upgrade the contract (UUPS proxy); start the game once after the launch, setting the start time and the holding requirement.
Holds funds
No.

IDPuzz pet

—

Does
Non-transferable pets with on-chain images.
Admin can
Upgrade the contract. Only the game contract can mint pets or change their stage.
Holds funds
No.

Red packets

—

Does
Player red packets and the reward vault's lucky bags.
Admin can
Upgrade the contract. It has no rescue function.
Holds funds
Packet balances, which can only be claimed by eligible players or returned to the creator (lucky bags return to the vault).

Reward vault

—

Does
Receives the token tax and settles each round into lucky bags: 30% for the opening round, 3% per round after that.
Admin can
Upgrade the contract, and move vault assets with rescue(token, to, amount) for maintenance and emergencies.
Holds funds
Yes — the prize vault.

$IDPUZZ

—

Does
2% buy and sell tax, paid to the reward vault. The game reads holders' balances for the eligibility rule.
Admin can
Only what Flap's tax-token template allows; see the verified source on BscScan.
Holds funds
No.

Agent ID (SPACE ID)

—

Does
The identity every move checks: one non-transferable .ai name per holder.
Admin can
Run by SPACE ID, not by IDPuzz.

Upgrades and rescue are kept so bugs can be fixed and funds can't get stuck. There is no pause switch: problems are fixed by upgrading.

Fixed in the contracts

Game parameters

ParameterValue
RoundsRound 0 lasts 30 minutes from the start; every later round lasts 4 hours, counted from the start
Welcome letterThe first letter of the name, on the first draw or first claimed gift, once per wallet
Holding requirement500,000 $IDPUZZ at the moment of a draw, gift, gift claim, wish or lucky-bag claim
Cards per revealName length ÷ 3, rounded up
Chance a card is a letter you need12%
FortunesSupreme 5%, Upper 20%, Middle 45%, Lower 20%, Lowest 10%
Gifts3 per round; unclaimed gifts can be taken back after 7 days
Pet evolutionStages 2, 3, 4 after 9, 21 and 42 draws since hatching
Hungry petAfter 24 hours without a draw; looks only
Opening lucky bag30% of the vault when round 0 settles, shared equally by its openers
Lucky bags per round3% of the vault; none below 0.001 BNB; 50% completed names, 25% Supreme Fortunes, 25% pet evolutions, equal shares within each
Lucky bag lifetime72 hours, then the rest returns to the vault
Player red packets1–200 shares; 1 hour to 7 days; blessing up to 80 bytes; up to 100 listed names; no token needed
Token tax2% buy, 2% sell, paid to the reward vault; nothing is paid to holders

Digital assets are volatile. Rewards depend on trading activity and are not guaranteed. Nothing here is financial advice.