Difficulty: Expert | Type: Feature / Architecture
Background: The repository's own description states it provides "Discord bot, docs, and ecosystem integrations for GuildPass community access and membership workflows," but the current file tree (app, components, docs, lib, scripts, test, types) contains no Discord bot code — this is a promised-but-unbuilt integration.
Problem: Communities using GuildPass for token-gated access have no way to enforce that gating inside Discord (e.g. auto-assigning/removing Discord roles based on GuildPass membership/role state), which is one of the most common real-world use cases for this kind of platform.
Expected Outcome: A new Discord bot (as a separate package/workspace within this repo, e.g. discord-bot/) that periodically or event-drivenly syncs GuildPass membership/role state to Discord server roles, using the existing guildpass-core outbox webhook mechanism (documented in the companion backend repo) as its ingestion source where possible.
Suggested Implementation: Scaffold a new bot package using discord.js, implement a slash command for members to link their Discord account to a wallet (via a SIWE-style verification flow reusing this repo's existing auth patterns), consume guildpass-core's outbox webhook events (ROLE_ASSIGNED, MEMBERSHIP_UPDATED, etc.) to drive Discord role sync, and add setup documentation to docs/.
Acceptance Criteria:
- New bot package can link a Discord account to a verified wallet via a secure flow.
- Role/membership changes on the backend correctly propagate to Discord role assignment/removal within a reasonable delay.
- Setup and self-hosting documentation is added to
docs/.
- Security review covers the account-linking flow specifically (replay/impersonation risks).
Likely Affected Files/Directories: discord-bot/ (new package), docs/, package.json (workspace config if applicable)
Labels: feature, architecture, integration, GrantFox OSS, Maybe Rewarded, Official Campaign | FWC26
Difficulty: Expert | Type: Feature / Architecture
Background: The repository's own description states it provides "Discord bot, docs, and ecosystem integrations for GuildPass community access and membership workflows," but the current file tree (
app,components,docs,lib,scripts,test,types) contains no Discord bot code — this is a promised-but-unbuilt integration.Problem: Communities using GuildPass for token-gated access have no way to enforce that gating inside Discord (e.g. auto-assigning/removing Discord roles based on GuildPass membership/role state), which is one of the most common real-world use cases for this kind of platform.
Expected Outcome: A new Discord bot (as a separate package/workspace within this repo, e.g.
discord-bot/) that periodically or event-drivenly syncs GuildPass membership/role state to Discord server roles, using the existingguildpass-coreoutbox webhook mechanism (documented in the companion backend repo) as its ingestion source where possible.Suggested Implementation: Scaffold a new bot package using discord.js, implement a slash command for members to link their Discord account to a wallet (via a SIWE-style verification flow reusing this repo's existing auth patterns), consume
guildpass-core's outbox webhook events (ROLE_ASSIGNED,MEMBERSHIP_UPDATED, etc.) to drive Discord role sync, and add setup documentation todocs/.Acceptance Criteria:
docs/.Likely Affected Files/Directories:
discord-bot/(new package),docs/,package.json(workspace config if applicable)Labels:
feature,architecture,integration,GrantFox OSS,Maybe Rewarded,Official Campaign | FWC26