Signature webhook
Key Requirements
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.
Signature Format:
The signature must be in a non-compact format, ending in either
1b
or1c
. 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, eitherpublic_transaction
,private_transaction
, orblock
.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 transactionhash
: 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 either1b
or1c
.
Last updated
Was this helpful?