Skip to content

Commit 62705be

Browse files
update guide to include UX improvements (#2582)
* update guide to include UX improvements * update wallet info * Update token-manager.mdx * remove video placeholder * update changelog
1 parent 5698f59 commit 62705be

File tree

10 files changed

+52
-26
lines changed

10 files changed

+52
-26
lines changed

public/changelog.json

+7
Original file line numberDiff line numberDiff line change
@@ -282,6 +282,13 @@
282282
}
283283
},
284284
"data": [
285+
{
286+
"category": "release",
287+
"date": "2025-05-09",
288+
"description": "This release introduces major improvements to session flexibility, authorization flows, and multi-network deployments. Add or deploy a new token today via [Token Manager](https://tokenmanager.chain.link/).",
289+
"title": "Token Manager Updates",
290+
"topic": "General"
291+
},
285292
{
286293
"category": "integration",
287294
"date": "2025-05-08",
Loading
Loading
Loading
Loading
Loading
Loading
98.1 KB
Loading
Loading

src/content/ccip/tutorials/token-manager.mdx

+45-26
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ import CcipCommon from "@features/ccip/CcipCommon.astro"
1313
CCIP Contact form](https://chain.link/ccip-contact?v=Token%20Manager%20support).
1414
</Aside>
1515

16-
The Token Manager allows token developers to deploy, configure, and manage Cross-Chain Tokens (CCTs) in a simplified web interface.
16+
The Token Manager allows token developers to deploy, configure, and manage Cross-Chain Tokens (CCTs) in a simplified web interface. The process involves deploying tokens and token pools, registering administrative roles, and configuring token pools to enable secure token transfers using CCIP.
1717

18-
The process involves deploying tokens and token pools, registering administrative roles, and configuring token pools to enable secure token transfers using CCIP. The Token Manager guides you through two workflows:
18+
The Token Manager guides you through two workflows:
1919

2020
- **Deploy a new token from scratch**: This is the more beginner-friendly workflow that guides you through the entire process step-by-step, starting by creating a token from scratch.
2121
- **Enable an existing token to go cross-chain**: This is a more advanced workflow for token developers who have already deployed their token and want to add cross-chain capabilities.
@@ -24,25 +24,35 @@ If you prefer to manage your deployments and configurations programmatically, re
2424

2525
You can also use the [CCIP JavaScript SDK](/ccip/ccip-javascript-sdk) to add a fully featured CCIP bridge to your app that can be styled to match your app design.
2626

27+
After enabling your tokens, you can also use Transporter to perform transfers and import tokens with the contract address. Use [test.transporter.io](https://test.transporter.io) for testnet or [transporter.io](https://transporter.io) for mainnet.
28+
2729
## Limitations
2830

2931
Currently, the following advanced features are not yet supported in Token Manager:
3032

3133
- **Token pool replacements and upgrades for existing tokens**. This capability will be added in a subsequent update. To learn more about the process of replacing and upgrading existing token pools, review the [CCIP token pool upgradability](/ccip/concepts/cross-chain-tokens#token-pool-upgradability) section.
32-
- **Deployment of token pools that use the [Lock and Unlock mechanism](/ccip/concepts/cross-chain-tokens#token-handling-mechanisms-and-token-pool-deployment)**. In this use case, tokens are locked on the source blockchain, and an equivalent amount of tokens are released on the destination blockchain.
34+
- **Deployment of token pools that use the [Lock and Unlock mechanism](/ccip/concepts/cross-chain-tokens#token-handling-mechanisms-and-token-pool-deployment)**. The Token Manager Wizard automatically configures all tokens with the Burn & Mint mechanism. (Refer to the [Burn & Mint token contract](https://github.com/smartcontractkit/chainlink/blob/contracts-ccip/v1.6.0-beta.0/contracts/src/v0.8/ccip/tokenAdminRegistry/TokenPoolFactory/FactoryBurnMintERC20.sol) and [Burn & Mint token pool contract](https://github.com/smartcontractkit/chainlink/blob/contracts-ccip/v1.6.0-beta.0/contracts/src/v0.8/ccip/pools/BurnMintTokenPool.sol) for the Burn & Mint mechanism.)
3335
- Deployment or enablement of custom token pools is not yet supported.
34-
- Adding a new network is currently supported if the Token Admin address is the same for each network. This capability will be expanded in a subsequent update to enable multiple Token Admin addresses across different networks.
3536

3637
## Getting started
3738

38-
1. Open the Token Manager, which has separate links for testnet and mainnet. It is highly recommended to test and perform any operations on testnet before mainnet:
39+
The Token Manager includes both testnet and mainnet functionality. It is highly recommended to test and perform any operations on testnet before mainnet.
40+
41+
Before you can deploy a new token or add an existing token, you need to connect and authorize your wallet.
42+
43+
1. Open the Token Manager using the appropriate link for your use case:
3944

4045
- For testnet, use [https://test.tokenmanager.chain.link](https://test.tokenmanager.chain.link).
4146
- For mainnet, use [https://tokenmanager.chain.link/](https://tokenmanager.chain.link/)
4247

43-
1. Connect your wallet using the **Connect wallet** button in the upper right corner.
48+
1. Connect your wallet using the **Connect wallet** button in the upper right corner. The following wallets are supported:
49+
50+
- Metamask (EOA)
51+
- Coinbase wallet (EOA)
52+
- WalletConnect (EOA & Safe)
53+
- Rabby wallet (EOA & Safe)
4454

45-
After your wallet is connected, you'll see the Token Manager homepage.
55+
1. After your wallet is connected, authorize the use of your wallet by clicking **Authorize** and complete the subsequent authorization flow for your wallet type. If you are connecting a Safe wallet, authorization is key to enabling permissioned actions on a per user basis; such as initiating transactions, updating off-chain data, and inviting collaborators.
4656

4757
## Deploy a new token
4858

@@ -52,60 +62,69 @@ After your wallet is connected, you'll see the Token Manager homepage.
5262
research before engaging with any tokens.
5363
</Aside>
5464

55-
If you haven't deployed your token to any networks yet, you can start here. This Token Manager Wizard automatically configures all tokens with the Burn & Mint mechanism. (Refer to the [Burn & Mint token contract](https://github.com/smartcontractkit/chainlink/blob/contracts-ccip/v1.6.0-beta.0/contracts/src/v0.8/ccip/tokenAdminRegistry/TokenPoolFactory/FactoryBurnMintERC20.sol) and [Burn & Mint token pool contract](https://github.com/smartcontractkit/chainlink/blob/contracts-ccip/v1.6.0-beta.0/contracts/src/v0.8/ccip/pools/BurnMintTokenPool.sol) for the Burn & Mint mechanism.)
65+
1. Once wallet connection and authorization is complete, click **Add new token** under the **My tokens** section of the Token Manager Dashboard.
66+
67+
1. In the Token Manager Wizard, select **Deploy a new token** and click **Continue** in the lower right corner.
68+
69+
<ClickToZoom src="/images/ccip/token-manager/new/start-0.png" alt="Select deploy a new token" />
5670

5771
1. On the **Details** page, enter the details for the first network you're configuring for your token deployment:
5872

5973
- Select the network in the **Network** dropdown field.
60-
- Fill in the **Name** and **Symbol** fields to give your token its name and ticker symbol. For example, "Your Token" and "YOURS" respectively:
74+
- Fill in the **Name** and **Symbol** fields to give your token its name and ticker symbol. For example, "Your Token" and "YOURS" respectively.
75+
- Click **Continue**.
6176

62-
<ClickToZoom src="/images/ccip/token-manager/new/1-details.png" alt="Naming your new token" />- Click **Continue**.
77+
<ClickToZoom src="/images/ccip/token-manager/new/details-1.png" alt="Naming your new token" />
6378

6479
1. On the **Settings** page, configure your token's supply:
6580

6681
- Setting a supply cap is optional &mdash; toggle the button to enable it and specify an amount. The supply cap sets a maximum limit for the total number of tokens that can ever be minted for the token you're creating.
6782
- Specify an amount of tokens to mint during this initial deployment step.
6883
- Click **Continue**.
6984

70-
<ClickToZoom
71-
src="/images/ccip/token-manager/new/2-supply-cap-amount.png"
72-
alt="Setting token supply cap and amount to mint"
73-
/>
85+
<ClickToZoom src="/images/ccip/token-manager/new/settings-2.png" alt="Setting token supply cap and amount to mint" />
86+
87+
1. On the **Networks** page, select the additional blockchain network(s) where you'd like to deploy your new token and click **Continue**.
88+
89+
<ClickToZoom src="/images/ccip/token-manager/new/networks-3.png" alt="Selecting blockchain networks" />
90+
91+
1. On the **Owners** page, confirm the accounts that will be taking actions on each network. Click **Continue**.
92+
93+
<ClickToZoom src="/images/ccip/token-manager/new/owners-4.png" alt="Confirming network accounts" />
94+
95+
The default account is the currently connected wallet. However, you can have different accounts for each network depending on who you want to be the owner.
7496

75-
1. On the **Networks** page, select the additional blockchain network(s) where you'd like to deploy your new token:
76-
<ClickToZoom src="/images/ccip/token-manager/new/3-select-networks.png" alt="Selecting blockchain networks" />
7797
1. On the **Summary** page, you can review your upcoming deployments and transactions. Each network you've selected appears along with an expandable list of the transactions the Token Manager will guide you through to deploy your token for each network:
7898

79-
<ClickToZoom
80-
src="/images/ccip/token-manager/new/4-summary-upcoming-deployments.png"
81-
alt="Summary of upcoming deployments"
82-
/>
99+
<ClickToZoom src="/images/ccip/token-manager/new/summary-5.png" alt="Summary of upcoming deployments" />
83100

84101
Make sure that your wallet contains gas tokens for each network where you're deploying your token, in order to pay for the deployment transactions.
85102

86103
If you selected more than two networks during the previous step, the _Remove_ links are active, allowing you to remove a network before proceeding. If you only have two networks selected, the _Remove_ links are intentionally not active. If you need to add more networks, navigate back to the **Networks** page.
87104

88-
1. The **Deploy** page displays the steps that you need to complete. For each network, the Token Manager guides you through each of these steps in order:
105+
1. The **Deploy** page displays the steps that you need to complete for each network:
89106

90107
- Deploy token and pool
91108
- Accept admin role
92109
- Accept token ownership
93110
- Accept pool ownership
94111

95-
<ClickToZoom src="/images/ccip/token-manager/new/5-deployment-steps.png" alt="Deployment steps" />
112+
<ClickToZoom src="/images/ccip/token-manager/new/deployment-6.png" alt="Deployment steps" />
96113

97-
At each step, you are prompted to confirm the corresponding transactions in your wallet. When each step is complete for all the networks you selected, the Token Manager marks them all as **Done**:
114+
After the **Deploy token and pool** step is completed, you can initiate the other steps all at the same time by clicking **Accept** under each step. While these steps run concurrently, each step separately prompts you to confirm the corresponding transactions in your wallet.
98115

99-
<ClickToZoom src="/images/ccip/token-manager/new/6-all-networks-done.png" alt="Steps complete for all networks" />
116+
Once all of the steps for one network have been initiated, you can switch to the other network and repeat the same process. You do not have to wait for the first network deploy process to be complete before initiating the second network deploy process.
117+
118+
When the deploy process is complete for all the networks you selected, the Token Manager marks them all as **Done**:
119+
120+
<ClickToZoom src="/images/ccip/token-manager/new/done-7.png" alt="Steps complete for all networks" />
100121

101122
Click **Continue**. The Token Manager displays a message showing that your configuration was successful:
102123

103124
<ClickToZoom src="/images/ccip/token-manager/new/7-success-message.png" alt="Success message" />
104125

105126
When everything is successfully set up for your token, you can view your new Token Page from the Token Manager Dashboard. It displays information about your CCT, enables configuration changes, and allows expansion to additional networks where you can deploy the token.
106127

107-
After enabling your tokens, you can also use Transporter to perform transfers and import tokens with the contract address. Use [test.transporter.io](https://test.transporter.io) for testnet or [transporter.io](https://transporter.io) for mainnet.
108-
109128
## Add an existing token
110129

111130
If you have existing token(s) that you've already deployed, you can use the Token Manager to create and configure a token pool for the token, and optionally deploy your token on additional networks. Note that tokens deployed to additional networks are automatically configured to use the Burn and Mint mechanism.

0 commit comments

Comments
 (0)