TronWeb

https://tronweb.network/docu/docs/
Admin
TronWeb is a JavaScript library for interacting with the TRON blockchain, enabling developers to...
Tokens:137,521
Snippets:807
Trust Score:7.8
Update:2 months ago
Show doc for...
Tokens:
Raw
### Get Account Examples

Source: https://tronweb.network/docu/docs/API%20List/trx/getAccount

Examples demonstrating how to retrieve account details using Base58 and HexString address formats.

```javascript
//Parameter Base58  
await tronWeb.trx.getAccount('TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ');  
{  
  address: '41bf97a54f4b829c4e9253b26024b1829e1a3b1120',  
  balance: 29887074430,  
  frozen: [ { frozen_balance: 12000000, expire_time: 1577615814000 } ],  
  create_time: 1575710031000,  
  latest_opration_time: 1577356614000,  
  latest_consume_free_time: 1577356614000,  
  account_resource: {  
    frozen_balance_for_energy: { frozen_balance: 12000000, expire_time: 1577588400000 },  
    latest_consume_time_for_energy: 1577342304000  
  },  
  owner_permission: { permission_name: 'owner', threshold: 1, keys: [ [Object] ] },  
  active_permission: [  
    {  
      type: 'Active',  
      id: 2,  
      permission_name: 'active',  
      threshold: 1,  
      operations: '7fff1fc0033e0100000000000000000000000000000000000000000000000000',  
      keys: [Array]  
    }  
  ],  
  assetV2: [ { key: '1000001', value: 0 } ],  
  free_asset_net_usageV2: [ { key: '1000001', value: 0 } ]  
}  
  
 //Parameter HexString  
await tronWeb.trx.getAccount('41BF97A54F4B829C4E9253B26024B1829E1A3B1120').then(result => console.log(result))  
{  
  address: '41bf97a54f4b829c4e9253b26024b1829e1a3b1120',  
  balance: 29340074430,  
  frozen: [ { frozen_balance: 12000000, expire_time: 1577615814000 } ],  
  create_time: 1575710031000,  
  latest_opration_time: 1578635577000,  
  latest_consume_time: 1578635577000,  
  latest_consume_free_time: 1577356614000,  
  account_resource: {  
    frozen_balance_for_energy: { frozen_balance: 12000000, expire_time: 1577588400000 },  
    latest_consume_time_for_energy: 1578047682000  
  },  
  owner_permission: { permission_name: 'owner', threshold: 1, keys: [ [Object] ] },  
  active_permission: [  
    {  
      type: 'Active',  
      id: 2,  
      permission_name: 'active12323',  
      threshold: 2,  
      operations: '7fff1fc0033e0000000000000000000000000000000000000000000000000000',  
      keys: [Array]  
    }  
  ],  
  assetV2: [ { key: '1000001', value: 1000000000 } ],  
  free_asset_net_usageV2: [ { key: '1000001', value: 0 } ]  
}
```

--------------------------------

### Basic Usage Example

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/delegateResource

A standard implementation example for delegating resources.

```javascript
const transaction = await tronWeb.transactionBuilder.delegateResource(10e6, 'receiverAddress', 'BANDWIDTH', 'TMVQGm1qAQYVdetCeGRRkTWYYrLXuHK2HC', true, 86400);
```

--------------------------------

### getBandwidth Examples

Source: https://tronweb.network/docu/docs/API%20List/trx/getBandwidth

Examples demonstrating the method usage with Base58 and HexString address formats.

```javascript
//Example 1  
await tronWeb.trx.getBandwidth('TVJ6njG5EpUwJt4N9xjTrqU5za78cgadS2');  
5000  
  
//Example 2  
await tronWeb.trx.getBandwidth('41D3FD1B6F3F3A86303E2925844456C49876C4561F');  
5000
```

--------------------------------

### Full Plugin Implementation Example

Source: https://tronweb.network/docu/docs/Plugins

A complete example combining plugin creation, registration, and usage.

