Premint V2

[kulkarohan]

Premint v2 - adding a new signature, where createReferral can be specified. ZoraCreator1155PremintExecutor recognizes new version of the signature, and still works with the v1 (legacy) version of the signature. 1155 contract has been updated to now take abi encoded premint config, premint config version, and send it to an external library to decode the config, the signer, and setup actions.

ZoraCreator1155PremintExecutor can now validate signatures by passing it the contract address, instead of needing to pass the full contract creation config, enabling it to validate signatures for 1155 contracts that were not created via the premint executor contract. This allows premints signatures to be validated on contracts that have been upgrade to a version that supports premints, and allows premints to be created on contracts that were not created via the premint executor contract.

1155 contract has been updated to now take abi encoded premint config, premint config version, and send it to an external library to decode the config, the signer, and setup actions.

changes to ZoraCreator1155PremintExecutorImpl:

PremintConfigV2 are updated to containe createReferral, and now look like:

struct PremintConfigV2 {
    // The config for the token to be created
    TokenCreationConfigV2 tokenConfig;
    // Unique id of the token, used to ensure that multiple signatures can't be used to create the same intended token.
    // only one signature per token id, scoped to the contract hash can be executed.
    uint32 uid;
    // Version of this premint, scoped to the uid and contract.  Not used for logic in the contract, but used externally to track the newest version
    uint32 version;
    // If executing this signature results in preventing any signature with this uid from being minted.
    bool deleted;
}

struct TokenCreationConfigV2 {
    // Metadata URI for the created token
    string tokenURI;
    // Max supply of the created token
    uint256 maxSupply;
    // Max tokens that can be minted for an address, 0 if unlimited
    uint64 maxTokensPerAddress;
    // Price per token in eth wei. 0 for a free mint.
    uint96 pricePerToken;
    // The start time of the mint, 0 for immediate.  Prevents signatures from being used until the start time.
    uint64 mintStart;
    // The duration of the mint, starting from the first mint of this token. 0 for infinite
    uint64 mintDuration;
    // RoyaltyBPS for created tokens. The royalty amount in basis points for secondary sales.
    uint32 royaltyBPS;
    // The address that will receive creatorRewards, secondary royalties, and paid mint funds.
    address payoutAddress;
    // Fixed price minter address
    address fixedPriceMinter;
    // create referral
    address createReferral;
}

PremintConfig fields are the same as they were before, but are treated as a version 1:

struct PremintConfig {
    // The config for the token to be created
    TokenCreationConfig tokenConfig;
    // Unique id of the token, used to ensure that multiple signatures can't be used to create the same intended token.
    // only one signature per token id, scoped to the contract hash can be executed.
    uint32 uid;
    // Version of this premint, scoped to the uid and contract.  Not used for logic in the contract, but used externally to track the newest version
    uint32 version;
    // If executing this signature results in preventing any signature with this uid from being minted.
    bool deleted;
}

struct TokenCreationConfig {
    // Metadata URI for the created token
    string tokenURI;
    // Max supply of the created token
    uint256 maxSupply;
    // Max tokens that can be minted for an address, 0 if unlimited
    uint64 maxTokensPerAddress;
    // Price per token in eth wei. 0 for a free mint.
    uint96 pricePerToken;
    // The start time of the mint, 0 for immediate.  Prevents signatures from being used until the start time.
    uint64 mintStart;
    // The duration of the mint, starting from the first mint of this token. 0 for infinite
    uint64 mintDuration;
    // RoyaltyMintSchedule for created tokens. Every nth token will go to the royalty recipient.
    uint32 royaltyMintSchedule;
    // RoyaltyBPS for created tokens. The royalty amount in basis points for secondary sales.
    uint32 royaltyBPS;
    // RoyaltyRecipient for created tokens. The address that will receive the royalty payments.
    address royaltyRecipient;
    // Fixed price minter address
    address fixedPriceMinter;
}

changes to ZoraCreator1155PremintExecutorImpl:

• new function premintV1 - takes a PremintConfig, and premint v1 signature, and executes a premint, with added functionality of being able to specify mint referral and mint recipient
• new function premintV2 - takes a PremintConfigV2 signature and executes a premint, with being able to specify mint referral and mint recipient
• deprecated function premint - call premintV1 instead
• new function isValidSignatureV1 - takes an 1155 address, contract admin, premint v1 config and signature, and validates the signature. Can be used for 1155 contracts that were not created via the premint executor contract.
• new function isValidSignatureV2 - takes an 1155 address, contract admin, premint v2 config and signature, and validates the signature. Can be used for 1155 contracts that were not created via the premint executor contract.
• deprecated function isValidSignature - call isValidSignatureV1 instead

[kulkarohan]

Current dependencies on/for this PR:

• main
  • PR Updated prettier formatting in all packages, and formatted code #360
    • PR Allow fork rpc and block number to be specified in anvil tests #362
      • PR Premint V2 #262 👈
        • PR Rename payout address to payout recipient #329
        • PR Premint - can execute premint on legacy version of contracts #299
          • PR Premint - if no mint recipient, revert with proper error #312
            • PR Premint - get supported premint signature version #303
              • PR Changed premint executor to use simpler method for determining if signer is authorized to sign a premint #344
                • PR Add implementation getter to premint executor #372
                  • PR Fix premint sdk changeset #373
                  • PR Fix premint changeset #374
                • PR WIP - premint v2 sdk #364
              • PR Added platform referral field, which is not currently supported but is in the sig #336
              • PR Premint - get array of supported premint versions #309
        • PR Premint - better mint arguments. Mint recipient is specified #294
          • PR Premint - no operator overloading #295
        • PR Premint - rename royaltyRecipient to fundsRecipient on premint v2 signature #289
        • PR Create referral - premint executor acccepts both v1 and v2 signatures #273
          • PR premint - fixed price minter has address(0) for funds recipient #288
            • PR Premint v1 and v2 sigs - 1155 now takes in encoded premint config and decodes it #284
          • PR support v1 and v2 sigs #280

This stack of pull requests is managed by Graphite.

[oveddan]

hey this makes sense as a way to support this.
The main issue is that existing signatures would not work (we need new forms of signatures, like a v2 of the signature) so an upgrade to this contract would result in existing signatures not working

[oveddan]

Merge activity

• Nov 15, 2:48 PM: @oveddan started a stack merge that includes this pull request via Graphite.
• Nov 15, 2:48 PM: Graphite couldn't merge this PR because it was not satisfying all requirements.