Lunar Assistant Guide
Search…
Getting Started
Welcome!
Admin Guide
Discord Bot Setup Quick Start
User Guide
User Guide Quick Start
Reference
Command Reference
Architecture
FAQ
About
Lunar Assistant
Powered By GitBook
Architecture
More info on the architecture powering Lunar Assistant.

Lunar Assistant Discord Bot Command Handler

The Lunar Assistant Discord Bot is run on a digital ocean droplet.

Lunar Assistant Wallet Holdings Tracker

There are a few processes involved with keeping discord user roles in sync with their wallet addresses.

Watching All Transactions

The Lunar Assistant watches all transactions and filters for those involving NFT transfers. Whenever an NFT transfer takes place, the Lunar Assistant checks whether or not any of the involved wallets are connected to a Discord account. If so, then the given user's Discord roles are updated with respect to their new wallet holdings. This allows for almost realtime role updates.

Cron Job

A cron job runs once a day which syncs every registered Discord user's roles with their wallet holdings. The point of this is to handle edge cases where transactions are missed in the "Watching All Transactions" approach.
// read all users from firestore
// read all serverConfigs from firestore
// for each user in users (in memory)
// for each serverConfig in serverConfigs (in memory)
// check if the user is in the server (in memory), if so:
// for each rule in serverConfig (in memory)
// query the user tokens relevant to the rule (cache if possible)
// update user's discord roles according to rule
// save the user's discord roles to firestore

On User Wallet Address Update

Each time a user updates their linked wallet address, that user's Discord roles are synced with their new wallet holdings.
​
Previous
User Commands
Next - Reference
FAQ
Last modified 11mo ago
Copy link
On this page
Lunar Assistant Discord Bot Command Handler
Lunar Assistant Wallet Holdings Tracker
Watching All Transactions
Cron Job
On User Wallet Address Update