跳到主要内容

Tokens

This guide shows how to view and send Chia Asset Tokens (CATs) in the Chia Cloud Wallet, how to issue your own tokens, and how to set a custom display name and ticker.

信息

You need a Cloud Wallet account and at least one vault. If you have not created a vault yet, follow the Getting Started Guide first.

Prerequisites​

  • An active Chia Cloud Wallet account with at least one vault
  • Access to your vault spend key (Chia Signer app or passkey) to sign token send, issue, and melt transactions
  • To issue tokens, XCH in the vault you issue from (see Issue a token)

View tokens in a vault​

  1. Log in to your Chia Cloud Wallet account and open the vault.

  2. Select the Tokens tab:

Vault Tokens tab listing CAT balancesVault Tokens tab listing CAT balances
  1. Click a token row to open its asset page. The page shows the balance, the vault address, and recent transactions for that token.
Token asset page with balance, address, and transactionsToken asset page with balance, address, and transactions

If the vault has not received any tokens yet, the tab shows No tokens yet. Tokens appear after they arrive in the vault.

Send a token​

  1. From the token asset page, click Send CAT.

  2. Under Send To, enter or paste the destination Address, pick a saved contact, or use Scan QR Code. Addresses start with xch on mainnet.

  3. Under Amount to send, enter the Amount and an optional Fee.

  4. Optionally add a Memo.

Send CAT form with address, amount, and feeSend CAT form with address, amount, and fee
  1. Click Send. Review the Confirm Transaction dialog (Sign and Send for a passkey, or approve the request in the Chia Signer app).

The fee is paid in XCH. Check Spendable balance on the send form before you submit.

If the vault is still being minted, the send form shows This vault is currently being minted. You cannot perform transactions until the minting process is complete.

Issue a token​

You can issue your own CAT from any of your vaults. Tokens you issue are listed on the Tokens page in the sidebar. This page is separate from a vault's Tokens tab, which lists every CAT the vault holds.

Every CAT is backed by XCH. Each token you issue uses 1,000 mojos (0.000000001 XCH) from the vault, so 1,000,000 tokens uses 0.001 XCH. The XCH equivalent shows under Amount as you type. The vault must have enough spendable XCH for the amount plus the fee.

  1. Open the Issue Token form from either place:
    • The Tokens page. Click Tokens in the sidebar (on mobile, open the menu and select Tokens), then click Issue Token. If you have not issued a token yet, the page is titled Issue Your First Token.
    • A vault page. Open the vault, open the more actions menu, and choose Issue Token. The vault is selected as the Issuing Vault in the form. This item is disabled when your plan's token limit is reached (see Plan limits). Hover over it to see Upgrade your plan to issue more tokens.
Tokens page with Issue Your First Token and the Issue Token buttonTokens page with Issue Your First Token and the Issue Token button
  1. Fill in the form:
    • Issuing Vault: the vault to issue the token from. This vault becomes the token's issuing vault and receives the new tokens.
    • Name: 2 to 32 characters
    • Symbol: 1 to 10 characters
    • Type: Single Issuance or Multi Issuance (see Issuance types)
    • Revocable: shown only for Multi Issuance, and on by default. If enabled, tokens can be revoked by the issuer at any time. Vaults holding the token get an email alert when it is revoked (see the Watchtowers section of the FAQ).
    • Amount: the number of tokens to issue
    • Fee: an optional network fee in XCH. Spendable balance shows the XCH available in the selected vault.
Issue Token form with issuing vault, name, and symbolIssue Token form with issuing vault, name, and symbol
Issue Token form with Multi Issuance, Revocable, amount with XCH equivalent, and feeIssue Token form with Multi Issuance, Revocable, amount with XCH equivalent, and fee
  1. Click Issue Token. The Issue Token dialog shows the amount, the XCH Cost, the fee, and the receiving vault.
Issue Token dialog with amount, XCH cost, fee, recipient, and Sign buttonIssue Token dialog with amount, XCH cost, fee, recipient, and Sign button
  1. Click Sign to approve with your passkey, or approve the request in the Chia Signer app.

The new token appears on the Tokens page right away. Its Total Supply and Balance show 0 until the transaction confirms. After that, the tokens also appear on the issuing vault's Tokens tab and you can send them like any other CAT. An issuance with no fee can take longer to confirm.

