KiiChain
  • Learn
    • What is KiiChain?
    • KiiChain
      • Vision of KiiChain
      • The Problems We Solve
      • Use Cases
      • Roadmap
      • Whitepaper
      • Business Model
    • Tokenomics
      • Intro Coin Details
      • Coin Unlocking Schedule
      • Utility
      • Evergreen Model
    • Getting Started
      • Get a Wallet
      • Download a Mobile Wallet
      • Set Up a Web Wallet
      • Connect Wallet to Explorer App
  • BUILD ON KIICHAIN
    • Developer Hub
    • Testnet Oro
    • Endpoints - Cosmos
      • EVM
        • VM
        • ERC20
        • FeeMarket
      • IBC
      • Kiichain
        • TokenFactory
      • Cosmwasm
      • Cosmos
        • Auth
        • Authz
        • Bank
        • Tendermint
        • Consensus
        • Distribution
        • Evidence
        • Feegrant
        • Gov
        • Slashing
        • Staking
        • Tx
        • Upgrade
    • Developer Tools
      • RWA Protocol
      • Rust SDK
      • JS/TS SDK
        • Kiijs-evm
        • Kiijs-proto
      • Deploy a smart contract
      • Deploy a dApp
      • Testnet faucet
    • Smart Contracts
    • Modules
      • TokenFactory
      • EVM
  • Validate the Network
    • Getting Started
      • What is a delegator?
      • What is a validator?
    • Run a Validator / Full Node
      • Getting started
      • Step-by-Step Guide
        • Becoming a Validator
        • Recovering Legacy Addresses
      • Maintaining a validator
      • Incentive
      • Technical requirements
      • Validator Security
    • Economics
      • Staking Requirements
      • Delegation / Staking
      • Rewards
      • Block Rewards Formula
      • APR
    • Delegator Information
      • Choosing a validator
      • Directives of delegators
      • Incentive to stake
      • Security considerations
      • Risks to consider
  • KII AMBASSADORS
    • What does it mean to be a KiiAmbassador?
    • Your Core Responsibilities
    • Participation Perks
    • Points System & Performance
    • How to lose the Role
    • Evaluation Process
  • KIIEX
    • Set Up KIIEX Account
      • Contact OTC Desk
    • Connect to KIIEX APIs
      • Introduction
        • New endpoints
        • Revised calls
        • Behavior Changes
        • Revised Calls 3.5.0
      • Background Information
        • Message Frame
        • Standard Response Objects and Common Error Codes
        • Modules
        • Users, Accounts, and Permissions
        • Products and Instruments
        • Quotes and Orders
        • Time– and Date-Stamp Formats
        • The Trading Day
      • Users
        • Activate2FA
        • AddUserAffiliateTag
        • Authenticate2FA
        • AuthenticateUser
        • CancelUserReport
        • GetAllUnredactedUserConfigsForUser
        • GetL2Snapshot
        • GetLevel1
        • GetUnredactedUserConfigByKey
        • GetUserAccountInfos
        • GetUserAccounts
        • GetUserAffiliateCount
        • GetUserAfilliateTag
        • GetUserConfig
        • GetUserDevices
        • GetUserReportTickets
        • GetUserReportWriterResultRecords
        • GetValidate2FARequiredEndpoints
        • LogOut
        • RegisterNewDevice
        • SubscribeAccountEvents
        • SubscribeBlockTrades
        • SuscribeLevel1
        • SubscribeLevel2
        • SubscribeTicker
        • SubscribeTrades
        • UnsuscribeBlockTrades
        • UnsubscribeLevel1
        • UnsubscribeLevel2
        • UnsubscribeTicket
        • UnsuscribeTrades
        • UpdateUserAffiliateTag
        • Validate2FA
      • Accounts
        • GetAccountInfo
        • GenerateTransactionActivityReport
        • GenerateTradeActivityReport
        • GenerateTreasuryActivityReport
        • GetAllAccountConfigs
        • GetAccountPositions
        • GetTreasuryProductsForAccount
        • ScheduleTradeActivityReport
      • Trades
        • GetAccountTrades
        • GetAccountTransactions
        • GetAllOpenTradeReports
        • GetOpenTradeReports
        • GetTickerHistory
        • GetTradesHistory
      • OMS Orders
        • CancelAllOrders
        • CancelOrder
        • CancelQuote
        • CancelReplaceOrder
        • CreateQuote
        • GetOMSFeeTiers
        • GetOpenOrders
        • GetOpenQuotes
        • GetOrderFee
        • GetOrderHistory
        • GetOrderHistoryByOrderId
        • GetOrdersHistory
        • GetOrderStatus
        • ModifyOrder
        • SendOrder
        • SubmitBlockTrade
        • UpdateQuote
      • Products
        • GetProduct
        • GetProducts
      • Instruments
        • GetInstrument
        • GetInstruments
      • Tickets
        • CreateDepositTicket
        • CancelWithdraw
        • CreateWithdrawTicket
        • Deposit withdraw template
        • GetAccountDepositTransactions
        • GetAccountWithdrawTransactions
        • GetAllDepositRequestInfoTemplates
        • GetDeposits
        • GetDepositInfo
        • GetDepositTicket
        • GetDepositRequestInfoTemplate
        • GetOMSWithdrawFees
        • GetStandardTemplateExample
        • GetTetherRPCWithdrawTemplateExample
        • GetWithdrawFee
        • GetWithdraws
        • GetWithdrawTemplate
        • GetWithdrawTemplateTypes
        • GetWithdrawTicket
        • GetWithdrawTickets
        • SubmitDepositTicketComment
        • SubmitWithdrawTicketComment
      • Misc
        • Ping
