Compose instructions and generate a quote

curl --request POST \
  --url https://api.biconomy.io/v1/quote \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "mode": "smart-account",
  "ownerAddress": "0x0a7C906832544293a6018bA25280c7f7b0Bbf120",
  "composeFlows": [
    {
      "type": "/instructions/build",
      "data": {
        "to": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "chainId": 8453,
        "functionSignature": "function transfer(address to, uint256 amount)",
        "args": [
          "<unknown>"
        ],
        "value": "0",
        "gasLimit": "50000"
      },
      "batch": true
    }
  ],
  "authorizations": [
    {
      "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "chainId": 8453,
      "nonce": 38,
      "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
      "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
      "yParity": 1,
      "v": "28"
    }
  ],
  "fundingTokens": [
    {
      "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainId": 1,
      "amount": "1000000000"
    }
  ],
  "feeToken": {
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "chainId": 1,
    "gasRefundAddress": "0x0a7C906832544293a6018bA25280c7f7b0Bbf120"
  },
  "cleanUps": [
    {
      "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainId": 1,
      "recipientAddress": "0x0a7C906832544293a6018bA25280c7f7b0Bbf120",
      "amount": "1000000",
      "gasLimit": "150000"
    }
  ],
  "gasLimit": "12345678901234567890",
  "lowerBoundTimestamp": 1710000000,
  "upperBoundTimestamp": 1710003600,
  "simulate": true,
  "simulationOverrides": {
    "tokenOverrides": [],
    "customOverrides": []
  }
}
'

{
  "ownerAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "fee": {
    "amount": "10000000000000000",
    "token": "0x0000000000000000000000000000000000000000",
    "chainId": 8453
  },
  "quoteType": "permit",
  "quote": {
    "hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
    "node": "0x9876543210abcdef9876543210abcdef98765432",
    "commitment": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
    "paymentInfo": {
      "sender": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
      "initCode": "0x1234abcd",
      "nonce": "0",
      "token": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "chainId": 1,
      "shortEncoding": false,
      "tokenValue": "1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)",
      "tokenWeiAmount": "1000000000000000000000 (1000 ether), 250000 (0.25 USDC)",
      "verificationGasLimit": "21000",
      "eoa": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "eip7702Auth": {
        "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
        "chainId": 8453,
        "nonce": 38,
        "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
        "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
        "yParity": 1,
        "v": "28"
      },
      "callGasLimit": "50000",
      "sponsored": true,
      "sponsorshipUrl": "https://sponsorship.abc.org",
      "tokenAmount": "1000 (1000 USDC), 1 (1 ether)",
      "gasFee": "21000000000000000",
      "orchestrationFee": "1000000000000000"
    },
    "userOps": [
      {
        "userOp": {
          "sender": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "nonce": "0",
          "callData": "0x1234abcd",
          "callGasLimit": "21000",
          "verificationGasLimit": "100000",
          "preVerificationGas": "21000",
          "maxFeePerGas": "1000000000",
          "maxPriorityFeePerGas": "100000000",
          "initCode": "0x1234abcd",
          "paymasterAndData": "0x",
          "signature": "0xabcdef123456"
        },
        "userOpHash": "0x1234abcd5678ef90",
        "meeUserOpHash": "0xabcdef1234567890",
        "lowerBoundTimestamp": 1710000000,
        "upperBoundTimestamp": 1710003600,
        "maxGasLimit": "1000000",
        "maxFeePerGas": "1000000000",
        "chainId": 8453,
        "eip7702Auth": {
          "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "chainId": 8453,
          "nonce": 38,
          "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
          "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
          "yParity": 1,
          "v": "28"
        },
        "isCleanUpUserOp": false,
        "shortEncoding": true
      }
    ],
    "fundingTokens": [
      {
        "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chainId": 1,
        "amount": "1000000000"
      }
    ]
  },
  "payloadToSign": [
    {
      "signablePayload": {
        "types": {},
        "message": {
          "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
          "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
          "value": "1000000000000000000000",
          "nonce": "0",
          "deadline": "1647857449"
        },
        "primaryType": "Permit",
        "domain": {
          "name": "USD Coin",
          "version": "2",
          "chainId": 1,
          "verifyingContract": "0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B",
          "salt": "0x0000000000000000000000000000000000000000000000000000000000000000"
        }
      },
      "metadata": {
        "nonce": "0",
        "name": "USD Coin",
        "version": "2",
        "domainSeparator": "0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335",
        "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
        "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
        "amount": "1000000000000000000000"
      }
    }
  ],
  "instructions": [
    {
      "calls": [
        {
          "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "value": "0",
          "functionSig": "transfer(address,uint256)",
          "inputParams": [
            {
              "fetcherType": 0,
              "paramData": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
              "constraints": []
            }
          ],
          "outputParams": [
            {
              "fetcherType": 0,
              "paramData": "0x"
            }
          ],
          "gasLimit": "100000"
        }
      ],
      "chainId": 1,
      "isComposable": true
    }
  ],
  "returnedData": [
    "<unknown>"
  ]
}

