This repository contains the Miden client, which provides a way to execute and prove transactions, facilitating the interaction with the Miden rollup.
The Miden client is still under heavy development and the project can be considered to be in an alpha stage. Many features are yet to be implemented and there is a number of limitations which we will lift in the near future.
The Miden client currently consists of two components:
miden-client
library, which can be used by other project to programmatically interact with the Miden rollup.miden-client
binary which is a wrapper around the library exposing its functionality via a simple command-line interface (CLI).
The client's main responsibility is to maintain a partial view of the blockchain which allows for locally executing and proving transactions. It keeps a local store of various entities that periodically get updated by syncing with the node.
For more info check:
Before you can use the Miden client, you'll need to make sure you have both Rust and sqlite3 installed. Miden client requires rust version 1.78 or higher.
In order to utilize the miden-client
library, you can add the dependency to your project's Cargo.toml
file:
miden-client = { version = "0.3" }
concurrent
: used to enable concurrent proofs generationtesting
: useful feature that lowers PoW difficulty when enabled. Only use this during development and not on production.
You can either build from source with:
cargo build --release
Once the binary is built, you can find it on ./target/release/miden
.
Or you can install the CLI from crates-io with:
cargo install miden-client
Note that binary name for the client is just miden
.
As mentioned before, we use cargo-make to encapsulate some tasks, such as running lints and tests. You can check out Makefile.toml for all available tasks.
To test the project's code, we provide both unit tests (which can be run with cargo test
) and integration tests. For more info on integration tests, refer to the integration testing document
The crate also comes with 2 feature flags that are used exclusively on tests:
test_utils
: used on unit tests to use the mocked RPC API.integration
: only used to run integration tests and separate them from unit tests
Interested in contributing? Check CONTRIBUTING.md.
This project is MIT licensed.