nem2-sandbox

This package aims to provide with a command line interface helping developers to communicate with the NEM2 (Catapult) blockchain.

This package is currently still in development, please do not use in production.

The author of this package cannot be held responsible for any loss of money or any malintentioned usage forms of this package. Please use this package with caution.

Package licensed under Apache v2.0 License.

Protocol Compatibility

• catapult-server@0.9.0.1
• Fushicho2 Client Diff

Donations / Pot de vin

Donations can be made with cryptocurrencies and will be used for running the project!

NEM:       NB72EM6TTSX72O47T3GQFL345AB5WYKIDODKPPYW
Bitcoin:   3EVqgUqYFRYbf9RjhyjBgKXcEwAQxhaf6o

Username	Role
eVias	Project Lead

Examples

Convert UInt64 array notation:

$ ./nem2-sandbox convert uint64 -i "[1, 1]"

Convert Public Key to address notation:

$ ./nem2-sandbox convert address
Enter a public key: 33F0E2685732AE9E202F92B2B93A525BF77C4C14BBA22D088926BA8A7FD0BE13

Transaction broadcaster examples:

$ ./nem2-sandbox transaction transfer
$ ./nem2-sandbox transaction hashlock
$ ./nem2-sandbox transaction aggregate
$ ./nem2-sandbox transaction mosaicDefinition
$ ./nem2-sandbox transaction mosaicSupply
$ ./nem2-sandbox transaction registerNamespace -n namespace
$ ./nem2-sandbox transaction mosaicAlias
$ ./nem2-sandbox transaction addressAlias

Aggregate Transaction Scenarios

1. Create a new named mosaic on catapult network

• Create a root namespace and necessary subnamespaces (RegisterNamespace)
• Create a Mosaic with parameters from command line (MosaicDefinition)
• Add supply to the created mosaic (MosaicSupplyChange)
• Create a namespace alias for the created mosaic (MosaicAlias)

$ ./nem2-sandbox aggregate mosaicConfiguration -n evias.test.name -d 0 -s 1 -t 1 -i 1000

2. Send batch transfers from CSV input

• Read a CSV file with columns: address, amount, mosaic
• Each row in the CSV will be added as one TransferTransaction
• Wrap all transfers into one aggregate transaction

$ export CSV_FILE=`pwd`/files/test.csv
$ ./nem2-sandbox aggregate batchTransfer -f ${CSV_FILE}

3. Create multiple levels of namespaces

$ ./nem2-sandbox aggregate multiLevelNamespace evias.levels.tests
$ ./nem2-sandbox aggregate multiLevelNamespace gregory.saive.handshakes

License

This software is released under the Apache v2.0 License.

© 2019 Grégory Saive [e-mail] for NEM, All rights reserved.