> For the complete documentation index, see [llms.txt](https://docs.zecblocks.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zecblocks.xyz/reference-implementation.md).

# Reference implementation

ZB-1 is intended to have a public reference implementation released under the MIT License.

The release should contain:

```
zb1/
├── LICENSE
├── README.md
├── SPEC.md
├── manifest/
├── miner/
├── claim/
├── validator/
├── ownership/
├── marketplace/
└── bitmap-v1/
```

## Release requirements

Before public mining opens, the reference package should include:

* 26-bit SHA-256 miner
* canonical proof encoder
* claim builder
* claim validator
* deterministic state reconstruction
* Ed25519 ownership tooling
* TRANSFER validation
* SALE / BUY validation
* 3% marketplace fee verification
* `BITMAP_V1`
* Genesis manifest
* reproducible test vectors

{% hint style="warning" %}
A specification alone is not enough to safely open public mining. The event encodings and validators must be public and end-to-end tested against the confirmed Genesis.
{% endhint %}

The downloadable source archive and its SHA-256 checksum will be published here when the public v1 client is ready.