Pioneer Discord and Telegram token-gating bot and community marketplace. Token Gating Rules (TGRs) assign roles based on token balances and attributes across 38+ chains.
- 01Discord token-gated roles
- 02Telegram group token-gating
- 03balance + trait-based access rules
- 04community marketplace miniapps
- 05automated role sync on transfers
| Variable | Scope | Description |
|---|---|---|
| COLLABLAND_API_KEY | Server | Collab.Land API key for partner/marketplace integrations. |
| COLLABLAND_BOT_TOKEN | Server | Bot install token / OAuth secret for Discord/Telegram integrations. |
Use Collab.Land to gate Discord and Telegram. Invite the bot, configure TGRs in the Command Center (`/setup` slash command in Discord), and define rules as either Balance-based (`token X >= N on chain Y`) or Attributes-based (NFT trait filters). For programmatic flows, the partner API at `https://api.collab.land/v1` accepts `X-API-KEY: $COLLABLAND_API_KEY` — endpoints include `GET /accounts/{discordId}/wallets` and `POST /tgrs` for rule provisioning. To build a Marketplace Miniapp, scaffold via `npx @collabland/create-miniapp` and deploy as a serverless action handler.
- ⚑Multi-wallet support exists but TGR evaluation runs across linked wallets; users with disconnected wallets may lose roles unexpectedly.
- ⚑Role sync is on a polling cooldown (minutes); transfers don't immediately revoke roles — design for eventual consistency.
- ⚑Free tier caps community size and TGR count; large servers (10k+ members) require a paid plan.
- ⚑Discord bot permissions must include Manage Roles above the gated role in the role hierarchy or sync silently no-ops.
- ⚑Telegram gating works via a separate join-flow link; users joining by direct invite bypass the verification — disable direct invites or set the group to private.
- ⚑Sanctioned-region or banned-wallet enforcement is opt-in via Chainalysis/TRM miniapps in the marketplace, not on by default.