#rpc-client #key-pair #anchor #programs #account #interact #signer

anchor-client

An RPC client to interact with Anchor programs

47 releases (29 breaking)

0.30.1 Jun 20, 2024
0.29.0 Oct 16, 2023
0.28.0 Jun 9, 2023
0.27.0 Mar 8, 2023
0.3.0 Mar 12, 2021

#14 in #anchor

Download history 2124/week @ 2024-07-20 2256/week @ 2024-07-27 1985/week @ 2024-08-03 2345/week @ 2024-08-10 1871/week @ 2024-08-17 2247/week @ 2024-08-24 2227/week @ 2024-08-31 1954/week @ 2024-09-07 1853/week @ 2024-09-14 2083/week @ 2024-09-21 1740/week @ 2024-09-28 1253/week @ 2024-10-05 2186/week @ 2024-10-12 2410/week @ 2024-10-19 2867/week @ 2024-10-26 3964/week @ 2024-11-02

11,628 downloads per month
Used in 54 crates (47 directly)

Apache-2.0

46KB
983 lines

An RPC client to interact with Solana programs written in anchor_lang.

Examples

A simple example that creates a client, sends a transaction and fetches an account:

use std::rc::Rc;

use anchor_client::{
    solana_sdk::{
        signature::{read_keypair_file, Keypair},
        signer::Signer,
        system_program,
    },
    Client, Cluster,
};
use my_program::{accounts, instruction, MyAccount};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create client
    let payer = read_keypair_file("keypair.json")?;
    let client = Client::new(Cluster::Localnet, Rc::new(payer));

    // Create program
    let program = client.program(my_program::ID)?;

    // Send a transaction
    let my_account_kp = Keypair::new();
    program
        .request()
        .accounts(accounts::Initialize {
            my_account: my_account_kp.pubkey(),
            payer: program.payer(),
            system_program: system_program::ID,
        })
        .args(instruction::Initialize { field: 42 })
        .signer(&my_account_kp)
        .send()?;

    // Fetch an account
    let my_account: MyAccount = program.account(my_account_kp.pubkey())?;
    assert_eq!(my_account.field, 42);

    Ok(())
}

More examples can be found in here.

Features

The client is blocking by default. To enable asynchronous client, add async feature:

anchor-client = { version = "0.30.1 ", features = ["async"] }

Dependencies

~76MB
~1.5M SLoC