/stellar-sdk

Stellar SDK for Rust

Primary LanguageRustApache License 2.0Apache-2.0

Stellar SDK

A lightweight Rust library for communicating with a Stellar Horizon server.

Features:

  • It uses only 3 dependencies and is extremely lightweight
  • A networking layer API for Horizon endpoints.
  • Facilities for building and signing transactions, for communicating with a Stellar Horizon instance, and for submitting transactions or querying network history.

Install

Add stellar_sdk to your Cargo.toml file and run cargo run

"stellar_sdk" = "0.1.3"

Usage

The usage is aimed to be identical to the JavaScript Stellar Sdk and we tried to avoid any complications that rust language itself has.

use stellar_sdk::{
    types::Asset,
    utils::{Direction, Endpoint},
    CallBuilder, Server,
};

fn main() {
    let s = String::from("https://horizon.stellar.org");
    let s = Server::new(s);

    // Load 1 account
    let my_acc = s
        .load_account("GAUZUPTHOMSZEV65VNSRMUDAAE4VBMSRYYAX3UOWYU3BQUZ6OK65NOWM")
        .unwrap();

    // Load transactions of an account
    let my_account_id = String::from("GAP2TJNW7NL52MPB36DZ2PB6PSIBEUEJXDG325BJQKUNDQBPKX3E2DLV");
    let my_txs = s
        .transactions()
        .order(Direction::Desc)
        .limit(2)
        .include_failed(false)
        .for_endpoint(Endpoint::Accounts(my_account_id))
        .call()
        .unwrap();

    // Load trades of yXLM and XLM
    let y_xlm = Asset::new(
        "yXLM",
        "GARDNV3Q7YGT4AKSDF25LT32YSCCW4EV22Y2TV3I2PU2MMXJTEDL5T55",
    );
    let native = Asset::native();
    let my_asset_pair = (y_xlm, native);
    let xlm_trades = s
        .trades()
        .for_asset_pair(my_asset_pair)
        .limit(2)
        .call()
        .unwrap();

    // Load USDC liquidity pools
    let usdc = Asset::new(
        "USDC",
        "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
    );
    let usdc_liquidity_pools = s.liquidity_pools().for_assets(vec![usdc]).call().unwrap();

    println!("{:#?}", my_txs);
    println!("{:#?}", xlm_trades);
    println!("{:#?}", my_acc);
    println!("{:#?}", usdc_liquidity_pools);
}

Todo

Asset

  • get_raw_asset_type
  • to_change_trust_XDR_object
  • to_trustline_XDR_object
  • to_XDR_object
  • from_operation

Claimant

FeeBumpTransaction

Keypair

  • master
  • xdr_account_id
  • xdr_public_key
  • xdr_muxed_account
  • signature_hint
  • sign_payload_decorated
  • sign_decorated

LiquidityPoolAsset

LiquidityPoolId

Memo

MuxedAccount

Operation

Server

  • checkMemoRequired

SignerKey

Transaction

Transaction Builder

Globals