Основные эндпоинты API

В этом документе представлены некоторые основные эндпоинты API, которые могут быть полезны, когда вы конфигурируете свою ноду или валидатора.

Все примеры ниже подразумевают наличие запущенной ноды или валидатора. Тем не менее, существует возможность отправлять запросы к удаленной ноде:

• Для выполнения команд из командной строки, необходимо использовать флаг --node

• Для удаленного вызова REST, вы можете заменить localhost на IP адрес удаленной ноды

Получение статуса ноды

CLI (командная строка)

> seid status | jq -r ".NodeInfo"
{
  "protocol_version": {
    "p2p": "8",
    "block": "11",
    "app": "0"
  },
  "id": "c3beb6d42f10311fd453029cb3ee6ac08880d522",
  "listen_addr": "tcp://0.0.0.0:26656",
  "network": "sei-testnet-1",
  "version": "0.34.15",
  "channels": "40202122233038606100",
  "moniker": "phils validator",
  "other": {
    "tx_index": "on",
    "rpc_address": "tcp://127.0.0.1:26657"
  }

REST

> curl localhost:1317/cosmos/base/tendermint/v1beta1/node_info  | jq -r ".default_node_info"
{
  "protocol_version": {
    "p2p": "8",
    "block": "11",
    "app": "0"
  },
  "default_node_id": "c3beb6d42f10311fd453029cb3ee6ac08880d522",
  "listen_addr": "tcp://0.0.0.0:26656",
  "network": "sei-testnet-1",
  "version": "0.34.15",
  "channels": "QCAhIiMwOGBhAA==",
  "moniker": "phils validator",
  "other": {
    "tx_index": "on",
    "rpc_address": "tcp://127.0.0.1:26657"
  }
}

Получение id ноды

CLI

> seid tendermint show-node-id
89e8fdd427a056fb7b4f5da2d58a4b688feb4b74

REST

> curl localhost:1317/cosmos/base/tendermint/v1beta1/node_info | jq -r ".default_node_info.default_node_id
89e8fdd427a056fb7b4f5da2d58a4b688feb4b74

Получение статуса синхронизации

CLI

> seid status | jq -r ".SyncInfo.catching_up"
false

REST

> curl localhost:1317/cosmos/base/tendermint/v1beta1/syncing
{
  "syncing": false
}

Получение последнего блока

CLI

> seid query block | jq
{
  "block_id": {
    "hash": "92B93642DCCECFBDFEAE972C67294CF1B3574FAF55F3B24E218990CC4EE28B0A",
    "parts": {
      "total": 1,
      "hash": "5FBD2E43F3A3F6DBD9C9E2021B1505DF3AC74841F7207F479E701FF0726E0EF3"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "11"
      },
...

REST

> curl localhost:1317/cosmos/base/tendermint/v1beta1/blocks/latest
{
  "block_id": {
    "hash": "krk2QtzOz73+rpcsZylM8bNXT69V87JOIYmQzE7iiwo=",
    "part_set_header": {
      "total": 1,
      "hash": "X70uQ/Oj9tvZyeICGxUF3zrHSEH3IH9HnnAf8HJuDvM="
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "11",
...

Запрос банкковского баланса

CLI

> seid query bank balances $ACCOUNT_ADDRESS
balances:
- amount: "29999999999995999900"
  denom: ust
pagination:
  next_key: null
  total: "0"

REST

> curl localhost:1317/bank/balances/$ACCOUNT_ADDRESS
{"height":"4028","result":[
  {
    "denom": "ust",
    "amount": "29999999999995999900"
  }
]}

Получение информации о валидаторах

CLI

> seid query tendermint-validator-set
block_height: "3472"
total: "2"
validators:
- address: cosmosvalcons1xrn3ejn56chrv26mfk9vaztef63zptkmygmdxf
  proposer_priority: "39374999999767"
  pub_key:
    type: tendermint/PubKeyEd25519
    value: Cf46GgHIjqEdk5ZeHux/PTWEmWUWnxTFeyJxIzwoxSA=
  voting_power: "70000000000000"

REST

> curl localhost:1317/cosmos/base/tendermint/v1beta1/validatorsets/latest
{
  "block_height": "4156",
  "validators": [
    {
      "address": "cosmosvalcons1xrn3ejn56chrv26mfk9vaztef63zptkmygmdxf",
      "pub_key": {
        "@type": "/cosmos.crypto.ed25519.PubKey",
        "key": "Cf46GgHIjqEdk5ZeHux/PTWEmWUWnxTFeyJxIzwoxSA="
      },
      "voting_power": "70000000000000",
      "proposer_priority": "42656249998811"
    },