Constants
Every protocol constant and default, with its exact value, including the Pons terms ZERO trades under.
Values are read from the verified contracts. Where a value is set at deployment, the table gives the value the mainnet deployment uses; read the live value from the contract when it matters.
PrivateVault
| Constant | Value | Meaning |
|---|---|---|
VIRTUAL_SHARES | 1e6 | Virtual shares in the share price, against the first-depositor inflation attack |
NETWORK_FEE_INTERVAL | 1 hours | How often poke resets the network fee from the price average; the previous fee stays accepted until the next reset |
opCostWei (storage, read through maxOpCostWei()) | 0.0002 ether at deployment | The operation cost: the most an operation may charge the gas deposit, and the value in ETH of the network fee. Set by initialize, then by the guardian with setOpCost |
MIN_OP_COST_WEI | 0.00005 ether | The lowest operation cost the guardian can set |
MAX_OP_COST_WEI | 0.001 ether | The highest operation cost the guardian can set |
| Network fee | opCostWei * tokensPerEthEma / 1e18 ZERO (at least 1) | An operation must pay at least the lower of networkFee and previousNetworkFee, and may cost at most the operation cost that goes with the fee it pays |
MAX_PRICE_STEP_BPS | 1_000 (10%) | A block's price (the last one poked in it) enters the average clamped to ±10% of it |
| EMA weight | 1/8 | ema = (ema * 7 + close) / 8: at most 1/8 × 10% = 1.25% per block |
BPS_DENOMINATOR (private) | 10_000 | Basis points |
SIG_VALIDATION_FAILED (private) | 1 | Returned by validateUserOp for an invalid proof |
| EIP-712 version | "1" | EIP712(name, "1"); the domain name is the constructor's name_ (TOKEN_NAME, zerotrace), the verifying contract the proxy |
DEFAULT_ADMIN_ROLE | 0x00 | Grants and revokes every role; the admin role of all three |
UPGRADER_ROLE | keccak256("UPGRADER_ROLE") | May call upgradeToAndCall |
GUARDIAN_ROLE | keccak256("GUARDIAN_ROLE") | May call pause, unpause, setEntriesPaused, setTargetExitsPaused and setOpCost |
UPGRADE_INTERFACE_VERSION | "5.0.0" | OpenZeppelin UUPS: upgrades go through upgradeToAndCall only |
REGISTER_TYPEHASH (private) | keccak256("Register(address owner,uint256 opk,bytes32 viewKey,uint256 nonce,uint256 deadline)") | registerFor signatures |
| Share price | convertToAssets(s) = s * (B + 1) / (S + VIRTUAL_SHARES) | Rounds down; convertToShares is the inverse |
| ERC-4337 nonce | uint192(nullifiers[0]) << 64 | One nonce key per first nullifier |
The price average counts block.number, which on Robinhood Chain is the L1 block (about 12 seconds).
FeeHarvesterV3
| Constant | Value | Meaning |
|---|---|---|
TEAM_SHARE_BPS | 5_000 (50%) | Share of the ETH each harvest collects that is owed to the team's recipient: 0.35% of each trade |
MAX_IMPACT_BPS | 50 (0.5%) | The most a single buy may move ZERO's price, sized from the pool's active liquidity or the curve's ETH reserve |
MAX_PREMIUM_BPS | 1_500 (15%) | A buy must get at least 85% of the ZERO the vault's price average gives, after Pons fees |
CALLER_TIP_BPS | 50 (0.5%) | The caller's gas refund never exceeds this share of the ETH a harvest puts to work |
GAS_OVERHEAD | 25_000 | Gas refunded on top of what the call measures, at min(tx.gasprice, 2 * block.basefee) |
| Buys per block | 1 | At most one buy per L1 block (lastBuyBlock) |
MAX_HALVINGS (private) | 8 | Sizes tried for a buy the market does not take within the limits, halving each time |
BPS (private) | 10_000 | Basis points |
targetDeposit (immutable) | 0.1 ether | EntryPoint deposit the harvester keeps for the vault |
The owner's handOver changes ZERO's creator fee recipient at once: there is no successor delay.
FeeHarvesterV2, an earlier harvester, has the same values plus SUCCESSOR_DELAY (24 hours): how long a proposed
successor waits before anyone can make it ZERO's fee recipient.
FeeHarvester (launch)
| Constant | Value | Meaning |
|---|---|---|
MAX_SLIPPAGE_BPS | 300 (3%) | A buy must land within this distance of the price average, after Pons fees |
CALLER_TIP_BPS | 50 (0.5%) | As in V3 |
GAS_OVERHEAD | 25_000 | As in V3 |
SUCCESSOR_DELAY | 24 hours | As in FeeHarvesterV2 |
MAX_HALVINGS (private) | 8 | Sizes tried for a buy too large for the tolerance, halving each time (down to 1/128) |
targetDeposit (immutable) | 0.1 ether | EntryPoint deposit the harvester keeps for the vault |
NoteRefund
| Constant | Value | Meaning |
|---|---|---|
ROOT | 18245288291973779630509445427376437660009926679625643508353614234913233621661 | The earlier vault's note-tree root at block 86632173, its last state |
BACKING | 90422335996389553352857672 | The earlier vault's totalBacking then, in wei of ZERO |
SHARES | 20520873138048082021922500621968 | Its totalShares then |
VIRTUAL_SHARES | 1e6 | As in the vault: a note of s shares is refunded s * (BACKING + 1) / (SHARES + VIRTUAL_SHARES) |
| Refund fund | 90409186608928900835385885 wei (90,409,186.61 ZERO) | Every share but the locked seed's, at that value, rounded up |
| Spent before that state | 120 nullifiers | Notes already spent then, never refunded |
MIN_OP_COST_WEI / MAX_OP_COST_WEI | 0.00005 / 0.001 ETH | Range of the cap on a claim's gas cost; it starts at 0.0002 ETH |
REFUND_CALL_GAS (SDK) | 1_300_000 | Execution gas of a claim: the shield into the vault |
PoseidonMerkleTree
The same values hold in the circuit and in the app.
| Constant | Value | Meaning |
|---|---|---|
TREE_DEPTH | 24 | 2^24 = 16,777,216 leaves per tree |
ROOT_HISTORY_SIZE | 64 | Recent roots accepted by isKnownRoot; final roots of full trees stay valid forever |
| Empty leaf | 0 | |
| Insertion | pairs of leaves | 1 + 23 = 24 tree hashes per insertion; a single note is paired with an empty leaf |
NoteHash and the circuit
| Constant | Value | Meaning |
|---|---|---|
FIELD | 0x30644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001 (21888242871839275222246405745257275088548364400416034343698204186575808495617) | BN254 scalar field modulus |
DOMAIN_NOTE | 1 | cm = H(DOMAIN_NOTE, stub, shares) |
DOMAIN_NULLIFIER | 2 | nf = H(DOMAIN_NULLIFIER, nk, cm, index) |
SHARES_BITS | 120 | Maximum bit size of any share amount in the circuit |
SPEND_TYPEHASH | keccak256("Spend(bytes32 transaction)") | EIP-712 type the wallet signs for every spend |
| Hash | Poseidon2 over BN254 | stub = H(opk, rho, r), opk = H(nk, wallet key limbs), tree nodes H(left, right) |
Circuit and proof sizes
| Item | Value |
|---|---|
| Inputs and outputs | 2 input notes, 2 output notes |
| Public inputs | 9: root, 2 nullifiers, 2 commitments, exit shares, extDataHash, domain separator high and low 128 bits |
NUMBER_OF_PUBLIC_INPUTS in the generated verifier | 17 |
VK_HASH in the generated verifier | 0x099927050be607d17373997a1fb29eb5ae5f68756b81a6b1faa5c81304743cc0 |
NUM_SMALL_IPA_OPENING_CLAIMS in the generated verifier | 5: the small-subgroup IPA also opens the grand sum at 1 |
| Circuit size | N = 131072 (2^17, LOG_N = 17) |
| Gates | 83,781, of which about 73,000 check the wallet signature (measured) |
| Proof size | 9,152 bytes (PROOF_BYTES) |
| Proof system | UltraHonk, EVM target (-t evm: keccak transcript, ZK) |
| On-chain verification | about 2.42M gas (measured, forge test --gas-report) |
| Proving time | about 1.3 s in Node, 3 to 5 s in desktop Chrome (measured) |
| Toolchain | nargo and @noir-lang/noir_js 1.0.0-beta.25, bb and @aztec/bb.js 5.2.1, noir-lang/poseidon v0.3.0; pinned in circuits/scripts/toolchain.sh, downloaded from the GitHub releases with checksums checked |
Pons terms
Set by Pons V2 when it created ZERO, and frozen since. Read them from the curve (feeBps, creatorTaxBps,
protocolFeeShareBps) and from factory.getLaunchedToken(zero).
| Term | Value | Meaning |
|---|---|---|
| Supply | 1,000,000,000 ZERO (18 decimals) | Minted into the bonding curve at launch |
Standard fee (feeBps) | 100 (1%) | On every trade, on the curve and on the graduated pool |
Pons share (protocolFeeShareBps) | 3000 (30% of the standard fee) | Kept by Pons |
Creator tax (creatorTaxBps) | 0 | On every trade, all to the creator fee recipient (the harvester). Pons caps it with maxCreatorTaxBps() |
| Buyback | disabled (buybackEnabled = false) | All of the creator share goes to the harvester |
| Trader pays | 1% | Standard fee plus creator tax |
| Reaches the harvester | 0.7% | 70% of the standard fee |
| Of which to the team | 0.35% | The harvester's TEAM_SHARE_BPS; the other 0.35% is the private holders' (gas deposit, then ZERO for the vault) |
| Fee currency | ETH | Credited to the Pons fee escrow; the harvester calls claim() |
| Graduation threshold | 4.2 ETH collected by the curve | Then graduate and createGraduatedPool, both permissionless |
| Graduated pool | fee 0, tick spacing 200, hook factory.memeHook() | Native ETH as currency0, ZERO as currency1 |
| Opening snipe tax | 99%, decaying to 0 over 5 seconds | On buys only; addresses named at launch are exempt, as Pons' rules allow |
| Launch phases | 0 not graduated, 1 swept, 2 pool created | PonsLaunchedToken.phase |
Deployment values
| Item | Value | Meaning |
|---|---|---|
| Token name / symbol | zerotrace / ZERO | ZERO's expected name and symbol, checked before deploying; the name is also the vault's EIP-712 domain name |
| Creator tax | 0 | ZERO's expected Pons creator tax, checked before deploying |
| Seed purchase | 0.001 ether | SEED_ETH of DeployV3.s.sol: spent on ZERO for the locked seed note, bought through the router |
| Seed note stub | keccak256("zerotrace/locked-seed") mod FIELD | Nobody knows a preimage, so the note cannot be spent |
| Initial gas deposit | 0.1 ether | GAS_DEPOSIT of DeployV3.s.sol: the vault's initial EntryPoint deposit |
| Target deposit | 0.1 ether | The harvester's target, read from the previous harvester |
OP_COST_WEI of DeployV3.s.sol | 0.0002 ether | The vault's operation cost at deployment |
| Vault roles | ADMIN, UPGRADER, GUARDIAN of DeployV3.s.sol | At launch all three are 0x1B0210b9695BbEB8bD70964A46bf512021127A73 (the deployer). On Robinhood Chain ADMIN and UPGRADER must be named explicitly; GUARDIAN defaults to the deployer |
| Harvester owner | HARVESTER_OWNER of DeployV3.s.sol | 0x1B0210b9695BbEB8bD70964A46bf512021127A73 (the deployer); defaults to the previous harvester's owner |
| Harvester team recipient | 0x1B0210b9695BbEB8bD70964A46bf512021127A73 | Read from the previous harvester |
| Successor delay of the previous harvester | 24 hours | The hand-over from FeeHarvesterV2 to FeeHarvesterV3, executed by DeployV3.s.sol's execute() |
| Optimizer runs | 200 for PrivateVault, 10_000 for every other contract | The vault at 10,000 runs exceeds the 24,576-byte contract size limit |
| Salt namespace | zerotrace-v1 | Salt namespace of the CREATE3 addresses |
| CreateX | 0xba5Ed099633D3B313e4D5F7bdc1305d3c28ba5Ed | CREATE3 factory for the first deployment's contracts, the hasher and the launch harvester among them; salts are guarded by the deployer and the chain ID |
| Pons factory | 0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e | Pons V2 launch factory |
| Pons fee escrow | 0xd3AFEB2a57f70eF218Aa82451c51B2fb0416Ac9e | Where Pons credits the creator fees |
| PoolManager | 0x8366a39CC670B4001A1121B8F6A443A643e40951 | Uniswap v4 PoolManager |
| EntryPoint | 0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108 | ERC-4337 EntryPoint v0.8 |
App defaults
What the ZeroTrace app uses when it builds a private transaction.
| Item | Value | Meaning |
|---|---|---|
| Verification gas limit | 5,500,000 | Validation gas limit of every private action |
| Call gas, sale | 650,000 | Execution gas of a sale (the swap and the ETH transfer) |
| Call gas, send or unshield | 60,000 | Execution gas of a send or unshield |
| Proof size | 9152 bytes | The placeholder proof used for estimates has the same size |
| EntryPoint | 0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108 | Canonical EntryPoint v0.8 |
| CRS points | 2 ** 17 (131072) | CRS points the prover loads, served by the app |
| Note ciphertext length | 286 bytes | 32 (ephemeral key) + 1 (view tag) + 24 (nonce) + 96 + 117 (memo) + 16 (tag) |
| Share amount limit | 2 ** 120 | The same bound as SHARES_BITS in the circuit |
| Slippage | 100 bps (1%) | Minimum output = quote × (10,000 − slippage) / 10,000 |
| Provisional gas | preVerificationGas 1,000,000; maxFeePerGas 0.1 gwei; maxPriorityFeePerGas 1,000,000 wei | Used before the bundler's estimate, when the bundler reports no price |
| Fee in shares | shares worth networkFee, rounded up, plus 1 | Shares paid as the network fee |
| Gas cost check | (verificationGasLimit + callGasLimit + preVerificationGas) * maxFeePerGas <= maxOpCostWei | Checked before proving; above it the app asks to try again later |
| Bundler gas price | standard × 5/4 | From pimlico_getUserOperationGasPrice |
Bundler preVerificationGas | estimate × 11/10 | |
| Bundler receipt polling | from every 2 s, backing off to 5 s | Gives up after 2 minutes |
| Direct submission gas | 20,000,000 | Gas of the handleOps call when the wallet submits it itself |
Key-derivation Issued At | 2026-01-01T00:00:00.000Z | Fixed, so the message and the keys are deterministic |
Key-derivation Nonce | first 16 hex characters of the earlier vault's address | The key and payment-link messages name the earlier vault (Deployment.keyVault), so wallets keep their keys and private address |
Services
| Item | Value |
|---|---|
| App domain | zerotrace.so |
| Bundler | https://public.pimlico.io/v2/4663/rpc |
Indexer page size of /events | 2000 events |
Post-mortem, 12 October 2026
How the earlier ZeroTrace vault was emptied by a forged proof that a flawed Barretenberg verifier accepted, what we have done, and the refund of every note.
Glossary
Short definitions of the terms used across the ZeroTrace documentation, with links to where each is explained.