Owner Two Step Transfer Facet

OwnerStorage​

/** storage-location: erc8042:erc173.owner */
struct OwnerStorage {
  address owner;
}

PendingOwnerStorage​

/** storage-location: erc8042:erc173.owner.pending */
struct PendingOwnerStorage {
  address pendingOwner;
}

Functions​

transferOwnership​

Callable only when msg.sender is the current owner. Sets pendingOwner to _newOwner and emits OwnershipTransferStarted(owner, _newOwner). The on-chain owner does not change until acceptOwnership is call.

function transferOwnership(address _newOwner) external;

Parameters:

acceptOwnership​

Callable only when msg.sender is the pending owner. Assigns owner to the pending address, sets pendingOwner to address(0), and emits OwnershipTransferred(previousOwner, newOwner).

function acceptOwnership() external;

Events​

OwnershipTransferStarted

Emitted when the current owner calls transferOwnership, before the pending address accepts.

Signature:

event OwnershipTransferStarted(address indexed _previousOwner, address indexed _newOwner);

OwnershipTransferred

Emitted when the pending owner calls acceptOwnership and ownership is updated.

Signature:

event OwnershipTransferred(address indexed _previousOwner, address indexed _newOwner);

Errors​

OwnerUnauthorizedAccount

Thrown when transferOwnership is called by anyone other than the current owner or the pending owner.

Signature:

error OwnerUnauthorizedAccount();

Best Practices​

• Initialize OwnerStorage.owner during deployment before relying on owner behavior elsewhere.
• After transferOwnership, ensure the nominated _newOwner can and will call acceptOwnership; until then, the previous owner remains owner.

Last updated:June 5, 2026

Newsletter

Get notified about releases, feature announcements, and technical deep-dives on building smart contracts with Compose.

Subscribe

No spam. Unsubscribe anytime.