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

# Mazze docs

Documentation for Mazze: a PoW layer 1 on a DAG, with three spaces on one chain — Native, eSpace (EVM) and a post-quantum Shielded space.

**Mazze is a Proof-of-Work layer 1 that orders blocks as a DAG.** One chain, one state root, three spaces: a native space, an Ethereum-compatible eSpace, and a shielded space for private payments.

{% hint style="info" %}
**Updated 20 October 2026** to the current `mazze-rust-release` code, including the `shielded-space` branch. Start with [What's new](/whats-new.md) if you have read these docs before.
{% endhint %}

## One chain, three spaces

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:orange;"><strong>● NATIVE</strong></mark></td><td><strong>Native space</strong></td><td>Base32 addresses, sponsorship and storage collateral, internal contracts. Served by <code>mazze_*</code> RPC.</td><td><a href="/overview/three-spaces.md">Three spaces</a></td></tr><tr><td><mark style="color:purple;"><strong>● ESPACE</strong></mark></td><td><strong>eSpace (EVM)</strong></td><td>Ethereum-compatible, on revm 40 with the Prague spec. MetaMask, Foundry and Hardhat work as they do on Ethereum.</td><td><a href="/developers/evm-compatibility.md">EVM compatibility</a></td></tr><tr><td><strong>● SHIELDED</strong></td><td><strong>Shielded space</strong></td><td>Private notes proven with post-quantum STARKs. Running on devnet; inactive on public networks until activation.</td><td><a href="/shielded-space/privacy.md">Shielded space</a></td></tr></tbody></table>

## Explore the docs

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Overview</strong></td><td>What Mazze is, the three spaces, and the specifications.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-aa01609e9a273676902e255b0a316412dbdf7eeb%2Fcard-overview.png?alt=media">card-overview.png</a></td><td><a href="/overview/introduction.md">Introduction</a></td></tr><tr><td><strong>Architecture</strong></td><td>How the node works, from the transaction pool to storage.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-38893d6d7bd3b6259d551029d97711fca97dcf15%2Fcard-architecture.png?alt=media">card-architecture.png</a></td><td><a href="/architecture/architecture.md">Mazze node architecture</a></td></tr><tr><td><strong>Shielded space</strong></td><td>Notes, nullifiers, STARK proofs, the shielded lane and the wallet.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-e7d480153d4278df7633409decfae62e16b7929e%2Fcard-privacy.png?alt=media">card-privacy.png</a></td><td><a href="/shielded-space/privacy.md">Shielded space</a></td></tr><tr><td><strong>Developers</strong></td><td>Build on eSpace with Ethereum tools, or call the native RPC.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-519117dacc4bb99e178e9b38bcce93efff2cbf2b%2Fcard-developers.png?alt=media">card-developers.png</a></td><td><a href="/developers/overview.md">Overview</a></td></tr><tr><td><strong>Run a node</strong></td><td>Set up a node and a miner, use the CLI and the RPC, and read the logs.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-f590c142eb0d9ae8eae627fd8b6dc77430e1d1b4%2Fcard-node.png?alt=media">card-node.png</a></td><td><a href="/run-a-node/introduction-to-mazze-testnet.md">Run a node</a></td></tr><tr><td><strong>Tokenomics</strong></td><td>Issuance, allocations, the wrapped token and bridge liquidity.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-79eab09c7ee263c0db20e1de5e67780548d8aa7f%2Fcard-tokenomics.png?alt=media">card-tokenomics.png</a></td><td><a href="/tokenomics/overview.md">Overview</a></td></tr><tr><td><strong>Knowledge base</strong></td><td>Answers to common questions and the terms used in these docs.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-990e5b8e276b73ff2795874af3a411edcc745865%2Fcard-knowledge.png?alt=media">card-knowledge.png</a></td><td><a href="/knowledge-base/faq.md">FAQ</a></td></tr><tr><td><strong>Community</strong></td><td>Ambassadors, the hackathon, grants and campaigns.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-b03fef90cf5983013a39f635c4ed74e3ae36b3d4%2Fcard-community.png?alt=media">card-community.png</a></td><td><a href="/community/grant-program.md">Grant program</a></td></tr><tr><td><strong>Roadmap</strong></td><td>What is done and what comes next, phase by phase.</td><td><a href="https://1357981310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAeIGZKbaFvqhD69HxCH%2Fuploads%2Fgit-blob-c3b258f39d17d03121eaf561cd5159316e792ba7%2Fcard-roadmap.png?alt=media">card-roadmap.png</a></td><td><a href="/roadmap/phases.md">Phases</a></td></tr></tbody></table>

## Quick start

{% stepper %}
{% step %}

### Run a node

Start a node and a miner with Docker Compose, or build them from source. See the [setup guide](/run-a-node/setup-guide.md).
{% endstep %}

{% step %}

### Check that it syncs

```bash
./run/mazze-cli.sh summary
```

The [CLI guide](/run-a-node/mazze-cli.md) covers wallets and transfers.
{% endstep %}

{% step %}

### Connect a wallet or your tools

Point MetaMask, Foundry or Hardhat at the eSpace RPC. See [Wallet connection](/run-a-node/how-to-add-the-mazze-testnet-to-metamask.md) and [Deploying smart contracts](/run-a-node/deploying-smart-contracts-on-mazze-testnet.md).
{% endstep %}

{% step %}

### Explore the chain

Follow blocks, epochs and the live DAG on the explorer at [mazzescan.io](https://mazzescan.io).
{% endstep %}
{% endstepper %}

## At a glance

|           |                                                          |
| --------- | -------------------------------------------------------- |
| Security  | Proof of Work, RandomX                                   |
| Ledger    | DAG of blocks, ordered by DETS into epochs               |
| Execution | Native interpreter · revm 40 (Prague) for eSpace         |
| Privacy   | 2-in × 2-out notes, PS-1 STARK, 128-bit proven soundness |
| Storage   | MDBX hot tier · ParityDB cold tier                       |
| RPC       | JSON-RPC over HTTP, WebSocket and TCP (jsonrpsee)        |

The full list is in [Technical specifications](/overview/technical-specifications.md).