Creating a mosaic

Follow this guide to create a mosaic.

Background

Mosaics can be used to represent any asset in the blockchain such as objects, tickets, coupons, stock share representation, and even your cryptocurrency.

Prerequisites

• Finish registering a namespace guide
• have an account with xpx
• XPX-Chain-SDK or XPX-Chain-CLI
• A text editor or IDE
• An account with XPX and at least one namespace

Getting into some code

Define two transactions to create a mosaic:

1. A mosaic definition transaction, to create the mosaic, with the following properties:

Property	Value	Description
Divisibility	0	The mosaic won’t be divisible. Determines up to what decimal place the mosaic can be divided.
Duration	1000	The mosaic will be created for the next 1000 blocks. If you want to create a non-expiring mosaic, do not set this property.
Supply mutable	true	The mosaic supply can change at a later point.
Transferable	true	The mosaic can be transferred between arbitrary accounts. Otherwise, the mosaic can be only transferred back to the mosaic creator.

Golang

JavaScript

nonce := rand.New(rand.NewSource(time.Now().UTC().UnixNano())).Uint32()

mosaicDefinitionTrx, err := client.NewMosaicDefinitionTransaction(
    sdk.NewDeadline(time.Hour),
    nonce,
    account.PublicAccount.PublicKey,
    sdk.NewMosaicProperties(true, true, 0, sdk.Duration(1000)),
)
if err != nil {
    panic(err)
}

    const nodeURL = "http://localhost:3000";

    const transactionHttp = new TransactionHttp(nodeURL);

    var mosaicDuration = (1 * 365 * 24 * 60 * 4 ); // 1 year - 15 sec per block 

    const privateKey = process.env.PRIVATE_KEY;
    const account = Account.createFromPrivateKey(privateKey, NetworkType.TEST_NET);

    const nonce = MosaicNonce.createRandom();
    var mosaicId = MosaicId.createFromNonce(nonce, account.publicAccount);

    const mosaicDefinitionTransaction = MosaicDefinitionTransaction.create(
        Deadline.create(),
        nonce,
        mosaicId,
        MosaicProperties.create({
            supplyMutable: true,
            transferable: true,
            divisibility: 0,
            duration: UInt64.fromUint(mosaicDuration),
        }),
        NetworkType.TEST_NET
    )

2. A mosaic supply change transaction, to set the supply. We are going to create 1.000.000 mosaic units.

Golang

JavaScript

mosaic, err := sdk.NewMosaicIdFromNonceAndOwner(nonce, account.PublicAccount.PublicKey)
if err != nil {
    panic(err)
}

mosaicSupplyChangeTrx, err := client.NewMosaicSupplyChangeTransaction(
    sdk.NewDeadline(time.Hour),
    mosaic,
    sdk.Increase,
    sdk.Amount(1000000),
)
if err != nil {
    panic(err)
}

const mosaicSupplyChangeTransaction = MosaicSupplyChangeTransaction.create(
    Deadline.create(),
    mosaicId,
    MosaicSupplyType.Increase,
    UInt64.fromUint(1000000),
    NetworkType.TEST_NET
);

Note:

Sirius Chain mainly works with absolute amounts. To get an absolute amount, multiply the amount of assets you want to create by 10divisibility. For example, if the mosaic has divisibility 2, to create 10 units (relative) you should define 1000 (absolute) instead.

3. Both transactions can be announced together using an aggregate transaction.

Golang

JavaScript

// Convert an aggregate transaction to an inner transaction including transaction signer.
mosaicDefinitionTrx.ToAggregate(account.PublicAccount)
mosaicSupplyChangeTrx.ToAggregate(account.PublicAccount)

// Create an aggregate complete transaction
aggregateTransaction, err := client.NewCompleteAggregateTransaction(
    // The maximum amount of time to include the transaction in the blockchain.
    sdk.NewDeadline(time.Hour),
    // Inner transactions
    []sdk.Transaction{mosaicDefinitionTrx, mosaicSupplyChangeTrx,},
)

const aggregateTransaction = AggregateTransaction.createComplete(
        Deadline.create(),
        [
            mosaicDefinitionTransaction.toAggregate(account.publicAccount),
            mosaicSupplyChangeTransaction.toAggregate(account.publicAccount)
        ],
        NetworkType.TEST_NET,
        []);

What’s next?

Transfer one mosaic created to another account or modify its properties following the next guide.