# sealForge

> Auditable sealed-bid auctions on Zcash: the clearing price is public, the bidders aren't.

- [sealForge documentation](https://sealforge.mintlify.app/index.md): Auditable sealed-bid auctions on Zcash: the clearing price is public, the bidders aren't. How these docs are organised and what the status labels mean.
- [Overview](https://sealforge.mintlify.app/overview.md): What sealForge is, the status of every component, the three guarantees stated precisely, and what is not guaranteed.
- [Roles and what each one knows](https://sealforge.mintlify.app/protocol/roles.md): Who holds which keys and data, and what each role can see or do: organiser, bidder, trustees, coordinator, observers and auditors.
- [Lifecycle state machine](https://sealforge.mintlify.app/protocol/lifecycle.md): Auction and batch state machines with triggers, actors and height rules: MIN_OPEN_BLOCKS, CLOSE_CONFIRMATIONS, reveal window, signer reset.
- [Wire formats](https://sealforge.mintlify.app/protocol/wire-formats.md): Byte-exact grammar and limits for the SF1 bid memo, SF1R reveal memo, SF1FEE memo, auction code, ZIP 321 URI, receipt and published result.
- [Commitments and domain separation](https://sealforge.mintlify.app/protocol/commitments.md): Every BLAKE2b personalization and byte layout: bid and price commitments, Merkle leaf, node and root, binding, salts and Rust/TS parity.
- [Bid selection](https://sealforge.mintlify.app/protocol/selection.md): The ordered rules that classify each escrow payment, in deposit and sealed-reveal mode, shared by the coordinator and every auditor.
- [Clearing](https://sealforge.mintlify.app/protocol/clearing.md): Uniform-price and first-price clearing: eligibility, the canonical sort key, undersubscribed auctions and the determinism guarantee.
- [Refund privacy](https://sealforge.mintlify.app/protocol/refunds.md): Canonical refund denominations, dropped dust, CSPRNG delays and mixed batches, with the linkability measurement method and known residuals.
- [Zcash integration reference](https://sealforge.mintlify.app/zcash-integration.md): Every protocol touchpoint: Ironwood, Unified Addresses and viewing keys, escrow key construction, FROST, PCZT, fees, memos, scanning, randomness and upstream risk.
- [Architecture and infrastructure](https://sealforge.mintlify.app/architecture.md): Components, crate map, sequence diagrams, DKG relay security, API authentication, data model, deployment and browser supply chain.
- [Security](https://sealforge.mintlify.app/security.md): Trust assumptions first, then the threat model summary, key custody, review findings and the mainnet gate checklist.
- [Verification and evidence](https://sealforge.mintlify.app/verification.md): How to audit any auction from the chain, the testnet record, reproducibility, CI and the test inventory.
- [Guides](https://sealforge.mintlify.app/guides.md): Role-by-role guides for organisers, trustees, bidders, auditors and integrators.
- [API and SDK reference](https://sealforge.mintlify.app/api-reference.md): Coordinator REST routes with auth and errors, the @sealforge/bid TypeScript package, and the Rust crates as libraries.
- [Product and economics](https://sealforge.mintlify.app/product.md): The problem, why Zcash, verticals, revenue models (all specified, none built) and unit economics from measured testnet costs.
- [Roadmap and mainnet gates](https://sealforge.mintlify.app/roadmap.md): Phases from docs review to mainnet, each with an exit criterion.
- [Open questions for reviewers](https://sealforge.mintlify.app/open-questions.md): Precise questions where outside review would change the design: keys, commitments, disclosure, refunds, chain handling and performance.
- [Glossary](https://sealforge.mintlify.app/appendix/glossary.md): Terms used across the sealForge documentation.
- [Test vectors](https://sealforge.mintlify.app/appendix/test-vectors.md): Cross-language vectors for commitments, memos, ZIP 321 URIs, Merkle leaves, nodes, roots and a 20-bid result.
- [ZIP and spec index](https://sealforge.mintlify.app/appendix/specs.md): Every ZIP, protocol specification section and RFC cited, and what for.
- [Changelog and memo versioning](https://sealforge.mintlify.app/appendix/changelog.md): Documentation changes and the memo-format version history.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.