Skip to main content

/cosmos/tx/v1beta1/simulate REST API Endpoint

Simulate simulates executing a transaction for estimating gas usage.

Updated on
May 15, 2024

/cosmos/tx/v1beta1/simulate REST API Endpoint

Body Parameters

tx
object
Transaction data
body
object
The body of the transaction
messages
array
REQUIRED
Messages included in the transaction
type_url
string
The type URL of the message
exchange_rates
string
The exchange rates
feeder
string
The feeder address
validator
string
The validator address
memo
string
Memo field for additional info
timeout_height
string
REQUIRED
Block height after which this transaction will not be processed
extension_options
array
Extension options for advanced transaction processing
type_url
string
The type URL of the extension
value
string
The value of the extension
non_critical_extension_options
array
Non-critical extension options
type_url
string
The type URL of the non-critical extension
value
string
The value of the non-critical extension
auth_info
object
Authorization info for the transaction
signer_infos
array
Info about signers of the transaction
public_key
object
Public key of the signer
type_url
string
The type URL of the public key
value
string
The value of the public key
mode_info
object
Mode info for signing
single
object
Single mode info
mode
string
Signing mode
multi
object
Multi-signature mode info
bitarray
object
Bit array for multi-signature
extra_bits_stored
integer
Extra bits stored in the bit array
elems
string
Elements of the bit array
mode_infos
array
Info about each signing mode in a multi-signature
sequence
string
Sequence number of the signer
fee
object
REQUIRED
Fee information for the transaction
amount
array
Amount of fees for the transaction
denom
string
The denomination of the fee
amount
string
The amount of the fee
gas_limit
string
The gas limit for the transaction
payer
string
The payer of the transaction fees
granter
string
The granter of the transaction fees
tip
object
The optional tip used for transaction fees paid in another denom
amount
array
Array of objects representing the amount of the tip
denom
string
The denomination of the tip
amount
string
The amount of the tip
tipper
string
The address of the account paying for the tip
signatures
array
REQUIRED
An array of signatures for the transaction
tx_bytes
string
The transaction bytes

Returns

params
object
The params object which contains the following fields:
gas_info
object
The gas_info object which contains the following fields:
gas_wanted
string
The maximum units of work that is allowed to perform
gas_used
string
The amount of gas actually consumed
result
object
The result object which contains the following fields:
data
string
Any data returned from message or handler execution
log
string
The log information from message or handler execution
events
array
An array of events
type
string
The type of the event
attributes
array
An array of attributes
key
string
Attribute key which describes the type of information the value holds
value
string
Attribute value associated with the corresponding key
index
boolean
A boolean flag indicating whether the attribute is indexed
msg_responses
array
An array of message handler responses
type_url
string
A URL/resource name that uniquely identifies the type of the serialized protocol buffer message
value
string
A valid serialized protocol buffer of the above specified type
Request
1
curl --location 'https://docs-demo.cosmos-mainnet.quiknode.pro/cosmos/tx/v1beta1/simulate' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
  "tx": {
5
    "body": {
6
      "messages": [
7
        {
8
          "type_url": "TYPE_URL",
9
          "value": "VALUE"
10
        }
11
      ],
12
      "memo": "MEMO",
13
      "timeout_height": "TIMEOUT_HEIGHT",
14
      "extension_options": [
15
        {
16
          "type_url": "TYPE_URL",
17
          "value": "VALUE"
18
        }
19
      ],
20
      "non_critical_extension_options": [
21
        {
22
          "type_url": "TYPE_URL",
23
          "value": "VALUE"
24
        }
25
      ]
26
    },
27
    "auth_info": {
28
      "signer_infos": [
29
        {
30
          "public_key": {
31
            "type_url": "TYPE_URL",
32
          "value": "VALUE"
33
          },
34
          "mode_info": {
35
            "single": {
36
              "mode": "SIGN_MODE_UNSPECIFIED"
37
            },
38
            "multi": {
39
              "bitarray": {
40
                "extra_bits_stored": 0,
41
                "elems": "ELEMS"
42
              },
43
              "mode_infos": [
44
                {}
45
              ]
46
            }
47
          },
48
          "sequence": "SEQUENCE"
49
        }
50
      ],
51
      "fee": {
52
        "amount": [
53
          {
54
            "denom": "DENOM",
55
            "amount": "AMOUNT"
56
          }
57
        ],
58
        "gas_limit": "GAS_LIMIT",
59
        "payer": "PAYER",
60
        "granter": "GRANTER"
61
      },
62
      "tip": {
63
        "amount": [
64
          {
65
            "denom": "DENOM",
66
            "amount": "AMOUNT"
67
          }
68
        ],
69
        "tipper": "TIPPER"
70
      }
71
    },
72
    "signatures": [
73
      "SIGNATURES"
74
    ]
75
  },
76
  "tx_bytes": "TX_BYTES"
77
}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free