#miden #faucet #local-node #node

app miden-faucet

Miden node token faucet

10 releases (5 breaking)

new 0.7.2 Jan 29, 2025
0.7.1 Jan 28, 2025
0.6.0 Nov 6, 2024
0.5.1 Sep 13, 2024
0.2.1 Apr 27, 2024

#122 in Magic Beans

Download history 125/week @ 2024-11-05 1/week @ 2024-11-12 4/week @ 2024-11-19 11/week @ 2024-12-10 110/week @ 2025-01-21

110 downloads per month

MIT license

430KB
5K SLoC

Miden node

This crate contains a binary for running a Miden rollup faucet.

Running the faucet

  1. Run a local node using the docker image. From the "miden-node" repo root run the following commands:
make docker-build-node
make docker-run-node
  1. Install the faucet:
make install-faucet
  1. [Optional] Create faucet account (skip this step if you want to use an account from the genesis). This will generate authentication keypair and generate and write public faucet account data with its keypair into the file specified in output-path:
miden-faucet create-faucet-account \
  --output-path <path to faucet.mac> \
  --token-symbol POL \
  --decimals 9 \
  --max-supply 1000000000

[!TIP] This account will not be created on chain yet, creation on chain will happen on the first minting transaction.

  1. Create the default faucet configuration file. Specify the path to the faucet account file created on the previous step in the -f flag (if you want to use an account from the genesis, specify the path to the faucet.mac file generated by the make-genesis command of the Miden node):
miden-faucet init -f <path to faucet.mac>
  1. Start the faucet server:
miden-faucet start

After a few seconds you may go to http://localhost:8080 and see the faucet UI.

License

This project is MIT licensed.

Dependencies

~28–56MB
~881K SLoC