Generic cli tooling for the CIC token network
Go to file
William Luke 47a9b259ae
continuous-integration/drone/pr Build is passing Details
continuous-integration/drone/push Build is passing Details
fix: add getpass
2022-03-14 15:48:36 +03:00
cic fix: add getpass 2022-03-14 15:48:36 +03:00
config fix: add getpass 2022-03-14 15:48:36 +03:00
doc/sphinx Embedded image in readme md 2021-11-30 10:54:13 +01:00
tests refactor: switch to poetry, add interactive deployment 2022-03-01 10:01:56 +03:00
.coveragerc refactor: switch to poetry, add interactive deployment 2022-03-01 10:01:56 +03:00
.drone.yml fix: change name to cic-cli 2022-03-01 12:40:30 +03:00
.gitignore fix: add getpass 2022-03-14 15:48:36 +03:00
.pylintrc refactor: switch to poetry, add interactive deployment 2022-03-01 10:01:56 +03:00
CHANGELOG WIP add entrypoint 2021-12-05 08:12:36 +01:00
LICENSE Initial commit 2021-10-09 18:50:43 +02:00
MANIFEST.in Add token deployment 2021-10-10 15:37:26 +02:00
README.md fix: add getpass 2022-03-14 15:48:36 +03:00
components.svg Add component diagram symlink 2021-11-30 10:34:46 +01:00
poetry.lock ci: install extra requirements 2022-03-01 12:09:22 +03:00
pyproject.toml fix: change name to cic-cli 2022-03-01 12:40:30 +03:00

README.md

CIC Token Deployment Tool

Status Version

CIC-CLI provides tooling to generate and publish metadata in relation to token deployments.

pip install --extra-index-url https://pip.grassrootseconomics.net cic[eth]

Setup

Importing a wallet from metamask

  • Export the accounts private key Instructions
  • Save the private key to a file
  • Run eth-keyfile -k <file> > ~/.config/cic/keystore/keyfile.json

Usage

Using the wizard

# Local
cic wizard ./somewhere -c ./config/docker

# Test Net
cic wizard ./somewhere -c ./config/testnet

Modular

Some of the concepts described below assume familiarity with base concepts of the CIC architecture. Please refer to the appropriate documentation for more information.

To initialize a new token deployment for the EVM:

cic init --target eth --name <token_name> --symbol <token_symbol> --precision <token_value_precision> <settings_folder>

To automatically fill in settings detected in the network for the EVM:

cic ext --registry <contract_registry_address> -d <settings_folder> -i <chain_spec> -p <rpc_endpoint> eth

Structure of the components

image

CIC-CLI is designed to interface any network type backend. The current state of the package contains interface to EVM only. Thus, the examples below are limited to the context of the EVM.

Development

Requirements

Setup

 poetry install -E eth

Running the CLI

 poetry run cic -h
 poetry run cic wizard ./somewhere -c ./config/docker

Tests

poetry run pytest