How to make your first namespace and mosaic!

This guide will cover the basic setup of namespaces and mosaics in the NanoWallet. To create a namespace you need: - 5000 XEM for the root namespace - 200 XEM for every subnamespace To create a mosaic you need: - 500 XEM ## Example You are a farmer with 50 potato fields. Since 50 fields are too many for yourself, you start to think about selling some of the fields to investors. How can this be done with NEM and NanoWallet? With namespaces and mosaics of course... ## Creating a namespace ### Introduction Before we create a mosaic to represent the 50 fields, we need to create a namespace and we will also create a sub-namespace. For this example, we create a root-namespace for the farmer and a sub-namespace for the potato fields. A root-namespace can be compared to a web domain, for example, nem.io. A sub-namespace can be compared to a sub-domain such as blog.nem.io. **Following namespaces have to be created:** Root-namespace: farmer Sub-namespace: potato (farmer.potato) ### Creation of root- and sub-namespaces Login to the NanoWallet, go to Services and choose "Create namespace". First, we create the root namespace. ![create namespace](http://imgur.com/ReVopg1.png) - Parent Namespace: select ". (New root Namespace)" - Namespace: farmer (this is the name of the namespace) - Password: Your wallet-password Once you have entered the values, click "Register". Go to the Dashboard and check, if the registration was successful: ![create namespace](http://imgur.com/caUyzq1.png) Now that the root-namespace exists, we can create a sub-namespace. ![create namespace](http://imgur.com/36c2quM.png) - Parent Namespace: select "farmer" - Namespace: potato (this is the name of the sub-namespace) - Password: Your wallet-password Once you have entered the values, click "Register". Go to the Dashboard and check, if the registration was successful: ![create sub-namespace](http://imgur.com/Mf8gous.png) ## Creating a Mosaic Asset After the creation of the Namespaces, we move on to create a mosaic for the 50 potato fields. ![create mosaic](http://imgur.com/Vx7prpZ.png) **Mosaic definition** - Parent Namespace: select "farmer.potato" - Mosaic name: field (this is the name of the mosaic) - Description (optional): a short text description - Password: Your wallet-password **Mosaic properties** - Initial supply: 50 (50 fields) - Divisibility: 0 (fields are not divisible) - Transferable: Means, the mosaic is transferable - Mutable supply: Means, the supply can be changed up or down in the future Once you have entered all the values, click "Send". Go to the Dashboard and check, if the creation was successful. ![mosaic creation](http://imgur.com/cty3uGG.png) If you open the "Explorer", you can see that you now own 50 assets of farmer.potato:field ![mosaic creation](http://imgur.com/nRAcMZ2.png) ## Transfer of Mosaic ### Introduction Everything is set up now and you are ready to sell your first field(s) to investors. Since you are using NEM to manage your fields, your investors also need to set up a NEM NanoWallet. Once done, they can send you their account address. ### Transfer (farmers view) Investor 1 (Alice) has set up the NanoWallet and wants to buy **2 fields** from you. The account address from Alice is: TC2S7V-55FISZ-BJJBP4-UZUDTO-X42P7O-H5WJET-NU4A To send 2 fields to the account, go to Send in NanoWallet and choose "Mosaic transfer": ![mosaic transfer](http://imgur.com/Rgmyj5j.png) Remove the "nem:xem" mosaic: ![mosaic transfer](http://imgur.com/ZiNa8zF.png) Choose "farmer.potato:field" from the "Currency" dropdown and click "Attach": ![mosaic transfer](http://imgur.com/YUzaQKa.png) Add the account address from Alice in the "To" field. Set the amount for the field(s) on the right side, enter your wallet-password and click "Send": ![mosaic transfer](http://imgur.com/4fGZILQ.png) Once you have sent the mosaic asset(s), go to the Dashboard and check, if the transfer was successful: ![mosaic transfer](http://imgur.com/P6Y4Peg.png) ### Transfer (investors view) Alice will see the incoming transactions on her Dashboard: ![mosaic transfer](http://imgur.com/YjtsmAu.png) To check all her owned mosaics, the investor can open the Explorer: ![mosaic transfer](http://imgur.com/ptzfdD9.png) ## Change of supply Your business runs great, in fact, you are thinking about adding another 50 potato fields to your farm. How to add those new fields to your Mosaic? Go to Services - "edit mosaic": ![mosaic transfer](http://imgur.com/Gxg1isV.png) - Select mosaic: farmer.potato:field - Change type: create - Change amount: 50 Check the resulting supply for errors and click "send." Done. ## What about the tomatoes? Since the potato field business is running great, why not do the same to the tomato fields? Since you already have your root-namespace you can create a sub-namespace, for example, "farmer.tomato" and create a mosaic for it just like you did for the potato fields (farmer.tomato:field). Customers happy with your potato asset can now trust your tomato asset too, as they could have both only been created by you. *The NEM Team would like to thank Patrick for this blog.*
4 Likes

