For Admins: Creating a Token-Granted Role (TGR) with a token on XRP Ledger (XRPL)


  1. Go to  https://cc.collab.land, the Collab.Land Dashboard - Command Center, and log in with Discord. Only ADMINS and mods with access to Collab.Land will be able to enter. If you are unsure if you are qualified check your server permissions - you must be able to access the #collabland-config channel in your server in order to manage your server in the Command Center.

     

  2. Click on the TGRs tab for the server you want to work with: 


  3. Press the + Select Role button to select the Discord role you would like to use. Note: Have all the roles you want to choose from created in Discord prior to adding the TGR functionality. 






  4. Enter the token details of your XRPL token now. 

Fungible Token(FT) example:




  1. Description: Optional field to enter a description of your TGR

  2. Chain Type: Select XRPL

  3. Token Type: Select XRPL FT

  4. Currency: Add the currency here. You can find it using any XRPL block explorer of your choice e.g. https://livenet.xrpl.org/.  Use either standard currency codes (such as USD) or non-standard currency codes in hex format. Both are readable by Collab.Land. 

        

        


  1. Issuer Address: Add the Issuer Address. You can find this using an XRPL block explorer of your choice like https://livenet.xrpl.org/


  1. Balance -  Min Amount: Enter the minimum amount of tokens required to get the role

  2. Balance - Max Amount (optional): Enter the maximum amount of tokens























Non-Fungible Token(NFT) example:


  1. Description: Optional field to enter a description of your TGR

  2. Chain Type: Select XRPL

  3. Token Type: Select XRPL NFT

  4. Taxon (optional): You can your NFT Taxon. You can find this using an XRPL block explorer of your choice like https://livenet.xrpl.org/

  5. Issuer Address: Add the Issuer Address. You can find this using an XRPL block explorer of your choice like https://livenet.xrpl.org/

  6. Balance - Min Amount: Enter the minimum amount of tokens required to get the role

  7. Balance - Max Amount (optional): Enter the maximum amount of tokens (optional)

  8. Attributes (optional): You can add specific metadata conditions which must be met for the member to qualify for the role. If your NFT contains metadata traits and values you can enter them by clicking on the Attributes button, and clicking on + Add metadata 

    And this is the modal that will pop up for you:

    1. Note: You can find the metadata traits and attributes for your token at https://livenet.xrpl.org/

    2. Once you have finished adding your metadata, click the Save Traits button

  1. Save: Click save! 

  2. Your XRPL FT TGR has been created! ?