1 of 9

Soroban API

getEvents

Clients can request a filtered list of events emitted by a given ledger range.

This method will use 10 Compute Units.

Reference: Here

Parameters

startLedger (required)
- Stringified ledger sequence number to fetch events after (inclusive). This method will return an error if startLedger is less than the oldest ledger stored in this node, or greater than the latest ledger seen by this node. If a cursor is included in the request, startLedger must be omitted.
filters
- array of: type (string) A comma separated list of event types (system, contract, or diagnostic) used to filter events. If omitted, all event types are included.
- contractIds (array) (optional) List of contract ids to query for events. If omitted, return events for all contracts. Maximum 5 contract IDs are allowed per request.
- topics (array) (optional) List of topic filters. If omitted, query for all events. If multiple filters are specified, events will be included if they match any of the filters. Maximum 5 filters are allowed per request.
pagination (see "Pagination")

Returns

latestLedger (string): Stringified-number of the current latest ledger observed by the node when this response was generated.

// Result
{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "latestLedger": "230473",
    "events": [
      {
        "type": "contract",
        "ledger": "230010",
        "ledgerClosedAt": "2023-01-23T18:54:41Z",
        "contractId": "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT",
        "id": "0000987885427757056-0000000001",
        "pagingToken": "0000987885427757056-0000000001",
        "inSuccessfulContractCall": true,
        "topic": [
          "AAAABQAAAAh0cmFuc2Zlcg==",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o=",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o="
        ],
        "value": {
          "xdr": "AAAABAAAAAEAAAAFAAAAAAABhqAAAAAAAAAAAA=="
        }
      },
      {
        "type": "contract",
        "ledger": "230170",
        "ledgerClosedAt": "2023-01-23T19:08:37Z",
        "contractId": "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT",
        "id": "0000988572622524416-0000000001",
        "pagingToken": "0000988572622524416-0000000001",
        "inSuccessfulContractCall": true,
        "topic": [
          "AAAABQAAAAh0cmFuc2Zlcg==",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o=",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o="
        ],
        "value": {
          "xdr": "AAAABAAAAAEAAAAFAAAAAAAHoSAAAAAAAAAAAA=="
        }
      }
    ]
  }
}

curl https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getEvents",
  "params": {
    "startLedger": "227000",
    "filters": [
      {
        "type": "contract",
        "contractIds": [
          "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT"
        ],
        "topics": [
          [
            "AAAABQAAAAh0cmFuc2Zlcg==",
            "*",
            "*"
          ]
        ]
      }
    ],
    "pagination": {
      "limit": 100
    }
  }
}'

curl https://testnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getEvents",
  "params": {
    "startLedger": "227000",
    "filters": [
      {
        "type": "contract",
        "contractIds": [
          "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT"
        ],
        "topics": [
          [
            "AAAABQAAAAh0cmFuc2Zlcg==",
            "*",
            "*"
          ]
        ]
      }
    ],
    "pagination": {
      "limit": 100
    }
  }
}'

getHealth

General node health check.

This method will use 10 .

Reference:

Parameters

None

Returns

status (string): Stringified-number of the current latest ledger observed by the node when this response was generated.

getLatestLedger

For finding out the current latest known ledger of this node. This is a subset of the ledger info from Horizon.

This method will use 10 Compute Units.

Reference: Here

Parameters

None

Returns

id (string) Hash of the latest ledger as a hex-encoded string

protocolVersion (number) Stellar Core protocol version associated with the latest ledger

sequence (number) Sequence number of the latest ledger

// Result
{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "id": "2a00000000000000000000000000000000000000000000000000000000000000",
    "protocolVersion": 20,
    "sequence": 666
  }
}

curl https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getLatestLedger"
  }'

curl https://testnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getLatestLedger"
  }'

getLedgerEntries

For reading the current value of ledger entries directly.

Allows you to directly inspect the current state of a contract, a contract's code, or any other ledger entry. This is a backup way to access your contract data which may not be available via events or

This method will use 10 .

Reference:

Parameters

keys (required) Array containing the keys of the ledger entries you wish to retrieve. (an array of serialized base64 strings)

