Skip to content
ReferenceTestnet: yesMainnet: Not availableSoftware: Core bad4a06ea · protocol pqwerai-v8-testnet/1Updated

g4 namespace (finality)

PQWERAI BFT finality, Smartnode registry and exact issuance accounting.

3 public methods. Operator, disabled and unsupported methods of this namespace are listed in Operator interfaces. $RPC is your node URL (see quickstart).

Method Access Summary
g4_evidence Public · read-only Lists equivocation evidence (double or surround votes) detected by this node.
g4_status Public · read-only Finality and issuance accounting: head, justified/finalized checkpoints, registry totals, exact issuance count
g4_validators Public · read-only Lists Smartnode validators from the registry: id, owner, Ed25519 key, stake, delegated stake, activation epoch

g4_evidence

Lists equivocation evidence (double or surround votes) detected by this node.
Access Public · read-only · playground
Network private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software protocol pqwerai-v8-testnet/1
Verified source core/source/cmd/pqwerai-core/g4.go:376 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns array of objects

Parameters: none

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "g4_evidence",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "g4_evidence", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}

Errors and edge cases

  • -32602 invalid or missing parameter (e.g. missing value for required argument 0).
  • -32000 execution or validation error with a message from the node.

g4_status

Finality and issuance accounting: head, justified/finalized checkpoints, registry totals, exact issuance counters and vote-submission counters.
Access Public · read-only · playground
Network private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software protocol pqwerai-v8-testnet/1
Verified source core/source/cmd/pqwerai-core/g4.go:210 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns object

Behaviour on PQWERAI

PQWERAI finality and issuance accounting. Fields minted_wei, pow_issued_wei, pos_issued_wei, founder_issued_wei and fee_burn_wei are exact counters read from consensus state.

Parameters: none

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "g4_status",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "g4_status", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "epoch_set_root": "8ae82c2488bbcda80595ba903a5825dc356ab2a2b891809c9b50c017fe250065",
    "epoch_set_size": 2,
    "fee_burn_wei": "1109182695701309",
    "finality": true,
    "finalized_hash": "0x982c1d3af93176df3ed7c1387b484ab70f3748b82000b2f70d0e7b3fb6a5e2d0",
    "finalized_height": 4288,
    "founder_issued_wei": "17832760910000000",
    "head": 4325,
    "justified_hash": "0x66a9adfb26cee8cf852691267bfec16dc1490841e76966205f545efef0541a5e",
    "justified_height": 4320,
    "liveness_ejected_validators": 2,
    "liveness_participation_records": true,
    "minted_wei": "1019143783276091000000000",
    "pos_issued_wei": "353088666018000000",
    "pow_issued_wei": "1412354664072000000",
    "registry_locked_gwei": 130000000000,
    "registry_slash_burned_gwei": 0,
    "rejected_certificates": 0,
    "validators": 5,
    "vote_counters": {
      "forged_or_unauthorized": 2080,
      "malformed": 4,
      "participation_relayed": 15,
      "replayed": 1,
      "stale": 18
    }
  }
}

Errors and edge cases

  • -32602 invalid or missing parameter (e.g. missing value for required argument 0).
  • -32000 execution or validation error with a message from the node.

g4_validators

Lists Smartnode validators from the registry: id, owner, Ed25519 key, stake, delegated stake, activation epoch and status.
Access Public · read-only · playground
Network private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software protocol pqwerai-v8-testnet/1
Verified source core/source/cmd/pqwerai-core/g4.go:344 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns array of objects

Parameters: none

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "g4_validators",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "g4_validators", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "activation_epoch": 0,
      "delegated_gwei": 0,
      "id": "44e1990f323a4e9f679841988f1f2c86f939ccfd7cdcd22c17eb91f5a2c24e61",
      "key": "0fd5d00dcabc5375ee04d70c54192f32fce7e7131c2cce728e65ef08be526a4c",
      "owner": "0x460e14b0296783a6f66cf1eed54853f4b5d5a918",
      "pending_key": false,
      "stake_gwei": 32000000000,
      "status": "exiting"
    },
    {
      "activation_epoch": 0,
      "delegated_gwei": 2000000000,
      "id": "92571f2ba70dcf9f86b1eb60527d478dd0f24e429bf9b65c92663236280e70f8",
      "key": "bf9fee5e279c5a8ae2549a2b6612b46f87d35c7df205643d1b2383f5580c2474",
      "owner": "0xfd6daa176013d5b9b7176e65caa61fb25a5cfe93",
      "pending_key": false,
      "stake_gwei": 32000000000,
      "status": "active"
    },
    {
      "activation_epoch": 0,
      "delegated_gwei": 0,
      "id": "9a738ce18aff9ee770b5afcf15a754188e82b33ed1c22c3c3ee7d34f99821798",
      "key": "7b0086337ae830eb03a89c7502f8ba248d50e6d35196e55c51271b5b88a65803",
      "owner": "0x478031f6aceef7404992d014a7d88a51b24e4ef1",
      "pending_key": false,
      "stake_gwei": 32000000000,
      "status": "exiting"
    },
    "... 2 more items"
  ]
}

Errors and edge cases

  • -32602 invalid or missing parameter (e.g. missing value for required argument 0).
  • -32000 execution or validation error with a message from the node.

Sources at 72057fe3ec: core/source/cmd/pqwerai-core/g4.go

Found a problem? Report a documentation issue · Build testnet-rc1+72057fe3ec