Set currency token supply limit

Changes the current maximum supply of currency tokens allowed to be minted for a currency.


Call URL

/currencies/(currencyAddress)/token-limit

Type : PUT


Call request header parameters

Field Type Required/Optional Description Accepted values
wallet-address string Required The sender's wallet address. Any valid wallet address
wallet-key string Required The key of the sender's wallet. Any valid wallet key that unlocks the sender's wallet

Call request URL parameters

Field Type Required/Optional Description Accepted values
currencyAddress string Required The address of the involved currency. Any valid currency address

Call request body parameters

Field Type Required/Optional Description Accepted values
newCurrencyTokenLimit number (in string) Required The new limit for the number of currency tokens allowed to be minted. Any number in string (limited to 16 digits in integer length).

Sample Call Request

https://api.tetrium.io/tokenize/currencies/0x29341b674091d600c227B137a457b0573515A7A8/token-limit

Parameters:

{
   "newCurrencyTokenLimit":"1000000000.00"
}

Call responses

Success response

Field Type Description Respond Values
status string Status of the API call. "success"
message string Information about the status. "set-currency-token-supply-limit initiated"
transactionHash string The hash of the transaction. To be used to verify the transaction's sealing status. Any string

Error response

Field Type Description Respond Values
status string Status of the API call. "fail"
error string Information about the error. (See below)

Information contained in error:

Error Messages Description
"missing newCurrencyTokenLimit" newCurrencyTokenLimit was not provided as a parameter in the API call body.
"invalid newCurrencyTokenLimit" newCurrencyTokenLimit provided was either not in a string format, lower than zero, or beyond the range allowed (Maximum 16 digits of integer and 6 digits of decimal points).
"token limit smaller than total supply" newCurrencyTokenLimit provided was smaller than the current total supply of currency tokens. Please set a higher limit or burn some currency tokens to set a lower number.

For any other errors, please refer to List of Common Error Messages

Sample Call Response

{
   "status":"success",
   "message":"set-currency-token-supply-limit initiated",
   "transactionHash":"0xbd0490790d8f76a1693964dcc64fec082e8aec377c481269b72473c0cae0fbee"
}

results matching ""

    No results matching ""