fetchPermissions

Retrieve available Spend Permissions for an account, chain, and spender

Defined in the Base Account SDK

Returns all permissions available to a given spender for a user’s Base Account on a specific chain.

Parameters

account · address · required

User’s Base Account address to query.

chainId · number · required

Target chain ID.

spender · address · required

Spender address you intend to use for spending.

provider · EIP1193Provider · required

EIP-1193 compliant Ethereum provider instance. Get this from sdk.getProvider().

Returns

permissions · SpendPermission[]

Array of spend permissions matching the query.

Show SpendPermission properties

permissionHash · string

Deterministic EIP-712 hash of the permission.

signature · string

Signature for the EIP-712 payload.

chainId · number

Target chain ID.

permission · object

Underlying permission fields.

Show permission fields

account · address

spender · address

token · address

allowance · bigint

period · number

Duration in seconds.

start · number

Unix timestamp (seconds).

end · number

Unix timestamp (seconds).

salt · string

extraData · string

Fetch permissions

import { fetchPermissions } from "@base-org/account/spend-permission";
import { createBaseAccountSDK } from "@base-org/account";

const sdk = createBaseAccountSDK({
  appName: 'My App',
  appLogoUrl: 'https://example.com/logo.png',
  appChainIds: [84532],
});

const permissions = await fetchPermissions({
  account: "0xUserBaseAccountAddress",
  chainId: 84532,
  spender: "0xAppSpenderAddress",
  provider: sdk.getProvider(),
});

Error Handling

Always wrap the call in a try-catch block to handle these errors gracefully.