SinBot User Guide

SinBot gives members Discord roles based on the NFTs they hold on Robinhood Chain, and can run private support tickets with a server's staff and giveaways.

SinBot will never ask for your seed phrase, your private key, a signature or a payment. You never connect your wallet to SinBot. Anyone asking for these is not SinBot — never share them.

Contents

1. For members: verifying your wallet
2. For members: your wallets and roles
3. For members: support tickets
4. For members: giveaways
5. For admins: adding SinBot and getting started
6. For admins: the setup checklist (/setup)
7. For admins: roles and rules (/roles)
8. For admins: role ladders
9. For admins: support tickets
10. For admins and hosts: giveaways (/giveaways)
11. Licences
12. Your data
13. Commands
14. Troubleshooting
15. Getting help

1. For members: verifying your wallet

You prove you own a wallet by putting a short code in your OpenSea profile bio. Nothing is signed and nothing is sent.

1. In the server's verify channel, press Verify and enter your wallet address (it starts with 0x).
2. SinBot shows a code like SIN-1A2B3C4D. It is valid for 30 minutes.
3. Go to opensea.io (type the address yourself — never use links from other people), log in with that wallet, edit your profile, paste the code into your Bio and save.
4. Back in Discord, wait for the 90-second countdown, then press I've updated my profile.
5. If SinBot cannot find the code yet, wait for the 30-second timer and try again.

When it works, your wallet is linked and your roles are given straight away. You can delete the code from your bio afterwards.

Good to know:

• You can make 10 verification attempts per hour.
• One wallet can be linked to one Discord account. Verifying a wallet that is linked elsewhere moves it to you.
• If you have never logged in to OpenSea with that wallet, do that once first.

2. For members: your wallets and roles

• Refresh roles (on the verify panel): re-checks your NFTs now, once a minute. SinBot also re-checks everyone every day, so roles follow your holdings when you buy or sell.
• My wallets (on the verify panel): shows your linked wallets and lets you unlink one. /unlink does the same. Your roles are re-checked straight after.
• If you hold NFTs in several linked wallets, they all count together.

3. For members: support tickets

If the server uses tickets, press Open ticket in its support channel, enter a topic and describe your problem. SinBot creates a private channel that only you and the server's staff can see.

• You can have one open ticket at a time; pressing Open ticket again links you to it.
• Press Close ticket when your problem is solved. The channel is locked, then deleted 24 hours later.
• A ticket with no messages for 6 days gets a warning and closes a day later.
• SinBot does not read or store the messages in tickets.
• Staff will never ask for your seed phrase or private key.

4. For members: giveaways

If the server runs giveaways, press the button under the giveaway post (usually 🎉) to enter.

• A pop-up asks for the wallet that should receive a prize, already filled in with your verified wallet. If you have several verified wallets, a menu lets you choose which one, or type another address.
• Some roles may give extra entries; the post lists them. Your entries are worked out from your roles when you enter, so press the button again after getting a new role.
• Press the button again to change your wallet or withdraw, until the giveaway ends.
• Winners are drawn at random when it ends: more entries means a better chance, and nobody wins more than one prize. Winners are tagged in the channel. You must still be in the server, and still allowed to enter, when the winners are drawn.
• A prize only ever needs your wallet address. Never share your seed phrase or private key.

5. For admins: adding SinBot and getting started

1. Add SinBot to your server with the invite link: get in touch with us. SinBot asks only for: Manage Roles, Manage Channels, View Channels, Send Messages, Read Message History, Embed Links and Attach Files. It never needs Administrator.
2. In Server Settings > Roles, drag SinBot's role above every role it should give out. Discord only lets a bot give roles below its own.
3. Run /activate and paste your licence key, e.g. /activate key:SIN-XXXXXX-XXXXXX-XXXXXX. You only do this once.
4. Run /setup and work through the checklist (section 6).
5. Tell your members to press Verify.

If you added SinBot before support tickets existed, turn on Manage Channels for SinBot's role in Server Settings > Roles.

6. For admins: the setup checklist (/setup)

/setup shows what is done and what is left:

1. Licence — active, or how long is left.
2. Log channel (recommended) — where SinBot reports role changes and problems. Only admins should see it.
3. Rules — at least one rule (section 7).
4. Verify button — the panel members use (Verify, Refresh roles, My wallets).
5. Health check — confirms everything works.

Buttons on the checklist:

