@liquidapps/zeus-cmd NPM

  ____   ___   _   _   ___ 
 |_  /  / _ \ | | | | / __|
  / /  |  __/ | |_| | \__ \
 /___|  \___|  \__,_| |___/  cmd
            
Extensible command-line tool - part of the Zeus SDK

Overview

zeus-cmd is an Extensible command line tool. SDK extensions come packaged in "boxes".

Boxes

EOSIO dApp development support
DAPP Services support
coldtoken - vRAM based eosio.token https://github.com/liquidapps-io/zeus-coldtoken-sample
deepfreeze - vRAM based cold storage contract for multiple tokens https://github.com/liquidapps-io/deepfreeze
vgrab - vRAM based airgrab for eosio.token https://github.com/liquidapps-io/vgrab

Getting started

Prerequisites:

Docker
nodejs >= 10.x
curl

Recommended (otherwise falling back to docker):

eosio.cdt v1.6.1 https://github.com/EOSIO/eosio.cdt/releases/tag/v1.6.1

Install

    npm install -g @liquidapps/zeus-cmd

    @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
    choco install -y vcbuildtools docker docker-machine docker-compose
    docker-machine create -d hyperv default

Recommended version: 18.06.1-ce-mac73

Upgrade

    npm update -g @liquidapps/zeus-cmd

Test

    zeus unbox helloworld
    cd helloworld
    zeus test

Other Options

    zeus compile - compile sample contracts
    zeus migrate - migrate sample contracts (deploy to local eos.node)

Notes regarding permissions errors:

Recommend using Node Version Manager (nvm)

    sudo apt install curl
    curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.34.0/install.sh | bash
    exec bash
    nvm install 10
    nvm use 10

Or you can try the following:

    sudo groupadd docker
    sudo usermod -aG docker $USER

    */ If still getting error: */
    sudo chmod 666 /var/run/docker.sock

Usage inside a project

    zeus --help

    zeus list-boxes

    zeus update --repos

Project structure

Directory structure:

    extensions/
    contracts/
    frontends/
    models/
    test/
    migrations/
    utils/
    services/
    zeus-box.json
    zeus-config.js

zeus-box.json:

    {
      "ignore": [
        "README.md"
      ],
      "commands": {
        "Compile contracts": "zeus compile",
        "Migrate contracts": "zeus migrate",
        "Test contracts": "zeus test"
      },
      "install":{
          "npm": {
              
          }
      },
      "hooks": {
        "post-unpack": "echo hello"
      }
    }

zeus-config.js

    module.exports = {
        defaultArgs:{
          chain:"eos",
          network:"development"
        },
        chains:{
            eos:{
                networks: {
                    development: {
                        host: "localhost",
                        port: 7545,
                        network_id: "*", // Match any network id
                        secured: false
                    },
                    jungle: {
                        host: "localhost",
                        port: 7545,
                        network_id: "*", // Match any network id
                        secured: false
                    },
                    mainnet:{
                        host: "localhost",
                        port: 7545,
                        network_id: "*", // Match any network id
                        secured: false
                    }
                }
            }
        }
    };

Overview

Boxes

Getting started

Prerequisites:

Recommended (otherwise falling back to docker):

Install

Additional installation steps on windows:

Notes regarding docker on mac:

Upgrade

Test

Other Options

Notes regarding permissions errors:

Usage inside a project

List Boxes

Update Boxes Repo

Project structure

Directory structure:

zeus-box.json:

zeus-config.js