Mosaics are part of what makes the Smart Asset System unique and flexible. They are fixed assets on the NEM blockchain 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 set of configurable properties. During the mosaic creation, you can define:
| Property | Type | Description |
|---|---|---|
| Divisibility | Integer | Determines up to what decimal place the mosaic can be divided. Divisibility of 3 means that a mosaic can be divided into smallest parts of 0.001 mosaics. The divisibility must be in the range of 0 and 6. |
| Duration | Integer | Specifies the number of confirmed blocks the mosaic is rented for. Mosaics can be configured to not expire. |
| Initial supply | Integer | Indicates the amount of mosaic in circulation. The initial supply must be in the range of 0 and 9,000,000,000. |
| Supply mutable | Boolean | If set to true, the mosaic supply can change at a later point. Otherwise, the mosaic supply remains immutable. |
| Transferability | Boolean | If set to true, the mosaic can be transferred between arbitrary accounts. Otherwise, the mosaic can be only transferred back to the mosaic creator. |
Note
⚠ The latest release introduces breaking changes. Until the SDKs are not aligned, we recommend using catapult-service-bootstrap 0.1.0 to run the guides.
Note
Configuration parameters are editable . Public network configuration may differ.
Announce a mosaic definition transaction to create a new mosaic.
Version: 0x02
Entity type: 0x414D
Inlines:
| Property | Type | Description |
|---|---|---|
| mosaicNonce | uint32 | Random nonce used to generate the mosaic id. |
| mosaicId | uint64 | The mosaic Id. |
| propertiesCount | uint8 | The number of elements in optional properties |
| flags | MosaicFlag | The mosaic flags. |
| divisibility | uint8 | The mosaic divisibility. |
| properties | array(MosaicProperty, count) | The optional mosaic properties. |
Announce a supply change transaction to increase or decrease a mosaic’s supply.
Version: 0x02
Entity type: 0x424D
Inlines:
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The id of the affected mosaic. |
| direction | MosaicSupplyChangeDirection | The supply change direction. |
| delta | uint64 | The amount of supply to increase or decrease. |
| Property | Type | Description |
|---|---|---|
| id | uint8 | The property id. (0x02) stands for duration. |
| mosaicId | uint64 | The mosaic property value. |
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The mosaic id. |
| amount | uint64 | The amount of the mosaic. |
| Property | Type | Description |
|---|---|---|
| mosaicId | uint64 | The mosaic id. |
| amount | uint64 | The amount of the mosaic. |
Enumeration: uint8
| Id | Description |
|---|---|
| 0x00 | No flags present. |
| 0x01 | The mosaic supply is mutable. |
| 0x02 | The mosaic is transferable. |
| 0x04 | The mosaic levy is mutable |
