Skip to main content
Version: 0.13

Miden Node Setup Tutorial

To run the Miden tutorial examples, you will need to set up a test environment and connect to a Miden node.

There are two ways to connect to a Miden node:

  1. Run the Miden node locally
  2. Connect to the Miden testnet

Running the Miden node locally​

Building the node from source requires a C/C++ toolchain (for compiling RocksDB). On macOS, make sure you have the Xcode Command Line Tools installed:

xcode-select --install

On Ubuntu, see the node installation page for the required packages. If you run into 'cstdint' file not found errors on macOS, see the troubleshooting section on the installation page.

Step 1: Install the Miden node​

Install the miden-node crate using this command:

cargo install miden-node --locked --version 0.13.0

Step 2: Initializing the node​

To start the node, we first need to generate the genesis file. Create the genesis file using this command:

mkdir data
mkdir accounts

miden-node bundled bootstrap \
  --data-directory data \
  --accounts-directory accounts

Expected output:

2025-04-16T18:05:30.049129Z  INFO miden_node::commands::store: bin/node/src/commands/store.rs:145: Generating account, index: 0, total: 1

Step 3: Starting the node​

To start the node run this command:

miden-node bundled start \
  --data-directory data \
  --rpc.url http://0.0.0.0:57291

Expected output:

2025-01-17T12:14:55.432445Z  INFO try_build_batches: miden-block-producer: /Users/username/.cargo/registry/src/index.crates.io-6f17d22bba15001f/miden-node-block-producer-0.6.0/src/txqueue/mod.rs:85: close, time.busy: 8.88µs, time.idle: 103µs
2025-01-17T12:14:57.433162Z  INFO try_build_batches: miden-block-producer: /Users/username/.cargo/registry/src/index.crates.io-6f17d22bba15001f/miden-node-block-producer-0.6.0/src/txqueue/mod.rs:85: new
2025-01-17T12:14:57.433256Z  INFO try_build_batches: miden-block-producer: /Users/username/.cargo/registry/src/index.crates.io-6f17d22bba15001f/miden-node-block-producer-0.6.0/src/txqueue/mod.rs:85: close, time.busy: 6.46µs, time.idle: 94.0µs

Congratulations, you now have a Miden node running locally. Now we can start creating a testing environment for building applications on Miden!

The endpoint of the Miden node running locally is:

http://localhost:57291

Resetting the node​

If you need to reset the local state of the node run this command:

rm -r data
rm -r accounts

After resetting the state of the node, follow steps 2 and 4 again.

Connecting to the Miden testnet​

To run the tutorial examples using the Miden testnet, use this endpoint:

https://rpc.testnet.miden.io:443