Comment on page
Token Issuance
Create a STAS token
Creating a token requires you to first create a 'default' wallet to issue it to the wallet. If you didnt create one, you can jump back to the wallet section.
The token issuance endpoint takes care of all the rest (including paying the mining fee to mint the token). All you need is to add the parameters to specify the type of STAS token you want.
Parameter | Description | Property |
---|---|---|
Name | The token name | UTF-8 standard, up to 32 characters in length. |
Symbol | The token symbol | 1-9 alphanumeric characters |
Description | The token description | up to 512 characters |
Image | The mini icon image | 250x250 pixels, type image |
Token Supply | The amount of tokens to mint in the issuance | Any integer |
Decimals | Decimals indicate the formatting, e.g. decimals 2 for a dollar token with cents. | Integer not bigger than 8 |
Sats Per Token | Satoshis to be used for each token. | Integer |
Splitable | Tokens are split table and merge able, NFTs are not. | Boolean [true/false] |
Data | Custom data string(s) to be added to the issued tokens | Object<Array> |
Meta | Any extra data to indicate legals and terms. | RFC 3986 JSON formatted |
Above stated are the main inputs for each STAS token, the extended schema can be found in below code example. There is only one STAS format but various settings that make it behave according to its purpose and use case.
To issue a STAS token, create a variable with all parameters, and trigger
relysia.issue()
. var parameters = {
serviceId: 'optional',
protocol: 'optional',
data: {
"name": "Bonus Point Token",
"protocolId": "STAS",
"symbol": "BPT",
"description": "A supermarket bonus point token to be used ay https://yourproject.com",
"image": "https://firebasestorage.googleapis.com/v0/b/nftdev/o/nftTemp%2FWL1DdD?alt=media",
"tokenSupply": 30,
"decimals": 0,
"satsPerToken": 1,
"splitable": true,
"data" : {"1" : ["custom data 1", "custom data 2"]},
"properties": {
"legal": {
"terms": "STAS, Inc. retains all rights to the token script. Use is subject to terms at https://stastoken.com/license.",
"licenceId": "stastoken.com"
},
"issuer": {
"organisation": "vaionex corp.",
"legalForm": "Limited",
"governingLaw": "US",
"issuerCountry": "US",
"jurisdiction": "US",
"email": "[email protected]"
},
"meta": {
"schemaId": "STAS1.0",
"website": "https://yourProject.com",
"legal": {
"terms": "Your personal token terms"
}
}
}
}
}
const response = await relysia.contracts.v1.issue(parameters);
Incorporating personalized data into your Tokens can significantly enhance its functionality. The "data" field allows for the inclusion of an object value, which will be assigned as a numbered string key with an accompanying array property. Each element in the array will be added to the token script as its own data chunk.
"data" : {"1" : ["custom data 1", "custom data 2"]},
post
https://api.relysia.com
/v1/issue
Mint a Token.
Last modified 2mo ago