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-token-chain    Create and initialize token chain. Please run the│
│                            command without supplying the configuration to   │
│                            only run initialize operation.                   │
│  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-evm-event-receiver-token-chain                                  │
│                            Create and initialize EVM event receiver token   │
│                            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.

╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --lookup-brid          Ignore any 'brid' property in configuration file,   │
│                         always perform lookup                               │
│  -cfg, --config=CONFIG  Alternate path for client configuration file        │
│  -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))                                     │
│  -tcc, --token-chain-config=PATH                                            │
│                         Configuration file for token 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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ 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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ 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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ 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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ 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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ 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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --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                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --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.