Events

Event Emissions

Events are emitted at every state-changing function call, in addition to standard ERC721 events. Events often include the timestamp as a specific parameter, which allows for direct consumption using a bloom filter without needing to fetch block context on every event.

Furthermore, collect and follow NFT transfers hook into an event emitter on the LensHub, which simplifies event consumption by tracking NFT transfers without indexing numerous follow and collect NFTs.

The Events library contains a convenient list of all custom Lens Protocol events as well as explanations for each. It also references the DataTypes library.

See the events emitted below:

BaseInitialized

event BaseInitialized(string name, string symbol, uint256 timestamp);

Emitted when the NFT contract's name and symbol are set at initialization by initialize()

StateSet

event StateSet(address indexed caller, DataTypes.ProtocolState indexed prevState, DataTypes.ProtocolState indexed newState, uint256 timestamp);

Emitted when the hub state is set by setState()

GovernanceSet

event GovernanceSet(address indexed caller, address indexed prevGovernance, address indexed newGovernance, uint256 timestamp);.

Emitted when the governance address is changed by setGovernance()

EmergencyAdminSet

event EmergencyAdminSet(address indexed caller, address indexed oldEmergencyAdmin, address indexed newEmergencyAdmin, uint256 timestamp);

Emitted when the emergency admin is changed by setEmergencyAdmin()

ProfileCreatorWhitelisted

event ProfileCreatorWhitelisted(address indexed profileCreator, bool indexed whitelisted, uint256 timestamp);

Emitted when a profile creator is added to or removed from the whitelist by whitelistProfileCreator()

FollowModuleWhitelisted

event FollowModuleWhitelisted(address indexed followModule, bool indexed whitelisted, uint256 timestamp);

Emitted when a follow module is added to or removed from the whitelist by whitelistFollowModule()

ReferenceModuleWhitelisted

event ReferenceModuleWhitelisted(address indexed referenceModule, bool indexed whitelisted, uint256 timestamp);

Emitted when a reference module is added to or removed from the whitelist by whitelistReferenceModule()

CollectModuleWhitelisted

event CollectModuleWhitelisted(address indexed collectModule, bool indexed whitelisted, uint256 timestamp);

Emitted when a collect module is added to or removed from the whitelist by whitelistCollectModule()

ProfileCreated

event ProfileCreated(uint256 indexed profileId, address indexed creator, address indexed to, string handle, string imageURI, address followModule, bytes followModuleReturnData, string followNFTURI, uint256 timestamp);

DispatcherSet

event DispatcherSet(uint256 indexed profileId, address indexed dispatcher, uint256 timestamp);

Emitted when a dispatcher is set for a specific profile by setDispatcher()

ProfileImageURISet

event ProfileImageURISet(uint256 indexed profileId, string imageURI, uint256 timestamp);

Emitted when a profile's URI is set by setProfileImageURI()

FollowNFTURISet

event FollowNFTURISet(uint256 indexed profileId, string followNFTURI, uint256 timestamp);

Emitted when a follow NFT's URI is set by setFollowNFTURI()

FollowModuleSet

event FollowModuleSet(uint256 indexed profileId, address followModule, bytes followModuleReturnData, uint256 timestamp);

Emitted when a profile's follow module is set by setFollowModule()

PostCreated

event PostCreated(uint256 indexed profileId, uint256 indexed pubId, string contentURI, address collectModule, bytes collectModuleReturnData, address referenceModule, bytes referenceModuleReturnData, uint256 timestamp);

Emitted when a "post" is published by either post() or postWithSig()

CommentCreated

event CommentCreated(uint256 indexed profileId, uint256 indexed pubId, string contentURI, uint256 profileIdPointed, uint256 pubIdPointed, address collectModule, bytes collectModuleReturnData, address referenceModule, bytes referenceModuleReturnData, uint256 timestamp);

Emitted when a "comment" is published by either comment() or commentWithSig()

