Audit ERC20, ERC721, and ERC1155 Token Activity using Quicknode SDK

This project is based on the guide, How to Audit ERC20, ERC721, and ERC1155 Token Activity using Quicknode SDK by Sergen Uysal. Using JavaScript and the Quicknode SDK, this tool fetches and analyzes transactions across ERC20, ERC721, and ERC1155 token standards to conducting comprehensive audits on blockchain wallets, specifically tailored for EVM-compatible chains.

Prerequisites

• A Quicknode account.
• Node.JS installed.

Clone Example Monorepo

To begin, clone the qn-guide-examples repo, navigate to this project's directory, install dependencies, and open the project directory in a code editor.

git clone https://github.com/quiknode-labs/qn-guide-examples.git
cd qn-guide-examples/ethereum/audit-token-activity
npm install

Running the Code

Configuring the Endpoint

1. Obtain a Quicknode endpoint URL for the EVM chain that you want.
2. Open the index.js file.
3. Locate the Core object instantiation. It should look like this:

const core = new Core({
  endpointUrl: "QUICKNODE_ENDPOINT",
});

4. Replace QUICKNODE_ENDPOINT with your actual Quicknode endpoint URL.

Audit Configuration

At the end of the index.js file, you will find the run function call. This function accepts four parameters:

• Addresses: An array of wallet addresses you wish to audit.
• FromBlock: The starting block number for the audit range.
• ToBlock: The ending block number for the audit range.
• TokenTypes: An array of token standards (e.g., 'ERC20', 'ERC721') to include in the audit.

Example Usage

The file contains a pre-configured example that audits a specific address for both ERC20 and ERC721 token transfers:

run(['0xe2233D97f30745fa5f15761B81B281BE5959dB5C'], 38063215, 38063220, ['ERC20', 'ERC721']);

Feel free to modify this example with your desired parameters.

Executing the Script

1. Open your terminal.
2. Navigate to the directory containing your index.js file.
3. Run the script using Node.js:

node index.js

Output

Upon successful execution, the script will generate a wallet_audit_data.json file in the same directory. This file contains a detailed account of the wallet's transactions, including token transfers and internal transactions, within the specified block range.

Support

For additional assistance or queries regarding the setup and usage, feel free to reach out to us by using the feedback form in the Conclusion section of the guide.