Struct Client

pub struct Client { /* private fields */ }

The Client.

Implementations

impl Client

pub fn new(sender: RpcChannel) -> Self

Creates a new Client.

pub fn set_account( &self, pubkey: String, update: AccountUpdate, ) -> impl Future<Output = RpcResult<RpcResponse<()>>>

A “cheat code” method for developers to set or update an account in Surfpool.

This method allows developers to set or update the lamports, data, owner, executable status, and rent epoch of a given account.

Parameters

• meta: Metadata passed with the request, such as the client’s request context.
• pubkey: The public key of the account to be updated, as a base-58 encoded string.
• update: The AccountUpdate struct containing the fields to update the account.

Returns

A RpcResponse<()> indicating whether the account update was successful.

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "surfnet_setAccount",
  "params": ["account_pubkey", {"lamports": 1000, "data": "base58string", "owner": "program_pubkey"}]
}

Example Response

{
  "jsonrpc": "2.0",
  "result": {},
  "id": 1
}

Notes

This method is designed to help developers set or modify account properties within Surfpool. Developers can quickly test or update account attributes, such as lamports, program ownership, and executable status.

See Also

• getAccount, getAccountInfo, getAccountBalance

pub fn set_token_account( &self, owner: String, mint: String, update: TokenAccountUpdate, token_program: Option<String>, ) -> impl Future<Output = RpcResult<RpcResponse<()>>>

A “cheat code” method for developers to set or update a token account in Surfpool.

This method allows developers to set or update various properties of a token account, including the token amount, delegate, state, delegated amount, and close authority.

Parameters

• meta: Metadata passed with the request, such as the client’s request context.
• owner: The base-58 encoded public key of the token account’s owner.
• mint: The base-58 encoded public key of the token mint (e.g., the token type).
• update: The TokenAccountUpdate struct containing the fields to update the token account.
• token_program: The optional base-58 encoded address of the token program (defaults to the system token program).

Returns

A RpcResponse<()> indicating whether the token account update was successful.

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "surfnet_setTokenAccount",
  "params": ["owner_pubkey", "mint_pubkey", {"amount": 1000, "state": "initialized"}]
}

Example Response

{
  "jsonrpc": "2.0",
  "result": {},
  "id": 1
}

Notes

This method is designed to help developers quickly test or modify token account properties in Surfpool. Developers can update attributes such as token amounts, delegates, and authorities for specific token accounts.

See Also

• getTokenAccountInfo, getTokenAccountBalance, getTokenAccountDelegate

pub fn clone_program_account( &self, source_program_id: String, destination_program_id: String, ) -> impl Future<Output = RpcResult<RpcResponse<()>>>

pub fn estimate_compute_units( &self, transaction_data: String, tag: Option<String>, ) -> impl Future<Output = RpcResult<RpcResponse<ProfileResult>>>

Estimates the compute units that a given transaction will consume.

This method simulates the transaction without committing its state changes and returns an estimation of the compute units used, along with logs and potential errors.

Parameters

• meta: Metadata passed with the request.
• transaction_data: A base64 encoded string of the VersionedTransaction.
• tag: An optional tag for the transaction.

Returns

A RpcResponse<ProfileResult> containing the estimation details.

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "surfnet_profileTransaction",
  "params": ["base64_encoded_transaction_string", "optional_tag"]
}

pub fn get_profile_results( &self, tag: String, ) -> impl Future<Output = RpcResult<RpcResponse<Vec<ProfileResult>>>>

Retrieves all profiling results for a given tag.

Parameters

• meta: Metadata passed with the request.
• tag: The tag to retrieve profiling results for.

Returns

A RpcResponse<Vec<ProfileResult>> containing the profiling results.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<RpcChannel> for Client

fn from(channel: RpcChannel) -> Self

Converts to this type from the input type.