• Manage roles — opens /roles.
• Run health check — checks permissions, roles, rules, the NFT and wallet services and your channels, and lists anything To fix or as a Warning. Long reports continue over several messages.
• Channels & panel — change or switch off the log channel, and post the Verify panel in a channel at any time (delete the old panel message yourself).
• Support tickets (optional) — section 9.
• Giveaways (optional) — section 10.

You can reopen /setup at any time.

7. For admins: roles and rules (/roles)

/roles is the one place for everything about holder roles. The home screen shows how many roles SinBot uses (each server can use up to 150 roles in its rules and ladders), your rules and ladders, and the collections you use.

• Create a rule — choose one of the collections enabled for your server, then the builder. Collections are enabled by the SinBot team: to use a new one, press Another collection and paste its contract address. SinBot passes the request on, and you can also ask on the SinBot Discord.
• View & remove rules — every rule, page by page, with its ladder position. Removing asks you to confirm.
• Ladders — section 8.

Role managers (optional): in /setup, press Role managers (optional) and pick roles whose members may use /roles without being administrators, for example your moderators. They can create and remove rules and ladders, but cannot use /setup or /activate. Every change is reported in your log channel with who made it. One extra step in Discord: open Server Settings > Integrations > SinBot, choose /roles, press Add Roles or Members and allow the same role(s), because Discord shows /roles only to administrators until you do.

• Browse traits — a collection's traits and how many NFTs have each value.
• Refresh traits — re-read a collection after a reveal or metadata change (once an hour per collection).
• Advanced: ERC-1155 rule — for ERC-1155 tokens: contract, token ID and minimum amount.

The rule builder

The builder first asks What should members need?

Tips:

• The builder shows live counts of how many NFTs match.
• Minimum NFTs can be any number: choose Other number... in its menu.
• For titles, type one title per line, like 5 = Banana Collector. SinBot creates the roles (or reuses roles with exactly those names), the rules and a ladder.
• In Master collector, number-style traits (such as Power or Speed) start unticked, because collecting every number is rarely possible. The values are fixed when you save; if a reveal adds new values later, the health check tells you.
• Several rules for the same role mean any one passing gives it.
• Nothing is saved until you confirm. Change rule type takes you back to the first question.

8. For admins: role ladders

A ladder is an ordered list of roles, top first. On each ladder, a member keeps only the highest role they qualify for, and SinBot removes the lower ones — even ones given by hand.

• Build them in /roles > Ladders (create, add roles, move up or down, remove, rename, delete), or automatically with Rank the values of a trait or Titles by how many they hold.
• A server can have several ladders; a role can be on only one.
• Safety: if SinBot cannot check a higher rung (for example a data service is down), it changes nothing on that ladder until it can.
• The health check flags ladders with fewer than two roles, deleted roles, and roles with no rule behind them.

9. For admins: support tickets

Optional, included with your licence. In /setup, press Support tickets and choose:

1. Your staff roles — they (and server admins) see every ticket.
2. A category for ticket channels — SinBot needs View Channel, Manage Channels and Send Messages there. A Discord category holds at most 50 channels.
3. The channel for the Open ticket button.

When a ticket opens, only the staff roles are pinged. Opening and closing are reported in your log channel. Ticket channels are named like ticket-0042-username.

10. For admins and hosts: giveaways (/giveaways)

Optional, included in every plan.

Setting up (admins): in /setup, press Giveaways (optional):

1. Switch giveaways on.
2. Choose a private results channel, one only staff can see. When a giveaway ends, SinBot posts the winners there with their wallets and a spreadsheet file (CSV) you can open in Excel or Google Sheets. SinBot needs View Channel, Send Messages and Attach Files there, and warns you if everyone can see it.
3. Optional: choose giveaway host roles, whose members may run giveaways without being administrators. Also open Server Settings > Integrations > SinBot, choose /giveaways, press Add Roles or Members and allow the same role(s), because Discord shows /giveaways only to administrators until you do.

Creating a giveaway: run /giveaways and press Create a giveaway.

