Skip to main content
POST
cURL

Overview

The BuildIntentRecoveryTransaction endpoint verifies a signed recovery payload (produced via PrepareIntentRecovery) and returns executable transaction data the client can broadcast. The transaction sweeps recoverable balances from a stranded intent wallet to the configured refund address.

Request Parameters

Required Fields

  • intentId (string): The unique ID of the intent being recovered.
  • payload (any): The payload returned by PrepareIntentRecovery.
  • signature (string): User signature over the typed data from PrepareIntentRecovery.
  • intentAddress (string): The intent wallet to recover from (matches PrepareIntentRecovery response).

Optional Fields

  • refundToAddress (string): Defaults to the intent owner address when omitted.

Response

  • to (string): Transaction to address.
  • data (string): Transaction calldata.
  • value (string): Transaction value (bigint).
  • chainId (number): Chain to broadcast on.
  • intentAddress (string)
  • requiresDeploy (boolean): true if the intent wallet must be counterfactually deployed as part of this transaction.
  • payloadHash (string, optional)

Example

Next Steps

PrepareIntentRecovery

Generate the payload to sign

GetIntent

Check intent state after recovery

Body

application/json
intentId
string
required
payload
object
required
signature
string
required
intentAddress
string
required
refundToAddress
string

Response

OK

to
string
required
data
string
required
value
string
required
chainId
number
required
intentAddress
string
required
requiresDeploy
boolean
required
payloadHash
string