NOTE: This repository is currently being reworked. Instead, please visit the following locations, depending on your interest:
- The Namada repository contains the Namada codebase.
- The Anoma specs repository contains the specifications for Anoma.
- Active development of Anoma is happening on three repositories:
- The Anoma alpha repository contains an alpha prototype.
- The Taiga repository contains the Taiga component, which provides shielded state transitions.
- The Typhon repository contains the Typhon component, which handles mempool, consensus, and execution.
Anoma is an intent-centric, privacy-preserving protocol for decentralized counterparty discovery, solving, and multi-chain atomic settlement. To learn more about Anoma's vision, take a look at the Anoma Vision Paper.
This is an implementation of the Anoma protocol in Rust.
Here lay dragons: this codebase is still experimental, try at your own risk!
There is a single command to build and install Anoma executables from source (the node, the client and the wallet). This command will also verify that a compatible version of Tendermint is available and if not, attempt to install it. Note that currently at least 16GB RAM is needed to build from source.
make installAfter 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.
If you have Nix, you may opt to build and install Anoma using Nix. The Nix integration also takes care of making a compatible version of Tendermint available.
# Nix 2.4 and later
nix profile install
# All versions of Nix
nix-env -f . -iA anomaFor more detailed instructions and more install options, see the Install section of the User Guide.
# Build the provided validity predicate, transaction and matchmaker wasm modules
make build-wasm-scripts-docker
# Development (debug) build Anoma, which includes a validator and some default
# accounts, whose keys and addresses are available in the wallet
ANOMA_DEV=true makeYou may opt to get all of the dependencies to develop Anoma by entering the development shell:
# Nix 2.4 and above
nix develop
# All versions of Nix
nix-shellInside the shell, all of the make targets work as usual:
# Build the WASM modules without docker
make build-wasm-scripts
# Development build (uses cargo)
ANOMA_DEV=true makeIt is also possible to use the Nix Rust infrastructure instead of Cargo to
build the project crates. This method uses crate2nix to derive Nix
expressions from Cargo.toml and Cargo.lock files. The workspace members are
exposed as packages in flake.nix with a rust_ prefix. Variants where the
ABCI-plus-plus feature flag is enabled are exposed with a :ABCI-plus-plus
suffix.
# List all packages
nix flake show
# Build the `anoma_apps` crate with `ABCI-plus-plus` feature
nix build .#rust_anoma_apps:ABCI-plus-plus
# Build the (default) anoma package. It consists of wrappers for the Anoma
# binaries (`rust_anoma_apps`) that ensure `tendermint` is in `PATH`.
nix build .#anoma