> For the complete documentation index, see [llms.txt](https://docs.capsulelabs.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.capsulelabs.xyz/capsulenft/developer-walkthroughs/developer-mint-a-capsule-nft.md).

# Developer - Mint a Capsule NFT

Users have the option to store tokens within a Capsule NFT at the time of mint and embed the Capsule NFT with artwork. At current date, the tokens stored within Capsule NFTs can be ERC-20 tokens, ERC-721 tokens (including Capsule NFTs), or ERC-1155 tokens. You are also able to create Simple Capsule NFTs, which hold no tokens and function as basic ERC-721 NFTs. All Capsule NFTs are minted from Capsule Collections, which you can learn about in [Developer - Create a Capsule Collection](/capsulenft/developer-walkthroughs/developer-create-a-capsule-collection.md).

Below are some examples of creating your own Capsule NFT using a pre-existing Capsule Collection.

### Methodology

In order to create a Capsule NFT you must**:**

1. [Select a Capsule Collection](#selecting-a-capsule-collection) from which it will be minted (this could be your Capsule Collection, or anyone else's public Capsule Collection)
2. Decide which type of Capsule NFT you'd like to create
   * Simple Capsule NFT (a basic ERC-721 Token)
   * ERC-20 Capsule NFT (a Capsule NFT which holds any number of ERC-20 tokens)
     * Depending on the amount of different tokens stored within the ERC-20 Capsule NFT, you will need to decide between methods `mintSingleERC20Capsule` (storing one token) and `mintMultiERC20Capsule` (storing two or more tokens)
   * ERC-721 Capsule NFT (a Capsule NFT which holds any number of ERC-721 tokens)
     * Depending on the amount of different NFTs stored within the ERC-721 Capsule NFT, you will need to decide between methods `mintSingleERC721Capsule` (storing one NFT) and `mintMultiERC721Capsule` (storing two or more NFTs)
   * ERC-1155 Capsule NFT (a Capsule NFT which holds any number of ERC-1155 tokens)
     * Only `mintMultiERC1155Capsule` is available to users and can still be used to store a single ERC-1155 token.
3. (if not a Simple Capsule NFT) - supply the Capsule NFT with the token(s) to store

#### Selecting a Capsule Collection

You'll need the address of the Capsule Collection you'd like to mint the Capsule NFT from. This can be found on the [CapsuleNFT Application](https://docs.capsulelabs.xyz/capsulenft/developer-walkthroughs/www.capsulenft.com/app) Collections Tab, by obtaining a response from the [Create a Capsule Collection](/capsulenft/developer-walkthroughs/developer-create-a-capsule-collection.md) method (upon creation), or by calling `getCapsuleCollectionsOf` and passing in an address as a parameter. This Capsule Collection address will be in the form of `0x...`.

### Capsule NFT Types and Methods

More information on the methods below can be found at the [CapsuleMinter.sol](/capsulenft/developer-walkthroughs/contracts/capsuleminter.sol.md) page. Depending on the type of Capsule NFT you are creating, you will call either:

#### [Simple Capsule NFT](#example-simple-capsule-nft-mint-call)

```solidity
function mintSimpleCapsule(address _capsule, string _uri, address _receiver) external payable
```

#### [ERC-20 Capsule NFT or Multi ERC-20 Capsule NFT](#erc-20-capsule-nft-minting)

{% code overflow="wrap" %}

```solidity
function mintSingleERC20Capsule(address _capsule, address _token, uint256 _amount, string _uri, address _receiver) external payable
```

{% endcode %}

{% code overflow="wrap" %}

```solidity
function mintMultiERC20Capsule(address _capsule, address[] _tokens, uint256[] _amounts, string _uri, address _receiver) external payable
```

{% endcode %}

#### [ERC-721 Capsule NFT or Multi ERC-721 Capsule NFT](#erc-721-capsule-nft-minting)

{% code overflow="wrap" %}

```solidity
function mintSingleERC721Capsule(address _capsule, address _token, uint256 _id, string _uri, address _receiver) external payable
```

{% endcode %}

{% code overflow="wrap" %}

```solidity
function mintMultiERC721Capsule(address _capsule, address[] _tokens, uint256[] _ids, string _uri, address _receiver) external payable
```

{% endcode %}

#### [Multi ERC-1155 Capsule NFT](#erc-1155-capsule-nft-minting)

Only `mintMultiERC1155Capsule` is available to the user. **Note: you can still create ERC-1155 Capsule NFTs that store a single token using this method.**

{% code overflow="wrap" %}

```solidity
function mintMultiERC1155Capsule(address _capsule, address[] _tokens, uint256[] _ids, string _uri, address _receiver) external payable
```

{% endcode %}

### Example Simple Capsule NFT Mint Call

An example call to create a Simple Capsule NFT is shown here:

```
mintSimpleCapsule(
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // Capsule Collection address
    "ipfs://bafyreibfmk7yeraghmiw5eygdjzjhgc2pqyh5ycyg5d2tm2lg5c2bop2by/metadata.json", // tokenURI/link to Metadata
    "0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db", // address to receive minted Capsule NFT
    { value: 0.001 }
);
```

This call will create a Simple Capsule NFT:

* In the Capsule Collection at address `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
* With `tokenURI` (metadata) linking to `ipfs://bafy...p2by/metadata.json`
* And send that Simple Capsule NFT to the address `0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db`
* With ETH fee amount specified. This is the [required amount to create](/economics/fee-structure.md) a Capsule NFT.

### ERC-20 Capsule NFT Minting

Note that two different methods, `mintSingleERC20Capsule` and `mintMultiERC20Capsule` are available to the user.

`mintSingleERC20Capsule` is an optimized function meant to save the user gas in the case where only a single ERC-20 token would be embedded within a Capsule NFT. 

`mintMultiERC20Capsule` is a function meant to be called when more than one different token is meant to be embedded within a Capsule NFT. **Note: you can create ERC-20 Capsule NFTs that store one token using the** `mintMultiERC20Capsule` **method, but it would be gas inefficient to do so.**

#### Example Single ERC-20 Capsule NFT Mint Call

An example call to create a Single ERC-20 Capsule NFT is shown here:

```
mintSingleERC20Capsule(
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // Capsule Collection address
    "0x1b40183EFB4Dd766f11bDa7A7c3AD8982e998421", // Token address
    200000000000000000000, // Token amount
    "ipfs://bafyreibfmk7yeraghmiw5eygdjzjhgc2pqyh5ycyg5d2tm2lg5c2bop2by/metadata.json", // tokenURI/link to Metadata
    "0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db", // address to receive minted Capsule NFT
    { value: 0.001 }
);
```

This call will create a Single ERC-20 Capsule NFT:

* In the Capsule Collection at address `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
* Storing `200` of the token at `0x1b40183EFB4Dd766f11bDa7A7c3AD8982e998421`
  * (Assuming 18 decimals)
* With `tokenURI` (metadata) linking to `ipfs://bafy...p2by/metadata.json`
* And send that Single ERC-20 Capsule NFT to the address `0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db`
* With ETH fee amount specified. This is the [required amount to create](/economics/fee-structure.md) a Capsule NFT.

#### Example Multi ERC-20 Capsule NFT Mint Call

An example call to create a Multi ERC-20 Capsule NFT is shown here:

```
mintMultiERC20Capsule(
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // Capsule Collection address
    [
        "0x1b40183EFB4Dd766f11bDa7A7c3AD8982e998421",
        "0xa3d58c4E56fedCae3a7c43A725aeE9A71F0ece4e"
    ], // Token addresses in an array
    [
        200000000000000000000,
        100000000000000000000
    ], // Token amounts in an array
    "ipfs://bafyreibfmk7yeraghmiw5eygdjzjhgc2pqyh5ycyg5d2tm2lg5c2bop2by/metadata.json", // tokenURI/link to Metadata
    "0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db", // address to receive minted Capsule NFT
    { value: 0.001 }
);
```

This call will create a Multi ERC-20 Capsule NFT:

* In the Capsule Collection at address `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
* Storing both:
  * `200` of the token at `0x1b40183EFB4Dd766f11bDa7A7c3AD8982e998421`
    * (Assuming 18 decimals)
  * `100` of the token at `0xa3d58c4E56fedCae3a7c43A725aeE9A71F0ece4e`
    * (Assuming 18 decimals)
* With `tokenURI` (metadata) linking to `ipfs://bafy...p2by/metadata.json`
* And send that Multi ERC-20 Capsule NFT to the address `0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db`
* With ETH fee amount specified. This is the [required amount to create](/economics/fee-structure.md) a Capsule NFT.

### ERC-721 Capsule NFT Minting

Note that two different methods, `mintSingleERC721Capsule` and `mintMultiERC721Capsule` are available to the user.

`mintSingleERC721Capsule` is an optimized function meant to save the user gas in the case where only a single ERC-721 token would be embedded within a Capsule NFT. 

`mintMultiERC721Capsule` is a function meant to be called when more than one different token is meant to be embedded within a Capsule NFT. **Note: you can create ERC-721 Capsule NFTs that store one token using the** `mintMultiERC721Capsule` **method, but it would be gas inefficient to do so.**

#### Example Single ERC-721 Capsule NFT Mint Call

An example call to create a Single ERC-721 Capsule NFT is shown here:

```
mintSingleERC721Capsule(
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // Capsule Collection address
    "0x1a0a69a267b3e72d22dEB970b2Cc6296aC31A80c", // NFT address
    1, // NFT ID
    "ipfs://bafyreibfmk7yeraghmiw5eygdjzjhgc2pqyh5ycyg5d2tm2lg5c2bop2by/metadata.json", // tokenURI/link to Metadata
    "0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db", // address to receive minted Capsule NFT
    { value: 0.001 }
);
```

This call will create a Single ERC-721 Capsule NFT:

* In the Capsule Collection at address `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
* Storing the NFT of ID `1` from `0x1a0a69a267b3e72d22dEB970b2Cc6296aC31A80c`
* With `tokenURI` (metadata) linking to `ipfs://bafy...p2by/metadata.json`
* And send that Single ERC-721 Capsule NFT to the address `0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db`
* With ETH fee amount specified. This is the [required amount to create](/economics/fee-structure.md) a Capsule NFT.

#### Example Multi ERC-721 Capsule NFT Mint Call

An example call to create a Multi ERC-721 Capsule NFT is shown here:

```
mintMultiERC721Capsule(
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // Capsule Collection address
    [
        "0x1a0a69a267b3e72d22dEB970b2Cc6296aC31A80c",
        "0xECE3053E1e7C4Dd365975e8AB4Db7D1b238e30B6"
    ], // NFT addresses in an array
    [
        1,
        15
    ], // NFT IDs in an array
    "ipfs://bafyreibfmk7yeraghmiw5eygdjzjhgc2pqyh5ycyg5d2tm2lg5c2bop2by/metadata.json", // tokenURI/link to Metadata
    "0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db", // address to receive minted Capsule NFT
    { value: 0.001 }
);
```

This call will create a Multi ERC-721 Capsule NFT:

* In the Capsule Collection at address `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
* Storing both:
  * The NFT of ID `1` from `0x1a0a69a267b3e72d22dEB970b2Cc6296aC31A80c`
  * The NFT of ID `15` from `0xECE3053E1e7C4Dd365975e8AB4Db7D1b238e30B6`
* With `tokenURI` (metadata) linking to `ipfs://bafy...p2by/metadata.json`
* And send that Multi ERC-721 Capsule NFT to the address `0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db`
* With ETH fee amount specified. This is the [required amount to create](/economics/fee-structure.md) a Capsule NFT.

### ERC-1155 Capsule NFT Minting

For ERC-1155 tokens, only `mintMultiERC1155Capsule` is available to the user.

`mintMultiERC1155Capsule` is a function meant to be called when more than one different token is meant to be embedded within a Capsule NFT. **Note: you can still create ERC-1155 Capsule NFTs that store a single token using the** `mintMultiERC1155Capsule` **method.**

#### Example Multi ERC-1155 Capsule NFT Mint Call

An example call to create a Multi ERC-1155 Capsule NFT is shown here:

```
mintMultiERC1155Capsule(
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // Capsule Collection address
    [
        "0xe8aE4BfD7521d26283bc14f2395675144AA65e6d",
        "0xd07dc4262BCDbf85190C01c996b4C06a461d2430"
    ], // ERC-1155 NFT addresses in an array
    [
        1,
        15
    ], // ERC-1155 NFT IDs in an array
    [
        2,
        1
    ], // ERC-1155 Token amounts in an array
    "ipfs://bafyreibfmk7yeraghmiw5eygdjzjhgc2pqyh5ycyg5d2tm2lg5c2bop2by/metadata.json", // tokenURI/link to Metadata
    "0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db", // address to receive minted Capsule NFT
    { value: 0.001 }
);
```

This call will create a Multi ERC-1155 Capsule NFT:

* In the Capsule Collection at address `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
* Storing both:
  * The NFT of ID `1` from `0xe8aE4BfD7521d26283bc14f2395675144AA65e6d`
    * of which we will store `2` tokens
  * The NFT of ID `15` from `0xd07dc4262BCDbf85190C01c996b4C06a461d2430`
    * of which we will store `1` token
* With `tokenURI` (metadata) linking to `ipfs://bafy...p2by/metadata.json`
* And send that Multi ERC-1155 Capsule NFT to the address `0xB58992cfA9B39A2FFA0dd286248503A2eFbc65Db`
* With ETH fee amount specified. This is the [required amount to create](/economics/fee-structure.md) a Capsule NFT.