6 releases (3 breaking)

0.4.2 Oct 6, 2022
0.4.1 Sep 21, 2022
0.3.0 Aug 1, 2021
0.2.0 Apr 23, 2021
0.1.0 Mar 26, 2021

#466 in Magic Beans

Download history 23/week @ 2023-12-04 31/week @ 2023-12-11 11/week @ 2023-12-18 24/week @ 2023-12-25 38/week @ 2024-01-01 4/week @ 2024-01-08 11/week @ 2024-01-15 20/week @ 2024-01-29 6/week @ 2024-02-12 32/week @ 2024-02-19 33/week @ 2024-02-26 20/week @ 2024-03-04 27/week @ 2024-03-11 20/week @ 2024-03-18

103 downloads per month
Used in algonaut_sandbox

MIT license

565KB
13K SLoC

Rust algonaut

Crate Docs GitHub license Continuous integration

Rust algonaut is a rusty SDK for Algorand. Please, be aware that this crate is a work in progress.

use algonaut::algod::v2::Algod;
use algonaut_core::MicroAlgos;
use algonaut_transaction::Pay;
use algonaut_transaction::{account::Account, TxnBuilder};
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let algod = Algod::new(
        "http://localhost:4001",
        "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    )?;

    // an account with some funds
    let from_account = Account::from_mnemonic("fire enlist diesel stamp nuclear chunk student stumble call snow flock brush example slab guide choice option recall south kangaroo hundred matrix school above zero")?;

    let to_address = "2FMLYJHYQWRHMFKRHKTKX5UNB5DGO65U57O3YVLWUJWKRE4YYJYC2CWWBY".parse()?;

    // algod has a convenient method that retrieves basic information for a transaction
    let params = algod.suggested_transaction_params().await?;

    // we are ready to build the transaction
    let t = TxnBuilder::with(
        &params,
        Pay::new(from_account.address(), to_address, MicroAlgos(123_456)).build(),
    )
    .build()?;

    // we need to sign the transaction to prove that we own the sender address
    let signed_t = from_account.sign_transaction(t)?;

    // broadcast the transaction to the network
    let send_response = algod.broadcast_signed_transaction(&signed_t).await?;

    println!("Transaction ID: {}", send_response.tx_id);

    Ok(())
}

Crates

  • algonaut_client contains clients for algod, kmd, and indexer RPC APIs.
  • algonaut_core defines core structures for Algorand like: Address, Round, MicroAlgos, etc.
  • algonaut_crypto contains crypto utilities such as: ed25519 and mnemonics.
  • algonaut_encoding implements encoding utility functions such as serde visitors.
  • algonaut_transaction support developers in building all kinds of Algorand transactions.
  • algonaut_abi Application Binary Interface (ABI) to invoke smart contract methods with a standarized interface.

External utilities

Integration examples

Changelog

Read the changelog for more details.

Contribute

Do you want to help with the development? Please find out how by reading our contributions guidelines.

Acknowledgements

This crate is based on the work of @mraof.

License

Ferris Algonaut

Licensed under MIT license. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, shall be licensed as above, without any additional terms or conditions.

Ferris Algonaut is licensed under a Creative Commons Attribution 4.0 International License.
Rust algonaut's logo is based on Font Awesome's icon and licensed under a Creative Commons Attribution 4.0 International License.

Dependencies

~14–30MB
~563K SLoC