Skip to main content

celocli governance

Interact with on-chain governance proposals and hotfixes

celocli governance:approvehotfix

Approve a dequeued governance proposal (or hotfix)

USAGE
$ celocli governance:approvehotfix --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k
<value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--proposalID <value> | --hotfix <value>] [--useMultiSig | --useSafe]
[--type approver|securityCouncil ]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Approver's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--hotfix=<value>
Hash of hotfix proposal

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--proposalID=<value>
UUID of proposal to approve

--type=<option>
Determines which type of hotfix approval (approver or security council) to use.
<options: approver|securityCouncil>

--useLedger
Set it to use a ledger wallet

--useMultiSig
True means the request will be sent through multisig.

--useSafe
True means the request will be sent through safe.

DESCRIPTION
Approve a dequeued governance proposal (or hotfix)

ALIASES
$ celocli governance:approve
$ celocli governance:approvehotfix

EXAMPLES
approve --proposalID 99 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

approve --proposalID 99 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631 --useMultiSig

approve --hotfix 0xfcfc98ec3db7c56f0866a7149e811bf7f9e30c9d40008b0def497fcc6fe90649 --from 0xCc50EaC48bA71343dC76852FAE1892c6Bd2971DA --useMultiSig

approve --hotfix 0xfcfc98ec3db7c56f0866a7149e811bf7f9e30c9d40008b0def497fcc6fe90649 --from 0xCc50EaC48bA71343dC76852FAE1892c6Bd2971DA --useMultiSig --type securityCouncil

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

celocli governance:build-proposal

Interactively build a governance proposal

USAGE
$ celocli governance:build-proposal [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--output <value>] [--afterExecutingProposal <value> |
--afterExecutingID <value>]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--afterExecutingID=<value>
Governance proposal identifier which will be executed prior to proposal being built

--afterExecutingProposal=<value>
Path to proposal which will be executed prior to proposal being built

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--output=<value>
[default: proposalTransactions.json] Path to output

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Interactively build a governance proposal

EXAMPLES
build-proposal --output ./transactions.json

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/build-proposal.ts

celocli governance:dequeue

Try to dequeue governance proposal

USAGE
$ celocli governance:dequeue --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k
<value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) From address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Try to dequeue governance proposal

EXAMPLES
dequeue --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/dequeue.ts

celocli governance:execute

Execute a passing governance proposal

