Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anoma/namada
Rust implementation of Namada, a Proof-of-Stake L1 for interchain asset-agnostic privacy
https://github.com/anoma/namada
blockchain privacy rust zkp
Last synced: 3 days ago
JSON representation
Rust implementation of Namada, a Proof-of-Stake L1 for interchain asset-agnostic privacy
- Host: GitHub
- URL: https://github.com/anoma/namada
- Owner: anoma
- License: gpl-3.0
- Created: 2022-07-05T02:20:30.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-17T20:21:53.000Z (8 days ago)
- Last Synced: 2025-01-17T21:24:26.771Z (8 days ago)
- Topics: blockchain, privacy, rust, zkp
- Language: Rust
- Homepage: https://namada.net
- Size: 256 MB
- Stars: 2,449
- Watchers: 108
- Forks: 986
- Open Issues: 166
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Audit: audits/report-anoma-inference.pdf
Awesome Lists containing this project
- awesome-ccamel - anoma/namada - Rust implementation of Namada, a Proof-of-Stake L1 for interchain asset-agnostic privacy (Rust)
- awesome-blockchain-rust - Namada
README
# Namada
[](./LICENSE)
## Overview
[Namada](http://namada.net) is a Proof-of-Stake L1 for multichain asset-agnostic data protection. Namada uses CometBFT
consensus and enables multi-asset shielded transfers for any native
or non-native asset. Namada features full IBC protocol support, a modern proof-of-stake
system with cubic slashing, and a
stake-weighted on-chain governance mechanism. Users of Namada's MASP (Multi-Asset Shielded Pool) are rewarded for their contributions to the shielded set in
the form of native protocol tokens. A multi-asset shielded transfer
wallet is provided in order to facilitate safe user
interaction with the protocol.
* Blogpost: [Introducing Namada: Multichain Asset-agnostic Data Protection](https://namada.net/blog/introducing-namada-multichain-asset-agnostic-data-protection)
## 📓 Docs
* [User guides](https://docs.namada.net/)
* [Specs](https://specs.namada.net/)
* Rust docs can be built with `cargo doc --open` (add `--no-deps` to only build docs for local crates)
## 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](#dependencies) is available and if not, attempt to install it. Note that currently at least 16GB RAM is needed to build from source.
```shell
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](https://docs.namada.net/users).
For more detailed instructions and more install options, see the [Install
section](https://docs.namada.net/introduction/install) of the User
Guide.
## ⚙️ Development
```shell
# Build the provided validity predicate and transaction wasm modules
make build-wasm-scripts-docker
```
### Before submitting a PR, please make sure to run the following
```shell
# 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, except for CometBFT ABCI, which has a lot of `debug` logging.
For more fine-grained logging levels settings, please refer to the [tracing subscriber docs](https://docs.rs/tracing-subscriber/0.2.18/tracing_subscriber/struct.EnvFilter.html#directives) 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](./CONTRIBUTING.md).
### Dependencies
The ledger currently requires [CometBFT v0.37.11](https://github.com/cometbft/cometbft/releases/tag/v0.37.11) is installed and available on path. This can be achieved through following [these instructions](https://github.com/cometbft/cometbft/blob/main/docs/tutorials/install.md).
#### Hermes
We maintain a fork of [hermes](https://github.com/heliaxdev/hermes) that adds support for Namada.
Compatibility table with Namada:
| Namada binaries | Hermes |
| ----------- | ----------- |
| v1.0.0 | [1.10.4-namada-beta17-rc2](https://github.com/heliaxdev/hermes/releases/tag/v1.10.4-namada-beta17-rc2) |