Skip to main content

🌐 Web3 Tools

Set up Web3 features for blockchain-based interactions. Fren One's Web3 Tools bring blockchain functionality to your Telegram community, enabling token-gated access, crypto price tracking, and exclusive perks for token holders.

Features Overview​

🔑 Token Gating​

Provide exclusive perks to verified token holders. Verify crypto token ownership on multiple blockchain networks and grant special access, roles, or XP points to token holders.

🙋‍♂️ Token Gating: Guide for Users​

Step-by-step instructions for community members on how to verify their token ownership and gain access to holder perks.

📈 Crypto Price Feed​

Create custom price feeds for selected tokens. Track token prices, set alerts for specific price levels, and keep your community informed with automated price updates.

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
Multi-Chain Support

Token Gating works seamlessly across all major blockchain networks, allowing you to verify holdings on the chain where your token is deployed.

Web3 Integration Benefits​

For Community Managers​

  • Automated Verification: No manual checking of wallet addresses
  • Exclusive Access Control: Create token-holder only spaces
  • Multi-chain Support: Works with various blockchain networks
  • Flexible Perks: Roles, XP, and private group access
  • Real-time Price Data: Keep members informed about token prices

For Token Holders​

  • Exclusive Perks: Access special roles and features
  • Private Groups: Join exclusive token-holder communities
  • XP Rewards: Earn additional XP for holding tokens
  • Recognition: Stand out as a verified token holder
  • Price Alerts: Stay informed about your token's price

Getting Started with Web3​

To set up Web3 features:

  1. Use the /settings command in your chat
  2. Navigate to the 🌐 Web3 section
  3. Choose 🔑 Token Gating or 📈 Crypto Price Feed
  4. Configure your token requirements or price feeds
  5. Test the integration with your community

Token Gating Quick Setup​

For token-gated communities:

  1. Set Token Details: Configure contract address and blockchain
  2. Set Minimum Holdings: Define how many tokens users need (Required Amount)
  3. Configure Verification Command: Set the command members will use (default: /holder)
  4. Configure Holder Perks: Choose perks (roles, XP, group access)
  5. Guide Your Members: Share the verification process with your community
Quick Start

The fastest way to get started: Set your token's contract address, choose the blockchain, set a required amount (e.g., 10 tokens), and configure at least one holder perk. Members can then use /holder to verify!

Crypto Price Feed Quick Setup​

For price tracking:

  1. Add Token: Enter the token symbol (e.g., btc, eth)
  2. Set Price Message: Customize the price update format with {token_symbol} and {price} placeholders
  3. Choose Mode: On-command (members type /price) or interval (automatic updates)
  4. Optional Alerts: Set price alerts for specific thresholds
  5. Test: Request a price update to see your configuration
Price Data Source

Crypto price data is sourced from reliable market data providers and updated in real-time.

Common Use Cases​

Token-Gated Community​

Scenario: Create a community exclusively for your token holders.

Setup:

  • Set Required Amount to minimum holding (e.g., 100 tokens)
  • Enable "Grant Group Access" to a private Telegram group
  • Add "Assign Role" to identify verified holders
  • Set verification command to /holder

Result: Only verified token holders can access the private community and get special roles.

Tiered Access Levels​

Scenario: Different perks for different holding amounts.

Setup:

  • Create multiple token gating configurations
  • Small holders: 100 tokens = basic role + 50 XP
  • Medium holders: 1,000 tokens = premium role + 200 XP
  • Large holders: 10,000 tokens = VIP role + 1,000 XP + private group access

Result: Graduated perks incentivize larger holdings and reward community commitment.

Price Tracking for Project Token​

Scenario: Keep community informed about your project token's price.

Setup:

  • Add your token symbol to Crypto Price Feed
  • Set price message with custom branding and {price} placeholder
  • Configure interval mode for automatic updates every 1 hour
  • Set alert for significant price movements

Result: Community stays informed without checking external price sources.

Multiple Token Requirements​

Scenario: Verify holders across multiple related tokens.

Setup:

  • Configure Token Gating for Token A (main project token)
  • Configure separate Token Gating for Token B (partner token)
  • Different perks for each token
  • Members can verify multiple tokens for cumulative benefits

Result: Flexible verification across your token ecosystem.

Best Practices​

