Skip to content
This repository has been archived by the owner on Jan 22, 2025. It is now read-only.

Latest commit

 

History

History
260 lines (176 loc) · 8.44 KB

README.md

File metadata and controls

260 lines (176 loc) · 8.44 KB

CUDOS BLAST

CUDOS BLAST is a Node.js CLI (command line interface) tool for working with the CUDOS blockchain. You can scaffold, compile, test (both unit & integration) your smart contracts. Utilizing blast.config.js it provides a possibility for deploying and interacting with them on a specified network (local, test or public). By using this tool you can also spin up a local cudos node and interact with it.

Overview

Click on a command for more information and examples.

Command Description
blast init Initialize a sample project
blast compile Compile all smart contracts in the project in alphabetical order
blast unittest Run unit tests for the smart contracts
blast test Run integration tests for the smart contracts
blast node Base command for interaction with a local node. Subcommands: 'start', 'stop', 'status'.
blast run Run a custom javascript file - for deployment or interaction
blast keys Base command for keystore/accounts management. Subcommands: 'ls', 'add', 'fund', 'rm'.

Installation

Make sure you have a current version of npm and NodeJS installed.
A Docker installation is also required.

Mac and Linux

  1. Install npm and node.
  2. Clone the repo & and cd to the cloned directory
  3. Install cudos-blast globally by running both:
npm install
npm install -g

Windows

For Windows users, we recommend using Windows Subsystem for Linux (WSL).

  1. Install WSL [click here]
  2. Install npm [click here]
  3. Install Node.js [ click here ]
  4. Change npm default directory [ click here ]
    • This is to avoid any permission issues with WSL
  5. Open WSL, clone the repo and cd to its directory
  6. Run both:
npm install
npm install -g

Network selection

todo

Full commands info

blast init

Scaffolds a sample project that is ready to work with the CUDOS blockchain. Contains sample smart contracts and scripts to deploy or interact. Optionally you can specify the directory of the project. If not specified - project is created in the current working directory.

  • arguments: none
  • options: --dir (-d) string, optional Specify a path to install

Example:

blast init
blast init --d /Your/Location/Here

blast compile

Compiles all smart contracts in alphabetical order. Please note that you have to call blast compile from the root of your project and the contracts have to be in a folder {project_root}/contracts or else the tool will not find them. The contracts are compiled as a Rust workspace and therefore if you want to add more folders to compile (i.e. dependent packages in a separate /packages folder) all you have to do is edit the base {project_root}/Cargo.toml file and add your folder under [members]. The compilation is done using rust-optimizer and the artifacts in {project_root}/artifacts folder are optimized for deployment.

  • arguments: none
  • options: --optimizer (-o) string, optional Specify the cargo optimizer version

Example:

blast compile

blast unittest

Runs the unit tests of the smart contracts. The command have to be called from the project root (or the main Cargo.toml file directory).

  • arguments: none
  • options: none

Example:

blast unittest

blast test

It is not working correctly. Only for demo purpose!

Runs the integration tests of the smart contracts - by default located in the integration_test folder. The command have to be called from the project root directory.

  • arguments: none
  • options: none

Example:

blast test

blast node

Base command for interaction with a local node (cudos node). Run blast node --help for more information.

blast node start

Starts a local CUDOS node

  • arguments: none
  • options: --daemon (-d) optional Run the node as a daemon and leaves the current console window free and usable

Example:

blast node start
blast node start -d

blast node stop

Stops a local CUDOS node

Example:

blast node stop

blast node status

Gives a status of a local CUDOS node - online/offline

Example:

blast node status

blast run

Runs a custom javascript file. Currently in the /scripts directory there are two files: deploy.js and interact.js. In the future it should be possible to supply relevant info by the command line (smart contract name, user adress, etc) as option

  • arguments: scriptFilePath string The script file to be executed

  • options: --network (-n) string, optional Specify a custom network
     --account (-a) string, optional Specified account name becomes signer

    How to deploy different smart contracts?

    For each smart contract create a separate deploy file (e.g. deploy_alpha.js and deploy_beta.js) and run it one by one. Do not forget to edit the contract name in the .js file (line 4 in the supplied deploy.js file)

Example:

blast run scripts/deploy.js
blast run scripts/interact.js
blast run scripts/yourScriptFile.js

blast keys

Manages accounts/keys in local node. Run blast keys --help for more information.

Subcommands:

blast keys add

Add an account to the node key storage

  • arguments: accountName string, required
  • options: none

Example:

blast keys add myAccount1

blast keys rm

Removes an account from the node key storage

  • arguments: accountName string, required
  • options: --force, -f Delete without confirmation

Example:

blast keys rm myAccount1

blast keys ls

List all accounts in the node key storage

  • arguments: None
  • options: None

Example:

blast keys ls

blast keys fund

Fund account with tokens

  • arguments: accountName string, required The account to be supplied with tokens
  • options: --tokens (-t) string, required The amount of tokens in acudos. They are transferred from the default local node faucet

Example:

blast keys fund myAccount1 --tokens 1000000

Options

Option Description
--help Show help [boolean]
--version Show version number [boolean]