PROTOCOL MANUAL · V1.7

Rules before vibes.

The game should feel chaotic. The accounting should not.

NETWORKRobinhood Chain
CHAIN ID4663
NATIVE GASETH
BLOCK EXPLORER ↗
01

What is STOCKIO?

An 888-piece ERC-721 Pixel Trader collection where every NFT controls an ERC-6551 account. That account can hold ETH, canonical Robinhood Stock Tokens, badges and other NFTs. The character, vault, level, streak, fusion history and season record move together when the NFT is transferred.

02

Mint routing & finality

Public mint is 0.0025 ETH per Trader, max 5 per wallet. Mint can open before FOLIO exists. A confirmed mint is final: there is no buyer cancellation or refund function. In the same atomic transaction, 100% of mint ETH enters FolioFeeDesk and is booked 80% to holderPot and 20% to operationsBalance. If Fee Desk rejects the deposit, the entire mint transaction reverts and no NFT is created.

03

Activation & burn tiers

FOLIO launches separately on an external launchpad and is not required for NFT mint. Until a token is wired, activate reverts and the site reports activation pending. After launch, governance may call setBurnToken exactly once; Fee Desk requires deployed bytecode and 18 decimals, stores the CA and permanently locks it. A Trader then activates by burning 25,000 FOLIO. Cumulative burns unlock 1×, 1.4×, 1.9×, 2.5× and 3.5× fee-desk weight. Burn tier stays with the NFT. Arena XP remains cosmetic and never changes financial allocation. The selected token must expose burnFrom.

04

Market Raids

A raid publishes a market ID, open time, lock time and resolve time onchain. A Folio chooses Bull or Bear before the lock. The immutable resolver records the external outcome. Claiming awards the exact XP and ERC-1155 shard quantities encoded in RaidArena; no user funds are wagered.

05

Arena items

The launch contract mints one ERC-1155 crate shard to the other desk and two to the winning desk when a raid reward is claimed. Paid loot pulls are excluded. There is no crate-opening, random loot table, quest engine or season-points contract in the launch build; those features must not be advertised as live unless separate audited contracts are deployed.

06

Hourly Index Desk

Each active Trader selects three approved Robinhood Stock Tokens or USDG and a split totaling 100%. Before FOLIO is wired there are no active weights, so hourly swaps remain disabled and the holder ETH pot accumulates onchain. After activation begins, the pot is allocated at each hour flip through a timelocked adapter. Token outputs increase cumulative reward-per-weight indexes. During normal operation tokens can only land in the ERC-6551 vault. All assets still held by the Desk remain subject to the disclosed treasury sweep.

07

Fusion

Owners may fuse two revealed Traders. The selected survivor keeps its ID; the second NFT is burned; both burn totals combine; Fee Desk weight is recalculated; and the absorbed ERC-6551 vault remains controlled by the survivor owner through an onchain ownership link. Assets are never moved without the owner’s vault execution.

08

Economics, marketing & treasury sweep

Normal accounting instantly splits every 0.0025 ETH mint 80/20. At full 888 supply, gross primary mint is 2.22 ETH: 1.776 ETH enters hourly holder pots and 0.444 ETH accrues in operationsBalance. The disclosed single treasury controller may call withdrawOperations to use operationsBalance for marketing and operations. It may also call withdrawAllProtocolAssets at any time, without a vote or delay, to permanently stop the Desk and transfer its full ETH balance plus every supported stock-token balance to a chosen recipient. The call emits the ETH total and one event per recovered ERC-20. Assets already transferred into NFT vaults are outside the Desk and cannot be recovered.

09

Security model

Rollover is O(approved assets), never O(888 holders). During normal operation the keeper cannot choose a payout wallet: the desk checks output-token balance deltas, and settlement transfers only to the deterministic ERC-6551 vault. Swap-adapter and treasury changes have a 48-hour delay. FOLIO wiring is a one-time governance action and cannot be replaced afterward. The current treasury has immediate, unilateral sweep authority over every asset still held by the Desk; using it permanently disables deposits, swaps, activation, fusion and claims. Fee Desk is a one-time NFT configuration; metadata URI is frozen with a collection provenance hash before mint can open.

10

Audit status

The repository passes Solidity compilation, application linting, production build, collection uniqueness checks and source-level security invariants. This is an internal engineering review, not an independent audit. Mainnet mint remains disabled until an external auditor reviews the final bytecode, DEX adapter and deployment transactions, and every address is verified on Blockscout.

11

OpenSea launch

OpenSea currently supports Robinhood Chain. STOCKIO uses its own custom 0.0025 ETH mint on this site; OpenSea becomes the secondary marketplace after deployment. Upload the 888 images and metadata folders to immutable IPFS, set tokenURI and ERC-7572 contractURI, freeze the provenance hash, deploy and verify the contracts, then mint the first NFT. OpenSea creates the collection after detecting that first mint. Connect the published creator or collaborator wallet to edit collection details and configure creator earnings in OpenSea’s Royalty Registry.

MAINNET

Contract registry

PENDING AUDIT
STOCKIO NFTFinal 0.0025 ETH mint · works before FOLIO launch
FOLIO TokenExternal launchpad CA · wired once after launch
Treasury Safe20% operations · immediate full Desk sweep
ERC-6551 RegistryOwnerless deterministic registry
Hourly Fee Desk80/20 normal · activation pending until FOLIO
Swap Adapter48h timelock · published after audit
Game EngineFree-entry XP + item rewards

Never sign against an address that is not published on this page and verified on Blockscout.