> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kingdomly.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Contract deployment

## Overview

### Pre-requisites

* You must have a mint page created and published.
* You must have a mint groups created and supply allocated.

### Deploy your mint contract

Deploying your mint contract is the **final step** in setting up your mint page. Having a **deployed contract** enables you to access the following features:

* **Manage whitelists and mint quotas**
* **Enable eligibility checker** for your mint
* **Manage your mint's supply and price**
* **Airdrop your NFTs**
* **Set up your mint's schedule and visibility**
* **Start your mint!**

<img src="https://mintcdn.com/kingdomly/dd_C12WmecYoJdK_/images/deployment-setup.gif?s=542a4962de6dd61bc58ea1c70cc8cb63" alt="Deployment Setup" width="760" height="480" data-path="images/deployment-setup.gif" />

## Mint Contract Details

### Default Standard

* Our contracts use **ERC721AC** as the default token standard for chains that support it.
* For chains that don't yet support ERC721AC, we use **ERC721A** as an alternative.
* **ERC721AC** includes enforced royalties functionality, while **ERC721A** is the standard implementation without enforced royalties.

**Mainnet Chains**

| Chain           | Enforced Royalties | Contract Standard |
| --------------- | ------------------ | ----------------- |
| Ethereum        | ✅ Yes              | ERC721AC          |
| Arbitrum One    | ✅ Yes              | ERC721AC          |
| Base Mainnet    | ✅ Yes              | ERC721AC          |
| Berachain       | ✅ Yes              | ERC721AC          |
| Mitosis Mainnet | ❌ No               | ERC721A           |
| HyperEVM        | ❌ No               | ERC721A           |
| Sophon          | ❌ No               | ERC721A           |

**Testnet Chains**

| Chain            | Enforced Royalties | Contract Standard |
| ---------------- | ------------------ | ----------------- |
| Ethereum Sepolia | ✅ Yes              | ERC721AC          |
| Arbitrum Sepolia | ✅ Yes              | ERC721AC          |
| Base Sepolia     | ✅ Yes              | ERC721AC          |
| MegaETH Testnet  | ❌ No               | ERC721A           |
| Monad Testnet    | ❌ No               | ERC721A           |

<Note>
  On some chains, we use ERC721A as an alternative to ERC721AC due to the lack of support for enforced royalties.
</Note>

**Contract Standards Documentation:**

* [ERC721A Documentation](https://chiru-labs.github.io/ERC721A/) - Gas-optimized NFT contract standard
* [ERC721AC Documentation](https://github.com/chiru-labs/ERC721A/tree/main/contracts/extensions) - ERC721A with enforced royalties extension

***

### Factory Deployment

* Contracts are deployed through a **contract factory**.
* This ensures consistent deployment and allows Kingdomly to **easily index all mint contracts** created on the platform.

All contracts are deployed through our factory contract at the following address across all supported chains:

**Mainnet Chains**

| Chain           | Factory Address                              |
| --------------- | -------------------------------------------- |
| Ethereum        | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Arbitrum One    | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Base Mainnet    | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Berachain       | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Mitosis Mainnet | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| HyperEVM        | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Sophon          | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |

**Testnet Chains**

| Chain            | Factory Address                              |
| ---------------- | -------------------------------------------- |
| Ethereum Sepolia | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Arbitrum Sepolia | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Base Sepolia     | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| MegaETH Testnet  | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |
| Monad Testnet    | `0x07b429f9dd10c3e6fa98467239df973633bb3fb3` |

<Note>
  The same factory address is used across all chains for consistency and easier contract verification.
</Note>

***

### Fees

By default, Kingdomly charges:

* **\$3 + 3% of the total mint fee price** per mint.
* For airdrops, the fee is **\$0.33 per airdrop / burn**.

**Example**

* If a creator sets their mint price at **0.05 ETH** (assume 1 ETH = \$4,500):
  * 0.05 ETH = \$50 mint price.
  * Kingdomly's fee = **$3 + (3% of $50)** = $3 + $1.50 = **\$4.50**.
  * Total cost to minter = $50 + $4.50 = **\$54.50**.

Since our fees are pegged to **USD**, a **price oracle** is used each time a mint occurs to ensure the native chain currency matches the correct fee equivalent.

***

### Custom Contracts

Custom contracts are available only to **Kingdomly Partners**.

We have a proven history of supporting advanced contract features, including:

* **Merkle Tree Contracts**: Ideal for L1 chains like Ethereum where gas costs are high, enabling cheaper whitelist management through merkle tree verification.
* **Open Edition Contracts**: Ready to use support for open edition style mints with unlimited supply capabilities.
* **Lucky Mint**: A randomized minting mechanism that gives users a chance to receive bonus NFTs beyond their initial purchase for added excitement.
* **Referral Systems**: Custom contract implementations that reward users for bringing new minters to a project, enabling viral growth through incentivized sharing.

For more custom contract support, please contact us at [dev@kingdomly.app](mailto:dev@kingdomly.app) or join our [Discord](https://discord.gg/DnGENNCMgs).

***

### Future Support

* We currently support **ERC721AC** contracts.
* **ERC1155 contracts** will be added in the future for creators who want to mint semi-fungible tokens or manage multiple token types under a single contract.

***