MirrorCreated

event MirrorCreated(uint256 indexed profileId, uint256 indexed pubId, uint256 profileIdPointed, uint256 pubIdPointed, address referenceModule, bytes referenceModuleReturnData, uint256 timestamp);

Emitted when a "mirror" is published by either mirror() or mirrorWithSig()

FollowNFTDeployed

event FollowNFTDeployed(uint256 indexed profileId, address indexed followNFT, uint256 timestamp);

Emitted when a followNFT clone is deployed using a lazy deployment pattern i.e. in case Follow NFT contract does not already exist when either follow() or followWithSig() is called.

CollectNFTDeployed

event CollectNFTDeployed(uint256 indexed profileId, uint256 indexed pubId, address indexed collectNFT, uint256 timestamp);

Emitted when a collectNFT clone is deployed using a lazy deployment pattern i.e. in case collect NFT contract does not already exist when either collect() or collectWithSig() is called.

Collected

event Collected(address indexed collector, uint256 indexed profileId, uint256 indexed pubId, uint256 rootProfileId, uint256 rootPubId, uint256 timestamp);

Emitted upon a successful collect action by either collect() or collectWithSig()

FollowNFTTransferred

event FollowNFTTransferred(uint256 indexed profileId, uint256 indexed followNFTId, address from, address to, uint256 timestamp);

Emitted via callback when a followNFT is transferred.

CollectNFTTransferred

event CollectNFTTransferred(uint256 indexed profileId, uint256 indexed pubId, uint256 indexed collectNFTId, address from, address to, uint256 timestamp);

Emitted via callback when a collectNFT is transferred.

Collect/Follow NFT-Specific

FollowNFTInitialized

event FollowNFTDelegatedPowerChanged(address delegate, uint256 newPower, uint256 timestamp);

Emitted when a newly deployed follow NFT is initialized.

FollowNFTDelegatedPowerChanged

event FollowNFTDelegatedPowerChanged(address delegate, uint256 newPower, uint256 timestamp);

Emitted when delegation power in a FollowNFT is changed.

CollectNFTInitialized

event CollectNFTInitialized(uint256 profileId, uint256 pubId, uint256 timestamp);

Emitted when a newly deployed collect NFT is initialized.

Module-Specific

ModuleGlobalsGovernanceSet

event ModuleGlobalsGovernanceSet(address indexed prevGovernance, address indexed newGovernance, uint256 timestamp);

Emitted when the ModuleGlobals governance address is set.

ModuleGlobalsTreasurySet

event ModuleGlobalsTreasurySet(address indexed prevTreasury, address indexed newTreasury, uint256 timestamp);

Emitted when the ModuleGlobals treasury address is set.

ModuleGlobalsTreasuryFeeSet

event ModuleGlobalsTreasuryFeeSet(uint16 indexed prevTreasuryFee, uint16 indexed newTreasuryFee, uint256 timestamp);

Emitted when the ModuleGlobals treasury fee is set.

ModuleGlobalsCurrencyWhitelisted

event ModuleGlobalsCurrencyWhitelisted(address indexed currency, bool indexed prevWhitelisted, bool indexed whitelisted, uint256 timestamp);

Emitted when a currency is added to or removed from the ModuleGlobals whitelist.

FeeModuleBaseConstructed

event FeeModuleBaseConstructed(address indexed moduleGlobals, uint256 timestamp);

Emitted when a module inheriting from the FeeModuleBase is constructed.

ModuleBaseConstructed

event ModuleBaseConstructed(address indexed hub, uint256 timestamp);

Emitted when a module inheriting from the ModuleBase is constructed.

FollowsApproved

event FollowsApproved(address indexed owner, uint256 indexed profileId, address[] addresses, bool[] approved, uint256 timestamp);

Emitted when one or multiple addresses are approved (or disapproved) for following in the ApprovalFollowModule.