Skip to main content

Token-Gated Communities

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.

What is Token-Gating?

At the heart of Token Gating are Token Gating Rules (TGRs). These are the rules that determine which roles a member 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 members who hold a certain number of tokens.

info

Collab.Land's balance check feature means that members who no longer hold a community's tokens will lose their roles in that community automatically.

What types of TGRs are there?

When creating TGRs, there are two types to choose from: Balance-based and Attributes-based. Learn how to create a TGR.

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.

tip

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 ownership of specific kinds of NFTs from a collection.

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.

info

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

Learn how to create a TGR.

Chain TypeToken Type
EVM chains------------------
Ethereum MainnetERC20, ERC721, ERC1155, ROLL, POAP, Staking Contracts, Gnosis Safe, Moloch, Opensea
GnosisERC20, ERC721, ERC1155, Super Token, ROLL, POAP, Gnosis Safe, Moloch, Opensea
OptimismERC20, ERC721, ERC1155, Super Token, Gnosis Safe, Otterspace Badge
BASEERC20, ERC721, ERC1155
PolygonERC20, ERC721, ERC1155, Staking Contracts, Super Token, Gnosis Safe
RoninERC20, ERC721, ERC1155
Arbitrum OneERC20, ERC721, ERC1155, Super Token, Gnosis Safe
Arbitrum NovaERC20, ERC721, ERC1155
LineaERC20, ERC721, ERC1155
BlastERC20, ERC721, ERC1155, Staking Contracts
CeloERC20, ERC721, ERC1155
BSCBEP20, BEP721, BEP1155, Gnosis Safe, Super Token
MoonbeamERC20, ERC721, ERC1155
AvalancheERC20, ERC721, ERC1155, Super Token, Gnosis Safe
PalmERC20, ERC721, ERC1155
Q ChainERC20, ERC721, ERC1155
DOS ChainERC20, ERC721, ERC1155
AstarERC20, ERC721, ERC1155
ShibariumERC20, ERC721, ERC1155
SEIERC20, ERC721, ERC1155
Sepolia (Ethereum testnet)ERC20, ERC721, ERC1155
Amoy (Polygon testnet)ERC20, ERC721, ERC1155
Non-EVM Chains------------------
SolanaSolana FT, Solana NFT
NEARNEAR FT, NEAR 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
Bitcoin NFTsBitcoin Stamps, Bitcoin Ordinals
Gitcoin Passport------------------
Friend.Tech------------------
tip

If your blockchain or wallet project is not supported, you may request an integration, or contact us directly by email at [email protected].