From 3e4d2243a380afc009635ce5531e24bfde01ca24 Mon Sep 17 00:00:00 2001 From: Marti Date: Mon, 27 Apr 2026 14:17:19 +0000 Subject: [PATCH 1/4] chore: move docs to docs/protocol --- docs/src/{ => protocol}/_category_.yml | 0 docs/src/{ => protocol}/account/_category_.yml | 0 docs/src/{ => protocol}/account/address.md | 0 docs/src/{ => protocol}/account/code.md | 0 docs/src/{ => protocol}/account/components.md | 0 docs/src/{ => protocol}/account/id.md | 0 docs/src/{ => protocol}/account/index.md | 0 docs/src/{ => protocol}/account/storage.md | 0 docs/src/{ => protocol}/asset.md | 0 docs/src/{ => protocol}/blockchain.md | 0 docs/src/{ => protocol}/fees.md | 0 .../img/account/account-definition.png | Bin .../src/{ => protocol}/img/asset/asset-issuance.png | Bin docs/src/{ => protocol}/img/asset/asset-storage.png | Bin docs/src/{ => protocol}/img/blockchain/batching.png | Bin docs/src/{ => protocol}/img/blockchain/block.png | Bin .../src/{ => protocol}/img/blockchain/execution.png | Bin .../img/miden-architecture-core-concepts.gif | Bin .../img/miden-architecture-state-progress.gif | Bin docs/src/{ => protocol}/img/network/Miden_node.png | Bin .../img/network/architecture-overview.png | Bin .../src/{ => protocol}/img/note/note-life-cycle.png | Bin docs/src/{ => protocol}/img/note/note.png | Bin docs/src/{ => protocol}/img/note/nullifier.png | Bin docs/src/{ => protocol}/img/state/account-db.png | Bin .../{ => protocol}/img/state/amm-transactions.gif | Bin docs/src/{ => protocol}/img/state/note-db.png | Bin docs/src/{ => protocol}/img/state/nullifier-db.png | Bin .../img/state/public-shared-state.png | Bin docs/src/{ => protocol}/img/state/state.png | Bin .../transaction/local-vs-network-transaction.png | Bin .../img/transaction/memory-layout-kernel.png | Bin .../transaction/one-transfer-two-transactions.gif | Bin .../img/transaction/transaction-contexts.png | Bin .../img/transaction/transaction-diagram.png | Bin .../transaction/transaction-execution-process.png | Bin .../img/transaction/transaction-flow.png | Bin .../img/transaction/transaction-program.png | Bin .../{ => protocol}/img/transaction/tx-overview.png | Bin docs/src/{ => protocol}/index.md | 0 docs/src/{ => protocol}/note.md | 0 docs/src/{ => protocol}/protocol_library.md | 0 docs/src/{ => protocol}/state.md | 0 docs/src/{ => protocol}/transaction.md | 0 44 files changed, 0 insertions(+), 0 deletions(-) rename docs/src/{ => protocol}/_category_.yml (100%) rename docs/src/{ => protocol}/account/_category_.yml (100%) rename docs/src/{ => protocol}/account/address.md (100%) rename docs/src/{ => protocol}/account/code.md (100%) rename docs/src/{ => protocol}/account/components.md (100%) rename docs/src/{ => protocol}/account/id.md (100%) rename docs/src/{ => protocol}/account/index.md (100%) rename docs/src/{ => protocol}/account/storage.md (100%) rename docs/src/{ => protocol}/asset.md (100%) rename docs/src/{ => protocol}/blockchain.md (100%) rename docs/src/{ => protocol}/fees.md (100%) rename docs/src/{ => protocol}/img/account/account-definition.png (100%) rename docs/src/{ => protocol}/img/asset/asset-issuance.png (100%) rename docs/src/{ => protocol}/img/asset/asset-storage.png (100%) rename docs/src/{ => protocol}/img/blockchain/batching.png (100%) rename docs/src/{ => protocol}/img/blockchain/block.png (100%) rename docs/src/{ => protocol}/img/blockchain/execution.png (100%) rename docs/src/{ => protocol}/img/miden-architecture-core-concepts.gif (100%) rename docs/src/{ => protocol}/img/miden-architecture-state-progress.gif (100%) rename docs/src/{ => protocol}/img/network/Miden_node.png (100%) rename docs/src/{ => protocol}/img/network/architecture-overview.png (100%) rename docs/src/{ => protocol}/img/note/note-life-cycle.png (100%) rename docs/src/{ => protocol}/img/note/note.png (100%) rename docs/src/{ => protocol}/img/note/nullifier.png (100%) rename docs/src/{ => protocol}/img/state/account-db.png (100%) rename docs/src/{ => protocol}/img/state/amm-transactions.gif (100%) rename docs/src/{ => protocol}/img/state/note-db.png (100%) rename docs/src/{ => protocol}/img/state/nullifier-db.png (100%) rename docs/src/{ => protocol}/img/state/public-shared-state.png (100%) rename docs/src/{ => protocol}/img/state/state.png (100%) rename docs/src/{ => protocol}/img/transaction/local-vs-network-transaction.png (100%) rename docs/src/{ => protocol}/img/transaction/memory-layout-kernel.png (100%) rename docs/src/{ => protocol}/img/transaction/one-transfer-two-transactions.gif (100%) rename docs/src/{ => protocol}/img/transaction/transaction-contexts.png (100%) rename docs/src/{ => protocol}/img/transaction/transaction-diagram.png (100%) rename docs/src/{ => protocol}/img/transaction/transaction-execution-process.png (100%) rename docs/src/{ => protocol}/img/transaction/transaction-flow.png (100%) rename docs/src/{ => protocol}/img/transaction/transaction-program.png (100%) rename docs/src/{ => protocol}/img/transaction/tx-overview.png (100%) rename docs/src/{ => protocol}/index.md (100%) rename docs/src/{ => protocol}/note.md (100%) rename docs/src/{ => protocol}/protocol_library.md (100%) rename docs/src/{ => protocol}/state.md (100%) rename docs/src/{ => protocol}/transaction.md (100%) diff --git a/docs/src/_category_.yml b/docs/src/protocol/_category_.yml similarity index 100% rename from docs/src/_category_.yml rename to docs/src/protocol/_category_.yml diff --git a/docs/src/account/_category_.yml b/docs/src/protocol/account/_category_.yml similarity index 100% rename from docs/src/account/_category_.yml rename to docs/src/protocol/account/_category_.yml diff --git a/docs/src/account/address.md b/docs/src/protocol/account/address.md similarity index 100% rename from docs/src/account/address.md rename to docs/src/protocol/account/address.md diff --git a/docs/src/account/code.md b/docs/src/protocol/account/code.md similarity index 100% rename from docs/src/account/code.md rename to docs/src/protocol/account/code.md diff --git a/docs/src/account/components.md b/docs/src/protocol/account/components.md similarity index 100% rename from docs/src/account/components.md rename to docs/src/protocol/account/components.md diff --git a/docs/src/account/id.md b/docs/src/protocol/account/id.md similarity index 100% rename from docs/src/account/id.md rename to docs/src/protocol/account/id.md diff --git a/docs/src/account/index.md b/docs/src/protocol/account/index.md similarity index 100% rename from docs/src/account/index.md rename to docs/src/protocol/account/index.md diff --git a/docs/src/account/storage.md b/docs/src/protocol/account/storage.md similarity index 100% rename from docs/src/account/storage.md rename to docs/src/protocol/account/storage.md diff --git a/docs/src/asset.md b/docs/src/protocol/asset.md similarity index 100% rename from docs/src/asset.md rename to docs/src/protocol/asset.md diff --git a/docs/src/blockchain.md b/docs/src/protocol/blockchain.md similarity index 100% rename from docs/src/blockchain.md rename to docs/src/protocol/blockchain.md diff --git a/docs/src/fees.md b/docs/src/protocol/fees.md similarity index 100% rename from docs/src/fees.md rename to docs/src/protocol/fees.md diff --git a/docs/src/img/account/account-definition.png b/docs/src/protocol/img/account/account-definition.png similarity index 100% rename from docs/src/img/account/account-definition.png rename to docs/src/protocol/img/account/account-definition.png diff --git a/docs/src/img/asset/asset-issuance.png b/docs/src/protocol/img/asset/asset-issuance.png similarity index 100% rename from docs/src/img/asset/asset-issuance.png rename to docs/src/protocol/img/asset/asset-issuance.png diff --git a/docs/src/img/asset/asset-storage.png b/docs/src/protocol/img/asset/asset-storage.png similarity index 100% rename from docs/src/img/asset/asset-storage.png rename to docs/src/protocol/img/asset/asset-storage.png diff --git a/docs/src/img/blockchain/batching.png b/docs/src/protocol/img/blockchain/batching.png similarity index 100% rename from docs/src/img/blockchain/batching.png rename to docs/src/protocol/img/blockchain/batching.png diff --git a/docs/src/img/blockchain/block.png b/docs/src/protocol/img/blockchain/block.png similarity index 100% rename from docs/src/img/blockchain/block.png rename to docs/src/protocol/img/blockchain/block.png diff --git a/docs/src/img/blockchain/execution.png b/docs/src/protocol/img/blockchain/execution.png similarity index 100% rename from docs/src/img/blockchain/execution.png rename to docs/src/protocol/img/blockchain/execution.png diff --git a/docs/src/img/miden-architecture-core-concepts.gif b/docs/src/protocol/img/miden-architecture-core-concepts.gif similarity index 100% rename from docs/src/img/miden-architecture-core-concepts.gif rename to docs/src/protocol/img/miden-architecture-core-concepts.gif diff --git a/docs/src/img/miden-architecture-state-progress.gif b/docs/src/protocol/img/miden-architecture-state-progress.gif similarity index 100% rename from docs/src/img/miden-architecture-state-progress.gif rename to docs/src/protocol/img/miden-architecture-state-progress.gif diff --git a/docs/src/img/network/Miden_node.png b/docs/src/protocol/img/network/Miden_node.png similarity index 100% rename from docs/src/img/network/Miden_node.png rename to docs/src/protocol/img/network/Miden_node.png diff --git a/docs/src/img/network/architecture-overview.png b/docs/src/protocol/img/network/architecture-overview.png similarity index 100% rename from docs/src/img/network/architecture-overview.png rename to docs/src/protocol/img/network/architecture-overview.png diff --git a/docs/src/img/note/note-life-cycle.png b/docs/src/protocol/img/note/note-life-cycle.png similarity index 100% rename from docs/src/img/note/note-life-cycle.png rename to docs/src/protocol/img/note/note-life-cycle.png diff --git a/docs/src/img/note/note.png b/docs/src/protocol/img/note/note.png similarity index 100% rename from docs/src/img/note/note.png rename to docs/src/protocol/img/note/note.png diff --git a/docs/src/img/note/nullifier.png b/docs/src/protocol/img/note/nullifier.png similarity index 100% rename from docs/src/img/note/nullifier.png rename to docs/src/protocol/img/note/nullifier.png diff --git a/docs/src/img/state/account-db.png b/docs/src/protocol/img/state/account-db.png similarity index 100% rename from docs/src/img/state/account-db.png rename to docs/src/protocol/img/state/account-db.png diff --git a/docs/src/img/state/amm-transactions.gif b/docs/src/protocol/img/state/amm-transactions.gif similarity index 100% rename from docs/src/img/state/amm-transactions.gif rename to docs/src/protocol/img/state/amm-transactions.gif diff --git a/docs/src/img/state/note-db.png b/docs/src/protocol/img/state/note-db.png similarity index 100% rename from docs/src/img/state/note-db.png rename to docs/src/protocol/img/state/note-db.png diff --git a/docs/src/img/state/nullifier-db.png b/docs/src/protocol/img/state/nullifier-db.png similarity index 100% rename from docs/src/img/state/nullifier-db.png rename to docs/src/protocol/img/state/nullifier-db.png diff --git a/docs/src/img/state/public-shared-state.png b/docs/src/protocol/img/state/public-shared-state.png similarity index 100% rename from docs/src/img/state/public-shared-state.png rename to docs/src/protocol/img/state/public-shared-state.png diff --git a/docs/src/img/state/state.png b/docs/src/protocol/img/state/state.png similarity index 100% rename from docs/src/img/state/state.png rename to docs/src/protocol/img/state/state.png diff --git a/docs/src/img/transaction/local-vs-network-transaction.png b/docs/src/protocol/img/transaction/local-vs-network-transaction.png similarity index 100% rename from docs/src/img/transaction/local-vs-network-transaction.png rename to docs/src/protocol/img/transaction/local-vs-network-transaction.png diff --git a/docs/src/img/transaction/memory-layout-kernel.png b/docs/src/protocol/img/transaction/memory-layout-kernel.png similarity index 100% rename from docs/src/img/transaction/memory-layout-kernel.png rename to docs/src/protocol/img/transaction/memory-layout-kernel.png diff --git a/docs/src/img/transaction/one-transfer-two-transactions.gif b/docs/src/protocol/img/transaction/one-transfer-two-transactions.gif similarity index 100% rename from docs/src/img/transaction/one-transfer-two-transactions.gif rename to docs/src/protocol/img/transaction/one-transfer-two-transactions.gif diff --git a/docs/src/img/transaction/transaction-contexts.png b/docs/src/protocol/img/transaction/transaction-contexts.png similarity index 100% rename from docs/src/img/transaction/transaction-contexts.png rename to docs/src/protocol/img/transaction/transaction-contexts.png diff --git a/docs/src/img/transaction/transaction-diagram.png b/docs/src/protocol/img/transaction/transaction-diagram.png similarity index 100% rename from docs/src/img/transaction/transaction-diagram.png rename to docs/src/protocol/img/transaction/transaction-diagram.png diff --git a/docs/src/img/transaction/transaction-execution-process.png b/docs/src/protocol/img/transaction/transaction-execution-process.png similarity index 100% rename from docs/src/img/transaction/transaction-execution-process.png rename to docs/src/protocol/img/transaction/transaction-execution-process.png diff --git a/docs/src/img/transaction/transaction-flow.png b/docs/src/protocol/img/transaction/transaction-flow.png similarity index 100% rename from docs/src/img/transaction/transaction-flow.png rename to docs/src/protocol/img/transaction/transaction-flow.png diff --git a/docs/src/img/transaction/transaction-program.png b/docs/src/protocol/img/transaction/transaction-program.png similarity index 100% rename from docs/src/img/transaction/transaction-program.png rename to docs/src/protocol/img/transaction/transaction-program.png diff --git a/docs/src/img/transaction/tx-overview.png b/docs/src/protocol/img/transaction/tx-overview.png similarity index 100% rename from docs/src/img/transaction/tx-overview.png rename to docs/src/protocol/img/transaction/tx-overview.png diff --git a/docs/src/index.md b/docs/src/protocol/index.md similarity index 100% rename from docs/src/index.md rename to docs/src/protocol/index.md diff --git a/docs/src/note.md b/docs/src/protocol/note.md similarity index 100% rename from docs/src/note.md rename to docs/src/protocol/note.md diff --git a/docs/src/protocol_library.md b/docs/src/protocol/protocol_library.md similarity index 100% rename from docs/src/protocol_library.md rename to docs/src/protocol/protocol_library.md diff --git a/docs/src/state.md b/docs/src/protocol/state.md similarity index 100% rename from docs/src/state.md rename to docs/src/protocol/state.md diff --git a/docs/src/transaction.md b/docs/src/protocol/transaction.md similarity index 100% rename from docs/src/transaction.md rename to docs/src/protocol/transaction.md From 3c56f10dedeef5ca632ad2332b29a295d770eb8e Mon Sep 17 00:00:00 2001 From: Marti Date: Mon, 27 Apr 2026 14:17:31 +0000 Subject: [PATCH 2/4] chore: add placehold for standards --- docs/src/standards/_category_.yml | 4 ++++ docs/src/standards/index.md | 12 ++++++++++++ 2 files changed, 16 insertions(+) create mode 100644 docs/src/standards/_category_.yml create mode 100644 docs/src/standards/index.md diff --git a/docs/src/standards/_category_.yml b/docs/src/standards/_category_.yml new file mode 100644 index 0000000000..dd17e412bc --- /dev/null +++ b/docs/src/standards/_category_.yml @@ -0,0 +1,4 @@ +label: "Standards" +# Determines where this documentation section appears relative to other sections on the main documentation page (which is the parent of this folder in the miden-docs repository) +position: 4 +collapsed: true diff --git a/docs/src/standards/index.md b/docs/src/standards/index.md new file mode 100644 index 0000000000..359e7726a6 --- /dev/null +++ b/docs/src/standards/index.md @@ -0,0 +1,12 @@ +--- +sidebar_position: 1 +title: Overview +--- + +# Miden Standards + +:::note +Placeholder. Documentation for the components published by `miden-standards` will land here in follow-up PRs. +::: + +The `miden-standards` crate provides reusable account components that build on top of the [protocol](../protocol/index.md) primitives. Examples include faucet components, authentication components, access-control components, and mint/burn policies. From d1aeec61085fddff2d67f1e4e49e7dd318be2bfe Mon Sep 17 00:00:00 2001 From: "Claude (Opus)" Date: Thu, 30 Apr 2026 09:11:25 +0000 Subject: [PATCH 3/4] fix(docs): repair broken links after docs split After moving the protocol docs into docs/src/protocol/, the navbar/theme links to / were broken on every page (no homepage existed at the new root), and a handful of bare relative links (e.g. `note`, `asset`, `../transaction`, `../state#account-database`) resolved to /-level URLs because index pages render without a trailing slash. Add a placeholder docs/src/index.md so / resolves to a valid page in the local Docusaurus dev preview, and add explicit .md extensions to the sibling/parent links in protocol/index.md and protocol/account/index.md so they are resolved as Docusaurus doc references. --- docs/src/index.md | 14 ++++++++++++++ docs/src/protocol/account/index.md | 4 ++-- docs/src/protocol/index.md | 12 ++++++------ 3 files changed, 22 insertions(+), 8 deletions(-) create mode 100644 docs/src/index.md diff --git a/docs/src/index.md b/docs/src/index.md new file mode 100644 index 0000000000..bf8aed878c --- /dev/null +++ b/docs/src/index.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 1 +title: Overview +slug: / +--- + +# Miden Documentation (Dev Preview) + +This is a local Docusaurus preview of the documentation that lives in this repository. In production these docs are aggregated into the [`miden-docs`](https://github.com/0xMiden/miden-docs) repository, where the protocol and standards sections appear alongside docs from other vendor repos. + +## Sections + +- [Protocol](protocol/index.md): the Miden protocol's core concepts (accounts, notes, assets, transactions, state, blockchain). +- [Standards](standards/index.md): reusable account components published by the `miden-standards` crate. diff --git a/docs/src/protocol/account/index.md b/docs/src/protocol/account/index.md index e43aaee065..a158a2021e 100644 --- a/docs/src/protocol/account/index.md +++ b/docs/src/protocol/account/index.md @@ -4,7 +4,7 @@ sidebar_position: 1 # Accounts / Smart Contracts -An `Account` represents the primary entity in Miden. It is capable of holding assets, storing data, and executing custom code. Each `Account` is a smart contract with a programmable interface through which note and transaction scripts can interact with the account's state and assets. By executing [transactions](../transaction) against an account, its state can be modified. +An `Account` represents the primary entity in Miden. It is capable of holding assets, storing data, and executing custom code. Each `Account` is a smart contract with a programmable interface through which note and transaction scripts can interact with the account's state and assets. By executing [transactions](../transaction.md) against an account, its state can be modified. ## What is the purpose of an account? @@ -46,7 +46,7 @@ Note that a transaction does not always change the state of an account. For inst ## Account creation -For an `Account` to be recognized by the network, it must exist in the [account database](../state#account-database) maintained by Miden node(s). +For an `Account` to be recognized by the network, it must exist in the [account database](../state.md#account-database) maintained by Miden node(s). However, a user can locally create a new `Account` ID before it's recognized network-wide. The typical process might be: diff --git a/docs/src/protocol/index.md b/docs/src/protocol/index.md index bf7c554b86..011f04f410 100644 --- a/docs/src/protocol/index.md +++ b/docs/src/protocol/index.md @@ -33,19 +33,19 @@ An [Account](account/index.md) can hold assets and define rules how assets can b ### Notes -A [Note](note) is a message that accounts send to each other. A note stores assets and a script that defines how the note can be consumed. The [note chapter](note) describes the design, the storage types, and the creation of a note. +A [Note](note.md) is a message that accounts send to each other. A note stores assets and a script that defines how the note can be consumed. The [note chapter](note.md) describes the design, the storage types, and the creation of a note. ### Assets -An [Asset](asset) can be fungible and non-fungible. They are stored in the owner's account itself or in a note. The [asset chapter](asset) describes asset issuance, customization, and storage. +An [Asset](asset.md) can be fungible and non-fungible. They are stored in the owner's account itself or in a note. The [asset chapter](asset.md) describes asset issuance, customization, and storage. ### Transactions -A [Transaction](transaction) describes the production and consumption of notes by a single account. +A [Transaction](transaction.md) describes the production and consumption of notes by a single account. Executing a transaction always results in a STARK proof. -The [transaction chapter](transaction) describes the transaction design and implementation, including an in-depth discussion of how transaction execution happens in the transaction kernel program. +The [transaction chapter](transaction.md) describes the transaction design and implementation, including an in-depth discussion of how transaction execution happens in the transaction kernel program. #### Accounts produce and consume notes to communicate @@ -59,11 +59,11 @@ Miden's state model captures the individual states of all accounts and notes, an ### State model -[State](state) describes everything that is the case at a certain point in time. Individual states of accounts or notes can be stored on-chain and off-chain. This chapter describes the three different state databases in Miden. +[State](state.md) describes everything that is the case at a certain point in time. Individual states of accounts or notes can be stored on-chain and off-chain. This chapter describes the three different state databases in Miden. ### Blockchain -The [Blockchain](blockchain) defines how state progresses as aggregated-state-updates in batches, blocks, and epochs. The [blockchain chapter](blockchain) describes the execution model and how blocks are built. +The [Blockchain](blockchain.md) defines how state progresses as aggregated-state-updates in batches, blocks, and epochs. The [blockchain chapter](blockchain.md) describes the execution model and how blocks are built. ##### Operators capture and progress state From 162bc9719b941e7a68fec4dcbf4be47d11b8000a Mon Sep 17 00:00:00 2001 From: "Claude (Opus)" Date: Thu, 30 Apr 2026 09:28:16 +0000 Subject: [PATCH 4/4] fix(docs): point dev-preview navbar at /protocol instead of placeholder root The previous commit added a placeholder docs/src/index.md to give the dev preview a homepage at /, but the aggregator at 0xMiden/docs ingests docs/src/* into docs/core-concepts/protocol/ verbatim, so that file would land in production where it doesn't belong. Drop the placeholder index and instead set navbar.logo.href to /protocol in the dev-preview Docusaurus config. This removes the broken / link from every page (it was the navbar logo defaulting to baseUrl) without adding any new content to the docs tree. --- docs/docusaurus.config.ts | 1 + docs/src/index.md | 14 -------------- 2 files changed, 1 insertion(+), 14 deletions(-) delete mode 100644 docs/src/index.md diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts index ef8eee7646..5e813a8d26 100644 --- a/docs/docusaurus.config.ts +++ b/docs/docusaurus.config.ts @@ -109,6 +109,7 @@ const config: Config = { src: "img/logo.png", alt: "Miden Logo", height: 240, + href: "/protocol", }, title: "MIDEN", items: [ diff --git a/docs/src/index.md b/docs/src/index.md deleted file mode 100644 index bf8aed878c..0000000000 --- a/docs/src/index.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 1 -title: Overview -slug: / ---- - -# Miden Documentation (Dev Preview) - -This is a local Docusaurus preview of the documentation that lives in this repository. In production these docs are aggregated into the [`miden-docs`](https://github.com/0xMiden/miden-docs) repository, where the protocol and standards sections appear alongside docs from other vendor repos. - -## Sections - -- [Protocol](protocol/index.md): the Miden protocol's core concepts (accounts, notes, assets, transactions, state, blockchain). -- [Standards](standards/index.md): reusable account components published by the `miden-standards` crate.