```typescript
import { TronWeb } from 'tronweb';
class MyPlugin1 {
    tronWeb: TronWeb;
    constructor(tronWeb: TronWeb) {
        this.tronWeb = tronWeb;
    }
    pluginInterface() {
        return {
            requires: '>=6.0.0',
            fullClass: true,
        };
    }
    myPlugin1Method() {
        console.log('MyPlugin1 method');
    }
}
class MyPlugin2 {
    tronWeb: TronWeb;
    constructor(tronWeb: TronWeb) {
        this.tronWeb = tronWeb;
    }
    pluginInterface() {
        return {
            requires: '>=6.0.0',
            fullClass: false,
            components: {
                trx: {
                    myPlugin2Method: this.myPlugin2Method,
                },
            },
        };
    }
    myPlugin2Method() {
        console.log('MyPlugin2 method');
    }
}
const tronWeb = new TronWeb({
    fullHost: 'http://127.0.0.1:9090',
});
tronWeb.plugin.register(MyPlugin1);
tronWeb.plugin.register(MyPlugin2);
tronWeb.myPlugin1.myPlugin1Method();
tronWeb.trx.myPlugin2Method();
```

--------------------------------

### sendToken Examples

Source: https://tronweb.network/docu/docs/API%20List/trx/sendToken

Examples demonstrating token transfer without and with a private key for signing.

```javascript
//example1  
await tronWeb.trx.sendToken("TVDGpn4hCSzJ5nkHPLetk8KQBtwaTppnkr",1000,’100010’);  
  
//example2   
await tronWeb.trx.sendToken("TVDGpn4hCSzJ5nkHPLetk8KQBtwaTppnkr", 1000,’100010’,’from_address_private’);  
{ result: true,  
 transaction:  
  { visible: false,  
    txID:  
     '7d3e08aed30e47d7f03062282ecaba9ac18164a5a2aa0830a6f4af8620c9b8ea',  
    raw_data:  
     { contract: [Array],  
       ref_block_bytes: 'b4c2',  
       ref_block_hash: '653e58b56f0a0c06',  
       expiration: 1579076202000,  
       timestamp: 1579076144747 },  
    raw_data_hex:  
     '0a02b4c22208653e58b56f0a0c064090dc9ac2fa2d5a730802126f0a32747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e736665724173736574436f6e747261637412390a07313030303030311215417946f66d0fc67924da0ac9936183ab3b07c811261a1541d3136787e667d1e055d2cd5db4b5f6c880563049200a70eb9c97c2fa2d',  
    signature:  
     [ '29d1db1203a3eb163b2602181cd77b1bbf1010bd66490b9f023d5cfbf22950892103ffefaf5c85d6894bd2baa27975d2ce456d121210a44a618791a2d36d82b301' ] } }
```

--------------------------------

### Install TronWeb and initialize instance

Source: https://tronweb.network/docu/docs/Build%20local%20node

Installation command and basic configuration for connecting TronWeb to a local node.

```bash
npm install tronweb
```

```javascript
import { TronWeb } from 'tronweb';  
const tronWeb = new TronWeb({  
  fullHost: 'http://127.0.0.1:9090',  
  privateKey: 'your private key',  
});
```

```bash
node yourFile.js
```

--------------------------------

### estimateEnergy Example

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/estimateEnergy

A practical example demonstrating how to estimate energy for a balanceOf function call.

```javascript
const result = await tronWeb.transactionBuilder.estimateEnergy(
    'TPYwAC9Y4uUcT2QH3WPPjqxzJSJWymMoMS',
    'balanceOf(address)', {}, 
    [{ type:'address',value: 'THvMiWQeVPGEMuBtAnuKn2QpuSjqjrGQGu' }]
)
{
  "result": {
    "result": true,
  },
  "energy_required": 900000
}
```

--------------------------------

### Example of updateSetting

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/updateSetting

A practical example showing the method call and the resulting unsigned transaction object.