POST

quote

curl --request POST \
  --url https://api.biconomy.io/v1/quote \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "mode": "smart-account",
  "ownerAddress": "0x0a7C906832544293a6018bA25280c7f7b0Bbf120",
  "composeFlows": [
    {
      "type": "/instructions/build",
      "data": {
        "to": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "chainId": 8453,
        "functionSignature": "function transfer(address to, uint256 amount)",
        "args": [
          "<unknown>"
        ],
        "value": "0",
        "gasLimit": "50000"
      },
      "batch": true
    }
  ],
  "authorizations": [
    {
      "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "chainId": 8453,
      "nonce": 38,
      "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
      "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
      "yParity": 1,
      "v": "28"
    }
  ],
  "fundingTokens": [
    {
      "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainId": 1,
      "amount": "1000000000"
    }
  ],
  "feeToken": {
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "chainId": 1,
    "gasRefundAddress": "0x0a7C906832544293a6018bA25280c7f7b0Bbf120"
  },
  "cleanUps": [
    {
      "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainId": 1,
      "recipientAddress": "0x0a7C906832544293a6018bA25280c7f7b0Bbf120",
      "amount": "1000000",
      "gasLimit": "150000"
    }
  ],
  "gasLimit": "12345678901234567890",
  "lowerBoundTimestamp": 1710000000,
  "upperBoundTimestamp": 1710003600,
  "simulate": true,
  "simulationOverrides": {
    "tokenOverrides": [],
    "customOverrides": []
  }
}
'

