Hanzo
OpenapiWeb3

Reports one chain and whether its upstream is answering.

Reports one chain and whether its upstream is answering.

GET /v1/web3/chains/{chain}

Addresshttps://api.hanzo.ai/v1/web3/chains/{chain}
MethodGET
Operationget_web3_chains_by_chain
AuthAuthorization: Bearer $HANZO_API_KEY

Reports one chain and whether its upstream is answering. An unreachable chain is still a 200 with live:false — the chain is configured, which is a different fact from the chain being up, and a 502 here would make a console page error rather than show the outage.

Request

1 field.

FieldInTypeRequiredDescription
chainpathstringyesChain is the registry id, as in /v1/web3/chains/lux.

Response

StatusBodyMeaning
200chainStatusok

200 body — 5 fields.

FieldInTypeAlwaysDescription
chainIdbodyinteger
heightbodyintegerHeight is the latest block, omitted when the chain did not answer rather than reported as zero — a zero height is a real value on a fresh chain.
idbodystring
livebodybooleanLive is whether the upstream answered eth_blockNumber.
namebodystring

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Web3 API · All Hanzo APIs · Interactive reference

How is this guide?

On this page