Simplified sales
When the Sale mode is set to Simplified in the configuration, your products will be created and managed in Hub.
Product creation
To create a product in the Hub, simply go to the Products tab and click on the Create Product button.
Fill the form with the following information:
| Property | Description |
|---|---|
| Product ID | Unique identifier of the product. |
| Product Name | The name of the product. |
| Description | The description of the product. |
| Image URL | The image URL of the product. |
| Status | Current status of the product - Active: Products available for sale - Inactive: Products not available for sale |
| Collection | The collection the product belongs to. |
| Token ID | Only applicable for ERC1155 collections. The ID of the token that will be minted as part of the sale. |
| Limits | The limits a product might have. You can enable limits and configure the maximum quantity a wallet address can receive. |
| Quantity | The stock quantity of the product. |
| Pricing | Amount: The price of the product Currency: The currency of the price. You can add multiple prices with different currencies for one product |
Product maintenance and deletion
To edit an existing product, simply click on the product in the grid and update the details in the form. Once you finish editing, click on Save changes.
To delete a product, scroll to the bottom of the page (Danger Zone) and click on Delete.
Metadata for the minted tokens
When a token is minted as part of a sale, the game developer needs to ensure that the token metadata is pre-defined (in case of ERC1155) or generated (in case of ERC721).
Metadata for ERC1155
The product has a Token ID field, which means the game needs to have metadata available for that token ID before tokens are minted.
Metadata for ERC721
For ERC721 the token IDs are generated randomly as part of the sale process, the game needs to implement a mechanism to generate the metadata for the minted tokens.
- Set up a Webhook in the Hub to receive the events when tokens are minted. The event imtbl_zkevm_activity_mint is triggered when a token is minted.
- Implement the logic in the game to generate the metadata for the minted tokens. This might involve refreshing the metadata using the Metadata refresh API.
Allowlists
On simplified mode, you can also define address allowlists to limit users who can participate in your sales. To enable that, go to your Primary Sales configuration tab in Hub and check the Enable allowlists option.
When allowlists are enabled, the Primary Sales widget will check if the user's wallet address is included in any active allowlists in your project.
Allowlist creation
To create or update allowlists, head to the Allowlists tab inside Hub's Primary Sales page. Click the Create allowlist button, then enter a list of wallet addresses. Once your allowlist is saved with an Active status, all addresses in the list will be able to participate in your sales.
