For AI agents: an LLM-friendly Markdown version of every page is available by appending .md to its URL or by sending an Accept: text/markdown request header. The full documentation index is at https://www.ankr.com/docs/llms.txt
Skip to main content

Kava — Cosmos REST methods (3/4)

API reference for Kava. All methods ->

Part 3 of 4: 1 · 2 · 3 · 4

Ibc core methods​

/ibc/core/channel/v1beta1/channels​

Retrieves all the IBC channels of a chain.

Parameters​

  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

IBC channels of a chain.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels

Response example​

{
  "channels": [
    {
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "ordering": "ORDER_NONE_UNSPECIFIED",
      "counterparty": {
        "port_id": "string",
        "channel_id": "string"
      },
      "connection_hops": [
        "string"
      ],
      "version": "string",
      "port_id": "string",
      "channel_id": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}​

Retrieves an IBC Channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.

Returns​

IBC channels of a chain.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}

Response example​

{
  "channel": {
    "state": "STATE_UNINITIALIZED_UNSPECIFIED",
    "ordering": "ORDER_NONE_UNSPECIFIED",
    "counterparty": {
      "port_id": "string",
      "channel_id": "string"
    },
    "connection_hops": [
      "string"
    ],
    "version": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state​

Retrieves the client state for the channel associated with the provided channel identifiers.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.

Returns​

Client state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state

Response example​

{
  "identified_client_state": {
    "client_id": "string",
    "client_state": {
      "type_url": "string",
      "value": "string"
    }
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}​

Retrieves the consensus state for the channel associated with the provided channel identifiers.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • revision_number (string, uint64; required): a revision number of the consensus state.
  • revision_height string, uint64; required: a revision height of the consensus state.

Returns​

Consensus state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Response example​

{
  "consensus_state": {
    "type_url": "string",
    "value": "string"
  },
  "client_id": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence​

Retrieves the next receive sequence for a given channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.

Returns​

Next receive sequence.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence

Response example​

{
  "next_sequence_receive": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements​

Retrieves all the packet acknowledgements associated with a channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Packet acknowledgements.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements

Response example​

{
  "acknowledgements": [
    {
      "port_id": "string",
      "channel_id": "string",
      "sequence": "string",
      "data": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}​

Retrieves a stored packet acknowledgement hash.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • sequence (string, uint64): a packet sequence.

Returns​

Packet acknowledgements.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}

Response example​

{
  "acknowledgement": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments​

Retrieves all the packet commitments hashes associated with a channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Packet commitments.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments

Response example​

{
  "commitments": [
    {
      "port_id": "string",
      "channel_id": "string",
      "sequence": "string",
      "data": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks​

Retrieves all the unreceived IBC acknowledgements associated with a channel and sequences.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_ack_sequence (array[string]): a required list of acknowledgement sequences.

Returns​

Unreceived IBC acknowledgements.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks

Response example​

{
  "sequences": [
    "string"
  ],
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets​

Retrieves all the unreceived IBC packets associated with a channel and sequences.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_commitment_sequences (array[string]): a list of packet sequences.

Returns​

Unreceived IBC packets.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets

Response example​

{
  "sequences": [
    "string"
  ],
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}​

Retrieves a stored packet commitment hash.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_commitment_sequences (array[string]): a list of packet sequences.

Returns​

Packet commitment hash.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}

Response example​

{
  "commitment": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}​

Checks whether a given packet sequence has been received on the queried chain.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • sequence (string, uint64): a required packet sequence.

Returns​

Whether the given packet has been received or not.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}

Response example​

{
  "received": true,
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/connections/{connection}/channels​

Retrieves all the channels associated with a connection end.

Parameters​

  • connection (string, required): a connection unique identifier.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key string($uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Channels associated with a connection.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/connections/{connection}/channels

Response example​

{
  "channels": [
    {
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "ordering": "ORDER_NONE_UNSPECIFIED",
      "counterparty": {
        "port_id": "string",
        "channel_id": "string"
      },
      "connection_hops": [
        "string"
      ],
      "version": "string",
      "port_id": "string",
      "channel_id": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/client/v1beta1/params​

Retrieves all parameters of the IBC client.

Parameters​

None.

Returns​

Params of the IBC client.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/client/v1beta1/params

Response example​

{
  "params": {
    "allowed_clients": [
      "string"
    ]
  }
}

/ibc/core/client/v1beta1/client_states​

Retrieves all the IBC light clients of a chain.

Parameters​

  • pagination.key (string; byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string; uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string; uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

IBC light clients.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/client_states

Response example​

{
  "client_states": [
    {
      "client_id": "string",
      "client_state": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/ibc/core/client/v1beta1/client_states/{client_id}​

Retrieves an IBC light client.

Parameters​

  • client_id (string; required): a client state unique identifier.

Returns​

IBC light client from client_id.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/client_states/{client_id}

Response example​

{
  "client_state": {
    "type_url": "string",
    "value": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/client/v1beta1/consensus_states/{client_id}​

Retrieves all the consensus state associated with a given client.

Parameters​

  • client_id (string; required): a client unique identifier.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Consensus state associated with given client

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/consensus_states/{client_id}

Response example​

{
  "consensus_states": [
    {
      "height": {
        "revision_number": "string",
        "revision_height": "string"
      },
      "consensus_state": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}​

Retrieves a consensus state associated with a client state at a given height.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • revision_number (string, uint64): a required consensus state revision number.
  • revision_height(string, uint64): a required consensus state revision height.
  • latest_height (boolean): overrides the height field and queries the latest stored consensus state.

Returns​

Consensus state associated with a client state at a given height.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}

Response example​

{
  "consensus_state": {
    "type_url": "string",
    "value": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/client_connections/{client_id}​

Retrieves the connection paths associated with a client state.

Parameters​

  • client_id (string, required): a client identifier associated with a connection.

Returns​

Connections paths associated with a client state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/client_connections/{client_id}

Response example​

{
  "connection_paths": [
    "string"
  ],
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/connections​

Retrieves all the IBC connections of a chain.

Parameters​

  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

IBC connections.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections

Response example​

{
  "connections": [
    {
      "id": "string",
      "client_id": "string",
      "versions": [
        {
          "identifier": "string",
          "features": [
            "string"
          ]
        }
      ],
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "counterparty": {
        "client_id": "string",
        "connection_id": "string",
        "prefix": {
          "key_prefix": "string"
        }
      },
      "delay_period": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/connections/{connection_id}​

Retrieves an IBC connection end.

Parameters​

  • connection_id (string; required): a connection unique identifier.

Returns​

IBC connections end.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}

Response example​

{
  "connection": {
    "client_id": "string",
    "versions": [
      {
        "identifier": "string",
        "features": [
          "string"
        ]
      }
    ],
    "state": "STATE_UNINITIALIZED_UNSPECIFIED",
    "counterparty": {
      "client_id": "string",
      "connection_id": "string",
      "prefix": {
        "key_prefix": "string"
      }
    },
    "delay_period": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/connections/{connection_id}/client_state​

Retrieves the client state associated with the connection.

Parameters​

  • connection_id (string; required): a connection unique identifier.

Returns​

Client state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}/client_state

Response example​

{
  "identified_client_state": {
    "client_id": "string",
    "client_state": {
      "type_url": "string",
      "value": "string"
    }
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}