Skip to main content

🔑 Token Gating

The Token Gating feature in Fren One enables community managers to verify crypto token ownership on several blockchain networks. This allows token holders to gain exclusive perks, such as access to private groups, roles, or additional XP points.

Overview​

Token Gating creates exclusive experiences for your token holders by:

  • Verifying Token Ownership: Confirm users hold specified tokens on supported blockchains
  • Granting Exclusive Perks: Assign roles, award XP, or provide private group access
  • Automating Access Control: No manual verification required
  • Supporting Multiple Chains: Works across 7 major blockchain networks
  • Incentivizing Holding: Reward community members for supporting your token
Multi-Chain Support

Token Gating works seamlessly across all major blockchain networks, automatically verifying holdings on the chain where your token is deployed.

Supported Blockchains​

Fren One's Token Gating supports the following blockchain networks:

  • Ethereum - ERC-20 tokens
  • Solana - SPL tokens
  • Polygon - MATIC network tokens
  • Binance Smart Chain - BEP-20 tokens
  • Avalanche - AVAX network tokens
  • Arbitrum - Layer 2 Ethereum tokens
  • Optimism - Layer 2 Ethereum tokens

How to Configure Token Gating​

To access Token Gating settings:

  1. Use the /settings command in your chat
  2. Navigate to 🌐 Web3 → 🔑 Token Gating
  3. Configure the sections below
Current Settings Display

The main Token Gating screen shows your current configuration, such as: "Users are required to hold at least 25.5 $wQUIL tokens to be recognized as verified holders."

Token Details​

Set up the required token details for verification.

Contract Address​

Set the contract address of the token required for gating.

When selected, the bot prompts:

📝 Please send the token contract address in this format:
0xYourTokenContractAddress

Steps:

  1. Click 🪙 Contract Address
  2. Paste your token's contract address in the chat
  3. Format: 0x... (Ethereum and EVM chains) or native format (Solana)
  4. Press Enter to confirm

Where to find contract address:

  • Token's official website
  • CoinGecko or CoinMarketCap
  • Blockchain explorer (Etherscan, Solscan, etc.)
  • DEX listing page (Uniswap, PancakeSwap, etc.)
Verify Contract Address

Always verify the contract address from official sources. Using the wrong address could allow unintended access or block legitimate holders.

Example contract addresses:

Ethereum: 0x8143182a775c54578c8b7b3ef77982498866945d
Solana: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Blockchain​

Specify the blockchain where the token contract is deployed.

Steps:

  1. Click 🌐 Blockchain
  2. Select from the supported blockchains:
    • ✅ Ethereum
    • Solana
    • Polygon
    • Binance Smart Chain
    • Avalanche
    • Arbitrum
    • Optimism
  3. The selected blockchain will be marked with ✅
Chain Selection

Choose the blockchain where your token is natively deployed. For multi-chain tokens, set up separate Token Gating configurations for each chain.

Set Token​

After configuring both Contract Address and Blockchain, your token will be set.

Current display shows:

Set Token: $wQUIL

This confirms your token configuration is active and ready for verification.

Required Amount​

Set the minimum number of tokens a user must hold to be verified.

Current display shows:

📊 Current Required Amount: 25.5

Steps:

  1. Click 📊 Required Amount
  2. Click ✏️ Edit
  3. The bot will prompt: 
    📝 Please send the required token amount (e.g., 0.0001).
  4. Enter the desired amount (e.g., 10, 100, 0.5)
  5. Press Enter to confirm

Considerations:

  • Too Low: May not provide enough exclusivity
  • Too High: May exclude legitimate community members
  • Decimal Precision: Supports fractional amounts (e.g., 25.5, 0.0001)
  • Token Value: Consider current token price when setting amount
Setting the Right Amount

Balance exclusivity with accessibility. Start with a reasonable amount that rewards holders without excluding smaller supporters. You can always adjust later!

Examples by token value:

  • High-value token ($100+): 1-10 tokens
  • Medium-value token ($1-$100): 10-1,000 tokens
  • Low-value token ($0.01-$1): 1,000-100,000 tokens
  • Micro-value token (<$0.01): 100,000+ tokens

Command​

Define the command to verify user token holdings.

Current display shows:

Current Command: /hodler

Steps:

  1. Click 📜 Command
  2. Click ✏️ Edit
  3. The bot will prompt: 
    📝 Please send the new command (e.g., /verify).
  4. Enter your desired command (e.g., /holder, /verify, /check)
  5. Press Enter to confirm

Default command: /holder

Command Usage

Members will type this command in the chat to initiate the token holder verification process. Make it easy to remember and type!

