Skip to main content

ActionSet

Transaction calldata and required approvals returned by action endpoints.

transactions object[]required

Pre-trade setup transactions (e.g. e-mode switch, collateral enable). Execute these before the main swap. Empty when no setup is needed.

  • Array [
    • tostringrequired

    Target contract address

    Example: 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2
    datastringrequired

    Encoded calldata

    Example: 0x617ba037000000000000000000000000c02aaa39b2
    valuestringrequired

    ETH value to send with the transaction

    Example: 0
    descriptionstring

    Human-readable label. For alternatives, this is the aggregator name (e.g. "Paraswap"). For transactions, describes the setup action (e.g. "Switch e-mode to 1").

  • ]
    • alternatives object[]

    DEX aggregator swap transactions sorted by best output (descending). Each entry's description is the aggregator name. The client should pick one to execute. Present on loop action endpoints.

  • Array [
    • tostringrequired

    Target contract address

    Example: 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2
    datastringrequired

    Encoded calldata

    Example: 0x617ba037000000000000000000000000c02aaa39b2
    valuestringrequired

    ETH value to send with the transaction

    Example: 0
    descriptionstring

    Human-readable label. For alternatives, this is the aggregator name (e.g. "Paraswap"). For transactions, describes the setup action (e.g. "Switch e-mode to 1").

  • ]
    • permissions object[]nullable

    Approval/delegation transactions that must execute before both transactions and alternatives. Includes ERC20 allowances (targeting the composer contract) and lender borrow/withdrawal delegations (targeting the lending protocol contract directly). Filtered against on-chain state so only missing approvals are returned. Null when no approvals are needed.

  • Array [
    • tostringrequired

    Target contract address

    datastringrequired

    Encoded calldata

    valuestringrequired

    ETH value

    Example: 0
    descriptionstring

    Human-readable description of the approval (e.g. "Approve borrow for AAVE_V3", "Approve ERC20")

    spenderstring

    ERC-20 approve spender (x-chain permissions). Match it against the selected quote's approvalTarget — several bridges can share one spender, so do not match by description.

  • ]
    • ActionSet
    {
      "transactions": [
        {
          "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
          "data": "0x617ba037000000000000000000000000c02aaa39b2",
          "value": "0",
          "description": "string"
        }
      ],
      "alternatives": [
        {
          "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
          "data": "0x617ba037000000000000000000000000c02aaa39b2",
          "value": "0",
          "description": "string"
        }
      ],
      "permissions": [
        {
          "to": "string",
          "data": "string",
          "value": "0",
          "description": "string",
          "spender": "string"
        }
      ]
    }