QUACDocs

Operating

REST API

Every QUAC node can serve the standard Cosmos SDK REST API (gRPC-gateway) on port 1317. On the public testnet it is published at:

https://testnet-api.quantcoin.world

All responses are JSON. Amounts are strings in uquac. Binary fields such as hashes, keys and signatures are base64. Browsers may call the API from any origin (CORS *).

Chain and blocks

Method & path Returns
GET /cosmos/base/tendermint/v1beta1/node_info Chain ID, node software versions
GET /cosmos/base/tendermint/v1beta1/syncing {"syncing": false} once caught up
GET /cosmos/base/tendermint/v1beta1/blocks/latest Latest block
GET /cosmos/base/tendermint/v1beta1/blocks/{height} Block at a height
GET /cosmos/base/tendermint/v1beta1/validatorsets/latest Current validator set with voting power

A block response has two copies of the block: block (proposer address as base64 bytes) and sdk_block (proposer as a quacvalcons1… address). Each last_commit.signatures[] entry is one validator's ML-DSA-65 vote on the previous block:

{
  "block_id_flag": "BLOCK_ID_FLAG_COMMIT",
  "validator_address": "BlB8ufmoGAOvPlYPrCLrFkZjYuI=",
  "timestamp": "2026-11-18T19:20:34.833643100Z",
  "signature": "…4,412 base64 characters = 3,309 bytes…"
}
curl -s https://testnet-api.quantcoin.world/cosmos/base/tendermint/v1beta1/blocks/latest \
  | jq '.block.header.height, (.block.last_commit.signatures | length)'

Transactions

Method & path Returns
GET /cosmos/tx/v1beta1/txs/{hash} One transaction (tx) and its result (tx_response)
GET /cosmos/tx/v1beta1/txs?query=…&order_by=ORDER_BY_DESC&limit=N Search by events
GET /cosmos/tx/v1beta1/txs/block/{height} Decoded transactions in a block
POST /cosmos/tx/v1beta1/txs Broadcast {"tx_bytes": "<base64>", "mode": "BROADCAST_MODE_SYNC"}
POST /cosmos/tx/v1beta1/simulate Estimate gas for {"tx_bytes": "<base64>"}

A transaction hash is the uppercase hex SHA-256 of the transaction bytes. Search queries use CometBFT event syntax:

# Everything, newest first
curl -sG https://testnet-api.quantcoin.world/cosmos/tx/v1beta1/txs \
  --data-urlencode "query=tx.height>0" --data-urlencode order_by=ORDER_BY_DESC --data-urlencode limit=10

# Sent by an address
--data-urlencode "query=message.sender='quac1…'"

# Received by an address
--data-urlencode "query=transfer.recipient='quac1…'"

In a transaction, tx.auth_info.signer_infos[i].public_key["@type"] is /cosmos.crypto.mldsa65.PubKey on an account's first transaction. Later transactions omit the key, because the chain already stores it. tx.signatures[i] is the 3,309-byte ML-DSA-65 signature.

Accounts and balances

Method & path Returns
GET /cosmos/auth/v1beta1/accounts/{address} Account number, sequence, stored public key. 404 if the address has never been used.
GET /cosmos/bank/v1beta1/balances/{address} All balances
GET /cosmos/bank/v1beta1/balances/{address}/by_denom?denom=uquac QUAC balance
GET /cosmos/bank/v1beta1/supply/by_denom?denom=uquac Total QUAC supply
GET /cosmos/bank/v1beta1/denoms_metadata/uquac Display metadata (QUAC, 6 decimals, logo)

Minting

Method & path Returns
GET /cosmos/mint/v1beta1/inflation Current annual inflation rate, e.g. "0.050000006751337462"
GET /cosmos/mint/v1beta1/annual_provisions Current annual issuance in uquac
GET /cosmos/mint/v1beta1/params Mint parameters, including max_supply

Staking and distribution

Method & path Returns
GET /cosmos/staking/v1beta1/validators All validators: moniker, tokens, commission, status, consensus key
GET /cosmos/staking/v1beta1/pool Bonded and not-bonded totals
GET /cosmos/staking/v1beta1/delegations/{delegator} An account's delegations
GET /cosmos/distribution/v1beta1/delegators/{delegator}/rewards Pending staking rewards
GET /cosmos/distribution/v1beta1/community_pool Community pool balance

Each validator's consensus_pubkey["@type"] is /cosmos.crypto.mldsa65.PubKey. Its consensus address is the first 20 bytes of SHA-256 of that key. The explorer uses this to match block proposers to validator names.

Parameters

Path Of note
/cosmos/auth/v1beta1/params sig_verify_cost_mldsa65 (750), tx_size_cost_per_byte (10)
/cosmos/staking/v1beta1/params bond_denom (uquac), unbonding_time, key_rotation_fee
/cosmos/gov/v1/params/voting Governance timing
/cosmos/consensus/v1/params validator.pub_key_types (["ml_dsa_65"])

Not available publicly

The public testnet does not expose CometBFT RPC (26657) or gRPC (9090/9190), so that validator IPs stay private (see Public testnet). Run your own node if you need them.

Edit this page on GitHub