Skip to main content

deployment

Usage: chr deployment [OPTIONS] COMMAND [ARGS]...

  Create and maintain deployments

╭─ Options ───────────────────────────────────────────────────────────────────╮
│  -h, --help  Show this message and exit                                     │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────╮
│  create    Deploy blockchain into container                                 │
│  info      Information about a deployed blockchain                          │
│  inspect   Inspect the API of a deployed blockchain                         │
│  update    Update configuration of a deployed blockchain                    │
│  resume    Starts a paused blockchain in a container                        │
│  pause     Pauses a blockchain in a container                               │
│  remove    Removes a blockchain in a container (This action is permanent)   │
│  proposal  Act on proposals                                                 │
│  voterset  Interact with votersets                                          │
╰─────────────────────────────────────────────────────────────────────────────╯

deployment create​

To deploy your dapp in a container, you use (chr deployment create):

Usage: chr deployment create [<options>]

  Deploy blockchain into container

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Options:
  --secret=<path>           Path to secret file (pubkey/privkey)
  -d, --network=<text>      Specify which deployment target to use
  -bc, --blockchain=<text>  Name of blockchain to deploy
  --no-compression          If compression on rell sources should not be done
  -y                        Confirm that this will create a new deployment
  -h, --help                Show this message and exit

The chr deployment create command reads the deployments key in the project config file. For the first deployment towards a target, the Chromia CLI prompts you with the chains config you need to add to the project config file. An example of such a prompt looks something like this:

Add the following to your project settings file
deployments:
  testnet:
    chains:
      my_rell_dapp: x"<BlockchainRID>" #Dapp Blockchain RID
note

This prompt is your genesis Blockchain RID; you must save this in the config file. This is the identifier for all your following deployments to the chain.

If you already have a deployment and haven't added the chain identifier in your Project Settings file, the command chr deployment overrides any previous deployment to the network. That's why saving the genesis Blockchain RID prompted after the first deployment is important.

note

If you want to override the state, ignore the chain identifier.

When you deploy, you create a snapshot build in the build/ folder with a timestamp by default. You can change this in the project config file in compile:target if you want a different target.

  • To deploy a dapp, you can run the following command when being in the working directory where the chromia.yml file presides:
chr deployment create --network testnet --secret .secret
  • Otherwise, you can set a path for the chromia.yml file or specify a different Project Settings file:
chr deployment create --settings chromia.yml --network testnet --secret .secret
  • If you have multiple chains and only want to deploy a specific one, you can write the command like this:
chr deployment create --settings chromia.yml --network testnet --blockchain my_rell_dapp --secret .secret

deployment info​

To get information about your dapp, you use (chr deployment info):

Usage: chr deployment info [<options>]

  Information about a deployed blockchain

Configuration Properties:
  -s, --settings=<settings>  Alternate path for project settings file

Chromia Configuration:

  Use connection configured under deployment from chromia.yml

  -d, --network=<text>      Specify which deployment target to use
  -bc, --blockchain=<text>  Name of blockchain to deploy

Manual:

  Set connection parameters manually

  -brid, --blockchain-rid=<text>  Target Blockchain RID
  --api-url=<text>                Target api url

Options:
  --verbose                         Show verbose information about nodes
  -f, --output-format=(table|JSON)  Output format
  -h, --help                        Show this message and exit

deployment inspect​

To inspect the API of your dapp, you use (chr deployment inspect):

Usage: chr deployment inspect [<options>]

  Inspect the API of a deployed blockchain

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Node:

  Target a test node

  -brid, --blockchain-rid=<text>  Target Blockchain RID
  --cid=<int>                     Target Blockchain IID
  --api-url=<text>                Target api url

Deployment:

  Use a configured deployment

  -d, --network=<text>      Specify which deployment target to use
  -bc, --blockchain=<text>  Name of blockchain in deployment configuration

