# gonka RPC — Complete Endpoint Reference > Full list of all API endpoints available at https://rpc.gonka.gg > Authentication required: send X-Api-Key header or Authorization: Bearer token Total endpoints: 354 --- ## CometBFT RPC (27 endpoints) Proxied from the CometBFT node via /chain-rpc/ (also available at root /). Historical data cached 24 h; live state refreshes 1–3 s. ### GET /chain-rpc/status Node status — moniker, network, sync info, latest block Cache: 1 s ### GET /chain-rpc/block Block header + data at height Parameters: height Cache: 24 h if height set ### GET /chain-rpc/block_results ABCI results (events, gas) for a block Parameters: height Cache: 24 h if height set ### GET /chain-rpc/commit Block commit (signatures) at height Parameters: height Cache: 24 h if height set ### GET /chain-rpc/blockchain Range of block headers Parameters: minHeight, maxHeight Cache: 1 s ### GET /chain-rpc/tx Transaction by hash (with optional proof) Parameters: hash (0x-prefixed), prove Cache: 24 h ### GET /chain-rpc/tx_search Search transactions by events Parameters: query, page, per_page, order_by Cache: custom ### GET /chain-rpc/validators Validator set at height Parameters: height, page, per_page Cache: custom ### GET /chain-rpc/net_info P2P network info — connected peers Cache: 10 s ### GET /chain-rpc/consensus_state Current consensus round/step Cache: 2 s ### GET /chain-rpc/dump_consensus_state Detailed consensus state dump Cache: 2 s ### GET /chain-rpc/genesis Genesis document Cache: 1 h ### GET /chain-rpc/abci_info ABCI application info Cache: 5 s ### GET /chain-rpc/abci_query Direct ABCI query to the app Parameters: path, data, height Cache: 3 s ### POST /chain-rpc/broadcast_tx_sync Broadcast tx — waits for CheckTx Parameters: JSON-RPC body ### POST /chain-rpc/broadcast_tx_async Broadcast tx — fire and forget Parameters: JSON-RPC body ### POST /chain-rpc/broadcast_tx_commit Broadcast tx — waits for block inclusion Parameters: JSON-RPC body ### GET /chain-rpc/unconfirmed_txs List unconfirmed txs in mempool Parameters: limit ### GET /chain-rpc/num_unconfirmed_txs Count of unconfirmed txs ### GET /chain-rpc/block_by_hash Block by hash Parameters: hash Cache: 24 h ### GET /chain-rpc/header Block header at height Parameters: height Cache: 24 h if height set ### GET /chain-rpc/header_by_hash Block header by hash Parameters: hash Cache: 24 h ### GET /chain-rpc/consensus_params Consensus parameters at height Parameters: height Cache: 5 s ### GET /chain-rpc/health Node health check Cache: 1 s ### POST /chain-rpc/check_tx Check transaction validity without broadcasting Parameters: JSON-RPC body ### POST /chain-rpc/subscribe Subscribe to events (WebSocket) Parameters: query ### POST /chain-rpc/unsubscribe Unsubscribe from events Parameters: query --- ## Cosmos REST (LCD) (112 endpoints) Full Cosmos SDK REST under /chain-api/. Cached per-module: bank 3 s, staking 15 s, gov 30 s, others 5–10 s. Also available without prefix (/cosmos/*, /ibc/*). ### GET /chain-api/cosmos/bank/v1beta1/balances/{addr} Account balances for an address ### GET /chain-api/cosmos/bank/v1beta1/supply Total supply of all denoms ### GET /chain-api/cosmos/bank/v1beta1/denoms_metadata Metadata for all denoms ### GET /chain-api/cosmos/staking/v1beta1/validators All validators ### GET /chain-api/cosmos/staking/v1beta1/delegations/{addr} Delegations for a delegator ### GET /chain-api/cosmos/distribution/v1beta1/delegators/{addr}/rewards Delegation rewards for an address ### GET /chain-api/cosmos/gov/v1/proposals All governance proposals ### GET /chain-api/cosmos/gov/v1/proposals/{id}/votes Votes on a proposal ### GET /chain-api/cosmos/auth/v1beta1/accounts/{addr} Account info (sequence, pub key) ### GET /chain-api/cosmos/authz/v1beta1/grants Authorization grants Parameters: granter, grantee ### GET /chain-api/cosmos/feegrant/v1beta1/allowances/{grantee} Fee grant allowances ### GET /chain-api/cosmos/slashing/v1beta1/signing_infos Validator signing info, slashing params ### GET /chain-api/cosmos/mint/v1beta1/inflation Current inflation rate ### GET /chain-api/cosmos/upgrade/v1beta1/current_plan Pending upgrade plan ### POST /chain-api/cosmos/tx/v1beta1/txs Broadcast / query transactions Parameters: tx_bytes, mode ### GET /chain-api/cosmos/tx/v1beta1/txs/{hash} Transaction by hash ### GET /chain-api/ibc/core/channel/v1/channels IBC channels ### GET /chain-api/ibc/core/connection/v1/connections IBC connections ### GET /chain-api/cosmwasm/wasm/v1/contract/{addr} CosmWasm contract info ### GET /chain-api/cosmwasm/wasm/v1/contract/{addr}/state CosmWasm contract state ### GET /chain-api/cosmwasm/wasm/v1/contract/{addr}/smart/{query} CosmWasm smart query ### GET /chain-api/cosmwasm/wasm/v1/contract/{addr}/raw/{key} CosmWasm raw state by key ### GET /chain-api/cosmwasm/wasm/v1/code All stored Wasm codes ### GET /chain-api/cosmwasm/wasm/v1/code/{code_id} Wasm code info by ID ### GET /chain-api/cosmos/evidence/v1beta1/evidence All evidence of misbehavior ### GET /chain-api/cosmos/evidence/v1beta1/evidence/{hash} Evidence by hash ### GET /chain-api/cosmos/group/v1/groups All groups ### GET /chain-api/cosmos/group/v1/group_members/{group_id} Group members ### GET /chain-api/cosmos/group/v1/group_policies/{group_id} Group policies ### GET /chain-api/cosmos/group/v1/proposals/{proposal_id} Group proposal by ID ### GET /chain-api/cosmos/nft/v1beta1/classes All NFT classes ### GET /chain-api/cosmos/nft/v1beta1/nfts All NFTs (filterable by class) ### GET /chain-api/cosmos/nft/v1beta1/balance/{owner}/{class_id} NFT balance by owner and class ### GET /chain-api/cosmos/circuit/v1/accounts Circuit breaker accounts ### GET /chain-api/cosmos/circuit/v1/disabled_list Disabled message types ### GET /chain-api/cosmos/consensus/v1/params Consensus parameters ### GET /chain-api/cosmos/params/v1beta1/params Module parameters by subspace Parameters: subspace, key ### GET /chain-api/cosmos/staking/v1beta1/validators/{addr}/delegations Delegations to a validator ### GET /chain-api/cosmos/staking/v1beta1/validators/{addr}/unbonding_delegations Unbonding delegations from validator ### GET /chain-api/cosmos/staking/v1beta1/pool Staking pool (bonded/unbonded totals) ### GET /chain-api/cosmos/staking/v1beta1/params Staking module parameters ### GET /chain-api/cosmos/distribution/v1beta1/params Distribution module parameters ### GET /chain-api/cosmos/distribution/v1beta1/community_pool Community pool balance ### GET /chain-api/cosmos/distribution/v1beta1/validators/{addr}/commission Validator commission ### GET /chain-api/cosmos/gov/v1/params/{params_type} Gov module parameters ### GET /chain-api/cosmos/gov/v1/proposals/{id} Proposal by ID ### GET /chain-api/cosmos/gov/v1/proposals/{id}/deposits Deposits on a proposal ### GET /chain-api/cosmos/gov/v1/proposals/{id}/tally Tally result for a proposal ### GET /chain-api/cosmos/slashing/v1beta1/params Slashing module parameters ### GET /chain-api/cosmos/mint/v1beta1/params Mint module parameters ### GET /chain-api/cosmos/mint/v1beta1/annual_provisions Current annual provisions ### GET /chain-api/cosmos/bank/v1beta1/params Bank module parameters ### GET /chain-api/cosmos/bank/v1beta1/balances/{addr}/{denom} Single denom balance for address ### GET /chain-api/cosmos/bank/v1beta1/spendable_balances/{addr} Spendable balances for address ### GET /chain-api/cosmos/bank/v1beta1/supply/{denom} Supply of a single denom ### GET /chain-api/cosmos/auth/v1beta1/params Auth module parameters ### GET /chain-api/cosmos/upgrade/v1beta1/applied_plan/{name} Applied upgrade plan by name ### GET /chain-api/cosmos/upgrade/v1beta1/module_versions Module consensus versions ### GET /chain-api/ibc/core/client/v1/client_states All IBC client states ### GET /chain-api/ibc/core/client/v1/client_states/{client_id} IBC client state by ID ### GET /chain-api/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id} IBC channel by ID and port ### GET /chain-api/ibc/apps/transfer/v1/denom_traces IBC denom traces ### GET /chain-api/ibc/apps/transfer/v1/params IBC transfer parameters ### GET /chain-api/ibc/apps/transfer/v1/denom_hashes/{trace} IBC denom hash for a trace ### GET /chain-api/ibc/core/connection/v1/connections/{connection_id} IBC connection by ID ### GET /chain-api/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments IBC packet commitments ### GET /chain-api/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_acks IBC packet acknowledgements ### GET /chain-api/ibc/core/client/v1/consensus_states/{client_id} IBC client consensus states ### GET /chain-api/cosmos/staking/v1beta1/validators/{addr} Single validator by operator address ### GET /chain-api/cosmos/staking/v1beta1/delegators/{addr}/validators Validators for a delegator ### GET /chain-api/cosmos/staking/v1beta1/delegators/{addr}/unbonding_delegations Unbonding delegations for delegator ### GET /chain-api/cosmos/staking/v1beta1/delegators/{addr}/redelegations Redelegations for delegator ### GET /chain-api/cosmos/staking/v1beta1/historical_info/{height} Historical staking info at height ### GET /chain-api/cosmos/distribution/v1beta1/validators/{addr}/outstanding_rewards Validator outstanding rewards ### GET /chain-api/cosmos/distribution/v1beta1/validators/{addr}/slashes Validator slashing events ### GET /chain-api/cosmos/distribution/v1beta1/delegators/{addr}/withdraw_address Delegator withdraw address ### GET /chain-api/cosmos/authz/v1beta1/grants/granter/{granter} Grants by granter ### GET /chain-api/cosmos/authz/v1beta1/grants/grantee/{grantee} Grants by grantee ### GET /chain-api/cosmos/feegrant/v1beta1/issued/{granter} Fee grants issued by granter ### GET /chain-api/cosmos/slashing/v1beta1/signing_infos/{cons_address} Signing info for a validator ### GET /chain-api/cosmos/tx/v1beta1/txs Search transactions by events Parameters: events, pagination, order_by ### GET /chain-api/cosmos/base/tendermint/v1beta1/blocks/latest Latest block (Cosmos base) ### GET /chain-api/cosmos/base/tendermint/v1beta1/blocks/{height} Block at height (Cosmos base) ### GET /chain-api/cosmos/base/tendermint/v1beta1/node_info Node info (Cosmos base) ### GET /chain-api/cosmos/base/tendermint/v1beta1/syncing Sync status (Cosmos base) ### GET /chain-api/cosmos/base/tendermint/v1beta1/validatorsets/latest Latest validator set (Cosmos base) ### GET /chain-api/cosmos/base/tendermint/v1beta1/validatorsets/{height} Validator set at height (Cosmos base) ### POST /chain-api/cosmos/tx/v1beta1/simulate Simulate transaction execution ### GET /chain-api/cosmos/auth/v1beta1/accounts All accounts (paginated) ### GET /chain-api/cosmos/auth/v1beta1/address_by_id/{id} Account address by account ID ### GET /chain-api/cosmos/bank/v1beta1/send_enabled Send-enabled denoms ### GET /chain-api/cosmos/gov/v1beta1/proposals All proposals (v1beta1 legacy) ### GET /chain-api/cosmos/gov/v1beta1/proposals/{id} Proposal by ID (v1beta1 legacy) ### GET /chain-api/cosmos/group/v1/group_info/{group_id} Group info by ID ### GET /chain-api/cosmos/group/v1/groups_by_admin/{admin} Groups by admin address ### GET /chain-api/cosmos/group/v1/groups_by_member/{address} Groups by member address ### GET /chain-api/cosmos/group/v1/group_policy_info/{address} Group policy info by address ### GET /chain-api/cosmos/group/v1/proposals_by_group_policy/{address} Proposals by group policy ### GET /chain-api/cosmos/nft/v1beta1/owner/{class_id}/{id} NFT owner ### GET /chain-api/cosmos/nft/v1beta1/supply/{class_id} NFT supply by class ### GET /chain-api/cosmos/nft/v1beta1/nfts/{class_id}/{id} Single NFT by class and ID ### POST /chain-api/cosmos/tx/v1beta1/encode Encode a transaction to bytes ### POST /chain-api/cosmos/tx/v1beta1/decode Decode transaction bytes ### POST /chain-api/cosmos/tx/v1beta1/encode/amino Encode transaction (Amino) ### POST /chain-api/cosmos/tx/v1beta1/decode/amino Decode transaction (Amino) ### GET /chain-api/cosmos/base/tendermint/v1beta1/abci_query ABCI query via Cosmos base endpoint Parameters: path, data, height ### GET /chain-api/cosmos/auth/v1beta1/module_accounts All module accounts ### GET /chain-api/cosmos/auth/v1beta1/module_accounts/{name} Module account by name ### GET /chain-api/cosmos/bank/v1beta1/denoms_metadata/{denom} Metadata for a single denom ### GET /chain-api/cosmwasm/wasm/v1/codes/pinned Pinned Wasm codes ### GET /chain-api/cosmwasm/wasm/v1/code/{code_id}/contracts Contracts instantiated from code ### GET /chain-api/swagger/ Swagger UI — interactive API documentation --- ## Gonka chain modules (REST) (98 endpoints) On-chain state from Gonka custom modules under /chain-api/productscience/inference/. These are auto-generated gRPC-gateway endpoints. Standard Cosmos pagination params apply (pagination.key, pagination.limit). ### GET /chain-api/productscience/inference/inference/params Inference module parameters ### GET /chain-api/productscience/inference/inference/inference/{index} Single inference by index ### GET /chain-api/productscience/inference/inference/inference All inferences (paginated) ### GET /chain-api/productscience/inference/inference/participant/{index} Participant by index ### GET /chain-api/productscience/inference/inference/participant All participants ### GET /chain-api/productscience/inference/inference/inference_participant/{address} Participant by address ### GET /chain-api/productscience/inference/inference/participants_with_balances Participants with token balances ### GET /chain-api/productscience/inference/inference/participants_stats Full participant stats ### GET /chain-api/productscience/inference/inference/participants/count Participant count ### GET /chain-api/productscience/inference/inference/get_participant_current_stats/{id} Current stats for participant ### GET /chain-api/productscience/inference/inference/get_all_participant_current_stats All participants current stats ### GET /chain-api/productscience/inference/inference/get_current_epoch Current epoch number and data ### GET /chain-api/productscience/inference/inference/epoch_info Epoch info (start block, duration) ### GET /chain-api/productscience/inference/inference/epoch_group_data/{epoch_index} Epoch group data ### GET /chain-api/productscience/inference/inference/current_epoch_group_data Current epoch group data ### GET /chain-api/productscience/inference/inference/epoch_performance_summary/{epoch_index} Performance summary for epoch ### GET /chain-api/productscience/inference/inference/epoch_performance_summary/{epoch_index}/{participantId} Performance for specific participant in epoch ### GET /chain-api/productscience/inference/inference/epoch_group_validations/{participant}/{epoch_index} Epoch group validations ### GET /chain-api/productscience/inference/inference/excluded_participants/{epoch_index} Excluded participants for epoch ### GET /chain-api/productscience/inference/inference/tokenomics_data Current tokenomics ### GET /chain-api/productscience/inference/inference/get_unit_of_compute_price_proposal Current UoC price proposal ### GET /chain-api/productscience/inference/inference/models_all All registered AI models ### GET /chain-api/productscience/inference/inference/model_per_token_price/{model_id} Per-token price for a model ### GET /chain-api/productscience/inference/inference/all_model_per_token_prices All model per-token prices ### GET /chain-api/productscience/inference/inference/model_capacity/{model_id} Capacity for a model ### GET /chain-api/productscience/inference/inference/all_model_capacities All model capacities ### GET /chain-api/productscience/inference/inference/models_stats_by_time Model stats by time period ### GET /chain-api/productscience/inference/inference/top_miner/{address} Top miner by address ### GET /chain-api/productscience/inference/inference/top_miner All top miners ### GET /chain-api/productscience/inference/inference/poc_batches_for_stage/{block_height} PoC batches at stage ### GET /chain-api/productscience/inference/inference/poc_validations_for_stage/{block_height} PoC validations at stage ### GET /chain-api/productscience/inference/inference/poc_v2_validations_for_stage/{block_height} PoC v2 validations at stage ### GET /chain-api/productscience/inference/inference/poc_v2_store_commit/{height}/{address} PoC v2 off-chain state commit ### GET /chain-api/productscience/inference/inference/all_poc_v2_store_commits/{height} All PoC v2 commits for stage ### GET /chain-api/productscience/inference/inference/poc_validation_snapshot/{height} PoC validation snapshot ### GET /chain-api/productscience/inference/inference/count_po_c_batches_at_height/{height} Count PoC batches at height ### GET /chain-api/productscience/inference/inference/count_po_c_validations_at_height/{height} Count PoC validations at height ### GET /chain-api/productscience/inference/inference/active_confirmation_poc_event Active confirmation PoC event ### GET /chain-api/productscience/inference/inference/confirmation_poc_events/{epoch_index} Confirmation PoC events for epoch ### GET /chain-api/productscience/inference/inference/mlnode_weight_distribution/{height}/{address} ML node weight distribution ### GET /chain-api/productscience/inference/inference/all_mlnode_weight_distributions/{height} All ML node weight distributions for stage ### GET /chain-api/productscience/inference/inference/mlnode_version Required ML node version ### GET /chain-api/productscience/inference/inference/hardware_nodes/{participant} Hardware nodes for participant ### GET /chain-api/productscience/inference/inference/hardware_nodes_all All hardware nodes ### GET /chain-api/productscience/inference/inference/training_task Current training task ### GET /chain-api/productscience/inference/inference/training_task_all All training tasks ### GET /chain-api/productscience/inference/inference/queued_training_tasks Queued training tasks ### GET /chain-api/productscience/inference/inference/in_progress_training_tasks In-progress training tasks ### GET /chain-api/productscience/inference/inference/training_kv_record/{taskId}/{key} Training KV record ### GET /chain-api/productscience/inference/inference/list_training_kv_record_keys/{taskId} List training KV record keys ### GET /chain-api/productscience/inference/inference/training_barrier Training barrier state ### GET /chain-api/productscience/inference/inference/training_alive_nodes Alive nodes in training ### GET /chain-api/productscience/inference/inference/training_allow_list Training allow list ### GET /chain-api/productscience/inference/inference/inference_timeout/{expirationHeight}/{inferenceId} Inference timeout record ### GET /chain-api/productscience/inference/inference/inference_validation_details/{epochId}/{inferenceId} Inference validation details ### GET /chain-api/productscience/inference/inference/get_inference_validation_parameters/{ids}/{requester} Inference validation parameters ### GET /chain-api/productscience/inference/inference/get_minimum_validation_average Minimum validation average threshold ### GET /chain-api/productscience/inference/inference/settle_amount/{participant} Settle amount for participant ### GET /chain-api/productscience/inference/inference/developer/{developer}/stats_by_time Developer stats by time period ### GET /chain-api/productscience/inference/inference/developer/{developer}/stats_by_epochs_backwards Developer stats by epochs ### GET /chain-api/productscience/inference/inference/all_stats_by_time Global stats by time period ### GET /chain-api/productscience/inference/inference/bridge_transaction/{origin_chain}/{block_number}/{receipt_index} Bridge transaction ### GET /chain-api/productscience/inference/inference/bridge_transactions All bridge transactions ### GET /chain-api/productscience/inference/inference/bridge_addresses/{chain_id} Bridge addresses by chain ### GET /chain-api/productscience/inference/inference/liquidity_pool Liquidity pool state ### GET /chain-api/productscience/inference/inference/wrapped_token_balances/{address} Wrapped token balances ### GET /chain-api/productscience/inference/inference/approved_tokens_for_trade Approved tokens for trading ### GET /chain-api/productscience/inference/inference/validate_wrapped_token_for_trade/{denom} Validate wrapped token for trading ### GET /chain-api/productscience/inference/inference/validate_ibc_token_for_trade/{denom} Validate IBC token for trading ### GET /chain-api/productscience/inference/inference/participant_allow_list Participant allow list ### GET /chain-api/productscience/inference/inference/partial_upgrade/{height} Partial upgrade at height ### GET /chain-api/productscience/inference/inference/partial_upgrade All partial upgrades ### GET /chain-api/productscience/inference/inference/random_seeds/{epoch_index} Random seeds for epoch ### GET /chain-api/productscience/inference/inference/subnet_escrow/{id} Subnet escrow by ID ### GET /chain-api/productscience/inference/inference/subnet_host_epoch_stats/{epoch_index}/{participant} Subnet host epoch stats ### GET /chain-api/productscience/inference/inference/grantees_by_message_type/{granter_address}/{message_type_url} Grantees by message type ### GET /chain-api/productscience/inference/bls/params BLS module parameters ### GET /chain-api/productscience/inference/bls/epoch_data/{epoch_id} BLS epoch data ### GET /chain-api/productscience/inference/bls/signing_status/{request_id} BLS signing status ### GET /chain-api/productscience/inference/bls/signing_history BLS signing history ### GET /chain-api/productscience/inference/collateral/params Collateral module parameters ### GET /chain-api/productscience/inference/collateral/collateral/{participant} Collateral for a participant ### GET /chain-api/productscience/inference/collateral/collateral All collaterals ### GET /chain-api/productscience/inference/collateral/unbonding/{participant} Unbonding collateral ### GET /chain-api/productscience/inference/collateral/unbonding All unbonding collaterals ### GET /chain-api/productscience/inference/restrictions/params Restrictions module parameters ### GET /chain-api/productscience/inference/restrictions/status Transfer restriction status ### GET /chain-api/productscience/inference/restrictions/exemptions Transfer exemptions ### GET /chain-api/productscience/inference/restrictions/exemption_usage Exemption usage ### GET /chain-api/productscience/inference/genesistransfer/params Genesis transfer parameters ### GET /chain-api/productscience/inference/genesistransfer/transfer_status/{genesis_address} Transfer status for genesis account ### GET /chain-api/productscience/inference/genesistransfer/transfer_history Transfer history ### GET /chain-api/productscience/inference/genesistransfer/allowed_accounts Allowed accounts ### GET /chain-api/productscience/inference/genesistransfer/transfer_eligibility/{genesis_address} Transfer eligibility ### GET /chain-api/productscience/inference/streamvesting/params Stream vesting parameters ### GET /chain-api/productscience/inference/streamvesting/vesting_schedule/{participant_address} Vesting schedule for participant ### GET /chain-api/productscience/inference/streamvesting/total_vesting/{participant_address} Total vesting amount ### GET /chain-api/productscience/inference/bookkeeper/params Bookkeeper module parameters --- ## Gonka transactions (Msg RPCs) (63 endpoints) On-chain write operations exposed as POST via gRPC-Gateway under /chain-api/. These correspond to the Msg service in each Gonka module. All require a signed transaction body. ### POST /chain-api/productscience/inference/inference/start_inference Start an inference request ### POST /chain-api/productscience/inference/inference/finish_inference Finish an inference and submit result ### POST /chain-api/productscience/inference/inference/invalidate_inference Invalidate a failed inference ### POST /chain-api/productscience/inference/inference/revalidate_inference Re-validate an invalidated inference ### POST /chain-api/productscience/inference/inference/validation Submit validation result for an inference ### POST /chain-api/productscience/inference/inference/submit_new_participant Register a new funded participant ### POST /chain-api/productscience/inference/inference/submit_new_unfunded_participant Register a new unfunded participant ### POST /chain-api/productscience/inference/inference/claim_rewards Claim epoch rewards ### POST /chain-api/productscience/inference/inference/submit_poc_batch Submit Proof of Computation batch ### POST /chain-api/productscience/inference/inference/submit_poc_validation Submit PoC validation result ### POST /chain-api/productscience/inference/inference/submit_poc_validations_v2 Submit PoC v2 validations (batch) ### POST /chain-api/productscience/inference/inference/poc_v2_store_commit Submit PoC v2 off-chain state commit ### POST /chain-api/productscience/inference/inference/mlnode_weight_distribution Submit ML node weight distribution ### POST /chain-api/productscience/inference/inference/submit_seed Submit random seed for epoch ### POST /chain-api/productscience/inference/inference/submit_unit_of_compute_price_proposal Submit UoC price governance proposal ### POST /chain-api/productscience/inference/inference/register_model Register a new AI model (gov) ### POST /chain-api/productscience/inference/inference/delete_governance_model Delete a governance-registered model ### POST /chain-api/productscience/inference/inference/create_training_task Create a new training task ### POST /chain-api/productscience/inference/inference/claim_training_task_for_assignment Claim training task for assignment ### POST /chain-api/productscience/inference/inference/assign_training_task Assign training task to participant ### POST /chain-api/productscience/inference/inference/join_training Join an active training session ### POST /chain-api/productscience/inference/inference/training_heartbeat Submit training heartbeat ### POST /chain-api/productscience/inference/inference/set_barrier Set training synchronization barrier ### POST /chain-api/productscience/inference/inference/join_training_status Report training join status ### POST /chain-api/productscience/inference/inference/submit_training_kv_record Submit training key-value record ### POST /chain-api/productscience/inference/inference/submit_hardware_diff Submit hardware configuration diff ### POST /chain-api/productscience/inference/inference/bridge_exchange Execute bridge token exchange ### POST /chain-api/productscience/inference/inference/register_bridge_addresses Register bridge contract addresses (gov) ### POST /chain-api/productscience/inference/inference/register_liquidity_pool Register bridge liquidity pool (gov) ### POST /chain-api/productscience/inference/inference/request_bridge_withdrawal Request bridge withdrawal ### POST /chain-api/productscience/inference/inference/request_bridge_mint Request bridge mint ### POST /chain-api/productscience/inference/inference/register_wrapped_token_contract Register wrapped token contract (gov) ### POST /chain-api/productscience/inference/inference/migrate_all_wrapped_tokens Migrate all wrapped tokens (gov) ### POST /chain-api/productscience/inference/inference/register_token_metadata Register token metadata (gov) ### POST /chain-api/productscience/inference/inference/approve_bridge_token_for_trading Approve bridge token for trading (gov) ### POST /chain-api/productscience/inference/inference/approve_ibc_token_for_trading Approve IBC token for trading (gov) ### POST /chain-api/productscience/inference/inference/register_ibc_token_metadata Register IBC token metadata (gov) ### POST /chain-api/productscience/inference/inference/add_training_allow_list Add to training allow list (gov) ### POST /chain-api/productscience/inference/inference/remove_training_allow_list Remove from training allow list (gov) ### POST /chain-api/productscience/inference/inference/set_training_allow_list Set entire training allow list (gov) ### POST /chain-api/productscience/inference/inference/add_participants_to_allow_list Add participants to allow list (gov) ### POST /chain-api/productscience/inference/inference/remove_participants_from_allow_list Remove participants from allow list (gov) ### POST /chain-api/productscience/inference/inference/create_partial_upgrade Create partial chain upgrade (gov) ### POST /chain-api/productscience/inference/inference/create_subnet_escrow Create subnet escrow ### POST /chain-api/productscience/inference/inference/settle_subnet_escrow Settle subnet escrow ### POST /chain-api/productscience/inference/inference/update_params Update inference module params (gov) ### POST /chain-api/productscience/inference/bls/submit_dealer_part Submit BLS dealer part (DKG) ### POST /chain-api/productscience/inference/bls/submit_verification_vector Submit BLS verification vector (DKG) ### POST /chain-api/productscience/inference/bls/submit_group_key_validation_signature Submit group key validation sig (DKG) ### POST /chain-api/productscience/inference/bls/submit_partial_signature Submit BLS partial signature ### POST /chain-api/productscience/inference/bls/request_threshold_signature Request BLS threshold signature ### POST /chain-api/productscience/inference/bls/update_params Update BLS module params (gov) ### POST /chain-api/productscience/inference/collateral/deposit_collateral Deposit collateral ### POST /chain-api/productscience/inference/collateral/withdraw_collateral Withdraw collateral ### POST /chain-api/productscience/inference/collateral/update_params Update collateral module params (gov) ### POST /chain-api/productscience/inference/restrictions/execute_emergency_transfer Execute emergency transfer (gov) ### POST /chain-api/productscience/inference/restrictions/update_params Update restrictions module params (gov) ### POST /chain-api/productscience/inference/genesistransfer/transfer_ownership Transfer genesis account ownership ### POST /chain-api/productscience/inference/genesistransfer/update_params Update genesis transfer params (gov) ### POST /chain-api/productscience/inference/streamvesting/transfer_with_vesting Transfer tokens with vesting schedule ### POST /chain-api/productscience/inference/streamvesting/batch_transfer_with_vesting Batch transfer with vesting ### POST /chain-api/productscience/inference/streamvesting/update_params Update stream vesting params (gov) ### POST /chain-api/productscience/inference/bookkeeper/update_params Update bookkeeper params (gov) --- ## Gonka API node (39 endpoints) Proxied from the Gonka decentralized-api node at /v1/. Developer-friendly JSON — no raw Cosmos formats needed. ### GET /v1/status Node health and sync status ### GET /v1/identity Node identity (address, pubkey) ### GET /v1/versions Software version info ### GET /v1/models Available AI models and capacities ### GET /v1/pricing Current inference pricing ### GET /v1/participants List all participants ### GET /v1/participants/{address} Participant details by address ### GET /v1/governance/models Governance-registered models ### GET /v1/governance/pricing Governance pricing proposals ### GET /v1/epochs/{epoch} Epoch data by ID ### GET /v1/epochs/{epoch}/participants Participants in an epoch ### GET /v1/stats/summary/epochs Global inference summary by epochs ### GET /v1/stats/summary/time Global inference summary by time ### GET /v1/stats/models Per-model usage statistics ### GET /v1/stats/developers/{dev}/inferences Developer inference stats ### GET /v1/bls/epoch/{id} BLS epoch data ### GET /v1/bls/signatures/{request_id} BLS signature by request ID ### GET /v1/bridge/status Bridge status ### GET /v1/bridge/addresses Bridge addresses ### GET /v1/restrictions/status Transfer restriction status ### GET /v1/restrictions/exemptions Transfer exemptions ### GET /v1/poc/artifacts/state Proof-of-Computation artifact state ### GET /v1/inference/payloads Inference payload data ### POST /v1/chat/completions Submit inference request (OpenAI-compatible) ### GET /v1/chat/completions Get inference result by ID ### POST /v1/participants Register a new participant ### POST /v1/training/tasks Create a training task ### GET /v1/training/tasks List training tasks ### GET /v1/training/tasks/{id} Get training task by ID ### POST /v1/training/lock-nodes Lock nodes for training session ### POST /v1/verify-proof Verify a submitted proof ### POST /v1/verify-block Verify a block ### GET /v1/governance/models-legacy Legacy governance-registered models ### GET /v1/stats/developers/{dev}/summary/epochs Developer epoch summary ### GET /v1/poc-batches/{epoch} PoC batches for an epoch ### POST /v1/poc/proofs Submit PoC proofs (rate limited 300/min) ### GET /v1/restrictions/exemptions/{id}/usage/{account} Exemption usage for specific account ### GET /v1/debug/pubkey-to-addr/{pubkey} Convert public key to address ### GET /v1/debug/verify/{height} Debug: verify at block height --- ## Fast indexed endpoints (9 endpoints) Read-only JSON from the ClickHouse chain index at /api/ch/*. Sub-200 ms on full history. Ideal for explorers, wallets, analytics. ### GET /api/ch/blocks Latest blocks with tx count, gas totals, timestamps — newest first Parameters: limit (default 20, max 100), offset (max 100K) Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/blocks?limit=10' ``` ### GET /api/ch/blocks/latest Latest indexed block — height, time, tx count, gas totals Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/blocks/latest' ``` ### GET /api/ch/tx/{hash} Transaction by hash — full indexed record Parameters: hash: 64 hex chars, 0x prefix ok Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/tx/7be18a9a41ec90c4563e526b24a65bc83fa38e3e7b064c1b6045181601013b1a' ``` ### GET /api/ch/block/{height} All transactions in a block, chain order Parameters: height: non-negative integer Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/block/3397529' ``` ### GET /api/ch/address/{address} Paginated tx history for any wallet — sent & received, newest first Parameters: limit (default 5, max 100), offset (max 1M) Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/address/gonka1jftn8khawsmfn7shgzfjn27myu5d4zd6ns09y8?limit=100' ``` ### GET /api/ch/slashing Slashing events — filter by participant and height range Parameters: participant, from_height, to_height, limit (50), offset Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/slashing?limit=50' ``` ### GET /api/ch/hardware/nodes/{address} Current hardware registrations — GPU types, status, timestamps Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/hardware/nodes/gonka1jftn8khawsmfn7shgzfjn27myu5d4zd6ns09y8' ``` ### GET /api/ch/hardware/snapshots Per-epoch hardware history Parameters: snapshot_epoch (required), participant, limit, offset Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/hardware/snapshots?snapshot_epoch=219' ``` ### GET /api/ch/epoch-performance/{address} Per-epoch inference & rewards counters for a participant Parameters: epoch_min, limit, offset. Ordered epoch_index DESC Example: ``` curl -sS -H 'X-Api-Key: YOUR_KEY' \ 'https://rpc.gonka.gg/api/ch/epoch-performance/gonka1jftn8khawsmfn7shgzfjn27myu5d4zd6ns09y8?limit=50' ``` --- ## MLNode callback API (6 endpoints) Callback endpoints for ML nodes participating in Proof of Computation. Used by the ML node software to report PoC results back to the API node. ### POST /mlnode/v1/poc-batches/generated V1: PoC batch generation callback ### POST /mlnode/v1/poc-batches/validated V1: PoC batch validation callback ### POST /v1/poc-batches/generated V1 alias: PoC batch generated ### POST /v1/poc-batches/validated V1 alias: PoC batch validated ### POST /v2/poc-batches/generated V2: PoC artifacts generation (off-chain) ### POST /v2/poc-batches/validated V2: PoC validations (off-chain) ---