Crate solana_sdk

The Solana host and client SDK.

This is the base library for all off-chain programs that interact with Solana or otherwise operate on Solana data structures. On-chain programs instead use the solana-program crate, the modules of which are re-exported by this crate, like the relationship between the Rust core and std crates. As much of the functionality of this crate is provided by solana-program, see that crate’s documentation for an overview.

Many of the modules in this crate are primarily of use to the Solana runtime itself. Additional crates provide capabilities built on solana-sdk, and many programs will need to link to those crates as well, particularly for clients communicating with Solana nodes over RPC.

Such crates include:

• solana-client - For interacting with a Solana node via the JSON-RPC API.
• solana-cli-config - Loading and saving the Solana CLI configuration file.
• solana-clap-utils - Routines for setting up the CLI using clap, as used by the Solana CLI. Includes functions for loading all types of signers supported by the CLI.

Re-exports

pub extern crate bs58;

pub use solana_message as message;

pub use solana_program::account_info;

pub use solana_program::big_mod_exp;

pub use solana_program::blake3;

pub use solana_program::clock;

pub use solana_program::epoch_rewards;

pub use solana_program::fee_calculator;

pub use solana_program::keccak;

pub use solana_program::native_token;

pub use solana_program::program_option;

pub use solana_program::program_pack;

pub use solana_program::rent;

pub use solana_program::serialize_utils;

pub use solana_program::stable_layout;

pub use solana_shred_version as shred_version;full

pub use solana_account as account;

pub use solana_epoch_info as epoch_info;

pub use solana_epoch_rewards_hasher as epoch_rewards_hasher;

pub use solana_fee_structure as fee;

pub use solana_inflation as inflation;

pub use solana_offchain_message as offchain_message;full

pub use solana_program_memory as program_memory;

pub use solana_sanitize as sanitize;

pub use solana_serde as deserialize_utils;

pub use solana_serde_varint as serde_varint;

pub use solana_short_vec as short_vec;

pub use solana_time_utils as timing;

Modules

account_utils

Useful extras for Account state.

borsh1borsh

Utilities for the borsh serialization format, version 1.

bpf_loader

The latest BPF loader native program.

bpf_loader_deprecated

The original and now deprecated Solana BPF loader.

config

The config native program.

debug_account_data

Debug-formatting of account data.

ed25519_program

The ed25519 native program.

entrypoint

The Rust-based BPF program entrypoint supported by the latest BPF loader.

entrypoint_deprecated

The Rust-based BPF program entrypoint supported by the original BPF loader.

epoch_schedule

hash

Hashing with the SHA-256 hash function, and a general Hash type.

incinerator

inner_instruction

instruction

lamports

Re-exports the LamportsError type for backwards compatibility.

log

native_loader

The native loader native program.

program

Wrappers around solana-cpi with support for overwriting syscall stubs

program_error

program_stubsNon-target_os="solana"

Implementations of syscalls used when solana-program is built for non-SBF targets.

pubkey

secp256k1_program

The secp256k1 native program.

signaturefull

Functionality for public and private keys.

signerfull

signersfull

simple_vote_transaction_checkerfull

slot_hashes

slot_history

syscalls

Declarations of Solana program syscalls.

sysvar

transactionfull

transportfull

Defines the TransportError type.

Macros

custom_heap_default

Define the default global allocator.

custom_panic_default

Define the default global panic handler.

declare_deprecated_id

Same as declare_id except report that this id has been deprecated.

declare_deprecated_sysvar_id

Same as declare_sysvar_id except that it reports that this ID has been deprecated.

declare_id

Convenience macro to declare a static public key and functions to interact with it.

declare_sysvar_id

Declares an ID that implements SysvarId.

impl_sysvar_get

Implements the Sysvar::get method for both SBF and host targets.

msg

Print a message to the log.

pubkey

Convenience macro to define a static public key.

pubkeys

Convenience macro to define multiple static public keys.

unchecked_div_by_const

Convenience macro for doing integer division where the operation’s safety can be checked at compile-time.