Class: SetPolicyEngine

Defined in: cct/evm/advanced-pool-hooks/operations/set-policy-engine.ts:47

Attaches a policy engine, or clears it with the zero address. Owner-only.

Extends

• EVMOperation<SetPolicyEngineParams>

Constructors

Constructor

new SetPolicyEngine(): SetPolicyEngine

Returns

SetPolicyEngine

Inherited from

EVMOperation<SetPolicyEngineParams>.constructor

Properties

name

readonly name: "setPolicyEngine" = 'setPolicyEngine'

Defined in: cct/evm/advanced-pool-hooks/operations/set-policy-engine.ts:48

camelCase id; matches the token-manager facade method and error context.

Overrides

EVMOperation.name

Methods

buildUnsigned()

protected buildUnsigned(chain: EVMChain, params: SetPolicyEngineParams): Promise<UnsignedEVMTx>

Defined in: cct/evm/advanced-pool-hooks/operations/set-policy-engine.ts:64

Confirms the target, policy engine code, and supplied owner before encoding setPolicyEngine(address).

Parameters

Parameter	Type
chain	EVMChain
params	SetPolicyEngineParams

Returns

Promise<UnsignedEVMTx>

Throws

CCTContractTypeInvalidError if the target is not AdvancedPoolHooks

Throws

CCTParamsInvalidError if non-zero newPolicyEngine has no deployed code

Throws

CCTParamsInvalidError if sender is supplied and is not the hooks owner

Throws

as resolveAdvancedPoolHooks for a poolAddress target

Overrides

EVMOperation.buildUnsigned

---

execute()

execute(chain: EVMChain, params: EVMExecuteParams<SetPolicyEngineParams>): Promise<TransactionResult>

Defined in: cct/evm/operation.ts:150

generate, then sign and submit; returns the confirmed tx hash.

Parameters

Parameter	Type
chain	EVMChain
params	EVMExecuteParams<SetPolicyEngineParams>

Returns

Promise<TransactionResult>

Inherited from

EVMOperation.execute

---

generate()

generate(chain: EVMChain, params: SetPolicyEngineParams): Promise<UnsignedEVMTx>

Defined in: cct/evm/operation.ts:110

Run prepare and buildUnsigned, applying optional sender; no signing.

Parameters

Parameter	Type
chain	EVMChain
params	SetPolicyEngineParams

Returns

Promise<UnsignedEVMTx>

Remarks

Also pins every built transaction to chain.network.chainId (no RPC, known at construction). This is the one point every CCT builder and both execute paths pass through; unpinned, ethers would infer the chain from the eventual signer's provider.

Inherited from

EVMOperation.generate

---

parse()

protected parse(params: SetPolicyEngineParams): SetPolicyEngineParams

Defined in: cct/operation.ts:42

Normalize validated params for the builder — defaults, conversions, derived values. Identity by default, so an op that needs no normalization declares nothing.

Parameters

Parameter	Type
params	SetPolicyEngineParams

Returns

SetPolicyEngineParams

Inherited from

EVMOperation.parse

---

prepare()

protected prepare(params: SetPolicyEngineParams): SetPolicyEngineParams

Defined in: cct/operation.ts:48

validate then parse — the single pre-RPC step, before any chain access.

Parameters

Parameter	Type
params	SetPolicyEngineParams

Returns

SetPolicyEngineParams

Inherited from

EVMOperation.prepare

---

resolveWalletSender()

protected resolveWalletSender(wallet: unknown, sender?: string): Promise<string>

Defined in: cct/evm/operation.ts:130

Resolves the address a signed submission is authorized against: the signing wallet's own. The chain gates on msg.sender, and submit clears any builder-set tx.from before populating the tx (so ethers' own from/signer guard never fires) — an explicit sender that differs from the wallet would therefore let an op's pre-tx checks authorize one address while a different one actually signs, passing every local guard and reverting on-chain. Ops that gate on an on-chain role call this from execute; build with generateUnsigned* instead when the eventual signer isn't known yet, where sender is trusted as given.

Parameters

Parameter	Type
wallet	unknown
sender?	string

Returns

Promise<string>

Throws

CCIPWalletInvalidError if wallet is not a valid signer

Throws

CCTParamsInvalidError if sender is given and is not the wallet's address

Inherited from

EVMOperation.resolveWalletSender

---

validate()

protected validate(params: SetPolicyEngineParams): void

Defined in: cct/evm/advanced-pool-hooks/operations/set-policy-engine.ts:51

Validates addresses before any RPC; zero newPolicyEngine deliberately disables checks.

Parameters

Parameter	Type
params	SetPolicyEngineParams

Returns

void

Overrides

EVMOperation.validate