d54882cd0f
Some checks failed
CI/CD Pipeline / Solidity Contracts (push) Failing after 1m12s
CI/CD Pipeline / Security Scanning (push) Successful in 2m38s
CI/CD Pipeline / Lint and Format (push) Failing after 40s
CI/CD Pipeline / Terraform Validation (push) Failing after 21s
CI/CD Pipeline / Kubernetes Validation (push) Successful in 24s
HYBX OMNL TypeScript & anchor / token-aggregation build + reconcile artifact (push) Failing after 24s
Validation / validate-genesis (push) Successful in 26s
Validation / validate-terraform (push) Failing after 21s
Validation / validate-kubernetes (push) Failing after 9s
Validation / validate-smart-contracts (push) Failing after 9s
Validation / validate-security (push) Failing after 1m7s
Validation / validate-documentation (push) Failing after 15s
Resolve etherscanLinks from batch metadata and optional mainnet log scans; serve a fast local-batch attestation path for the explorer CT. Co-authored-by: Cursor <cursoragent@cursor.com>
Checkpoint indexer REST API
Exposes v2 hub reads for wallets and explorers, plus an Etherscan V2-shaped shim for Chain 138 (unsupported on official Etherscan V2 chainlist).
See: docs/04-configuration/etherscan/CHAIN138_ETHERSCAN_V2_UNSUPPORTED_NETWORK_FRAMEWORK.md
Endpoints (v1)
| Method | Path | Description |
|---|---|---|
| GET | /health |
Liveness |
| GET | /v1/checkpoint/latest |
Latest batch header |
| GET | /v1/checkpoint/:batchId |
Historical batch |
| GET | /v1/tx/:txHash/attestation |
Inclusion in batch |
| GET | /v1/account/:address |
Account summary + attested activity |
| GET | /v1/account/:address/transactions |
Batch-indexed txs for address |
| GET | /v1/account/:address/activity |
Attested activity rows |
| GET | /v1/tx/:txHash/logs |
Receipt logs from batch payload |
Endpoints (v2 — Etherscan supplement)
| Method | Path | Description |
|---|---|---|
| GET | /v2/chainlist-supplement |
Supplemental chainlist (chain 138 + mainnet attestation layer) |
| GET | /v2/api?chainid=138&module=account&action=balance |
Chain 138 balance (RPC) |
| GET | /v2/api?chainid=138&module=account&action=txlist |
Blockscout tx list proxy |
| GET | /v2/api?chainid=138&module=chain138&action=participantactivity |
Attested activity from batch index |
| GET | /v2/api?chainid=138&module=chain138&action=attestation&txhash=0x… |
Per-tx attestation |
| GET | /v2/api?chainid=138&module=proxy&action=eth_blockNumber |
Chain 138 block number |
| GET | /v2/api?chainid=1&module=chain138mirror&action=contracts |
Mainnet mirror/registry/hub map |
| GET | /v2/api?chainid=1&module=chain138mirror&action=participantlogs |
Etherscan V2 log proxy (credited topic2, debited topic3) |
| GET | /v2/api?chainid=1&module=chain138mirror&action=mirrorlogs |
v1 TransactionMirror logs |
Env: ADDRESS_ACTIVITY_REGISTRY_MAINNET, ETHERSCAN_API_KEY (for mainnet log proxy).
Run
cd smom-dbis-138/services/checkpoint-indexer
pnpm install && pnpm build
CHAIN138_MAINNET_CHECKPOINT_PROXY=0x… pnpm start
From repo root: bash scripts/deployment/start-checkpoint-services.sh (builds aggregator + indexer).
Default port: 3099 (CHECKPOINT_INDEXER_PORT).
Public NPM path (when configured): https://explorer.d-bis.org/checkpoint/v2/... → indexer.