coinbase_fetchPermissions

Retrieve permissions associated with a specific account, chain, and spender

Coinbase-specific RPC method

Retrieves permissions associated with a specific account, chain, and spender. This method excludes permissions that have expired or been revoked, returning only active spend permissions.

Parameters

account · string · required

The address of the account whose permissions are being queried.

chainId · string · required

The ID of the blockchain, in hexadecimal format.

spender · string · required

The entity granted with the permission to spend the account’s funds.

pageOptions · object

Optional pagination settings for the request.

Show PageOptions properties

pageSize · number

The number of permissions to fetch in a single request. Defaults to 50.

cursor · string

A unique identifier to start fetching from a specific page.

Returns

result · object

The permissions response object.

Show FetchPermissionsResult properties

permissions · array

An array of permission objects.

pageDescription · object

Pagination information for the response.

Request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "coinbase_fetchPermissions",
  "params": [{
    "account": "0xfB2adc8629FC9F54e243377ffcECEb437a42934C",
    "chainId": "0x14A34",
    "spender": "0x2a83b0e4462449660b6e7567b2c81ac6d04d877d"
  }]
}

Success Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "permissions": [
      {
        "createdAt": 1640995200,
        "permissionHash": "0xabc123...",
        "signature": "0xdef456...",
        "spendPermission": {
          "account": "0xfB2adc8629FC9F54e243377ffcECEb437a42934C",
          "spender": "0x2a83b0e4462449660b6e7567b2c81ac6d04d877d",
          "token": "0xA0b86a33E6441b97B7cd5C4F5B42a6e2F8a38923",
          "allowance": "1000000000000000000",
          "period": 86400,
          "start": 1640995200,
          "end": 1672531200,
          "salt": "12345678901234567890",
          "extraData": "0x"
        }
      }
    ],
    "pageDescription": {
      "pageSize": 1,
      "nextCursor": "abc123next"
    }
  }
}

Error Handling

Code	Message	Description
4001	User rejected the request	User denied the permission request
4100	Requested method not supported	The method is not supported by the wallet
-32602	Invalid params	Invalid account, chainId, or spender parameters

Ensure the chainId, account, and spender parameters are correctly formatted and valid for the blockchain you are querying.