# mintFreeNFT

## Description

The `mintFreeNFT` function is used to mint a free NFT (Non-Fungible Token) for a specified recipient with the provided metadata. It sends a request to a blockchain explorer API with specific parameters, including the recipient's address and the metadata required to create the NFT. The function then receives a response indicating the status of the minting process.

## Parameters

| Parameter   | Data Type | Description                                                                                                   |
| ----------- | --------- | ------------------------------------------------------------------------------------------------------------- |
| `recipient` | any       | The recipient's address to whom the minted NFT will be transferred.                                           |
| `metadata`  | any       | The metadata required to create the NFT, such as token name, description, and any other relevant information. |

## Response

| Field    | Data Type | Description                                                                                                                                        |
| -------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`   | number    | A code indicating the status of the API request (1 for success, 0 for error).                                                                      |
| `result` | any       | The response data indicating the status of the NFT minting process. The specific structure may vary depending on the blockchain explorer API used. |

## Example Request and Response

### Prerequisites

Before making requests with Volary SDK, you must have it installed.

You can install Volary SDK using either **`npm`** or **`yarn`**. Use the following commands to install Volary SDK:

```sh
npm install @nest25/casper-lib
OR
yarn add @nest25/casper-lib
```

### Request

Here is an example of how to make a `mintFreeNFT` request using the Volary SDK:

```javascript
```

### Response

```sh
{
        code: 1,
        bid_tx_hash: '1ffc4f4ad1458d0355a837d8bfdcb475568dcda6b29ef30eaaee80dbf970e5bb'                                                     aaee80dbf970e5bb'
}
```

## Use Cases

* **Rewarding Users**: In a decentralized application (DApp) or online platform, the `mintFreeNFT` function can be used to reward users with free NFTs as part of promotional events, loyalty programs, or achievements.
* **Minting Collectibles**: The function can be employed in collectible NFT projects, where users can mint their own unique NFTs with custom metadata representing collectible items, artwork, or game assets.
* **NFT Giveaways**: For marketing or community engagement purposes, the function can be used to conduct NFT giveaways, allowing users to claim NFTs for free within a specified timeframe.
* **Airdrops**: In token airdrop campaigns, the `mintFreeNFT` function can be utilized to distribute NFTs to recipients who meet certain criteria, such as holding a specific token or being part of a particular community.
* **Testing and Development**: During the development and testing phase of an NFT-related project, the function can be used to create test NFTs with predefined metadata for simulation and debugging purposes.


---

# 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.volary.io/sdks-guide/blockchain-sdks/casper-sdk/mintfreenft.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.