📖 Weldr Bot Commands & Usage

Welcome to the Weldr Bot documentation! Here you can find all available Telegram bot commands and how to use them for raiding Farcaster casts.

🚀 Getting Started

weldr is a bot that allows Telegram communities to raid farcaster & base app posts through their Telegram client. Created by token0verlord

🍠 Weldr Club

Weldr Bot uses a premium membership system that provides access to all raid management and casting features. Groups pay monthly based on their size using ETH on Base.

💰 Pricing & Tiers

Subscription pricing is automatically determined by your group size:

Weldr Club subscriptions last 30 days.

Weldr Club NFT

Anyone who holds this NFT in their connected Farcaster wallet will have unlimited lifetime access to use Weldr in 1 group at a time no matter the group size.

If you hold a Weldr Club NFT in your Farcaster wallet:

Step 1: Connect Farcaster

/connect

Step 2: Run Upgrade Command

/upgrade

Note: The upgrade process automatically checks for NFT ownership. If you hold a Weldr Club NFT, you'll get lifetime access automatically!

🎉 Lifetime Benefits

• No Monthly Fees: One-time verification grants permanent access
• Unlimited Group Size: No member count restrictions
• All Premium Features: Full access to raid management and casting
• One Group Active: Use in 1 group at a time, switch anytime

💳 Payment Process

The subscription process is simple and secure:

Step 1: Start Upgrade

/upgrade

Run this command in your group. The bot will:

• Detect your group size automatically
• Send payment instructions to your private DMs
• Generate a unique wallet address for your payment

Step 2: Send ETH Payment

You'll receive a DM with:

• Your unique wallet address
• Exact ETH amount to send
• Current ETH price and USD equivalent
• Your payment ID for confirmation

Step 3: Confirm Payment

/confirmpayment <payment_id>

After sending ETH to your unique wallet, use this command to verify and activate your subscription.

⚙️ Managing Subscriptions

• /subscriptionstatus – Check your group's current subscription status, tier, and expiry date
• Automatic Expiry: Subscriptions expire after 30 days with a simple group notification
• Easy Renewal: Run /upgrade again when your subscription expires
• Premium Command Gating: Unpaid groups cannot use raid management or casting features

🎯 Raid Management

Note: Raid commands require an active subscription or NFT lifetime access.

Starting a Raid

Start a raid by pasting any Farcaster cast URL:

/weld https://farcaster.xyz/superhotfire/0xdf450e1e

Quick Target Setting

You can also set targets directly in the command:

/weld [url] [likes] [recasts] [replies] [time_minutes]

Supported URLs:

• farcaster.xyz cast links
• Direct cast hashes

Note: If you don't set targets in the command, the bot will guide you through setting them interactively.

Active Raid Commands

• /viewwelds – View all active raids, targets, and time remaining.
• /stopweld – Stop the current active raid and show confirmation. If there's a queued raid, it will automatically start.
• /skipweld – Skip the current raid and seamlessly move to the next queued raid (requires both active and queued raids).
• /nextweld <cast_url> – Queue the next raid target with interactive setup.
  Example: /nextweld https://farcaster.xyz/user/0x123abc

Raid Queue System

Weldr Bot supports a powerful queue system for continuous raiding:

• Queue Setup: Use /nextweld to add raids to the queue with custom targets
• Auto-Start: When you /stopweld, the next queued raid automatically begins
• Seamless Skip: Use /skipweld to instantly move to the next raid without stopping messages
• Target Presets: Set likes, recasts, and reply targets for queued raids in advance

Raid Customization

After starting a raid, use the interactive buttons to customize:

⏱️ Time Duration Options:

• 5 minutes
• 30 minutes
• 1 hour (Default)
• 2 hours
• 24 hours

🎯 Target Settings:

• Likes Target: Set how many likes to aim for
• Recasts Target: Set how many recasts to aim for
• Replies Target: Set how many replies to aim for

🎬 Raid Actions:

• ❤️ Like: Community members like the cast
• 🔄 Recast: Community members recast the post
• 💬 Reply: Community members reply to the cast
• 🎯 All Actions: Combination of likes, recasts, and replies

👤 Profile & Information

Get detailed Farcaster profile information:

/profile <username_or_url>

Examples:

/profile superhotfire /profile https://farcaster.xyz/superhotfire

📤 Posting Casts

Note: Casting requires an active subscription or NFT lifetime access.

Text-Only Casts

Simply use the cast command with your message:

/cast Your message here

Casts with Images

Important: Follow this exact process for image casts:

1. Send your image to the chat first (just the image, no command).
2. Reply to your image with /cast Your message here.

Note: You cannot attach a photo directly to the /cast command. Always reply to an image with your cast command to include both text and image in your cast command to include both text and image in your Farcaster post.

📋 Complete Command Reference