Admin Commands Reference

Complete reference of all admin commands for managing the ESDT Tipping Bot

Complete reference of all admin commands for managing the bot.

Project Management

/register-project

Register a new project with auto-generated wallet.

Usage: /register-project project-name supported-tokens [project-logo-url] [user-input]

Parameters:

• project-name (Required): Unique name for the project

• supported-tokens (Required): Comma-separated list of token tickers

• project-logo-url (Optional): URL to project logo image

• user-input (Optional): Additional notes

Example:

/register-project MainWallet REWARD-cf6eac,EGLD https://logo.png

Note: The bot automatically generates a new MultiversX wallet for your project. Wallet details (address, seed phrase, PEM file) will be displayed in the command response and sent to you via DM. Make sure to save the PEM file and seed phrase securely. You must top up the wallet with EGLD (for fees) and REWARD tokens (for usage fees) before using it.

/update-project

Update project settings.

Usage: /update-project project-name [new-project-name] [wallet-address] [wallet-pem] [supported-tokens] [project-logo-url] [qr-code-url] [user-input]

Examples:

/update-project MainWallet project-logo-url:https://new-logo.png
/update-project Community Fund qr-code-url:https://new-qr.png
/update-project MainWallet supported-tokens:REWARD-cf6eac,EGLD,USDC

/list-projects

List all registered projects.

Usage: /list-projects [public]

/delete-project

Delete a project (requires "DELETE" confirmation).

Usage: /delete-project project-name confirm:DELETE

⚠️ Warning: This action cannot be undone!

/set-community-fund

Create and set Community Fund (auto-generated wallet).

Usage: /set-community-fund fund-name supported-tokens [qr-code-url]

Example:

/set-community-fund MainFund REWARD-cf6eac,EGLD https://qr-code.png

---

Token & NFT Management

/send-esdt

Send ESDT tokens to a user.

Usage: /send-esdt project-name user-tag token-ticker amount [memo]

Example:

/send-esdt MainWallet @user REWARD-cf6eac 100 "Welcome bonus"

/send-nft

Send NFT or SFT to a user.

Usage: /send-nft project-name collection nft-name user-tag [memo] [amount]

Note: Supports both NFTs and SFTs. For SFTs, specify the amount parameter.

Example:

/send-nft MainWallet COLLECTION-abc123 NFT-NAME @user "Airdrop"

For SFTs:

/send-nft MainWallet COLLECTION-abc123 SFT-NAME @user "Airdrop" amount:5

/house-tip

Tip user from House Balance.

Usage: /house-tip user token amount source [memo]

Parameters:

• user: Discord user to tip

• token: Token ticker

• amount: Amount to send

• source: Which house to use (betting, auction, lottery, or drop)

• memo (Optional): Note about the tip

Example:

/house-tip @user REWARD-cf6eac 500 betting "Reward for participation"

/update-token-metadata

Update token information.

Usage: /update-token-metadata token-ticker name decimals

Example:

/update-token-metadata REWARD-cf6eac REWARD 18

---

Activity Management

/create-lottery

Create a new lottery game.

Usage: /create-lottery winning-numbers total-numbers token ticket-price drawing-frequency [house-commission] [channel] [initial-prize-pool]

Parameters:

• winning-numbers: Number of numbers to match (e.g., 3)

• total-numbers: Total pool of numbers (e.g., 50)

• token: Token ticker for tickets

• ticket-price: Price per ticket

• drawing-frequency: daily, weekly, or manual

• house-commission (Optional): House commission percentage

• channel (Optional): Channel to post lottery

• initial-prize-pool (Optional): Starting prize pool from Lottery House

Example:

/create-lottery 3 50 REWARD-cf6eac 10 daily 5 #lottery 1000

/create-fixtures

Create football matches for betting.

Usage: /create-fixtures competition token amount [channel]

Parameters:

• competition: Competition code (e.g., PL for Premier League)

• token: Token ticker for bets

• amount: Bet amount per match

• channel (Optional): Channel to post matches

Example:

/create-fixtures PL REWARD-cf6eac 100 #betting

/create-auction

Create an NFT or SFT auction.

Usage: /create-auction collection nft-name starting-amount duration [token] [min-bid-increase] [title] [description] [amount]

Note: Supports both NFTs and SFTs. For SFTs, specify the amount parameter to set the quantity being auctioned.

