Add Token

Overview

Buttons on DApps allow users to directly add the specified tokens to the asset list on their TronLink user extension.

Specification

Example

const res = await tronWeb.request({
  method: 'wallet_watchAsset',
  params: {
    type: 'TRC20',
    options: {
      address: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
    }
  },
});

Parameters

interface WatchAssetParams {
  type: 'trc10' | 'trc20' | 'trc721';
  options: {
    address: string;
    symbol?: string;
    decimals?: number;
    image?: string;
  }
}

• method: wallet_watchAsset fixed string

• params: WatchAssetParams, the specific parameters are as follows:

  • type: Only 'trc10', 'trc20', 'trc721' are supported now

  • options:

    • address: the contract address of the token or the token id, required

    • symbol: placeholder (currently unused), optional

    • decimals: placeholder (currently unused), optional

    • image: placeholder (currently unused), optional

Returns

This method has no return value

Interaction

Add TRC10 assets

if (window.tronLink.ready) {
  const tronweb = tronLink.tronWeb;
  try {
    tronweb.request({
      method: 'wallet_watchAsset',
      params: {
        type: 'trc10',
        options: {
          address: '1002000'
        },
      },
    });
  } catch (e) {}
}

When the code is executed, a TronLink pop-up window for adding TRC10 assets will show up, and the user can click “Add” or “Cancel”.

After clicking "Add", users can see the added assets as shown in the following screen:

Add TRC20 assets

if (window.tronLink.ready) {
  const tronweb = tronLink.tronWeb;
  try {
    tronweb.request({
      method: 'wallet_watchAsset',
      params: {
        type: 'trc20',
        options: {
          address: 'TF17BgPaZYbz8oxbjhriubPDsA7ArKoLX3'
        },
      },
    });
  } catch (e) {}
}

When the code is executed, a TronLink pop-up window for adding TRC20 assets will show up, and the user can click “Add” or “Cancel”.

After clicking “Add”, users can see the added assets as shown in the following screen:

Add TRC721 asset

if (window.tronLink.ready) {
  const tronweb = tronLink.tronWeb;
  try {
    tronweb.request({
      method: 'wallet_watchAsset',
      params: {
        type: 'trc721',
        options: {
          address: 'TVtaUnsgKXhTfqSFRnHCsSXzPiXmm53nZt'
        },
      },
    });
  } catch (e) {}
}

When the code is executed, a TronLink pop-up window for adding TRC721 will show up, and the user can click “Add” or “Cancel”.

After clicking “Add”, users can see the added assets as shown in the following screen: