Tx

Simulate simulates executing a transaction for estimating gas usage.

post

Body

SimulateRequest is the request type for the Service.Simulate RPC method.

txobjectOptional

tx is the transaction to simulate. Deprecated. Send raw tx bytes instead.

tx_bytesstring · byteOptional

tx_bytes is the raw transaction.

Since: cosmos-sdk 0.43

Responses

application/json

objectOptional

SimulateResponse is the response type for the Service.SimulateRPC method.

application/json

post

HTTPcURLJavaScriptPython

POST /cosmos/tx/v1beta1/simulate HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Content-Type: application/json
Accept: */*
Content-Length: 643

{
  "tx": {
    "body": {
      "messages": [
        {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "memo": "text",
      "timeout_height": "text",
      "extension_options": [
        {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "non_critical_extension_options": [
        {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_UNSPECIFIED"
            },
            "multi": "[Circular Reference]"
          },
          "sequence": "text"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "text",
            "amount": "text"
          }
        ],
        "gas_limit": "text",
        "payer": "text",
        "granter": "text"
      }
    },
    "signatures": [
      "Ynl0ZXM="
    ]
  },
  "tx_bytes": "Ynl0ZXM="
}

{
  "gas_info": {
    "gas_wanted": "text",
    "gas_used": "text"
  },
  "result": {
    "data": "Ynl0ZXM=",
    "log": "text",
    "events": [
      {
        "type": "text",
        "attributes": [
          {
            "key": "text",
            "value": "text",
            "index": true
          }
        ]
      }
    ]
  }
}

GetTxsEvent fetches txs by event.

get

Query parameters

eventsanyOptional

events is the list of transaction event type.

pagination.keyanyOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetanyOptional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitanyOptional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalanyOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverseanyOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

order_byanyOptional

• ORDER_BY_UNSPECIFIED: ORDER_BY_UNSPECIFIED specifies an unknown sorting order. OrderBy defaults to ASC in this case.
• ORDER_BY_ASC: ORDER_BY_ASC defines ascending order
• ORDER_BY_DESC: ORDER_BY_DESC defines descending order

Responses

application/json

objectOptional

GetTxsEventResponse is the response type for the Service.TxsByEvents RPC method.

application/json

get

HTTPcURLJavaScriptPython

GET /cosmos/tx/v1beta1/txs HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "memo": "text",
        "timeout_height": "text",
        "extension_options": [
          {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "non_critical_extension_options": [
          {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "@type": "text",
              "ANY_ADDITIONAL_PROPERTY": "anything"
            },
            "mode_info": "[Circular Reference]",
            "sequence": "text"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "gas_limit": "text",
          "payer": "text",
          "granter": "text"
        }
      },
      "signatures": [
        "Ynl0ZXM="
      ]
    }
  ],
  "tx_responses": [
    {
      "height": "text",
      "txhash": "text",
      "codespace": "text",
      "code": 1,
      "data": "text",
      "raw_log": "text",
      "logs": [
        {
          "msg_index": 1,
          "log": "text",
          "events": [
            {
              "type": "text",
              "attributes": [
                {
                  "key": "text",
                  "value": "text"
                }
              ]
            }
          ]
        }
      ],
      "info": "text",
      "gas_wanted": "text",
      "gas_used": "text",
      "tx": {
        "@type": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "timestamp": "text",
      "events": [
        {
          "type": "text",
          "attributes": [
            {
              "key": "text",
              "value": "text",
              "index": true
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

BroadcastTx broadcast transaction.

post

Body

BroadcastTxRequest is the request type for the Service.BroadcastTxRequest RPC method.

tx_bytesstring · byteOptional

tx_bytes is the raw transaction.

modestring · enumOptional

BroadcastMode specifies the broadcast mode for the TxService.Broadcast RPC method.

• BROADCAST_MODE_UNSPECIFIED: zero-value for mode ordering
• BROADCAST_MODE_BLOCK: BROADCAST_MODE_BLOCK defines a tx broadcasting mode where the client waits for the tx to be committed in a block.
• BROADCAST_MODE_SYNC: BROADCAST_MODE_SYNC defines a tx broadcasting mode where the client waits for a CheckTx execution response only.
• BROADCAST_MODE_ASYNC: BROADCAST_MODE_ASYNC defines a tx broadcasting mode where the client returns immediately.

Default: BROADCAST_MODE_UNSPECIFIEDAvailable options:

Responses

application/json

objectOptional

BroadcastTxResponse is the response type for the Service.BroadcastTx method.

application/json

post

HTTPcURLJavaScriptPython

POST /cosmos/tx/v1beta1/txs HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "tx_bytes": "Ynl0ZXM=",
  "mode": "BROADCAST_MODE_UNSPECIFIED"
}

{
  "tx_response": {
    "height": "text",
    "txhash": "text",
    "codespace": "text",
    "code": 1,
    "data": "text",
    "raw_log": "text",
    "logs": [
      {
        "msg_index": 1,
        "log": "text",
        "events": [
          {
            "type": "text",
            "attributes": [
              {
                "key": "text",
                "value": "text"
              }
            ]
          }
        ]
      }
    ],
    "info": "text",
    "gas_wanted": "text",
    "gas_used": "text",
    "tx": {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "timestamp": "text",
    "events": [
      {
        "type": "text",
        "attributes": [
          {
            "key": "text",
            "value": "text",
            "index": true
          }
        ]
      }
    ]
  }
}

GetBlockWithTxs fetches a block with decoded txs.

get

Since: cosmos-sdk 0.45.2

Path parameters

heightanyRequired

height is the height of the block to query.

Query parameters

pagination.keyanyOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetanyOptional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitanyOptional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalanyOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverseanyOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

application/json

objectOptional

GetBlockWithTxsResponse is the response type for the Service.GetBlockWithTxs method.

Since: cosmos-sdk 0.45.2

application/json

get

HTTPcURLJavaScriptPython

GET /cosmos/tx/v1beta1/txs/block/{height} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "memo": "text",
        "timeout_height": "text",
        "extension_options": [
          {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "non_critical_extension_options": [
          {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "@type": "text",
              "ANY_ADDITIONAL_PROPERTY": "anything"
            },
            "mode_info": "[Circular Reference]",
            "sequence": "text"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "gas_limit": "text",
          "payer": "text",
          "granter": "text"
        }
      },
      "signatures": [
        "Ynl0ZXM="
      ]
    }
  ],
  "block_id": {
    "hash": "Ynl0ZXM=",
    "part_set_header": {
      "total": 1,
      "hash": "Ynl0ZXM="
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "text",
        "app": "text"
      },
      "chain_id": "text",
      "height": "text",
      "time": "2025-04-23T13:52:46.510Z",
      "last_block_id": {
        "hash": "Ynl0ZXM=",
        "part_set_header": {
          "total": 1,
          "hash": "Ynl0ZXM="
        }
      },
      "last_commit_hash": "Ynl0ZXM=",
      "data_hash": "Ynl0ZXM=",
      "validators_hash": "Ynl0ZXM=",
      "next_validators_hash": "Ynl0ZXM=",
      "consensus_hash": "Ynl0ZXM=",
      "app_hash": "Ynl0ZXM=",
      "last_results_hash": "Ynl0ZXM=",
      "evidence_hash": "Ynl0ZXM=",
      "proposer_address": "Ynl0ZXM="
    },
    "data": {
      "txs": [
        "Ynl0ZXM="
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "text",
              "round": 1,
              "block_id": {
                "hash": "Ynl0ZXM=",
                "part_set_header": {
                  "total": 1,
                  "hash": "Ynl0ZXM="
                }
              },
              "timestamp": "2025-04-23T13:52:46.510Z",
              "validator_address": "Ynl0ZXM=",
              "validator_index": 1,
              "signature": "Ynl0ZXM=",
              "extension": "Ynl0ZXM=",
              "extension_signature": "Ynl0ZXM="
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "text",
              "round": 1,
              "block_id": {
                "hash": "Ynl0ZXM=",
                "part_set_header": {
                  "total": 1,
                  "hash": "Ynl0ZXM="
                }
              },
              "timestamp": "2025-04-23T13:52:46.510Z",
              "validator_address": "Ynl0ZXM=",
              "validator_index": 1,
              "signature": "Ynl0ZXM=",
              "extension": "Ynl0ZXM=",
              "extension_signature": "Ynl0ZXM="
            },
            "total_voting_power": "text",
            "validator_power": "text",
            "timestamp": "2025-04-23T13:52:46.510Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "text",
                    "app": "text"
                  },
                  "chain_id": "text",
                  "height": "text",
                  "time": "2025-04-23T13:52:46.510Z",
                  "last_block_id": {
                    "hash": "Ynl0ZXM=",
                    "part_set_header": {
                      "total": 1,
                      "hash": "Ynl0ZXM="
                    }
                  },
                  "last_commit_hash": "Ynl0ZXM=",
                  "data_hash": "Ynl0ZXM=",
                  "validators_hash": "Ynl0ZXM=",
                  "next_validators_hash": "Ynl0ZXM=",
                  "consensus_hash": "Ynl0ZXM=",
                  "app_hash": "Ynl0ZXM=",
                  "last_results_hash": "Ynl0ZXM=",
                  "evidence_hash": "Ynl0ZXM=",
                  "proposer_address": "Ynl0ZXM="
                },
                "commit": {
                  "height": "text",
                  "round": 1,
                  "block_id": {
                    "hash": "Ynl0ZXM=",
                    "part_set_header": {
                      "total": 1,
                      "hash": "Ynl0ZXM="
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "Ynl0ZXM=",
                      "timestamp": "2025-04-23T13:52:46.510Z",
                      "signature": "Ynl0ZXM="
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "Ynl0ZXM=",
                    "pub_key": {
                      "ed25519": "Ynl0ZXM=",
                      "secp256k1": "Ynl0ZXM=",
                      "sr25519": "Ynl0ZXM="
                    },
                    "voting_power": "text",
                    "proposer_priority": "text"
                  }
                ],
                "proposer": {
                  "address": "Ynl0ZXM=",
                  "pub_key": {
                    "ed25519": "Ynl0ZXM=",
                    "secp256k1": "Ynl0ZXM=",
                    "sr25519": "Ynl0ZXM="
                  },
                  "voting_power": "text",
                  "proposer_priority": "text"
                },
                "total_voting_power": "text"
              }
            },
            "common_height": "text",
            "byzantine_validators": [
              {
                "address": "Ynl0ZXM=",
                "pub_key": {
                  "ed25519": "Ynl0ZXM=",
                  "secp256k1": "Ynl0ZXM=",
                  "sr25519": "Ynl0ZXM="
                },
                "voting_power": "text",
                "proposer_priority": "text"
              }
            ],
            "total_voting_power": "text",
            "timestamp": "2025-04-23T13:52:46.510Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "text",
      "round": 1,
      "block_id": {
        "hash": "Ynl0ZXM=",
        "part_set_header": {
          "total": 1,
          "hash": "Ynl0ZXM="
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "Ynl0ZXM=",
          "timestamp": "2025-04-23T13:52:46.510Z",
          "signature": "Ynl0ZXM="
        }
      ]
    }
  },
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

GetTx fetches a tx by hash.

get

Path parameters

hashanyRequired

hash is the tx hash to query, encoded as a hex string.

Responses

application/json

objectOptional

GetTxResponse is the response type for the Service.GetTx method.

application/json

get

HTTPcURLJavaScriptPython

GET /cosmos/tx/v1beta1/txs/{hash} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "tx": {
    "body": {
      "messages": [
        {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "memo": "text",
      "timeout_height": "text",
      "extension_options": [
        {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "non_critical_extension_options": [
        {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "@type": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_UNSPECIFIED"
            },
            "multi": "[Circular Reference]"
          },
          "sequence": "text"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "text",
            "amount": "text"
          }
        ],
        "gas_limit": "text",
        "payer": "text",
        "granter": "text"
      }
    },
    "signatures": [
      "Ynl0ZXM="
    ]
  },
  "tx_response": {
    "height": "text",
    "txhash": "text",
    "codespace": "text",
    "code": 1,
    "data": "text",
    "raw_log": "text",
    "logs": [
      {
        "msg_index": 1,
        "log": "text",
        "events": [
          {
            "type": "text",
            "attributes": [
              {
                "key": "text",
                "value": "text"
              }
            ]
          }
        ]
      }
    ],
    "info": "text",
    "gas_wanted": "text",
    "gas_used": "text",
    "tx": {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "timestamp": "text",
    "events": [
      {
        "type": "text",
        "attributes": [
          {
            "key": "text",
            "value": "text",
            "index": true
          }
        ]
      }
    ]
  }
}