USAGE
$ celocli governance:execute --proposalID <value> --from
0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k <value> | --useLedger | ] [-n
<value>] [--gasCurrency 0x1234567890123456789012345678901234567890]
[--ledgerAddresses <value> ] [--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Executor's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--proposalID=<value>
(required) UUID of proposal to execute

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Execute a passing governance proposal

EXAMPLES
execute --proposalID 99 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/execute.ts

celocli governance:executehotfix

Execute a governance hotfix prepared for the current epoch

USAGE
$ celocli governance:executehotfix --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
--jsonTransactions <value> --salt <value> [-k <value> | --useLedger | ] [-n <value>]
[--gasCurrency 0x1234567890123456789012345678901234567890] [--ledgerAddresses
<value> ] [--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Executors's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--jsonTransactions=<value>
(required) Path to json transactions

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--salt=<value>
(required) Secret salt associated with hotfix

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Execute a governance hotfix prepared for the current epoch

EXAMPLES
executehotfix --jsonTransactions ./transactions.json --salt 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/executehotfix.ts

celocli governance:hashhotfix

Hash a governance hotfix specified by JSON and a salt

USAGE
$ celocli governance:hashhotfix --jsonTransactions <value> --salt <value> [-k <value> |
--useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--force]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--force
Skip execution check

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--jsonTransactions=<value>
(required) Path to json transactions of the hotfix

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--salt=<value>
(required) Secret salt associated with hotfix

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Hash a governance hotfix specified by JSON and a salt

EXAMPLES
hashhotfix --jsonTransactions ./transactions.json --salt 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/hashhotfix.ts

celocli governance:list

List live governance proposals (queued and ongoing)

USAGE
$ celocli governance:list [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--columns <value> | -x] [--filter <value>] [--no-header | [--csv |
--no-truncate]] [--output csv|json|yaml | | ] [--sort <value>]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

-x, --extended
show extra columns

--columns=<value>
only show provided columns (comma-separated)

--csv
output is csv format [alias: --output=csv]

--filter=<value>
filter property by partial string matching, ex: name=foo

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--no-header
hide table header from output

--no-truncate
do not truncate output to fit screen

--output=<option>
output in a more machine friendly format
<options: csv|json|yaml>

--sort=<value>
property to sort by (prepend '-' for descending)

--useLedger
Set it to use a ledger wallet

DESCRIPTION
List live governance proposals (queued and ongoing)

EXAMPLES
list

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/list.ts

celocli governance:preparehotfix

Prepare a governance hotfix for execution in the current epoch

USAGE
$ celocli governance:preparehotfix --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --hash
<value> [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Preparer's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--hash=<value>
(required) Hash of hotfix transactions

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Prepare a governance hotfix for execution in the current epoch

EXAMPLES
preparehotfix --hash 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/preparehotfix.ts

celocli governance:propose

Submit a governance proposal

USAGE
$ celocli governance:propose --jsonTransactions <value> --deposit <value> --from
0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --descriptionURL https://www.celo.org [-k
<value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--for 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --useMultiSig]
[--force] [--noInfo] [--afterExecutingProposal <value> | --afterExecutingID <value>]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--afterExecutingID=<value>
Governance proposal identifier which will be executed prior to proposal

--afterExecutingProposal=<value>
Path to proposal which will be executed prior to proposal

--deposit=<value>
(required) Amount of Celo to attach to proposal

--descriptionURL=https://www.celo.org
(required) A URL where further information about the proposal can be viewed

--for=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
Address of the multi-sig contract

--force
Skip execution check

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Proposer's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--jsonTransactions=<value>
(required) Path to json transactions

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--noInfo
Skip printing the proposal info

--useLedger
Set it to use a ledger wallet

--useMultiSig
True means the request will be sent through multisig.

DESCRIPTION
Submit a governance proposal

EXAMPLES
propose --jsonTransactions ./transactions.json --deposit 10000e18 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631 --descriptionURL https://gist.github.com/yorhodes/46430eacb8ed2f73f7bf79bef9d58a33

propose --jsonTransactions ./transactions.json --deposit 10000e18 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631 --useMultiSig --for 0x6c3dDFB1A9e73B5F49eDD46624F4954Bf66CAe93 --descriptionURL https://gist.github.com/yorhodes/46430eacb8ed2f73f7bf79bef9d58a33

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/propose.ts

celocli governance:revokeupvote

Revoke upvotes for queued governance proposals

USAGE
$ celocli governance:revokeupvote --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k
<value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Upvoter's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Revoke upvotes for queued governance proposals

EXAMPLES
revokeupvote --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/revokeupvote.ts

celocli governance:show

Show information about a governance proposal, hotfix, or account.

USAGE
$ celocli governance:show [-n <value>] [--globalHelp] [--raw] [--jsonTransactions
<value>] [--notwhitelisted] [--whitelisters | --nonwhitelisters | | [--proposalID
<value> | --account <value> | --hotfix <value>]] [--afterExecutingProposal <value> |
--afterExecutingID <value>]

FLAGS
-n, --node=<value> URL of the node to run commands against or an
alias
--account=<value> Address of account or voter
--afterExecutingID=<value> Governance proposal identifier which will be
executed prior to proposal
--afterExecutingProposal=<value> Path to proposal which will be executed prior to
proposal
--globalHelp View all available global flags
--hotfix=<value> Hash of hotfix proposal
--jsonTransactions=<value> Output proposal JSON to provided file
--nonwhitelisters If set, displays validators that have not
whitelisted the hotfix.(will be removed when L2
launches
--notwhitelisted List validators who have not whitelisted the
specified hotfix (will be removed when L2
launches
--proposalID=<value> UUID of proposal to view
--raw Display proposal in raw bytes format
--whitelisters If set, displays validators that have
whitelisted the hotfix.(will be removed when L2
launches

DESCRIPTION
Show information about a governance proposal, hotfix, or account.

ALIASES
$ celocli governance:show
$ celocli governance:showhotfix
$ celocli governance:showaccount
$ celocli governance:view
$ celocli governance:viewhotfix
$ celocli governance:viewaccount

EXAMPLES
show --proposalID 99

show --proposalID 99 --raw

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --whitelisters

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --nonwhitelisters

show --account 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/show.ts

celocli governance:showaccount

Show information about a governance proposal, hotfix, or account.

USAGE
$ celocli governance:showaccount [-n <value>] [--globalHelp] [--raw] [--jsonTransactions
<value>] [--notwhitelisted] [--whitelisters | --nonwhitelisters | | [--proposalID
<value> | --account <value> | --hotfix <value>]] [--afterExecutingProposal <value> |
--afterExecutingID <value>]

FLAGS
-n, --node=<value> URL of the node to run commands against or an
alias
--account=<value> Address of account or voter
--afterExecutingID=<value> Governance proposal identifier which will be
executed prior to proposal
--afterExecutingProposal=<value> Path to proposal which will be executed prior to
proposal
--globalHelp View all available global flags
--hotfix=<value> Hash of hotfix proposal
--jsonTransactions=<value> Output proposal JSON to provided file
--nonwhitelisters If set, displays validators that have not
whitelisted the hotfix.(will be removed when L2
launches
--notwhitelisted List validators who have not whitelisted the
specified hotfix (will be removed when L2
launches
--proposalID=<value> UUID of proposal to view
--raw Display proposal in raw bytes format
--whitelisters If set, displays validators that have
whitelisted the hotfix.(will be removed when L2
launches

DESCRIPTION
Show information about a governance proposal, hotfix, or account.

ALIASES
$ celocli governance:show
$ celocli governance:showhotfix
$ celocli governance:showaccount
$ celocli governance:view
$ celocli governance:viewhotfix
$ celocli governance:viewaccount

EXAMPLES
show --proposalID 99

show --proposalID 99 --raw

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --whitelisters

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --nonwhitelisters

show --account 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

celocli governance:showhotfix

Show information about a governance proposal, hotfix, or account.

USAGE
$ celocli governance:showhotfix [-n <value>] [--globalHelp] [--raw] [--jsonTransactions
<value>] [--notwhitelisted] [--whitelisters | --nonwhitelisters | | [--proposalID
<value> | --account <value> | --hotfix <value>]] [--afterExecutingProposal <value> |
--afterExecutingID <value>]

FLAGS
-n, --node=<value> URL of the node to run commands against or an
alias
--account=<value> Address of account or voter
--afterExecutingID=<value> Governance proposal identifier which will be
executed prior to proposal
--afterExecutingProposal=<value> Path to proposal which will be executed prior to
proposal
--globalHelp View all available global flags
--hotfix=<value> Hash of hotfix proposal
--jsonTransactions=<value> Output proposal JSON to provided file
--nonwhitelisters If set, displays validators that have not
whitelisted the hotfix.(will be removed when L2
launches
--notwhitelisted List validators who have not whitelisted the
specified hotfix (will be removed when L2
launches
--proposalID=<value> UUID of proposal to view
--raw Display proposal in raw bytes format
--whitelisters If set, displays validators that have
whitelisted the hotfix.(will be removed when L2
launches

DESCRIPTION
Show information about a governance proposal, hotfix, or account.

ALIASES
$ celocli governance:show
$ celocli governance:showhotfix
$ celocli governance:showaccount
$ celocli governance:view
$ celocli governance:viewhotfix
$ celocli governance:viewaccount

EXAMPLES
show --proposalID 99

show --proposalID 99 --raw

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --whitelisters

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --nonwhitelisters

show --account 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

celocli governance:upvote

Upvote a queued governance proposal

USAGE
$ celocli governance:upvote --proposalID <value> --from
0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k <value> | --useLedger | ] [-n
<value>] [--gasCurrency 0x1234567890123456789012345678901234567890]
[--ledgerAddresses <value> ] [--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Upvoter's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--proposalID=<value>
(required) UUID of proposal to upvote

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Upvote a queued governance proposal

EXAMPLES
upvote --proposalID 99 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/upvote.ts

celocli governance:view

Show information about a governance proposal, hotfix, or account.

USAGE
$ celocli governance:view [-n <value>] [--globalHelp] [--raw] [--jsonTransactions
<value>] [--notwhitelisted] [--whitelisters | --nonwhitelisters | | [--proposalID
<value> | --account <value> | --hotfix <value>]] [--afterExecutingProposal <value> |
--afterExecutingID <value>]

FLAGS
-n, --node=<value> URL of the node to run commands against or an
alias
--account=<value> Address of account or voter
--afterExecutingID=<value> Governance proposal identifier which will be
executed prior to proposal
--afterExecutingProposal=<value> Path to proposal which will be executed prior to
proposal
--globalHelp View all available global flags
--hotfix=<value> Hash of hotfix proposal
--jsonTransactions=<value> Output proposal JSON to provided file
--nonwhitelisters If set, displays validators that have not
whitelisted the hotfix.(will be removed when L2
launches
--notwhitelisted List validators who have not whitelisted the
specified hotfix (will be removed when L2
launches
--proposalID=<value> UUID of proposal to view
--raw Display proposal in raw bytes format
--whitelisters If set, displays validators that have
whitelisted the hotfix.(will be removed when L2
launches

DESCRIPTION
Show information about a governance proposal, hotfix, or account.

ALIASES
$ celocli governance:show
$ celocli governance:showhotfix
$ celocli governance:showaccount
$ celocli governance:view
$ celocli governance:viewhotfix
$ celocli governance:viewaccount

EXAMPLES
show --proposalID 99

show --proposalID 99 --raw

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --whitelisters

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --nonwhitelisters

show --account 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

celocli governance:viewaccount

Show information about a governance proposal, hotfix, or account.

USAGE
$ celocli governance:viewaccount [-n <value>] [--globalHelp] [--raw] [--jsonTransactions
<value>] [--notwhitelisted] [--whitelisters | --nonwhitelisters | | [--proposalID
<value> | --account <value> | --hotfix <value>]] [--afterExecutingProposal <value> |
--afterExecutingID <value>]

FLAGS
-n, --node=<value> URL of the node to run commands against or an
alias
--account=<value> Address of account or voter
--afterExecutingID=<value> Governance proposal identifier which will be
executed prior to proposal
--afterExecutingProposal=<value> Path to proposal which will be executed prior to
proposal
--globalHelp View all available global flags
--hotfix=<value> Hash of hotfix proposal
--jsonTransactions=<value> Output proposal JSON to provided file
--nonwhitelisters If set, displays validators that have not
whitelisted the hotfix.(will be removed when L2
launches
--notwhitelisted List validators who have not whitelisted the
specified hotfix (will be removed when L2
launches
--proposalID=<value> UUID of proposal to view
--raw Display proposal in raw bytes format
--whitelisters If set, displays validators that have
whitelisted the hotfix.(will be removed when L2
launches

DESCRIPTION
Show information about a governance proposal, hotfix, or account.

ALIASES
$ celocli governance:show
$ celocli governance:showhotfix
$ celocli governance:showaccount
$ celocli governance:view
$ celocli governance:viewhotfix
$ celocli governance:viewaccount

EXAMPLES
show --proposalID 99

show --proposalID 99 --raw

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --whitelisters

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --nonwhitelisters

show --account 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

celocli governance:viewhotfix

Show information about a governance proposal, hotfix, or account.

USAGE
$ celocli governance:viewhotfix [-n <value>] [--globalHelp] [--raw] [--jsonTransactions
<value>] [--notwhitelisted] [--whitelisters | --nonwhitelisters | | [--proposalID
<value> | --account <value> | --hotfix <value>]] [--afterExecutingProposal <value> |
--afterExecutingID <value>]

FLAGS
-n, --node=<value> URL of the node to run commands against or an
alias
--account=<value> Address of account or voter
--afterExecutingID=<value> Governance proposal identifier which will be
executed prior to proposal
--afterExecutingProposal=<value> Path to proposal which will be executed prior to
proposal
--globalHelp View all available global flags
--hotfix=<value> Hash of hotfix proposal
--jsonTransactions=<value> Output proposal JSON to provided file
--nonwhitelisters If set, displays validators that have not
whitelisted the hotfix.(will be removed when L2
launches
--notwhitelisted List validators who have not whitelisted the
specified hotfix (will be removed when L2
launches
--proposalID=<value> UUID of proposal to view
--raw Display proposal in raw bytes format
--whitelisters If set, displays validators that have
whitelisted the hotfix.(will be removed when L2
launches

DESCRIPTION
Show information about a governance proposal, hotfix, or account.

ALIASES
$ celocli governance:show
$ celocli governance:showhotfix
$ celocli governance:showaccount
$ celocli governance:view
$ celocli governance:viewhotfix
$ celocli governance:viewaccount

EXAMPLES
show --proposalID 99

show --proposalID 99 --raw

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --whitelisters

show --hotfix 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --nonwhitelisters

show --account 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

celocli governance:vote

Vote on an approved governance proposal

USAGE
$ celocli governance:vote --proposalID <value> --value Abstain|No|Yes --from
0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k <value> | --useLedger | ] [-n
<value>] [--gasCurrency 0x1234567890123456789012345678901234567890]
[--ledgerAddresses <value> ] [--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Voter's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--proposalID=<value>
(required) UUID of proposal to vote on

--useLedger
Set it to use a ledger wallet

--value=<option>
(required) Vote
<options: Abstain|No|Yes>

DESCRIPTION
Vote on an approved governance proposal

EXAMPLES
vote --proposalID 99 --value Yes --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/vote.ts

celocli governance:votePartially

Vote partially on an approved governance proposal

USAGE
$ celocli governance:votePartially --proposalID <value> --from
0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k <value> | --useLedger | ] [-n
<value>] [--gasCurrency 0x1234567890123456789012345678901234567890]
[--ledgerAddresses <value> ] [--globalHelp] [--yes <value>] [--no <value>]
[--abstain <value>]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--abstain=<value>
Abstain votes

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Voter's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--no=<value>
No votes

--proposalID=<value>
(required) UUID of proposal to vote on

--useLedger
Set it to use a ledger wallet

--yes=<value>
Yes votes

DESCRIPTION
Vote partially on an approved governance proposal

EXAMPLES
vote-partially --proposalID 99 --yes 10 --no 20 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/votePartially.ts

celocli governance:whitelisthotfix

Whitelist a governance hotfix

USAGE
$ celocli governance:whitelisthotfix --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --hash
<value> [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Whitelister's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--hash=<value>
(required) Hash of hotfix transactions

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Whitelist a governance hotfix

EXAMPLES
whitelisthotfix --hash 0x614dccb5ac13cba47c2430bdee7829bb8c8f3603a8ace22e7680d317b39e3658 --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/whitelisthotfix.ts

celocli governance:withdraw

Withdraw refunded governance proposal deposits.

USAGE
$ celocli governance:withdraw --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d [-k
<value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) Proposer's address

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Withdraw refunded governance proposal deposits.

EXAMPLES
withdraw --from 0x5409ed021d9299bf6814279a6a1411a7e866a631

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/governance/withdraw.ts