Returns

entries array[object] Hash of the latest ledger as a hex-encoded string

latestLedger (number) The current latest ledger observed by the node when this response was generated.

getNetwork

General information about the currently configured network. This response will contain all the information needed to successfully submit transactions to the network this node serves.

This method will use 10 Compute Units.

Reference: Here

Parameters

None

Returns

friendbotUrl (string) (optional) The URL of this network's "friendbot" faucet

passphrase (string) Network passphrase configured

protocolVersion (string) Protocol version of the latest ledger

// Result
{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "friendbotUrl": "https://friendbot.stellar.org/",
    "passphrase": "Test SDF Network ; September 2015",
    "protocolVersion": "20"
  }
}

curl https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getNetwork"
}'

curl https://testnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getNetwork"
}'

getTransaction

Clients will poll this to tell when the transaction has been completed.

This method will use 10 .

Reference:

Parameters

hash (string)(required) Transaction hash to query, as a hex-encoded string

Returns

status string - The current status of the transaction by hash
- Allowed values:SUCCESSNOT_FOUNDFAILED
latestLedger string - The latest ledger known to Soroban-RPC at the time it handled the getTransaction() request.
latestLedgerCloseTime string - The unix timestamp of the close time of the latest ledger known to Soroban-RPC at the time it handled the getTransaction() request.
oldestLedger string - The oldest ledger ingested by Soroban-RPC at the time it handled the getTransaction() request.
oldestLedgerCloseTime string - The unix timestamp of the close time of the oldest ledger ingested by Soroban-RPC at the time it handled the getTransaction() request.
ledger string - (optional) The sequence of the ledger which included the transaction. This field is only present if status is SUCCESS or FAILED.
createdAt string - (optional) The unix timestamp of when the transaction was included in the ledger. This field is only present if status is SUCCESS or FAILED.
applicationOrder number - (optional) The index of the transaction among all transactions included in the ledger. This field is only present if status is SUCCESS or FAILED.
feeBump boolean - (optional) Indicates whether the transaction was fee bumped. This field is only present if status is SUCCESS or FAILED.
envelopeXdr string - (optional) A base64 encoded string of the raw TransactionEnvelope XDR struct for this transaction.
resultXdr string - (optional) A base64 encoded string of the raw TransactionResult XDR struct for this transaction. This field is only present if status is SUCCESS or FAILED.
resultMetaXdr string (optional) A base64 encoded string of the raw TransactionResultMeta XDR struct for this transaction.

sendTransaction

Submit a real transaction to the Stellar network. This is the only way to make changes "on-chain".

This method will use 10 .

Reference:

Parameters

transaction (string)(required) The signed transaction to broadcast (serialized in base64).

Returns

hash string - The transaction hash (in an hex-encoded string).
status string - The current status of the transaction by hash.
- Allowed values:PENDINGDUPLICATETRY_AGAIN_LATERERROR
latestLedger string - The latest ledger known to Soroban-RPC at the time it handled the sendTransaction() request.
latestLedgerCloseTime string - The unix timestamp of the close time of the latest ledger known to Soroban-RPC at the time it handled the sendTransaction() request.
errorResultXdr string (optional) - If the transaction status is ERROR, this will be a base64 encoded string of the raw TransactionResult XDR struct containing details on why stellar-core rejected the transaction.

simulateTransaction

Submit a trial contract invocation to simulate how it would be executed by the network. This endpoint calculates the effective transaction data, required authorizations, and minimal resource fee. It provides a way to test and analyze the potential outcomes of a transaction without actually submitting it to the network.

This method will use 10 .

Reference:

Parameters

transaction (string)(required) The transaction to be simulated (serialized in base64)

Returns

