Alice in Collab.Land
Our bot, is ready to take you to Collab.Land.
You will need a Discord server to use Collab.Land.
If you don’t already have an existing server, see below for setup instructions.
Linking the Collab.Land Bot
Important: To function properly, make sure Collab.Land role is above any roles it is managing (all token-gated roles). The best practice is to put it under the Admin or Mod roles.
Create a Discord Server
Chatting with Collab.Land
Like all good bots, Collab.Land needs to be told what to do.
Once Collab.Land is added to your server, it will greet you and automatically create a collabland-config channel. We advise to keep access to your collabland-config channel limited as it contains privileged setup information. By default, the person setting up the bot has exclusive access.
There are three ways to chat with Collab.Land, each which allows a unique set of commands.
Admin Commands Accessible only in collabland-config
General Command Use in any channel except collabland-config.
Direct Command DM Alice.
Collab.Land has two levels of privilege.
Admin Configure token permissions.
Users Send and claim tips.
Type !help in the collabland-config channel to get started.
(Available exclusively in collabland-config)
Enter !help in the collabland-config channel to set up token features for the server’s channels.
Enter commands in the message bar at the bottom of the app. Some commands can be entered by selecting the appropriate reaction emoji
Use “!setup role” in the collabland-config channel to set up token permissions and assign them to roles created in the Discord server settings. Alice will moderate up to 24 role configurations assigned to your channels based on token holdings and token behavior. Once set up, community members can enter !join in any public channel to participate in your token economy!
One or more tokens can be configured for each role. When more than one token is configured, a member only needs to meet the requirement for one of the configurations. The bot continues to monitor your member's token holding in regular intervals. If a member no longer meets the requirement, for example they transfer the tokens out of their wallet, the role will automatically be removed.
Roles must first be created in Discord server settings. Make sure Collab.Land is at the top of the server role hierarchy. It needs to be above any roles it will interact with.
Example of Discord roles:
Choose a Network
Collab.Land supports several blockchain networks for token permission roles.
Click on the reaction for the corresponding network to proceed.
Select a Token Type
Collab.Land supports multiple types of tokens for token permission access.
ERC-20 Token Example
If done correctly, the Role Configuration should look like this:
Removing a Role Configuration
When viewing the Role Configuration, react with Remove Role.
Then, message !delete followed by the number of the configuration to delete.
A confirmation will be displayed.
The welcome message will be DM’d to members by the Bot upon first joining the community.
Enter any message here, including links, to help your new members explore your community.
To view a list of active token permission roles use the command “!roles”
Enables the welcome message.
Disables the welcome message.
Enables membership verification in regular intervals. This is enabled by default.
Disables membership verification in regular intervals. The bot will verify members once upon joining.
Command Alice to connect your wallet, send tokens, and access your balance.
Enter “!help” in chat for a list of community features available to you.
To gain access to private token permission chat channels, users enter the command “!join” in the public channel to begin the process of connecting their crypto wallet.
The Bot will DM the member a link to connect their crypto wallet
Once a wallet is connected the Bot can determine if the member is holding the required token(s) to access private channel(s).
Community members can send each other tips within the group without gas fees by using the “!tip” command.
Enter !tip <@username> <number of tokens> <the token symbol>)
The Collab.land Bot will DM the recipient to notify that a tip has been sent.
Members can DM the Bot the “!balance” command to view their total balance.
!help (in DM)
You can DM Alice to privately access your balance and process deposits and withdrawals.
DM the Bot to view your current crypto balance within the community.
Use the “!deposit” command to add funds to your balance without having to receive a tip.
Before sending funds from your wallet, make sure to update the depositor address by following the link.
Updating the Depositor Address
This is the wallet address you will be using to send funds to your Collab.land wallet
4. Your wallet is now accepted and can send funds to the balance deposit address.
Use the “!withdraw” command to transfer funds from your balance to a wallet address.
(Optional) (true = pay transaction fee from token value.)
Example: !withdraw DAI true
Use the “tip tokens” command to display a list of tokens supported for tipping.
This can be entered in chat or as a DM to the bot.
During this promotional event, there are no fees for tipping within Discord. Please feel free to send tokens back and forth to any of your community members.
However, if you move tokens to or from a crypto wallet address, you will have to pay gas, which is a mining fee required for all Ethereum transactions. Currently, DeFi projects are causing spikes in the cost, so we advise you do this in as few transactions as possible.
Our withdrawal UI is still being built. Currently, if you withdraw, there won’t be a warning. Gas cost will automatically be deducted from your balance. Make sure you have enough ETH, otherwise, the cost will be pulled from your existing token balance based on the token types used for that transaction.
A user has 0 ETH, and 1000 DAI, and tries to withdraw their full DAI balance. If the gas fee is equivalent to 10 DAI, then the user will receive 1000 - 10 (990) DAI.
If a User is using multiple tokens in the same transaction, the platform will attempt to withdraw tokens in the order they are used within the !withdraw command.