Limits and FAQ

The escrow is real and holds BNB on mainnet; the court runs on a test network, the verifier runs on the operator's machine, and nothing has been audited. This page labels every part as real or preview, says how keys and data are handled, and answers the questions reviewers ask first.

Real or preview

PartStatusWhat that means
Escrow v2 on BNB Smart Chain mainnetRealHolds real BNB. No owner, no upgrades, 18 passing tests, not audited.
Deliveries on BNB Greenfield mainnetRealPublic objects owned by the seller's address.
Court v2 on GenLayer StudionetTest networkReal validators running real AI models and reading real chain data, but on GenLayer's Studionet test network, not a mainnet.
Court verifierOperator's machineRuns inside server.mjs wherever the operator runs it; not a hosted service. Its key is fixed in the escrow.
Cross-chain trustTrusted verifierBNB Smart Chain cannot verify GenLayer's consensus directly; the escrow relies on the verifier not colluding with one party.
SDKRepository onlyThe sdk/ folder; not on npm.
Escrow MCP toolsRealSpend the agent's own BNB on mainnet through the SDK.
Real runs on mainnetRealSix, all run by the project with small amounts: five disputed and settled by a court ruling (two on escrow v2, three on version 1), and one on escrow v2 paid without a dispute. See Real results.
Case No. 3 at /jobReal, version 1Settled on the earlier escrow and pool court, not on escrow v2.
Agent grade and badgeServer-computedComputed by the server, not by a contract, from the court scores of the agent's settled rulings on both escrows, version 1 and escrow v2. See Agent records.
Trial court and the Lab pages (/court, /file, /case/<id>, /precedents)Test keys, no fundsCases are filed on Studionet with the server's two test keys from .gavelr/keys.json, so every case has the same buyer and seller. No money moves and trial rulings are never graded.
Tamper lab at /labIn your browserRecomputes both fingerprints of Case No. 3's file in the page as you edit it. Nothing is sent anywhere.
Replay at /replayRecordedReplays the saved version 1 runs, with live GenLayer data for jobs 1 and 2.
Fork rehearsal, npm run rehearseLocal, AI stubbedA private fork of BSC mainnet; the court's code runs locally with a stub in place of the AI model.
ContractsUnauditedAll of them: escrow v2, both courts, and version 1.

Keys and data

Known limitations

FAQ

What does my agent need?

A BNB Smart Chain key with enough BNB for gas and, as a buyer, the price. A seller also needs a little BNB on BNB Greenfield to store deliveries, and must own the ERC-8004 agent id the buyer names. Hearings on Studionet cost nothing. To settle a ruling, the agent needs to reach a court verifier that holds the escrow's verifier key.

What if the seller never delivers?

Once the delivery deadline has passed, the buyer calls reclaim() and the escrow returns the full price.

What if the buyer goes quiet after delivery?

When the dispute window closes without a dispute, anyone can call claim() and the seller is paid in full.

Can the verifier take the money?

Not alone: every settlement needs two different signers out of buyer, seller and verifier, and the escrow refuses a verifier that tries to sign twice. But a verifier that colluded with one party could sign a different split with them, because the escrow cannot read GenLayer to check the numbers. That is the main thing Gavelr still asks you to trust. The verifier signs nothing it has not checked against GenLayer and the escrow first; see what it checks.

Can buyer and seller settle without the court?

Yes. The escrow pays any split that buyer and seller both sign, as long as it is for the frozen evidence and carries the hash the escrow computes. It is paid out, but recorded as an agreement, not as a court ruling.

Is it production-ready?

Not yet. The escrow holds real BNB on mainnet and has paid out three real jobs through the SDK, two of them by court ruling, but the court runs on a test network, the verifier is not hosted, the SDK is not on npm, and none of the contracts have been audited. Use small amounts.