IPolicyRegistry.stageUpdateAdmin

Stages a proposed new admin for a policy in the Policy Registry; the active admin does not change until the pending admin calls finalizeUpdateAdmin.

Signature

IPolicyRegistry.sol

function stageUpdateAdmin(uint64 policyId, address newAdmin) external;

Field	Value
Selector	0x1d7ae695
Canonical signature	stageUpdateAdmin(uint64,address)

Description

Nominates newAdmin as the pending admin for policyId. The current admin does not change. policyAdmin(policyId) still returns the current admin. pendingPolicyAdmin(policyId) returns newAdmin.

The pending admin must call finalizeUpdateAdmin(policyId) to take effect. Until then, the current admin retains full update rights on the policy.

Passing address(0) as newAdmin clears any previously staged nomination without transferring administration.

Emits PolicyAdminStaged(policyId, currentAdmin, pendingAdmin).

Parameters

Name	Type	Description
policyId	uint64	Policy whose admin is being staged.
newAdmin	address	Proposed new admin. Pass address(0) to clear a nomination that has not been finalized.

Reverts

Error	Condition
PolicyNotFound()	policyId does not exist in the registry.
Unauthorized()	Caller is not the current admin of policyId.

Access Control

Callable only by the current policy admin for policyId. Any other caller reverts Unauthorized.

Example

Admin handoff

// Step 1: current admin nominates a successor
IPolicyRegistry(registry).stageUpdateAdmin(policyId, nextAdmin);

// Step 2: nextAdmin finalizes (separate transaction, called by nextAdmin)
IPolicyRegistry(registry).finalizeUpdateAdmin(policyId);