Syncing & Automation

Syncing re-checks on-chain holdings for users who have already verified a wallet in this server and updates their Discord roles accordingly. It does not affect users who have never verified.

What Sync Does

When you run Sync Roles in your server, the system:

  • Re-fetches current FT and NFT balances for previously verified users

  • Compares holdings against current role rules

  • Adds roles users newly qualify for

  • Removes roles users no longer qualify for

  • Updates the server’s role assignments to match on-chain reality

What Sync Does Not Do

Syncing does NOT:

  • ❌ Verify new users

  • ❌ Ask users to reconnect wallets

  • ❌ Assign roles to users who never verified

  • ❌ Run continuously or in real time

When You Should Run Sync

Run Sync Roles when:

  • Users token balances have changed significantly

  • You update role thresholds

  • You add or remove role mappings

  • You want to ensure roles reflect the current on-chain state

How to Run Sync

  1. Run /roles

  2. Select Sync Roles

  3. Wait for the confirmation message

circle-info

⏱️ Sync can be triggered once every 72 hours per server

⚠️ Sync affects ALL previously verified users in the server. Changes are applied automatically and cannot be undone.

Last updated