The Mixin BFT-DAG network reference implementation, the Trusted Execution Environment is not integrated into this repository yet.
Install golang and setup GOPATH following this guide https://golang.org/doc/install.
$ git clone https://github.com/MixinNetwork/mixin.git
$ cd mixin
$ go buildThe mixin command is both the kernel node and tools to communicate with the node RPC interface.
$ mixin
NAME:
mixin - A free and lightning fast peer-to-peer transactional network for digital assets.
USAGE:
mixin [global options] command [command options] [arguments...]
VERSION:
v0.3.2-fac0871857badab82333af6f4ad71d8ecb321e5a
COMMANDS:
kernel, k Start the Mixin Kernel daemon
setuptestnet Setup the test nodes and genesis
createaddress Create a new Mixin address
decodeaddress Decode an address as public view key and public spend key
updateheadreference Update the cache round external reference, never use it unless agree by other nodes
removegraphentries Remove data entries by prefix from the graph data storage
validategraphentries Validate transaction hash integration
signrawtransaction Sign a JSON encoded transaction
sendrawtransaction Broadcast a hex encoded signed raw transaction
decoderawtransaction Decode a raw transaction as JSON
getroundlink Get the latest link between two nodes
getroundbynumber Get a specific round
getroundbyhash Get a specific round
listsnapshots List finalized snapshots
getsnapshot Get the snapshot by hash
gettransaction Get the finalized transaction by hash
getutxo Get the UTXO by hash and index
listmintdistributions List mint distributions
getinfo Get info from the node
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--help, -h show help
--version, -v print the version
Mixin Kernel address are a pair of ed25519 keys, following the CryptoNote protocol. To create a new address use the createaddress command.
$ mixin createaddress
address: XINJkpCdwVk3qFqmS3AAAoTmC5Gm2fR3iRF7Rtt7hayuaLXNrtztS3LGPSxTmq5KQh3KJ2qYXYE5a9w8BWXhZAdsJKXqcvUr
view key: 568302b687a2fa3e8853ff35d99ffdf3817b98170de7b51e43d0dcf4fe30470f
spend key: 7c2b5c97278ed371d75610cccd9681af31b0d99be4adc2d66983f3c455fc9702
Share the address to receive assets from other Mixin Kernel addresses, and keep view key and spend key privately and securely.
Both the view key and spend key are required to spend the assets received from others, and the view key iteself is sufficient to decode and view all the transactions sent to address.
Basic Mixin Kernel transaction is similar to the transaction in Bitcoin, with following format.
{
"version": 1,
"asset": "a99c2e0e2b1da4d648755ef19bd95139acbbe6564cfb06dec7cd34931ca72cdc",
"extra": "34366362393932382d653636632d343966392d386165632d366462366137346666663638",
"outputs": [
{
"type": 0,
"amount": "115.06849309",
"script": "fffe01",
"accounts": [
"XINPXu5NBXszhpZDRJ8iA26TbQ2oWTSq1tXqKKeVeYWgLSz8yXGTtVhMogynYytoMewYVFR541wauLhy1YV33zg445E49YA7"
]
}
],
"inputs": [
{
"hash": "20001842d6eff5129c11f7c053bf1209f0267bf223f1681c9cb9d19fc773a692",
"index": 11
}
]
}This is the same UTXO model used in Bitcoin, but with different field names. Among them version, type and script should not be modified unless you know some advanced topics.
Compact the raw transaction JSON and sign it with the private view and spend key as following.
$ mixin signrawtransaction -n mixin-node:8239 \
-key 0d48c96d383d325a97eea5295cbf3afa7766c49db477b68fd8032ff7f59b0b00d77e434f96f3f42c2d1796662c7cc90497feaf3863a5815f27ba49fd5e29b906 \
-raw '{"version":1,"asset":"a99c2e0e2b1da4d648755ef19bd95139acbbe6564cfb06dec7cd34931ca72cdc","extra":"34366362393932382d653636632d343966392d386165632d366462366137346666663638","outputs":[{"type":0,"amount":"115.06849309","script":"fffe01","accounts":["XINPXu5NBXszhpZDRJ8iA26TbQ2oWTSq1tXqKKeVeYWgLSz8yXGTtVhMogynYytoMewYVFR541wauLhy1YV33zg445E49YA7"]}],"inputs":[{"hash":"20001842d6eff5129c11f7c053bf1209f0267bf223f1681c9cb9d19fc773a692","index":11}]}'
To start a node, create a directory mixin for the config and network data files, then put the genesis.json, nodes.json and config.json files in it.
The main net genesis.json, nodes.json and an example config.example.json files can be obtained from here, you only need to put your own signer spend key in the config.json file.
$ mixin help kernel
NAME:
mixin kernel - Start the Mixin Kernel daemon
USAGE:
mixin kernel [command options] [arguments...]
OPTIONS:
--dir value, -d value the data directory
--port value, -p value the peer port to listen (default: 7239)
This will setup a minimum local test net, with all nodes in a single device.
$ mixin setuptestnet
$ mixin kernel -dir /tmp/mixin-7001 -port 7001
$ mixin kernel -dir /tmp/mixin-7002 -port 7002
$ mixin kernel -dir /tmp/mixin-7003 -port 7003
$ mixin kernel -dir /tmp/mixin-7004 -port 7004
$ mixin kernel -dir /tmp/mixin-7005 -port 7005
$ mixin kernel -dir /tmp/mixin-7006 -port 7006
$ mixin kernel -dir /tmp/mixin-7007 -port 7007
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent