Signature webhook

This is not used for EIP712 wallet intents.

Key Requirements

  1. Response Time:

    • Your service must respond within 200ms to prevent the intent from being dropped. A faster response ensures smooth execution and preserves transaction opportunities.

  2. Signature Format:

    • The signature must be in a non-compact format, ending in either 1b or 1c. Ensure that your signing process produces this format for compatibility.


Request:

The following is an example of the payload sent to your webhook:

{
  intentId: "0000-0000-0000-0000", 
  // launch information
  launch: {
    type: 'public_transaction' | 'private_transaction' | 'block',
    blockNumber: "20584608",
    launchTxHash: "0x7f4d3b29b184096659b499ee9cc15355c5edc70f3ea76fb14975ea1f505d42b8",
  },
  tx: { 
    // EIP 1559 transaction
    to: "0x80a64c6d7f12c47b7c66c5b4e20e72bc1fcd5d9e",
    // refer to the provided ABI to decode this
    data: "0x791ac9470000000000000000000000000000000000000000000000004563918244f3ffff00000000000000000000000000000000000000000000000006dd07c72e01291200000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000b6a14f0d6d49776ca63304f00f4eb2772f705e5a000000000000000000000000000000000000000000000000000000006622c82300000000000000000000000000000000000000000000000000000000000000020000000000000000000000004880c2032a6279773b1ac48205c09e94f03a3154000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    value: "0x0",
    chainId: "0x1",
    gas: "0x4b97b",
    nonce: "0x2cb",
    maxFeePerGas: "0x35323bec5",
    maxPriorityFeePerGas: "0xb2d05e00",
  },
  rawTx: "0x....", // raw serialized version of tx
   // sign this hash!
  hash: "0x01a08a72149d0ebb6b4630bafdc2f42c15dbebf95d9bd63c9b51a0f4bf58d814", 
}

Field Descriptions:

  • intentId: A unique identifier for the intent being processed.

  • launch: Information about the detected launch:

    • type: The type of launch, either public_transaction, private_transaction, or block.

    • blockNumber: The block number associated with the launch.

    • launchTxHash: The transaction hash of the detected launch.

  • tx: Transaction details as an EIP-1559 compliant structure.

  • rawTx: The raw serialized transaction (optional - only when launch type is a transaction).

  • hash: The transaction hash to be signed.


Response

Your webhook should respond with a signature in the following format:

{
  "signature": "0xc536a0215511a9900bc43f7f6ad92d8563a64ad44c281971fa6c65b90a144b723f1o1c1963cf97100b0d72e67815aca0afbc798ba5b93aa639510f9760964d9f1c"
}

Field Descriptions:

  • signature: The ECDSA signature for the transaction hash, in non-compact format. Ensure it ends with either 1b or 1c.

Last updated