```javascript
const transaction = await tronWeb.transactionBuilder.updateSetting("TBQ8ubHnwWAZvHVPJevnKpEfabetDdaQdQ",40,"TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ");
{
  visible: false,
  txID: 'eb9ce3d85c033e16e4dd0058d2bdff06857379b534839193bf982c05adebd271',
  raw_data: {
    contract: [ [Object] ],
    ref_block_bytes: '19c3',
    ref_block_hash: '610212ce583a92aa',
    expiration: 1581320133000,
    timestamp: 1581320074559
  },
  raw_data_hex: '0a0219c32208610212ce583a92aa4088b399f0822e5a6a082112660a32747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e55706461746553657474696e67436f6e747261637412300a1541bf97a54f4b829c4e9253b26024b1829e1a3b11201215410faf1b6bce9e815555544aea9d350f9d3dc6d3ba182870bfea95f0822e'
}
```

--------------------------------

### createProposal Example

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/createProposal

Example call to createProposal and the resulting unsigned transaction object.

```javascript
await tronWeb.transactionBuilder.createProposal([{ "key": 32, "value": 1 }, { "key": 33, "value": 11 }],"41BF97A54F4B829C4E9253B26024B1829E1A3B1120");  
{  
  visible: false,  
  txID: '771d2fe10099dd2d48e9f874bc7c17a5882c77bca2622fbb695cc59327e1bc08',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: 'ba3b',  
    ref_block_hash: 'e09ff41b96e649f1',  
    expiration: 1581050079000,  
    timestamp: 1581050021547  
  },  
  raw_data_hex: '0a02ba3b2208e09ff41b96e649f14098ceb6ef812e5a5e0810125a0a33747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e50726f706f73616c437265617465436f6e747261637412230a1541bf97a54f4b829c4e9253b26024b1829e1a3b112012040820100112040821100b70ab8db3ef812e'  
}
```

--------------------------------

### Contract Deployment Example

Source: https://tronweb.network/docu/docs/API%20List/contract/tronweb.contract%28%29.new

A complete example showing the deployment function execution and the resulting contract address output.

```javascript
let abi = 'some abi for contract';  
let code = 'bytecode';  
async function deploy_contract(){  
  let contract_instance = await tronWeb.contract().new({  
    abi:JSON.parse(abi),  
    bytecode:code,  
    feeLimit:1_00_000_000,  
    callValue:0,  
    userFeePercentage:1,  
    originEnergyLimit:10_000_000  
  });  
  console.log(contract_instance.address);  
}  
  
deploy_contract();// Execute the function  
414d137bb7f91e8704d712d3967f6a745b9eedd839  
```

--------------------------------

### Example response for getContractInfo

Source: https://tronweb.network/docu/docs/API%20List/trx/getContractInfo

Example of the object returned by the getContractInfo method.

```javascript
await tronWeb.trx.getContractInfo("TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t");  
{  
  "runtimecode": "6080604052600436106101a1576000357c01...45553445400000000000000000000000000000000000000000000000000000000",  
  "smart_contract": {  
    "bytecode": "60806040526000600260146101000a81548160ff0219169...45553445400000000000000000000000000000000000000000000000000000000",  
    "consume_user_resource_percent": 30,  
    "name": "TetherToken",  
    "origin_address": "41517591d35d313bf6a5e33098284502b045e2bc08",  
    "abi": {  
      "entrys": [  
        {  
          "outputs": [  
            {  
              "type": "string"  
            }  
          ],  
          "constant": true,  
          "name": "name",  
          "stateMutability": "View",  
          "type": "Function"  
        },  
        ...  
        {  
          "inputs": [  
            {  
              "name": "_blackListedUser",  
              "type": "address"  
            }  
          ],  
          "name": "destroyBlackFunds",  
          "stateMutability": "Nonpayable",  
          "type": "Function"  
        }  
      ]  
    },  
    "origin_energy_limit": 10000000,  
    "contract_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",  
    "code_hash": "99bb60e56b4cd2642c6847e372b18b6e0f9514229e3086d3a042d60a4c7b78a9"  
  },  
  "contract_state": {  
    "update_cycle": 9460,  
    "energy_usage": 11743864698,  
    "energy_factor": 34000  
  }  
}
```

--------------------------------

### getTokenByID Examples

Source: https://tronweb.network/docu/docs/API%20List/trx/getTokenByID

