How do I set up Amaru with a local Cardano node?

Ensure you have a synced cardano-node running on port 3001 or adjust the AMARU_PEER_ADDRESS environment variable. Use 'make bootstrap' and 'make start' commands with the AMARU_NETWORK set, as detailed in the README's running instructions.

Amaru vs cardano-node: which is better for development?

Amaru is an open-source Rust alternative focused on transparency and community contributions, ideal for experimenting with Rust and early-stage development. cardano-node, the official implementation, is more stable and feature-complete for production-like testing.

Is Amaru ready for production use?

No, Amaru is explicitly in an exploratory phase with warnings about incomplete features and instability. It's best suited for development, testing, and community projects rather than production deployments.

What Cardano networks does Amaru support?

Amaru supports Cardano networks like preprod for development and testing. You specify the network using the AMARU_NETWORK environment variable during bootstrap and startup processes.

How to monitor Amaru with OpenTelemetry?

Run the provided docker-compose file for Jaeger and set AMARU_WITH_OPEN_TELEMETRY=true when starting Amaru. This forwards logs to the telemetry backend for observability, as mentioned in the optional setup steps.

Can Amaru connect to multiple peer addresses?

Yes, you can add multiple peers by replicating the --peer-address option when running Amaru, allowing connections to several Cardano node relays for improved network access and redundancy.

Open-Awesome

amaru

Apache-2.0Rust

A fully open-source Cardano node client written in Rust, enabling direct blockchain interaction.

Visit Website GitHub

106 stars29 forks0 contributors

What is amaru?

Amaru is a fully open-source node client for the Cardano blockchain, written in Rust. It enables developers to run a Cardano node, sync with the network, and interact directly with the blockchain. The project provides a transparent alternative to proprietary node implementations, fostering community-driven development.

Target Audience

Blockchain developers and teams working with Cardano who need a reliable, open-source node client for development, testing, or production use.

Value Proposition

Developers choose Amaru for its Rust-based performance and safety, its commitment to open-source transparency, and its early integration approach that prioritizes visible progress and community collaboration.

Overview

A fully open source node client for Cardano, written in Rust

Use Cases

Best For

Running a Cardano node for development and testing on preprod networks
Building Cardano-based applications that require direct blockchain interaction
Contributing to open-source Cardano infrastructure projects
Experimenting with Cardano node observability using OpenTelemetry and Jaeger
Learning about Cardano's peer-to-peer network architecture
Developing in Rust for blockchain and cryptocurrency applications

Not Ideal For

Production environments requiring a stable, fully-featured node client with guaranteed long-term support
Projects lacking access to a synced Cardano node peer, as Amaru depends on external relays for operation
Teams needing extensive out-of-the-box tooling or a mature plugin ecosystem for rapid deployment

Pros & Cons

Pros

Rust Performance and Safety

Built in Rust for high performance, memory safety, and concurrency, ensuring efficient and secure blockchain interactions as highlighted in the key features.

Open-Source Transparency

Provides a fully open-source, community-driven alternative to proprietary solutions, fostering collaboration and avoiding vendor lock-in.

Early Progress Visibility

Emphasizes early integration of components to make development progress tangible, even with incomplete features, aligning with the project's philosophy.

Observability Integration

Supports optional integration with OpenTelemetry and Jaeger for monitoring and tracing, useful for debugging during development and testing phases.

Cons

Exploratory Phase Instability

Still in an exploratory phase with incomplete features and potential instability, as warned in the README, making it unsuitable for critical production use.

External Node Dependency

Requires a synced cardano-node peer to function, adding setup complexity and reliance on external infrastructure, which can be a barrier for standalone deployments.

Limited Maturity and Features

Lacks the comprehensive feature set, documentation, and ecosystem support of established Cardano node clients, limiting immediate utility for advanced use cases.

Frequently Asked Questions

Related Projects

linera-protocol

Main repository for the Linera protocol

Diem’s mission is to build a trusted and innovative financial network that empowers people and businesses around the world.

Stars16,672

Forks2,546

Last commit2 days ago

Foundry

Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.

Stars10,502

Forks2,581

Last commit21 hours ago

datahaven

An EVM compatible Substrate chain, powered by StorageHub and secured by EigenLayer

Stars7,927

Forks146

Last commit3 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub