What is walletconnect-tron

walletconnect-tron helps DApp to connect with the WalletConnect TRON Chain.

Get Started

Installation

You can install @tronweb3/walletconnect-tron with npm/yarn/pnpm.

npm i @tronweb3/walletconnect-tron
//or
yarn add @tronweb3/walletconnect-tron

Create WalletConnect Wallet

Request Parameters

Argument	Description	Type
network	The Chain (Mainnet, Shasta, Nile)	string
options	The options Info of the wallet	object
qrcodeModalOptions	The options for QRCode Modal	object

interface WalletConnectWalletAdapterConfig {
  network: WalletConnectChainID;
  options: SignClientTypes.Options;
  /**
   * QRCode modal options.
   * - qrcodeModalOptions.registryUrl: URL to fetch wallet list.
   *     Default is https://registry.walletconnect.com/api/v2/wallets .
   * - qrcodeModalOptions.desktopLinks: Wallets Names to show on desktop browser like 
   *     ['Ledger', 'GoldBit'].
   * - qrcodeModalOptions.mobileLinks: Wallets Names to show on IOS mobile browser like 
   *   ['Trust', 'TokenPocket'].
   */
  qrcodeModalOptions?: IQRCodeModalOptions;
}

Example

import { WalletConnectWallet, WalletConnectChainID } from '@tronweb3/walletconnect-tron';
const wallet = new WalletConnectWallet({
  network: WalletConnectChainID.Mainnet,
  options: {
    relayUrl: 'wss://relay.walletconnect.com',
    projectId: '....',
    metadata: {
      name: 'JustLend',
      description: 'JustLend WalletConnect',
      url: 'https://app.justlend.org/',
      icons: ['https://app.justlend.org/mainLogo.svg']
    }
  },
  qrcodeModalOptions: {
    desktopLinks: ['Ledger', 'GoldBit', 'TokenPocket', 'Tokenary', 'Apollox'],
    // wallet's name can be case insensitive
    mobileLinks: ['rainbow', 'trust', 'metamask', 'safe'],
  }
});

Connect to the Wallet

Use wallet.connect() to connect to your wallet. Your DApp will connect automatically, if it has been connected before. Otherwise, a WalletConnect QRCode will be displayed.

Response

Return the wallet address if connected.

Example

const { address } = await wallet.connect();

Disconnect to the Wallet

Use wallet.disconnect() to disconnect to your wallet.

Example

try {
  await wallet.disconnect();
} catch (error) {
  console.log('disconnect:' + error);
}

Sign Transaction

Sign a provided transaction object

Request Parameters

Argument	Description	Type
transation	Tron Transaction	object

Example

try {
  const signature = await wallet.signTransaction(transaction);
} catch (error) {
  console.log('signTransaction:' + error);
}

Sign Message

Sign a String Message

Request Parameters

Argument	Description	Type
message	message	string

Example

try {
  const signature = await wallet.signMessage('hello world');
} catch (error) {
  console.log('signTransaction:' + error);
}

Check Connect Status

Check the Connect Status

Response

Return the wallet address. If the wallet is not connected, return NULL.

Example

const { address } = await wallet.checkConnectStatus();

Note

Since the connection is based on the relayUrl service, DApp developers should handle network errors, connection errors, and timeout errors properly according to the scenario.

To see all error messages and error codes, refer to WalletConnect Errors.

License

MIT