Examples showing how to retrieve token information using both async/await and promise-based syntax.

```javascript
//example 1  
await tronWeb.trx.getTokenByID(1002000);  
{  
  owner_address: '4137fa1a56eb8c503624701d776d95f6dae1d9f0d6',  
  name: 'BitTorrent',  
  abbr: 'BTT',  
  total_supply: 990000000000000000,  
  trx_num: 1,  
  precision: 6,  
  num: 1,  
  start_time: 1548000000000,  
  end_time: 1548000001000,  
  description: 'Official Token of BitTorrent Protocol',  
  url: 'www.bittorrent.com',  
  id: '1002000'  
}  
  
//example 2  
tronWeb.trx.getTokenByID('1002000').then(result => {console.log(result)});  
{  
  owner_address: '4137fa1a56eb8c503624701d776d95f6dae1d9f0d6',  
  name: 'BitTorrent',  
  abbr: 'BTT',  
  total_supply: 990000000000000000,  
  trx_num: 1,  
  precision: 6,  
  num: 1,  
  start_time: 1548000000000,  
  end_time: 1548000001000,  
  description: 'Official Token of BitTorrent Protocol',  
  url: 'www.bittorrent.com',  
  id: '1002000'  
}
```

--------------------------------

### Create Account Example Output

Source: https://tronweb.network/docu/docs/API%20List/utils/createAccount

Example of the object returned by the createAccount method, containing keys and address formats.

```json
await TronWeb.createAccount();  
{
    "privateKey": "D9AA****1A7E",
    "publicKey": "04FFFA899E5EAEB8DB1AA583A96D598DDBAB6DDC0D24B4FD8948E740D7D8E828AC8F177D3937960DE6E2567CECD7E899130DA921EA3B90F0A8FEF24E9D1670A0C1",
    "address": {
        "base58": "TXeSp72o5r185cmeGxFDkdCZFdJS1TAyHw",
        "hex": "41EDC66496A39744FEA631A598CBAE4B7D6A728AA7"
    }
}
```

--------------------------------

### Example of updateEnergyLimit

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/updateEnergyLimit

A practical example showing the function call and the resulting unsigned transaction object.

```javascript
const transaction = await tronWeb.transactionBuilder.updateEnergyLimit("TBQ8ubHnwWAZvHVPJevnKpEfabetDdaQdQ",30,"TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ");  
console.log(transaction)  
{  
  visible: false,  
  txID: 'b17022e101f964e0f1b413e0862ca8a3ca6c7e48f39b1765103ca59bd3a84f0a',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: '2782',  
    ref_block_hash: '6309a83565218acf',  
    expiration: 1581330690000,  
    timestamp: 1581330630613  
  },  
  raw_data_hex: '0a02278222086309a83565218acf40d0df9df5822e5a6e082d126a0a36747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e557064617465456e657267794c696d6974436f6e747261637412300a1541bf97a54f4b829c4e9253b26024b1829e1a3b11201215410faf1b6bce9e815555544aea9d350f9d3dc6d3ba181e70d58f9af5822e'  
}
```

--------------------------------

### sendTransaction Examples

Source: https://tronweb.network/docu/docs/API%20List/trx/sendTransaction

Examples showing a basic transfer and a transfer signed with a private key.

```javascript
//example1  
await tronWeb.trx.sendTransaction("TVDGpn4hCSzJ5nkHPLetk8KQBtwaTppnkr", 1000);  
  
//example2   
await tronWeb.trx.sendTransaction("TVDGpn4hCSzJ5nkHPLetk8KQBtwaTppnkr", 1000, 'from_address_private');  
{  
  result: true,  
  transaction:  
   { visible: false,  
     txID:  
      'f8f70731df59b4d7d8159df705f0f7289cd2a037187dda043e28c77287b12e11',  
     raw_data:  
      { contract: [Array],  
        ref_block_bytes: 'b3e2',  
        ref_block_hash: '3778f8d30f91eb00',  
        expiration: 1579075530000,  
        timestamp: 1579075470470 },  
     raw_data_hex:  
      '0a02b3e222083778f8d30f91eb004090daf1c1fa2d5a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a15417946f66d0fc67924da0ac9936183ab3b07c81126121541d3136787e667d1e055d2cd5db4b5f6c88056304918e807708689eec1fa2d',  
     signature:  
      [ 'd0839fd236016149da98ddd3dcd2f1dfcfd11aabee8a27ffae50b1323ed4ad6a259c2d48c983c7d0c786e373d2a90c48adc91f33b82be07efffaa7d57e4d3f6000' ] } }
```

