Owner Two Step Transfer Module

OwnerStorage​

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

PendingOwnerStorage​

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

Functions​

getOwnerStorage​

Returns a storage pointer to OwnerStorage.

function getOwnerStorage() pure returns (OwnerStorage storage s);

Returns:

getPendingOwnerStorage​

Returns a storage pointer to PendingOwnerStorage.

function getPendingOwnerStorage() pure returns (PendingOwnerStorage storage s);

Returns:

transferOwnership​

Requires msg.sender == owner; otherwise reverts OwnerUnauthorizedAccount. Sets pendingOwner to _newOwner and emits OwnershipTransferStarted(owner, _newOwner). Does not change owner until acceptOwnership.

function transferOwnership(address _newOwner);

Parameters:

acceptOwnership​

Requires msg.sender == pendingOwner; otherwise reverts OwnerUnauthorizedAccount. Assigns owner to the pending address, clears pendingOwner, and emits OwnershipTransferred(previousOwner, newOwner).

function acceptOwnership();

Events​

OwnershipTransferStarted

Emitted when the current owner calls transferOwnership (pending owner set).

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 when acceptOwnership is called by anyone other than the pending owner.

Signature:

error OwnerUnauthorizedAccount();

Best Practices​

• Expose transferOwnership and acceptOwnership only through trusted external facet entrypoints; confirm _newOwner before initiating.
• Keep the same OwnerStorage / PendingOwnerStorage layout as Owner Two Step Transfer Facet and Owner Two Step Data Module
• owner is shared with OwnerDataMod and single-step owner code at keccak256("erc173.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.