How to create a mintpass CSV for an Ordinals collection

  • Updated

If you're a creator deploying your collection using the Ordinal Launchpad, you'll have the option to create and upload a custom CSV file containing mintpass information. While this is an optional association, it can help set your collection apart from others and provide added benefits relative to collections without them. We'll explain exactly how to format your file so you can easily add it to your collection if desired. You can also check out this video guide that shows you how to create it.

You can create a CSV file using many different applications, but the most common method would be to use Microsoft Excel or Google Sheets. These files can be exported as CSV files when downloading them.

Mintpass CSV File

A mintpass is used to allow specific, pre-defined Taproot wallet addresses to mint Ordinals from your collection ahead of its public sale. The file for mintpass is quite straightforward, simply requiring wallet addresses in one column, and the maximum mint limit in a second column.

During the mintpass sale period on mintpass-enabled collections, the system will automatically check claim (i.e. mint) transactions for presence on the mintpass list and will ensure there are remaining mints within the max mint limit. If any mints remain, it will allow the mint to occur. If the Bitcoin address claiming is not on the list or has no remaining mints within its limit, then the transaction will fail. This enables only the addresses with a mintpass allocation to mint up to their mint limit until the public sale is initiated if it is.

Addresses must be entered using an Ordinal address as the system mintpass functionality does not work with non-Ordinal addresses (e.g. ​​Taproot addresses start with ‘bc1p…’ and are case insensitive).

Here is an example of the file format needed for mintpass CSV. There should be no headings on the mintpass CSV file.

bc1p00000000000000A 1
bc1p00000000000000B 4
bc1p00000000000000C 2
bc1p00000000000000D 3
bc1p00000000000000E 2

In this scenario, the address ending in A will be able to mint 1 ordinal, and B will be able to mint a maximum of 4 ordinals from your collection during the mintpass sale period. Likewise, the addresses ending in C, D, and E will be able to mint a maximum number of Ordinals from your collection during the mintpass sale period.

After the mintpass sale period is over, the listed addresses and any other address regardless of their presence on the mintpass CSV file, will be able to mint any number of Ordinals up to the maximum limit set for the entire collection. The upper limit by default will be the total number of tokens you submitted assets for, but this limit may be changed if needed via the Ordinals collection manager, at any point before or during the mint.

Watch this video for information on how to manage your Ordinals collection.

Note that if you paused the mint on deploy, you can still upload the CSV file. However, once the mint has started, mint passes can no longer be updated.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request



Please sign in to leave a comment.