🔮 Perle Labs Auto Task Bot

Nền tảng dữ liệu AI chất lượng cao trên Solana.

• 💰 Gọi vốn: $17.5M

📖 Hướng Dẫn Tham Gia

1. 🔗 Truy cập: https://app.perle.xyz/join/rxcUsl

2. 👛 Kết nối ví Solana hoặc Email.

3. 🎯 Hoàn thành task tại "Recommended Projects" & "Marketplace".

4. ⚙️ Vào Settings liên kết: Ví, X, Discord, Email.

Lưu ý: Ví cần có hold trên 0.01 $SOL thì dự án mới cho xác thực task

✨ Tính Năng Nổi Bật

• 🔐 Auto Login: Tự động đăng nhập bằng Private Key hoặc Seed Phrase.

• 🌟 Welcome to Perle Labs:

  • Auto: Connect Wallet, Read Docs, Join Telegram.

  • Skip: Discord & X (Cần làm thủ công để tránh ban).

• 🤖 AI Powered Tasks (Groq LLaMA 3.3 70B): Tích hợp Groq AI để trả lời các task văn bản:

  • 📝 Product Tagging Quest: Nhận diện sản phẩm từ email khách hàng.

  • 🏥 Medical Specialty Quest: Phân tích bệnh án để chọn đúng chuyên khoa y tế.

  • ⚖️ Legal Classification Quest: Phân loại điều khoản hợp đồng.

  • 🔍 Ambiguous Instruction Quest: Xác định câu mơ hồ trong đoạn văn.

  • 🧠 Logical Fallacy Detection Quest: Nhận diện lỗi ngụy biện logic trong lập luận.

  • 💬 Conversation Response Rating Quest: Đánh giá chất lượng phản hồi AI trong hội thoại (Helpful/Off-Topic/TCBU/Incomplete).

• 🐾 Pet Bounding Box Quest (NEW): Tự động phát hiện và khoanh vùng đầu thú cưng trong ảnh bằng Vision AI (LLaMA 4 Maverick).

• 🎙️ Meeting Caption Quest: Tự động tạo audio bằng ElevenLabs AI với giọng nói siêu tự nhiên như người thật và upload.

• 🎤 Emotional Speech Recording Quest: Tự động tạo audio với giọng frustrated/dissatisfied customer.

• 🔄 Smart Retry Logic: Tự động làm lại các task bị sai (bỏ qua task thủ công).

• ⛓️ On-Chain Submission: Tự động ký và gửi giao dịch on-chain (Solana) từ API instructions.

• ✅ Transaction Confirmation: Xác nhận giao dịch qua Perle API

• 🎁 Referral Buff: Tự động nhập mã giới thiệu khi login để buff ref.

• ⚡ Multi-threading: Chạy song song nhiều tài khoản cùng lúc.

• 🔗 Chain Mode (NEW): Chạy tuần tự, tự động chuyển SOL giữa các tài khoản.

• 🌐 Proxy Support: Hỗ trợ HTTP/HTTPS/SOCKS proxy cho từng tài khoản.

• 🛡️ Anti-Detect: Giả lập browser headers, random delay.

🆕 Tính Năng Mới (v2.8)

• 🐾 Pet Bounding Box Quest: Phát hiện đầu thú cưng trong ảnh và tự động submit tọa độ bounding box {x, y, w, h} lên API.

• 👁️ Vision AI (LLaMA 4 Maverick): Dùng meta-llama/llama-4-maverick-17b-128e-instruct qua Groq để phân tích ảnh, trả về tọa độ theo phần trăm (0-100%) rồi convert sang pixel.

• 📐 Phân biệt Close-up / Full-body: AI tự nhận dạng ảnh chân dung (head fills 50-95%) hay toàn thân (head fills 15-35%) để ước tính chính xác.

• 🔄 Retry on Vision Fail: Nếu AI fails/timeout → chờ 10s/20s rồi retry tối đa 2 lần; nếu vẫn fail thì bỏ qua task.

• ✅ Post On-Chain Verification: Sau khi submit on-chain, chờ 5s rồi gọi lại API kiểm tra is_correct và hiện kết quả ✅/❌.

• ⏳ Timeout Handling: Khi Groq Vision API timeout → chờ 5s rồi thử tiếp, không crash.

• Có 10 project hiện tại, mỗi task xác thực cần 0.000005 $SOL để submit on-chain

🛠️ Yêu Cầu

• 🟢 Node.js: Phiên bản 16 trở lên.

• 🐍 Python: Cần thiết để chạy tính năng tạo audio (TTS).

• 🔑 ElevenLabs API Key: Đăng ký miễn phí tại elevenlabs.io

• 🤖 Groq API Key: Đăng ký miễn phí tại console.groq.com

