Skip to main content

🙋‍♂️ Token Gating: Guide for Users

If your community uses token gating, you can prove you hold its token and receive rewards such as a holder role, bonus XP, or an invite to a private group.

For admins

This page is for members verifying their tokens, and the steps start in the group chat. To set up token gating for your community, see Token Gating.

What you need​

  • At least the required amount of the community's token, in a wallet you control (not on an exchange)
  • A wallet app for the token's chain, such as MetaMask or Trust Wallet
  • For the transfer method, a little of the chain's native token for gas

Verifying​

  1. Send /holder in the group. The agent asks you to send your wallet address in a private chat with it.
  2. Send your wallet address in that private chat, in the format 0xYourWalletAddress.
  3. The agent checks your balance. If it's below the requirement, it tells you how much you currently hold, and you stop here.
  4. Prove you own the wallet, using the method your community chose:
    • Transfer: send exactly the amount the agent shows, of the same token, from your wallet to your own address. The agent watches the chain for that transaction for 5 minutes. The transfer needs a network gas fee.
    • Signature: sign the message the agent sends you, using your wallet app's "Sign message" (personal_sign) option, and paste the signature into the chat within 10 minutes. This is an off-chain signature, not a transaction.
  5. Receive your rewards. Once ownership is confirmed, the agent gives you whatever your community set up: a holder role, bonus XP, and an invite link to a private group. A group invite link is valid for 10 minutes, so use it straight away.

Verification happens once. Fren One doesn't re-check your balance later.

What Fren One never asks for

Verification only needs your public wallet address and either a transfer to your own address or a signed message. Never share your private key, seed phrase or wallet password with anyone, and never send tokens to someone else's address to "verify".

Troubleshooting​

"You must hold at least … tokens"

  • The wallet you sent holds less than the requirement. Check you sent the right wallet address, and that the tokens aren't on an exchange.

The transfer wasn't detected

  • Send the exact amount shown, of the right token, to the same address you gave the agent, within 5 minutes. If the time ran out, send /holder again.
  • Make sure you have enough of the chain's native token to pay gas.

"Signature verification failed"

  • Sign the exact message the agent sent, with the same wallet address you gave it, then try again.

"This wallet address is already associated with another member"

  • Each wallet can be verified by one member only. Use your own wallet.

"You are already a verified holder"

  • You've already verified in this group, so there's nothing more to do.

"Incomplete configuration" or no reply to /holder

  • Token gating isn't fully set up or is switched off in this group. Ask an admin. After each attempt there's a short cooldown of a few seconds.

On this page