• Prizes & times: a title, an optional description, the prizes with the top prize first, one per line (1 x Rare NFT, 100 x WL spot; up to 1,000 winners in total), when it starts (now, or for example 2h or 1d 6h) and how long it runs (for example 3d 12h; 5 minutes to 60 days). The screen shows the exact start and end times.
• Channel: where the giveaway is posted. SinBot needs View Channel, Send Messages and Embed Links there.
• Entries & button (optional): entries for everyone (0 means only the roles you list can enter), entries per role (Gold Holder = 5, one per line), and the button emoji.
• Members with several bonus roles get: their best role only (default) or roles add up (everyone's entries plus every bonus role they hold).

When it ends: winners are drawn at random, weighted by entries, top prize first, one prize per person. Each winner is checked to be still in the server and still allowed to enter; if not, the next person drawn takes their place. If there are fewer entrants than prizes, everyone wins once and the leftover prizes are reported as not awarded. Winners are tagged in the giveaway channel (about 80 per message), and only winners are pinged.

Afterwards, in /giveaways: open a giveaway to edit it (title, description, prizes, end time), end it now and draw, cancel it, re-roll a winner (for example someone who cannot claim: a new winner is drawn for the same prize from people who have not won), or see the winners and download the winners file. Finished giveaways stay in the /giveaways list for 30 days, until their entries are deleted; the results channel keeps the results messages for as long as you keep them. Each server can have up to 10 scheduled or running giveaways at once. Creating, editing, ending, cancelling and re-rolling are reported in your log channel.

If giveaways are switched off, or the licence has run out, running giveaways pause: nobody can enter and nothing is drawn until they are back on.

11. Licences

• A licence switches SinBot on for one server (/activate).
• Every licence has a plan:

• "Members" means members who currently hold at least one role given by SinBot. /setup, /roles and the health check show your usage.
• Over the member limit: for 7 days nothing changes except a daily warning in your log channel. After that, members who do not have a SinBot role yet will not get one until you upgrade or the number drops; members who already have roles keep them.
• SinBot posts reminders in your log channel during the last 7 days of your licence.
• After it expires, roles keep updating for 5 more days (grace period), then updates pause until it is renewed.

12. Your data

In short: SinBot stores your Discord user ID and the wallet addresses you link, never your seed phrase, email or messages. Wallet links are deleted when you unlink them, or 30 days after you are no longer in any server that uses SinBot. A server's rules and settings are deleted 30 days after SinBot is removed. Unfinished verifications are deleted a day after the code expires, ticket records 90 days after the ticket closed, and giveaway entries (with the wallets entered) 30 days after the giveaway ended. Full details: coming soon.

13. Commands

Everyone: Verify, Refresh roles and My wallets buttons, giveaway entry buttons, /unlink, /help, /ping.

Server admins:

• /activate key: — switch SinBot on with your licence key (once).
• /setup — the setup checklist, Channels & panel, health check and support tickets.
• /roles — create and remove rules, ladders, browse and refresh traits, ERC-1155 rules. Also open to role managers (section 7).
• /giveaways — create and run giveaways. Also open to giveaway hosts (section 10).

14. Troubleshooting

Admins: start with /setup > Run health check — it lists what to fix.

• A holder did not get a role: SinBot's role must sit above the role it gives (Server Settings > Roles).
• "Could not find your code": make sure the code is saved in the bio of the same wallet's OpenSea profile, wait a minute, then try again after the timer.
• "OpenSea has no profile": log in to opensea.io once with that wallet, then try again.
• "Verification is busy" or "10 verification attempts": wait until the time shown, then try again.
• "Could not reach OpenSea right now": a temporary problem on our side; try again later.
• Roles did not change after a sale: press Refresh roles. Everyone is re-checked daily.
• A collection shows few or no traits, or "traits still loading": some collections reveal after the NFT data service saved a placeholder. SinBot then reads each NFT's traits from its own metadata file in the background, which takes about 10 minutes for 500 NFTs. Check again later in /roles > Browse traits.
• The Verify button will not post: give SinBot View Channel and Send Messages in that channel, then choose it again in /setup > Channels & panel.
• Tickets do not open: give SinBot Manage Channels, plus View Channel, Manage Channels and Send Messages in the ticket category. The health check shows what is missing.
• "This server already uses N of the 150 roles": remove rules you no longer need in /roles > View & remove rules.
• A giveaway did not start or draw: giveaways must be switched on in /setup > Giveaways, with a results channel SinBot can post in. The health check shows what is missing.
• Old commands like /newrule are missing: they were replaced by /setup and /roles. Press Ctrl+R in Discord if the command list looks out of date.

15. Getting help

Contact: https://discord.gg/D6H58DZn8