invoke

Calls one or more contracts on-chain and returns the relayed transaction hash.

Parameters

1. invocations (required)

InvocationArguments[]

Each invocation defines a contract hash, operation, arguments, and optional abortOnFail.

2. signers (optional)

Signer[]

Witness scope information for the transaction.

3. attributes (optional)

TransactionAttribute[]

Supported standard attributes include HighPriority and OracleResponse.

4. options (optional)

TransactionOptions

type TransactionOptions = {
  suggestedSystemFee?: Integer;
  extraSystemFee?: Integer;
  validUntilBlock?: number;
};

Returns

Promise<UInt256>

The relayed transaction hash.

Errors

Code	Name	Description
10002	INVALID	One or more inputs are invalid.
10004	FAILED	Contract execution failed.
10005	TIMEOUT	The request timed out.
10006	CANCELED	The user rejected the transaction.
10008	RPC_ERROR	The RPC server returned an error.

Example

Request

const txid = await provider.invoke(
  [
    {
      hash: "0xd2a4cff31913016155e38e474a2c06d08be276cf",
      operation: "transfer",
      args: [
        { type: "Hash160", value: "0x682cca3ebdc66210e5847d7f8115846586079d4a" },
        { type: "Hash160", value: "0xd45b7756498f83c9af7c2f71c66f8d6a8f6d6d11" },
        { type: "Integer", value: "100000000" },
        { type: "Any" },
      ],
      abortOnFail: true,
    },
  ],
  [
    {
      account: "0x682cca3ebdc66210e5847d7f8115846586079d4a",
      scopes: "CalledByEntry",
    },
  ],
  [],
  {
    extraSystemFee: "10000",
    suggestedSystemFee: "1000000",
  },
);

Response

"0x1f4d1defa46faa5e7b9b8d3f79a06bec777d7c26c4aa5f6f5899a291daa87c15"