Quick Start

Initialization
Requires Kit
If you have not installed the Kit client, check the previous page to learn how to install it.
The first thing to do is to initialize your machine. This process will create the necessary directories, files and configurations required to run a MakeOS node. 
Open a terminal and run this command:
1
kit init --v1
Copied!
The init command will set up Kit’s application directory and create the configuration needed to operate a MakeOS node. These data directory of a node can be found in $HOME/.kit:
The flag --v1 applies the network preset that configures your node for the Testnet (v1). Without the flag, your node will be configured for the Mainnet which is not live at the moment.
1
ls $HOME/.kit 
2
1 accounts extensions kit.yml
3
​
4
ls $HOME/.kit/config 
5
addrbook.json genesis.json priv_validator_key.json config.toml node_key.json
Copied!
Join the network
To get your node to join the public network, run:
1
kit start --rpc.on
Copied!
Turn on RPC service 
The --rpc.on flag turns on RPC service allowing you to attach to the node.
Kit will connect to the network automatically and begin to fetch and execute blocks till it is completely synchronized with the network. Kit connects to seed nodes embedded in the binary and managed by us.
The seed nodes in the binaries we distribute will allow you to quickly and painlessly connect to the network as soon as you start Kit.
However, if you want to connect to a specific node of your choice, use the --node.addpeer flag to add one or more peer addresses:
1
kit start --node.addpeer="<id-of-node>@127.0.0.1:9000"
Copied!
Start in console mode
Kit provides a JavaScript console environment that allows you to create custom instructions and execute operations not natively or conveniently provided via the CLI interface.
On the console, you can perform query operations, create transactions, execute custom scripts, perform RPC operations and more.
To start a node in console mode, open a new terminal window and run:
1
kit console --rpc.on
Copied!
The command will start a console session that allows you to execute JavaScript expressions and scripts:
1
Welcome to the JavaScript Console! 
2
Client:0.0.1, Protocol:1, Commit:4e522ab9a9...568f6abcae, Go:go1.14.5 
3
type '.exit' to exit console
4
​
5
> 2 + 2
6
4 
Copied!
The command above is like kit start, except it also runs the JavaScript console where you can write and execute JavaScript expressions.
Attach to a node
Kit can attach to and interact with a running node via RPC. In attach mode, a JavaScript console is started and connects to the RPC service of a local or remote node, allowing you to query and execute operations against it.
If you already have a node running on the default RPC address and port, you can attach to it using the kit command:
1
kit attach
Copied!
However, if the node is running on a remote server, you can specify the remote address of the server using the --remote.address flag:
1
kit attach --remote.address="10.45.22.21:9002"
Copied!
Use --rpc.user and --rpc.password to set RPC username and password.
You may find that some methods available in the console mode are non-functional in attach mode. We are working to bring the attach mode into parity with the console mode
Create a Repository.
Get Test Coins
Initialize a New Repository

Introduction - Previous

Install

Next - Introduction

Set Up a Private Network

Last modified 1yr ago

Copy link

Contents

Initialization

Join the network

Start in console mode

Attach to a node

Create a Repository.