Class PoliciesClient

The namespace containing all Policy methods.

Implements

PoliciesClientInterface

Index

Constructors

constructor

Methods

listPolicies createPolicy getPolicyById deletePolicy updatePolicy

Constructors

constructor

new PoliciesClient(): PoliciesClient
Returns PoliciesClient

Methods

listPolicies

listPolicies(options?: ListPoliciesOptions): Promise<ListPoliciesResult>
Lists policies belonging to the developer's CDP Project. Can be filtered by scope (project or account).
Parameters
- Optionaloptions: ListPoliciesOptions = {}
  Options for filtering and paginating the results
  - OptionalpageSize?: number
    The page size to paginate through the accounts.
  - OptionalpageToken?: string
    The page token to paginate through the accounts.
  - Optionalscope?: "project" | "account"
    The scope of the policies to return. If project, the response will include exactly one policy, which is the project-level policy. If account, the response will include all account-level policies for the developer's CDP Project.
Returns Promise<ListPoliciesResult>
A paginated list of policies
Example: **List all policies**
```
         const { policies } = await cdp.policies.listPolicies();
         
```
Example: **Filter by scope**
```
         const { policies } = await cdp.policies.listPolicies({
           scope: 'project'
         });
         
```
Example: **With pagination**
```
         // Get first page
         const firstPage = await cdp.policies.listPolicies({
           pageSize: 10
         });

         // Get next page using cursor
         const nextPage = await cdp.policies.listPolicies({
           pageSize: 10,
           pageToken: firstPage.pageToken
         });
         
```
Implementation of PoliciesClientInterface.listPolicies
- Defined in src/client/policies/policies.ts:63

createPolicy

