Skip to content

[mkdocs] docs: add mosaics concept#846

Open
zero4862 wants to merge 1 commit intoNemProject:new-docsfrom
zero4862:docs-mosaics-concept
Open

[mkdocs] docs: add mosaics concept#846
zero4862 wants to merge 1 commit intoNemProject:new-docsfrom
zero4862:docs-mosaics-concept

Conversation

@zero4862
Copy link
Copy Markdown

@zero4862 zero4862 commented May 5, 2026

Adapts Mosaics concept to NEM technology.

Differences with Symbol:

  • Mosaic ID: <namespace>:<mosaic name> form on NEM (e.g. nem:xem); numeric ID on Symbol (e.g. 0x6BED913FA20223F8), optionally aliased by a namespace.
  • Namespace coupling: Every mosaic lives under a namespace on NEM and inherits its parent's lifecycle; mosaics on Symbol exist independently of namespaces.
  • Lifecycle: NEM mosaics expire when their parent namespace expires (no separate duration); Symbol mosaics have their own duration (eternal or up to 10 years).
  • Properties: Four on NEM (divisibility, initialSupply, supplyMutable, transferable); six on Symbol (adds restrictable and revocable).
  • Levy: Not supported on Symbol.
  • Description: NEM mosaics carry a free-text description field; Symbol uses the generic metadata instead.
  • Creation fee: Fixed at 10 XEM on NEM; variable on Symbol.


Defines the total number of mosaic units created at issuance.

A mosaic's total supply cannot exceed **9 × 10^15^** atomic units, regardless of divisibility.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We might want to mention the max total supply on Symbol docs.

balances are preserved.
- If the original owner renews the namespace during the grace period, the mosaic and its balances become usable again.

!!! warning "Mosaic loss past the grace period is permanent"
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In Symbol, it might be worth investigating and documenting what happens with balances if the account creator tries to renew an expired mosaic.

Creating a mosaic requires announcing a transaction, which also has an associated fee.
However, this transaction fee is typically negligible compared to the creation fee.

## Modifying a Mosaic
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could add a similar section in Symbol docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant