curl --request POST \
--url https://dev.api.withconvexity.com/v1/wallet/hd/sign \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"chainType": "EVM",
"chainId": 8453,
"addressIndex": 12,
"transaction": {
"to": "0x2222222222222222222222222222222222222222",
"value": "0",
"data": "0xa9059cbb…"
},
"webhookUrl": "https://example.com/hooks/wallet",
"webhookSecret": "a-secret-you-generate-and-keep"
}
'{
"status": true,
"message": "Transaction signed successfully",
"data": {
"signedTransaction": "0x02f8b18221058084...c0a0e1"
}
}Sign transaction
Signs (and, where applicable, sponsors and submits) a transaction from a derived wallet identified by addressIndex. Asynchronous by default, like transfers: sponsored signs are validated, recorded, and answered 202 with the PENDING transaction while the relay executes on-chain. Poll Get transaction by id or pass webhookUrl to be notified of the outcome (see Transfer lifecycle). Pass waitForCompletion: true for the legacy synchronous mode, which holds the request open and answers 200 with the relay result (txHash, gasUsed, feeWei). Local-only signing (a non-EVM chain with addressIndex; nothing is broadcast) always answers 200 with the signed transaction. Requires the wallet.hd.sign capability and an Idempotency-Key header. See Idempotency.
curl --request POST \
--url https://dev.api.withconvexity.com/v1/wallet/hd/sign \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"chainType": "EVM",
"chainId": 8453,
"addressIndex": 12,
"transaction": {
"to": "0x2222222222222222222222222222222222222222",
"value": "0",
"data": "0xa9059cbb…"
},
"webhookUrl": "https://example.com/hooks/wallet",
"webhookSecret": "a-secret-you-generate-and-keep"
}
'{
"status": true,
"message": "Transaction signed successfully",
"data": {
"signedTransaction": "0x02f8b18221058084...c0a0e1"
}
}Headers
Unique client-generated key (use a UUID) that makes this request safe to retry. A retry sent with the same key returns the original result instead of submitting again. See Idempotency.
Body
Optional. POST the final transaction here once execution settles (wallet.sign.completed / wallet.sign.failed). HTTPS only in production; private/internal hosts rejected. Delivery is signed and retried. See Outcome webhook.
2048Response
OK
The response is of type object.