Effective Web3 Integration
  • Clear Instructions: Pin a message explaining the verification process
  • Reasonable Requirements: Don't set token amounts too high
  • Valuable Perks: Make holder benefits worth the verification effort
  • Regular Updates: Keep price feeds and alerts current
  • Test Thoroughly: Verify the process works before announcing
  • Support Your Members: Help users who encounter issues
  • Security Education: Remind users to never share private keys
  • Use Official Commands: Document the exact verification command
  • Multiple Perks: Combine roles, XP, and group access for maximum value
  • Price Transparency: Keep holders informed with price feeds
Security Considerations
  • Never Ask for Private Keys: Verification never requires seed phrases or private keys
  • Outgoing Transaction Only: Users send tokens to themselves (from their wallet to their wallet)
  • Small Amount: The verification transaction amount should be minimal
  • Educate About Scams: Warn members about fake verification requests
  • Admin Verification: Only official bot verification should be trusted
  • No Payment to Admins: Admins never request tokens be sent to them
  • Secure Bot Permissions: Ensure bot has appropriate permissions in verification groups

Troubleshooting​

Token Gating Issues​

Verification not working?

  • Verify the contract address is correct
  • Ensure the correct blockchain is selected
  • Check that the user has sufficient token balance
  • Confirm the verification transaction was completed
  • Verify bot has admin permissions for role assignment

Users can't find the verification command?

  • Check the command is set correctly (default: /holder)
  • Ensure the command is communicated to members
  • Pin a message with verification instructions
  • Test the command yourself first

Group access not granted?

  • Verify bot has admin permissions in the target group
  • Ensure the correct group ID is configured
  • Check that the user completed verification successfully
  • Test with a known good wallet first

Crypto Price Feed Issues​

Token not found?

  • Try removing "w" prefix from wrapped tokens (use btc not wbtc)
  • Use common token symbols (eth, btc, sol)
  • Check the token is listed on major exchanges
  • Try alternative symbol names

Price updates not posting?

  • Verify the mode is set correctly (command vs. interval)
  • Check bot has permission to post in the channel/group
  • Ensure the price message template is valid
  • Test with the command manually first

Alerts not triggering?

  • Verify the alert threshold is set correctly
  • Check that the price has actually crossed the threshold
  • Ensure bot has posting permissions
  • Review alert configuration

Advanced Strategies​

Holder Incentive Program​

Create a comprehensive program for token holders:

Setup:

  1. Token Gating with graduated perks
  2. Exclusive holder-only group
  3. Special roles with custom permissions
  4. Bonus XP for verification
  5. Price feed in holder group
  6. Regular holder-exclusive events

Price-Based Moderation​

Use price alerts to adjust community behavior:

Setup:

  1. Price feed tracks your token
  2. Alert set for price milestones
  3. Scheduled messages celebrate price achievements
  4. Holder perks increase at certain price levels
  5. Community engagement during price movement

Multi-Chain Token Verification​

For projects with tokens on multiple chains:

Setup:

  1. Separate Token Gating for each chain
  2. Different roles per chain (e.g., ETH-Holder, BSC-Holder)
  3. Cumulative XP across all chains
  4. Cross-chain holder benefits
  5. Price feeds for wrapped versions

Understanding Token Verification​

How Verification Works​

  1. User Initiates: Types /holder (or custom command) in chat
  2. Bot Responds: Asks for wallet address in private chat
  3. User Provides Address: Sends their wallet address to bot
  4. Bot Requests Transaction: Asks user to send small amount of token to themselves
  5. User Completes Transaction: Sends tokens from their wallet to their own wallet
  6. Bot Monitors Blockchain: Watches for the outgoing transaction
  7. Verification Complete: Bot confirms token ownership
  8. Perks Granted: User receives configured perks (roles, XP, group access)

Why Outgoing Transaction?​

Fren One uses outgoing transaction verification (sending tokens to yourself) because:

  • Proves Wallet Control: Only the wallet owner can send transactions
  • Doesn't Require Private Keys: No need to sign messages or share sensitive data
  • Works Across All Chains: Universal verification method
  • Tamper-Proof: Can't be faked or manipulated
  • Real-Time: Blockchain confirmation provides instant verification
Transaction Cost

Users pay only network gas fees (very small amount). The tokens go from their wallet back to their wallet - no tokens are lost in verification!

  • 👋 Onboarding - Integrate token verification with welcome processes
  • 🏆 Gamification - Reward token holders with special roles and XP
  • 🎮 Roles - Configure special permissions for token holders
  • ⭐ XP - Award XP points to verified token holders
Web3 Made Easy

Fren One makes Web3 integration simple for both admins and community members. Token verification works across all major blockchains without requiring technical knowledge from your users!