wbnns / aiwa

Get addresses that interacted with an address on Ethereum and Base

AIWA (Address Interacted With Address)

Overview

AIWA is a script that fetches all transactions sent to a specific Ethereum address from both the Ethereum and Base mainnet. The results are saved to a CSV file.

Setup

1. Clone the repository:

   git clone https://github.com/wbnns/aiwa.git
   cd aiwa

2. Create a virtual environment and activate it:

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Install the required packages:

   pip install requests python-dotenv

4. Create a .env file based on the .env.example:

   cp .env.example .env

5. Edit the .env file and add your Etherscan and Base API keys.

Usage

Run the script to fetch transactions for a specific address:

python aiwa.py <target_address>

Replace <target_address> with the address you want to query, e.g., 0xebe9f0540df89509e5fbd4693c85ad66f73affc9.

The transactions will be saved to transactions.csv.

License

MIT License