Options:
  -f, --output-format=(table|JSON)
                           Output format
  -m, --modules=<modules>  Explicitly state which module to inspect (comma
                           separated)
  -l, --list-modules       List all module names
  --module-args            Show module_args
  --definitions=(queries|operations|entities|objects)
                           List definitions of this kind (comma separated),
                           default: all
  --signature=<value>      Show the signature of the specified definition and
                           exit
  -h, --help               Show this message and exit

deployment update​

To update your dapp, you use (chr deployment update):

Usage: chr deployment update [<options>]

  Update configuration of a deployed blockchain

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Options:
  --secret=<path>           Path to secret file (pubkey/privkey)
  -d, --network=<text>      Specify which deployment target to use
  -bc, --blockchain=<text>  Name of blockchain to deploy
  --no-compression          If compression on rell sources should not be done
  --height=<int>            Deploy configuration at a specific height
  --verify-only             Verifies blockchain config without sending update
                            transaction
  --skip-verification       Skip verification of blockchain config before
                            sending update transaction
  -h, --help                Show this message and exit

deployment pause​

To pause your dapp, you use (chr deployment pause):

Usage: chr deployment pause [<options>]

  Pauses a blockchain in a container

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Options:
  --secret=<path>           Path to secret file (pubkey/privkey)
  --description=<text>      Description on why the blockchain is being acted on
  -d, --network=<text>      Specify which deployment target to use
  -bc, --blockchain=<text>  Name of blockchain to deploy
  -h, --help                Show this message and exit

deployment resume​

To start your paused dapp, you use (chr deployment resume):

Usage: chr deployment resume [<options>]

  Starts a paused blockchain in a container

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Options:
  --secret=<path>           Path to secret file (pubkey/privkey)
  --description=<text>      Description on why the blockchain is being acted on
  -d, --network=<text>      Specify which deployment target to use
  -bc, --blockchain=<text>  Name of blockchain to deploy
  -h, --help                Show this message and exit

deployment remove​

To remove your dapp, you use (chr deployment remove):

Usage: chr deployment remove [<options>]

  Removes a blockchain in a container (This action is permanent)

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Options:
  --secret=<path>           Path to secret file (pubkey/privkey)
  --description=<text>      Description on why the blockchain is being acted on
  -d, --network=<text>      Specify which deployment target to use
  -bc, --blockchain=<text>  Name of blockchain to deploy
  -h, --help                Show this message and exit

deployment proposal​

The deployment proposal command (chr deployment proposal) comprises sub-commands that manage proposals.

Usage: chr deployment proposal [OPTIONS] COMMAND [ARGS]...

  Act on proposals

╭─ Options ───────────────────────────────────────────────────────────────────╮
│  -h, --help  Show this message and exit                                     │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────╮
│  vote    Vote on proposals linked to your public key                        │
│  list    List all proposals that you can vote on                            │
│  info    Get information of a given proposal                                │
│  revoke  Revoke/remove a proposal submitted by you                          │
│  rename  Create a proposal to rename a deployed blockchain                  │
╰─────────────────────────────────────────────────────────────────────────────╯

proposal vote​

Usage: chr deployment proposal vote [<options>]

  Vote on proposals linked to your public key

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  --secret=<path>     Path to secret file (pubkey/privkey)
  --id=<int>          Id of the proposal
  --accept, --reject  Vote action to cast
  -h, --help          Show this message and exit

The vote command (chr deployment proposal vote) allows you to vote on proposals that are linked to your public key.

proposal list​

Usage: chr deployment proposal list [<options>]

  List all proposals that you can vote on

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  --from=<value>  List proposals from date (YYYY-MM-DD)
  --to=<value>    List proposals to date (YYYY-MM-DD)
  --all           Include all proposals, including ones you can not vote on
  --pending       Only include proposals that are still pending
  -f, --output-format=(table|JSON)
                  Output format
  -h, --help      Show this message and exit

