Admin Setup
To begin using VeriX in your Telegram community, follow these steps:
Add VeriX Bot to Your Telegram Group
Invite the Bot:
For Testnet, add
@verixstagbot
.For Mainnet, add
@utxo_global_verix_bot
.
Promote to Admin: Go to your Telegram group settings, choose the βAdministratorsβ tab, and grant VeriX the ability to remove members who fail verification.
Important Note: It may take up to 10 minutes for VeriXβs features to fully activate after promotion.
Supported Gating Types (via
/settoken
)
All on-chain gating - whether native CKB, an xUDT token, or an NFTβuses the same
/settoken
command. VeriX will automatically detect if the providedtype_hash
corresponds to an xUDT or an NFT contract./settoken ckb β Gate by native CKB balance. /settoken <type_hash> β Gate by whichever asset that type_hash represents: β’ xUDT (user-defined token) β’ NFT (e.g. Spore Protocol collection)
CKB:
/settoken ckb
xUDT or NFT:
/settoken 0xab12β¦34
(bot introspects on-chain to know if itβs a token or an NFT)Combine with
/setamount
to set:a minimum balance (for CKB/xUDT), or
a minimum count (for NFTs).
Configure the Bot via Commands
/help
Lists all available commands.
/groupconfig
View current settings (min age, token type, required balance).
/listusers
List currently verified users and their status.
/setage <years>
Set minimum age requirement.
e.g. /setage 21
/settoken <type_hash|ckb>
Choose gating token:
β’ "ckb" β native CKB
β’ Any valid xUDT/NFT type_hash β specific xUDT or NFT
e.g. /settoken ckb
/settoken 0xab12β¦34
/setamount <number>
Set minimum balance required of the active token (CKB, xUDT, or NFT count).
e.g. /setamount 100
(100 CKB, or 100 xUDT, or 1 for an NFT if you require at least 1)
How to Find a Tokenβs
type_hash
Open the Appropriate Explorer
Mainnet: https://explorer.nervos.org/
Testnet: https://testnet.explorer.nervos.org/
Navigate to the Asset List
In the top menu, click Coins β xUDT for tokens, or NFT Collections for NFTs.
Search for Your Asset
Type the token/NFT name or paste its contract address into the search bar.
Copy the Type Hash
On the assetβs detail page, the URL contains the
type_hash
.Example β xUDT (Mainnet)
https://explorer.nervos.org/xudt/0x178fb47b597a56d48b549226aff59f750b4784250c7f40f781b64ef090a8a0a7 β type_hash = 0x178fb47b597a56d48b549226aff59f750b4784250c7f40f781b64ef090a8a0a7
Example β NFT Collection (Testnet)
https://testnet.explorer.nervos.org/nft-collections/0x7401053f5cf6857c32ecffb63d89cb8cbce7305877617680f605a66288783ae8?tab=transfers β type_hash = 0x7401053f5cf6857c32ecffb63d89cb8cbce7305877617680f605a66288783ae8
Best Practices
Verify Admin Permissions: Ensure VeriX retains Ban Users rights.
Start Small: Test in a staging group before going live.
Monitor Logs: Run
/groupconfig
after any change.Combine Checks: For both age and token gating, set both
/setage
,/settoken
, and/setamount
appropriately.
Last updated