Role Rewards Setup
Setting up role rewards for user NFT or token holdings
Last updated
Setting up role rewards for user NFT or token holdings
Last updated
The SpaceNFT bot can award roles based on Solana NFT or token holdings. To do this, we add rules to determine what is required to be held and what role will be rewarded.
Use /setup_rewards to get started! Rules generally have the following inputs:
| Input | Description | Typical Input Examples |
|---|---|---|
Example modal input menu:
When the /setup_rewards command is used, you will get an interactive menu:
Click through through the buttons in the menu to set up or remove rules as desired.
From the add new rule menu, choose "Add NFT rule" or "Add CNFT rule" if you want to verify an NFT holding - please verify if your NFT is compressed prior to rule setup! Use "Add fungible token rule" if you want to verify a token holding (e.g. BONK, RAY, SAMO, SVIZ).
There are many ways to verify NFTs! These options allow you to create rules to check holdings for a single NFT, an NFT within a collection, NFTs within multiple collections, or NFTs with certain attributes. Each button option will open up a modal input menu to input verification details.
If you don't know what to verify by, we suggest using collection address (if available) or creator address. Open a sample NFT from your collection in Solana.fm, the below diagram describes where you can find various addresses for verification:
When in doubt... check the NFT metadata
Post in the Space Vizsla Discord support channel if you need more help on what to verify by!
After using the modal input menu to create rules you are all set! Use the verify button to get your roles!
More question on rule setup? Reach out on Discord! General Information
Rule Type
What type of holding is being verified? (Selected from setup menu buttons)
Choose NFT, CNFT (compressed NFT) or Fungible Token Holding
Verification Type
How will this be verified? (Selected from setup menu buttons)
Choose Collection Address, Mint Address(es), Creator Address, Metadata, or more from available options...
Verification Address
Collection Address, creator address, update authority address, or other base58 format address depending on verification type.
FRScj6c9JS3BYNSvj4QUuqQR5oU7PCEX2L4a7oDpPtrc
Quantity Required
How many tokens or NFTs are required to be held? Must be an integer.
1, or any other number
Role Awarded
What role will be given if the user meets the holding requirement? Use Role ID.
1060959050902294538
Attribute & Value
For metadata attribute verifications only. Input the attribute and the required value, separate by a colon.
Background: Blue
Power Level
Only used for "power level" verifications. This will take the sum of values for a given attribute among all NFTs held by a user. For example: if a user has three NFTs with an attribute called "Defense", with values of "1", "2", and "3" respectively, this rule can be used to verify a total "Defense" of up to "6". Value must be a number for this verification. For input: separate the attribute and total power level required by a colon.
Power: 25 Defense: 6 Hamburgers: 25