--------------------------------

### purchaseToken Examples

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/purchaseToken

Examples demonstrating token purchase transactions using different address formats.

```javascript
// Example 1  
await tronWeb.transactionBuilder.purchaseToken("41bf97a54f4b829c4e9253b26024b1829e1a3b1120", "1000088", 100, "41010D3A8E0D80F8C83148240202DD178DF495B7BD");  
{  
  visible: false,  
  txID: '9ffe34c87be9e803ca219c05a1e976cdbc1ee63459335a43fbdc290b616fe09f',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: '6ce6',  
    ref_block_hash: 'e123937572ed7ab5',  
    expiration: 1581384000000,  
    timestamp: 1581383940593  
  },  
  raw_data_hex: '0a026ce62208e123937572ed7ab54080c4d38e832e5a7b080912770a3a747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e506172746963697061746541737365744973737565436f6e747261637412390a1541010d3a8e0d80f8c83148240202dd178df495b7bd121541bf97a54f4b829c4e9253b26024b1829e1a3b11201a0731303030303838206470f1f3cf8e832e'  
}  
  
// Example 2  
await tronWeb.transactionBuilder.purchaseToken("TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ", "1000088", 100,"TPnBjYQEMo4Yd4866KCzXdi4a169KGd63n");  
{  
  visible: false,  
  txID: 'b86ac32d981d56ce7aef1461a6e8455c4176d2cb5daa5860d16d3132210ac49b',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: '6cfb',  
    ref_block_hash: '5ff675a58150b8e0',  
    expiration: 1581384063000,  
    timestamp: 1581384004388  
  },  
  raw_data_hex: '0a026cfb22085ff675a58150b8e04098b0d78e832e5a7b080912770a3a747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e506172746963697061746541737365744973737565436f6e747261637412390a1541977c20977f412c2a1aa4ef3d49fee5ec4c31cdfb121541bf97a54f4b829c4e9253b26024b1829e1a3b11201a0731303030303838206470a4e6d38e832e'  
}
```

--------------------------------

### withdrawExchangeTokens Examples

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/withdrawExchangeTokens

Examples showing how to withdraw tokens using different address formats.

```javascript
//Example 1  
const transaction = await tronWeb.transactionBuilder.withdrawExchangeTokens(1, "1000003", 100, "410ca7c49aa44d26aabfe7f594c645cf9f17a4ff70");  
console.log(transaction);  
{  
  visible: false,  
  txID: '560b803647f39b87a76623c4428102d1d96d18367b7f679412cc810029499a71',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: '6e55',  
    ref_block_hash: '96fe9781aef670d8',  
    expiration: 1581385101000,  
    timestamp: 1581385042932  
  },  
  raw_data_hex: '0a026e55220896fe9781aef670d840c8dd968f832e5a61082b125d0a35747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e45786368616e67655769746864726177436f6e747261637412240a15410ca7c49aa44d26aabfe7f594c645cf9f17a4ff7010011a0731303030303033206470f497938f832e'  
}  
  
// Example 2  
await tronWeb.transactionBuilder.withdrawExchangeTokens(1, "1000003", 100, "TB8865sqTQ3qxWqhNQRCBov3KtPXFRPccK");  
{  
  visible: false,  
  txID: 'a776c9009655b72c4ad4858d391e25a522d753d9e40197f24703adda41dc3c77',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: '6e7b',  
    ref_block_hash: '413bf5de7cf22452',  
    expiration: 1581385215000,  
    timestamp: 1581385155940  
  },  
  raw_data_hex: '0a026e7b2208413bf5de7cf224524098d89d8f832e5a61082b125d0a35747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e45786368616e67655769746864726177436f6e747261637412240a15410ca7c49aa44d26aabfe7f594c645cf9f17a4ff7010011a0731303030303033206470e48a9a8f832e'  
}
```

--------------------------------

### Update Token Example

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/updateToken

A complete example showing the input object and the resulting unsigned transaction object.

```javascript
const createasset = {  
  description: "justfortest",  
  url: "www.my-token.com",  
  freeBandwidth: 1000000,  
  freeBandwidthLimit: 100,  
  permissionId: 2  
}  
const transaction = await tronWeb.transactionBuilder.updateToken(createasset, "TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ");  
console.log(transaction);  
{  
  visible: false,  
  txID: '009e8b45c34fbccf86d3f8d1f5e52d694c40b14550289a49048e9ba64799520f',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: '21ca',  
    ref_block_hash: '65b258d979c2d3f8',  
    expiration: 1581326298000,  
    timestamp: 1581326241240  
  },  
  raw_data_hex: '0a0221ca220865b258d979c2d3f84090d791f3822e5a72080f126c0a30747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5570646174654173736574436f6e747261637412380a1541bf97a54f4b829c4e9253b26024b1829e1a3b1120120b6a757374666f72746573741a0c7777772e636374762e636f6d20c0843d2864280170d89b8ef3822e'  
}
```

--------------------------------

### Example usage of deployConstantContract

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/deployConstantContract

A concrete example showing how to pass the owner address and contract bytecode to the method.

```javascript
const result = await tronWeb.transactionBuilder.deployConstantContract({  
    ownerAddress: 'TMVQGm1qAQYVdetCeGRRkTWYYrLXuHK2HC',  
    input: '0x60806040526000805534801561001457600080fd5b50d3801561002157600080fd5b50d2801561002e57600080fd5b5060e08061003d6000396000f3fe6080604052348015600f57600080fd5b50d38015601b57600080fd5b50d28015602757600080fd5b5060043610605d576000357c01000000000000000000000000000000000000000000000000000000009004806360fe47b1146062575b600080fd5b608b60048036036020811015607657600080fd5b810190808035906020019092919050505060a1565b6040518082815260200191505060405180910390f35b600081600081905550600054905091905056fea165627a7a72305820392f2cf7f1b37873349bf7ce496fb370bc80c6539de204bded6197106c530e7000',  
});
```

--------------------------------

### freezeBalance Examples

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/freezeBalance

Examples of staking TRX using different address formats.

```javascript
//example 1  
await tronWeb.transactionBuilder.freezeBalance(tronWeb.toSun(100), 3, "ENERGY", "4115B95D2D2CBCE1B815BA4D2711A3BEA02CBB37F3", "4115B95D2D2CBCE1B815BA4D2711A3BEA02CBB37F3");
```

```javascript
//example 2  
await tronWeb.transactionBuilder.freezeBalance(tronWeb.toSun(100), 3, "ENERGY", "TBx5FQGFeLUHPFMkn3BaFxxfVwLy7ffE5k", "TBx5FQGFeLUHPFMkn3BaFxxfVwLy7ffE5k");
```

--------------------------------

### Example Query and Response

Source: https://tronweb.network/docu/docs/API%20List/event/getEventsByContractAddress

A practical example showing how to query 'Transfer' events for a specific contract and the structure of the returned data.

```javascript
const events = await tronWeb.event.getEventsByContractAddress(  
  'TPYwAC9Y4uUcT2QH3WPPjqxzJSJWymMoMS',  
  {  
    eventName: 'Transfer'  
  }  
);  
console.log(events);  
{  
    "success":true,  
    "data": [  
      {  
          "block_number": 42054864,  
          "block_timestamp": 1700704884000,  
          "caller_contract_address": "TPYwAC9Y4uUcT2QH3WPPjqxzJSJWymMoMS",  
          "contract_address": "TPYwAC9Y4uUcT2QH3WPPjqxzJSJWymMoMS","event_index": 1,  
          "event_name": "Transfer",  
          "result": {  
             "0": "0x65fa68800fff5a10346d1a3aa1fb2ce92f2e2971",  
             "1": "0xbbd6d9c36cf31f73b01ad2415b12d9d2bda7fb08",  
             "2": "27000000","from":"0x65fa68800fff5a10346d1a3aa1fb2ce92f2e2971",  
             "to": "0xbbd6d9c36cf31f73b01ad2415b12d9d2bda7fb08","value": "27000000"  
          },  
          "result_type": {  
            "from":"address",  
            "to":"address",  
            "value":"uint256"  
          },  
          "event": "Transfer(address indexed from, address indexed to, uint256 value)",  
          "transaction_id": "9c9e4776de1ee889aad48be360262e3dd6d1a1e3d4e0d7c72dc50075260846df"  
        }  
    ],  
    "meta": {  
        "at":1700720666204,  
        "page_size": 1  
    }  
}
```

--------------------------------

### getBlock Examples

Source: https://tronweb.network/docu/docs/API%20List/trx/getBlock

Examples showing how to retrieve block data using a block number, a block ID, and the 'latest' keyword.

```javascript
//Example 1  
await tronWeb.trx.getBlock(12345);  
{  
  blockID: '000000000000303987c7c8ab3f5967c107a619fa47819940597e9938811a1764',  
  block_header: {  
    raw_data: {  
      number: 12345,  
      txTrieRoot: '0000000000000000000000000000000000000000000000000000000000000000',  
      witness_address: '414b4778beebb48abe0bc1df42e92e0fe64d0c8685',  
      parentHash: '0000000000003038c0a3aa1806236bc5b281633728b5fe8a14a51062522e651d',  
      timestamp: 1529928585000  
    },  
    witness_signature: 'cb889103aa9ce691d39df8030b54b50b12b77984684281f3490e0b802cbc364c13af773ede8d9314add0fa4d247165be82fa28721f17493c88761b7039ba1c1100'  
  }  
}  
  
//Example 2  
await tronWeb.trx.getBlock('000000000000303987c7c8ab3f5967c107a619fa47819940597e9938811a1764');  
{  
  blockID: '000000000000303987c7c8ab3f5967c107a619fa47819940597e9938811a1764',  
  block_header: {  
    raw_data: {  
      number: 12345,  
      txTrieRoot: '0000000000000000000000000000000000000000000000000000000000000000',  
      witness_address: '414b4778beebb48abe0bc1df42e92e0fe64d0c8685',  
      parentHash: '0000000000003038c0a3aa1806236bc5b281633728b5fe8a14a51062522e651d',  
      timestamp: 1529928585000  
    },  
    witness_signature: 'cb889103aa9ce691d39df8030b54b50b12b77984684281f3490e0b802cbc364c13af773ede8d9314add0fa4d247165be82fa28721f17493c88761b7039ba1c1100'  
  }  
}  
  
//Example 3  
await tronWeb.trx.getBlock('latest').then(result => {console.log(result)});  
{  
  blockID: '0000000000000000de1aa88295e1fcf982742f773e0419c5a9c134c994a9059e',  
  block_header: {  
    raw_data: {  
      txTrieRoot: 'ea97ca7ac977cf2765093fa0e4732e561dc4ff8871c17e35fd2bcabb8b5f821d',  
      witness_address: '414b4778beebb48abe0bc1df42e92e0fe64d0c8685',  
      parentHash: '957dc2d350daecc7bb6a38f3938ebde0a0c1cedafe15f0edae4256a2907449f6'  
    }  
  },  
  transactions: [  
    {  
      txID: 'abda6c8b1e8954dbe1d5a06a774a3e6923b003d29bb4ce286998f23452e3b04a',  
      raw_data: [Object],  
      raw_data_hex: '5a6f0801126b0a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e7472616374123a0a173078303030303030303030303030303030303030303030121541f16412b9a17ee9408646e2a21e16478f72ed1e9518ffffa7ec85afd1b101'  
    },  
  
 ... // Contains the block contents (transactions, IDs, hashes, timestamps, etc.)
```

--------------------------------

