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------------------
ApeChainERC20, ERC721, ERC1155
Arbitrum NovaERC20, ERC721, ERC1155
Arbitrum OneERC20, ERC721, ERC1155, Super Token, Gnosis Safe
AstarERC20, ERC721, ERC1155
AvalancheERC20, ERC721, ERC1155, Super Token, Gnosis Safe
BASEERC20, ERC721, ERC1155
BlastERC20, ERC721, ERC1155, Staking Contracts
BSCBEP20, BEP721, BEP1155, Gnosis Safe, Super Token
CeloERC20, ERC721, ERC1155
DOS ChainERC20, ERC721, ERC1155
Ethereum MainnetERC20, ERC721, ERC1155, ROLL, POAP, Staking Contracts, Gnosis Safe, Moloch, Opensea
GnosisERC20, ERC721, ERC1155, Super Token, ROLL, POAP, Gnosis Safe, Moloch, Opensea
LineaERC20, ERC721, ERC1155
MoonbeamERC20, ERC721, ERC1155
OptimismERC20, ERC721, ERC1155, Super Token, Gnosis Safe, Otterspace Badge
PalmERC20, ERC721, ERC1155
PolygonERC20, ERC721, ERC1155, Staking Contracts, Super Token, Gnosis Safe
Q ChainERC20, ERC721, ERC1155
RoninERC20, ERC721, ERC1155
SEIERC20, ERC721, ERC1155
ShibariumERC20, ERC721, ERC1155
Amoy (Polygon testnet)ERC20, ERC721, ERC1155
ApeChain Curtis (Testnet)ERC20, ERC721, ERC1155
Sepolia (Ethereum testnet)ERC20, ERC721, ERC1155
Non-EVM Chains------------------
Bitcoin NFTsBitcoin Stamps, Bitcoin Ordinals
EluvioERC721
FlowFLOW FT, FLOW NFT
Friend.Tech------------------
Gitcoin Passport------------------
Immutable XImmutable X
KusamaRMRK
LoopringLoopring FT, Loopring NFT
NEARNEAR FT, NEAR NFT
NiftyNIFTY
PolkadotERC20
SolanaSolana FT, Solana NFT
TezosTezos FA1.2, Tezos FA2
XRPLXRPL FT, XRPL NFT
caution

Please note that blockchain testnets are for testing purposes only. Collab.Land reserves the right to suspend support for testnets at any time.

tip

If you are interested in a new Blockchain or Wallet Integration, please let us know by filling out this form.