Simulate transaction

curl --request POST \
  --url https://api.us1.shinami.com/aptos/node/v1/transactions/simulate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "sender": 6.195948399647823e+76,
  "sequence_number": "32425224034",
  "max_gas_amount": "32425224034",
  "gas_unit_price": "32425224034",
  "expiration_timestamp_secs": "32425224034",
  "payload": {
    "type": "entry_function_payload",
    "function": "0x1::aptos_coin::transfer",
    "type_arguments": [
      "<string>"
    ],
    "arguments": [
      "<any>"
    ]
  },
  "replay_protection_nonce": "32425224034",
  "signature": {
    "type": "ed25519_signature",
    "public_key": 6.195948399647823e+76,
    "signature": 6.195948399647823e+76
  }
}'

[
  {
    "version": "32425224034",
    "hash": "<string>",
    "state_change_hash": "<string>",
    "event_root_hash": "<string>",
    "state_checkpoint_hash": "<string>",
    "gas_used": "32425224034",
    "success": true,
    "vm_status": "<string>",
    "accumulator_root_hash": "<string>",
    "changes": [
      {
        "type": "delete_module",
        "address": 6.195948399647823e+76,
        "state_key_hash": "<string>",
        "module": "0x1::aptos_coin"
      }
    ],
    "sender": 6.195948399647823e+76,
    "sequence_number": "32425224034",
    "max_gas_amount": "32425224034",
    "gas_unit_price": "32425224034",
    "expiration_timestamp_secs": "32425224034",
    "payload": {
      "type": "entry_function_payload",
      "function": "0x1::aptos_coin::transfer",
      "type_arguments": [
        "<string>"
      ],
      "arguments": [
        "<any>"
      ]
    },
    "signature": {
      "type": "ed25519_signature",
      "public_key": 6.195948399647823e+76,
      "signature": 6.195948399647823e+76
    },
    "replay_protection_nonce": "32425224034",
    "events": [
      {
        "guid": {
          "creation_number": "32425224034",
          "account_address": 6.195948399647823e+76
        },
        "sequence_number": "32425224034",
        "type": "<string>",
        "data": "<any>"
      }
    ],
    "timestamp": "32425224034"
  }
]

Transactions

Simulate transaction

The output of the transaction will have the exact transaction outputs and events that running an actual signed transaction would have. However, it will not have the associated state hashes, as they are not updated in storage. This can be used to estimate the maximum gas units for a submitted transaction.

To use this, you must:

Create a SignedTransaction with a zero-padded signature.
Submit a SubmitTransactionRequest containing a UserTransactionRequest containing that signature.

To use this endpoint with BCS, you must submit a SignedTransaction encoded as BCS. See SignedTransaction in types/src/transaction/mod.rs.

POST

transactions

simulate

Simulate transaction

curl --request POST \
  --url https://api.us1.shinami.com/aptos/node/v1/transactions/simulate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "sender": 6.195948399647823e+76,
  "sequence_number": "32425224034",
  "max_gas_amount": "32425224034",
  "gas_unit_price": "32425224034",
  "expiration_timestamp_secs": "32425224034",
  "payload": {
    "type": "entry_function_payload",
    "function": "0x1::aptos_coin::transfer",
    "type_arguments": [
      "<string>"
    ],
    "arguments": [
      "<any>"
    ]
  },
  "replay_protection_nonce": "32425224034",
  "signature": {
    "type": "ed25519_signature",
    "public_key": 6.195948399647823e+76,
    "signature": 6.195948399647823e+76
  }
}'

[
  {
    "version": "32425224034",
    "hash": "<string>",
    "state_change_hash": "<string>",
    "event_root_hash": "<string>",
    "state_checkpoint_hash": "<string>",
    "gas_used": "32425224034",
    "success": true,
    "vm_status": "<string>",
    "accumulator_root_hash": "<string>",
    "changes": [
      {
        "type": "delete_module",
        "address": 6.195948399647823e+76,
        "state_key_hash": "<string>",
        "module": "0x1::aptos_coin"
      }
    ],
    "sender": 6.195948399647823e+76,
    "sequence_number": "32425224034",
    "max_gas_amount": "32425224034",
    "gas_unit_price": "32425224034",
    "expiration_timestamp_secs": "32425224034",
    "payload": {
      "type": "entry_function_payload",
      "function": "0x1::aptos_coin::transfer",
      "type_arguments": [
        "<string>"
      ],
      "arguments": [
        "<any>"
      ]
    },
    "signature": {
      "type": "ed25519_signature",
      "public_key": 6.195948399647823e+76,
      "signature": 6.195948399647823e+76
    },
    "replay_protection_nonce": "32425224034",
    "events": [
      {
        "guid": {
          "creation_number": "32425224034",
          "account_address": 6.195948399647823e+76
        },
        "sequence_number": "32425224034",
        "type": "<string>",
        "data": "<any>"
      }
    ],
    "timestamp": "32425224034"
  }
]

Authorizations

Authorization

string

header

required

Query Parameters

estimate_max_gas_amount

boolean

estimate_gas_unit_price

boolean

estimate_prioritized_gas_unit_price

boolean

Body

sender

string<hex>

required

Example:

sequence_number

string<uint64>

required

Example:

max_gas_amount

string<uint64>

required

Example:

gas_unit_price

string<uint64>

required

Example:

expiration_timestamp_secs

string<uint64>

required

Example:

payload

object

required

Option 1
Option 2
Option 3
Option 4

Show child attributes

signature

object

required

Option 1
Option 2
Option 3
Option 4
Option 5
Option 6
Option 7
Option 8
Option 9
Option 10
Option 11

Show child attributes

replay_protection_nonce

string<uint64>

Example:

Response

version

string<uint64>

required

Example:

hash

string

required

state_change_hash

string

required

event_root_hash

string

required

gas_used

string<uint64>

required

Example:

success

boolean

required

vm_status

string

required

accumulator_root_hash

string

required

changes

object[]

required

Option 1
Option 2
Option 3
Option 4
Option 5
Option 6

Show child attributes

sender

string<hex>

required

Example:

sequence_number

string<uint64>

required

Example:

max_gas_amount

string<uint64>

required

Example:

gas_unit_price

string<uint64>

required

Example:

expiration_timestamp_secs

string<uint64>

required

Example:

payload

object

required

Option 1
Option 2
Option 3
Option 4

Show child attributes

events

object[]

required

Show child attributes

timestamp

string<uint64>

required

Example:

state_checkpoint_hash

string

signature

object

Option 1
Option 2
Option 3
Option 4
Option 5
Option 6
Option 7
Option 8
Option 9
Option 10
Option 11

Show child attributes

replay_protection_nonce

string<uint64>

Example:

Submit batch transactions

Encode submission

Aptos

Movement

SUI

Simulate transaction

Authorizations

Query Parameters

Body

Response