{
  "ownerAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "fee": {
    "amount": "10000000000000000",
    "token": "0x0000000000000000000000000000000000000000",
    "chainId": 8453
  },
  "quoteType": "permit",
  "quote": {
    "hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
    "node": "0x9876543210abcdef9876543210abcdef98765432",
    "commitment": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
    "paymentInfo": {
      "sender": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
      "initCode": "0x1234abcd",
      "nonce": "0",
      "token": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "chainId": 1,
      "shortEncoding": false,
      "tokenValue": "1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)",
      "tokenWeiAmount": "1000000000000000000000 (1000 ether), 250000 (0.25 USDC)",
      "verificationGasLimit": "21000",
      "eoa": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "eip7702Auth": {
        "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
        "chainId": 8453,
        "nonce": 38,
        "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
        "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
        "yParity": 1,
        "v": "28"
      },
      "callGasLimit": "50000",
      "sponsored": true,
      "sponsorshipUrl": "https://sponsorship.abc.org",
      "tokenAmount": "1000 (1000 USDC), 1 (1 ether)",
      "gasFee": "21000000000000000",
      "orchestrationFee": "1000000000000000"
    },
    "userOps": [
      {
        "userOp": {
          "sender": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "nonce": "0",
          "callData": "0x1234abcd",
          "callGasLimit": "21000",
          "verificationGasLimit": "100000",
          "preVerificationGas": "21000",
          "maxFeePerGas": "1000000000",
          "maxPriorityFeePerGas": "100000000",
          "initCode": "0x1234abcd",
          "paymasterAndData": "0x",
          "signature": "0xabcdef123456"
        },
        "userOpHash": "0x1234abcd5678ef90",
        "meeUserOpHash": "0xabcdef1234567890",
        "lowerBoundTimestamp": 1710000000,
        "upperBoundTimestamp": 1710003600,
        "maxGasLimit": "1000000",
        "maxFeePerGas": "1000000000",
        "chainId": 8453,
        "eip7702Auth": {
          "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "chainId": 8453,
          "nonce": 38,
          "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
          "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
          "yParity": 1,
          "v": "28"
        },
        "isCleanUpUserOp": false,
        "shortEncoding": true
      }
    ],
    "fundingTokens": [
      {
        "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chainId": 1,
        "amount": "1000000000"
      }
    ]
  },
  "payloadToSign": [
    {
      "signablePayload": {
        "types": {},
        "message": {
          "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
          "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
          "value": "1000000000000000000000",
          "nonce": "0",
          "deadline": "1647857449"
        },
        "primaryType": "Permit",
        "domain": {
          "name": "USD Coin",
          "version": "2",
          "chainId": 1,
          "verifyingContract": "0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B",
          "salt": "0x0000000000000000000000000000000000000000000000000000000000000000"
        }
      },
      "metadata": {
        "nonce": "0",
        "name": "USD Coin",
        "version": "2",
        "domainSeparator": "0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335",
        "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
        "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
        "amount": "1000000000000000000000"
      }
    }
  ],
  "instructions": [
    {
      "calls": [
        {
          "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "value": "0",
          "functionSig": "transfer(address,uint256)",
          "inputParams": [
            {
              "fetcherType": 0,
              "paramData": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
              "constraints": []
            }
          ],
          "outputParams": [
            {
              "fetcherType": 0,
              "paramData": "0x"
            }
          ],
          "gasLimit": "100000"
        }
      ],
      "chainId": 1,
      "isComposable": true
    }
  ],
  "returnedData": [
    "<unknown>"
  ]
}

Authorizations

X-API-Key

string

header

required

API Key required to access Supertransaction API. Example: mee_2w3mXCuyt4xVXDRCZ5k5Lhgs

Body

application/json

Body

Combine compose flows with quote configuration to compose instructions and generate a quote in a single call.

mode

enum<string>

required

Available options:

smart-account,

eoa,

eoa-7702

ownerAddress

string

required

EOA wallet address which is used as owner of the orchestrator account

Example:

"0x0a7C906832544293a6018bA25280c7f7b0Bbf120"

composeFlows

object[]

required

Required array length: 1 - 10 elements

This enable developers to specify a build, intent-simple, or intent operation

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

composeFlows.type

string

required

Compose flow for the "build" type to generate composable MEE instructions from a custom specification.

Allowed value: "/instructions/build"

Example:

"/instructions/build"

composeFlows.data

object

required

Request to build composable instructions from ABI signature and arguments

Show child attributes

composeFlows.data.to

string

required

Target contract address

Example:

"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"

composeFlows.data.chainId

number

required

Chain ID where the transaction will be executed

Example:

8453

composeFlows.data.functionSignature

string

required

Function signature string (e.g., "function approve(address spender, uint256 amount)")

Example:

"function transfer(address to, uint256 amount)"

composeFlows.data.args

any[]

required

composeFlows.data.value

string

Native token value in wei

Example:

"0"

composeFlows.data.gasLimit

string

Gas limit for the transaction

Example:

"50000"

composeFlows.batch

boolean

Flag to enable or disable instructions batching. By default, batching is enabled

Example:

true

authorizations

object[]

Show child attributes

authorizations.address

string

required

The EVM address of the delegation contract to which your EOA (Externally Owned Account) is being upgraded. Must be a valid checksummed Ethereum address.

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

authorizations.chainId

number

required

The chain ID for which this authorization is valid. Use 0 for multichain or specify a supported chain ID.

Example:

8453

authorizations.nonce

number

required

Signature nonce

Example:

38

authorizations.r

string

required

The "r" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded"

authorizations.s

string

required

The "s" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1"

authorizations.yParity

number

required

The y-parity value (EIP-2098) for the signature. Should be 0 or 1.

Example:

1

authorizations.v

string