📥 Cài Đặt

1. Cài đặt Node.js dependencies:

   npm install

2. Cài đặt thư viện Python (cho Audio Task với ElevenLabs):

   pip install elevenlabs httpx

3. Lấy ElevenLabs API Key:

   • Đăng ký tại: https://elevenlabs.io (Free 10,000 credits/tháng)

   • Lấy API key tại: https://elevenlabs.io/app/settings/api-keys

   • Điền vào key_elevenlabs.txt (mỗi dòng 1 key)

4. Lấy Groq API Keys (hỗ trợ key rotation):

   • Đăng ký tại: https://console.groq.com

   • Tạo nhiều API keys tại: https://console.groq.com/keys (khuyến nghị 3-5 keys)

   • Lưu vào groq_keys.txt (mỗi dòng 1 key)

   • Hoặc điền 1 key vào config.json → ai.groqApiKey

   • Bot sẽ tự động xoay vòng các keys khi có error/quota exceeded

5. Lấy Solana RPC (khuyến nghị):

   • Đăng ký Helius: https://dev.helius.xyz (Free 100k requests/ngày)

   • Điền vào config.json → api.rpcUrl

⚙️ Cấu hình (Accounts, Proxy)

1. 📂 Accounts (accounts.txt)

Mỗi dòng một tài khoản, định dạng:

PrivateKey

Hoặc:

Seed Phrase (12 hoặc 24 từ)

2. 🌐 Proxy (proxy.txt)

Mỗi dòng một proxy, hỗ trợ các định dạng:

ip:port
ip:port:user:pass
http://ip:port:user:pass
socks5://ip:port:user:pass

⚠️ Quan trọng: ElevenLabs API cần proxy để hoạt động ổn định từ Việt Nam.

🛠️ Settings (config.json)

Mở file config.json để chỉnh sửa:

{
    "threads": 6,                    // 🧵 Số luồng chạy song song
    "delay": {
        "min": 4000,                 // ⏱️ Thời gian nghỉ tối thiểu (ms)
        "max": 7000                  // ⏱️ Thời gian nghỉ tối đa (ms)
    },
    "api": {                         // 🌐 Cấu hình API (NEW)
        "rpcUrl": "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY"
    },
    "features": {
        "autoJoinProjects": true,    // 📁 Tự động tham gia dự án mới
        "completeSocialTasks": true, // 🐦 Làm task xã hội
        "completeTextTasks": true,   // 📝 Làm task văn bản
        "completeAudioTasks": true,  // 🎙️ Làm task âm thanh
        "claimBadges": true,         // 🏅 Tự động claim huy hiệu
        "submitOnChain": true        // ⛓️ Gửi giao dịch on-chain
    },
    "elevenlabs": {
        "randomKey": true            // 🎤 Random key từ key_elevenlabs.txt
    },
    "referral": {
        "enabled": true,             // 🤝 Bật tính năng buff ref
        "code": "rxcUsl"             // 🎟️ Mã ref của bạn
    },
    "projects": {                    // 🏗️ Bật/tắt từng dự án cụ thể
        "welcomeToPerle": false,
        "productTagging": true,
        "meetingCaption": true,
        "medicalNotes": true,
        "legalClassification": true,
        "emotionalSpeech": true,
        "ambiguousInstruction": true,
        "logicalFallacy": true,
        "conversationRating": true,
        "petBoundingBox": true,       // 🐾 NEW: Pet Bounding Box Quest
        "other": false               // 🛡️ Mặc định TẮT project chưa có logic
    },
    "proxy": {
        "enabled": true              // 🌐 Bật/tắt proxy
    },
    "transaction": {                 // ⛓️ Cấu hình xác nhận giao dịch
        "confirmRetries": 15,
        "confirmDelayMs": 2000,
        "skipPerleConfirm": false
    },
    "ai": {                          // 🤖 Cấu hình Groq AI (NEW)
        "groqApiKey": "gsk_xxxxx",   // API key từ console.groq.com
        "model": "llama-3.3-70b-versatile",
        "randomKey": true,           // 🔄 Random lựa chọn key (true) hoặc thứ tự (false)
        "retryOnKeyError": true,     // 🔁 Tự động retry với key khác khi quota/auth error
        "maxRetries": 3              // 🔀 Số lần retry tối đa
    },
    "autoref": {
        "proxyRotatingKey": "YOUR_API_KEY",
        "useExistingAccounts": true,
        "saveGeneratedAccounts": true,
        "max_acc_per_proxy": 1
    }
}

▶️ Chạy Bot

Chạy chính (làm task):

npm start

Chạy buff referral:

npm run autoref

🔗 Chạy Chain Mode (NEW):

npm run chain

Chain Mode - Dành cho người ít SOL:

• Chạy tuần tự 1 luồng

