Skip to main content

Pack

The pack contract lets you bundle ERC20, ERC721 and, ERC1155 tokens together into ERC1155 NFTs that act as randomized loot boxes. The packs are ERC1155 NFTs themselves, which can have the metadata you'd expect of an NFT, such as a name, image, description, etc.

When a pack is opened, a pre-defined quantity of tokens are randomly selected from the ones that were used to create the packs (that haven't already been selected), and awarded to the opener. The pack NFT is burned as it's opened.

You can configure how many tokens get selected for the pack:

  • How many tokens are in each "unit" (for ERC20 & ERC1155 tokens - one unit could be multiple tokens).
  • How many units are in each pack.

Use Cases & Examples

You could use the Pack contract to:

  • Create randomized NFT loot boxes
  • Run a randomized raffle where some users open a winning ticket
  • Reward your community with token gift boxes

Smart Contract Design

For a detailed exploration of how the pack smart contract works, why it was built, and it's limitations, visit our Pack Design Doc!

Using the Contract in the SDK

This page outlines how you can create and configure your pack contract using the dashboard.

You can also use our SDK to create and interact with your contract.

Creating & Configuring the Pack

Learn how to create and configure your smart contract using the dashboard.

Creating a Pack Contract

Deploy the pack contract to any of our supported networks using the button below.

Contract Metadata

To configure the image, name, and description of the contract, click the Settings tab:

Contract Metadata

Royalty & Platform Fees

From the Settings tab, you also configure the royalty fee:

Pack Royalty