The "v" value of the ECDSA signature (recovery id), as a string. Optional for EIP-2098 signatures.

Example:

"28"

fundingTokens

object[]

Show child attributes

fundingTokens.tokenAddress

string

required

Contract address of the token that will be deposited into the Nexus smart account.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

fundingTokens.chainId

number

required

Chain ID where the funding token resides. Use a supported chain ID.

Example:

1

fundingTokens.amount

string

required

Amount of funding token in wei/smallest unit to deposit.

Example:

"1000000000"

feeToken

object

Optional fee token configuration. If not specified, sponsorship will be used.

Show child attributes

feeToken.address

string

required

Contract address of the token used to pay MEE execution fees

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

feeToken.chainId

number

required

Chain ID where the fee token resides. Use a supported chain ID.

Example:

1

feeToken.gasRefundAddress

string

Custom gas refund address to receive remaining unspent gas. Defaults to owner address. Gas refunds are always in ETH and may be refunded on multiple chains depending on userOps involved.

Example:

"0x0a7C906832544293a6018bA25280c7f7b0Bbf120"

cleanUps

object[]

Optional cleanup configurations for intermediate tokens

Show child attributes

cleanUps.tokenAddress

string

required

Address of the token to cleanup

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

cleanUps.chainId

number

required

Chain ID where the token cleanup should occur

Example:

1

cleanUps.recipientAddress

string

required

Address to receive the cleanup tokens

Example:

"0x0a7C906832544293a6018bA25280c7f7b0Bbf120"

cleanUps.amount

string

Amount to cleanup in wei. If not specified, uses runtime balance (entire balance).

Example:

"1000000"

cleanUps.gasLimit

string

Custom gas limit for cleanup userOp

Example:

"150000"

gasLimit

string

Optional gas limit override for the gas userop.

Example:

"12345678901234567890"

lowerBoundTimestamp

number

The lower bound timestamp for the user operation.

Example:

1710000000

upperBoundTimestamp

number

The upper bound timestamp for the user operation.

Example:

1710003600

simulate

boolean

simulationOverrides

object

Show child attributes

simulationOverrides.tokenOverrides

object[]

required

Show child attributes

simulationOverrides.tokenOverrides.tokenAddress

string

required

Address of the token to override the balance for.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

simulationOverrides.tokenOverrides.chainId

number

required

Chain ID where the token override should occur

Example:

1

simulationOverrides.tokenOverrides.balance

string

required

Balance of the token to override the balance for, in wei/smallest unit.

Example:

"1000000000"

simulationOverrides.tokenOverrides.accountAddress

string

Address of the account to override the balance for.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

simulationOverrides.customOverrides

object[]

required

Show child attributes

simulationOverrides.customOverrides.contractAddress

string

required

Address of the contract to override the storage slot for.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

simulationOverrides.customOverrides.storageSlot

string

required

Storage slot to override the value for.

Example:

"0x1234567890123456789012345678901234567890123456789012345678901234"

simulationOverrides.customOverrides.chainId

number

required

Chain ID where the storage slot override should occur

Example:

1

simulationOverrides.customOverrides.value

string

required

Value to override the storage slot for.

Example:

"0x1234567890123456789012345678901234567890"

Response

Combined response containing composed instructions and the resulting MEE quote.

ownerAddress

string

required

Owner wallet address which will be used as a owner of orchestrator account

Example:

"0x1234567890abcdef1234567890abcdef12345678"

fee

object

required

Fee details: amount, token address, and chain ID.

Show child attributes

fee.amount

string

required

Fee amount for the quote in wei.

Example:

"10000000000000000"

fee.token

string

required

EVM address of the fee token (zero address for native ETH).

Example:

"0x0000000000000000000000000000000000000000"

fee.chainId

number

required

Chain ID where the fee token resides.

Example:

8453

quoteType

enum<string>

required

Type of MEE signature: permit, onchain, simple, permit-sca, or mm-dtk.

Available options:

permit,

onchain,

simple,

permit-sca,

mm-dtk

Example:

"permit"

quote

object

required

MEE network compatible quote information

Show child attributes

quote.hash

string

required

Supertransaction hash of the quote.

