tron-tx-decoder-tronweb/README.md

Lightweight utility for decoding function parameters and function output from Tron blockchain transactions.

<p align="center">
<img src="https://tron.network/static/images/logo.png" width=400 />
</p>

## tron-tx-decoder-tronweb

[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com) ![npm](https://img.shields.io/npm/v/tron-tx-decoder-tronweb) ![npm bundle size](https://img.shields.io/bundlephobia/min/tron-tx-decoder-tronweb) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

- _[Built with ethers.js](https://github.com/ethers-io/ethers.js/)_.

**Demo:** [https://tron-decoder.github.io](https://tron-decoder.github.io/)

## Installation

```bash
npm i tron-tx-decoder-tronweb
```

### Initialization

```js
const TronTxDecoder = require('tron-tx-decoder-tronweb');
const Tronweb = require('tronweb');

const tronweb = new TronWeb({
    network: 'shasta',
    fullHost: 'https://api.shasta.trongrid.io',
    apiUrl: 'https://shastapi.tronscan.org/api',
    eventServer: 'https://api.shasta.trongrid.io',
    privateKey: 'PRIVATE_HERE',
    headers: { 'TRON-PRO-API-KEY': 'API KEY FROM trongrid.io' },
});

const decoder = new TronTxDecoder({ tronweb });
```

### Decode Input:
Decode function input parameters by passing transaction id.
```js
async function decodeTxInput(txId){
    const decodedInput = await decoder.decodeInputById(txId);
    return decodedInput;
}

decodeTxInput("0c739761b34a891b3bbecd528302de827736660d76c62dacf8d3a9ebe7dade08");
```
#### Output:
```js
{ 
    methodName: 'submitTheGame',
    inputNames: [ '_betId', 'freshHouseSeed', 'rollResult', '_gameOutcome' ],
    inputTypes: [ 'uint256', 'address', 'uint8', 'uint8' ],
    decodedInput: { 
        '0': BigNumber { _hex: '0x265aa6' },
        '1': '0x8F476d1155E9910A885Cae1c4396BDD392c3883E',
        '2': 11,
        '3': 1,
        _length: 4 
    } 
}
```

### Decode Output:
Decode function outputs by passing transaction id.

```js
async function decodeTxOutput(txId){
    const decodedOutput = await decoder.decodeResultById(txId);
    return decodedOutput;
}

decodeTxOutput("0c739761b34a891b3bbecd528302de827736660d76c62dacf8d3a9ebe7dade08");
```
#### Output:
```js
{ 
    methodName: 'submitTheGame',
    outputNames: [ null, null ],
    outputTypes: [ 'uint256', 'uint256' ],
    decodedOutput: { 
        '0': BigNumber { _hex: '0x265aa6' },
        '1': BigNumber { _hex: '0x0615ec20' },
        _length: 2 
    }
}
```

### Decode Revert Message (if any):
Decode function outputs by passing transaction id.

```js
async function decodeRevertMessage(txId){
    const decodedMessage = await decoder.decodeRevertMessage(txId);
    return decodedMessage;
}

decodeRevertMessage("5d6db71f3316a2abdf7f08f97cd42880209ee7344816d404ce865a8679bdb7ae");
```
#### Output:
```js
{ 
    txStatus: 'REVERT',
    revertMessage: 'Plot is not currently owned' 
}
```

### BigNumber

- BigNumber can be converted to number using  ***prototype*** .toNumber(). Which return a JavaScript number of the value.

- [BigNumber Documentation (ethers.js)](https://docs.ethers.io/ethers.js/html/api-utils.html#big-numbers)

## Contributing

- Issues & Pull requests are welcome! Fork, branch, and submit PR.