createPolicy(options: CreatePolicyOptions): Promise<Policy>
Creates a new policy that can be used to govern the behavior of projects and accounts.
Parameters
- options: CreatePolicyOptions
  Options for creating the policy
  
  Options for creating a Policy.
  - OptionalidempotencyKey?: string
    The idempotency key to ensure the request is processed exactly once. Used to safely retry requests without accidentally performing the same operation twice.
  - policy: {
        scope: "project" | "account";
        description?: string;
        rules: (
            | {
                action: "reject"
                | "accept";
                operation: "signEvmTransaction";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "netUSDChange";
                        changeCents: number;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | { action: "reject"
            | "accept"; operation: "signEvmHash" }
            | {
                action: "reject" | "accept";
                operation: "signEvmMessage";
                criteria: { type: "evmMessage"; match: string }[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "signEvmTypedData";
                criteria: (
                    | {
                        type: "evmTypedDataField";
                        types: {
                            types: Record<string, { name: ...; type: ... }[]>;
                            primaryType: string;
                        };
                        conditions: (
                            | { addresses: (...)[]; operator: (...) | (...); path: string }
                            | {
                                value: string;
                                operator: (...) | (...) | (...) | (...) | (...);
                                path: string;
                            }
                            | { match: string; path: string }
                        )[];
                    }
                    | {
                        type: "evmTypedDataVerifyingContract";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "sendEvmTransaction";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmNetwork";
                        networks: (
                            | "base-sepolia"
                            | "base"
                            | "arbitrum"
                            | "optimism"
                            | "polygon"
                            | "avalanche"
                            | "ethereum"
                            | "ethereum-sepolia"
                        )[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "netUSDChange";
                        changeCents: number;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "prepareUserOperation";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmNetwork";
                        networks: (
                            | "base-sepolia"
                            | "base"
                            | "arbitrum"
                            | "optimism"
                            | "zora"
                            | "polygon"
                            | "bnb"
                            | "avalanche"
                            | "ethereum"
                            | "ethereum-sepolia"
                        )[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "sendUserOperation";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "signSolTransaction";
                criteria: (
                    | {
                        type: "solAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solValue";
                        solValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | { type: "splAddress"; addresses: string[]; operator: "in"
                    | "not in" }
                    | {
                        type: "splValue";
                        splValue: string;
                        operator: ">" | ">=" | "<" | "<=" | "==";
                    }
                    | {
                        type: "mintAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solData";
                        idls: (
                            | "SystemProgram"
                            | "TokenProgram"
                            | "AssociatedTokenProgram"
                            | objectOutputType<
                                { address: ...; instructions: ... },
                                ZodTypeAny,
                                "passthrough",
                            >
                        )[];
                        conditions: { instruction: string; params?: (...)[] }[];
                    }
                    | { type: "programId"; programIds: string[]; operator: "in"
                    | "not in" }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "sendSolTransaction";
                criteria: (
                    | {
                        type: "solAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solValue";
                        solValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | { type: "splAddress"; addresses: string[]; operator: "in"
                    | "not in" }
                    | {
                        type: "splValue";
                        splValue: string;
                        operator: ">" | ">=" | "<" | "<=" | "==";
                    }
                    | {
                        type: "mintAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solData";
                        idls: (
                            | "SystemProgram"
                            | "TokenProgram"
                            | "AssociatedTokenProgram"
                            | objectOutputType<
                                { address: ...; instructions: ... },
                                ZodTypeAny,
                                "passthrough",
                            >
                        )[];
                        conditions: { instruction: string; params?: (...)[] }[];
                    }
                    | { type: "programId"; programIds: string[]; operator: "in"
                    | "not in" }
                    | {
                        type: "solNetwork";
                        networks: ("solana-devnet" | "solana")[];
                        operator: "in" | "not in";
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "signSolMessage";
                criteria: { type: "solMessage"; match: string }[];
            }
        )[];
    }
    The policy definition to create. Contains the scope, description, and rules for the policy.
    
    scope: "project" | "account"
    The scope of the policy. "project" applies to the entire project, "account" applies to specific accounts.
    
    Optionaldescription?: string
    An optional human-readable description for the policy. Limited to 50 characters of alphanumeric characters, spaces, commas, and periods.
    
    rules: (
        | {
            action: "reject"
            | "accept";
            operation: "signEvmTransaction";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "netUSDChange";
                    changeCents: number;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | { action: "reject"
        | "accept"; operation: "signEvmHash" }
        | {
            action: "reject" | "accept";
            operation: "signEvmMessage";
            criteria: { type: "evmMessage"; match: string }[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "signEvmTypedData";
            criteria: (
                | {
                    type: "evmTypedDataField";
                    types: {
                        types: Record<string, { name: ...; type: ... }[]>;
                        primaryType: string;
                    };
                    conditions: (
                        | { addresses: (...)[]; operator: (...) | (...); path: string }
                        | {
                            value: string;
                            operator: (...) | (...) | (...) | (...) | (...);
                            path: string;
                        }
                        | { match: string; path: string }
                    )[];
                }
                | {
                    type: "evmTypedDataVerifyingContract";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "sendEvmTransaction";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmNetwork";
                    networks: (
                        | "base-sepolia"
                        | "base"
                        | "arbitrum"
                        | "optimism"
                        | "polygon"
                        | "avalanche"
                        | "ethereum"
                        | "ethereum-sepolia"
                    )[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "netUSDChange";
                    changeCents: number;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "prepareUserOperation";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmNetwork";
                    networks: (
                        | "base-sepolia"
                        | "base"
                        | "arbitrum"
                        | "optimism"
                        | "zora"
                        | "polygon"
                        | "bnb"
                        | "avalanche"
                        | "ethereum"
                        | "ethereum-sepolia"
                    )[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "sendUserOperation";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "signSolTransaction";
            criteria: (
                | {
                    type: "solAddress";
                    addresses: string[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "solValue";
                    solValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | { type: "splAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "splValue";
                    splValue: string;
                    operator: ">" | ">=" | "<" | "<=" | "==";
                }
                | { type: "mintAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "solData";
                    idls: (
                        | "SystemProgram"
                        | "TokenProgram"
                        | "AssociatedTokenProgram"
                        | objectOutputType<
                            { address: ...; instructions: ... },
                            ZodTypeAny,
                            "passthrough",
                        >
                    )[];
                    conditions: { instruction: string; params?: (...)[] }[];
                }
                | { type: "programId"; programIds: string[]; operator: "in"
                | "not in" }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "sendSolTransaction";
            criteria: (
                | {
                    type: "solAddress";
                    addresses: string[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "solValue";
                    solValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | { type: "splAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "splValue";
                    splValue: string;
                    operator: ">" | ">=" | "<" | "<=" | "==";
                }
                | { type: "mintAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "solData";
                    idls: (
                        | "SystemProgram"
                        | "TokenProgram"
                        | "AssociatedTokenProgram"
                        | objectOutputType<
                            { address: ...; instructions: ... },
                            ZodTypeAny,
                            "passthrough",
                        >
                    )[];
                    conditions: { instruction: string; params?: (...)[] }[];
                }
                | { type: "programId"; programIds: string[]; operator: "in"
                | "not in" }
                | {
                    type: "solNetwork";
                    networks: ("solana-devnet" | "solana")[];
                    operator: "in" | "not in";
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "signSolMessage";
            criteria: { type: "solMessage"; match: string }[];
        }
    )[]
    Array of rules that comprise the policy. Limited to a maximum of 10 rules per policy.
Returns Promise<Policy>
The created policy
Throws
When the policy is invalid
Example: **Creating a new EVM policy**
```
         const policy = await cdp.policies.createPolicy({
           policy: {
             scope: "account",
             description: "Limits the amount of ETH in transaction",
             rules: [
               {
                 action: "reject",
                 operation: "signEvmTransaction",
                 criteria: [
                   {
                     type: "ethValue",
                     ethValue: "1000000000000000000",
                     operator: ">",
                   },
                 ],
               },
             ],
           }
         });
         
```
Example: **Creating a new Solana policy**
```
         const policy = await cdp.policies.createPolicy({
           policy: {
             scope: "account",
             description: "Limits SOL transfers and SPL token operations",
             rules: [
               {
                 action: "reject",
                 operation: "signSolTransaction",
                 criteria: [
                   {
                     type: "solValue",
                     solValue: "1000000000", // 1 SOL in lamports
                     operator: ">",
                   },
                   {
                     type: "solAddress",
                     addresses: ["9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin"],
                     operator: "in",
                   },
                 ],
               },
               {
                 action: "accept",
                 operation: "sendSolTransaction",
                 criteria: [
                   {
                     type: "mintAddress",
                     addresses: ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"], // USDC mint
                     operator: "in",
                   },
                 ],
               },
             ],
           }
         });
         
```
Example: **With idempotency key**
```
         const idempotencyKey = uuidv4();

         // First call creates the policy
         const policy = await cdp.policies.createPolicy({
           policy: {
             scope: "account",
             description: "Limits the amount of ETH in transaction",
             rules: [
               {
                 action: "reject",
                 operation: "signEvmTransaction",
                 criteria: [
                   {
                     type: "ethValue",
                     ethValue: "1000000000000000000",
                     operator: ">",
                   },
                 ],
               },
             ],
           },
           idempotencyKey
         });

         // Second call with same key returns the same policy
         const samePolicy = await cdp.policies.createPolicy({
           policy: { ... },
           idempotencyKey
         });
         
```
Implementation of PoliciesClientInterface.createPolicy
- Defined in src/client/policies/policies.ts:181

getPolicyById

getPolicyById(options: GetPolicyByIdOptions): Promise<Policy>
Retrieves a policy by its unique identifier.
Parameters
- options: GetPolicyByIdOptions
  Options containing the policy ID to retrieve
  
  Options for retrieving a Policy by ID.
  - id: string
    The unique identifier of the policy to retrieve. This is a UUID that's generated when the policy is created.
Returns Promise<Policy>
The requested policy
Example: **Retrieving a policy by ID**
```
         const policy = await cdp.policies.getPolicyById({
           id: "__ID__"
         });

         console.log(policy.name);
         console.log(policy.rules);
         
```
Implementation of PoliciesClientInterface.getPolicyById
- Defined in src/client/policies/policies.ts:216

deletePolicy

deletePolicy(options: DeletePolicyOptions): Promise<void>
Deletes a policy by its unique identifier. If a policy is referenced by an active project or account, this operation will fail.
Parameters
- options: DeletePolicyOptions
  Options containing the policy ID to delete
  
  Options for deleting a Policy.
  - id: string
    The unique identifier of the policy to delete. This is a UUID that's generated when the policy is created.
  - OptionalidempotencyKey?: string
    The idempotency key to ensure the request is processed exactly once. Used to safely retry requests without accidentally performing the same operation twice.
Returns Promise<void>
Void on successful deletion
Example: **Deleting a policy**
```
         await cdp.policies.deletePolicy({
           id: "__ID__"
         });
         
```
Example: **With idempotency key**
```
         const idempotencyKey = uuidv4();

         // This operation is idempotent with the key
         await cdp.policies.deletePolicy({
           id: "__ID__",
           idempotencyKey
         });
         
```
Implementation of PoliciesClientInterface.deletePolicy
- Defined in src/client/policies/policies.ts:252

updatePolicy

updatePolicy(options: UpdatePolicyOptions): Promise<Policy>
Updates an existing policy by its unique identifier. This will apply the updated policy to any project or accounts that are currently using it.
Parameters
- options: UpdatePolicyOptions
  Options containing the policy ID and updated policy data
  
  Options for updating a Policy.
  - id: string
    The unique identifier of the policy to update. This is a UUID that's generated when the policy is created.
  - policy: {
        description?: string;
        rules: (
            | {
                action: "reject"
                | "accept";
                operation: "signEvmTransaction";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "netUSDChange";
                        changeCents: number;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | { action: "reject"
            | "accept"; operation: "signEvmHash" }
            | {
                action: "reject" | "accept";
                operation: "signEvmMessage";
                criteria: { type: "evmMessage"; match: string }[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "signEvmTypedData";
                criteria: (
                    | {
                        type: "evmTypedDataField";
                        types: {
                            types: Record<string, { name: ...; type: ... }[]>;
                            primaryType: string;
                        };
                        conditions: (
                            | { addresses: (...)[]; operator: (...) | (...); path: string }
                            | {
                                value: string;
                                operator: (...) | (...) | (...) | (...) | (...);
                                path: string;
                            }
                            | { match: string; path: string }
                        )[];
                    }
                    | {
                        type: "evmTypedDataVerifyingContract";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "sendEvmTransaction";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmNetwork";
                        networks: (
                            | "base-sepolia"
                            | "base"
                            | "arbitrum"
                            | "optimism"
                            | "polygon"
                            | "avalanche"
                            | "ethereum"
                            | "ethereum-sepolia"
                        )[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "netUSDChange";
                        changeCents: number;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "prepareUserOperation";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmNetwork";
                        networks: (
                            | "base-sepolia"
                            | "base"
                            | "arbitrum"
                            | "optimism"
                            | "zora"
                            | "polygon"
                            | "bnb"
                            | "avalanche"
                            | "ethereum"
                            | "ethereum-sepolia"
                        )[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "sendUserOperation";
                criteria: (
                    | {
                        type: "ethValue";
                        ethValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | {
                        type: "evmAddress";
                        addresses: `0x${string}`[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "evmData";
                        abi: | "erc20"
                        | "erc721"
                        | "erc1155"
                        | readonly (
                            | {}
                            | {}
                            | (
                                { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                            )
                        )[];
                        conditions: { function: string; params?: (...)[] }[];
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "signSolTransaction";
                criteria: (
                    | {
                        type: "solAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solValue";
                        solValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | { type: "splAddress"; addresses: string[]; operator: "in"
                    | "not in" }
                    | {
                        type: "splValue";
                        splValue: string;
                        operator: ">" | ">=" | "<" | "<=" | "==";
                    }
                    | {
                        type: "mintAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solData";
                        idls: (
                            | "SystemProgram"
                            | "TokenProgram"
                            | "AssociatedTokenProgram"
                            | objectOutputType<
                                { address: ...; instructions: ... },
                                ZodTypeAny,
                                "passthrough",
                            >
                        )[];
                        conditions: { instruction: string; params?: (...)[] }[];
                    }
                    | { type: "programId"; programIds: string[]; operator: "in"
                    | "not in" }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "sendSolTransaction";
                criteria: (
                    | {
                        type: "solAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solValue";
                        solValue: string;
                        operator: ">"
                        | ">="
                        | "<"
                        | "<="
                        | "==";
                    }
                    | { type: "splAddress"; addresses: string[]; operator: "in"
                    | "not in" }
                    | {
                        type: "splValue";
                        splValue: string;
                        operator: ">" | ">=" | "<" | "<=" | "==";
                    }
                    | {
                        type: "mintAddress";
                        addresses: string[];
                        operator: "in"
                        | "not in";
                    }
                    | {
                        type: "solData";
                        idls: (
                            | "SystemProgram"
                            | "TokenProgram"
                            | "AssociatedTokenProgram"
                            | objectOutputType<
                                { address: ...; instructions: ... },
                                ZodTypeAny,
                                "passthrough",
                            >
                        )[];
                        conditions: { instruction: string; params?: (...)[] }[];
                    }
                    | { type: "programId"; programIds: string[]; operator: "in"
                    | "not in" }
                    | {
                        type: "solNetwork";
                        networks: ("solana-devnet" | "solana")[];
                        operator: "in" | "not in";
                    }
                )[];
            }
            | {
                action: "reject"
                | "accept";
                operation: "signSolMessage";
                criteria: { type: "solMessage"; match: string }[];
            }
        )[];
    }
    The updated policy definition. Contains the description and rules for the policy.
    
    Optionaldescription?: string
    An optional human-readable description for the policy. Limited to 50 characters of alphanumeric characters, spaces, commas, and periods.
    
    rules: (
        | {
            action: "reject"
            | "accept";
            operation: "signEvmTransaction";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "netUSDChange";
                    changeCents: number;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | { action: "reject"
        | "accept"; operation: "signEvmHash" }
        | {
            action: "reject" | "accept";
            operation: "signEvmMessage";
            criteria: { type: "evmMessage"; match: string }[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "signEvmTypedData";
            criteria: (
                | {
                    type: "evmTypedDataField";
                    types: {
                        types: Record<string, { name: ...; type: ... }[]>;
                        primaryType: string;
                    };
                    conditions: (
                        | { addresses: (...)[]; operator: (...) | (...); path: string }
                        | {
                            value: string;
                            operator: (...) | (...) | (...) | (...) | (...);
                            path: string;
                        }
                        | { match: string; path: string }
                    )[];
                }
                | {
                    type: "evmTypedDataVerifyingContract";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "sendEvmTransaction";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmNetwork";
                    networks: (
                        | "base-sepolia"
                        | "base"
                        | "arbitrum"
                        | "optimism"
                        | "polygon"
                        | "avalanche"
                        | "ethereum"
                        | "ethereum-sepolia"
                    )[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "netUSDChange";
                    changeCents: number;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "prepareUserOperation";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmNetwork";
                    networks: (
                        | "base-sepolia"
                        | "base"
                        | "arbitrum"
                        | "optimism"
                        | "zora"
                        | "polygon"
                        | "bnb"
                        | "avalanche"
                        | "ethereum"
                        | "ethereum-sepolia"
                    )[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "sendUserOperation";
            criteria: (
                | {
                    type: "ethValue";
                    ethValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | {
                    type: "evmAddress";
                    addresses: `0x${string}`[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "evmData";
                    abi: | "erc20"
                    | "erc721"
                    | "erc1155"
                    | readonly (
                        | {}
                        | {}
                        | (
                            { payable?: boolean | undefined; constant?: boolean | undefined; gas?: number | undefined; } & ({ inputs: readonly AbiParameter[]; outputs: readonly AbiParameter[]; type: "function"; name: string; stateMutability: "pure" | ... 2 more ... | "payable"; } | { ...; } | { ...; } | { ...; })
                        )
                    )[];
                    conditions: { function: string; params?: (...)[] }[];
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "signSolTransaction";
            criteria: (
                | {
                    type: "solAddress";
                    addresses: string[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "solValue";
                    solValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | { type: "splAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "splValue";
                    splValue: string;
                    operator: ">" | ">=" | "<" | "<=" | "==";
                }
                | { type: "mintAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "solData";
                    idls: (
                        | "SystemProgram"
                        | "TokenProgram"
                        | "AssociatedTokenProgram"
                        | objectOutputType<
                            { address: ...; instructions: ... },
                            ZodTypeAny,
                            "passthrough",
                        >
                    )[];
                    conditions: { instruction: string; params?: (...)[] }[];
                }
                | { type: "programId"; programIds: string[]; operator: "in"
                | "not in" }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "sendSolTransaction";
            criteria: (
                | {
                    type: "solAddress";
                    addresses: string[];
                    operator: "in"
                    | "not in";
                }
                | {
                    type: "solValue";
                    solValue: string;
                    operator: ">"
                    | ">="
                    | "<"
                    | "<="
                    | "==";
                }
                | { type: "splAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "splValue";
                    splValue: string;
                    operator: ">" | ">=" | "<" | "<=" | "==";
                }
                | { type: "mintAddress"; addresses: string[]; operator: "in"
                | "not in" }
                | {
                    type: "solData";
                    idls: (
                        | "SystemProgram"
                        | "TokenProgram"
                        | "AssociatedTokenProgram"
                        | objectOutputType<
                            { address: ...; instructions: ... },
                            ZodTypeAny,
                            "passthrough",
                        >
                    )[];
                    conditions: { instruction: string; params?: (...)[] }[];
                }
                | { type: "programId"; programIds: string[]; operator: "in"
                | "not in" }
                | {
                    type: "solNetwork";
                    networks: ("solana-devnet" | "solana")[];
                    operator: "in" | "not in";
                }
            )[];
        }
        | {
            action: "reject"
            | "accept";
            operation: "signSolMessage";
            criteria: { type: "solMessage"; match: string }[];
        }
    )[]
    Array of rules that comprise the policy. Limited to a maximum of 10 rules per policy.
  - OptionalidempotencyKey?: string
    The idempotency key to ensure the request is processed exactly once. Used to safely retry requests without accidentally performing the same operation twice.
Returns Promise<Policy>
The updated policy
Throws
When the updated policy is invalid
Example: **Updating an EVM policy**
```
         const updatedPolicy = await cdp.policies.updatePolicy({
           id: "__ID__",
           policy: {
             description: "Now with lower transaction limits",
             rules: [
               {
                 action: "reject",
                 operation: "signEvmTransaction",
                 criteria: [
                   {
                     type: "ethValue",
                     ethValue: "1000000000",
                     operator: ">",
                   },
                 ],
               },
             ],
           },
         });
         
```
Example: **Updating a Solana policy**
```
         const updatedPolicy = await cdp.policies.updatePolicy({
           id: "__ID__",
           policy: {
             description: "Updated Solana transaction limits",
             rules: [
               {
                 action: "reject",
                 operation: "signSolTransaction",
                 criteria: [
                   {
                     type: "splValue",
                     splValue: "1000000", // SPL token amount
                     operator: ">=",
                   },
                   {
                     type: "mintAddress",
                     addresses: ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"], // USDC mint
                     operator: "in",
                   },
                 ],
               },
             ],
           },
         });
         
```
Example: **With idempotency key**
```
         const idempotencyKey = uuidv4();

         // This operation is idempotent with the key
         await cdp.policies.updatePolicy({
           id: "__ID__",
           policy: {
             description: "Modified Policy",
             rules: { ... }
           },
           idempotencyKey
         });
         
```
Implementation of PoliciesClientInterface.updatePolicy
- Defined in src/client/policies/policies.ts:340

Class PoliciesClient

Implements

Index

Constructors

Methods

Constructors

constructor

Returns PoliciesClient

Methods

listPolicies

Parameters

OptionalpageSize?: number

OptionalpageToken?: string

Optionalscope?: "project" | "account"

Returns Promise<ListPoliciesResult>

Example: **List all policies**

Example: **Filter by scope**

Example: **With pagination**

createPolicy

Parameters

OptionalidempotencyKey?: string

scope: "project" | "account"

Optionaldescription?: string

Returns Promise<Policy>

Throws

Example: **Creating a new EVM policy**

Example: **Creating a new Solana policy**

Example: **With idempotency key**

getPolicyById

Parameters

id: string

Returns Promise<Policy>

Example: **Retrieving a policy by ID**

deletePolicy

Parameters

id: string

OptionalidempotencyKey?: string

Returns Promise<void>

Example: **Deleting a policy**

Example: **With idempotency key**

updatePolicy

Parameters

id: string

Optionaldescription?: string

OptionalidempotencyKey?: string

Returns Promise<Policy>

Throws

Example: **Updating an EVM policy**

Example: **Updating a Solana policy**

Example: **With idempotency key**

Settings

On This Page

`Optional`pageSize?: number

`Optional`pageToken?: string

`Optional`scope?: "project" | "account"

Example: List all policies

Example: Filter by scope

Example: With pagination

`Optional`idempotencyKey?: string

`Optional`description?: string

Example: Creating a new EVM policy

Example: Creating a new Solana policy

Example: With idempotency key

Example: Retrieving a policy by ID

`Optional`idempotencyKey?: string

Example: Deleting a policy

Example: With idempotency key

`Optional`description?: string

`Optional`idempotencyKey?: string

Example: Updating an EVM policy

Example: Updating a Solana policy

Example: With idempotency key