Chains API
Claim a bridge withdrawal on the parent chain
Whether an L2 → parent-chain withdrawal can be claimed yet, and if so the exact parent-chain transaction (contract + calldata with its proof) that claims it. RHC.
/api/external/chain-analysis/bridge-withdrawal-claim/{chain}What it returns
Ask by messageId, the withdrawal's number as bridge-transfers answers it. status is claimable once the withdrawal is confirmed and not yet executed, executed once it has been claimed, unconfirmed while it is still inside its challenge period, and null when no withdrawal has that number. When claimable, claim is the transaction that executes it: send calldata to contract on the parent chain, with no value, from any account. The call carries its own proof and is checked to be the execution of exactly the withdrawal asked for.
Chains
- Robinhood Chain RHC
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/chain-analysis/bridge-withdrawal-claim/RHC?messageId=<messageId>"
| Parameter | Description |
|---|---|
messageIdquery · integer · required | The withdrawal's number: messageId on a bridge-transfers withdrawal. |
chainpath · string · required | RHC; every other chain returns 400. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
messageId | integer | The withdrawal asked about. |
status | string | null | claimable: confirmed and not executed; claim executes it. executed: already claimed on the parent chain. unconfirmed: still inside its challenge period (or not yet posted to the parent chain). null: no withdrawal has this number. |
claim | object | null | Set exactly when status is claimable; null otherwise. |
claim.contract | string | The parent chain's outbox contract to send calldata to. |
claim.calldata | string | The whole call, proof included. Send it with no value. |
claim.sender | string | The L2 address that sent the withdrawal. |
claim.destination | string | The parent-chain address the withdrawal calls. |
claim.value | string | The native value it releases, in wei. |
claim.data | string | The call it makes on destination; 0x when none. |
claim.l2BlockNumber | integer | The L2 block that sent it. |
claim.parentBlockNumber | integer | The parent-chain block the L2 had seen when it was sent. |
claim.initiatedAt | integer | Unix seconds it was sent on the L2. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key