For Admins

Admin Guide

Create and manage token-gated communities on Solana.

Memo Bot works on both Telegram and Discord. The commands and setup process are similar—only the platform configuration differs.


Prerequisites

⚠️

Required for Community Creation:

  • ✅ Verified Solana wallet (via /verify)
  • 50,000 $MEMO tokens in your wallet
  • 1 $MEMO to deploy rules on-chain

Why 50,000 $MEMO?

  • Ensures serious commitment to community building
  • Prevents spam and abuse
  • Aligns incentives with protocol success

$MEMO Contract: 8ZQme2xv6prRKkKNA4PTn5DSXUTdY6yeoc5yDkm7pump


Creating Your Community

Verify Your Wallet

Run /verify <YOUR_WALLET_ADDRESS> and complete the self-transfer process.

Start the Creation Wizard

DM the bot and run:

/create

The wizard will guide you through:

  1. Community Name — Display name for your community
  2. Token Mint Address — The SPL token contract users must hold
  3. Token Requirement — Fixed amount (e.g., 1000) or percentage (e.g., 0.5%)
  4. Whale Threshold — Percentage for whale badge (e.g., 5 for 5%)

Deploy Rules On-Chain

The wizard provides:

  • A Community Address (newly generated)
  • JSON rules data to store on-chain

Send 1 $MEMO to the Community Address with the JSON in the memo field:

🚨

CRITICAL: You must paste the JSON into the memo field! Without this, your community won't work. Use Phantom if your wallet doesn't support memo fields.

Add Bot & Configure Platform

Telegram Setup:

  1. Add @memo_verification_bot to your group
  2. Promote bot to Admin with these permissions:
    • ✅ Ban Users
    • ✅ Invite Users via Link
  3. Create an invite link with "Request Admin Approval" enabled
  4. Run /link <COMMUNITY_ADDRESS> in the group

Test Your Setup

  1. Run /rules to verify settings
  2. Have a friend test the verification flow
  3. Run /audit to check member compliance

Admin Commands

Analytics & Community

CommandDescription
/leaderboardTop 50 token holders with rankings
/supplyGroup's total holdings and % of supply
/whalesMembers meeting whale threshold
/rulesCurrent community requirements

Governance

CommandDescription
/poll "Q" "A" "B"Create token-weighted poll
/tallyCalculate weighted results (reply to poll)

Core Management

CommandDescription
/link <address>Link group/server to community
/createLaunch creation wizard (DM only)
/auditScan members, report non-compliance
/kickRemove non-compliant members
/checkCheck user status (reply to message)
/exportExport member data to CSV

Locked Token Management

CommandDescription
/lockedView tracked locked allocations
/addlocked <amount> <link>Track locked allocation
/removelocked <number>Remove tracked allocation

User Whitelist

CommandDescription
/whitelistWhitelist a user for your group (DM only)
/viewwhitelistView all whitelisted users (DM only)
/removewhitelistRemove a user from whitelist (DM only)

Key Command Details

/audit

Scans all members and reports compliance issues without removing anyone.

📊 Audit Results

Total Tracked: 45
✅ Compliant: 38
❌ Non-Compliant: 7

/kick

⚠️

Use /audit first to preview who will be affected.

Removes non-compliant members from the group entirely.

/export

Exports verified member data to CSV (sent to your DM):

  • User ID, Username
  • Wallet address(es)
  • Token balance
  • Timestamp

/whitelist (DM Only)

Whitelist users who should bypass wallet verification—ideal for team members, partners, or special guests.

What whitelisting does:

  • User can join the group without verifying a wallet
  • User is excluded from /audit reports
  • User is never removed by /kick

How to use:

  1. DM the bot: /whitelist
  2. Select your group from the list
  3. The bot will scan the group for non-compliant members (no wallet, etc.)
  4. Click the button for the user you want to whitelist.
  5. (Optional) Use "Manual Input" to enter a specific username or ID if they don't appear in the list.
ℹ️

To view whitelisted users, run /viewwhitelist in a DM. To remove someone, run /removewhitelist in a DM—same interactive flow, select group then enter username.


Troubleshooting

Bot not approving/verifying users

  • Bot must have Ban Users + Invite Users permissions
  • Invite link must have "Request Admin Approval" enabled
  • Run /rules to verify link is active

"Rules not found" when running /link

  1. Wait 30-60 seconds for Solana to index
  2. Verify you sent 1 $MEMO with JSON in the memo field
  3. Check you're using the Community Address (not token address)

"Access Denied" for admin commands

  • You need 50,000 $MEMO in your verified wallet
  • Run /mystatus to confirm your wallet is linked

Best Practices

Token Requirements

  • New projects: Use percentages (e.g., 0.1%) for fair scaling
  • Established projects: Use fixed amounts for predictability

Compliance Management

  1. Run /audit weekly
  2. Review the report
  3. Optionally warn members
  4. Run /kick to enforce

Command Quick Reference

/link <address>      # Link community
/create              # Create community (DM)
/audit               # Scan compliance
/kick                # Remove non-compliant
/check               # Check user (reply)
/export              # Export CSV
/poll "Q" "A" "B"    # Create poll
/tally               # Weighted results (reply)

🚀

Ready to create your community? Run /create in a DM with the Memo bot!

Open Telegram Bot → (opens in a new tab)