# Manage Token

To[ manage an existing token](https://tokentool.bitbond.com/managetoken) you need to connect the **wallet that owns the token contract** in Token Tool. After that, enter the **token contract address**. Alternatively you can also click on the token that you want to manage from the drop down or the list of tokens shown on the page. Make sure that your wallet is connected to the same network as the one on which the token was created.

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

### Token verification with custom contract name

Token verification is available on all supported mainnet and testnet networks except for peaq network. Contracts created with Token Tool can be verified on multiple block explorers, you can see supported explorers in the verification process.

All tokens created with Token Tool will have **Bitbond branding** by default as the name of the contract file. You can however change the default name to your own custom contract name for an extra fee upon creating the token.

To do that, when creating your token, simply enable "Set Custom Token Contract Name" by turning on toggle. Then type the name you desire in **PascalCase (e.g. MyTokenProject):**

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

<mark style="color:red;">The custom contract name cannot be changed once the token is created and deployed.</mark>

Example of a verified token contract on the block explorer **without** a custom name:

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

Example of a verified token contract on the block explorer **with** a custom name:

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

The custom contract name verification will be complete once you complete the steps in the **Verify Source Code** sectio&#x6E;**.**

### Verify source code of contracts

Source code verification is supported for all contracts created via Token Tool.

Here is an example process for how you can complete verification for a token contract. The process is similar across other contracts, you should simply follow the same steps from their designated sections within Token Tool.

To verify token contract source code for a Token, go to [Manage Token](https://tokentool.bitbond.com/managetoken/) and select your token. Then click the **Verify Source Code** button:

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

Then select the block explorer on which you wish to have the contract verified. You can choose from supported explorers, and you can perform verification on more than just one block explorer:

<figure><img src="/files/9amxE00kaUHV20yi5UY3" alt=""><figcaption></figcaption></figure>

Then click next and choose the type of verification you wish to complete. **Please note that contract source code verification is possible in three different options**:

1. Source code verification with Bitbond branding
2. Source code verification Bitbond branding removed
3. Source code verification with your own custom branding

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

Select the verification option you desire, agree on the terms, and then click "Submit". Confirm transaction in your wallet to pay fees and complete the verification. Once the transaction is complete, you will be able to see the source contract verified and publicly displayed on the block explorer.

Click the "View verified contract" to see your token contract on the explorer. [Here is an example](https://sepolia.etherscan.io/address/0x8275C0B2D412bCef3d0d79C5dF0552AF0A6F97C0#code):

<figure><img src="/files/2ZqSshzfAFRiR31lASqQ" alt=""><figcaption></figcaption></figure>

Here is how your token contract source code looks like on the block explorer with the default Bitbond branding:

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

Here is how your token's contract source code without any branding:

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

Here is how your token's contract source code with your own branding:

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

### Token configuration

You can control the following parameters of your token. Please note that some of these parameters can only be changed, if the respective function was activated at the initial token creation. Some of these settings are only possible for certain token types:

* Mint (only possible if activated at creation)
* Burn (only possible if activated at creation)
* Change owner (always possible)
* Renounce ownership (always possible)
* Blacklist address (only possible if activated at creation)
* Pause (only possible if activated at creation)
* Transaction tax / fee (only possible if activated at creation). You can exclude addresses from being taxed by adding them to the exclusion list. **Add the LP address to exclusion list for it to be traded on V3. Tax will not apply on transactions that take place on V3 DEXes.**
* Deflation settings (only possible if activated at creation). **Add the LP address to exclusion list for it to be traded on V3. Deflation will not apply on transactions that take place on V3 DEXes.**
* Holders Reward / Reflection Token (only possible if activated at creation) . You can prevent addresses from receiving holders rewards by adding them to the exclusion list. **Add the LP address to exclusion list for it to be traded on V3. Holders rewards will not apply on transactions that take place on V3 DEXes.**
* Add a liquidity pool to a decentralized exchange. This feature <mark style="color:red;">may not work for tokens that have</mark> [<mark style="color:red;">Asset Token Configuration</mark>](#token-configuration) <mark style="color:red;">features activated</mark>.
* Edit asset documentation (only possible if activated at creation)
* Add or remove whitelisted addresses (only visible and possible if activated at creation)
* Change tokens per address limit (only possible if activated at creation) – note that you can only increase the limit but not decrease it in order to avoid creating a conflict with the amount of tokens that could be held per address prior to the change. This feature is also called "whale protection". You can exclude specific wallet addresses by adding them to the exclusion list. Once added to the exclusion list, the limit would not apply to these wallets. This can be useful when adding a liquidity pool to DEX.\
  **Note when creating a liquidity pool:** make sure to fund it with an amount within the limit, you can then add the liquidity pool (LP) address to the exclusion list once the pool is created. Excluding the LP address from this limit will allow you to fund the pool with a higher amount than the limit set.
* Force transaction to move tokens from any wallet address to another address (only possible if activated at creation)

Manage Token is particularly useful if you want to execute **corporate actions** that have an impact on existing or to be newly minted tokens / shares.

**View of Manage Advanced Token**

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

**View of Manage Asset Token**

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

### Add liquidity pool to DEX

This feature enables you to easily submit and add a liquidity pool for your token on a decentralized exchange (DEX). Feel free to try it on testnets prior to proceeding with mainnet transactions.

Start by clicking the "Add liquidity pool to DEX" button under the Manage Token page. Then select the DEX of choice from the presented options by creating a new pool. If you already have an existing pool, you can choose top "Top Up" that LP after clicking the add liquidity button.

<figure><img src="/files/TEZM9Vb6GM0I84qSFiXv" alt="" width="375"><figcaption></figcaption></figure>

**Note: If your token has holder rewards, burn fee or tax, it needs to be set to 0.** After adding/topping up the liquidity pool (LP), modify it back to the desired rate. If your token has a max limit per holder / whale protection set up, ensure to add the initial LP within the limits, you can then add the LP contract address to the exclusion list under Manage Token and increase the liquidity as needed.

Next, insert the pair amount you wish to submit to the LP. After that, click "Approve" to allow the sending of the tokens and confirm the transaction in your wallet. Once completed, proceed with clicking "Submit", confirm the transaction in your wallet.

<figure><img src="/files/P5cyOG75N7b4xXJ18bAM" alt="" width="375"><figcaption></figcaption></figure>

After the transaction is processed, your liquidity pool will be submitted to the selected DEX.

<figure><img src="/files/28P1DQtOrG1MBh05n6gi" alt="" width="375"><figcaption></figcaption></figure>

You can then return to this page to modify existing pool ratios for your LP by topping it up.

### Add and Manage Liquidity for Tokens with Fees and Holder Limits

The **Add Liquidity** function on Token Tool is designed to simplify the process of submitting liquidity to decentralized exchanges (DEXs) like Uniswap or PancakeSwap. It acts as an intermediary, allowing you to add liquidity in a user-friendly way without needing to interact directly with the DEX platform.

Token Tool is **not a DEX protocol**. We do not have control over platforms like Uniswap or PancakeSwap. Our feature is solely meant to help you submit liquidity to these protocols more easily. This guide explains how to add and manage liquidity for tokens with fees (tax, deflation, holders reward) and/or a maximum limit per address.

#### 1. Adding Liquidity for Tokens with Fees

* You can add liquidity even if token fees are enabled.
* If fees are not set to 0, they will be deducted when adding liquidity.
* Recommendation: Temporarily set fees to 0 when adding liquidity. This ensures the pool ratios remain correct.

#### 2. Adding Initial Liquidity for Tokens with Max Limit per Address enabled

* Add liquidity using a token amount that is smaller or equal to the maximum limit per address.
* As long as the LP (Liquidity Pool) address is not excluded, tax will apply to any swaps involving that LP.
* Swapping in both directions (buy/sell) should work fine at this stage.

#### 3. Excluding the LP Address

After liquidity is added, you can exclude the LP contract address to achieve the following:

1. Disable tax on transactions involving the LP (i.e. swaps).
2. Remove the max limit per address, allowing you to fund the LP with an amount greater than the limit.

When the LP address is excluded:

* Swapping: Swaps will continue to work.
* Tax: No fees will be charged on swap transactions involving the LP address.
* Max Limit: You can now add liquidity beyond the original max limit per address.

⚠️ Important: Once you finish funding the LP remove the LP address from the exclusion list to re-enable tax and max limit restrictions.

#### 4. Fixing Pool Ratio Issues

If tax is applied or swaps occur during the initial LP setup, the pool ratios may get disrupted. This can cause issues, especially if slippage tolerance is low or set to 0.

To try and fix this issue:

1. Go directly to the DEX platform where the liquidity is added (Uniswap, PancakeSwap etc.).
2. Remove 100% of the liquidity from the pool.
3. Re-fund the LP with the correct amount of tokens.
4. While re-funding, exclude the LP address to temporarily disable tax and remove the max limit.

⚠️ Reminder: Once the LP is successfully funded, remove the LP address from the exclusion list to restore tax and max holder limit functionality.

**Crucial Note on Pool Ratios:**

* **Correct Ratio at the Start**: It is **critical** to submit the correct ratio of tokens when adding initial liquidity. If the wrong ratio is submitted initially, it **cannot be fully fixed** later.
* **DEX Protocol Behavior**: Even when you remove 100% of the liquidity, the DEX protocol retains a **very small ratio** of the token pair. This ensures that the ratio is maintained in case liquidity is added to the same token contract address in the future.

#### 5. Finalizing the LP Setup

After re-funding the LP or adding tokens beyond the limit:

1. Remove the LP address from the exclusion list.
2. Swaps will now work, and taxes will apply as intended.

If a swap fails: Increase your slippage tolerance to account for adjusted pool ratios.

#### 6. Adding Liquidity Beyond the Address Limit

To fund the LP with an amount greater than the max limit per address:

1. Exclude the LP address temporarily.
2. Add the desired amount of liquidity.
3. Once done, remove the LP address from the exclusion list.

⚠️ Note: While the LP address is excluded, tax will not apply, and the max limit restriction is bypassed.

By following these steps, you can seamlessly add and manage liquidity for tokens with fees and address limits while ensuring smooth swap functionality and proper tax enforcement.

#### Supported decentralied exchanges (DEXes):

* Ethereum: Uniswap V2, SushiSwap V2
* Avalanche: Trader Joe V1, Uniswap V2, SushiSwap V2
* Polygon PoS: Quickswap V2, Uniswap V2, ApeSwap, SushiSwap V2
* BNB Chain: PancakeSwap V2, Uniswap V2, ApeSwap, SushiSwap V2
* Fantom: SpookySwap V2, WigoSwap, SushiSwap V2
* Arbitrum: Camelot V2, Uniswap V2, Trader Joe V1, SushiSwap V2
* Optimism: Uniswap V2, SushiSwap V2
* Base: Uniswap V2, BaseSwap V2, SwapBased V2, SushiSwap V2
* Blast: BlasterSwap V2, Uniswap V2, SushiSwap V2


---

# 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.bitbond.com/asset-tokenization-suite/token-tool/create-token/manage-token.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.