fetchPermission

Retrieve a single Spend Permission by its hash

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

Fetch single permission

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