Skip to main content

network

Usage: pmc network [OPTIONS] COMMAND [ARGS]...

Commands relating to the network as a whole

╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────╮
│ initialize Create system cluster with naked system container│
for the directory blockchain. Module argument │
│ initial_provider becomes first member of SYSTEM_P│
│ voter set. │
│ initialize-economy-chain Create and initialize economy chain. Please run │
│ the command without supplying the configuration │
│ to retry a failed initialization. │
│ initialize-evm-transaction-submitter-chain │
│ Create and initialize EVM transaction submitter │
│ chain │
│ initialize-evm-event-receiver-chain │
│ Create and initialize EVM event receiver chain │
│ initialize-evm-event-receiver-price-oracle-chain │
│ Create and initialize EVM event receiver price │
│ oracle chain │
│ initialize-price-oracle-chain │
│ Create and initialize Price oracle chain │
│ summary Show summary of the network │
│ version Shows network version │
│ verify Verify that all nodes are accessible │
╰─────────────────────────────────────────────────────────────────────────────╯

The network command (pmc network) consists of sub-commands that initialize a network and show a summary or version of an existing network.

network initialize

Usage: pmc network initialize [OPTIONS]

Create system cluster with naked system container for the directory
blockchain. Module argument initial_provider becomes first member of SYSTEM_P
voter set.

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -sac, --system-anchoring-config=PATH
│ Configuration file for system anchoring chain (GtvML (*.xml) or│
│ Gtv (*.gtv))
│ -cac, --cluster-anchoring-config=PATH
│ Configuration file for cluster anchoring chain (GtvML (*.xml)
│ or Gtv (*.gtv))
│ -ecc, --economy-chain-config=PATH
│ Configuration file for economy chain (GtvML (*.xml) or Gtv │
(*.gtv))
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The initialize command (pmc network initialize) creates a system cluster. The system cluster has a naked system container for the directory blockchain.

network initialize-economy-chain

Usage: pmc network initialize-economy-chain [OPTIONS]

Create and initialize economy chain. Please run the command without supplying
the configuration to retry a failed initialization.

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -ecc, --economy-chain-config=PATH
│ Configuration file for economy chain (GtvML (*.xml) or Gtv │
(*.gtv))
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The initialize-economy-chain command (pmc network initialize-economy-chain) creates and initializes the economy chain.

network initialize-evm-transaction-submitter-chain

Usage: pmc network initialize-evm-transaction-submitter-chain [OPTIONS]

Create and initialize EVM transaction submitter chain

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -tsc, --transaction-submitter-config=PATH
│ Configuration file for EVM transaction submitter chain (GtvML │
(*.xml) or Gtv (*.gtv))
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The network initialize-evm-transaction-submitter-chain command (pmc network initialize-evm-transaction-submitter-chain) creates and initializes the EVM transaction submitter chain.

network initialize-evm-event-receiver-chain

Usage: pmc network initialize-evm-event-receiver-chain [OPTIONS]

Create and initialize EVM event receiver chain

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -erc, --event-receiver-config=PATH
│ Configuration file for EVM event receiver chain (GtvML (*.xml)
│ or Gtv (*.gtv))
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The network initialize-evm-event-receiver-chain command (pmc network initialize-evm-event-receiver-chain) creates and initializes the EVM event receiver chain.

network initialize-evm-event-receiver-price-oracle-chain

Usage: pmc network initialize-evm-event-receiver-price-oracle-chain [OPTIONS]

Create and initialize EVM event receiver price oracle chain

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -erc, --event-receiver-config=PATH
│ Configuration file for EVM event receiver price oracle chain │
(GtvML (*.xml) or Gtv (*.gtv))
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The network initialize-evm-event-receiver-price-oracle-chain command (pmc network initialize-evm-event-receiver-price-oracle-chain) creates and initializes EVM event receiver price oracle chain.

network initialize-price-oracle-chain

Usage: pmc network initialize-price-oracle-chain [OPTIONS]

Create and initialize Price oracle chain

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -poc, --price-oracle-config=PATH
│ Configuration file for Price oracle chain (GtvML (*.xml) or Gtv│
(*.gtv))
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The network initialize-price-oracle-chain command (pmc network initialize-price-oracle-chain) creates and initializes the Price oracle chain.

network summary

Usage: pmc network summary [OPTIONS]

Show summary of the network

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The summary command (pmc network summary) shows the summary of the network.

network version

Usage: pmc network version [OPTIONS]

Shows network version

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The version command (pmc network version) shows the version of D1 running on a network.

network verify

Usage: pmc network verify [OPTIONS]

Verify that all nodes are accessible

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│ --show-progress Show which node is currently being verified │
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The verify command (pmc network verify) verifies whether all the nodes within the network are accessible. Optionally, the --show-progress flag can be used to display which node is currently being verified.