Transactions

List transactions.

Changed on

Returns a list of transactions, most recent first.

get/v2/transactions

Request

  • Base URL: https://api.openfort.io
  • URL: https://api.openfort.io/v2/transactions
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Query parameters

limitinteger

Specifies the maximum number of records to return.

skipinteger

Specifies the offset for the first records to return.

order'asc' | 'desc'

Specifies the order in which to sort the results.

expandTransactionExpandableV2[]

Specifies the fields to expand in the response. timeline adds the lifecycle history (one monitor lookup per request); userOperation and logs add the heavyweight execution payload and receipt logs, which are otherwise omitted.

chainIdinteger

The chain ID. Must be a supported chain.

accountIdstring[]

Filter by account ID (starts with acc_).

userIdstring[]

Filter by user ID (starts with usr_).

walletIdstring[]

Filter by wallet ID (starts with pla_).

feeSponsorshipIdstring[]

Filter by fee sponsorship ID (starts with pol_).

status'awaiting_signature' | 'submitted' | 'succeeded' | 'reverted' | 'failed'

Filter by transaction status.

Response

Successful response.

object'list' required
urlstring required
startinteger required
endinteger required
totalinteger required

Example response

{
  "data": [
    {
      "chainId": 80002,
      "accountId": "acc_e1b24353-1741-4a3d-9e91-2b0fd2942f60",
      "walletId": "pla_6f6c9067-89fa-4fc8-ac72-c242a268c584",
      "feeSponsorshipId": "pol_7e07ae30-2a4d-48fa-803f-361da94905dd",
      "account": {
        "custody": "Developer"
      },
      "feeSponsorship": {
        "name": "My DeFi Gas Sponsorship",
        "description": "Sponsors gas for free-tier users",
        "chainId": 8453,
        "enabled": true,
        "strategy": {
          "sponsorSchema": "pay_for_user",
          "tokenContract": "con_48eeba57-2cd5-4159-a2cb-057a23a35e65",
          "tokenContractAmount": "1000000000000000000",
          "dynamicExchangeRate": true,
          "splTokens": [
            "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          ],
          "tokenContracts": [
            {
              "contract": "con_48eeba57-2cd5-4159-a2cb-057a23a35e65",
              "amount": "1000000000000000000"
            }
          ]
        },
        "paymasterId": "pay_48eeba57-2cd5-4159-a2cb-057a23a35e65",
        "forwarderContractId": "cfo_48eeba57-2cd5-4159-a2cb-057a23a35e65",
        "policyId": "ply_48eeba57-2cd5-4159-a2cb-057a23a35e65"
      },
      "calls": [
        {
          "to": "0x3994801f2BF191D22aA60c2ce3728c4D0e856a7B",
          "value": "1000000000000000000",
          "contractId": "con_0cddb398-1dc6-4e6f-8726-9ec7cea85f35",
          "functionName": "mint"
        }
      ],
      "execution": {
        "entryPointVersion": "0.8"
      },
      "nextAction": {
        "hash": "0x1a3d1d2fbb8a9c1a3f0f7d2b6c4a8b2b1e1d5c9a7f3e2b1c0d9e8f7a6b5c4d3e"
      },
      "receipt": {
        "error": {
          "reason": "AA31: paymaster deposit too low",
          "name": "ExecutionResult",
          "explanation": {
            "cause": "The paymaster does not have enough native tokens deposited in the EntryPoint to cover the gas cost.",
            "solution": "Top up your account balance in the dashboard or deposit more to the Paymaster contract on the relevant chain."
          }
        }
      },
      "costUsd": "0.42"
    }
  ]
}

Changes

  • ed27009e33a9Revision changes
    • breaking

      the /// response's property type changed from no type to object for status

    • breaking

      removed the required property /// from the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

  • 5a79c9209871Revision changes
    • breaking

      removed the enum value user from the property items/ of the query request parameter expand

    • warning

      deleted the query request parameter account

    • warning

      deleted the query request parameter feeSponsorship

    • warning

      deleted the query request parameter user

    • warning

      deleted the query request parameter wallet

    • warning

      removed the optional property // from the response with the status

    • info

      added the new optional query request parameter accountId

    • info

      added the new optional query request parameter feeSponsorshipId

    • info

      added the new optional query request parameter userId

    • info

      added the new optional query request parameter walletId