Kaya - Zilliqa's RPC client for testing and development

Kaya is Zilliqa's RPC server for testing and development. It is personal blockchain which makes developing application easier and faster. Kaya emulates the Zilliqa's blockchain behavior, and follows the expected server behavior as seen in the zilliqa-js.

The goal of the project is to support all endpoints in Zilliqa Javascript API, making it easy for app developers to build Dapps on our platform.

Kaya is under development. See roadmap here.

Currently, Kaya supports the following functions:

• CreateTransaction
• GetTransaction
• GetRecentTransactions
• GetNetworkID
• GetSmartContractState
• GetSmartContracts
• GetBalance
• GetSmartContractInit
• GetSmartContractCode

Methods that are NOT supported:

• GetDsBlock
• GetTxBlock
• GetLatestDsBlock
• GetLatestTxBlock

In addition, the following features are not supported yet:

• Multi-contract calls
• Events

Getting Started

Installation

Install the node packages and dependencies: npm install

Scilla files must be processed using the scilla-interpreter. The Scilla interpreter executable provides a calling interface that enables users to invoke transitions with specified inputs and obtain outputs.

Using Remote Scilla Interpreter (Default)

By default, Kaya RPC uses the remote scilla interpreter to process .scilla files. You do not have to change any configurations.

Using Local Scilla Interpreter

You can choose to use your own scilla interpreter locally. To do it, you will have to compile the binaries yourself from the scilla repository and transfer it to the correct directory within Kaya RPC.

Instructions:

1. Ensure that you have installed the related dependencies: INSTALL.md
2. Then, run make clean; make
3. Copy the scilla-runner from [SCILLA_DIR]/bin into [Kaya_DIR]/components/scilla/
4. Open config.js file and set the config.scilla.remote to false. Alternative, use -r false at startup.

Usage

Command Line

$ node server.js

Options:

• -d or --data: Relative path where state data will be stored. Creates directory if path does not exists
• -f or --fixtures: Load fixed account addresses and keys (fixtures) from a JSON-file
• -l or --load: Load data files from a JSON file
• -n or --numAccounts: Number of accounts to load at start up. Only used if fixtures file is not defined.
• -p or --port: Port number to listen to (Default: 4200)
• -r or --remote: Option to use remote interpreter or local interpreter. Remote if True
• -s or --save: Saves data files to saved/ directory by the end of the session
• -v or --verbose: Log all requests and responses to stdout

Example Usage

• Starts server based on predefined wallet files with verbose mode.

node server.js -v -f test/account-fixtures.json  

• Load data files from a previous session and save the data at the end of the session

node server.js -v -s --load test/sample-export.json

Presents

KayaRPC comes with a few preset configurations for lazy programmers:

• npm run debug: Use server with random account keypairs
• npm run debug:fixtures: Use server with fixed account keypairs loaded from test/account-fixtures.json
• npm start: The same as node server.js - random account keypair generations with no verbosity

Testing

Some of the functions in Kaya RPC are covered under automated testing using jest. However, scilla related transactions are not covered through automated testing. To test the CreateTransaction functionalities, you will have to test it manually.

From test/scripts/, you can use run node DeployContract.js to test contract deployment. Then, use node CreateTransaction --key [private-key] --to [contract_addr] to make transition calls. You can use the curl commands stated in the jsonrpc apidocs to test the rest of the functions.

Use --key to specify a private key. Otherwise, a random privatekey will be generated.

Testing with Fixture Files

You can also use the --test flag, which uses default test configurations:

1. Start the server using npm run debug:fixtures
2. Deploy a contract using node DeployContract.js --test.
3. Check where the contract is deployed. It should be on the logs if you have enabled debug mode, otherwise you can check it through the GetSmartContracts method.
4. Send a transaction using node CreateTransaction.js --test

License

kaya is released under GPLv3. See license here