Bunga CLI tool

Bunga is a tool used for interacting with Daowabunga. Using dfx to do things like create proposals and recieve motion data is very difficult and sometimes not even possible because of the way motion data is encoded. Currently Bunga is only set up to interact with multisig canister but as the other canisters are released it will be modified to interact with them as well.

Getting started

Clone this repo and run

cargo install --path . && bunga

This will install and add the bunga path. Before interacting with a multsig canister you will also need to import your dfx identity and set your multisig canister principle. You will only have to do this once. If your dfx identity is encrypted Bunga will not ever save or store it any unencrpyted way but because of that you will have to enter your password everytime you run a command using that identity

You can set your multisig principal by running

bunga multisig set-id <PRINCIPAL

you can import your dfx identity by running

bunga import-identity <PATH TO .PEM FILE>

Dfx stores your pem files ~/.config/dfx/identity/IDENTITY-NAME the pem file will be named identity.pem or identity.pem.encrypted bunga can import either version.

Commands

When running any command you can pass --network=ic after bunga to interact with a canister on mainnet. If left out bunga will default to using a local network

bunga multisig create-txn

This command will start the flow to create a txn. No args are needed

bunga multisig get txns

Returns batch motions Optionally pass --status <STATUS> to recieve only motions of a certain status

USAGE:
    bunga multisig get txns [OPTIONS] [ARGS]

ARGS:
    <INDEX>    The index to start retrieving motions from. defaults to 0 [default: 0]
    <COUNT>    How many motions you want to recieve back. defaults to 10 [default: 10]

OPTIONS:
    -h, --help               Print help information
    -s, --status <STATUS>    Get only motions with a certian status [possible values: open,
                             executing, completed, failed, rejected]

bunga multisig get txn

Will return all info on the motion including the commands

USAGE:
    bunga multisig get txn <MOTION_ID>

ARGS:
    <MOTION_ID>    The id of the motion

OPTIONS:
    -h, --help    Print help information

bunga multisig get signers

Returns info about the signers of the multisig and their voting power

USAGE:
    bunga multisig get signers

OPTIONS:
    -h, --help    Print help information

bunga multisig get id

Returns the current set Principal id of the multisig

USAGE:
    bunga multisig get id

OPTIONS:
    -h, --help    Print help information

bunga multisig set-id

Sets or updates the principle id for your multisig. Required to run before interacting with multisig

USAGE:
    bunga multisig set-id <CANISTER_ID>

ARGS:
    <CANISTER_ID>    The principle id of the multisig canister

OPTIONS:
    -h, --help    Print help information

bunga multisig approve

Cast approval on a transaction

USAGE:
    bunga multisig approve <MOTION_ID>

ARGS:
    <MOTION_ID>    The id of the motion

OPTIONS:
    -h, --help    Print help information

bunga multisig reject

Cast a rejection on a transaction

USAGE:
    bunga multisig reject <MOTION_ID>

ARGS:
    <MOTION_ID>    The id of the motion

OPTIONS:
    -h, --help    Print help information

bunga import-identity

Import in an identity

USAGE:
    bunga import-identity <PEM_FILE_PATH>

ARGS:
    <PEM_FILE_PATH>    The path to the PEM file you want to import. This will typical be
                       './Users/<name>/.config/dfx/identity/default/identity.pem' the file name
                       may be identity.pem.encrypted as well make sure you spell out the whole
                       name

OPTIONS:
    -h, --help    Print help information