Mosaic (SDA)
Mosaics, synonymously known as Sirius Digital Assets - SDAs - are part of what makes the Smart Asset System unique and flexible. Throughout this document, SDA and mosaic are used interchangeably. SDAs are fixed assets on the Sirius Chain that can represent a set of multiple identical things that do not change.
An SDA can be a token, but it can also be a class collection of more specialized assets such as reward points, shares of stock, signatures, status flags, votes or even other currencies. A singular SDA that is unique is a Non-Fungible Token, more commonly known as NFT.
Properties
Each SDA has a unique identifier and a set of configurable properties. During the SDA creation, you can define:
| Property | Type | Description |
|---|---|---|
| Divisibility | Integer | Determines up to what decimal place the SDA can be divided. Divisibility of 3 means that an SDA can be divided into smallest parts of 0.001 SDAs. The divisibility must be in the range of 0 and 6. |
| Duration | Integer | Specifies the number of confirmed blocks the SDA is rented for. Duration is allowed to lie up to 3650 days (10 years). To create non-expiring SDAs, leave this property undefined. |
| Supply mutable | Boolean | If set to true, the SDA supply can change at a later point. Otherwise, the SDA supply remains immutable. |
| Transferability | Boolean | If set to true, the SDA can be transferred between arbitrary accounts. Otherwise, the SDA can be only transferred back to the SDA creator. |
Absolute and relative amounts
Sirius Chain works with absolute amounts, removing the comma when the SDA can be divisible. To get an absolute amount, multiply the amount of assets you want to create or send by .
For example, if the SDA has divisibility 2, to create or send 10 units (relative) you should define 1000 (absolute) instead.
Cost
The cost of creating an SDA is configurable per network. By default, it has a cost of 500 xpx plus transaction fees.
SDA Levy
A levy allows a creator of an SDA to set a tax on any subsequent transactions of that SDA. The tax could be set as absolute and percentile. For example, if levy is 20 and absolute then every time when somebody transfer the mosaic the creator gets 20 units of this mosaic. If levy is 20 and percentile then the creator gets 20 percent of the transfer amount. Any SDA may be used as a levy.
Example
A private company, ComfyClothingCompany, decides that it wants to go public. Instead of a traditional IPO, the company decides to do an STO to issue tokens through the Sirius Chain platform.
Thus, the company must create an SDA to represent shares to their company. Here is how the company might configure the SDA properties:
| Property | Configuration |
|---|---|
| Duration | undefined |
| Divisibility | 2 |
| Supply mutable | true |
| Transferable | true |
Duration: Shares of the company should exist as long as the company is in business. The ComfyClothingCompany leaves this property undefined, creating a non-expiring SDA representing their assets.
Divisibility: Although brokerages and investment firms can fractionalize shares, the traditional minimum number of shares an investor can purchase from the open market is 1.
However, Sirius Chain SDAs offer more flexibility in tokenizing their company shares. ComfyClothingCompany chooses the divisibility to be 2, allowing the smallest fraction of their shares to be 0.01.
Fractional ownership, along with the ability to trade 24/7, brings additional liquidity to the market. These same characteristics also open up the market to smaller investors.
Supply: ComfyClothingCompany sets the initial supply of the SDA to a typical startup amount of 10,000,000 authorized shares. As the company grows, it could choose to increase the number of shares, so the supply mutable is set to true.
Transferable: Once the initial shares are distributed, the shares will be on the market to be traded in public. Thus, the transferability property needs to be set to true.
Tips
MosaicId is lower bracket of uint64, therefore the first mosaicId hex is represented by 00 to 7F.
Eg. All mosaicId hex will start from 00XXXXXXXXXXXXXX to 7FXXXXXXXXXXXXXX.
Guides
Note:
We recommend checking out setting up your workstation before going through the guides.
Creating a SDA -After creating a namespace, follow this guide to create an SDA.
Modifying SDA supply -After the supply of an SDA following this guide.
Linking a namespace to a SDA -Link a namespace to an SDA.
Getting the SDA information -Get the ownership, divisibility, duration, and flags for a given SDA identifier.
Getting the asset identifier behind a namespace with receipts -Get the resolution for a given alias and transaction using receipts.
Create(modify) and get SDA levy -Create a new levy for an SDA and get an SDA levy info.
Remove SDA levy -Remove an SDA levy.
Schemas
Note:
Configuration parameters are editable . Public network configuration may differ.
MosaicDefinitionTransaction
Announce an SDA definition transaction to create a new SDA.
Version: 0x02
Entity type: 0x414D
Inlines:
| Property | Type | Description |
|---|---|---|
| mosaicNonce | uint32 | Random nonce used to generate the SDA id. |
| mosaicId | uint64 | The SDA Id. |
| propertiesCount | uint8 | The number of elements in optional properties |
| flags | MosaicFlag | The SDA flags. |
| divisibility | uint8 | The SDA divisibility. |
| properties | array(MosaicProperty, count) | The optional SDA properties. |
MosaicSupplyChangeTransaction
Announce a supply change transaction to increase or decrease an SDA’s supply.
Version: 0x02
Entity type: 0x424D
Inlines:
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The id of the affected SDA. |
| direction | MosaicSupplyChangeDirection | The supply change direction. |
| delta | uint64 | The amount of supply to increase or decrease. |
MosaicModifyLevyTransaction
Add levy to SDA.
Version: 0x01
Entity type: 0x434d
Inlines:
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The id of the affected SDA. |
| Levy | MosaicLevyRaw | A new levy. |
MosaicRemoveLevyTransactionBody
Remove SDA levy.
Version: 0x01
Entity type: 0x444d
Inlines:
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The id of the affected SDA. |
MosaicProperty
| Property | Type | Description |
|---|---|---|
| id | uint8 | The property id. (0x02) stands for duration. |
| mosaicId | uint64 | The SDA property value. |
Mosaic
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The mosaic id. |
| amount | uint64 | The amount of the SDA. |
UnresolvedMosaic
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The mosaic id. |
| amount | uint64 | The amount of the SDA. |
MosaicFlags
Enumeration: uint8
| Id | Description |
|---|---|
| 0x00 | No flags present. |
| 0x01 | The SDA supply is mutable. |
| 0x02 | The SDA is transferable. |
MosaicSupplyChangeDirection
Enumeration: uint8
| Id | Description |
|---|---|
| 0 | Increase. |
| 1 | Decrease. |
MosaicLevyFeeDecimalPlace
| Value | Type | Description |
|---|---|---|
| 100'000 | uint64_t | Levy fee effective decimal places |
MosaicLevyRaw
| Property | Type | Description |
|---|---|---|
| Type | LevyType | Levy type |
| Recipient | UnresolvedAddress | Transaction recipient |
| MosaicId | UnresolvedMosaicId | Levy SDA currency |
| Fee | Amount | The Levy fee |
MosaicLevyType
Enumeration: uint8
| Id | Description |
|---|---|
| 0 | None |
| 1 | Absolute |
| 2 | Percentile |