# ERC-1155 Migration Guide

### Step 1. Choose the collection you wish to migrate

From your Launchpad dashboard, select the project or collection you’d like to begin migrating.

<figure><img src="/files/hoRQYvrv8VTJQVj1MZEk" alt=""><figcaption></figcaption></figure>

Please note: migration is only applicable for projects that were **deployed to the blockchain** (mainnet or testnet) **and** are currently using **HeyMint’s IPFS hosting**.

*If your project uses your own IPFS for images and metadata, there’s no need to migrate—it won’t be affected by the shutdown.*

While this guide focuses on 1155 projects, some minor steps may differ depending on your collection type. But don’t worry—the overall process remains the same. Also, please make sure **not to close your browser tab** during any part of the migration to avoid interruptions when files are downloading or updating.

### Step 2. Access the Export Collection feature

In your Launchpad dashboard, click on **Export Collection** from the left-hand sidebar.

<figure><img src="/files/GXMIRbksuhpHsbiUMIa5" alt=""><figcaption></figcaption></figure>

*Note: This option will only appear if your project has been deployed to the blockchain (either on mainnet or testnet).*

### Step 3. Download your collection’s artwork / images

Start by clicking on **Download collection images**. Follow the prompt to choose the folder where the files will be saved. Once the download is complete, check your local directory to make sure all files are there.

<figure><img src="/files/f4QmC42DFwmaj6Yl4JbR" alt=""><figcaption></figcaption></figure>

#### Please keep the following in mind:

1. **ERC-1155 projects** may include a variety of file types based on what was uploaded—such as `.jpg`, `.png`, or `.gif`. The downloaded files will be named according to their Token IDs.
2. If your project doesn’t include any uploaded animations, the **“Download animations”** button will not be visible.

### Step 4. Upload your collection’s artwork, images, or animations to your chosen IPFS host