minResourceFee string (optional) - Stringified number - Recommended minimum resource fee to add when submitting the transaction. This fee is to be added on top of the . Not present in case of error.
cost object (optional) - Information about instructions used, etc. Not present in case of error.
results array[object] (optional) - This array will only have one element: the result for the Host Function invocation. Only present on successful simulation (i.e. no error) of InvokeHostFunction operations.
transactionData string (optional) - Serialized base64 string - The recommended Soroban Transaction Data to use when submitting the simulated transaction. This data contains the refundable fee and resource usage information such as the ledger footprint and IO access data (serialized in a base64 string). Not present in case of error.
events array (optional) - Array of serialized base64 strings - Array of the events emitted during the contract invocation. The events are ordered by their emission time. (an array of serialized base64 strings). Only present when simulating of InvokeHostFunction operations, note that it can be present on error, providing extra context about what failed.
restorePreamble (object) (optional) - It can only be present on sucessful simulation (i.e. no error) of InvokeHostFunction operations. If present, it indicates that the simulation detected expired ledger entries which need to be restored before the submission of the InvokeHostFunction operation. The minResourceFee and transactionData fields should be used to submit a transaction containing a RestoreFootprint operation
latestLedger (string) - A Stringified number - Current latest closed ledger (LCL) observed by the node when this response was generated. Always present.
error string (optional) - This field will include details about why the invoke host function call failed. Only present if the transaction simulation failed.

getEvents

Clients can request a filtered list of events emitted by a given ledger range.

This method will use 10 Compute Units.

Reference: Here

Parameters

startLedger (required)
- Stringified ledger sequence number to fetch events after (inclusive). This method will return an error if startLedger is less than the oldest ledger stored in this node, or greater than the latest ledger seen by this node. If a cursor is included in the request, startLedger must be omitted.
filters
- array of: type (string) A comma separated list of event types (system, contract, or diagnostic) used to filter events. If omitted, all event types are included.
- contractIds (array) (optional) List of contract ids to query for events. If omitted, return events for all contracts. Maximum 5 contract IDs are allowed per request.
- topics (array) (optional) List of topic filters. If omitted, query for all events. If multiple filters are specified, events will be included if they match any of the filters. Maximum 5 filters are allowed per request.
pagination (see "Pagination")

Returns

latestLedger (string): Stringified-number of the current latest ledger observed by the node when this response was generated.

// Result
{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "latestLedger": "230473",
    "events": [
      {
        "type": "contract",
        "ledger": "230010",
        "ledgerClosedAt": "2023-01-23T18:54:41Z",
        "contractId": "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT",
        "id": "0000987885427757056-0000000001",
        "pagingToken": "0000987885427757056-0000000001",
        "inSuccessfulContractCall": true,
        "topic": [
          "AAAABQAAAAh0cmFuc2Zlcg==",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o=",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o="
        ],
        "value": {
          "xdr": "AAAABAAAAAEAAAAFAAAAAAABhqAAAAAAAAAAAA=="
        }
      },
      {
        "type": "contract",
        "ledger": "230170",
        "ledgerClosedAt": "2023-01-23T19:08:37Z",
        "contractId": "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT",
        "id": "0000988572622524416-0000000001",
        "pagingToken": "0000988572622524416-0000000001",
        "inSuccessfulContractCall": true,
        "topic": [
          "AAAABQAAAAh0cmFuc2Zlcg==",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o=",
          "AAAABAAAAAEAAAAAAAAAAgAAAAUAAAAHQWNjb3VudAAAAAAEAAAAAQAAAAgAAAAAHavpBsZgRv4pEDXWB0NnwQBvvAL/8adWXz2fV7eNq2o="
        ],
        "value": {
          "xdr": "AAAABAAAAAEAAAAFAAAAAAAHoSAAAAAAAAAAAA=="
        }
      }
    ]
  }
}

curl https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getEvents",
  "params": {
    "startLedger": "227000",
    "filters": [
      {
        "type": "contract",
        "contractIds": [
          "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT"
        ],
        "topics": [
          [
            "AAAABQAAAAh0cmFuc2Zlcg==",
            "*",
            "*"
          ]
        ]
      }
    ],
    "pagination": {
      "limit": 100
    }
  }
}'

