What Blacksite is
A sealed-order venue for tokenised stocks on Robinhood Chain: what it does, what it is not, one trade end to end, and where version 1.1 stands.
The life of a batch
How a batch runs on the L1 block clock: 16 blocks to commit, 5 to reveal, then settlement by anyone within 26 blocks.
Glossary
The terms used across these docs, from batch, commitment and bond to usable amount, void and dust.
The vault
Every order is paid from a balance the contract keeps for you: which tokens it takes, free versus locked, and what it never does with them.
Commitments
What a sealed order puts on-chain: one hash binding your address, the batch, the order and a 32-byte salt that only you hold.
Reveal
Opening a sealed order in the 5-block reveal window: the checks it must pass, what it changes, and what becomes public.
Settlement
How a batch is voided or crossed: one midpoint for every fill, the lighter side in full and the heavier side pro rata.
The price guard
Why settlement checks the midpoint against the batch’s price samples, and voids the batch when the pool has been pushed.
Rounding
Every division in settlement rounds toward the venue, so a book can never pay out more than it took in.
Fees
A 0.10 % matching fee per side on what crosses, capped at 0.50 %, and where every fee and forfeited bond goes.
Staking
Staking is built into the venue: stake $BLACKSITE, earn a share of every fee in USDG, and claim whenever you like.
Markets
Nine stocks, each read from one canonical Uniswap V4 pool against USDG: how the pools were chosen and how markets change.
What the contract guarantees
The rules the code enforces, from sealed commitments to the fee ceiling, and what it does not cover, starting with privacy after reveal.
Risks
Contract, price and reveal-window risk, issuer controls on stock tokens, corporate actions and liveness. Read this before depositing.
Admin powers
What the owner can call, what each call does, and the list of things the owner cannot do, starting with your balance.
Contract reference
Every function traders, keepers and integrators call, the phase each one works in, and the views and events.
Computing a commitment
Compute the commitment hash off-chain with viem, in the right units, and commit into the right batch.
Reading V4 prices
How the venue reads a Uniswap V4 pool through extsload and turns sqrtPriceX96 into USDG per share.
Running a keeper
Poking markets for price samples and settling books after each reveal window: what a keeper does, and why anyone can run one.
Proof of funds in zero knowledge
The version 2 plan: balances in a shielded note tree and a Noir proof of funds, then encrypted reveals. None of it is live.
What comes next
What is done and what comes next, from the version 1.1 deployment and the keeper to an audit, more markets and version 2.
