/sendTransactionToStellarContractWithContractInfo

1 min

POST

Build, sign, and send a Soroban smart-contract invocation through the MPC system.

This endpoint creates a full InvokeHostFunction transaction targeting the given Soroban contract (C-address) and submits it to the Stellar network.

What this endpoint does:

Builds a Soroban transaction calling contract_address.function_name(parameters_fields_types_and_values).
Attaches any authorization_entry_xdrs required for nested authorizations.
Signs the transaction through the MPC node identified by account_id.
Optionally validates (simulate) the transaction if validate_transaction=True.
Submits the transaction to the Stellar network with a maximum fee of max_fee.

Notes

contract_address must be a valid C-address (Soroban contract ID).
All addresses in parameters must be valid StrKeys (G… or C…).
map<K,V> keys must follow canonical Soroban ordering; the system auto-sorts if needed.
string values must be valid UTF-8; symbol values ASCII ≤ 32 bytes.
Success here means the transaction was built and broadcast; check '/getTransactionByToken` for final on-chain status.
Transactions may still fail on-chain if the contract reverts or validation fails post-simulation.

-------------------- Request --------------------

     sendTransactionToStellarContractWithContractInfo( 
              account_id=42,
              contract_address="CCOZ5XDWPXVYLIUCLK2YKW5RXPOWINDB2FIQBM5JUXAWLMQW5RRMELNF",
              max_fee=4000000,
              function_name="execute",
              parameters_fields_types_and_values=[
                  ["address", "GBCT2KLG4F4Y7A53KITD4WAM4QW5P5BPBQAFPTUEQWXIROVQU3TNEICW"]
              ],
              structs=None,
              specificFromAddress="GBCT2KLG4F4Y7A53KITD4WAM4QW5P5BPBQAFPTUEQWXIROVQU3TNEICW"
      ):

-------------------- Response --------------------

{
  "FunctionData": {
      "ApprovalRequestStatus": 3,
      "CoinType": "DOT",
      "Transactions": [
          {
              "AmountToTransfer": "1000000",
              "DestinationAddress": "5CBy...Jtf"
          }
      ]
  },
  "Meta": {
      "AccessToken": "f192762c...",
      "Destination": "045bd19d...",
      "Source": "6f8fd2e8...",
      "Time": "2024-09-29 20:48:21.158"
        }
    }

account_idintegerInternal MPC account identifier that will sign the authorization (the "Hot" signer).

contract_addressstringTarget contract address (C-address, StrKey starting with 'C…').

max_feeintegerMaximum fee (in stroops) allowed for this transaction.

function_namestringContract function to invoke (symbol), e.g. "execute".

parameters_fields_types_and_valuesarraySupported Soroban types <ul> <li><code>bool</code> → <code>"true" / "false" / 0 / 1</code></li> <li><code>u32, u64, u128</code> → unsigned integers (base-10, within range)</li> <li><code>i32, i64, i128</code> → signed integers (base-10, within range)</li> <li><code>timepoint</code>, <code>duration</code> → unsigned integer seconds</li> <li><code>symbol</code> → short ASCII identifier (<code>^[A-Za-z0-9_]{1,32}$</code>)</li> <li><code>string</code> → UTF-8 text (≤ 4096 bytes)</li> <li><code>bytes</code> → variable-length hex <code>"0x…"</code>, even length</li> <li><code>address</code> → valid StrKey <code>G…</code> (account) or <code>C…</code> (contract)</li> <li><code>vec<T></code> → list of elements of type T, e.g. <code>["1","2","3"]</code></li> <li><code>map<K,V></code> → sorted list of <code>[key,value]</code> pairs, e.g. <code>[[["symbol","USD"],["u128","1000"]],[["symbol","EUR"],["u128","500"]]]</code></li> </ul> All numeric values must be provided as strings.

structsstring(Optional) Custom struct schemas used in composite parameters.

authorization_entry_xdrsarrayList of base64-encoded SorobanAuthorizationEntry XDRs created by :func:<code>getSorobanAuthorizationEntrySignedByMpc</code>. These entries prove authorization for any <code>require_auth</code> paths inside the call.

validate_transactionbooleanWhen True, the MPC node simulates the transaction and rejects it if the network reports a failure (invalid footprint, auth, etc.).

descriptionstringFree-text note stored with the transaction in your records.

specificFromAddressstringThe specific deposit address to send from. Cannot be used if the account is defined as an Omnibus account.

acceptstringGenerated from available response content types

200success

curl --request POST \
     --url '/sendTransactionToStellarContractWithContractInfo?account_id=1&contract_address=CCOZ5XDWPXVYLIUCLK2YKW5RXPOWINDB2FIQBM5JUXAWLMQW5RRMELNF&max_fee=4000000&function_name=execute&parameters_fields_types_and_values=array&structs=None&validate_transaction=true' \
     --header 'accept: application/json'