Tokens page with a created token card showing vault, total supply, balance, and issuance typeTokens page with a created token card showing vault, total supply, balance, and issuance type

Issuance types​

TypeSupplyRevocable
Single IssuanceFixed. You cannot issue more after the first issuance.No
Multi IssuanceYou can issue more later from the same vault.Optional, set at issuance

You cannot change the type or the Revocable setting after the token is created.

View a token you created​

Click a token on the Tokens page to open its details. The page shows the Asset ID, Issuing Vault, Symbol, Issuance Type, Revocable?, Total Issued, Total Melted, Total Supply, and Balance Held (tokens the issuing vault still holds).

Token page with asset ID, token details, and Melt and Issue More buttonsToken page with asset ID, token details, and Melt and Issue More buttons

Share the Asset ID with anyone who wants to add your token to their wallet.

Issue more tokens​

For a Multi Issuance token, you can issue more at any time:

  1. Open the token from the Tokens page and click Issue More (or choose Issue More from the token card's menu).

  2. Issuing Vault, Name, Symbol, and Type are filled in and cannot be changed. Enter the Amount and an optional Fee.

Issue More form with amount, XCH equivalent, and feeIssue More form with amount, XCH equivalent, and fee
  1. Click Issue More, then approve the transaction.

Melt tokens​

Melting destroys tokens and returns the XCH that backs them to the issuing vault. Only Multi Issuance tokens issued with Revocable on can be melted, and only from the tokens the issuing vault still holds.

  1. Open the token from the Tokens page and click Melt.

  2. In the Melt Tokens dialog, enter the Amount to melt and an optional Fee. The XCH you get back shows under the amount.

Melt Tokens dialog with amount to melt, XCH returned, and feeMelt Tokens dialog with amount to melt, XCH returned, and fee
  1. Click Melt Tokens, then approve the transaction.

The issuing vault needs some XCH to melt tokens, even if you do not pay a fee.

Plan limits​

Your plan sets how many tokens you can issue. The free plan allows up to 50 tokens. This counts every token you have issued from your vaults. Issuing more of an existing token or melting tokens does not change the count. When you reach the limit, Issue Token is disabled on the Tokens page and in the vault page menu, and shows Upgrade your plan to issue more tokens.

Custom name and ticker​

You can set a display name and ticker (token symbol) for a CAT you hold. This only changes how the token appears in your Cloud Wallet. It does not change the token on the blockchain.

  1. Open Settings, then open the Tokens tab.

  2. Click Add Token Details (or Add a token's details if you have not added any yet).

  3. Fill in:

    • Display Name (2 to 32 characters)
    • Token Symbol (1 to 10 characters)
    • Asset ID (exactly 64 characters). You can select a token you already hold, or paste an asset id.

    The form also includes Display Image. Image uploads are temporarily disabled. You can still save a display name and ticker without an image.

Add Token Details form with display name, token symbol, and asset idAdd Token Details form with display name, token symbol, and asset id
  1. Click Add Token Details.

To change labels later, open the token from Settings → Tokens or click Edit on the token asset page, update Display Name and Token Symbol, then click Update Token Details. Asset ID is read-only when you edit an existing entry.

Troubleshooting​

  • If a token does not appear on the Tokens tab, confirm it was sent to this vault's address and wait for the transaction to confirm
  • If the vault is still being minted, wait until this clears: This vault is currently being minted. You cannot perform transactions until the minting process is complete.
  • For send failures, check the token spendable balance and that the vault has enough XCH for the fee
  • If Issue Token shows Amount + fee exceeds available balance, add XCH to the selected vault or issue fewer tokens. Each token uses 1,000 mojos of XCH
  • If a token card on the Tokens page shows Unsigned, the issuance was not signed. Open the card's menu and choose Sign & Submit, or Cancel to discard it
  • If a token card shows Failed to Issue, the issuance did not complete. Open the card's menu and choose Remove, then issue the token again
  • If Issue More or Melt is missing, check the token's Issuance Type and Revocable? values. Only Multi Issuance tokens can issue more, and only revocable tokens with a Balance Held can be melted
  • For signing problems, confirm your Chia Signer app or passkey can approve the send request
  • For additional support, use In App Support