Mosaics are part of what makes the Smart Asset System unique and flexible. They are fixed assets that can represent a set of multiple identical things that do not change.
A mosaic could be a token, but it could also be a collection of more specialized assets such as reward points, shares of stock, signatures, status flags, votes or even other currencies.
Each mosaic has a unique identifier represented as a 64-bit unsigned integer and a set of configurable properties and flags that can be defined during the mosaic creation.
Find below the complete list of configurable properties.
Determines the decimal place to which the mosaic can be divided. Divisibility of 3 means that the smallest fraction a mosaic can be divided into will be 0.001. The divisibility must be in the range of 0 and 6.
Indicates the amount of mosaic in circulation.
The total supply must be in the range of 0 and 9,000,000,000,000,000 atomic units.
Catapult works with absolute amounts. To get an absolute amount, multiply the amount of assets you want to create or send by 10divisibility.
For example, if the mosaic has divisibility 2, to create or send 10 units (relative) you should define 1,000 (absolute) instead.
Specifies the number of confirmed blocks the mosaic is rented for.
It is allowed to lie in Catapult’s public network up to 3650 days (10 years), being this parameter editable per network.
Non-expiring mosaics can be created by setting this property to 0.
You can use the following formula to convert approximately days to blocks:
If set to true, the mosaic supply can change at a later point. Otherwise, the mosaic supply remains immutable.
Example of a non-transferable mosaic
If set to true, the mosaic can be transferred between arbitrary accounts. Otherwise, the mosaic can only be transferred back to the mosaic creator.
Example of a mosaic restriction
If set to true, the mosaic creator can configure custom restrictions.
To create a mosaic, accounts have to pay a rental fee in addition to the transaction fee. The fees will be deducted from the account’s balance after the announcement of a valid MosaicDefinitionTransaction.
By default, registering a mosaic in Catapult’s public network has an initial cost of 0.0005 symbol.xym.
However, the network dynamically adjusts the mosaic rental fee over time.
To calculate the effective rental fee, the network multiplies the default value set in the configuration by the median network multiplier over last maxDifficultyBlocks. In case there are zero multipliers, these are replaced by the defaultDynamicFeeMultiplier before the median calculation.
Tokenize an asset using mosaics.
Alter the supply of a mosaic.
Getting the mosaic information
Get the ownership, divisibility, duration, and flags for a given mosaic identifier.
Announce a MosaicDefinitionTransaction to create a new mosaic.
Version: 0x01
EntityType: 0x414D
Inlines:
| Property | Type | Description |
|---|---|---|
| id | MosaicId | Identifier of the mosaic. |
| duration | BlockDuration | Mosaic duration expressed in blocks. If set to 0, the mosaic is non-expiring. |
| nonce | uint32 | Random nonce used to generate the mosaic id. |
| flags | MosaicFlag | Mosaic flags. |
| divisibility | uint8 | Mosaic divisibility. |
Announce a supply change transaction to increase or decrease a mosaic’s supply.
Version: 0x01
EntityType: 0x424D
Inlines:
| Property | Type | Description |
|---|---|---|
| mosaicId | UnresolvedMosaicId | Affected mosaic identifier. |
| delta | Amount | Amount of supply to increase or decrease. |
| action | MosaicSupplyChangeAction | Supply change action. |
| Property | Type | Description |
|---|---|---|
| mosaicId | UnresolvedMosaicId | Mosaic identifier. If the most significant bit of byte 0 is set, a namespaceId (alias) is used instead of the real mosaic identifier. |
| amount | Amount | Mosaic amount. |
Enumeration: uint8
| Id | Description |
|---|---|
| 0x00 | No flags present. |
| 0x01 | Mosaic supports supply changes even when the mosaic creator owns partial supply. |
| 0x02 | Mosaic supports transfers between arbitrary accounts. When not set, the mosaic can only be transferred to/from the mosaic creator. |
| 0x04 | Mosaic creator can add rules to restrict which accounts are enabled to send and receive the mosaic. |
Enumeration: uint8
| Id | Description |
|---|---|
| 0x00 | Decrease. |
| 0x01 | Increase. |
Continue: Namespaces.
Did you find what you were looking for? Give us your feedback.
