Owner Transfer Module

OwnerStorage​

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

Functions​

getStorage​

Returns a pointer to the OwnerStorage struct.

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

Returns:

transferOwnership​

Transfer the diamond ownership from the current owner to the next one. Caller must be the current owner.

_newOwner may be address(0) to clear ownership (same storage effect as renounceOwnership() in OwnerRenounceMod).

function transferOwnership(address _newOwner);

Parameters:

Events​

OwnershipTransferred

Emitted when the stored owner changes (including when _newOwner is address(0)).

Signature:

event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

Errors​

OwnerUnauthorizedAccount

Thrown when msg.sender is not the stored owner during transferOwnership.

Signature:

error OwnerUnauthorizedAccount();

Best Practices​

• Call transferOwnership only from trusted external wrappers; confirm _newOwner before sending a transaction.
• Keep the same STORAGE_POSITION and OwnerStorage layout as other owner modules; do not introduce a second owner slot.
• If you want a dedicated renounce entrypoint in Solidity, prefer OwnerRenounceMod or pass address(0) here. Both target the same storage field.

Integration Notes​

OwnerStorage lives at keccak256("erc173.owner") inside the diamond. The same slot as OwnerDataMod, OwnerTransferFacet, and related owner code. Transferring here updates what owner() reads on OwnerDataFacet.

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.