Anoma is a sovereign, proof-of-stake blockchain protocol that enables private, asset-agnostic cash and private bartering among any number of parties. To learn more about Anoma's vision, take a look at the Anoma Vision Paper or Anoma's Whitepaper.
This is an implementation of the Anoma protocol in Rust.
- docs: built from docs mdBook
- rustdoc: built from the source
Here lay dragons: this codebase is still experimental, try at your own risk!
There's a single command to build and install Anoma executables from source (the node, the client and the wallet). This command will also verify that Tendermint with a compatible version is available and if not, attempt to install it. Note that currently at least 16GB RAM is needed to build from source.
make install
After installation, the main anoma
executable will be available on path.
To find how to use it, check out the User Guide section of the docs.
# Build the provided validity predicate, transaction and matchmaker wasm modules
make build-wasm-scripts-docker
# Development build Anoma
make
nix-shell -p crate2nix --command "crate2nix generate"
nix-build -A apps
nix-env -i ./result
# Format the code
make fmt
# Lint the code
make clippy
To change the log level, set ANOMA_LOG
environment variable to one of:
error
warn
info
debug
trace
The default is set to info
for all the modules, expect for Tendermint ABCI, which has a lot of debug
logging.
For more fine-grained logging levels settings, please refer to the tracing subscriber docs for more information.
To switch on logging in tests that use #[test]
macro from test_env_log::test
, use RUST_LOG
with e.g. RUST_LOG=info cargo test -- --nocapture
.
Please see the contributing page.
The ledger currently requires that Tendermint version 0.34.x is installed and available on path. The pre-built binaries and the source for 0.34.8 are here, also directly available in some package managers.
This can be installed by make install
command (which runs scripts/install/get_tendermint.sh script).