InviteRegistry

Invite codes and referral weights.

Deployed once per chain; shared across all auctions (keyed by auction address). Authority for bid gating + fee attribution (offchain DB is UX-only):

Factory registers each auction and seeds creator invite codes (bytes32 → issuer).
InviteValidationHook calls useInvite on first CCA bid; unknown/self invites revert.
Codes are reusable; only the first participation per bidder credits the issuer.
Creator or prior participants may createInvites; FeeDistributor reads referral counts.

State Variables

CcaLaunchFactory — only caller allowed to registerAuction / seedInvites.

address public factory

address public validationHook

mapping(address => address) public creatorOf

mapping(address => address) public auctionOfToken

mapping(address => mapping(bytes32 => address)) public inviteIssuer

mapping(address => mapping(address => bool)) public participated

mapping(address => mapping(address => uint256)) public referralCountOf

mapping(address => uint256) public totalReferralCountOf

mapping(address => uint256) public invitesCreated

function setFactory(address factory_) external;

function setValidationHook(address hook_) external;

function registerAuction(address auction, address token, address creator) external;

function seedInvites(address auction, address issuer, bytes32[] calldata codes) external;

function createInvites(address auction, bytes32[] calldata codes) external;

function _createInvites(address auction, address issuer, bytes32[] calldata codes) internal;

Called by InviteValidationHook during CCA submitBid.

function useInvite(address auction, address bidder, bytes32 code) external;

function referralCount(address auction, address referrer) external view returns (uint256);

function totalReferralCount(address auction) external view returns (uint256);

event FactorySet(address indexed factory);

event ValidationHookSet(address indexed hook);

event AuctionRegistered(address indexed auction, address indexed token, address indexed creator);

event InviteCreated(address indexed auction, bytes32 indexed code, address indexed issuer);

event InviteUsed(address indexed auction, address indexed bidder, address indexed referrer, bytes32 code);

error AlreadySet();

error NotAuthorized();

error InvalidInvite();

error InviteExists();

error ZeroAddress();