### unfreezeBalance Example

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/unfreezeBalance

Example call to unfreeze BANDWIDTH and the resulting unsigned transaction object.

```javascript
await tronWeb.transactionBuilder.unfreezeBalance("BANDWIDTH", "41BF97A54F4B829C4E9253B26024B1829E1A3B1120", "41BF97A54F4B829C4E9253B26024B1829E1A3B1120");  
{  
  visible: false,  
  txID: '2ba070338263eecbec034aac62a0a9b906a033ac34eb3e183cc7ccc2c4d1fb20',  
  raw_data: {  
    contract: [ [Object] ],  
    ref_block_bytes: 'afa9',  
    ref_block_hash: 'd25a977d06b9fb63',  
    expiration: 1581312834000,  
    timestamp: 1581312774685  
  },  
  raw_data_hex: '0a02afa92208d25a977d06b9fb6340d0f3dbec822e5a53080c124f0a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e556e667265657a6542616c616e6365436f6e747261637412170a1541bf97a54f4b829c4e9253b26024b1829e1a3b1120709da4d8ec822e'  
}
```

--------------------------------

### undelegateResource Example

Source: https://tronweb.network/docu/docs/API%20List/transactionBuilder/undelegateResource

Practical example of revoking bandwidth resources using specific parameters.

```javascript
const transaction = await tronWeb.transactionBuilder.undelegateResource(10e6, 'receiverAddress', 'BANDWIDTH', 'TMVQGm1qAQYVdetCeGRRkTWYYrLXuHK2HC');
```

--------------------------------

### getBalance Examples with Different Address Formats

Source: https://tronweb.network/docu/docs/API%20List/trx/getBalance

Examples demonstrating how to retrieve balances using both Base58 and HexString address formats.

```javascript
//Parameter Base58  
await tronWeb.trx.getBalance('TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ');  
29887074430  
           
//Parameter HexString  
await tronWeb.trx.getBalance('41BF97A54F4B829C4E9253B26024B1829E1A3B1120');  
29340074430
```

--------------------------------

### Example output of getChainParameters

Source: https://tronweb.network/docu/docs/API%20List/trx/getChainParameters

Example of the asynchronous call and the resulting array of blockchain parameter objects.

```javascript
await tronWeb.trx.getChainParameters();  
[ { key: 'getMaintenanceTimeInterval', value: 21600000 },  
  { key: 'getAccountUpgradeCost', value: 9999000000 },  
  { key: 'getCreateAccountFee', value: 100000 },  
  { key: 'getTransactionFee', value: 10 },  
  { key: 'getAssetIssueFee', value: 1024000000 },  
  { key: 'getWitnessPayPerBlock', value: 32000000 },  
  { key: 'getWitnessStandbyAllowance', value: 115200000000 },  
  { key: 'getCreateNewAccountFeeInSystemContract' },  
  { key: 'getCreateNewAccountBandwidthRate', value: 1 },  
  { key: 'getAllowCreationOfContracts', value: 1 },  
  { key: 'getRemoveThePowerOfTheGr', value: -1 },  
  { key: 'getEnergyFee', value: 10 },  
  { key: 'getExchangeCreateFee', value: 1024000000 },  
  { key: 'getMaxCpuTimeOfOneTx', value: 50 },  
  { key: 'getAllowUpdateAccountName' },  
  { key: 'getAllowSameTokenName', value: 1 },  
  { key: 'getAllowDelegateResource', value: 1 },  
  { key: 'getTotalEnergyLimit', value: 100000000000 },  
  { key: 'getAllowTvmTransferTrc10', value: 1 },  
  { key: 'getTotalEnergyCurrentLimit', value: 100000000000 },  
  { key: 'getAllowMultiSign' },  
  { key: 'getAllowAdaptiveEnergy' },  
  { key: 'getTotalEnergyTargetLimit', value: 6944444 },  
  { key: 'getTotalEnergyAverageUsage' },  
  { key: 'getUpdateAccountPermissionFee', value: 100000000 },  
  { key: 'getMultiSignFee', value: 1000000 } ]
```
Tokens:
Raw