Recommended commands:

  • /holder - Clear and standard
  • /verify - Simple and direct
  • /hodler - Fun crypto culture reference
  • /check - Short and easy
  • /access - Descriptive of purpose
Command Conflicts

Ensure your chosen command doesn't conflict with other bot commands or Telegram's built-in commands. Test before announcing to your community.

Holder Perks​

Configure the special perks or roles granted to token holders.

Available perks:

  • 🎭 Assign Role: Assign a specific role to users who meet the token requirements
  • ✨ Award XP: Award XP to token holders as an additional incentive
  • 🔓 Grant Group Access: Grant group access to users who meet the token criteria

You can enable multiple perks simultaneously to create a comprehensive holder rewards program.

Assign Role​

Grant a role to verified holders, which can be configured to offer extra permissions in the Roles section.

Current display:

🎭 Assign Role: Not set.

Steps:

  1. Click 🎭 Assign Role
  2. Configure or select a role from your existing roles
  3. Verified holders will automatically receive this role
  4. Customize role permissions in 🏆 Gamification → 🎭 Roles

Role benefits:

  • Visual distinction in chat (role tag/badge)
  • Custom permissions (if configured in Roles settings)
  • Recognition as verified token holder
  • Access to role-specific features
Role Strategy

Create a dedicated "Token Holder" or "[TokenName] Holder" role that clearly identifies verified members. Combine with custom permissions for maximum benefit.

Award XP​

Specify an XP reward that verified holders will receive upon verification.

Current display:

✨ Award XP: 123

Steps:

  1. Click ✨ Award XP
  2. Edit the XP amount
  3. Enter the XP value (e.g., 50, 100, 500)
  4. Verified holders will receive this XP immediately upon verification

XP Amount Considerations:

  • Small Amount (10-50 XP): Minor bonus, symbolic recognition
  • Medium Amount (50-200 XP): Meaningful reward, noticeable leaderboard impact
  • Large Amount (200-1000 XP): Significant reward, major incentive
  • Very Large Amount (1000+ XP): Premium reward for high token requirements
One-Time Reward

XP is awarded once upon successful verification. If a user loses tokens and then reacquires them, they may need to verify again depending on your configuration.

Strategic XP amounts:

Token Requirement: 100 tokens → Award: 50 XP
Token Requirement: 1,000 tokens → Award: 200 XP
Token Requirement: 10,000 tokens → Award: 1,000 XP

Grant Group Access​

Allow verified holders access to a private group or channel.

Steps:

  1. Click 🔓 Grant Group Access
  2. The bot will prompt: 
    📝 Please provide me with the group ID that holders should gain access to.
  3. Get the group ID by typing !id in the target group
  4. Paste the group ID in the chat
  5. Press Enter to confirm

Requirements:

  • Bot must be admin in the target group
  • Bot needs "Invite Users" permission
  • Target group should be private (invite-only)

How it works:

  1. User completes token verification
  2. Bot generates a custom one-time invite link
  3. User receives the invite link (usually in private chat)
  4. User clicks link to join the exclusive group
  5. Access remains as long as they meet token requirements (depending on configuration)
Group Permissions

Ensure the bot has admin permissions in the target group with "Invite Users" enabled. Without proper permissions, invite links cannot be generated.

To get Group ID:

  1. Add Fren One bot to the target group
  2. Give bot admin permissions
  3. Type !id in the group chat
  4. Bot will reply with the group ID
  5. Copy the group ID and paste it in Token Gating settings

Example Group ID formats:

-100123456789 (Supergroup)
-123456789 (Regular group)
Exclusive Group Benefits

Create a dedicated holder-only group for:

  • Exclusive alpha and information
  • Direct access to team members
  • Holder-only events and giveaways
  • Price discussions and strategy
  • Community-driven governance

Configuration Example​

Here's a complete Token Gating configuration example:

Token Details:

  • Contract Address: 0x8143182a775c54578c8b7b3ef77982498866945d
  • Blockchain: Ethereum ✅
  • Set Token: $wQUIL

Requirements:

  • Required Amount: 25.5 tokens
  • Command: /hodler

Holder Perks:

  • Assign Role: "wQUIL Holder" ✅
  • Award XP: 123 XP ✅
  • Grant Group Access: Exclusive holders group ✅

Result: Users who hold at least 25.5 $wQUIL tokens can type /hodler to verify. Upon verification, they receive the "wQUIL Holder" role, 123 XP, and access to the exclusive holders group.

Common Use Cases​

Basic Token Holder Verification​

Scenario: Simple verification with role assignment.

