Receive Withdrawal Notifications

Once the transaction has been submitted, the following webhooks are sent out for each stage of the withdrawal process.

• layer1:crypto:withdrawal:status-change updates on any change of the withdrawal status.
• layer1:digital:balance:updated gives an update of the wallet balances within your Asset Pool.

The "balance updated" webhooks

The following webhooks are sent out to update the current balance within the corresponding master address:

• The "funds reserved" update indicates the withdrawal amount has been moved from AVAILABLE to RESERVED balance.
• The "funds released" update indicates that the funds have been removed from the RESERVED pool following a successful withdrawal.

Balance Updated: Funds Reserved

{
  "event": "layer1:digital:balance:updated",
  "timestamp": "2024-06-06T19:33:25.059079161Z",
  "data": {
    "reference": "AssetPoolTwo",
    "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
    "asset": "ETH",
    "funds": [
      {
        "type": "AVAILABLE",
        "balance": "0.19848315335156838671875",
        "delta": "-0.00114716058324173828125"
      },
      {
        "type": "BLOCKCHAIN",
        "balance": "0.199630313934810125",
        "delta": "0.00"
      },
      {
        "type": "RESERVED",
        "balance": "0.00114716058324173828125",
        "delta": "0.00114716058324173828125"
      }
    ]
  }
}

Balance Updated: Funds Released

{
  "event": "layer1:digital:balance:updated",
  "timestamp": "2024-06-06T19:34:38.763517740Z",
  "data": {
    "reference": "AssetPoolTwo",
    "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
    "asset": "ETH",
    "funds": [
      {
        "type": "AVAILABLE",
        "balance": "0.198496131149297125",
        "delta": "0.000012977797728738"
      },
      {
        "type": "BLOCKCHAIN",
        "balance": "0.198496131149297125",
        "delta": "-0.001134182785513"
      },
      {
        "type": "RESERVED",
        "balance": "0.00",
        "delta": "-0.001147160583241738"
      }
    ]
  }
}

The "status change" webhooks

The following webhooks are sent out to inform about the current status of the withdrawal:

• CREATED
• SCREENING_REQUESTED
• FUNDS_RESERVED
• SIGNED
• DETECTED. At this stage, the transaction is already on the relevant blockchain and can now be traced with the hash provided in the webhook.
• UNCONFIRMED
• CONFIRMED
• SUCCESS. At the final stage, the withdrawal is now in the destination wallet. All pool balances have been updated. The withdrawal process is now complete.

Created

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:33:25.139504437Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001",
    "status": "CREATED",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.000147160583241738",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      },
      {
        "amount": "0.001",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:33:25.109693Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84A4a239805d06c685219801B82BEA7c76702214"
      }
    ]
  }
}

Screening Requested

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:33:25.332170456Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001",
    "status": "SCREENING_REQUESTED",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.000147160583241738",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      },
      {
        "amount": "0.001",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:33:25.298837Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84A4a239805d06c685219801B82BEA7c76702214"
      }
    ]
  }
}

Funds Reserved

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:33:26.038587396Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001",
    "status": "FUNDS_RESERVED",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.000147160583241738",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      },
      {
        "amount": "0.001",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:33:25.987397Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84A4a239805d06c685219801B82BEA7c76702214"
      }
    ]
  }
}

Signed

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:33:26.620045369Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001",
    "status": "SIGNED",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.000147160583241738",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      },
      {
        "amount": "0.001",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:33:26.596896Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84A4a239805d06c685219801B82BEA7c76702214"
      }
    ]
  }
}

Detected

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:33:31.090682810Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "hash": "0xd5048b414557978a4c271998b3fda04b0f6228edbdb47500a045f12bf22b1ee2",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001",
    "status": "DETECTED",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.001",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:33:31.046673Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84a4a239805d06c685219801b82bea7c76702214"
      }
    ]
  }
}

Unconfirmed

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:33:38.477488250Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "hash": "0xd5048b414557978a4c271998b3fda04b0f6228edbdb47500a045f12bf22b1ee2",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001134182785513",
    "status": "UNCONFIRMED",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.001134182785513",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:33:38.447726Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84a4a239805d06c685219801b82bea7c76702214"
      }
    ],
    "networkDetail": {
      "fee": {
        "asset": "ETH",
        "amount": "0.000134182785513"
      },
      "block": {
        "number": 6053161,
        "timestamp": "2024-06-06T19:33:36Z"
      }
    }
  }
}

Confirmed

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:34:38.719132837Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "hash": "0xd5048b414557978a4c271998b3fda04b0f6228edbdb47500a045f12bf22b1ee2",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001134182785513",
    "status": "CONFIRMED",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.001134182785513",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:34:38.697222Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84a4a239805d06c685219801b82bea7c76702214"
      }
    ],
    "networkDetail": {
      "fee": {
        "asset": "ETH",
        "amount": "0.000134182785513"
      },
      "block": {
        "number": 6053161,
        "timestamp": "2024-06-06T19:33:36Z"
      }
    }
  }
}

Success

{
  "event": "layer1:digital:withdrawal:status-change",
  "timestamp": "2024-06-06T19:34:38.822842496Z",
  "data": {
    "id": "018fef0aab157afb966b7d20c89b55048e1fcdb58edc49b792891c41c5bcd81869",
    "hash": "0xd5048b414557978a4c271998b3fda04b0f6228edbdb47500a045f12bf22b1ee2",
    "type": "WITHDRAWAL",
    "asset": "ETH",
    "amount": "0.001134182785513",
    "status": "SUCCESS",
    "address": {
      "id": "8e1fcdb5-8edc-49b7-9289-1c41c5bcd818",
      "address": "0x96073c4b415d60ade18de32e43efc2914731e03d",
      "network": "ETHEREUM",
      "keyPairId": "fdc9f5a0-698c-4163-ab21-df85f343a2a4",
      "reference": "AssetPoolTwo",
      "assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600"
    },
    "sources": [
      {
        "amount": "0.001134182785513",
        "address": "0x96073c4b415d60ade18de32e43efc2914731e03d"
      }
    ],
    "createdAt": "2024-06-06T19:33:24.885Z",
    "reference": "myUniqueRef333",
    "updatedAt": "2024-06-06T19:34:38.802803Z",
    "destinations": [
      {
        "amount": "0.001",
        "address": "0x84a4a239805d06c685219801b82bea7c76702214"
      }
    ],
    "networkDetail": {
      "fee": {
        "asset": "ETH",
        "amount": "0.000134182785513"
      },
      "block": {
        "number": 6053161,
        "timestamp": "2024-06-06T19:33:36Z"
      }
    }
  }
}