Once you’ve confirmed that your images have been successfully downloaded, the next step is to upload them to your preferred IPFS hosting provider—such as [Storacha](https://console.storacha.network/), [Pinata](https://pinata.cloud/), or [Web3.Storage](https://web3.storage/).

Please note: depending on the size of your collection, some providers may charge for additional storage.

For this guide, we’ll be using **Storacha** as the example IPFS host. While the upload process may look slightly different on other platforms, the important part—retrieving your **CID (Content Identifier)**—will be the same.

**Important:**\
If your project includes both **images and animations**, upload them separately. Each should be saved and handled using its own unique CID.

Here’s how to proceed on Storacha:

1. After registering and creating your space, upload the folder that contains your downloaded assets.
   * For **721A (Token Flow)** and **1155 projects**, your download will come as a ZIP file. Be sure to **unzip** it before uploading to your IPFS host.
2. Once the upload is complete, copy the **CID** provided.\
   The CID is a unique string (usually starting with `bafyxxxxxx`) that serves as a digital fingerprint for your uploaded content. It allows anyone to locate and access your files through IPFS gateways.

You can use gateways like [ipfs.io](http://ipfs.io) or [w3s.link](http://w3s.link) to view your uploaded assets using the CID, as shown in the examples below.

<figure><img src="/files/M168aBUIDn7TtCYls4E5" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/y3ZLzBiufPD5sKkz7QiU" alt=""><figcaption></figcaption></figure>

Your chosen IPFS host will usually display the CID of your uploaded folder or repository in its dashboard—just like the example below from Storacha.

<figure><img src="/files/PUCxTM7tApBZrb1KqTXo" alt=""><figcaption></figcaption></figure>

To help guide you through this step, we've included a video below showing the process on a Windows setup using a sample 721A art-generated project.

In this video, you'll see how to:

1. Download your images and assets
2. Upload them to a new IPFS host (e.g. Storacha)
3. Copy and save the newly generated CID

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgUBEZKVtA2DMYGTVBbl6%2Fuploads%2FblkJjScjN5AHVw7mCYaV%2FAsset%20upload%20to%20new%20IPFS%20host-clipped.mp4?alt=media&token=b0954ce1-1d17-4cd6-9552-7e25d4236b43>" %}

{% file src="/files/6mfKedbeZkfiKmKV4cbT" %}

### Step 5. Update the new image CID

After uploading your images to your new IPFS host, copy the CID and paste it into the **“CID for image files”** field in your dashboard. Then click **Save image CID** (or **Save animation CID**, if applicable).

Make sure you select the correct **Media format** (such as PNG, JPG, MP4, etc.) based on the files you've uploaded.

A few things to keep in mind:

1. **If your project doesn't include animations**, you can leave the animation CID field blank and continue with the rest of the steps.

   <figure><img src="/files/j3HP1AztcdvcwJGLLZiU" alt=""><figcaption></figcaption></figure>

2. **For 1155 projects**, since the original media formats are used (and may include different file types), you don't need to manually select a media format. Just paste the CID and click **Save**.

<figure><img src="/files/ZuaSSvaerAgSvopfH8do" alt=""><figcaption></figcaption></figure>

### Step 6. Process and update your collection’s metadata with the new image CID

Once you've saved your new image CID, go to **“Process and download the updated metadata with new image URI”** and click **“Update Metadata.”**

This will generate a fresh set of metadata files, now pointing to your newly uploaded images on IPFS.

For example, if your saved CID is:\
`bafybeihwusrv4unp3mxdncfhg6rikbtasjprcy4kndhniwnldjofnkhyba`\
the updated metadata will reference this in each token’s image field.

<figure><img src="/files/MHvwJWDuvd7ZoZNP0FuB" alt=""><figcaption></figcaption></figure>

This process may take a few moments, as it will gather your collection’s existing metadata (based on the “Current Metadata URI”) and replace the image and animation URLs with the new ones you've just saved.

Once it's complete, you'll be able to **download a ZIP file** containing the updated metadata.

<figure><img src="/files/UCqxEWmQZySEW3NCp6EH" alt=""><figcaption></figcaption></figure>

After the download is complete, double-check that the ZIP file isn’t empty and contains your updated metadata files. These files will be numbered and won’t have file extensions—this is expected.

<figure><img src="/files/KTdjtgAE4khcY60RDaJh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/N75khBVZM3EG375RN04U" alt=""><figcaption></figcaption></figure>

If you'd like to double-check that the image and animation URLs in the metadata have been updated correctly, you can drag any of the metadata files into your browser to view its contents. See the example below for a comparison.

In the original metadata, you’ll see a different CID in the `image` field:\
`bafybeibxq6bezazq2iwdhk5p23fwsllbz6372kvulabouxmsuwv35k2gbm`

<figure><img src="/files/33YFh3RcfYdgK8QifvIK" alt=""><figcaption><p>Original metadata</p></figcaption></figure>

In the updated metadata generated by the migration tool, you'll see that it now uses the CID you saved earlier:\
`bafybeihwusrv4unp3mxdncfhg6rikbtasjprcy4kndhniwnldjofnkhyba`

<figure><img src="/files/5ojE8VbOsHPf7WbKscvu" alt=""><figcaption><p>Updated metadata</p></figcaption></figure>

### Step 7. Upload the updated metadata files to your chosen IPFS host

Once you've confirmed that the metadata files have been updated, go ahead and upload all of them—in one folder—to your preferred IPFS host.

We've included a video walkthrough below that covers this step (along with Step 6), shown using a Windows setup. The process is the same for both 721A and 1155 projects, so you can follow along regardless of your collection type.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgUBEZKVtA2DMYGTVBbl6%2Fuploads%2FY1pc7PsbKotnmCUOyagQ%2FMetadata%20updater%20and%20IPFS%20upload%20-%20Made%20with%20Clipchamp.mp4?alt=media&token=440f3bae-d596-4380-8d10-0cf89928c8a2>" %}

{% file src="/files/Grno6MYX3Nrkw1wS8n6u" %}

In this example, the CID provided after uploading the updated metadata is:\
[**bafybeihzx37ul3oucta45yb2paxqesloa66lccs6liamydsi45hw5feqlm**](https://bafybeihzx37ul3oucta45yb2paxqesloa66lccs6liamydsi45hw5feqlm.ipfs.w3s.link/ipfs/bafybeihzx37ul3oucta45yb2paxqesloa66lccs6liamydsi45hw5feqlm)

You can view the contents of this CID here:\
<https://bafybeihzx37ul3oucta45yb2paxqesloa66lccs6liamydsi45hw5feqlm.ipfs.w3s.link/>

### Step 8. Update your collection’s metadata on-chain

Now that you have your new metadata CID, head back to your dashboard and input the updated IPFS URI. The format should be:

```
ipfs://<your CID here>/
```

For this example, it would be:

```
ipfs://ipfs:bafybeihzx37ul3oucta45yb2paxqesloa66lccs6liamydsi45hw5feqlm/
```

<figure><img src="/files/bddBKq0Hn7OmtZxYaDDu" alt=""><figcaption></figcaption></figure>

Click **Validate & Save**, and once everything checks out, you’ll be prompted to sign a transaction through MetaMask. This will update your collection’s metadata on the blockchain.

You can refer to the video below to see how the update process works and how to confirm that the metadata has been successfully changed.

Here are the details of the test collection used in the recording:

1. OpenSea (Testnet) collection link: <https://testnets.opensea.io/collection/yababoo>
2. Project contract on Sepolia: <https://sepolia.etherscan.io/address/0xb90938d30c0f450e9b35bfc66e1e2c8374767bbc>

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgUBEZKVtA2DMYGTVBbl6%2Fuploads%2FXDnHe0lkyb1EH36VktSF%2FUpdate%20metadata%20in%20blockchain%20-%20Made%20with%20Clipchamp.mp4?alt=media&token=e00c0597-aba2-43ed-922a-0a6f553f8742>" %}

{% file src="/files/S3uaCfGOyqIexzvkoS93" %}

You can also confirm if the update was successful by checking your project through a blockchain explorer.

In our example, the project is deployed on **Sepolia (Ethereum)**, so we'll use [sepolia.etherscan.io](https://sepolia.etherscan.io) as the explorer.

Here’s how to check:

1. In the sidebar, click **Smart Contract**
2. Under the **Overview** tab, click the **Contract Address.** Make sure your contract is marked as **Verified**

   If it’s not, you’ll need to click **Verify Now** and complete the verification before continuing<br>

   <figure><img src="/files/qApmtaZZyWyK6vBxQxVm" alt=""><figcaption></figcaption></figure>
3. In the blockchain explorer, click on the **Contract** tab, then select **Read as Proxy**.

   > Note: This option will only appear if your contract has been verified. If you don’t see it, please go back and complete the verification step first.

<figure><img src="/files/xltukaLtCxqLc7FDDMNV" alt=""><figcaption></figcaption></figure>

4. Scroll through the available methods and look for either:

   * **`tokenURI`** – for 721A projects
   * **`uri`** – for 1155 projects

   Click on the appropriate method, enter the token ID you want to check (e.g. `1`), and click **Query**. The current metadata URI for that token will appear below.

<figure><img src="/files/3hApDcV3ozzKbgnRotME" alt=""><figcaption><p><strong>For 1155 projects:</strong><br>Using the <code>uri</code> method, the expected result should follow this format:<br><code>ipfs://&#x3C;cid>/{id}</code> <br>No matter which token ID you input, the result will always display <code>{id}</code> as a placeholder.<br>For example:<br><code>ipfs://bafybeia2ac5urmqdxfs2jvld227za4sngntihhf7gnstzoa2rfqy3ixswu/{id}</code> <br>You can view a sample contract here:<br><a href="https://sepolia.etherscan.io/address/0x0a3f884502aECF6b088ECd248E340791b28EeF78#readProxyContract">https://sepolia.etherscan.io/address/0x0a3f884502aECF6b088ECd248E340791b28EeF78#readProxyContract</a></p></figcaption></figure>

You can also check out the video below, which walks through the steps above using a 721A project. The process is nearly the same for 1155 projects—the only difference is that you'll use the **`uri`** method instead of **`tokenURI`**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgUBEZKVtA2DMYGTVBbl6%2Fuploads%2FIw6mRKmAAG4JytUQl7wx%2FChecking%20change%20in%20URI%20through%20blockchain%20explorer%20-%20Made%20with%20Clipchamp.mp4?alt=media&token=f929c605-b840-4e09-971f-60de6acdf97b>" %}

{% file src="/files/X8tUIaJC3EpzkugyW0qh" %}

Once you've completed all the steps and confirmed that your metadata URI now points to your own IPFS host, your migration is officially complete. You've successfully exported your project's metadata and assets to a location you fully control.

### Step 9. Make sure your NFT appears correctly on marketplaces

After you changed the token URI, make sure to go to one of the marketplaces, refresh metadata of one of the NFTs, and make sure it still displays correctly.&#x20;

***

### **Need help or have questions?**

We’re here for you. If you need any assistance or have questions about the platform or migration process, feel free to reach out to us at <hey@heymint.xyz>.

We'll continue to support users until our closure, but please note that response times may be a bit slower than usual as we operate at limited capacity.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.launchpad.heymint.xyz/migrate/heymint-launchpad-closure-announcement-faqs-and-migration-guide/erc-1155-migration-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.