Launch app

Docs / 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 bookkeeping.

Assets

The vault accepts USDG (6 decimals) and the stock of every listed market (18 decimals). Any other token reverts with UnknownAsset. Deposits credit what actually arrived, measured as the change in the contract's balance, so a token that charges on transfer can never credit more than it delivered.

Free and locked

  • Free balance is what balanceOf(trader, token) returns. You can withdraw all of it in one call, in any phase.
  • Locked balance is the size of your revealed orders in a batch that has not settled. It is not in balanceOf until settlement returns it or pays for it.

A commitment only locks the 1 USDG bond. Your order size is taken at reveal, which is why a commitment does not say how much you hold.

What the vault does not do

It does not lend, rehypothecate or earn anything on deposits. Balances sit in the contract until you trade or withdraw them.

Stock-level controls

Robinhood's stock tokens are upgradeable proxies whose issuer can pause transfers or block accounts. If a stock is paused, deposits and withdrawals of that stock fail until it is unpaused. Blackpool cannot override this; see Risks.