Powered by GitBook
LogoLogo
On this page
Export as PDF
  1. BUILD ON KIICHAIN
  2. Endpoints - Cosmos
  3. Cosmos

Tx

PreviousStakingNextUpgrade

Last updated 23 days ago

GetTxsEvent fetches txs by event.

get
Query parameters
eventsanyOptional

events is the list of transaction event type. Deprecated post v0.47.x: use query instead, which should contain a valid events query.

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
pageanyOptional

page is the page number to query, starts at 1. If not provided, will default to first page.

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.

queryanyOptional

query defines the transaction event query that is proxied to Tendermint's TxSearch RPC method. The query must be valid.

Since cosmos-sdk 0.50

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/tx/v1beta1/txs HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "text",
            "value": "Ynl0ZXM="
          }
        ],
        "memo": "text",
        "timeout_height": "text",
        "extension_options": [
          {
            "type_url": "text",
            "value": "Ynl0ZXM="
          }
        ],
        "non_critical_extension_options": [
          {
            "type_url": "text",
            "value": "Ynl0ZXM="
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "type_url": "text",
              "value": "Ynl0ZXM="
            },
            "mode_info": "[Circular Reference]",
            "sequence": "text"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "gas_limit": "text",
          "payer": "text",
          "granter": "text"
        },
        "tip": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "tipper": "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_url": "text",
        "value": "Ynl0ZXM="
      },
      "timestamp": "text",
      "events": [
        {
          "type": "text",
          "attributes": [
            {
              "key": "text",
              "value": "text",
              "index": true
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  },
  "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
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/tx/v1beta1/txs/{hash} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "memo": "text",
      "timeout_height": "text",
      "extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "text",
            "value": "Ynl0ZXM="
          },
          "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"
      },
      "tip": {
        "amount": [
          {
            "denom": "text",
            "amount": "text"
          }
        ],
        "tipper": "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_url": "text",
      "value": "Ynl0ZXM="
    },
    "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
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/tx/v1beta1/txs/block/{height} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "text",
            "value": "Ynl0ZXM="
          }
        ],
        "memo": "text",
        "timeout_height": "text",
        "extension_options": [
          {
            "type_url": "text",
            "value": "Ynl0ZXM="
          }
        ],
        "non_critical_extension_options": [
          {
            "type_url": "text",
            "value": "Ynl0ZXM="
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "type_url": "text",
              "value": "Ynl0ZXM="
            },
            "mode_info": "[Circular Reference]",
            "sequence": "text"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "gas_limit": "text",
          "payer": "text",
          "granter": "text"
        },
        "tip": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "tipper": "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-05-17T09:46:16.570Z",
      "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-05-17T09:46:16.570Z",
              "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-05-17T09:46:16.570Z",
              "validator_address": "Ynl0ZXM=",
              "validator_index": 1,
              "signature": "Ynl0ZXM=",
              "extension": "Ynl0ZXM=",
              "extension_signature": "Ynl0ZXM="
            },
            "total_voting_power": "text",
            "validator_power": "text",
            "timestamp": "2025-05-17T09:46:16.570Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "text",
                    "app": "text"
                  },
                  "chain_id": "text",
                  "height": "text",
                  "time": "2025-05-17T09:46:16.570Z",
                  "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-05-17T09:46:16.570Z",
                      "signature": "Ynl0ZXM="
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "Ynl0ZXM=",
                    "pub_key": {
                      "ed25519": "Ynl0ZXM=",
                      "secp256k1": "Ynl0ZXM="
                    },
                    "voting_power": "text",
                    "proposer_priority": "text"
                  }
                ],
                "proposer": {
                  "address": "Ynl0ZXM=",
                  "pub_key": {
                    "ed25519": "Ynl0ZXM=",
                    "secp256k1": "Ynl0ZXM="
                  },
                  "voting_power": "text",
                  "proposer_priority": "text"
                },
                "total_voting_power": "text"
              }
            },
            "common_height": "text",
            "byzantine_validators": [
              {
                "address": "Ynl0ZXM=",
                "pub_key": {
                  "ed25519": "Ynl0ZXM=",
                  "secp256k1": "Ynl0ZXM="
                },
                "voting_power": "text",
                "proposer_priority": "text"
              }
            ],
            "total_voting_power": "text",
            "timestamp": "2025-05-17T09:46:16.570Z"
          }
        }
      ]
    },
    "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-05-17T09:46:16.570Z",
          "signature": "Ynl0ZXM="
        }
      ]
    }
  },
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}
  • POSTTxDecode decodes the transaction.
  • POSTTxEncode encodes the transaction.
  • POSTTxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.
  • POSTTxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.
  • GETGetTxsEvent fetches txs by event.
  • GETGetTx fetches a tx by hash.
  • POSTBroadcastTx broadcast transaction.
  • GETGetBlockWithTxs fetches a block with decoded txs.
  • POSTSimulate simulates executing a transaction for estimating gas usage.