• Sau khi xong account → Tự động chuyển toàn bộ SOL sang account tiếp theo

• Tiếp tục đến hết tất cả accounts

• Chỉ cần nạp SOL cho 1 account đầu tiên

Account 1 (có SOL) → Chạy task → Chuyển SOL → Account 2
                                                  ↓
                           Chạy task ← Account 2 (nhận SOL)
                                                  ↓
                                       Chuyển SOL → Account 3
                                                       ↓
                                    ... tiếp tục đến hết ...

Cấu hình Autoref (config.json):

"autoref": {
    "proxyRotatingKey": "YOUR_API_KEY",  // API key từ proxyxoay.shop
    "useExistingAccounts": true,         // Dùng ví từ ref_accounts.txt
    "saveGeneratedAccounts": true        // Lưu ví mới vào ref_accounts.txt
}

File ref_accounts.txt:

• Mỗi dòng 1 private key hoặc seed phrase

• Ví đã buff thành công sẽ được comment bằng #

⚠️ Xử lý lỗi

• ❌ Lỗi Login failed: Kiểm tra lại Private Key/Seed Phrase hoặc Proxy.

• 🔄 Lỗi User referral has been used: Tài khoản đã có ref, bot tự động bỏ qua.

• 🔊 Lỗi ElevenLabs API key chưa được cấu hình: Thêm API key vào key_elevenlabs.txt.

• 🤖 Lỗi Groq API key chưa được cấu hình: Thêm API keys vào groq_keys.txt hoặc config.json → ai.groqApiKey.

• 🔄 Lỗi Groq quota exceeded: Bot tự động đổi sang key tiếp theo. Thêm nhiều keys trong groq_keys.txt.

• 🌐 Lỗi multiple free accounts: Cần sử dụng proxy cho ElevenLabs API.

• ⏳ Lỗi 429 Too Many Requests: Giảm số threads hoặc tăng delay.

• 🔗 Lỗi fetch failed (RPC): Proxy không hoạt động, kiểm tra lại proxy hoặc dùng RPC riêng.

📌 Lưu ý

• 🚀 Bot chạy trực tiếp trên API, không mở trình duyệt nên rất nhẹ.

• 🛡️ Nên dùng Proxy chất lượng để tránh bị đánh dấu spam và cho ElevenLabs hoạt động.

• ⛽ Đảm bảo ví có một ít SOL (khoảng 0.015 SOL) để làm phí gas cho các giao dịch on-chain.

• 🤖 Groq AI (LLaMA 3.3 70B) rất nhanh và chính xác, free 30k tokens/phút.

• 🎤 ElevenLabs tạo giọng nói AI siêu tự nhiên, giúp pass QA dễ hơn.

Lưu Ý Quan Trọng (v2.3)

💾 Về Cache System

• File submitted_tasks.json sẽ được tự động tạo và lưu các task/project đã hoàn thành

• Nếu muốn chạy lại project đã hoàn thành: Xóa entry tương ứng trong file JSON

• Để xóa toàn bộ cache: Xóa file submitted_tasks.json

• Cache có thời hạn 365 ngày, sau đó tự động xóa

🤖 Về Groq AI & Key Rotation

• Model: llama-3.3-70b-versatile (70B parameters, rất chính xác)

• Free tier: 30 requests/phút, 30,000 tokens/phút per key

• Key Rotation: Thêm 3-5 keys trong groq_keys.txt để tăng throughput

• randomKey: true → Chọn random key (tối ưu load balancing)

• randomKey: false → Chọn thứ tự (debug, testing)

• retryOnKeyError: true → Auto-retry với key khác khi quota/401/429

• maxRetries: 3 → Số lần retry tối đa trước khi fail

• Các model khác: llama-3.1-8b-instant, mixtral-8x7b-32768, gemma2-9b-it

🔗 Về Chain Mode

• Chạy với npm run chain

• Chỉ cần nạp SOL cho account đầu tiên

• Bot tự động chuyển SOL sau mỗi account

• Phí chuyển: ~0.000005 SOL mỗi lần

• Wallet cuối cùng sẽ giữ toàn bộ SOL còn lại

💰 Về SOL

• Mỗi task cần 0.000005 SOL để submit on-chain

• Mỗi project có 5-10 task = 0.000025-0.00005 SOL

• 10 project = 70-100 task = 0.0003-0.00045 SOL + phí gas

• Khuyến nghị: Nạp ít nhất 0.016 SOL cho mỗi tài khoản

🔄 Khi Nâng Cấp

• Backup file submitted_tasks.json trước khi cập nhật (nếu cần giữ cache)

• Chạy npm install để cài đặt dependencies mới

📞 Liên hệ hỗ trợ

• 📢 Telegram: @R1zaX040