Overview

Jupsy Bot Documentation

Welcome to the official developer and user documentation for Jupsy Bot โ€” the high-performance Solana trading engine and copy trading suite engineered natively for Discord communities.

๐Ÿ’ก
Non-Custodial Architecture: Jupsy Bot generates dedicated Solana keypairs for each user, stored strictly with symmetric Fernet AES-256 encryption. Private keys are decrypted in-memory only during the brief milliseconds required to sign a transaction, and are never logged or exposed in plaintext.
โšก

Sub-Second Execution

Direct low-latency swap routing via Jupiter Swap API with direct Versioned Transaction Solana RPC broadcasting.

๐Ÿค–

Automated Copy Trading

Mirror any top Discord trader automatically with proportional sell exits, gas reserve protection, and instant DM notifications.

๐Ÿ“Š

4,600+ Tokens DB

Automated 24-hour background token synchronization caching verified mint addresses with 0ms in-memory resolution.

Getting Started

Quick Start in 3 Easy Steps

Get up and running with Jupsy Bot in under two minutes inside any Discord server where Jupsy Bot is installed.

1

Configure Your API Key & RPC Endpoint

Run the /setup command in Discord. Click Configure API & RPC to input your free Jupiter API key and Helius Solana RPC URL.

/setup
2

Generate Your Dedicated Solana Wallet & Deposit SOL

Type /wallet to open your private wallet console. Click ๐Ÿ“ฅ Deposit to view your public Solana address and scannable QR code. Send a small amount of SOL (e.g. 0.05 SOL) to get started.

/wallet
3

Perform Your First Swap or Start Copy Trading

Click ๐ŸŸข Buy Tokens in your /wallet to purchase any token (e.g. BONK, JUP, RAY) or follow an expert server trader with /copy-trade follow @trader.

/copy-trade follow user:@trader max_sol_amount:0.05
Security First

System Architecture & Security Model

Jupsy Bot is built with defense-in-depth principles to protect user funds, safeguard API credentials, and provide sub-second transaction routing.

Component Implementation Standard Purpose
Private Key Storage Fernet Symmetric AES-256 Encryption User private keypairs are encrypted with server-level cryptographic secrets before persisting to SQLite/PostgreSQL.
RPC Transmission HTTPS / TLS 1.3 to Helius Mainnet Signed VersionedTransaction payloads are submitted directly to dedicated RPC nodes.
Balance Safeguard Truncated 3-Decimal Formatting Prevents rounding overshoots (e.g. `0.8339` SOL formats as `0.833` SOL instead of `0.834` SOL) to guarantee zero insufficient balance errors.
Gas Reserve Lock 0.005 SOL Auto-Retention Both manual withdrawals and automated copy-trades preserve at least 0.005 SOL to pay for future network transaction fees.
Anti-Double-Click Atomic UI State Lock Swap confirmation buttons immediately disable on first click to prevent duplicate transaction broadcasting.
Configuration

/setup โ€” API Keys & Helius RPC

Jupsy Bot utilizes dedicated per-user credentials to bypass rate limits and provide institutional-grade transaction confirmation speeds.

/setup

How /setup Works

Running /setup delivers an ephemeral message with current configuration statuses and an interactive Configure API & RPC button. Clicking this button opens a modal form with two secure inputs:

Jupsy Bot Avatar
Jupsy APP Today at 12:00 PM
โš™๏ธ Jupsy Bot API & RPC Configuration

Configure your personal Jupiter API Key and Helius RPC Endpoint for dedicated swap routing and lightning-fast execution.

