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.

GET/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>"
Parameters
ParameterDescription
messageId

query · integer · required

The withdrawal's number: messageId on a bridge-transfers withdrawal.
chain

path · 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.

Response fields of Claim a bridge withdrawal on the parent chain
FieldTypeDescription
messageIdintegerThe withdrawal asked about.
statusstring | nullclaimable: 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.
claimobject | nullSet exactly when status is claimable; null otherwise.
claim.contractstringThe parent chain's outbox contract to send calldata to.
claim.calldatastringThe whole call, proof included. Send it with no value.
claim.senderstringThe L2 address that sent the withdrawal.
claim.destinationstringThe parent-chain address the withdrawal calls.
claim.valuestringThe native value it releases, in wei.
claim.datastringThe call it makes on destination; 0x when none.
claim.l2BlockNumberintegerThe L2 block that sent it.
claim.parentBlockNumberintegerThe parent-chain block the L2 had seen when it was sent.
claim.initiatedAtintegerUnix 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