User Guide

πŸ“Œ Welcome to FarmLabs

The Modular, No-Code EVM Automation Console.

Use this guide to learn how to safely automate testnet interactions, manage wallet behavior, and configure stealth options for advanced EVM farming and testing strategies. All operations are client-side, meaning your keys and data never leave your browser.

πŸ”„ Console Comparison

Not sure which console to use? Here’s a quick breakdown to help you decide.

Feature Basic Console Advance Console
Wallet Connectβœ…βœ…
Multiple Private KeysβŒβœ…
Wallet PersonasβŒβœ…
Recipient Modesβœ…βœ…
Gas-aware logicβŒβœ…
Live Chartsβœ…βœ…
Persona ProfilesβŒβœ…
Best For Quick Testnet Tasks Long-Term Automation

πŸš€ Getting Started (Step-by-Step)

  1. Open basic.html or advance.html depending on your use case.
  2. Connect a wallet or paste private keys (Advance only).
  3. Select your recipient mode or upload a list of addresses.
  4. Configure stealth options like delays, chain, and personas (Advance only).
  5. Press Start Interaction and watch the logs and charts in real-time.
  6. Monitor the process and export logs or configuration as needed.

πŸ‘› Wallet Management

  • Multiple Keys (Advance): Paste multiple private keysβ€”one per lineβ€”to run automations from several wallets simultaneously.
  • Wallet Personas (Advance): Simulate human-like behavior with presets like Night Owl, Gas Saver, or XP Farmer. These profiles automatically adjust timing and action frequency.
  • Balance Check: Always check wallet balances before starting automation to ensure you have enough funds for gas fees.
  • Safety First: Never use wallets that contain mainnet funds or any real assets. This tool is for testnets only.

πŸ“€ Recipient Configuration

Choose where your automated transactions are sent:

  • Dynamic Pool: Automatically fetches recently active addresses on the target chain to use as recipients.
  • Fixed: Sends all transactions to a single, specified target address.
  • CSV Upload: Provide a complete list of recipients by uploading a CSV file.
  • Self Interaction (Advance): Shuffles your loaded wallets and has them send transactions to each other, creating internal activity.

βš™οΈ Stealth & Config

The Advance Console offers powerful stealth features to mimic human behavior:

  • Custom Delays: Set minimum and maximum delay ranges (in seconds) between actions to avoid predictable, bot-like timing.
  • Gas Awareness: Use the gas multiplier to automatically pause activity when network gas prices spike, saving on fees.
  • Randomization: The script automatically randomizes transaction amounts and action types (send, idle, check balance) to create a more organic activity pattern.
  • RPC Rotation: Add multiple RPC endpoints for a single chain. The console will automatically rotate between them to improve reliability and avoid rate-limiting.

πŸ“Š Charts & Logs

Get real-time visual feedback and detailed records of all activity:

  • Wallet Balance Chart: A bar chart displaying the current ETH balance of all loaded wallets.
  • Action Distribution Chart: A pie chart showing the breakdown of actions performed (e.g., Send, Idle, Balance Check).
  • Spike Tracker: A display that shows when the last "human-like" random spike in activity or delay occurred.
  • Live Log: A detailed, timestamped log of every action, success, and error. You can download the full log as a CSV or JSON file.
  • AI Log Summarizer (Advance): Use your Gemini API key to get an AI-powered summary of the log, highlighting key events and potential issues.

🧩 Modules (Coming Soon)

We're constantly developing new tools to expand FarmLabs' capabilities. Here's a preview of what's next:

  • Mint Tool: Automatically call the `mint()` function on supported NFT and token contracts.
  • Deploy Tool: Push new smart contracts to any testnet using bytecode or a simple UI.
  • Bridge Simulator: Mimic cross-chain transactions to test bridging protocols and generate related activity.
  • Airdrop Claimer: Simulate interactions with airdrop claim contracts.
  • Transaction Signer: Build, sign, and send raw EIP-1559 transactions with full control over gas and nonce.

πŸ”’ Security Notice

Your security is our top priority. Please read this carefully.

  • Client-Side Only: Your private keys, configuration, and all sensitive data never leave your browser. There is no backend server involved in processing your data.
  • Testnet Use Only: This tool is designed exclusively for testnets. Do not use real funds or mainnet wallets. You are solely responsible for the keys you use.
  • Local Execution: All automation logic is executed locally within your browser. This ensures you have full control and transparency over the process.