OpenDomains Discord Bot

OpenDomains Discord interface built with discord.js.

Prerequisites

• Node.js 18.17+ and npm.
• A Discord application with a bot token.

Setup

1. Copy .env.example to .env and fill in DISCORD_TOKEN, CLIENT_ID, and optionally GUILD_ID for guild-scoped development commands.
2. Install dependencies:

   npm install

3. Register slash commands (guild registration is faster for iteration):

   npm run register

4. Run the bot:

   npm start

Available commands

• /ping – health check for the bot.
• /about – quick context on the OpenDomains bot.
• /login – start device-based authentication with OpenDomains and store the session in MongoDB.
• /logout – clear your stored OpenDomains session/API key.
• /domains – list your domains and their statuses.

Login prerequisites

• MongoDB connection string in MONGO_URI (and optional MONGO_DB_NAME override).
• The device auth endpoints default to https://beta.open-domains.net/api with /device-auth and /device-auth/poll. Override with OPEN_DOMAINS_API_BASE, OPEN_DOMAINS_DEVICE_START_PATH, or OPEN_DOMAINS_DEVICE_POLL_PATH if the service uses different paths.
• The domains listing endpoint defaults to /domains. Override with OPEN_DOMAINS_DOMAINS_PATH if needed.
• For offline testing, set OPEN_DOMAINS_MOCK_DEVICE_AUTH=true to return dummy device codes and a mock API key without calling the real service.

Add new commands by creating files in src/commands/ that export command = { data, execute }. Commands are auto-loaded by both the runtime and the registration script.