AleoDotNet

The official .NET ecosystem for the Aleo blockchain — SDK, wallet, cryptographic engine, and developer tools.

AleoDotNet aims to provide a complete, modern, and high‑performance .NET interface to the Aleo zero‑knowledge blockchain.
Planned components include:

• A Rust‑based native cryptographic engine (planned)
• A safe and minimal P/Invoke interop layer (planned)
• Strongly‑typed Aleo primitives (scaffolded)
• A full RPC client for interacting with Aleo nodes (planned)
• A secure wallet implementation (planned)
• A high‑level SDK for building Aleo applications in C# (planned)

AleoDotNet is designed for long‑term stability, clarity, and developer experience — enabling .NET developers to build private, verifiable applications on Aleo with confidence.

---

Features

• Native Rust Engine
  High‑performance cryptographic operations exposed through a stable C ABI.

• Safe Interop Layer
  Carefully designed P/Invoke bindings with strict memory and error‑handling rules.

• Aleo Primitives
  Strongly‑typed representations of Aleo addresses, records, fields, scalars, and more.

• RPC Client
  A modern, async‑first client for interacting with Aleo nodes.

• Wallet Support
  Key management, record handling, and transaction construction.

• High‑Level SDK
  A clean, intuitive API for building Aleo applications in .NET.

---

Repository Structure

aleo-dotnet-sdk/ │ ├── src/ │ ├── Aleo.Primitives/ │ │ ├── Address.cs │ │ ├── PrivateKey.cs │ │ ├── ViewKey.cs │ │ ├── Record.cs │ │ ├── Transaction.cs │ │ └── Aleo.Primitives.csproj │ │ │ ├── Aleo.Crypto/ │ │ ├── IAleoCryptoEngine.cs │ │ ├── RustAleoCryptoEngine.cs │ │ ├── NativeMethods.cs │ │ ├── Interop/ │ │ │ ├── aleo_dotnet_engine.h │ │ │ ├── win-x64/ │ │ │ │ └── aleo_dotnet_engine.dll │ │ │ ├── linux-x64/ │ │ │ │ └── libaleo_dotnet_engine.so │ │ │ └── osx-arm64/ │ │ │ └── libaleo_dotnet_engine.dylib │ │ └── Aleo.Crypto.csproj │ │ │ ├── Aleo.Rpc/ │ │ ├── IAleoRpcClient.cs │ │ ├── AleoRpcClient.cs │ │ ├── Models/ │ │ │ ├── Block.cs │ │ │ ├── RpcRecord.cs │ │ │ ├── RpcTransaction.cs │ │ │ └── RpcError.cs │ │ └── Aleo.Rpc.csproj │ │ │ ├── Aleo.Wallet/ │ │ ├── AleoWallet.cs │ │ ├── WalletConfig.cs │ │ ├── WalletFactory.cs │ │ └── Aleo.Wallet.csproj │ │ │ ├── Aleo.Sdk/ │ │ ├── AleoSdk.cs │ │ ├── AleoConfig.cs │ │ ├── DependencyInjection.cs │ │ └── Aleo.Sdk.csproj │ │ │ └── Directory.Build.props │ ├── rust-engine/ │ ├── Cargo.toml │ ├── src/ │ │ ├── lib.rs │ │ ├── keygen.rs │ │ ├── address.rs │ │ ├── transfer.rs │ │ └── errors.rs │ └── build.sh │ ├── tests/ │ ├── Aleo.Primitives.Tests/ │ ├── Aleo.Crypto.Tests/ │ ├── Aleo.Rpc.Tests/ │ ├── Aleo.Wallet.Tests/ │ └── Aleo.Sdk.Tests/ │ ├── samples/ │ ├── ConsoleWallet/ │ │ ├── Program.cs │ │ └── ConsoleWallet.csproj │ └── WebApiDemo/ (optional) │ ├── docs/ │ ├── getting-started.md │ ├── architecture.md │ ├── rpc-reference.md │ ├── crypto-engine.md │ └── wallet-guide.md │ ├── .github/ │ ├── workflows/ │ │ ├── build.yml │ │ ├── test.yml │ │ └── publish.yml │ └── ISSUE_TEMPLATE.md │ ├── README.md ├── LICENSE └── Aleo.DotNet.sln

---

Getting Started

Prerequisites

• .NET 10 or later
• Rust (latest stable)
• Cargo
• Visual Studio 2022 or VS Code

Building the Solution

dotnet build

Running Tests

dotnet test

Roadmap

• Rust engine ABI definition
• P/Invoke interop layer
• Aleo primitives
• RPC client
• Wallet implementation
• High‑level SDK
• Developer templates
• Documentation site

License

AleoDotNet is licensed under the Apache License 2.0, matching the Aleo ecosystem.

Contributing

Contributions are welcome! Please see .github/copilot-instructions.md and CONTRIBUTING.md (coming soon) for guidelines.

Status

🚧 Active Development
AleoDotNet is under construction and not yet ready for production use.