curl https://testnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getEvents",
  "params": {
    "startLedger": "227000",
    "filters": [
      {
        "type": "contract",
        "contractIds": [
          "CB64D3G7SM2RTH6JSGG34DDTFTQ5CFDKVDZJZSODMCX4NJ2HV2KN7OHT"
        ],
        "topics": [
          [
            "AAAABQAAAAh0cmFuc2Zlcg==",
            "*",
            "*"
          ]
        ]
      }
    ],
    "pagination": {
      "limit": 100
    }
  }
}'

getTransaction

Clients will poll this to tell when the transaction has been completed.

This method will use 10 .

Reference:

Parameters

hash (string)(required) Transaction hash to query, as a hex-encoded string

Returns

status string - The current status of the transaction by hash
- Allowed values:SUCCESSNOT_FOUNDFAILED
latestLedger string - The latest ledger known to Soroban-RPC at the time it handled the getTransaction() request.
latestLedgerCloseTime string - The unix timestamp of the close time of the latest ledger known to Soroban-RPC at the time it handled the getTransaction() request.
oldestLedger string - The oldest ledger ingested by Soroban-RPC at the time it handled the getTransaction() request.
oldestLedgerCloseTime string - The unix timestamp of the close time of the oldest ledger ingested by Soroban-RPC at the time it handled the getTransaction() request.
ledger string - (optional) The sequence of the ledger which included the transaction. This field is only present if status is SUCCESS or FAILED.
createdAt string - (optional) The unix timestamp of when the transaction was included in the ledger. This field is only present if status is SUCCESS or FAILED.
applicationOrder number - (optional) The index of the transaction among all transactions included in the ledger. This field is only present if status is SUCCESS or FAILED.
feeBump boolean - (optional) Indicates whether the transaction was fee bumped. This field is only present if status is SUCCESS or FAILED.
envelopeXdr string - (optional) A base64 encoded string of the raw TransactionEnvelope XDR struct for this transaction.
resultXdr string - (optional) A base64 encoded string of the raw TransactionResult XDR struct for this transaction. This field is only present if status is SUCCESS or FAILED.
resultMetaXdr string (optional) A base64 encoded string of the raw TransactionResultMeta XDR struct for this transaction.

// SUCCESS
{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "status": "SUCCESS",
    "latestLedger": "45075181",
    "latestLedgerCloseTime": "1677115742",
    "oldestLedger": "45070000",
    "latestLedgerCloseTime": "1677000000",
    "ledger": "45070700",
    "createdAt": "1677009000",
    "applicationOrder": 1,
    "feeBump": false,
    "envelope_xdr": "AAAAAgAAAABzdv3ojkzWHMD7KUoXhrPx0GH18vHKV0ZfqpMiEblG1gAAp18AAAAAAAAAAgAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAHN2/eiOTNYcwPspSheGs/HQYfXy8cpXRl+qkyIRuUbWAAAAGAAAAAEAAAABAAAAAPVf8W9m9DNgJmuV22+P7AHXYDEFQwauSks4BZj2z9EUAAAAAO3beL34UBBpCfUUPCfcnqX8YQKn41UhnKu6BInkVe9lAAAAAAAAAAEAAAABAAAAB+3beL34UBBpCfUUPCfcnqX8YQKn41UhnKu6BInkVe9lAAAAAQAAAAbhq+vRxjISTR62JpK1SAnzz1cZKpSpkRlwLJH6ZrzssgAAABQAAUKLAAAUkAAAAIAAAACoAAAAAAAAACEAAAAAAAAAARG5RtYAAABA+Vy3k86bNEP7rP8hb3cY1QWYhRa3CnF7jqHUj22Rd++2a0YwCKrMbofTUOb21GP6aFZwfKVvaokS22u1to5xDw==",
    "resultXdr": "AAAAAAAApS4AAAAAAAAAAQAAAAAAAAAYAAAAAAAAAAEAAAANAAAAIOGr69HGMhJNHrYmkrVICfPPVxkqlKmRGXAskfpmvOyyAAAAAA==",
    "result_meta_xdr": "AAAAAwAAAAIAAAADAAAAFgAAAAAAAAAAc3b96I5M1hzA+ylKF4az8dBh9fLxyldGX6qTIhG5RtYN4Lazp2JdKwAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAANAAAAAGRuCr8AAAAAAAAAAQAAABYAAAAAAAAAAHN2/eiOTNYcwPspSheGs/HQYfXy8cpXRl+qkyIRuUbWDeC2s6diXSsAAAAAAAAAAgAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAFgAAAABkbgrIAAAAAAAAAAEAAAABAAAAAAAAABYAAAAG4avr0cYyEk0etiaStUgJ889XGSqUqZEZcCyR+ma87LIAAAAUAAAAEgAAAADt23i9+FAQaQn1FDwn3J6l/GECp+NVIZyrugSJ5FXvZQAAAAAAAAAAAAAAAQAAAAAAAAAAAAClLgAAAAAAAAABAAAAAAAAABgAAAAAAAAAAQAAAA0AAAAg4avr0cYyEk0etiaStUgJ889XGSqUqZEZcCyR+ma87LIAAAAA1pFOFvAXyYyG3zRHjl+0ABs5xH4/40CX9PPHFC+QN5jLvEh1Deu4U1CTs96viKx/TP+HQlV2pY3iusdUrNtGFrr72ylPbuM+gn7/FJKmJcDFiKveRR/kP8mOYOcy9S4RAAAAAA=="
  }
}


