resource

• tg-dapp-demo

Install

npm install @blockchain-web3/web3-tg-sdk

Usage

import { WalletTgSdk } from 'https://cdn.jsdelivr.net/npm/@blockchain-web3/web3-tg-sdk';

import { WalletTgSdk } from '@blockchain-web3/web3-tg-sdk'

const { ethereum } = new WalletTgSdk({
    metaData: {
        name: 'your name',
        icon:"https://example.com/icon.png"
       
    }
})

Ethereum Provider API

Supported Chains

The UXUY Wallet Connection is designed to be multi-chain. The following chains are supported:

| Chain | ChainID | | :-------- | :----- | | Ethereum | 1 (0x1)| | BNB Chain |56 (0x38)| | Base |8453 (0x2105)| | Arbitrum |42161 (0xa4b1)| | Polygon |137 (0x89)| | Fantom |250 (0xfa)| | Optimism |10 (0xa)| | Avalanche C-Chain |43114 (0xa86a)| | zkSync Era |324 (0x144)| | Linea |59144 (0xe708)| | Core |1116 (0x45c)| | zkLink |810180 (0xc5cc4)|

request Api

The request method is used to make RPC requests to the connected wallet. It takes an object with the following properties:

• id (optional): A number or string that identifies the request.
• method: The RPC method to request.
• params (optional): An array or object of parameters for the RPC method.

The method returns a Promise that resolves with the result of the RPC method call.

json-rpc-api from metamask json-rpc-api from ethereum.org

interface RequestArguments {
  id?:number | string
  /** The RPC method to request. */
  method: string;

  /** The params of the RPC method, . */
  params?: Array<unknown> | object;
}

ethereum.request = (args: RequestArguments): Promise<any>

from UXuy Wallet rpc api

eth_requestAccounts

connect to the wallet and return the address of the connected wallet.

• method: eth_requestAccounts
• params: [] |
• returns: Promise<string[address]>

 ethereum.request({ method: 'eth_requestAccounts' })

eth_accounts

return the address of the connected wallet.

• method: eth_accounts
• params:
• returns: Promise<string[address]>

 ethereum.request({ method: 'eth_accounts' })

eth_chainId

return the chainId of the connected wallet.

• method: eth_chainId
• params:
• returns: Promise

 ethereum.request({ method: 'eth_chainId' })

wallet_switchEthereumChain

switch the connected wallet to the specified chainId.

• method: wallet_switchEthereumChain
• params:
  • chainId: number | string
• returns: Promise

try {
  await ethereum.request({
    method: 'wallet_switchEthereumChain',
    params: [{ chainId: '0xf00' }],
  });
} catch (switchError) {
  // This error code indicates that the chain has not been added to Uxuy Wallet.
}

eth_sendTransaction

send a transaction to the connected wallet.

• method: eth_sendTransaction
• params:
  • transaction: TransactionObject
• returns: Promise

const accounts = await ethereum.request({ method: 'eth_accounts', params: [{}] })  
const fromAddress =  ethereum.selectedAddress
const transactionParameters = {
  nonce: '0x00', // ignored by Uxuy Wallet
  gasPrice: '0x09184e72a000', // customizable by user during Uxuy Wallet confirmation.
  gas: '0x2710', // customizable by user during Uxuy Wallet confirmation.
  to: '0x0000000000000000000000000000000000000000', // Required except during contract publications.
  from:  fromAddress || accounts[0], // must match user's active address.
  value: '0x00', // Only required to send ether to the recipient from the initiating external account.
  data:
    '0x7f7465737432000000000000000000000000000000000000000000000000000000600057', // Optional, but used for defining smart contract creation and interaction.
  chainId: '0x3', // Used to prevent transaction reuse across blockchains. Auto-filled by Uxuy Wallet.
};

 ethereum.request(
    { 
        method: 'eth_sendTransaction', 
        params: [ 
            transactionParameters
        ] 
    }
)

signData Api

• personal_sign
• eth_signTypedData
• eth_signTypedData_v3
• eth_signTypedData_v4

You can refer to docs signing-data-with-metamask eth-sig-util

personal_sign

sign a message with the connected wallet.

• method: personal_sign
• params:
  • message: string
  • address: string
• returns: Promise

 ethereum.request({ method: 'personal_sign', params: ['hello', '0x1234567890'] })

eth_signTypedData_v3

• params:
• returns: Promise

 ethereum.request({ method: 'eth_signTypedData_v3', params: [{}, '0x1234567890'] })

eth_signTypedData_v4

• params:
• returns: Promise

 ethereum.request({ method: 'eth_signTypedData_v4', params: [{}] })

Event listeners

Notify when address and network change. Uses eventemitter3.

accountChanged

• params:

 ethereum.on('accountsChanged', handler: (accounts: Array<string>) => void);

 ethereum.on('accountChanged', (accounts) => {
    console.log(accounts || [])
})

chainChanged

• params:

 ethereum.on('chainChanged', (chainId) => {
    console.log(chainId)
})

// remove all event listeners
ethereum.removeAllListeners();

function handleAccountsChainChanged() {
  ethereum.on('accountsChanged', ([address]) => {
    // Handle the new accounts, or lack thereof.
    // "accounts" will always be an array, but it can be empty.
    alert('address changed');
  });
  ethereum.on('chainChanged', async (chainId) => {
    // Handle the new chain.
    // Correctly handling chain changes can be complicated.
    // We recommend reloading the page unless you have good reason not to.
    alert('chainid changed');
  });
}


// add event listener
function handleAccountsChanged(accounts) {
  // ...
}
//remove
ethereum.removeListener('accountsChanged', handleAccountsChanged); // only remove one 
ethereum.on('accountsChanged', handleAccountsChanged);