TxDecode decodes the transaction.

post

Since: cosmos-sdk 0.47

Body

TxDecodeRequest is the request type for the Service.TxDecode RPC method.

Since: cosmos-sdk 0.47

tx_bytesstring · byteOptional

tx_bytes is the raw transaction.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
post
POST /cosmos/tx/v1beta1/decode HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "tx_bytes": "Ynl0ZXM="
}
{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "memo": "text",
      "timeout_height": "text",
      "extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "text",
            "value": "Ynl0ZXM="
          },
          "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"
      },
      "tip": {
        "amount": [
          {
            "denom": "text",
            "amount": "text"
          }
        ],
        "tipper": "text"
      }
    },
    "signatures": [
      "Ynl0ZXM="
    ]
  }
}

TxEncode encodes the transaction.

post

Since: cosmos-sdk 0.47

Body

TxEncodeRequest is the request type for the Service.TxEncode RPC method.

Since: cosmos-sdk 0.47

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
post
POST /cosmos/tx/v1beta1/encode HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Content-Type: application/json
Accept: */*
Content-Length: 629

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "memo": "text",
      "timeout_height": "text",
      "extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "text",
            "value": "Ynl0ZXM="
          },
          "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"
      },
      "tip": {
        "amount": [
          {
            "denom": "text",
            "amount": "text"
          }
        ],
        "tipper": "text"
      }
    },
    "signatures": [
      "Ynl0ZXM="
    ]
  }
}
{
  "tx_bytes": "Ynl0ZXM="
}

TxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.

post

Since: cosmos-sdk 0.47

Body

TxDecodeAminoRequest is the request type for the Service.TxDecodeAmino RPC method.

Since: cosmos-sdk 0.47

amino_binarystring · byteOptional
Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
post
POST /cosmos/tx/v1beta1/decode/amino HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "amino_binary": "Ynl0ZXM="
}
{
  "amino_json": "text"
}

TxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.

post

Since: cosmos-sdk 0.47

Body

TxEncodeAminoRequest is the request type for the Service.TxEncodeAmino RPC method.

Since: cosmos-sdk 0.47

amino_jsonstringOptional
Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
post
POST /cosmos/tx/v1beta1/encode/amino HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "amino_json": "text"
}
{
  "amino_binary": "Ynl0ZXM="
}

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: DEPRECATED: use BROADCAST_MODE_SYNC instead, BROADCAST_MODE_BLOCK is not supported by the SDK from v0.47.x onwards.
  • 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_UNSPECIFIEDPossible values:
Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
post
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_url": "text",
      "value": "Ynl0ZXM="
    },
    "timestamp": "text",
    "events": [
      {
        "type": "text",
        "attributes": [
          {
            "key": "text",
            "value": "text",
            "index": true
          }
        ]
      }
    ]
  }
}

Simulate simulates executing a transaction for estimating gas usage.

post
Body

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

tx_bytesstring · byteOptional

tx_bytes is the raw transaction.

Since: cosmos-sdk 0.43

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
post
POST /cosmos/tx/v1beta1/simulate HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Content-Type: application/json
Accept: */*
Content-Length: 651

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "memo": "text",
      "timeout_height": "text",
      "extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "text",
            "value": "Ynl0ZXM="
          },
          "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"
      },
      "tip": {
        "amount": [
          {
            "denom": "text",
            "amount": "text"
          }
        ],
        "tipper": "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
          }
        ]
      }
    ],
    "msg_responses": [
      {
        "type_url": "text",
        "value": "Ynl0ZXM="
      }
    ]
  }
}