The list command (chr deployment proposal list) lists all proposals that you can vote on.

proposal info​

Usage: chr deployment proposal info [<options>]

  Get information of a given proposal

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  --id=<int>                        Id of the proposal
  -f, --output-format=(table|JSON)  Output format
  -h, --help                        Show this message and exit

The info command (chr deployment proposal info) shows the information of a given proposal.

proposal revoke​

Usage: chr deployment proposal revoke [<options>]

  Revoke/remove a proposal submitted by you

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  --id=<int>       Id of the proposal
  --secret=<path>  Path to secret file (pubkey/privkey)
  -h, --help       Show this message and exit

The revoke command (chr deployment proposal revoke) revokes a proposal submitted by you.

proposal rename​

Usage: chr deployment proposal rename [<options>]

  Create a proposal to rename a deployed blockchain

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  --secret=<path>       Path to secret file (pubkey/privkey)
  --description=<text>  Proposal description
  -n, --name=<text>     New name of the blockchain
  -h, --help            Show this message and exit

The rename command (chr deployment proposal rename) creates a proposal to rename a deployed blockchain.

deployment voterset​

The deployment voterset command (chr deployment voterset) comprises sub-commands that manage voter sets.

Usage: chr deployment voterset [OPTIONS] COMMAND [ARGS]...

  Interact with votersets

╭─ Options ───────────────────────────────────────────────────────────────────╮
│  -h, --help  Show this message and exit                                     │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────╮
│  info               Show information of voter set                           │
│  update             Propose an update of a voter set's members list         │
│  list               List all voter sets                                     │
│  add-dapp-provider  Add a dapp provider to container                        │
╰─────────────────────────────────────────────────────────────────────────────╯

voterset info​

Usage: chr deployment voterset info [<options>]

  Show information of voter set

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  -n, --name=<value>       Name of voter set
  -c, --container=<value>  Name of the container that is governed by the
                           voterset
  -f, --output-format=(table|JSON)
                           Output format
  -h, --help               Show this message and exit

The info command (chr deployment voterset info) shows the information about a voter set.

voterset update​

Usage: chr deployment voterset update [<options>]

  Propose an update of a voter set's members list

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  --secret=<path>          Path to secret file (pubkey/privkey)
  -vs, --voter-set=<text>  Name of existing voter set to update
  --threshold=<int>        New threshold
  --add-member=<value>     Provider pubkey(s) to add to voter set. Separate
                           keys with ','
  --remove-member=<value>  Provider pubkey(s) to remove from voter set.
                           Separate keys with ','
  --description=<text>     Proposal description
  -h, --help               Show this message and exit

With the update command (chr deployment voterset update), you can propose an update of a voter sets governor. New governor must be an existing voter set.

voterset list​

Usage: chr deployment voterset list [<options>]

  List all voter sets

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  -f, --output-format=(table|JSON)
                          Output format
  -c, --container=<text>  Specify the container to receive the voterset for, If
                          not set it will default to all votersets.
  -h, --help              Show this message and exit

The list command (chr deployment voterset list) lists all the voter sets.

voterset add-dapp-provider​

Usage: chr deployment voterset add-dapp-provider [<options>]

  Add a dapp provider to container

Configuration Properties:
  -cfg, --config=<config>    Alternate path for client configuration file
  -s, --settings=<settings>  Alternate path for project settings file

Deployment:

  Use a configured deployment network

  -d, --network=<text>  Specify which deployment target to use

Options:
  --secret=<path>              Path to secret file (pubkey/privkey)
  -a, --await / --no-await     Wait for transaction to be included in a block
  -pk, --pubkey=<text>         The public key of the dapp provider to be added
  -cid, --container-id=<text>  Container Identifier to add dapp provider too
  -h, --help                   Show this message and exit

The add-dapp-provider command (chr deployment voterset add-dapp-provider) adds a dapp provider to a container.