Start here

What Blacksite is

Blacksite is a venue for trading tokenised stocks on Robinhood Chain without publishing your order first. It is one contract. It keeps a vault of…

Section Start here2 min read
Start here

Glossary

Batch. A run of 21 L1 blocks: 16 to commit, 5 to reveal. Numbered from zero at deployment.

Section Start here1 min read
Protocol

Commitments

A commitment is the only thing an order puts on-chain while the batch takes orders.

Section Protocol1 min read
Protocol

Settlement

settle(batch, market) can be called by anyone once the batch's reveal window has closed, and succeeds once per batch and market.

Section Protocol1 min read
Protocol

Rounding

Settlement divides a lot, and integer division drops remainders. Blacksite chooses the direction of every one of them so the book can never pay…

Section Protocol1 min read
Protocol

Staking

Staking is built into the venue. There is no separate rewards contract.

Section Protocol1 min read
Trust

What the contract guarantees

This page separates what the Blacksite contract enforces from what it does not. If something is not on the first list, do not assume it.

Section Trust2 min read
Trust

Admin powers

The owner is set at deployment and handed to the treasury with a two-step transfer (transferOwnership, then acceptOwnership from the new address).

Section Trust1 min read
Developers

Computing a commitment

The commitment is plain abi.encode then keccak256. Compute it off-chain; commitmentOf exists to check your code against the contract.

Section Developers1 min read
Developers

Running a keeper

A keeper does two things, and anyone can do them.

Section Developers1 min read
Roadmap

What comes next

Each item appears on this page as done only when it is done.

Section Roadmap1 min read
Start here

The life of a batch

Batches run back to back from the block the contract was deployed in. Each one has a commit window and a reveal window; settlement happens after…

Section Start here2 min read
Protocol

The vault

Every order is paid from, and paid into, a balance the contract keeps for you. Tokens only move on deposit and withdraw; everything else is…

Section Protocol1 min read
Protocol

Reveal

In the 5 reveal blocks of the batch, you call:

Section Protocol1 min read
Protocol

The price guard

Blacksite trusts the pool for its price. The price guard is what stops that trust from being exploited in a single block.

Section Protocol1 min read
Protocol

Fees

Unfilled size pays nothing.

Section Protocol1 min read
Protocol

Markets

A market is a stock plus one Uniswap V4 pool key against USDG. At launch every market uses the pool with fee 0.30 %, tick spacing 60 and no hook.

Section Protocol1 min read
Trust

Risks

The contract is tested, including fuzzing of settlement, but it has not been audited. Deposit what you are prepared to lose.

Section Trust1 min read
Developers

Contract reference

Solidity 0.8.28, no proxy, no external dependencies beyond a 512-bit mulDiv. Source in the verified source.

Section Developers1 min read
Developers

Reading V4 prices

Uniswap V4 keeps every pool inside one PoolManager, at 0x8366a39CC670B4001A1121B8F6A443A643e40951 on Robinhood Chain. Pool state is not exposed…

Section Developers1 min read
Roadmap

Proof of funds in zero knowledge

This is the plan for version 2. None of it is in the contract you can use today.

Section Roadmap1 min read