Configuration:

  • Required Amount: 100 tokens
  • Command: /holder
  • Perks: Assign Role only
  • Result: Verified holders get special role and recognition

Premium Holder Program​

Scenario: High-requirement exclusive access.

Configuration:

  • Required Amount: 10,000 tokens
  • Command: /vip
  • Perks: Premium role + 500 XP + private group access
  • Result: Major holders get VIP treatment with exclusive group

Tiered Holder System​

Scenario: Multiple verification levels.

Configuration:

  • Tier 1: 100 tokens → Basic role + 50 XP
  • Tier 2: 1,000 tokens → Silver role + 200 XP
  • Tier 3: 10,000 tokens → Gold role + 1,000 XP + group access
  • Result: Graduated benefits incentivize larger holdings

Multi-Chain Verification​

Scenario: Token exists on multiple chains.

Configuration:

  • ETH Chain: Same token on Ethereum
  • BSC Chain: Same token on Binance Smart Chain
  • Different roles per chain: "ETH Holder" vs "BSC Holder"
  • Result: Holders can verify on their preferred chain

Best Practices​

Effective Token Gating
  • Test First: Verify the complete process works before announcing
  • Clear Communication: Pin a message explaining how to verify
  • Reasonable Requirements: Set achievable token amounts
  • Valuable Perks: Make verification worth the effort
  • Multiple Benefits: Combine role, XP, and group access
  • Support Members: Help users who encounter verification issues
  • Regular Review: Adjust requirements based on token price changes
  • Secure Setup: Double-check contract address and blockchain selection
  • Document Process: Create a verification guide (see Token Gating Guide)
  • Monitor Verifications: Check that perks are being granted correctly
Common Mistakes
  • Wrong Contract Address: Always verify from official sources
  • Wrong Blockchain: Ensure chain selection matches token deployment
  • Insufficient Bot Permissions: Bot needs admin rights for roles and groups
  • Amount Too High: Price volatility may make requirements unreasonable
  • Complex Command: Keep verification command simple and memorable
  • Missing Group Permissions: Bot must be admin in target group with invite permissions
  • No Member Support: Users will have questions - be ready to help

Troubleshooting​

Verification not working?

  • Check contract address is correct
  • Verify blockchain selection matches token
  • Ensure user has sufficient token balance
  • Confirm user completed verification transaction
  • Check bot has necessary permissions

Role not being assigned?

  • Verify bot is admin in the group
  • Check bot has "Manage Users" permission
  • Ensure role exists and is configured
  • Test with a different user

XP not being awarded?

  • Confirm XP feature is enabled in Gamification
  • Check XP amount is set correctly
  • Verify user completed verification successfully
  • Review XP logs if available

Group access not granted?

  • Verify bot is admin in target group
  • Check bot has "Invite Users" permission
  • Ensure correct group ID is configured
  • Test with !id command in target group
  • Verify target group is private (not public)

Wrong token being verified?

  • Double-check contract address
  • Verify blockchain selection
  • Ensure token symbol matches intended token
  • Test verification yourself first

Integration with Other Features​

Token Gating + Roles​

Combine with the Roles system for maximum impact:

  • Create dedicated token holder roles
  • Configure special permissions for holders
  • Visual distinction in chat
  • Role-based features and commands

Token Gating + XP System​

Integrate with XP and Leveling:

  • Award XP for verification
  • Bonus XP for higher holdings
  • Leaderboard recognition
  • Level-based additional perks

Token Gating + Crypto Price Feed​

Keep holders informed with Price Tracking:

  • Post price updates in holder group
  • Set alerts for price milestones
  • Price-based community engagement
  • Celebrate price achievements

Token Gating + Welcome Message​

Combine with Welcome Messages:

  • Welcome new verified holders
  • Custom greeting for token holders
  • Verification instructions in welcome
  • Encourage immediate verification

User Verification Process​

For detailed user instructions, see the Token Gating: Guide for Users.

Quick overview of user experience:

  1. User types verification command (e.g., /holder) in chat
  2. Bot responds and asks for wallet address (in private chat)
  3. User provides their wallet address
  4. Bot requests a small verification transaction
  5. User sends tokens to themselves (from their wallet to their wallet)
  6. Bot monitors blockchain for the transaction
  7. Verification confirms, perks are granted automatically
  8. User receives role, XP, and/or group invite link
Security

Verification never requires private keys or seed phrases. Users only send a small amount of tokens to themselves, proving wallet ownership without security risks.

Exclusive Community Access

Token Gating is perfect for creating exclusive experiences for your token holders. Combine roles, XP, and private group access for a comprehensive holder rewards program!