๐Ÿช Jupiter API Key: โœ… Configured (jup_sec_***)
โšก Helius RPC URL: โœ… Configured (https://mainnet.helius-rpc.com/...)

Pre-Filling & Validation Logic

If you have already configured one or both fields, the modal will automatically pre-fill your existing credentials and mark them optional. You can update one field without having to re-enter the other.

Step-by-Step Tutorial

๐Ÿช How to Get Your Free Jupiter API Key (8 Steps)

Jupiter API keys unlock dedicated routing endpoints, 0% rate-limiting issues, and lightning-fast swap quotes across 4,600+ Solana tokens. Follow this visual step-by-step tutorial to create your free API key.

๐Ÿ’ก
100% Free: Jupiter's developer tier is completely free and requires zero payment or credit card.
1

Navigate to Jupiter Portal & Sign In

Visit developers.jup.ag/sign-in โ†—. Sign in using your Google account, GitHub, or email.

developers.jup.ag/sign-in โ€” Step 1 ๐Ÿ” Click to zoom
Jupiter API Step 1: Sign in with Google
Click "Continue with Google" or your preferred sign-in method.
2

Create an Organization

On the welcome screen, click the Create organization card to initialize your developer workspace for API keys and analytics.

Organizations โ€” Step 2 ๐Ÿ” Click to zoom
Jupiter API Step 2: Create organization
Click "Create organization" to start a new workspace.
3

Click "+ Create team"

Once your dashboard loads, locate the + Create team button on the right side of the Home page and click it.

Home Dashboard โ€” Step 3 ๐Ÿ” Click to zoom
Jupiter API Step 3: Click Create team
Click the "+ Create team" button on the dashboard.
4

Enter Team Name & Confirm

In the popup modal, enter a team name (e.g. Jupsy Team or your Discord username) and click the green Create team button.

Create Team Dialog โ€” Step 4 ๐Ÿ” Click to zoom
Jupiter API Step 4: Enter team name
Type "Jupsy Team" and click the green "Create team" button.
5

Navigate to Settings โž” API Keys

On the left-hand sidebar, open the Settings dropdown, select API Keys, and then click the green + Create API Key button on the right.

Settings > API Keys โ€” Step 5 ๐Ÿ” Click to zoom
Jupiter API Step 5: Settings API Keys
1. Click "API Keys" under Settings • 2. Click "+ Create API Key".
6

Select Your Team

On the "Continue to API Keys" screen, choose the team you created in Step 4 (e.g. Jupsy Team).

Select Team โ€” Step 6 ๐Ÿ” Click to zoom
Jupiter API Step 6: Select Team
Click your team ("Jupsy Team") to proceed.
7

Name Your API Key

Enter a label for your key (e.g. jupsy-bot, must be between 5 and 32 characters) and click Submit.

Name API Key โ€” Step 7 ๐Ÿ” Click to zoom
Jupiter API Step 7: Name API Key
Enter "jupsy-bot" and click "Submit".
8

Copy Your Secret Jupiter Key & Save in Bot

Your secret Jupiter API key (starting with jup_) is displayed. Click the copy icon to copy it. Then open Discord, run /setup, and paste it into the Jupiter API Key field.

API Key Created โ€” Step 8 ๐Ÿ” Click to zoom
Jupiter API Step 8: Copy API Key
โš ๏ธ This is the only time your full key will be displayed. Copy and keep it safe!
Step-by-Step Tutorial

โšก How to Get Your Free Helius RPC URL (2 Steps)

Helius provides blazing-fast Solana RPC nodes with priority transaction broadcasting, preventing dropped swaps and network congestion errors. Follow these 2 quick steps to generate your free endpoint.

๐Ÿš€
High Throughput: Helius free tier includes generous monthly credits and sub-second confirmation latency.
1

Sign In to Helius Developer Dashboard

Navigate to dashboard.helius.dev/login โ†—. Sign in using your Google account, GitHub, Solana wallet, or email.

dashboard.helius.dev/login โ€” Step 1 ๐Ÿ” Click to zoom
Helius Step 1: Login with Google
Click "Google" or your preferred authentication method to sign in.
2

Copy Your Mainnet RPC URL & Add to Jupsy Bot

From the left sidebar under Products, click on RPCs. In the RPC URL field, click the copy icon to copy your full URL (format: https://mainnet.helius-rpc.com/?api-key=YOUR_KEY). Paste this URL into the Helius RPC URL field in Jupsy Bot's /setup modal.

Helius Dashboard > RPCs โ€” Step 2 ๐Ÿ” Click to zoom
Helius Step 2: Copy RPC URL
1. Click "RPCs" in left menu • 2. Copy the "RPC URL" and paste into Jupsy Bot /setup.
Core Command

/wallet โ€” The Wallet Console

The /wallet command is your central mission control inside Discord. It displays your public Solana address, live SOL balance, all non-zero SPL token holdings, and interactive action buttons.

/wallet
Jupsy Bot Avatar
Jupsy APP Today at 12:05 PM
๐ŸŽ Airdrop Points: 1,250 | Buy/Sell Tokens to earn
๐Ÿ’ณ Your Solana Wallet
8RTVFJSKXmyRi7rX13ogG8gXBFe3n2Grh6msQdXpjXvR
SOL Balance: 2.325 SOL
SPL Tokens Balance
โ€ข JUP: 4,456.20
โ€ข USDC: 750.85
โ€ข JUPSY: 150,000.00
Transfers

Depositing Funds & Scannable QR Codes

Clicking the ๐Ÿ“ฅ Deposit button in /wallet renders a private embed containing:

  • Your Full Public Key: Ready to copy with 1 click in Discord.
  • Live Scannable QR Code: Compatible with Phantom, Solflare, Backpack, and Coinbase Wallet camera scanners.
  • Clickable Solscan Link: Direct hyperlink to inspect your wallet address on Solscan.io โ†—.
๐Ÿ’ก
Instant Reflection: Solana deposits typically confirm in under 1 second. Run /wallet immediately after sending from Phantom or an exchange to see your updated SOL and token balances.
Transfers

Multi-Asset Withdrawals & Security Controls

Clicking the ๐Ÿ“ค Withdraw button in /wallet launches an interactive selection menu allowing you to cash out either native Solana (SOL) or $JUPSY Tokens directly to any external Solana wallet address (Phantom, Solflare, Backpack, or hardware wallets).

Interactive Asset Selection Menu

Upon clicking Withdraw, an ephemeral menu displays your live balances with a native Discord Select Menu:

  • ๐Ÿช™ Solana (SOL): Transfer native SOL to your external wallet. Supports fixed numbers, percentages (e.g. 50%), or max (automatically retains a 0.001 SOL network reserve).
  • ๐Ÿ’Ž $JUPSY Token: Cash out $JUPSY SPL tokens on-chain with zero platform fees. Automatically initializes the recipient's Associated Token Account (ATA) if needed.

Withdrawal Protection Rules & Reserves

Asset / Field Validation Rule Description
Recipient Address Valid Base58 Solana Public Key Cryptographically validated using Ed25519 format checks (32โ€“44 characters) before broadcast to prevent sending funds to malformed addresses.
$JUPSY Minimum Amount amount >= 10 $JUPSY The minimum withdrawal threshold for $JUPSY is 10 $JUPSY tokens.
$JUPSY Wallet Reserve balance - amount >= 1.0 $JUPSY Users must always leave at least 1 $JUPSY token in their wallet after withdrawing (minimum wallet balance to initiate is 11 $JUPSY).
$JUPSY Smart MAX max / 100% = balance - 1.0 Entering max, all, or 100% automatically calculates and withdraws the maximum allowable amount while leaving exactly 1 $JUPSY reserved.
Network Gas Fee Pre-Check sol_balance >= ~0.002 SOL Transferring SPL tokens requires a small amount of SOL in the wallet to pay Solana network fees and idempotent ATA creation for destination wallets.
SOL Fee Reserve balance - amount >= 0.001 SOL When cashing out SOL with max, a buffer of 0.001 SOL is automatically retained to pay for the transfer transaction fee.
2-Step Confirmation View Interactive Approval Screen Displays asset, amount, destination address, and remaining balance with red Confirm Withdraw and gray Cancel buttons before signing on-chain.
Trading

Buying SPL Tokens with SOL

Buying any token takes seconds. Simply click ๐ŸŸข Buy Tokens in your /wallet:

1

Specify Token Symbol or Mint Address

Enter any ticker (e.g. BONK, JUP, WIF, PUMP, USDC) or paste any raw 44-character Solana mint address.

2

Enter SOL Amount & Slippage Tolerance

Input the amount of SOL to swap (e.g. 0.1) and your slippage percentage (default: 1.0%).

3

Review In-Place Swap Quote & Confirm

Jupsy Bot fetches the exact Jupiter routing quote and displays estimated output tokens. Click Confirm Swap. The transaction signs, broadcasts via Helius RPC, and confirms with a Solscan transaction hash receipt.

1-Click Swap

1-Click Quick Buy $JUPSY

The โšก Quick Buy $JUPSY button located on the /wallet console allows users to purchase the native $JUPSY token with a single click, completely bypassing manual modal typing.

๐Ÿ’Ž
Holder Benefits: $JUPSY holders enjoy 0% platform fees, Free Mint NFT Whitelist access, and earn +50 Airdrop Points per trade!

How Quick Buy Works:

  1. Open your wallet console using /wallet.
  2. Click the purple โšก Quick Buy $JUPSY button.
  3. Select an amount preset: 0.05 SOL, 0.1 SOL, 0.25 SOL, 0.5 SOL, or 1.0 SOL.
  4. Jupsy Bot automatically routes the swap through Jupiter, broadcasts the transaction on Solana, and credits your wallet immediately!
Community & Gifting

/tip โ€” $JUPSY Token Tipping

/tip user:@Member amount:<int>

Send $JUPSY tokens directly to fellow Discord members with sub-second on-chain settlement, automated recipient wallet generation, and interactive confirmation.

๐ŸŽ
Token Restriction: Tips are strictly supported for $JUPSY tokens (hMRrRA85NVbUojJTkHhJUoPdWRvGPkyiin9rRc2kory). Use /wallet โž” โšก Quick Buy $JUPSY to acquire tokens to tip!

Key Features & On-Chain Mechanics:

  • Auto-Provisioned Recipient Wallets: If the recipient has never used Jupsy Bot before, the bot automatically provisions an encrypted Solana wallet for them on-the-fly.
  • Idempotent ATA Creation: The transaction automatically creates the recipient's Associated Token Account (ATA) on-chain if it does not already exist, covered by the sender's network fee.
  • Interactive Confirmation View: Renders a preview modal showing the recipient's public address, current balance, and balance after tip before executing.
  • Dual Activity History: Automatically logs a TIP_SENT entry for the sender and a TIP_RECEIVED entry for the recipient in /logs.
  • Live Channel Announcements: Broadcasts a tip celebration embed into the server's configured /logs-channel (respecting server privacy settings).
  • Permanent $JUPSY Vault Protection: $JUPSY token accounts are permanently exempt from rent reclaiming and can never be closed or burned.

How to Send a Tip:

  1. Type /tip in any channel.
  2. Select the user you want to tip (e.g. @Friend).
  3. Enter the amount of $JUPSY tokens to send (e.g. 100, 500, 1000).
  4. Review the confirmation view and click ๐ŸŽ Confirm Tip to execute the transfer.
Trading

Selling SPL Tokens Back to SOL

Click ๐Ÿ”ด Sell Tokens in your /wallet. You will see an interactive menu of all SPL tokens currently held in your wallet:

  • Select Token: Pick the token you wish to sell from your active holdings.
  • Percentage or Fixed Amount: Choose 25%, 50%, 75%, 100% (ALL), or type an exact token quantity.
  • Sub-Second Execution: Swaps execute directly against Jupiter DEX pools and return native SOL into your wallet.
Rent Reclaim

1-Click Rent Reclaiming & Fail-Safe Dust Burning

Every time an Associated Token Account (ATA) is created on Solana, approximately 0.002039 SOL (~$0.20 USD) is locked as an on-chain rent-exemption deposit. When you sell tokens, accounts with 0 balance or tiny dust residues remain open on-chain holding your rent.

๐Ÿ›ก๏ธ
Fail-Safe Price Protection: When scanning tokens with tiny balances (< 0.01), Jupsy Bot rigorously verifies live market valuation against Jupiter liquidity pools. If a token is worth more than the rent refund, or if the price is unverified/unquoted, the bot strictly protects the asset and refuses to burn it. Only verified dust (< 0.00204 SOL value) and 100% empty accounts are eligible for rent reclaiming.

How to Reclaim Rent:

  1. Open your wallet console with /wallet.
  2. Click the ๐Ÿงน Claim Rent button located on the same line as your SOL balance.
  3. Review the detected empty and dust token accounts alongside total reclaimable SOL and live USD valuation.
  4. Click Claim SOL to broadcast on-chain instructions via your Helius RPC and instantly receive your SOL refund!
Database Engine

4,600+ Tokens DB & Truncated Precision

Jupsy Bot features an automated 24-hour background synchronization engine that populates an in-memory token database of over 4,600+ verified Solana tokens.

โš–๏ธ
Truncation vs Rounding: Traditional bots round balances upwards (e.g. `0.0549` SOL rounds to `0.055` SOL), causing confusing "Insufficient Funds" errors when users try to spend their full balance. Jupsy Bot truncates balances up to 3 decimal places without rounding, guaranteeing that every displayed decimal is 100% spendable.
Phase 2 Feature

Automated Solana Copy Trading Suite

Jupsy Bot's automated copy trading engine allows you to mirror the token purchases and sales of any top trader in your Discord server with institutional-grade safeguards.

๐Ÿ›ก๏ธ

Fixed SOL Buy Allocation

Regardless of whether the trader buys with 10 SOL or 100 SOL, your trade executes with your exact configured budget (e.g. 0.05 SOL).

โš–๏ธ

Proportional Auto-Exits

When the trader sells 50% of their bag, Jupsy Bot automatically sells 50% of your bag for that specific token.

๐Ÿ“ฉ

Direct Discord DM Receipts

Every mirrored transaction immediately sends you a private DM receipt with Solscan transaction links and execution prices.

Command Reference

/copy-trade follow โ€” Mirroring a Trader

Start mirroring any Discord member in your server with customizable SOL limits and slippage tolerances.

/copy-trade follow user:@trader max_sol_amount:0.05 slippage_pct:1.5

Command Parameters

Parameter Type Default Description
user Required Member โ€” The Discord user whose trades you want to mirror.
max_sol_amount Optional Float 0.1 SOL Maximum amount of SOL to spend per copied buy order (min: 0.001 SOL).
slippage_pct Optional Float 1.5% Maximum allowable slippage percentage for mirrored orders (0.1% - 50.0%).
๐Ÿ”’
Prerequisite Check: To prevent unexpected errors, Jupsy Bot requires followers to have completed /setup and executed at least 1 prior test swap in /wallet before enabling copy trading.
Mechanics

Proportional Exits & Gas Retention

The copy trading engine uses smart proportion calculation to handle multi-step scale-outs:

Example: Proportional Scale-Out Workflow

  1. Buy Signal: @Trader buys 1,000,000 $BONK with 5 SOL. Follower buys 10,000 $BONK with their configured 0.05 SOL limit.
  2. Partial Take-Profit: @Trader sells 500,000 $BONK (50% of their bag). Jupsy Bot automatically calculates the 50% ratio and sells 5,000 $BONK (50% of follower's bag) into SOL.
  3. Final Exit: @Trader sells their remaining $BONK. Follower's remaining balance is sold automatically.
Management

Managing Targets: List, Pause & Resume

You can manage your active copy trading targets at any time with dedicated commands:

/copy-trade list

Displays all traders you are currently copying, their active/paused status, total copied trades, and total SOL allocated.

/copy-trade pause user:@trader

Temporarily pauses mirroring a trader without losing your custom SOL allocation and slippage settings.

/copy-trade resume user:@trader

Re-activates mirrored trading for a previously paused target.

/copy-trade unfollow user:@trader

Completely removes a trader from your copy trading list.

Discovery

/copy-trade leaderboard โ€” Server Rankings

Discover top traders in your Discord server ranked by Net Realized Profit (SOL), Win Rate %, and Total Trade Volume.

/copy-trade leaderboard
Workflow

1-Click Copy Trading via /pnl

When inspecting any trader via /pnl user:@trader, Jupsy Bot automatically renders a ๐Ÿ‘ฅ Copy Trade @Trader button at the bottom of their profile embed. Clicking this button opens a modal allowing you to configure your budget and start copying with zero typing required.

Analytics

/pnl โ€” Portfolio Analytics

The /pnl command calculates your comprehensive trading performance across all Solana swaps executed with Jupsy Bot.

/pnl

Metrics Calculated

Metric Formula / Details
Net Realized PnL Total SOL Received from Sells - Cost Basis of Sold Tokens (calculated strictly on tokens bought and sold via Jupsy Bot; external deposits excluded)
Realized ROI % (Net Realized PnL / Cost Basis of Sold Tokens) * 100
Win Rate % (Profitable Closed Trades / Total Closed Tracked Trades) * 100
Total Trade Volume Aggregate SOL volume across completed Jupsy Bot buy and sell transactions.
Inspection

Inspecting Other Traders (/pnl user)

Audit the verified track record of any server member before deciding to mirror their trades.

/pnl user:@trader
Deep Dive

Token Breakdown Analysis (/pnl token)

Inspect your historical profit and loss on an individual token basis (e.g. BONK, JUP, WIF).

/pnl token:BONK
Auditability

/logs โ€” Transaction Audit History

Jupsy Bot logs every transaction in the database and formats your 20 most recent entries with dynamic local Discord timestamps (<t:timestamp:f>) and Solscan verification links.

/logs
Clean UI

Log Categories & Solscan Links

Activity logs are categorized cleanly into four main action types:

Category Action Trigger Solscan Hyperlink Included
BUY Token purchase via /wallet or automated copy trade. โœ… Yes (Transaction Signature)
SELL Token sale via /wallet or automated copy trade. โœ… Yes (Transaction Signature)
WITHDRAWAL SOL or SPL token transfer to external address. โœ… Yes (Transaction Signature)
COPY_TRADE Follow, unfollow, pause, or resume action. โ€”
๐Ÿงน
Spam-Free UI: Routine wallet balance checks (WALLET_CHECK) are logged silently in the database for security compliance but are filtered out from the Discord /logs embed so your transaction feed stays clean and readable.
Rewards & Whitelists

Airdrop Points Reward Engine

Jupsy Bot features an automated trading reward system where users accumulate Airdrop Points on every buy and sell swap. Points directly determine whitelist qualification for our upcoming Free Mint Genesis NFTs and distribution of the 100% Dev Supply Airdrop.

๐ŸŽ
Checking Your Score: Your live airdrop score is prominently displayed at the top of your /wallet console (e.g. -# Airdrop Points: 1,250 | Buy/Sell Tokens to earn) and announced with every trade in live server notifications.

Point Reward Mechanics

Trade Type / Token Points Awarded Notes
Standard Token Buy (All Tokens) +10 Points Base points awarded automatically on every completed buy swap.
Standard Token Sell (All Tokens) +10 Points Base points awarded automatically on every completed sell swap.
$JUPSY Token Trades (Buy or Sell) +50 Points 5x Boost Multiplier! Trading $JUPSY awards 50 points per trade.
Public Command

/airdrop-config view โ€” Reward Dashboard

Any user can run /airdrop-config view in Discord to inspect active airdrop reward tiers, default point values, and special token multipliers.

/airdrop-config view

Bot Owner Management

  • /airdrop-config set <token> <buy_points> <sell_points>: Configures custom point multipliers for any token ticker, mint address, or DEFAULT.
  • /airdrop-config remove <token>: Removes a custom token boost, immediately reverting the token back to default point rewards.
  • /airdrop-config view: Public command for all members to view active reward rules.
Public Command

/leaderboard โ€” Airdrop Points Rankings

View live trader rankings ranked by accumulated Airdrop Points with completed trade counts. Displays the top 10 traders per page with optional page navigation and Global vs Server scope switching.

/leaderboard [page:1..N] [scope:global/server] [user:@User]

Command Parameters

Parameter Type Default Description
page Integer (โ‰ฅ 1) 1 Fetch specific page of rankings (10 traders displayed per page).
scope Choice ๐ŸŒ Global Toggle between all bot users across Discord or members within your current server.
user Member / User Optional Optional member to highlight in the rankings.
Server Administration

/logs-channel โ€” Real-Time Server Trade Feeds

Server Administrators can set up a dedicated Discord channel to broadcast live trade notifications whenever members buy, sell tokens, reclaim rent, or cash out SOL using Jupsy Bot.

/logs-channel add channel:#trade-alerts [private:True/False]

Administrator Subcommands

  • /logs-channel add channel:<#channel> [private:True/False]: Assigns the designated logging channel. Optional private toggle controls anonymity.
  • /logs-channel remove: Disables live trade logging in the server.
  • /logs-channel view: Displays the current notifications channel and privacy configuration.
๐Ÿ“ˆ
Realized Profits & Cash Out Alerts: When a user sells tokens at a profit or withdraws SOL, the notification highlights the event and live USD valuation (e.g. "๐Ÿ’ธ Someone just cashed out 0.05 SOL ($5.20)!" or "Realized Profit: +0.45 SOL ๐Ÿš€").
๐Ÿ”’
Privacy & Security Modes:
  • Public Mode (private:False): Tags the trader (e.g. @username just bought 150 $JUPSY).
  • Private Mode (private:True): Masks identity completely (e.g. Someone just bought 150 $JUPSY).
  • Zero TX Hash Leaks: For maximum trader safety, transaction signatures/hashes are never published to server channels. All tokens are hyperlinked safely to Jupiter (https://jup.ag/tokens/{mint}).
Command Guides

Standardized Help Guides

Jupsy Bot provides clean, spam-free help menus tailored to regular traders and server administrators:

User Command Guide: /help

/help

Displays a clean, private overview of all trader tools (/wallet, /pnl, /copytrade, /logs, /setup, /airdrop-config view).

Server Admin Guide: /admin-help

/admin-help

Restricted to members with Server Administrator permissions. Explains all /logs-channel trade notification controls.

Genesis Collection & $JUPSY

Genesis NFT Pass & $JUPSY Token Utility

Holding $JUPSY tokens and Genesis NFTs unlocks priority execution across all features, 0% withdrawal fees with $JUPSY, a 100% dev supply airdrop after the locking period, and server licensing rights.

โšก

Top Priority Across Everything

Holders of $JUPSY tokens and Genesis NFTs receive top-tier priority across all bot features, faster execution routing, early access tools, and dedicated support.

๐Ÿช™

0% Fees on $JUPSY Withdrawals

Zero platform fees on all withdrawals processed using the native $JUPSY token.

๐ŸŽ

100% Dev Supply Airdrop

100% of the developer token supply will be airdropped directly to $JUPSY and Genesis NFT holders after the locking period.

๐Ÿ’Ž

0% Swap Fees & Server Whitelisting

Zero platform surcharges across token swaps and permission to authorize Jupsy Bot inside your own Discord communities.

๐Ÿ’Ž Official $JUPSY Contract Address (Solana Mint)
hMRrRA85NVbUojJTkHhJUoPdWRvGPkyiin9rRc2kory
Fee Schedule

Fee Structure Comparison

Tier Swap Platform Fee Copy Trading Engine Server Whitelisting
Public Free Tier 0.5% Standard Speed Public Servers Only
$JUPSY & Genesis NFT Holder 0.0% (Zero Fees) Top Priority Execution Unlimited Servers
Troubleshooting

RPC & Swap Error Resolution

Jupsy Bot translates low-level Solana RPC errors into friendly, actionable diagnostic messages.

Error Type Root Cause How to Resolve
AccountNotFound Wallet has 0 SOL or recipient token account does not exist. Deposit a small amount of SOL (e.g. 0.01 SOL) into your Jupsy wallet address.
BlockhashNotFound Transaction expired during Solana cluster congestion. Retry the swap. Ensure your Helius RPC URL in /setup is configured.
SlippageExceeded Price moved beyond your maximum slippage tolerance. Increase slippage percentage (e.g. from 1.0% to 2.5%) during high volatility.
InsufficientBalance Attempting to swap or withdraw more SOL than available after reserving gas. Leave at least 0.005 SOL in your wallet to cover network transaction fees.
Error Guide

Managing Slippage in Fast-Moving Markets

When trading newly launched meme tokens or during major market volatility, prices can shift within milliseconds. If your swap fails with SlippageExceeded:

  • Type a higher slippage tolerance (e.g. 2.0% or 3.0%).
  • Verify your Helius RPC URL in /setup to take advantage of priority fee routing.
Balance Diagnostics

Insufficient SOL Balance & Gas Diagnostics

Solana transactions require a small amount of SOL for compute fees, network prioritization, and Associated Token Account (ATA) rent. If your wallet lacks sufficient funds for a trade, Jupsy Bot automatically displays a clear breakdown comparing your available balance with the required amount:

โ›ฝ
Exact Balance Error Example:
"โŒ Insufficient SOL Balance: Your wallet currently has 0.0060 SOL, but this transaction requires 0.0500 SOL (including network & rent fees)."

How to Resolve Insufficient Balance:

  1. Run /wallet in Discord.
  2. Click ๐Ÿ“ฅ Deposit to view your Solana deposit address and QR code.
  3. Send a small amount of SOL (e.g. 0.05 SOL or higher) from your external wallet (Phantom, Solflare, etc.).
  4. Once deposited, re-run your swap or Quick Buy!

Safety Gas Buffer:

Jupsy Bot automatically enforces a 0.005 SOL safety reserve on all withdrawals and automated copy trades to guarantee your wallet always has enough gas to execute future transactions.

Security

Cryptographic Specifications

Technical implementation details for security auditors and developers:

  • Encryption Algorithm: Fernet Symmetric Key Cryptography (AES-128-CBC + HMAC-SHA256 authenticated envelope).
  • Key Derivation: 256-bit cryptographically secure pseudorandom secret derived from environment configuration.
  • Transaction Construction: solders.transaction.VersionedTransaction with MessageV0 compiled instructions.
  • Auditability: Every trade hash and token mint is hyperlinked to official Solscan verification endpoints.
FAQ

Frequently Asked Questions

Can the bot administrators withdraw my funds? +

No. Your private keys are encrypted with AES-256 and stored in the database. Transactions can only be initiated through your personal Discord user account interactions.

Can I export my private key to Phantom or Solflare? +

You can withdraw your entire SOL and token balances to your Phantom or Solflare wallet at any time with 0 platform fees using the /wallet Withdraw modal.

What happens if a trader I copy executes a scam token? +

Jupsy Bot checks token mints against Jupiter's verified routing engine and enforces your max_sol_amount budget limit on every single buy order, capping your maximum downside per trade.