Discord Bot
A self-hosted Discord bot (v1.0) that reads members' Andamio credentials and gates Discord roles on them. Fork the template and stand up your own instance.
The Andamio Discord bot brings on-chain credentials into a Discord community. A member proves they control an Andamio alias with /login, sees their earned credentials with /credentials, and is automatically granted Discord roles based on what they hold.
At v1.0, the bot is self-hosted: there is no managed service to sign up for. You install it by forking the repo (a GitHub template) and standing up your own instance against your Discord server and an Andamio deployment.
It does what a plain wallet-verification bot cannot: it reads each member's credentials from the authenticated Andamio API and gates Discord roles on them, with no wallet handling by adopters. The bot never touches a wallet, seed phrase, or private key. You need no wallet, no ADA, no Cardano knowledge, and no Andamio CLI or account to deploy.
Full documentation
Andamio Bot is open source (Apache 2.0), and the andamio-bot repo is the source of truth. It ships with task-oriented guides:
- Quickstart — deploy with a list of values you were given (no Andamio account needed).
- Builder guide — wire up your own gating, using the Andamio CLI to find your
course_idandslt_hash. - Concepts — the few terms involved and where each config value comes from.
- Deploy anywhere and troubleshooting.
The rest of this page is a quick orientation.
What it does
Members interact with the bot through slash commands:
| Command | What it does |
|---|---|
/login · /logout | Link or unlink a Discord account to an Andamio alias, via the hosted Andamio login. |
/credentials | Show the member the Andamio credentials they have earned. |
/available | List the credentials this server gates channels on, each marked held or not. |
/check | Re-read credentials live, update roles, and report where the member stands. |
/progress | The member's Andamio progress across courses and per-module status. |
/preview | Preview a course's modules and a lesson or assignment as an embed. |
/faq | A get-started guide plus server-specific Q&A, with autocomplete. |
Moderators with Manage Roles (or a configured MOD_ROLE_ID) also get a deny-list (/deny, /allow, /denials) to withhold a gated role from a specific member even when they hold the credential.
How it works
/loginreuses the Andamio app's hosted login to prove a Discord member controls an alias, then stores thediscord_id-to-alias link plus the member's login token. No wallet logic lives in the bot.- Reads run on the authenticated Andamio API (
POST /api/v2/user/dashboard): an operator key authenticates the bot, and the member's bearer token selects whose dashboard to read. config/role-mappings.jsonmaps earned credentials to Discord roles. The bot grants and revokes only the roles it manages, never a moderator, booster, or other role.- Roles re-evaluate on
/login, on/check, when a member rejoins, and on a periodic sweep. The datastore is file-based SQLite (zero-ops).
Deploy your own
The repo is a GitHub template: use "Use this template" to start your own, or fork it. Follow the Quickstart to deploy with values you were given, or the Builder guide to define what your server gates on. Deploy guidance for any host is in DEPLOY.md.