👋GuildSafe - Token Gate

Token-gating and decentralized governance all-in-one - with zero community risk. This guide will show you how to leverage GuildSafe to build a more secure, transparent, and productive community. GuildSafe offers truly unprecedented customization - with the capacity to gate based on NFTs and coins as well as the option to register multiple wallets.

🛡️ Welcome to GuildSafe!

Welcome to GuildSafe, the ultimate security and governance tool for your Telegram community. GuildSafe is designed to automate member verification, protect your group from bots and spam, and enable fair, decentralized decision-making, all while prioritizing user privacy. The core of GuildSafe revolves around two key features:

1. Anonymous & Secure Verification: Say goodbye to manually collecting wallet addresses. GuildSafe allows users to verify they meet your group's token or NFT holding requirements through a brief, secure, and anonymous process. Users prove ownership of their wallet with a micro-transaction, ensuring their private information is never exposed and admins are freed from managing sensitive data.

2. Weighted Voting Module: Transform your group's governance with asset-weighted polling. A user's voting power is directly tied to their verified stake in the community (tokens and NFTs), ensuring that the most invested members have a proportional voice in key decisions.

GuildSafe offers truly unprecedented customization - with the capacity to gate based on NFTs and coins as well as the option to register multiple wallets.

🚀 Getting Started: How It Works

When a new, un-registered user speaks in a protected group, GuildSafe will prompt them to register their wallet in a private chat. This ensures the group remains for verified members only, while all verification steps happen securely and privately. 👤 User Commands (For Everyone)

These commands help you register your wallet and verify your status. 1. Registering Your Wallet (The Secure Way) To participate in a GuildSafe-protected group, you must register a wallet that meets the group's requirements. This is a one-time process for each group.

• Step 1: Start the Process

  • When joining a gated group, the bot will automatically send you a private message with a registration link. Click the button in the group or the link in the private message to begin.

  • Alternatively, an admin can provide a registration link.

• Step 2: Submit Your Wallet

  • In the private chat with the bot, use the /register command with your SUI wallet address.

  • Usage: /register [your_wallet_address]

  • Example: /register 0xcd2d5f5fc335aba0d01e629d451c0de458ce7ed0afae8062213a97f80562e87f

• Step 3: Ownership Verification

  • The bot will check if your wallet meets the group's token or NFT requirements.

  • If it does, you'll be asked to send a small amount of SUI to a donation address. This is not a payment; it's proof (verified only via Nexa API) that you control the wallet-in-question.

  • Note that this transfer is 100% user-initiated. The bot never accesses your wallet and therefore provides zero security risk.

  • After you've sent the SUI, use the /confirm command in the private chat to finalize the verification.

2. Add/Check Your Wallet in the Group

• /mywallets: Use this command in the group to receive a private link to submit a new wallet or check your currently registered one.

👑 Admin Commands

These commands are the core of the bot and are only available to group administrators.1. Initial Configuration

• /gsconfig: This is the most important command. It allows you to set up all the rules for your group in a private chat, including:

  • Registration Mode: Choose whether users need to hold a specific token, an NFT from a collection, or either.

  • Token & NFT Thresholds: Set the minimum amount of tokens or NFTs required for access.

  • Auto-Remove: Enable or disable the feature to automatically remove users who no longer meet the holding requirements.

2. Weighted Voting

• /votesetup: Configure the parameters for your weighted polls. You can decide how much voting power is granted per NFT or per 1 million tokens.

• /vote: Create a new weighted poll in your group. Users' votes will be weighted automatically based on the assets in their registered wallets.

3. Manual User Management. Note: Telegram API limitations mean that these commands will only work if a user has VERY recently sent a message in chat.

• /exempt: Reply to a user's message or use their @username to make them exempt from all holding requirements. This is useful for team members, partners, or special guests.

• /addwallet: Reply to a user's message or use their @username to manually add a wallet address to their account.

❓ Frequently Asked Questions (FAQ)

• Why do I need to send SUI? Is it safe?

  • Yes, it's completely safe. The small SUI transfer is a standard method to prove you have control over your wallet without ever revealing your private keys. The bot only verifies that the transaction occurred on the public blockchain.

• Why was I removed from the group?

  • If the "Auto-Remove" feature is enabled, the bot periodically checks if registered members still meet the holding requirements. If your balance drops below the threshold, you may be removed. You can rejoin by meeting the requirements and registering again.

• Why can't I vote?

  • Your voting power is based on the tokens and NFTs in your registered and verified wallet. If you haven't registered or your holdings don't meet the criteria set by the admin, you won't be able to vote.