Example:

"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef"

quote.node

string

required

EVM address of the node providing the quote.

Example:

"0x9876543210abcdef9876543210abcdef98765432"

quote.commitment

string

required

Node's commitment hash for the supertransaction quote (hex string, 0x-prefixed).

Example:

"0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"

quote.paymentInfo

object

required

Show child attributes

quote.paymentInfo.sender

string

required

Sender EVM address (optional)

Example:

"0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4"

quote.paymentInfo.initCode

string

default:0x

required

Init code as hex string (optional)

Example:

"0x1234abcd"

quote.paymentInfo.nonce

string

required

Nonce as string (optional)

Example:

"0"

quote.paymentInfo.token

string

required

Payment token address

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.paymentInfo.chainId

number

required

Chain ID of the payment token

Example:

1

quote.paymentInfo.shortEncoding

boolean

default:false

required

Short encoding flag (default: false)

Example:

false

quote.paymentInfo.tokenValue

string

required

Token value as string in USD

Example:

"1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)"

quote.paymentInfo.tokenWeiAmount

string

required

Token wei amount as string (optional)

Example:

"1000000000000000000000 (1000 ether), 250000 (0.25 USDC)"

quote.paymentInfo.verificationGasLimit

string

Verification gas limit as string (optional)

Example:

"21000"

quote.paymentInfo.eoa

string

EOA address (optional)

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.paymentInfo.eip7702Auth

object

Object containing the EIP-7702 authorization signature fields for delegation, including the signer address, chain ID, nonce, and ECDSA signature components (r, s, v/yParity). Used to prove delegation intent and validity.

Show child attributes

quote.paymentInfo.eip7702Auth.address

string

required

The EVM address of the delegation contract to which your EOA (Externally Owned Account) is being upgraded. Must be a valid checksummed Ethereum address.

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.paymentInfo.eip7702Auth.chainId

number

required

The chain ID for which this authorization is valid. Use 0 for multichain or specify a supported chain ID.

Example:

8453

quote.paymentInfo.eip7702Auth.nonce

number

required

Signature nonce

Example:

38

quote.paymentInfo.eip7702Auth.r

string

required

The "r" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded"

quote.paymentInfo.eip7702Auth.s

string

required

The "s" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1"

quote.paymentInfo.eip7702Auth.yParity

number

required

The y-parity value (EIP-2098) for the signature. Should be 0 or 1.

Example:

1

quote.paymentInfo.eip7702Auth.v

string

The "v" value of the ECDSA signature (recovery id), as a string. Optional for EIP-2098 signatures.

Example:

"28"

quote.paymentInfo.callGasLimit

string

Call gas limit as string (optional)

Example:

"50000"

quote.paymentInfo.sponsored

boolean

Sponsored ulr (optional)

Example:

"https://sponsorship.abc.org"

quote.paymentInfo.tokenAmount

string

Token amount as string (optional)

Example:

"1000 (1000 USDC), 1 (1 ether)"

quote.paymentInfo.gasFee

string

Gas fee as string (optional)

Example:

"21000000000000000"

quote.paymentInfo.orchestrationFee

string

Orchestration fee as string (optional)

Example:

"1000000000000000"

quote.userOps

object[]

required

Array of MEE UserOperation objects for the quote.

Show child attributes

quote.userOps.userOp

object

required

Object containing the fields of a UserOperation, including sender, nonce, calldata, gas limits, and signature.

Show child attributes

quote.userOps.userOp.sender

string

required

The address of the account initiating the user operation.

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.userOps.userOp.nonce

string

required

The nonce of the sender account, as a bigint.

Example:

"0"

quote.userOps.userOp.callData

string

required

The calldata for the user operation, as a hex string.

Example:

"0x1234abcd"

quote.userOps.userOp.callGasLimit

string

required

The gas limit for the call, as a bigint.

Example:

"21000"

quote.userOps.userOp.verificationGasLimit

string

required

The gas limit for verification, as a bigint.

Example:

"100000"

quote.userOps.userOp.preVerificationGas

string

required

The gas used before verification, as a bigint.

Example:

"21000"

