# Role Rewards Setup

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:

<table><thead><tr><th width="138.33333333333331">Input</th><th>Description</th><th>Typical Input Examples</th></tr></thead><tbody><tr><td>Rule Type</td><td>What type of holding is being verified?<br>(<em>Selected from setup menu buttons)</em></td><td><em>Choose NFT, CNFT (compressed NFT) or Fungible Token Holding</em></td></tr><tr><td>Verification Type</td><td>How will this be verified? <br>(<em>Selected from setup menu buttons)</em></td><td>C<em>hoose Collection Address, Mint Address(es), Creator Address, Metadata, or more from available options...</em></td></tr><tr><td>Verification Address</td><td>Collection Address, creator address, update authority address, or other base58 format address depending on verification type.</td><td><em>FRScj6c9JS3BYNSvj4QUuqQR5oU7PCEX2L4a7oDpPtrc</em><br></td></tr><tr><td>Quantity Required</td><td>How many tokens or NFTs are required to be held? Must be an integer.</td><td><em>1, or any other number</em></td></tr><tr><td>Role Awarded</td><td>What role will be given if the user meets the holding requirement? Use Role ID. </td><td>1060959050902294538</td></tr><tr><td>Attribute &#x26; Value</td><td>For metadata attribute verifications only. Input the attribute and the required value, separate by a colon.</td><td><em>Background: Blue</em></td></tr><tr><td>Power Level</td><td>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.</td><td><em>Power: 25</em><br><em>Defense: 6</em><br><em>Hamburgers: 25</em></td></tr><tr><td></td><td></td><td></td></tr></tbody></table>

Example modal input menu:\
![](/files/zF5aGP4PUbu0bdZfRJWX)

When the `/setup_rewards` command is used, you will get an interactive menu:

<figure><img src="/files/KBF6c9cMZU0zX6XRyB7g" alt=""><figcaption></figcaption></figure>

Click through through the buttons in the menu to set up or remove rules as desired.

#### **Add New Rule Menu**

<figure><img src="/files/mEvr3KAsc3dLBxqmDoNN" alt=""><figcaption></figcaption></figure>

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).&#x20;

#### Add NFT rule

<figure><img src="/files/0h53oqJh3vDPwpsV8Qxh" alt=""><figcaption></figcaption></figure>

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.&#x20;

**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:

<figure><img src="/files/7M8ezG1yX4lcj5c7RRdz" alt=""><figcaption></figcaption></figure>

When in doubt... check the NFT metadata&#x20;

<figure><img src="/files/R5aYxiYwfSx67rbzsgMH" alt=""><figcaption></figcaption></figure>

*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](/space-nft-bot/general-information.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://space-vizsla.gitbook.io/space-nft-bot/setup/role-rewards-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.