Namada
Overview
Namada is a Proof-of-Stake L1 for interchain asset-agnostic privacy. Namada uses Tendermint BFT consensus and enables multi-asset shielded transfers for any native or non-native asset. Namada features full IBC protocol support, a natively integrated Ethereum bridge, a modern proof-of-stake system with automatic reward compounding and cubic slashing, and a stake-weighted governance signalling mechanism. Users of shielded transfers are rewarded for their contributions to the privacy set in the form of native protocol tokens. A multi-asset shielded transfer wallet is provided in order to facilitate safe and private user interaction with the protocol.
π Docs
- dev docs: built from dev mdBook
Warning
Here lay dragons: this codebase is still experimental, try at your own risk!
πΎ Installing
There is a single command to build and install Namada 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 install
After installation, the main namada
executable will be available on path.
To find how to use it, check out the User Guide section of the docs.
For more detailed instructions and more install options, see the Install section of the User Guide.
βοΈ Development
# Build the provided validity predicate and transaction wasm modules
make build-wasm-scripts-docker
# Development (debug) build Namada, which includes a validator and some default
# accounts, whose keys and addresses are available in the wallet
NAMADA_DEV=true make
Before submitting a PR, pls make sure to run the following
# Format the code
make fmt
# Lint the code
make clippy
π§Ύ Logging
To change the log level, set NAMADA_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_log::test
, use RUST_LOG
with e.g. RUST_LOG=info cargo test -- --nocapture
.
How to contribute
Please see the contributing page.
Dependencies
The ledger currently requires that the Heliax fork of tendermint[v0.1.4-abciplus] is installed and available on path. This can be achieved through following these instructions