Struct SimpleTallyClient 

pub struct SimpleTallyClient {
    pub rpc_client: RpcClient,
    pub program_id: Pubkey,
}

Simple Tally client for basic operations

Fields

rpc_client: RpcClient

RPC client for queries

program_id: Pubkey

Program ID

Implementations

impl SimpleTallyClient

pub fn new(cluster_url: &str) -> Result<Self>

Create a new simple Tally client

Arguments

• cluster_url - RPC endpoint URL

Returns

• Ok(SimpleTallyClient) - The client instance

Errors

Returns an error if the program ID cannot be parsed or client creation fails

pub fn new_with_program_id(cluster_url: &str, program_id: &str) -> Result<Self>

Create a new simple Tally client with custom program ID

Arguments

• cluster_url - RPC endpoint URL
• program_id - Custom program ID to use

Returns

• Ok(SimpleTallyClient) - The client instance

Errors

Returns an error if the program ID cannot be parsed or client creation fails

pub const fn program_id(&self) -> Pubkey

Get the program ID

pub fn merchant_address(&self, authority: &Pubkey) -> Pubkey

Compute merchant PDA using this client’s program ID

pub const fn rpc(&self) -> &RpcClient

Get the RPC client

pub fn account_exists(&self, address: &Pubkey) -> Result<bool>

Check if an account exists

Errors

Returns an error if the RPC call to check account existence fails

pub fn get_merchant( &self, merchant_address: &Pubkey, ) -> Result<Option<Merchant>>

Get merchant account data

Errors

Returns an error if the account doesn’t exist or can’t be deserialized

pub fn get_plan(&self, plan_address: &Pubkey) -> Result<Option<Plan>>

Get plan account data

Errors

Returns an error if the account doesn’t exist or can’t be deserialized

pub fn list_plans( &self, merchant_address: &Pubkey, ) -> Result<Vec<(Pubkey, Plan)>>

List all plans for a merchant

Errors

Returns an error if the RPC query fails or accounts can’t be deserialized

pub fn list_subscriptions( &self, plan_address: &Pubkey, ) -> Result<Vec<(Pubkey, Subscription)>>

List all subscriptions for a plan

Errors

Returns an error if the RPC query fails or accounts can’t be deserialized

pub fn submit_transaction<T: Signer>( &self, transaction: &mut Transaction, signers: &[&T], ) -> Result<String>

Submit and confirm a transaction

Errors

Returns an error if transaction submission or confirmation fails

pub fn submit_instruction<T: Signer>( &self, instruction: Instruction, signers: &[&T], ) -> Result<String>

Submit instruction with automatic transaction handling

Errors

Returns an error if transaction submission or confirmation fails

pub fn get_latest_blockhash(&self) -> Result<Hash>

Get latest blockhash

Errors

Returns an error if RPC call fails

pub fn get_latest_blockhash_with_commitment( &self, commitment: CommitmentConfig, ) -> Result<(Hash, u64)>

Get latest blockhash with commitment

Errors

Returns an error if RPC call fails

pub fn create_merchant<T: Signer>( &self, authority: &T, usdc_mint: &Pubkey, treasury_ata: &Pubkey, platform_fee_bps: u16, ) -> Result<(Pubkey, String)>

High-level method to create a merchant account

Errors

Returns an error if merchant creation fails

pub fn initialize_merchant_with_treasury<T: Signer>( &self, authority: &T, usdc_mint: &Pubkey, treasury_ata: &Pubkey, platform_fee_bps: u16, ) -> Result<(Pubkey, String, bool)>

High-level method to initialize merchant with treasury management

This method handles both cases:

• Treasury ATA exists + Merchant missing → Create merchant only
• Treasury ATA missing + Merchant missing → Create both ATA and merchant

Arguments

• authority - The wallet that will own the merchant account and treasury ATA
• usdc_mint - The USDC mint address
• treasury_ata - The expected treasury ATA address
• platform_fee_bps - Platform fee in basis points

Returns

• Ok((merchant_pda, signature, created_ata)) - The merchant PDA, transaction signature, and whether ATA was created
• Err(TallyError) - If merchant already exists or other validation/execution failures

Errors

Returns an error if merchant already exists, validation fails, or transaction execution fails

pub fn create_plan<T: Signer>( &self, authority: &T, plan_args: CreatePlanArgs, ) -> Result<(Pubkey, String)>

High-level method to create a subscription plan

Errors

Returns an error if plan creation fails

pub fn withdraw_platform_fees<T: Signer>( &self, platform_authority: &T, platform_treasury_ata: &Pubkey, destination_ata: &Pubkey, usdc_mint: &Pubkey, amount: u64, ) -> Result<String>

High-level method to withdraw platform fees

Errors

Returns an error if fee withdrawal fails

pub fn get_confirmed_signatures_for_address( &self, address: &Pubkey, config: Option<GetConfirmedSignaturesForAddress2Config>, ) -> Result<Vec<RpcConfirmedTransactionStatusWithSignature>>

Get confirmed signatures for a program address

Errors

Returns an error if RPC call fails

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

Get transaction details

Errors

Returns an error if RPC call fails or transaction not found

pub fn get_transactions( &self, signatures: &[Signature], ) -> Result<Vec<Option<Value>>>

Get multiple transactions in batch

Errors

Returns an error if any RPC calls fail

pub fn send_and_confirm_transaction( &self, transaction: &VersionedTransaction, ) -> Result<Signature>

Submit and confirm a pre-signed transaction

Errors

Returns an error if transaction submission or confirmation fails

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

Get current slot

Errors

Returns an error if RPC call fails

pub fn get_health(&self) -> Result<()>

Get health status

Errors

Returns an error if RPC call fails