Pharos Network Automation 🚀

Hey, Cat Lovers! 🐯 This Python script helps you create wallets, claim faucet tokens, and send tokens on the Pharos Testnet. It’s got a smooth CLI with rounded tables, proxy support, and a simple menu. Whether you’re testing or just messing around, this tool’s here to help! 😎

---

What’s This For? 🤔

This script does three main things:

• Claim Faucet 💧: Makes wallets, logs in, and grabs testnet tokens with invite codes.

• Send Tokens 💸: Sends tokens from your wallets to someone else.

• Exit 🚪: Closes the app when you’re done.

It’s built with Python, uses rich for pretty tables, aiohttp for async API calls, and web3 for blockchain stuff. Proxy support is included if you need it! 🕵️‍♂️

---

Project Structure 📂

pharos_automation/
├── config/
│   └── settings.py        # API, RPC, proxy config
├── models/
│   └── wallet.py          # Wallet dataclass
├── utils/
│   └── ui.py              # Rounded table UI
├── helpers/
│   ├── api.py             # Login & faucet API calls
│   └── wallet.py          # Wallet creation & token sending
├── main.py                # Main script (menu)
├── requirements.txt       # Dependencies
├── wallets.json           # Wallet data
├── .gitignore             # Ignore stuff
├── README.md              # This file!

---

What You Need 🛠️

• Python 3.8+ (python --version)

• Proxy (optional, for API calls)

• Git (to clone the repo)

• Pharos Testnet invite code

---

Setup ⚙️

1. Clone the Repo

   git clone https://github.com/your-repo/pharos_automation.git
   cd pharos_automation

2. Make a Virtual Environment

   python -m venv venv
   source venv/bin/activate      # macOS/Linux
   venv\Scripts\activate         # Windows

3. Install Stuff

   pip install -r requirements.txt

   (Installs web3, rich, aiohttp, eth-account, python-dotenv, tenacity.)

4. Set Up .env Make a .env file in the project folder:

   API_URL=https://api.pharosnetwork.xyz
   RPC_URL=https://testnet.dplabs-internal.com
   CHAIN_ID=1513
   PROXY_URL=http://your-proxy:port  # Optional
   FAUCET_AMOUNT=0.1
   RECIPIENT_ADDRESS=0xYourRecipientAddress
   SIGNATURE_MESSAGE=Sign this message to login to Pharos Network
   INVITE_CODES=BCEHd8GbJm5mRJY4

   Change PROXY_URL, RECIPIENT_ADDRESS, and INVITE_CODES to your own values.

5. Run It

   python main.py

---

How To Use 🎮

When you run python main.py, you’ll see a menu like this:

Pharos Network Automation
1. Claim Faucet
2. Send Tokens
3. Exit
Select an option [1]:

Claim Faucet 💧

• Enter how many wallets per invite code (default: 10)

• Enter how many threads (default: 4)

• The script makes wallets, logs in, and claims faucet tokens

• You’ll see rounded tables with wallet addresses and status (Success/Failed)

• Successful wallets get saved to wallets.json

• You get a summary table at the end

Send Tokens 💸

• Enter how many threads (default: 4)

• Loads wallets from wallets.json, checks balances, and sends FAUCET_AMOUNT to RECIPIENT_ADDRESS

• Shows tables with address, balance, tx hash, and status

• Ends with a summary table

Exit 🚪

• Just closes the script

---

Example Output 🖥️

Here’s what the tables look like:

╭───────────────╮
│ Field   │ Value   │
├─────────┼─────────┤
│ Address │ 0x1234… │
│ Status  │ Success │
╰───────────────╯

And the summary:

╭────────────── Faucet Claim Summary ──────────────╮
│ Metric      │ Value                              │
├─────────────┼────────────────────────────────────┤
│ Successful  │ 10                                 │
│ Failed      │ 0                                  │
│ Total       │ 10                                 │
╰─────────────────────────────────────────────────╯

---

Troubleshooting 🐛

Proxy not working?

• Check your PROXY_URL in .env

• Test: curl --proxy http://your-proxy:port https://api.pharosnetwork.xyz/user/login

• Try without a proxy: leave PROXY_URL empty

Invite code invalid?

• Make sure INVITE_CODES is right in .env

• Test the API with curl

Tables not rounded?

• Make sure you have rich==14.0.0

• Check utils/ui.py uses box=box.ROUNDED

Dependency issues?

• Check versions: pip show web3 rich aiohttp eth-account python-dotenv tenacity

• Reinstall: pip install -r requirements.txt

Still stuck?

• Share your .env (hide sensitive stuff)

• Share console output or screenshots

• Run python --version and pip --version

---

Contributing 🤝

Got ideas? Fork the repo, make changes, and send a pull request! Add new features, UI tweaks, or whatever you think is cool. Let’s make it awesome! 🌟

---

License 📜

MIT License. Use it, share it, enjoy it! 💖

---

Thanks 🙌

Happy automating, Cat Lovers! 🐯🚀