# Miden Documentation

> Miden is a privacy-preserving blockchain where users execute and prove transactions locally. Accounts are programmable smart contracts, notes are programmable messages, and private state stays client-side unless a developer opts into public or network-visible state.

- [Docs home](https://docs.miden.xyz/): Latest stable docs, currently 0.14.
- [Next / unstable builder docs](https://docs.miden.xyz/next/builder/): Current development builder docs, currently labeled 0.15 unstable.
- [Next / unstable reference](https://docs.miden.xyz/next/reference/): Current development protocol, VM, node, and compiler docs.
- [Agent skill](https://docs.miden.xyz/skill.md): Compact Miden context for AI coding assistants.
- [GitHub organization](https://github.com/0xMiden): Source repositories.

## Builder Documentation

- [Get Started](https://docs.miden.xyz/builder/get-started/): Install the toolchain, create accounts, work with notes, read storage, and build a first smart contract.
- [Installation](https://docs.miden.xyz/builder/get-started/setup/installation): Install Miden tools with `midenup`.
- [CLI Basics](https://docs.miden.xyz/builder/get-started/setup/cli-basics): Common account, note, sync, and transaction commands.
- [Accounts](https://docs.miden.xyz/builder/get-started/accounts): Account types, storage modes, and creation patterns.
- [Notes](https://docs.miden.xyz/builder/get-started/notes): Note concepts and asset transfer flow.
- [Read Storage](https://docs.miden.xyz/builder/get-started/read-storage): Query account storage and inspect on-chain state.
- [Your First Smart Contract](https://docs.miden.xyz/builder/get-started/your-first-smart-contract/): Build, test, and deploy a Rust smart contract.

## Smart Contracts

- [Smart Contracts](https://docs.miden.xyz/builder/smart-contracts/): Rust SDK reference for Miden smart contracts.
- [Overview](https://docs.miden.xyz/builder/smart-contracts/overview): Execution model, account logic, notes, and transactions.
- [Accounts](https://docs.miden.xyz/builder/smart-contracts/accounts/introduction): Components, storage, custom types, operations, cryptography, and authentication.
- [Notes](https://docs.miden.xyz/builder/smart-contracts/notes/introduction): Note scripts, note types, output notes, and note data access.
- [Transactions](https://docs.miden.xyz/builder/smart-contracts/transactions/introduction): Transaction context, scripts, and advice provider usage.
- [Cross-component Calls](https://docs.miden.xyz/builder/smart-contracts/cross-component-calls): Calling account component methods from other components or note scripts.
- [Types](https://docs.miden.xyz/builder/smart-contracts/types): Felt, Word, AccountId, NoteId, Asset, and other core Rust SDK types.

## Client SDKs and Tools

- [Clients](https://docs.miden.xyz/builder/tools/clients/): Rust, TypeScript, and React client SDK overview.
- [Rust Client](https://docs.miden.xyz/builder/tools/clients/rust-client/): Native client library and CLI documentation.
- [Web SDK](https://docs.miden.xyz/builder/tools/clients/web-client/): `@miden-sdk/miden-sdk` browser and TypeScript API.
- [React SDK](https://docs.miden.xyz/builder/tools/clients/react-sdk/): `@miden-sdk/react` provider, hooks, signers, and recipes.
- [Common Client Errors](https://docs.miden.xyz/builder/tools/clients/common-errors): Shared diagnostics and recovery patterns.
- [midenup](https://docs.miden.xyz/builder/tools/midenup): Miden toolchain installer.
- [Network](https://docs.miden.xyz/builder/tools/network): Public network and endpoint information.
- [Playground](https://docs.miden.xyz/builder/tools/playground): Browser-based contract playground.

## Tutorials and Guides

- [Tutorials](https://docs.miden.xyz/builder/tutorials/): Hands-on tutorials and reusable development helpers.
- [Miden Bank Tutorial](https://docs.miden.xyz/builder/tutorials/miden-bank/): End-to-end smart contract tutorial.
- [Testing Helpers](https://docs.miden.xyz/builder/tutorials/helpers/testing): Testing patterns for Miden applications.
- [Debugging Helpers](https://docs.miden.xyz/builder/tutorials/helpers/debugging): Debugging transaction and MASM failures.
- [Common Pitfalls](https://docs.miden.xyz/builder/tutorials/helpers/pitfalls): Practical issues developers hit while building.
- [Migration Guide](https://docs.miden.xyz/builder/migration/): Current migration notes across protocol, SDK, client, VM, and assembler changes.

## Guardian and Application Patterns

- [Miden Guardian](https://docs.miden.xyz/builder/miden-guardian/): Assisted self-custody architecture and operator documentation.
- [Guardian Quickstart](https://docs.miden.xyz/builder/miden-guardian/getting-started/quickstart): How to get and run the Guardian service.
- [Guardian Production Guide](https://docs.miden.xyz/builder/miden-guardian/operations/production): Production deployment configuration.
- [Multisig SDK](https://docs.miden.xyz/builder/miden-guardian/reference/multisig-sdk): Private multisig concepts and SDK usage.

## Reference

- [Reference](https://docs.miden.xyz/reference/): Protocol, VM, compiler, and node architecture.
- [Protocol](https://docs.miden.xyz/reference/protocol/): Accounts, assets, blockchain state, notes, transactions, and protocol MASM library.
- [Miden VM](https://docs.miden.xyz/reference/miden-vm/): VM architecture, programs, user docs, tooling, and performance.
- [Compiler](https://docs.miden.xyz/reference/compiler/): Rust-to-MASM compiler usage and guides.
- [Node](https://docs.miden.xyz/reference/node/): Node services, operator guide, and RPC reference.

## Source Repositories

- [docs](https://github.com/0xMiden/docs): Docusaurus documentation site.
- [protocol](https://github.com/0xMiden/protocol): Protocol types, account model, notes, assets, transactions, and MASM protocol library.
- [miden-vm](https://github.com/0xMiden/miden-vm): Virtual machine and assembler.
- [miden-client](https://github.com/0xMiden/miden-client): Rust client, Web SDK, and React SDK.
- [node](https://github.com/0xMiden/node): Miden node implementation.
- [compiler](https://github.com/0xMiden/compiler): Rust-to-MASM compiler.
- [tutorials](https://github.com/0xMiden/tutorials): Tutorial source content.