#solana #lookup-tables #programs #rpc #rpc-client #tx #legacy

solana-program-client

lightweight crate to call Solana programs

1 unstable release

0.1.0 Jun 3, 2024

#17 in #tx

MIT license

37KB
294 lines

Solana program client

solana_program_client is a lightweight crate to call Solana programs. It focuses on abstracting away relevant crates used for interacting with Solana programs.

Overview

solana_program_client is a crate for developing clients for Solana programs and client-side web applications using Rust. The primary goal behind this project is to provide an ergonomic interface for interacting with Solana programs.

This in turn allows developers to use call program functions using simple RPC requests.

An example is available here:

use solana_program_client::legacy_tx::*;

#[derive(BorshSerialize, BorshDeserialize)]
#[borsh(crate = "borsh")]
pub struct UpdateBlob {
    pub data: Vec<u8>,
}

fn main() {
    // create a Rpc client connection
    let connection = RpcClient::new("https://api.devnet.solana.com");
    let program_id = blob::ID;

    // get blob PDA
    let (blob_account, _) = Pubkey::find_program_address(&[&b"blob"[..]], &program_id);

    let payer = Keypair::read_from_file("~/.config/solana/id.json").unwrap();

    let instruction_name = "update_blob";

    //  construct instruction data
    let instruction_data = UpdateBlob {
        data: "data".as_bytes().to_vec(),
    };

    // set up accounts
    let accounts = vec![
        AccountMeta::new(blob_account, false),
        AccountMeta::new(payer.pubkey(), true),
    ];

    // call signed call
    let _tx_signature = signed_call(
        connection,
        program_id,
        payer,
        instruction_name,
        instruction_data,
        accounts,
    ).unwrap();
}

Features

  • Submit signed call to Solana program
  • Create a lookup table
  • Extend a lookup table
  • Submit versioned transaction

Motivation

  • Inability to submit transactions through Rust Solana client without knowing the function discriminant.
  • Repeated code duplication when building Rust Solana client.

Development status

The crate is currently under development and should be considered in the alpha stage. Additional work is needed on further extensions.

TODO

  • unsigned call
  • event subscription

Tip:

solana: Fj72ApTUaYEwC3RKCKQ7iX3s8i8CVAnZW1f9PAXSKtbY

Dependencies

~76MB
~1.5M SLoC