German Translation:

Erstelle deinen ersten Namespace inkl. Mosaic im Nanowallet!

Diese Anleitung lernt dir die ersten Schritte zum erstellen von namespaces und mosaics im Nanowallet.

FĂĽr einen namespace brauchst du:

  • 5000 XEM fĂĽr den root namespace
  • 200 XEM fĂĽr jeden sub namespace

FĂĽr ein Mosaic brauchst du:

  • 500 XEM

Beispiel

Du bist ein Landwirt mit 50 Kartoffel-Feldern. 50 Felder sind zu viele fĂĽr dich alleine, du beginnst nachzudenken, einige Felder an Investoren zu verkaufen.

Wie kann das mit NEM und dem Nanowallet gelöst werden?
Mit namespaces und mosaics natürlich…

Erstellung eines namespace

Einleitung

Bevor wir ein mosaic für die 50 Felder erstellen können, müssen wir einen root-namespace sowie einen sub-namespace erstellen. In diesem Beispiel erstellen wir den root-namespace farmer und den sub-namespace potato.

Ein root-namespace kann mit einer Webdomain verglichen werden, zum Beispiel nem.io
Ein sub-namespace kann mit einer Sub-Domain verglichen werden, zum Beispiel blog.nem.io.

Foglende namespaces mĂĽssen erstellt werden:
Root-namespace: farmer
Sub-namespace: potato (farmer.potato)

Erstellung von root- und sub-namespaces

Logge dich im Nanowallet ein, gehe zu Services und wähle “Create namespace”.
Zuerst erstellen wir den root-namespace.

  • Parent Namespace: wähle “. (New root Namespace)”
  • Namespace: farmer (das ist der Name fĂĽr unseren root-namespace)
  • Password: Dein Wallet Passwort

Wenn du alles ausgefüllt hast, klicke auf “Register”. Gehe danach zum Dashboard und überprüfe, ob die Registrierung erfoglreich war:
create namespace

Da der root-namespace nun existiert, können wir einen sub-namespace erstellen.

  • Parent Namespace: wähle “farmer”
  • Namespace: potato (das ist der Name fĂĽr unseren sub-namespace)
  • Password: Dein Wallet Passwort

Wenn du alles ausgefüllt hast, klicke auf “Register”. Gehe danach zum Dashboard und überprüfe, ob die Registrierung erfoglreich war:
create sub-namespace

Erstellung des Mosaic Assets

Nachdem wir die namespaces erstellt haben, fahren wir mit der Erstellung unserers Mosaic’s fort.


Mosaic definition

  • Parent Namespace: wähle “farmer.potato”
  • Mosaic name: field (so heisst unser Mosaic)
  • Description (optional): kurze Beschreibung des Mosaics
  • Password: Dein Wallet Passwort

Mosaic properties

  • Initial supply: 50 (50 Felder)
  • Divisibility: 0 (die Felder sind nicht unterteilbar, werden nur als ganzes Angeboten)
  • Transferable: Legt fest, ob ein Mosaic versendet werden kann
  • Mutable supply: Legt fest, ob die Menge des Moisaics in Zukunft angepasst werden kann

Wenn du alles ausgefüllt hast, klicke auf “Send”. Gehe danach zum Dashboard und überprüfe, ob die Registrierung erfoglreich war:
mosaic creation

Wenn du den Explorer öffnest siehst du nun, dass du im Besitz von 50 assets des farmer.potato:field bist.

Versenden eines Mosaic’s

Einleitung

Grundsätzlich ist nun alles für deinen ersten Verkauf eingerichtet. Da du NEM zur Verwaltung der Felder verwendest, brauchen deine Investoren ebenfalls ein NEM Nanowallet. Sobald sie ein Nanowallet eingerichtet haben, können sie dir Ihre Adressen bekanntgeben.

Transfer (aus der Sicht des Landwirts)

Investor 1 (Alice) hat das Nanowallet eingerichtet und möchte gerne 2 Felder von dir kaufen.
Die Adresse des Accounts von Alice ist: TC2S7V-55FISZ-BJJBP4-UZUDTO-X42P7O-H5WJET-NU4A

Um 2 Felder auf diesen Account zu senden, gehe zu “Send” im Nanowallet und setze das Häckchen bei “Mosaic transfer”:


Entferne das “nem:xem” mosaic auf der rechten Seite:

Wähle “farmer.potato:field” aus dem “Currency” dropdown und klicke auf “Attach”:

Füge die Account Adresse von Alice ins “To” Feld ein. Lege danach die Anzahl Felder unter “Amount” fest und klicke auf “Send”:

Gehe danach zum Dashboard und ĂĽberprĂĽfe, ob die Transaktion erfoglreich war:

Transfer (aus der Sicht des Investors)

Alice sieht nun die eingehende Transaktion im Dashboard:


Um alle Mosaics, welche Alice besitzt, anzeigen zu lassen, öffnet Alice den Explorer:

Ă„nderung der Menge

Dein Geschäft läuft grossartig. Es läuft sogar so gut, dass du darüber nachdenkst 50 weitere Kartoffel-Felder für Investoren anzubieten.
Wie können diese neuen Felder in dem Mosaic ergänzt werden?
Gehe zu Services - “edit mosaic”:

  • Select mosaic: farmer.potato:field
  • Change type: create
  • Change amount: 50

Überprüfe nun die “resulting supply” auf Fehler und klicke danach auf “send”. Fertig.

Was ist mit den Tomaten?

Weil das Geschäft mit den Kartoffel-Feldern gut läuft, möchtest du das selbe für die Tomaten-Felder anbieten.
Da du deinen root-namespace “farmer” bereits besitzt, kannst du direkt einen weiteren sub-namespace erstellen. Dieser könnte zum Beispiel farmer.tomato heissen.
Investoren welche bereits bei den Kartoffel-Feldern (farmer.potato) dabei waren, können deinem neuen Tomaten-Mosaic (farmer.tomato) nun ebenfalls vertrauen, da es unter dem gleichen root-namespace (farmer), welcher im Besitz von dir ist, erstellt wurde.

3 Likes

Hi,
I have some question. i have created namespace and mosaic at the test network successfully.
However, i can’t see my newly created ns + mosaic at the test explorer.
Isn’t expected to able to view at test explorer? or my creation is done wrongly.

Thank you

Which one explorer you use?
Please give your address.

Hi im using this link.
http://bob.nem.ninja:8765/#/browse/

izzit correct?
For my send/receive transaction history i could check there.

Thank you

Looks like explorer is not up to date. Last transaction is 2 days ago.
@gimre, @BloodyRookie it’s your server?

Will tell @gimre tomorrow.

1 Like

Any update on this?

Thank you

@gimre @BloodyRookie
All is working now? Namespace is still not visible.

Using the nano wallet. Namespaces can be created for around 100 XEM and mosaics for around 30 xem.