Skip to main content

Helix Testnet Endpoints

These endpoints allow you to query the blockchain state, submit transactions, and build applications on top of Helix.

Available Endpoints​

InterfaceURLDescription
REST APIhttps://api-testnet.nuklaivm.com/REST API
RPChttps://rpc-testnet.nuklaivm.com/CometBFT RPC interface
gRPCapi-testnet.nuklaivm.com:9090Protobuf gRPC service

REST API​

The REST API provides HTTP endpoints to interact with Helix. It's ideal for web applications and services that need to query blockchain state or submit transactions.

Common Endpoints​

  • /cosmos/auth/v1beta1/accounts/{address} - Get account information
  • /cosmos/bank/v1beta1/balances/{address} - Query account balances
  • /cosmos/tx/v1beta1/txs - Submit signed transactions
  • /nuklai/dataset/v1/datasets - Query all datasets
  • /nuklai/dataset/v1/datasets/{denom} - Get dataset details
  • /nuklai/dataset/v1/contributions/{denom} - List dataset contributions
  • /cosmos/staking/v1beta1/validators - Query validators

Example Usage​

# Query account balance
curl -X GET "https://api-testnet.nuklaivm.com/cosmos/bank/v1beta1/balances/nuklai13fy0hfyy5h9zxmkukfx48j0m84kyl7qpcljh5h"

# Get dataset information
curl -X GET "https://api-testnet.nuklaivm.com/nuklai/dataset/v1/datasets/nuklaidataset07d1b507e614c562ef726c4b051"

RPC​

Provides access to the CometBFT consensus layer, handles transaction broadcasting, block queries node status and more.

Common Endpoints​

  • /status - Get the node sync status and network information
  • /broadcast_tx_commit - Submit and wait for transaction confirmation
  • /block - Get block at specified height or latest
  • /tx_search - Search for transactions with query
  • /validators - Get validator set at specified height
  • /abci_query - Query application state directly

Example Usage​

# Get network status
curl -X GET "https://rpc-testnet.nuklaivm.com/status"

Response:

{
  "jsonrpc": "2.0",
  "id": -1,
  "result": {
    "node_info": {
      "protocol_version": {
        "p2p": "8",
        "block": "11",
        "app": "0"
      },
      "id": "fc115d2a64a66d61284abcab0f04da956755812c",
      "listen_addr": "tcp://0.0.0.0:26656",
      "network": "nuklai",
      "version": "0.38.12",
      "channels": "40202122233038606100",
      "moniker": "secondary-node",
      "other": {
        "tx_index": "on",
        "rpc_address": "tcp://0.0.0.0:26657"
      }
    },
    "sync_info": {
      "latest_block_hash": "6F88317FA1FCAA6CC553D975E49FD06232273B07F1893751CF1B6B08B6C9F248",
      "latest_app_hash": "31B12076FDDEB4333F3F5AE13D43125008BEC9311E2438E6DD88FE6FF9206594",
      "latest_block_height": "341144",
      "latest_block_time": "2025-05-11T10:46:56.787199938Z",
      "earliest_block_hash": "16BEC90AD1578E85526E37092ED4318D3052562C8FB0500ED8F4F43C9F0DB8F9",
      "earliest_app_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
      "earliest_block_height": "1",
      "earliest_block_time": "2025-04-21T14:32:38.061571024Z",
      "catching_up": false
    },
    "validator_info": {
      "address": "3325E113F102D4BE0EAC54A62F11D2E95F8160C8",
      "pub_key": {
        "type": "tendermint/PubKeyEd25519",
        "value": "cUmc0Gz3WA2ahHK3l9ms48AawD0sGk5iiKiOhRRleH0="
      },
      "voting_power": "296"
    }
  }
}
# Broadcast a signed transaction
curl -X POST "https://rpc-testnet.nuklaivm.com/broadcast_tx_commit" \
  --data-binary '{"jsonrpc":"2.0","id":1,"method":"broadcast_tx_commit","params":{"tx":"6F88317FA1FCAA6CC553D975E49FD06232273B07F1893751CF1B6B08B6C9F248"}}'

gRPC​

Main Services​

  • cosmos.auth.v1beta1.Query - Account and module parameter queries
  • cosmos.bank.v1beta1.Query - Token balances and supply
  • cosmos.tx.v1beta1.Service - Transaction submission and queries
  • nuklai.dataset.v1.Query - Dataset module queries
  • cosmos.staking.v1beta1.Query - Validator and delegation queries
  • cosmwasm.wasm.v1.Query - Smart contract queries and interaction

Example Usage​

Using grpcurl (a command-line tool like curl but for gRPC):

# List available services
grpcurl -insecure rpc-testnet.nuklaivm.com:9090 list

# Query account balance
grpcurl -insecure -d '{"address":"nuklai13fy0hfyy5h9zxmkukfx48j0m84kyl7qpcljh5h"}' \
  rpc-testnet.nuklaivm.com:9090 cosmos.bank.v1beta1.Query/AllBalances

# Query datasets
grpcurl -insecure rpc-testnet.nuklaivm.com:9090 nuklai.dataset.Query

SDK Integration​

Nuklai Chain can be easily integrated with various programming languages through available Cosmos SDK client libraries:

Additional Resources​