// NOT FOUND
{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "status": "NOT_FOUND",
    "latestLedger": "45075181",
    "latestLedgerCloseTime": "1677115742",
    "oldestLedger": "45070000",
    "latestLedgerCloseTime": "1677000000"
  }
}

curl https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getTransaction",
  "params": {
    "hash": "a01441a4d0b80769d2c2d97dcd28d13e9036065da14ea83731424d77efc50894"
  }
}'

curl https://testnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getTransaction",
  "params": {
    "hash": "a01441a4d0b80769d2c2d97dcd28d13e9036065da14ea83731424d77efc50894"
  }
}'

simulateTransaction

This method will use 10 .

Reference:

Parameters

transaction (string)(required) The transaction to be simulated (serialized in base64)

Returns

minResourceFee string (optional) - Stringified number - Recommended minimum resource fee to add when submitting the transaction. This fee is to be added on top of the . Not present in case of error.
cost object (optional) - Information about instructions used, etc. Not present in case of error.
results array[object] (optional) - This array will only have one element: the result for the Host Function invocation. Only present on successful simulation (i.e. no error) of InvokeHostFunction operations.
transactionData string (optional) - Serialized base64 string - The recommended Soroban Transaction Data to use when submitting the simulated transaction. This data contains the refundable fee and resource usage information such as the ledger footprint and IO access data (serialized in a base64 string). Not present in case of error.
events array (optional) - Array of serialized base64 strings - Array of the events emitted during the contract invocation. The events are ordered by their emission time. (an array of serialized base64 strings). Only present when simulating of InvokeHostFunction operations, note that it can be present on error, providing extra context about what failed.
restorePreamble (object) (optional) - It can only be present on sucessful simulation (i.e. no error) of InvokeHostFunction operations. If present, it indicates that the simulation detected expired ledger entries which need to be restored before the submission of the InvokeHostFunction operation. The minResourceFee and transactionData fields should be used to submit a transaction containing a RestoreFootprint operation
latestLedger (string) - A Stringified number - Current latest closed ledger (LCL) observed by the node when this response was generated. Always present.
error string (optional) - This field will include details about why the invoke host function call failed. Only present if the transaction simulation failed.