Parameters:

• collection: NFT/SFT collection identifier

• nft-name: Specific NFT/SFT name

• starting-amount: Starting bid amount

• duration: Auction duration in hours

• token (Optional): Token for bidding

• amount (Optional): Quantity for SFTs (default: 1 for NFTs)

• min-bid-increase (Optional): Minimum bid increase

• title (Optional): Auction title

• description (Optional): Auction description

Example:

/create-auction COLLECTION-abc123 NFT-NAME 100 24 REWARD-cf6eac 10

/update-lottery

Update an existing lottery (Admin only).

Usage: /update-lottery lottery_id [topup_prize_pool] [update_ticket_price]

Parameters:

• lottery_id (Required): Select the lottery to update

• topup_prize_pool (Optional): Amount to add to prize pool from Lottery House

• update_ticket_price (Optional): New ticket price for future purchases

Important: Only LIVE lotteries can be updated. At least one update option must be provided.

Example:

/update-lottery lottery-123 topup_prize_pool:500 update_ticket_price:15

/update-football-match

Top up the bonus pot (prize pool) for an existing football match (Admin only).

Usage: /update-football-match game_id topup-pot-size

Parameters:

• game_id (Required): Select the match to update

• topup-pot-size (Required): Amount to add to the bonus pot (prize pool)

Important: Only matches with status SCHEDULED, TIMED, or IN_PLAY can be updated. This adds to the existing bonus pot, creating a larger prize pool for winners.

Example:

/update-football-match 12345 topup-pot-size:200

This adds 200 tokens to the bonus pot, increasing the total prize pool for this match.

/create-staking-pool

Create a new NFT staking pool.

Usage: /create-staking-pool collection_ticker reward_token_identifier initial_supply reward_per_nft_per_day duration_months [pool_name] [staking_total_limit] [staking_limit_per_user]

Note: Required parameters must be provided before optional parameters.

Parameters:

• collection_ticker (Required): Collection identifier for stakable NFTs

• reward_token_identifier (Required): Token identifier for rewards

• initial_supply (Required): Initial reward supply amount

• reward_per_nft_per_day (Required): Daily reward per NFT

• duration_months (Required): Pool duration in months (1-12)

• pool_name (Optional): Display name for the pool

• staking_total_limit (Optional): Maximum NFTs that can be staked

• staking_limit_per_user (Optional): Maximum NFTs per user

Example:

/create-staking-pool COLLECTION-abc123 REWARD-cf6eac 10000 10 "My Pool" 1000 50 6

/update-staking-pool

Update an existing staking pool.

Usage: /update-staking-pool staking_pool [topup_staking_pool] [change_reward_per_nft] [increase_nft_pool_limit] [increase_user_staking_limit] [trait_filter_action] [trait_filter_type] [trait_filter_value] [trait_filter_index]

Parameters:

• staking_pool (Required): Select the pool to update

• topup_staking_pool (Optional): Add more tokens to pool supply

• change_reward_per_nft (Optional): Update daily reward per NFT

• increase_nft_pool_limit (Optional): Increase total NFT limit

• increase_user_staking_limit (Optional): Increase per-user limit

• trait_filter_action (Optional): Manage trait filters (add, remove, clear)

• trait_filter_type (Optional): Trait type for filtering

• trait_filter_value (Optional): Specific trait value

• trait_filter_index (Optional): Filter index to remove

Note: Only the pool creator can update their pool.

Example:

/update-staking-pool pool-123 topup_staking_pool:5000 change_reward_per_nft:15

/close-staking-pool

Close a staking pool and return NFTs to users.

Usage: /close-staking-pool staking_pool_name

Parameters:

• staking_pool_name (Required): Select the pool to close

Note: Only the pool creator can close their pool. All NFTs are returned and final rewards are distributed.

Example:

/close-staking-pool pool-123

/start-drop-game-automation

Start the DROP Game automation system with hourly rounds and weekly leaderboard.

Usage: /start-drop-game-automation token-ticker base-amount min-droppers [collection-identifier] [nft-collection-multiplier]

Parameters:

• token-ticker (Required): Token identifier for airdrop rewards (e.g., REWARD-cf6eac)

• base-amount (Required): Base amount per point for weekly airdrops (e.g., 10)

• min-droppers (Required): Minimum number of participants required to close a round (e.g., 5)

