"Getting Started" documentation and CLI

Latrasis commented 5 years ago

Following #123, we need begin working out how to provide an initial onboarding experience on setting up a cap9 contract.

This involves specific steps (in relative order) including:

Basic Setup:

[ ] Setting up an Ewasm Testnet (Docker Container)
[ ] Creating an Account on that Testnet
[x] Installing a CLI
[x] Creating a Project Folder - via CLI
[x] Setting up initial deployment parameters including the Admin account - via CLI
[x] Deploying a kernel instance with a default ACL and Admin Procedure - via CLI

State Fetching

[x] List Procedures - via CLI
[x] List Capabilities - via CLI
[x] List Administrator Commands - via CLI

Development Workflow

[x] Setup a hello_world procedure - via CLI
[x] Set Caps + Id - via CLI or File Config
[x] Compile, Deploy and Register new Procedure - via CLI / Cargo
[x] Make Call to new Procedure - via CLI

Proc Upgrade Workflow

Code Change:

[ ] Make code changes to hello_world Procedure
[ ] Compile + Deploy new Procedure - via CLI
[x] Register Upgraded hello_world Procedure - via CLI

Capability-List Change:

[x] Add additional Capability to hello_world Procedure - via CLI/ Config
[x] Register Upgraded hello_world Procedure - via CLI

Test Workflow

[ ] Setup Test - via CLI
[ ] Make Test for new Procedure - via Lib

Documentation

[x] Setup Doc Folder
[ ] Setup Website with linked Documentation

JakeOShannessy commented 5 years ago

Add additional Capability to hello_world Procedure - via CLI/ Config

This might not be currently achievable because we went with static caps. We'll have to make it clear we replacing the previous procedure with a new one (possibly with the same contract).

JakeOShannessy commented 5 years ago

Further to that point, in general upgrading procedures is not possible without the delete procedure capability (this is demonstrated in test deploy_proc_twice). This means that procedure upgrades will need to include a "delete" step.

JakeOShannessy commented 5 years ago

Delete Procedure is now implemented, so all the items under "Proc Upgrade Workflow" can be performed, although we should probably document and/or add shortcuts for those items before we consider them complete.

Daohub-io / cap9