telos docs
Search…
Treasuries
Read below to learn more about Treasuries

What is a Treasury?

Treasuries contain information like the current supply of tokens, the max supply, the group settings, and the name of the current manager. Note that tokens cannot exist on Telos Decide™ without an accompanying Treasury.

What is a Treasury Symbol?

All treasuries are identified by the symbol of the tokens they manage - also called their Treasury Symbol.
Note that Treasury Symbols contain the precision amount of the token as well as the actual ticker name. So a 1.000 TEST token would have a symbol of: 3,TEST. The number 3 for the three decimal places of precision, followed by a comma with no space, then the ticker symbol in all caps. Whenever prompted to supply a treasury symbol, remember to give it in this format.

Getting Started

Follow these steps to get started creating a Telos Decide Treasury:

1. Treasury Setup

Any user on Telos Decide may create a new token treasury, complete with all the features Telos Decide provides. Before creating a treasury, the creator needs to know a few things first:
  • Manager: the account that will be the manager of the treasury. This account is allowed to do things like mint new tokens, change settings, or lock the treasury.
  • Max Supply: the total number of tokens allowed to exist at one time. The treasury symbol will be extracted from this value (including the token precision).
  • Access: the accessibility of the treasury. This can be set to public, private, or invite. Public means that an account can register as a voter at any time. Private means the treasury manager will have to approve every new voter before they can register. Invite means any voter can invite another voter, provided the inviter is a registered voter themselves.

2. Send newtreasury() Transaction

Once the new settings are decided, the treasury is ready for creation. Actually creating it involves sending a newtreasury() action to the telos.decide contract and giving it your arguments like so:
1
cleos push action telos.decide newtreasury '["craig.tf", "500.00 CRAIG", "public"]' -p craig.tf
Copied!
In the above command we are creating the public CRAIG treasury, managed by the craig.tf account, and with a max supply of 500.00 tokens.
Note that sending a newtreasury() transaction can be done through almost any Telos block explorer, and even some wallets like Sqrl.

3. Managing A Treasury

After the treasury has been successfully created its ready to start holding ballots - but first we have to register voters and mint tokens, otherwise there won't be any voters with tokens who can participate on our ballots.
In order to mint tokens we have to have a voter to hold them, so let's go ahead and register ourselves. Registering new voters is done by sending a regvoter() transaction to the telos.decide contract. Similar to preparing for sending the newtreasury() transaction, we also need to know a few pieces of information first:
  • Voter: the name of the account to register as a voter.
  • Treasury Symbol: the symbol of the treasury to register for. This includes the token precision (the number of decimal places the token uses).
  • Referrer: the account that is referring the new voter, if any. If no referrer, then give null as an argument.
Depending on the access method, a treasury may require extra signatures from certain voters to qualify. Since we made our treasury public we don't need to worry about referrals.
1
cleos push action telos.decide regvoter '["craig.tf", "2,CRAIG", null]' -p craig.tf
Copied!
Treasury Settings
Setting
Description
Default
transferable
Allows tokens to be transferred.
false
burnable
Allows tokens to be burned by the manager.
false
reclaimable
Allows tokens to be reclaimed by the manager.
false
stakeable
Allows tokens to be staked.
false
unstakeable
Allows tokens to be unstaked.
false
maxmutable
Allows max supply to be mutated.
false
Treasury Access
Access Method
Description
Public
Open to everyone
Private
Requires referral by manager
Invite
Requires referral by voter

Table Breakdown

Treasuries manage a lot of data, so it's important for managers to understand how treasuries work and how to read treasury information so they can best serve their voters.
Table: treasuries
Scope: telos.decide
Field
Type
Description
supply
asset
Current circulating supply of tokens.
max_supply
asset
Maximum circulating supply of tokens.
access
name
Access method for becoming a voter.
manager
name
Account that can edit and lock the treasury.
title
string
Treasury title.
description
string
Treasury description.
icon
string
IPFS cid or URI pointing to treasury icon.
voters
uint32
Number of voters registered.
delegates
uint32_t
Number of delegates registered.
committees
uint32_t
Number of committees registered.
open_ballots
uint16
Number of ballots open for voting.
locked
boolean
Locked if true, unlocked if false.
unlock_acct
name
Account that can unlock the treasury.
unlock_auth
name
Authority that can unlock the treasury.
settings
map<name, bool>
List of treasury-wide settings with on/off states.
Last modified 8mo ago