fetchPermission - Base Documentation

import { fetchPermission } 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],
});

// Fetch a specific permission by its hash
const permission = await fetchPermission({
  permissionHash: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  provider: sdk.getProvider(),
});

if (permission) {
  console.log('Permission found:', permission);
} else {
  console.log('Permission not found');
}

// Using without explicit provider (uses default SDK provider)
const permission2 = await fetchPermission({
  permissionHash: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
});

Defined in the Base Account SDK

Returns a single spend permission by its unique hash identifier. This is useful when you have a permission hash from a previous operation and need to retrieve its current details.

Parameters

permissionHash

string

required

The unique hash identifier of the permission to retrieve.

provider

EIP1193Provider

Optional. EIP-1193 compliant Ethereum provider instance. Get this from sdk.getProvider(). If not provided, uses the default SDK provider.

Returns

permission

SpendPermission | null

The spend permission matching the hash, or null if not found.

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

import { fetchPermission } 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],
});

// Fetch a specific permission by its hash
const permission = await fetchPermission({
  permissionHash: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  provider: sdk.getProvider(),
});

if (permission) {
  console.log('Permission found:', permission);
} else {
  console.log('Permission not found');
}

// Using without explicit provider (uses default SDK provider)
const permission2 = await fetchPermission({
  permissionHash: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
});

Error Handling

The function returns null if the permission is not found rather than throwing an error. Always check for null values:

const permission = await fetchPermission({
  permissionHash: hash,
});

if (!permission) {
  // Handle permission not found
  console.error('Permission not found');
  return;
}

// Safe to use permission here
console.log('Permission details:', permission);

Usage Notes

This function is particularly useful when:

You have a permission hash from a previous operation (e.g., from requestSpendPermission)
You want to verify the current state of a specific permission
You need to look up permission details without knowing the account or spender information
You’re tracking specific permissions across sessions

Unlike fetchPermissions, this function:

Returns a single permission instead of an array
Does not require account, chain, or spender parameters
Provides direct access via the permission’s unique identifier
Returns null instead of an empty array when no permission is found

fetchPermissions

getPermissionStatus

⌘I

​Parameters

​Returns

​Error Handling

​Usage Notes

Parameters

Returns

Error Handling

Usage Notes