Memo Verification Bot
The bridge between Telegram communities and the Immutable Layer.
The Memo Verification Bot enforces token-gating rules defined on the Memo Protocol, ensuring that every member in your group is a verified stakeholder. It enables communities to coordinate with the speed of Telegram while maintaining the integrity of the blockchain.
User Manual: How to Join
If you are trying to join a Memo-gated group, the process is designed to be secure and passive.
The Verification Flow
- Request to Join: Click the group's invite link.
- Check DMs: The bot will send you a private message with a secure access link.
- The "Magic Transaction": Follow the instructions to send a self-transfer on Solana.
- Note: This transaction proves you own the wallet without ever exposing your private keys or connecting to a website.
- Automatic Approval: Once the bot's indexers see your proof on the Immutable Layer, you are instantly approved.
Essential Member Commands
| Command | Description |
|---|---|
/verify | Starts the verification process. Generates your unique challenge. |
/mystatus | Checks your current verification status, wallet address, and token balance. |
/rules | Displays the current on-chain rules (Token Mint, % Holding required). |
/leaderboard | Shows the Top 50 holders in the current chat. |
Admin Guide: Management & Moderation
1. Setup
- Add Bot: Add
@memo_verification_botto your group. - Permissions: Promote to Admin with "Ban Users" and "Invite Users via Link".
- Group Settings: Enable "Request Admin Approval" in your invite link settings. This allows the bot to intercept and verify users before they join.
2. Linking a Community
Once you have created a community via the Web App (or the /create wizard), link it to your Telegram group:
- Command:
/link [Community Address] - Requirement: You must be an Admin/Creator in the Telegram group.
3. Monitoring & Safety
Keep your community clean with these tools:
/audit: Scans the entire member list. identifying users who have sold their tokens or disconnected their wallets./kick: Manually triggers a cleanup. The bot effectively removes any user who no longer meets the on-chain requirements./check: Reply to any message with/checkto instantly see that user's wallet balance and status.
Advanced Protocol Reference
The following section details the technical specifications of the bot's operation on the Immutable Layer.
Core Security Model
Passive Verification Architecture
The bot operates on a "Don't Trust, Verify" model. It never asks for private keys or wallet connections. Instead, it monitors the Immutable Layer (Solana) for specific public transactions that prove ownership.
Full Command Reference
Permissions are strictly enforced by the protocol logic (admin.js, verify.js).
| Command | Arguments | Description | Permission |
|---|---|---|---|
/start | None | Initialize interaction. | User |
/sent | None | Triggers a manual re-check of the Immutable Layer. | User |
/poll | "Question" ... | Creates a token-gated poll. | User |
/vote | (Button) | Records a vote on the Immutable Layer. | User |
/tally | None | Forces a recount of poll votes. | Admin |
/create | None | Starts the Community Creation Wizard (DM Only). | Admin |
/setup | None | Interactive configuration for gating rules. | Admin |
/export | None | Exports a CSV file of all member data. | Admin |
/locked | None | View all locked token amounts. | User |
/addlocked | [amount] ... | Manually registers a locked token amount. | Admin |
Edge Cases & Restrictions
- Group Only: Commands like
/leaderboard,/audit, and/kickfail in DMs. - Admin Requirement: The user running
/linkMUST hold the required token amount themselves. - Creator Eligibility: To run
/create, a user must hold a minimum of 50,000 MEMO.