// Result
{
  "jsonrpc": "2.0",
  "id": 1102,
  "result": {
    "transactionData": "AAAAAwAAAAAAAAAAYvwdC9CRsrYcDdZWNGsqaNfTR8bywsjubQRHAlb8BfcAAAAG4avr0cYyEk0etiaStUgJ889XGSqUqZEZcCyR+ma87LIAAAAUAAAAB8zDhJ3ZTMHmdBjlVh/7d1HDdo+QI1ZXGmeRzBwVAoVXAAAAAQAAAAbhq+vRxjISTR62JpK1SAnzz1cZKpSpkRlwLJH6ZrzssgAAABUAAAAAAAAAAGL8HQvQkbK2HA3WVjRrKmjX00fG8sLI7m0ERwJW/AX3ACb/vgAAFcQAAAC0AAABrAAAAAAAAABUAAAAAA==",
    "events": [
      "AAAAAQAAAAAAAAAB4avr0cYyEk0etiaStUgJ889XGSqUqZEZcCyR+ma87LIAAAABAAAAAAAAAAEAAAAOAAAABGF1dGgAAAAPAAAABXdvcmxkAAAA",
      "AAAAAQAAAAAAAAAB4avr0cYyEk0etiaStUgJ889XGSqUqZEZcCyR+ma87LIAAAABAAAAAAAAAAEAAAAOAAAABGF1dGgAAAAPAAAABXdvcmxkAAAA"
    ],
    "minResourceFee": "79488",
    "results": [
      {
        "auth": [
          "AAAAAQAAAAAAAAAAYvwdC9CRsrYcDdZWNGsqaNfTR8bywsjubQRHAlb8BfcAAAAAAAAAAOGr69HGMhJNHrYmkrVICfPPVxkqlKmRGXAskfpmvOyyAAAABGF1dGgAAAACAAAAEwAAAAAAAAAAYvwdC9CRsrYcDdZWNGsqaNfTR8bywsjubQRHAlb8BfcAAAAPAAAABXdvcmxkAAAAAAAAAAAAAAA="
        ],
        "xdr": "AAAAEwAAAAAAAAAAYvwdC9CRsrYcDdZWNGsqaNfTR8bywsjubQRHAlb8Bfc="
      }
    ],
    "cost": {
      "cpuInsns": "2222468",
      "memBytes": "2204681"
    },
    "latestLedger": "23456"
  }
}

curl https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "simulateTransaction",
  "params": {
    "transaction": "AAAAAgAAAABzdv3ojkzWHMD7KUoXhrPx0GH18vHKV0ZfqpMiEblG1gAAAGQAAAAAAAAABAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAHN2/eiOTNYcwPspSheGs/HQYfXy8cpXRl+qkyIRuUbWAAAAGAAAAAIAAAAAAAAABAAAAA0AAAAg4avr0cYyEk0etiaStUgJ889XGSqUqZEZcCyR+ma87LIAAAAPAAAABGF1dGgAAAATAAAAAAAAAABi/B0L0JGythwN1lY0aypo19NHxvLCyO5tBEcCVvwF9wAAAA8AAAAFd29ybGQAAAAAAAAAAAAAAAAAAAQAAAANAAAAIOGr69HGMhJNHrYmkrVICfPPVxkqlKmRGXAskfpmvOyyAAAADwAAAARhdXRoAAAAEwAAAAAAAAAAYvwdC9CRsrYcDdZWNGsqaNfTR8bywsjubQRHAlb8BfcAAAAPAAAABXdvcmxkAAAAAAAAAAAAAAAAAAAA"
  }
}'

curl https://testnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "simulateTransaction",
  "params": {
    "transaction": "AAAAAgAAAABzdv3ojkzWHMD7KUoXhrPx0GH18vHKV0ZfqpMiEblG1gAAAGQAAAAAAAAABAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAHN2/eiOTNYcwPspSheGs/HQYfXy8cpXRl+qkyIRuUbWAAAAGAAAAAIAAAAAAAAABAAAAA0AAAAg4avr0cYyEk0etiaStUgJ889XGSqUqZEZcCyR+ma87LIAAAAPAAAABGF1dGgAAAATAAAAAAAAAABi/B0L0JGythwN1lY0aypo19NHxvLCyO5tBEcCVvwF9wAAAA8AAAAFd29ybGQAAAAAAAAAAAAAAAAAAAQAAAANAAAAIOGr69HGMhJNHrYmkrVICfPPVxkqlKmRGXAskfpmvOyyAAAADwAAAARhdXRoAAAAEwAAAAAAAAAAYvwdC9CRsrYcDdZWNGsqaNfTR8bywsjubQRHAlb8BfcAAAAPAAAABXdvcmxkAAAAAAAAAAAAAAAAAAAA"
  }
}'