Struct FunctionCall 

pub struct FunctionCall { /* private fields */ }

A standalone function call configuration, decoupled from any transaction.

Use this when you need to pre-build calls and compose them into a transaction later. This is especially useful for dynamic transaction composition (e.g. in a loop) or for batching typed contract calls into a single transaction.

Note: FunctionCall does not capture a receiver/contract account. The call will execute against whichever receiver_id is set on the transaction it’s added to.

Examples

// Pre-build calls independently
let init = FunctionCall::new("init")
    .args(serde_json::json!({"owner": "alice.testnet"}))
    .gas(Gas::from_tgas(50));

let notify = FunctionCall::new("notify")
    .args(serde_json::json!({"msg": "done"}));

// Compose into a single atomic transaction
near.transaction("contract.testnet")
    .add_action(init)
    .add_action(notify)
    .send()
    .await?;

// Dynamic composition in a loop
let calls = vec![
    FunctionCall::new("method_a").args(serde_json::json!({"x": 1})),
    FunctionCall::new("method_b").args(serde_json::json!({"y": 2})),
];

let mut tx = near.transaction("contract.testnet");
for call in calls {
    tx = tx.add_action(call);
}
tx.send().await?;

Implementations

impl FunctionCall

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

Create a new function call for the given method name.

pub fn args(self, args: impl Serialize) -> Self

Set JSON arguments.

pub fn args_raw(self, args: Vec<u8>) -> Self

Set raw byte arguments.

pub fn args_borsh(self, args: impl BorshSerialize) -> Self

Set Borsh-encoded arguments.

pub fn gas(self, gas: impl IntoGas) -> Self

Set gas limit.

Defaults to 30 TGas if not set.

Panics

Panics if the gas string cannot be parsed. Use Gas’s FromStr impl for fallible parsing of user input.

pub fn deposit(self, amount: impl IntoNearToken) -> Self

Set attached deposit.

Defaults to zero if not set.

Panics

Panics if the amount string cannot be parsed. Use NearToken’s FromStr impl for fallible parsing of user input.

Trait Implementations

impl Debug for FunctionCall

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

Formats the value using the given formatter.

impl From<FunctionCall> for Action

fn from(call: FunctionCall) -> Self

Converts to this type from the input type.