Skip to content
forked from anoma/namada

Rust implementation of Namada, a Proof-of-Stake L1 for interchain asset-agnostic privacy

License

Notifications You must be signed in to change notification settings

klatos063/namada

Folders and files

NameName
Last commit message
Last commit date

Latest commit

a9d205f · Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Feb 3, 2023
Nov 20, 2023
Aug 8, 2022
Nov 20, 2023
Nov 20, 2023
Nov 10, 2023
Nov 8, 2023
Nov 7, 2023
Nov 14, 2023
Nov 20, 2023
Aug 21, 2023
Nov 20, 2023
Nov 7, 2023
Nov 15, 2023
Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Nov 7, 2023
Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Nov 17, 2023
Sep 22, 2023
Nov 30, 2022
Nov 11, 2023
May 20, 2021
Sep 7, 2023
Nov 11, 2023
Nov 11, 2023
Feb 2, 2021
Nov 11, 2023
Oct 26, 2023
Dec 21, 2022
Dec 21, 2022
Oct 14, 2022
May 20, 2023
May 20, 2023
Jun 19, 2023

Repository files navigation

Namada

License: GPL v3 CI Status

Overview

Namada is a Proof-of-Stake L1 for interchain asset-agnostic privacy. Namada uses CometBFT 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

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 CometBFT 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

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 CombetBFT 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 CometBFT v0.37.2 is installed and available on path. This can be achieved through following these instructions

About

Rust implementation of Namada, a Proof-of-Stake L1 for interchain asset-agnostic privacy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 99.3%
  • Other 0.7%