quote.userOps.userOp.maxFeePerGas

string

required

The maximum fee per gas, as a bigint.

Example:

"1000000000"

quote.userOps.userOp.maxPriorityFeePerGas

string

required

The maximum priority fee per gas, as a bigint.

Example:

"100000000"

quote.userOps.userOp.initCode

string

The initCode for contract creation, as a hex string. Optional.

Example:

"0x1234abcd"

quote.userOps.userOp.paymasterAndData

string

The paymaster and data field, as a hex string. Optional.

Example:

"0x"

quote.userOps.userOp.signature

string

The signature for the user operation, as a hex string. Optional.

Example:

"0xabcdef123456"

quote.userOps.userOpHash

string

required

The hash of the user operation.

Example:

"0x1234abcd5678ef90"

quote.userOps.meeUserOpHash

string

required

The MEE-specific hash of the user operation.

Example:

"0xabcdef1234567890"

quote.userOps.lowerBoundTimestamp

number

required

The lower bound timestamp for the user operation.

Example:

1710000000

quote.userOps.upperBoundTimestamp

number

required

The upper bound timestamp for the user operation.

Example:

1710003600

quote.userOps.maxGasLimit

string

required

The maximum gas limit for the user operation.

Example:

"1000000"

quote.userOps.maxFeePerGas

string

required

The maximum fee per gas for the user operation.

Example:

"1000000000"

quote.userOps.chainId

number

required

The chain ID for the user operation.

Example:

8453

quote.userOps.eip7702Auth

object

Show child attributes

quote.userOps.eip7702Auth.address

string

required

The EVM address of the delegation contract to which your EOA (Externally Owned Account) is being upgraded. Must be a valid checksummed Ethereum address.

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.userOps.eip7702Auth.chainId

number

required

The chain ID for which this authorization is valid. Use 0 for multichain or specify a supported chain ID.

Example:

8453

quote.userOps.eip7702Auth.nonce

number

required

Signature nonce

Example:

38

quote.userOps.eip7702Auth.r

string

required

The "r" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded"

quote.userOps.eip7702Auth.s

string

required

The "s" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1"

quote.userOps.eip7702Auth.yParity

number

required

The y-parity value (EIP-2098) for the signature. Should be 0 or 1.

Example:

1

quote.userOps.eip7702Auth.v

string

The "v" value of the ECDSA signature (recovery id), as a string. Optional for EIP-2098 signatures.

Example:

"28"

quote.userOps.isCleanUpUserOp

boolean

Whether this is a clean-up user operation.

Example:

false

quote.userOps.shortEncoding

boolean

Whether the user operation uses short encoding.

Example:

true

quote.fundingTokens

object[]

Optional array of funding tokens for token pull execution.

Show child attributes

quote.fundingTokens.tokenAddress

string

required

Contract address of the token that will be deposited into the Nexus smart account.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

quote.fundingTokens.chainId

number

required

Chain ID where the funding token resides. Use a supported chain ID.

Example:

1

quote.fundingTokens.amount

string

required

Amount of funding token in wei/smallest unit to deposit.

Example:

"1000000000"

payloadToSign

object[]

required

Array of payloads to be signed, structure depends on the quoteType.

Minimum array length: 1

Full EIP-712 permit signature data (payload and metadata)

Option 1
Option 2
Option 3

Show child attributes

payloadToSign.signablePayload

object

required

Payload to be signed for EIP-712 permit

Show child attributes

payloadToSign.signablePayload.types

object

required

Show child attributes

payloadToSign.signablePayload.types.{key}

object[]

List of fields for this struct

Show child attributes

payloadToSign.signablePayload.types.{key}.name

string

required

A string value.

Example:

"owner"

payloadToSign.signablePayload.types.{key}.type

string

required

A string value.

Example:

"address"

Example:

[
  { "name": "owner", "type": "address" },
  { "name": "spender", "type": "address" },
  { "name": "value", "type": "uint256" },
  { "name": "nonce", "type": "uint256" },
  { "name": "deadline", "type": "uint256" }
]

payloadToSign.signablePayload.message

object

required

Key-value pairs for the EIP-712 message

Show child attributes