• collection-identifier (Optional): NFT collection identifier for supporter status calculation

• nft-collection-multiplier (Optional): Enable NFT-based multiplier system (true or false)

Example:

/start-drop-game-automation token-ticker:REWARD-cf6eac base-amount:10 min-droppers:5 collection-identifier:COLLECTION-abc123 nft-collection-multiplier:true

Note: Once started, the game runs automatically with hourly rounds. Users participate by reacting with 🪂 emoji. Weekly airdrops are distributed every Sunday at 18:00 ECT in the specified reward token.

/stop-drop-game-automation

Stop the active DROP Game automation.

Usage: /stop-drop-game-automation

Note: This stops the automated game system. Current round will complete, but no new rounds will be created.

/show-drop-game-leaderboard

Display the current weekly leaderboard with points and rankings.

Usage: /show-drop-game-leaderboard [public]

Parameters:

• public (Optional): Show leaderboard publicly or privately

Shows:

• Current week's top participants

• Points earned

• Supporter status (if multiplier enabled)

• Rankings

---

Monitoring & Debugging

/server-balances

View server-wide virtual account summary.

Usage: /server-balances [public]

Shows:

• Total virtual account balances

• House balance

• Community Fund balance

• Token breakdowns

/house-balance

View House Balance (earnings, spending, PNL).

Usage: /house-balance [public]

Shows:

• Betting House: Earnings, Spending, PNL

• Auction House: Earnings, Spending, PNL

• Lottery House: Earnings, Spending, PNL

• Drop House: Earnings, Spending, PNL

/blockchain-status

Check blockchain listener status.

Usage: /blockchain-status

Shows:

• Listener status (running/stopped)

• Number of monitored wallets

• Polling interval

• Processed transaction count

/list-wallets

List registered wallets.

Usage: /list-wallets [filter] [page] [public]

Parameters:

• filter (Optional): Filter by username or wallet address

• page (Optional): Page number for pagination

• public (Optional): Show publicly or privately

/check-community-fund-balance

Check Community Fund balances for withdrawals.

Usage: /check-community-fund-balance [transfers]

Parameters:

• transfers (Optional): Number of transfers to check (default: 1)

Shows:

• EGLD balance

• REWARD balance

• Required amounts for withdrawals

• Balance breakdown

/update-usernames

Update Discord usernames for all virtual accounts.

Usage: /update-usernames

Updates usernames in the database to match current Discord usernames.

/test-football-api

Test Football-Data.org API connectivity.

Usage: /test-football-api

Verifies that the Football-Data.org API is accessible and working.

/debug-server-config

Debug server configuration.

Usage: /debug-server-config

Shows detailed server configuration information for troubleshooting.

/debug-user

Debug user information.

Usage: /debug-user user

Shows detailed information about a specific user for troubleshooting.

/delete-all-server-data

Delete ALL server data and perform mass refund (requires "DELETE ALL DATA" confirmation).

Usage: /delete-all-server-data confirm:"DELETE ALL DATA"

⚠️ WARNING: This is a destructive operation that cannot be undone! It will:

• Delete all projects

• Delete all user wallets

• Delete all virtual accounts

• Delete all game data

• Delete all activity data

• Perform mass refunds (if possible)

---

Utility Commands

/show-community-fund-address

Display the Community Fund wallet address and QR code.

Usage: /show-community-fund-address [public]

Shows:

• Community Fund wallet address

• QR code (if available)

• Supported tokens

/get-competition

View last used competition code.

Usage: /get-competition

Useful for remembering which competition code was used for football betting.

---

Command Permissions

All admin commands require Administrator permissions in the Discord server.

If you don't have administrator permissions, contact your server admins.

---

Best Practices

Project Management

• Use separate wallets for different purposes

• Keep project logos and QR codes updated

• Regularly review and update supported tokens

• Monitor project balances

Activity Management

• Set reasonable bet amounts and ticket prices

• Monitor House Balance regularly

• Use House Balance to seed initial prize pools

• Track activity performance

Monitoring

• Check blockchain listener status regularly

• Monitor server balances

• Review House Balance PNL

• Keep usernames updated

Security

• Never share PEM files

• Use new wallets for the bot

• Keep minimal tokens in bot wallets

• Regularly review registered wallets

---

For more detailed information on specific commands, refer to the relevant sections in the documentation.