Skip to main content

Token-Gate Communities

What is Token-Gating?

Collab.Land's bot functionality is built around the concept of Token-Gating. This refers to the ability to create roles on social platforms such as Discord and Telegram, that are only accessible to users who meet certain token-related criteria.

At the heart of this concept are Token Gating Rules (TGRs). These are the rules that determine which roles a user will be assigned based on the token-related criteria defined by the community admin. For example, a TGR may grant access to a "VIP" role for users who hold a certain number of tokens.

What types of TGRs are there?

When creating TGRs, there are two types to choose from: Balance-based & Attributes-based.

Balance-based

Balance-based TGRs check the quantity of a specific token in the user's wallet. If the user holds more tokens than the lower limit and less than the upper limit (upper limit is optional), then the role is granted. This allows for the creation of roles based on the amount of a specific token that a user holds.

info

This TGR type is commonly used by groups built on fungible tokens, such as ERC20.

Attributes-based

Attributes-based TGRs check for the existence of individual tokens that possess one or more "traits" as part of their metadata, specified by the admin. This type of TGR is used to create roles based on NFT ownership.

For example, if an admin wants to create a role for BAYC members who own an ape NFT with specific metadata traits (blue fur), they can use an Attributes-based TGR to check for an ape with blue fur in the member's wallet.

info

Attributes-based TGRs are only used for tokens that contain metadata -- NFTs such as ERC721 and ERC1155 tokens.

Supported Blockchains & Tokens

This blockchain list is intended for community admins. It shows which Token Types can be used with which blockchains.

Community members should reference the list of supported wallets to know which wallets can be used with which blockchain.

Chain TypeToken Type
EVM chains------------------
MainnetERC20, ERC721, ERC1155, ROLL, POAP, Staking Contracts, Gnosis Safe, Moloch, Opensea
GoerliERC20, ERC721, ERC1155, Gnosis Safe, Otterspace Badge
PolygonERC20, ERC721, ERC1155, Super Token, Gnosis Safe
Mumbai (Testnet)ERC20, ERC721, ERC1155
MoonbeamERC20, ERC721, ERC1155
BSCBEP20, BEP721, BEP1155, Gnosis Safe, Super Token
GnosisERC20, ERC721, ERC1155, Super Token, ROLL, POAP, Gnosis Safe, Moloch, Opensea
RoninERC20, ERC721, ERC1155
Arbitrum OneERC20, ERC721, ERC1155, Super Token, Gnosis Safe
Arbitrum NovaERC20, ERC721, ERC1155
AvalancheERC20, ERC721, ERC1155, Super Token, Gnosis Safe
OptimismERC20, ERC721, ERC1155, Super Token, Gnosis Safe, Otterspace Badge
PalmERC20, ERC721, ERC1155
Q ChainERC20, ERC721, ERC1155
Non-EVM Chains------------------
SolanaSolana FT, Solana NFT
EluvioERC721
FlowFLOW FT, FLOW NFT
KusamaRMRK
NiftyNIFTY
PolkadotERC20
TezosTezos FA1.2, Tezos FA2
Immutable XImmutable X
LoopringLoopring FT, Loopring NFT
XRPLXRPL FT, XRPL NFT
tip

If your blockchain or wallet project is not supported, you may request an integration, or contact us directly by email at integrations@collab.land.