payloadToSign.signablePayload.message.{key}

any

Example:

{
  "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
  "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
  "value": "1000000000000000000000",
  "nonce": "0",
  "deadline": "1647857449"
}

payloadToSign.signablePayload.primaryType

string

required

Name of the main EIP-712 struct to sign (e.g. 'Permit')

Example:

"Permit"

payloadToSign.signablePayload.domain

object

EIP-712 domain object

Show child attributes

payloadToSign.signablePayload.domain.name

string

Token or contract name (e.g. 'USD Coin')

Example:

"USD Coin"

payloadToSign.signablePayload.domain.version

string

Contract version (e.g. '1')

Example:

"2"

payloadToSign.signablePayload.domain.chainId

number

EVM chain ID (e.g. 1 for Ethereum mainnet)

Example:

1

payloadToSign.signablePayload.domain.verifyingContract

string

Address of the contract being verified

Example:

"0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B"

payloadToSign.signablePayload.domain.salt

string

Optional domain salt (hex string)

Example:

"0x0000000000000000000000000000000000000000000000000000000000000000"

payloadToSign.metadata

object

required

Extra metadata for the permit signature

Show child attributes

payloadToSign.metadata.nonce

string

required

Permit nonce (as string)

Example:

"0"

payloadToSign.metadata.name

string

required

Token or contract name

Example:

"USD Coin"

payloadToSign.metadata.version

string

required

Contract version

Example:

"2"

payloadToSign.metadata.domainSeparator

string

required

EIP-712 domain separator (hex string)

Example:

"0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335"

payloadToSign.metadata.owner

string

required

Address of the permit owner

Example:

"0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4"

payloadToSign.metadata.spender

string

required

Address of the spender

Example:

"0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45"

payloadToSign.metadata.amount

string

required

Permit amount in wei (as string)

Example:

"1000000000000000000000"

instructions

object[]

required

Show child attributes

instructions.calls

object[]

required

Show child attributes

instructions.calls.to

string

required

EVM address of the target smart contract to invoke for this call.

Example:

"0x1111111254EEB25477B68fb85Ed929f73A960582"

instructions.calls.value

string

required

Amount of native token (in wei) to send with the contract call. Must be a non-negative integer.

Example:

"0"

instructions.calls.functionSig

string

required

Function signature as a string, e.g. "transfer(address,uint256)". Must match the target contract ABI.

Example:

"transfer(address,uint256)"

instructions.calls.inputParams

object[]

required

Show child attributes

instructions.calls.inputParams.fetcherType

enum<number>

required

Available options:

0,

1

instructions.calls.inputParams.paramData

string

required

String representing the input parameter data, such as ABI-encoded bytes or a direct value.

Example:

"example string"

instructions.calls.inputParams.constraints

object[]

required

Show child attributes

instructions.calls.inputParams.constraints.constraintType

enum<number>

required

Available options:

0,

1,

2,

3

instructions.calls.inputParams.constraints.referenceData

string

required

String data used as the reference for the constraint, such as a literal value or ABI-encoded data.

Example:

"example string"

Example:

[
  {
    "fetcherType": 0,
    "paramData": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
    "constraints": []
  }
]

instructions.calls.outputParams

object[]

required

Show child attributes

instructions.calls.outputParams.fetcherType

enum<number>

required

Available options:

0,

1

instructions.calls.outputParams.paramData

string

required

String representing the output parameter data, such as ABI-encoded bytes or a result value.

Example:

"example string"

Example:

[{ "fetcherType": 0, "paramData": "0x" }]

instructions.calls.gasLimit

string

Gas limit for the contract call. Optional - if not provided, it will be estimated.

Example:

"100000"

instructions.chainId

number

required

Chain ID on which this instruction should be executed. Must be a supported EVM chain ID.

Example:

1

instructions.isComposable

boolean

Indicates if this instruction is composable with others in the same execution batch.

Example:

true

returnedData

any[]

required

4. Execute Workflow Submit the supertransaction for execution

⌘I

About Supertransaction API

Building Workflow Instructions

Executing Workflows

API Reference

Compose instructions and generate a quote

Authorizations

Body

Response