List community RPC nodes

.github/pull_request_template.md

@@ -10,6 +10,11 @@ _Describe any minor or "drive-by" changes here. If none delete this section_
 
 _An explanation of how the changes were tested or an explanation as to why they don't need to be._
 
+
+### How to QA
+
+_List of steps required to QA the change if applicable_
+
 ### Related issues
 
 - Fixes #[issue number here]

docs/command-line-interface/network.md

@@ -3,11 +3,95 @@
 
 View details about the network, like contracts and parameters
 
+* [`celocli network:community-rpc-nodes`](#celocli-networkcommunity-rpc-nodes)
 * [`celocli network:contracts`](#celocli-networkcontracts)
 * [`celocli network:info`](#celocli-networkinfo)
 * [`celocli network:parameters`](#celocli-networkparameters)
+* [`celocli network:rpc-urls`](#celocli-networkrpc-urls)
 * [`celocli network:whitelist`](#celocli-networkwhitelist)
 
+## `celocli network:community-rpc-nodes`
+
+Displays a list of community RPC nodes for the currently elected validator groups
+
+```
+USAGE
+  $ celocli network:community-rpc-nodes [-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>] [--all]
+
+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
+
+  --all
+      Display all community RPC nodes, not just the ones from currently elected validator
+      groups
+
+  --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
+  Displays a list of community RPC nodes for the currently elected validator groups
+
+ALIASES
+  $ celocli network:rpc-urls
+  $ celocli validator:rpc-urls
+  $ celocli network:community-rpc-nodes
+  $ celocli validator:community-rpc-nodes
+  $ celocli validatorgroup:community-rpc-nodes
+
+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 network:contracts`
 
 Lists Celo core contracts and their addresses.
@@ -106,6 +190,88 @@ FLAG DESCRIPTIONS
 
 _See code: [src/commands/network/parameters.ts](https://github.com/celo-org/developer-tooling/tree/master/packages/cli/src/commands/network/parameters.ts)_
 
+## `celocli network:rpc-urls`
+
+Displays a list of community RPC nodes for the currently elected validator groups
+
+```
+USAGE
+  $ celocli network:rpc-urls [-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>] [--all]
+
+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
+
+  --all
+      Display all community RPC nodes, not just the ones from currently elected validator
+      groups
+
+  --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
+  Displays a list of community RPC nodes for the currently elected validator groups
+
+ALIASES
+  $ celocli network:rpc-urls
+  $ celocli validator:rpc-urls
+  $ celocli network:community-rpc-nodes
+  $ celocli validator:community-rpc-nodes
+  $ celocli validatorgroup:community-rpc-nodes
+
+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 network:whitelist`
 
 List the whitelisted fee currencies

docs/command-line-interface/validator.md

@@ -4,12 +4,14 @@
 View and manage Validators
 
 * [`celocli validator:affiliate ARG1`](#celocli-validatoraffiliate-arg1)
+* [`celocli validator:community-rpc-nodes`](#celocli-validatorcommunity-rpc-nodes)
 * [`celocli validator:deaffiliate`](#celocli-validatordeaffiliate)
 * [`celocli validator:deregister`](#celocli-validatorderegister)
 * [`celocli validator:downtime-slash`](#celocli-validatordowntime-slash)
 * [`celocli validator:list`](#celocli-validatorlist)
 * [`celocli validator:register`](#celocli-validatorregister)
 * [`celocli validator:requirements`](#celocli-validatorrequirements)
+* [`celocli validator:rpc-urls`](#celocli-validatorrpc-urls)
 * [`celocli validator:set-bitmaps`](#celocli-validatorset-bitmaps)
 * [`celocli validator:show ARG1`](#celocli-validatorshow-arg1)
 * [`celocli validator:signed-blocks`](#celocli-validatorsigned-blocks)
@@ -79,6 +81,88 @@ FLAG DESCRIPTIONS
 
 _See code: [src/commands/validator/affiliate.ts](https://github.com/celo-org/developer-tooling/tree/master/packages/cli/src/commands/validator/affiliate.ts)_
 
+## `celocli validator:community-rpc-nodes`
+
+Displays a list of community RPC nodes for the currently elected validator groups
+
+```
+USAGE
+  $ celocli validator:community-rpc-nodes [-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>] [--all]
+
+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
+
+  --all
+      Display all community RPC nodes, not just the ones from currently elected validator
+      groups
+
+  --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
+  Displays a list of community RPC nodes for the currently elected validator groups
+
+ALIASES
+  $ celocli network:rpc-urls
+  $ celocli validator:rpc-urls
+  $ celocli network:community-rpc-nodes
+  $ celocli validator:community-rpc-nodes
+  $ celocli validatorgroup:community-rpc-nodes
+
+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 validator:deaffiliate`
 
 Deaffiliate a Validator from a Validator Group, and remove it from the Group if it is also a member.
@@ -426,6 +510,88 @@ FLAG DESCRIPTIONS
 
 _See code: [src/commands/validator/requirements.ts](https://github.com/celo-org/developer-tooling/tree/master/packages/cli/src/commands/validator/requirements.ts)_
 
+## `celocli validator:rpc-urls`
+
+Displays a list of community RPC nodes for the currently elected validator groups
+
+```
+USAGE
+  $ celocli validator:rpc-urls [-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>] [--all]
+
+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
+
+  --all
+      Display all community RPC nodes, not just the ones from currently elected validator
+      groups
+
+  --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
+  Displays a list of community RPC nodes for the currently elected validator groups
+
+ALIASES
+  $ celocli network:rpc-urls
+  $ celocli validator:rpc-urls
+  $ celocli network:community-rpc-nodes
+  $ celocli validator:community-rpc-nodes
+  $ celocli validatorgroup:community-rpc-nodes
+
+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 validator:set-bitmaps`
 
 Set validator signature bitmaps for provided intervals