Struct Client 

pub struct Client { /* private fields */ }

Lichen RPC client

Implementations

impl Client

pub fn new(rpc_url: impl Into<String>) -> Self

Create a new client with default settings

pub fn from_env() -> Self

Create a client using the LICHEN_RPC_URL env var, falling back to localhost:8899.

pub fn builder() -> ClientBuilder

Create a client builder for custom configuration

pub async fn get_slot(&self) -> Result<u64>

Get current slot

pub async fn get_balance(&self, pubkey: &Pubkey) -> Result<Balance>

Get account balance

pub async fn get_block(&self, slot: u64) -> Result<Block>

Get block by slot

pub async fn get_latest_block(&self) -> Result<Block>

Get latest block

pub async fn get_network_info(&self) -> Result<NetworkInfo>

Get network information

pub async fn get_validators(&self) -> Result<Vec<Value>>

Get validators

pub async fn send_raw_transaction(&self, tx_base64: &str) -> Result<String>

Send raw transaction (base64-encoded bincode)

pub async fn send_transaction(&self, tx: &Transaction) -> Result<String>

Send transaction (serializes with wire envelope and encodes automatically)

pub async fn get_transaction(&self, signature: &str) -> Result<Value>

Get transaction by signature

pub async fn get_account_info(&self, pubkey: &Pubkey) -> Result<Value>

Get account info

pub async fn get_transaction_history( &self, pubkey: &Pubkey, limit: Option<u64>, ) -> Result<Value>

Get transaction history for an account

pub async fn call_readonly_contract( &self, contract: &Pubkey, function: &str, args: Vec<u8>, from: Option<&Pubkey>, ) -> Result<ReadonlyContractResult>

Execute a read-only contract call without submitting a transaction.

pub async fn get_recent_blockhash(&self) -> Result<String>

Get recent blockhash (for transaction building)

pub async fn get_validator_info(&self, pubkey: &Pubkey) -> Result<Value>

Get detailed validator information

pub async fn get_validator_performance(&self, pubkey: &Pubkey) -> Result<Value>

Get validator performance metrics

pub async fn get_chain_status(&self) -> Result<Value>

Get comprehensive chain status

pub async fn stake( &self, staker: &Keypair, validator: &Pubkey, amount: u64, ) -> Result<String>

Create stake transaction

pub async fn unstake( &self, staker: &Keypair, validator: &Pubkey, amount: u64, ) -> Result<String>

Create unstake transaction

pub async fn get_staking_status(&self, pubkey: &Pubkey) -> Result<Value>

Get staking status for an account

pub async fn get_staking_rewards(&self, pubkey: &Pubkey) -> Result<Value>

Get staking rewards for an account

pub async fn transfer( &self, from: &Keypair, to: &Pubkey, amount: u64, ) -> Result<String>

Transfer native LICN (spores) from one account to another.

pub async fn deploy_contract( &self, deployer: &Keypair, code: Vec<u8>, init_data: Vec<u8>, ) -> Result<String>

Deploy a WASM smart contract.

Arguments

• deployer - Deployer keypair (signer, pays deploy fee)
• code - WASM bytecode (must start with \0asm magic, max 512 KB)
• init_data - Optional initialization data passed to contract init

pub async fn call_contract( &self, caller: &Keypair, contract: &Pubkey, function: &str, args: Vec<u8>, value: u64, ) -> Result<String>

Call a function on a deployed WASM smart contract.

Arguments

• caller - Caller keypair (signer)
• contract - Contract account public key
• function - Name of the contract function to invoke
• args - Serialized function arguments
• value - Native LICN to send with the call in spores

pub async fn upgrade_contract( &self, owner: &Keypair, contract: &Pubkey, code: Vec<u8>, ) -> Result<String>

Upgrade a deployed WASM smart contract (owner only).

pub async fn get_peers(&self) -> Result<Value>

Get connected peers

pub async fn get_metrics(&self) -> Result<Value>

Get network metrics

pub async fn get_total_burned(&self) -> Result<Value>

Get total burned tokens

pub async fn get_contract_info(&self, contract_id: &Pubkey) -> Result<Value>

Get contract information

pub async fn get_contract_logs(&self, contract_id: &Pubkey) -> Result<Value>

Get contract execution logs

pub async fn get_symbol_registry(&self, symbol: &str) -> Result<Value>

Get a symbol-registry entry.

pub async fn get_lichenid_profile(&self, pubkey: &Pubkey) -> Result<Value>

Get the complete LichenID profile for an address.

pub async fn get_lichenid_reputation(&self, pubkey: &Pubkey) -> Result<Value>

Get the LichenID reputation summary for an address.

pub async fn get_lichenid_skills(&self, pubkey: &Pubkey) -> Result<Value>

Get LichenID skills for an address.

pub async fn get_lichenid_vouches(&self, pubkey: &Pubkey) -> Result<Value>

Get LichenID vouches for an address.

pub async fn resolve_lichen_name(&self, name: &str) -> Result<Value>

Resolve a .lichen name to its owner.

pub async fn get_name_auction(&self, name: &str) -> Result<Value>

Get premium-name auction state for a .lichen label.

pub async fn get_lichenid_agent_directory( &self, options: Option<Value>, ) -> Result<Value>

Get the LichenID agent directory.

pub async fn get_lichenid_stats(&self) -> Result<Value>

Get aggregated LichenID statistics.

pub async fn get_sporepay_stats(&self) -> Result<Value>

Get aggregated SporePay streaming statistics.

pub async fn get_lichenswap_stats(&self) -> Result<Value>

Get aggregated LichenSwap statistics.

pub async fn get_thalllend_stats(&self) -> Result<Value>

Get aggregated ThallLend lending statistics.

pub async fn get_sporevault_stats(&self) -> Result<Value>

Get aggregated SporeVault yield-vault statistics.

pub async fn get_neo_gas_rewards_stats(&self) -> Result<Value>

Get aggregated Neo GAS rewards vault statistics.

pub async fn get_neo_gas_rewards_position( &self, address: &Pubkey, ) -> Result<Value>

Get per-wallet Neo GAS rewards vault accounting.

pub async fn get_neo_zk_proof_service_status(&self) -> Result<Value>

Get Neo reserve/liability proof-service verifier metadata.

pub async fn verify_neo_reserve_liability_proof( &self, proof_envelope: Value, ) -> Result<Value>

Verify a CLI-produced Neo reserve/liability proof envelope.

pub async fn get_bountyboard_stats(&self) -> Result<Value>

Get aggregated BountyBoard marketplace statistics.

pub async fn get_program(&self, program_id: &Pubkey) -> Result<Value>

pub async fn get_program_stats(&self, program_id: &Pubkey) -> Result<Value>

pub async fn get_programs(&self) -> Result<Value>

pub async fn get_program_calls(&self, program_id: &Pubkey) -> Result<Value>

pub async fn get_program_storage(&self, program_id: &Pubkey) -> Result<Value>

pub async fn get_collection(&self, collection_id: &Pubkey) -> Result<Value>

pub async fn get_nft( &self, collection_id: &Pubkey, token_id: u64, ) -> Result<Value>

pub async fn get_nfts_by_owner(&self, owner: &Pubkey) -> Result<Value>

pub async fn get_nfts_by_collection( &self, collection_id: &Pubkey, ) -> Result<Value>

pub async fn get_nft_activity( &self, collection_id: &Pubkey, token_id: u64, ) -> Result<Value>

pub async fn get_all_contracts(&self) -> Result<Value>

Get all deployed contracts

pub async fn health(&self) -> Result<bool>

Health check

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.