diff --git a/docs/website/blog/2026-01-06-dmq-testing-program.md b/docs/website/blog/2026-01-06-dmq-testing-program.md index 840e72ba36e..98dc69884e6 100644 --- a/docs/website/blog/2026-01-06-dmq-testing-program.md +++ b/docs/website/blog/2026-01-06-dmq-testing-program.md @@ -9,7 +9,9 @@ tags: [DMQ, decentralization, testing program] :::info[Update 2026/08/04] -With the release of the [`2630.0`](https://github.com/input-output-hk/mithril/releases/tag/2630.0) distribution, the DMQ node has been upgraded to its first **stable beta release** version `0.7.0.0` on the `release-mainnet` and `release-preprod` networks. +The testing program with SPOs has been successfully completed, and the DMQ node is now officially supported in **beta** on the release networks. The Mithril team thanks all participating SPOs for their valuable feedback and contributions to this milestone. + +See update about the DMQ node beta release on the release networks in this [post](https://mithril.network/doc/dev-blog/2026/08/04/dmq-beta-release). ::: @@ -51,12 +53,12 @@ The rollout plan of the DMQ network is the following: - [x] **Distribution [2603](https://github.com/input-output-hk/mithril/releases/tag/2603.1)**: `unstable` on the `pre-release-preview` network - [x] DMQ activation on the `pre-release-preview` network - - [x] Released a [guide](https://mithril.network/doc/manual/operate/run-signer-node/#set-up-the-dmq-node-unstable) for setting up a DMQ node in the SPO infrastructure + - [x] Released a [guide](https://mithril.network/doc/manual/operate/run-signer-node/#set-up-the-dmq-node-beta) for setting up a DMQ node in the SPO infrastructure - [x] 4-6 weeks testing program with selected SPOs - [x] **Distribution [2617](https://github.com/input-output-hk/mithril/releases/tag/2617.0)**: `unstable` on the `pre-release-preview` network (extended testing) - [x] Upgraded the DMQ node to version `0.4.2.0` on the `pre-release-preview` network - [x] 4-6 weeks extended testing program with selected SPOs -- [x] **Distribution [2630](https://github.com/input-output-hk/mithril/releases/tag/2630.0)**: `stable` on the `release-preprod` and `release-mainnet` networks with fallback +- [x] **Distribution [2630](https://github.com/input-output-hk/mithril/releases/tag/2630.0)**: `beta` on the `release-preprod` and `release-mainnet` networks with fallback - [x] DMQ activation on the `release-preprod` and `release-mainnet` networks - [x] Activation of the fallback to the legacy signature registration mechanism for all SPOs - [x] Release of an updated guide for setting up a DMQ node in the SPO infrastructure diff --git a/docs/website/blog/2026-01-06-multiple-aggregators-testing-program.md b/docs/website/blog/2026-01-06-multiple-aggregators-testing-program.md index 6089dc5bcbc..ff73dc71b29 100644 --- a/docs/website/blog/2026-01-06-multiple-aggregators-testing-program.md +++ b/docs/website/blog/2026-01-06-multiple-aggregators-testing-program.md @@ -7,6 +7,12 @@ tags: [DMQ, decentralization, testing program, aggregator, follower] ### Multiple aggregators testing program +:::info[Update 2026/08/04] + +The DMQ node is now officially supported in **beta** on the `release-mainnet` and `release-preprod` networks (see this [post](https://mithril.network/doc/dev-blog/2026/08/04/dmq-beta-release)). Running multiple aggregators remains in testing on the `pre-release-preview` network until the DMQ network adoption reaches the required threshold on the release networks. + +::: + :::info[Update 2026/04/28] With the release of the [`2617.0`](https://github.com/input-output-hk/mithril/releases/tag/2617.0) distribution, the testing program for running multiple aggregators is extended on the `pre-release-preview` network to keep gathering feedback before the stable release on `release-preprod` and `release-mainnet` networks. @@ -60,7 +66,7 @@ The Mithril team will provide dedicated support and guidance to help participant #### Rollout plan -The rollout plan of the DMQ network is the following: +The rollout plan of the multiple aggregators feature is the following: - [x] **Distribution [2603](https://github.com/input-output-hk/mithril/releases/tag/2603.1)**: `unstable` on the `pre-release-preview` network - [x] Activation of the feature on the `pre-release-preview` network @@ -69,7 +75,7 @@ The rollout plan of the DMQ network is the following: - [x] 4-6 weeks testing program with selected participants - [x] **Distribution [2617](https://github.com/input-output-hk/mithril/releases/tag/2617.0)**: `unstable` on the `pre-release-preview` network (extended testing) - [x] 4-6 weeks extended testing program with selected SPOs -- [ ] **Distribution +3**: `stable` on the `release-preprod` and `release-mainnet` networks +- [ ] **Distribution +4**: `stable` on the `release-preprod` and `release-mainnet` networks - [ ] Activation of the feature on the `release-preprod` and `release-mainnet` networks - [ ] Release of an updated guide for setting up a follower aggregator - [ ] Monitoring and support for operators running follower aggregators. diff --git a/docs/website/blog/2026-08-03-distribution-2630.md b/docs/website/blog/2026-08-03-distribution-2630.md index 1a026fb2ad9..789865f4d57 100644 --- a/docs/website/blog/2026-08-03-distribution-2630.md +++ b/docs/website/blog/2026-08-03-distribution-2630.md @@ -10,7 +10,7 @@ tags: [release, distribution, 2630] The [`2630.0`](https://github.com/IntersectMBO/mithril/releases/tag/2630.0) distribution has been released, introducing the following changes: - **Breaking Changes**: Removed support for the `CardanoImmutableFilesFull` certificate type in the Mithril signer and aggregator. Use `CardanoDatabase` (also known as Cardano database v2) instead -- **DMQ network**: Promoted the DMQ node as stable (beta) on `release-mainnet` and `release-preprod` networks +- **DMQ network**: Promoted the DMQ node to **beta** on `release-mainnet` and `release-preprod` networks - **Cardano Blocks and Transactions**: Activation of the testing phase on the `pre-release-preview` and `release-preprod` networks - **Maintenance**: Bug fixes and performance improvements. diff --git a/docs/website/blog/2026-08-04-dmq-beta-release.md b/docs/website/blog/2026-08-04-dmq-beta-release.md index 88ff6fce1f5..97480d10a41 100644 --- a/docs/website/blog/2026-08-04-dmq-beta-release.md +++ b/docs/website/blog/2026-08-04-dmq-beta-release.md @@ -9,7 +9,7 @@ tags: [DMQ, decentralization, beta, release, distribution, 2630] We are happy to announce that the **Decentralized Message Queue (DMQ)** node is now officially supported in **beta** on the `release-mainnet` and `release-preprod` networks. This milestone follows the [DMQ testing program with SPOs](https://mithril.network/doc/dev-blog/2026/01/06/dmq-testing-program) conducted on the `pre-release-preview` network, and would not have been possible without the feedback of the participating stake pool operators (SPOs). -With the [`2630.0`](https://github.com/IntersectMBO/mithril/releases/tag/2630.0) distribution, the DMQ node version `0.7.0.0` has been promoted as **stable (beta)**, and the DMQ network is activated on both release networks. +With the [`2630.0`](https://github.com/IntersectMBO/mithril/releases/tag/2630.0) distribution, the DMQ node version `0.7.0.0` has been promoted as **beta**, and the DMQ network is activated on both release networks. #### All SPOs should now run a DMQ node diff --git a/docs/website/root/manual/operate/run-aggregator-node.md b/docs/website/root/manual/operate/run-aggregator-node.md index 09398dd705a..0a5f1ff6216 100644 --- a/docs/website/root/manual/operate/run-aggregator-node.md +++ b/docs/website/root/manual/operate/run-aggregator-node.md @@ -8,7 +8,7 @@ import CompiledBinaries from '../../compiled-binaries.mdx' :::danger -Running multiple Mithril aggregators on a Mithril network is enabled by the DMQ protocol, which is currently **unstable** and not suitable for production use. +Running multiple Mithril aggregators on a Mithril network relies on the DMQ protocol, which is currently in **beta**. Until the DMQ network adoption reaches the required threshold, follower aggregators may not be able to produce valid certificates, and this setup is not suitable for production use. ::: @@ -110,10 +110,10 @@ You can also fetch the minimum supported version for your network using the comm wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."**YOUR_CARDANO_NETWORK**"."cardano-minimum-version"."mithril-aggregator"' ``` -Here is an example for `preprod`: +Here is an example for `mainnet`: ```bash -wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."preprod"."cardano-minimum-version"."mithril-aggregator"' +wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."mainnet"."cardano-minimum-version"."mithril-aggregator"' ``` ::: @@ -265,7 +265,7 @@ The configuration values for the `/opt/mithril/mithril-aggregator.env` file are - `NETWORK`: Cardano network name (eg, `mainnet`, `preprod`, or `preview`) - `NETWORK_MAGIC`: Cardano network magic number (required only if not using `mainnet`, `preprod` or `preview`) - `CARDANO_NODE_SOCKET_PATH`: Path to the IPC file of the Cardano node -- `CARDANO_NODE_VERSION`: Version of the Cardano node running (eg, `10.5.0`) +- `CARDANO_NODE_VERSION`: Version of the Cardano node running (eg, `10.7.1`) - `CHAIN_OBSERVER_TYPE`: Type of chain observer (default: `pallas`) - `ERA_READER_ADAPTER_TYPE`: Type of era reader adapter to use (default: `bootstrap`, use `cardano-chain` for production networks as specified in [Network configurations](../getting-started/network-configurations.md)) - `ERA_READER_ADAPTER_PARAMS`: JSON encoded parameters for the era reader adapter. For `cardano-chain` type, compute using: `jq -nc --arg address $(wget -q -O - **YOUR_ERA_READER_ADDRESS**) --arg verification_key $(wget -q -O - **YOUR_ERA_READER_VERIFICATION_KEY**) '{"address": $address, "verification_key": $verification_key}'` (URLs can be found in the [Network configurations](../getting-started/network-configurations.md)) @@ -275,7 +275,7 @@ The configuration values for the `/opt/mithril/mithril-aggregator.env` file are - **Base configuration** **optional** values are: - - `BLOCKFROST_PARAMETERS`: Parameters to connect to the Blockfrost API. Used to fetch the ticker and name of the registered stake pools. Example: `{"project_id":"preprodWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` + - `BLOCKFROST_PARAMETERS`: Parameters to connect to the Blockfrost API. Used to fetch the ticker and name of the registered stake pools. Example: `{"project_id":"mainnetWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` - `SIGNER_IMPORTER_RUN_INTERVAL`: Time interval at which the pools names and ticker in blockfrost will be imported (in minutes, default: `720`). - The **Cardano database** configuration values are (only needed if supporting Cardano database certification): @@ -300,31 +300,31 @@ The configuration values for the `/opt/mithril/mithril-aggregator.env` file are :::tip -Here is an **example** set of values for **release-preprod** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **Base configuration**: - **SIGNED_ENTITY_TYPES**: `MithrilStakeDistribution,CardanoStakeDistribution,CardanoTransactions` (only supporting stake distributions and transactions, excluding database snapshots) - **SERVER_PORT**: `8080` - **PUBLIC_SERVER_URL**: `https://aggregator.example.com/aggregator` - - **LEADER_AGGREGATOR_ENDPOINT**: `https://aggregator.release-preprod.api.mithril.network/aggregator` + - **LEADER_AGGREGATOR_ENDPOINT**: `https://aggregator.release-mainnet.api.mithril.network/aggregator` - **RUN_INTERVAL**: `60000` - **AGGREGATE_SIGNATURE_TYPE**: `Concatenation` - **STORE_RETENTION_LIMIT**: `5` - - **NETWORK**: `preprod` - - **NETWORK_MAGIC**: `1` + - **NETWORK**: `mainnet` + - **NETWORK_MAGIC**: `764824073` - **CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` - - **CARDANO_NODE_VERSION**: `10.5.0` + - **CARDANO_NODE_VERSION**: `10.7.1` - **CHAIN_OBSERVER_TYPE**: `pallas` - **ERA_READER_ADAPTER_TYPE**: `cardano-chain` - - **ERA_READER_ADAPTER_PARAMS**: `$(jq -nc --arg address $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-preprod/era.addr) --arg verification_key $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-preprod/era.vkey) '{"address": $address, "verification_key": $verification_key}')` - - **GENESIS_VERIFICATION_KEY**: `$(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-preprod/genesis.vkey)` + - **ERA_READER_ADAPTER_PARAMS**: `$(jq -nc --arg address $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-mainnet/era.addr) --arg verification_key $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-mainnet/era.vkey) '{"address": $address, "verification_key": $verification_key}')` + - **GENESIS_VERIFICATION_KEY**: `$(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-mainnet/genesis.vkey)` - **DMQ_NODE_SOCKET_PATH**: `/dmq/ipc/node.socket` - **CUSTOM_ORIGIN_TAG_WHITE_LIST**: `EXPLORER,BENCHMARK,CI,NA` - **Optional configuration**: - - **BLOCKFROST_PARAMETERS**: `{"project_id":"preprodWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` + - **BLOCKFROST_PARAMETERS**: `{"project_id":"mainnetWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` - **SIGNER_IMPORTER_RUN_INTERVAL**: 720 - **Cardano database configuration**: @@ -413,7 +413,7 @@ EOF` :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /opt/mithril/mithril-aggregator.env << EOF @@ -421,17 +421,17 @@ sudo bash -c 'cat > /opt/mithril/mithril-aggregator.env << EOF SIGNED_ENTITY_TYPES=MithrilStakeDistribution,CardanoStakeDistribution,CardanoTransactions SERVER_PORT=8080 PUBLIC_SERVER_URL=https://aggregator.example.com/aggregator -LEADER_AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator +LEADER_AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator RUN_INTERVAL=60000 AGGREGATE_SIGNATURE_TYPE=Concatenation STORE_RETENTION_LIMIT=5 -NETWORK=preprod -NETWORK_MAGIC=1 +NETWORK=mainnet +NETWORK_MAGIC=764824073 CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket -CARDANO_NODE_VERSION=10.5.0 +CARDANO_NODE_VERSION=10.7.1 CHAIN_OBSERVER_TYPE=pallas ERA_READER_ADAPTER_TYPE=cardano-chain -ERA_READER_ADAPTER_PARAMS={"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"} +ERA_READER_ADAPTER_PARAMS={"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"} DMQ_NODE_SOCKET_PATH=/dmq/ipc/node.socket CUSTOM_ORIGIN_TAG_WHITE_LIST=EXPLORER,BENCHMARK,CI,NA EOF' @@ -442,7 +442,7 @@ If you want to configure **Optional** parameters, append the following variables ```bash sudo bash -c 'cat >> /opt/mithril/mithril-aggregator.env << EOF # Optional configuration -BLOCKFROST_PARAMETERS={"project_id":"preprodWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"} +BLOCKFROST_PARAMETERS={"project_id":"mainnetWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"} SIGNER_IMPORTER_RUN_INTERVAL=720 EOF' ``` @@ -939,17 +939,17 @@ The DMQ node supports the implementation of a **Decentralized Message Queue** (D :::tip -Here is an **example** set of values for **pre-release-preview** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **YOUR_DMQ_NODE_SOCKET_PATH**: `/dmq/ipc/node.socket` - **YOUR_CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` - **YOUR_CARDANO_SHELLEY_GENESIS_FILE_PATH**: `/cardano/config/shelley-genesis.json` -- **YOUR_CARDANO_NETWORK_MAGIC**: `2` -- **YOUR_DMQ_NETWORK_MAGIC**: `2147483650` +- **YOUR_CARDANO_NETWORK_MAGIC**: `764824073` +- **YOUR_DMQ_NETWORK_MAGIC**: `2912307721` - **YOUR_DMQ_NODE_PUBLIC_ADDRESS**: `34.14.65.160` - **YOUR_DMQ_NODE_PORT**: `6161` -- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `34.76.22.193` -- **YOUR_DMQ_BOOTSTRAP_PEER_PORT**: `11001`. +- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `35.233.75.24` +- **YOUR_DMQ_BOOTSTRAP_PEER_PORT**: `6161`. ::: @@ -957,9 +957,9 @@ Here is an **example** set of values for **pre-release-preview** that will be us :::tip -As we are still in a testing stage, we only support the `pre-release-preview` network. +The DMQ node is supported on the `release-mainnet`, `release-preprod` and `pre-release-preview` networks. -You can use these parameters for the **pre-release-preview** network: +You can use these parameters for all the supported networks: - **DMQ_RELEASE_URL**: `https://github.com/IntersectMBO/dmq-node/releases/download/0.7.0.0/dmq-node-linux.tar.gz` @@ -1013,7 +1013,7 @@ sudo chown cardano:cardano $(dirname **YOUR_DMQ_NODE_SOCKET_PATH**) :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo mkdir -p $(dirname /dmq/ipc/node.socket) @@ -1041,7 +1041,7 @@ bash -c 'cat > /opt/dmq/config.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1050,13 +1050,13 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/config.json << EOF { - "NetworkMagic": 2147483650, - "CardanoNetworkMagic": 2, + "NetworkMagic": 2912307721, + "CardanoNetworkMagic": 764824073, "CardanoNodeSocket": "/cardano/ipc/node.socket", "ShelleyGenesisFile": "/cardano/config/shelley-genesis.json", "PeerSharing": true, @@ -1067,7 +1067,7 @@ bash -c 'cat > /opt/dmq/config.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1117,7 +1117,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/topology.json << EOF @@ -1127,8 +1127,8 @@ bash -c 'cat > /opt/dmq/topology.json << EOF { "accessPoints": [ { - "address": "34.76.22.193", - "port": 11001, + "address": "35.233.75.24", + "port": 6161, "valency": 1 } ], @@ -1181,7 +1181,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/systemd/system/dmq-aggregator.service << EOF @@ -1194,7 +1194,8 @@ Type=simple Restart=always RestartSec=60 User=cardano -ExecStart=/opt/dmq/dmq-node --configuration-file /opt/dmq/config.json --topology-file /opt/dmq/topology.json --local-socket /dmq/ipc/node.socket --host-addr 34.14.65.160 --port 11001 +ExecStart=/opt/dmq/dmq-node --configuration-file /opt/dmq/config.json --topology-file /opt/dmq/topology.json --local-socket /dmq/ipc/node.socket --host-addr 34.14.65.160 --port 6161 + [Install] WantedBy=multi-user.target EOF' @@ -1244,7 +1245,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat >> /opt/mithril/mithril-aggregator.env << EOF @@ -1280,10 +1281,10 @@ You can monitor your aggregator's activity using the [Mithril explorer](https:// https://mithril.network/explorer/?aggregator=**URL_ENCODED_AGGREGATOR_ENDPOINT** ``` -For example, to monitor the `release-preprod` leader aggregator: +For example, to monitor the `release-mainnet` leader aggregator: ``` -https://mithril.network/explorer/?aggregator=https%3A%2F%2Faggregator.release-preprod.api.mithril.network%2Faggregator +https://mithril.network/explorer/?aggregator=https%3A%2F%2Faggregator.release-mainnet.api.mithril.network%2Faggregator ``` To monitor your own aggregator, replace the endpoint with your aggregator's public URL (URL-encoded). @@ -1309,10 +1310,10 @@ If you want to make your follower aggregator publicly discoverable, you should: - Opening an issue in the [Mithril GitHub repository](https://github.com/IntersectMBO/mithril/issues) - Or by creating a pull request that modifies the [`networks.json`](https://github.com/IntersectMBO/mithril/blob/main/networks.json) file and updates the `aggregators` field in the Cardano network you are targeting. - Here is an example command to add an aggregator to the `release-preprod` network configuration: + Here is an example command to add an aggregator to the `release-mainnet` network configuration: ```bash - jq '.preprod.mithril-networks.release-preprodaggregators += [{"name": "My Aggregator", "endpoint": "https://aggregator.example.com/aggregator"}]' networks.json > networks.json.tmp && mv networks.json.tmp networks.json + jq '.mainnet."mithril-networks"[0]."release-mainnet".aggregators += [{"url": "https://aggregator.example.com/aggregator"}]' networks.json > networks.json.tmp && mv networks.json.tmp networks.json ``` :::info diff --git a/docs/website/root/manual/operate/run-signer-node.md b/docs/website/root/manual/operate/run-signer-node.md index fcc71d6bfbc..3c5aac5063b 100644 --- a/docs/website/root/manual/operate/run-signer-node.md +++ b/docs/website/root/manual/operate/run-signer-node.md @@ -148,10 +148,10 @@ You can also fetch the minimum supported version for your network using the comm wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."**YOUR_CARDANO_NETWORK**"."cardano-minimum-version"."mithril-signer"' ``` -Here is an example for `preprod`: +Here is an example for `mainnet`: ```bash -wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."preprod"."cardano-minimum-version"."mithril-signer"' +wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."mainnet"."cardano-minimum-version"."mithril-signer"' ``` ::: @@ -299,14 +299,14 @@ sudo mv mithril-signer /opt/mithril :::tip -Here is an **example** set of values for **release-preprod** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **YOUR_KES_SECRET_KEY_PATH**: `/cardano/keys/kes.skey` - **YOUR_OPERATIONAL_CERTIFICATE_PATH**: `/cardano/keys/node.cert` -- **YOUR_CARDANO_NETWORK**: `preprod` -- **YOUR_AGGREGATOR_ENDPOINT**: `https://aggregator.release-preprod.api.mithril.network/aggregator` +- **YOUR_CARDANO_NETWORK**: `mainnet` +- **YOUR_AGGREGATOR_ENDPOINT**: `https://aggregator.release-mainnet.api.mithril.network/aggregator` - **YOUR_ERA_READER_ADAPTER_TYPE**: `cardano-chain` -- **YOUR_ERA_READER_ADAPTER_PARAMS**: `{"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"}` +- **YOUR_ERA_READER_ADAPTER_PARAMS**: `{"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"}` - **YOUR_RELAY_ENDPOINT**: `192.168.1.50` - **YOUR_RELAY_LISTENING_PORT**: `3132` - **YOUR_BLOCK_PRODUCER_INTERNAL_IP**: `192.168.1.75` @@ -339,14 +339,14 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /opt/mithril/mithril-signer.env << EOF KES_SECRET_KEY_PATH=/cardano/keys/kes.skey OPERATIONAL_CERTIFICATE_PATH=/cardano/keys/node.cert -NETWORK=preprod -AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator +NETWORK=mainnet +AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator RUN_INTERVAL=60000 DB_DIRECTORY=/cardano/db CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket @@ -354,7 +354,7 @@ CARDANO_CLI_PATH=/app/bin/cardano-cli DATA_STORES_DIRECTORY=/opt/mithril/stores STORE_RETENTION_LIMIT=5 ERA_READER_ADAPTER_TYPE=cardano-chain -ERA_READER_ADAPTER_PARAMS={"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"} +ERA_READER_ADAPTER_PARAMS={"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"} RELAY_ENDPOINT=http://192.168.1.50:3132 EOF' ``` @@ -382,14 +382,14 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /opt/mithril/mithril-signer.env << EOF KES_SECRET_KEY_PATH=/cardano/keys/kes.skey OPERATIONAL_CERTIFICATE_PATH=/cardano/keys/node.cert -NETWORK=preprod -AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator +NETWORK=mainnet +AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator RUN_INTERVAL=60000 DB_DIRECTORY=/cardano/db CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket @@ -397,7 +397,7 @@ CARDANO_CLI_PATH=/app/bin/cardano-cli DATA_STORES_DIRECTORY=/opt/mithril/stores STORE_RETENTION_LIMIT=5 ERA_READER_ADAPTER_TYPE=cardano-chain -ERA_READER_ADAPTER_PARAMS={"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"} +ERA_READER_ADAPTER_PARAMS={"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"} EOF' ``` @@ -684,7 +684,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/squid/squid.conf << EOF @@ -868,7 +868,7 @@ sudo ufw allow from **YOUR_BLOCK_PRODUCER_INTERNAL_IP** to any port **YOUR_RELAY :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo ufw allow from 192.168.1.75 to any port 3132 proto tcp @@ -886,7 +886,7 @@ sudo service netfilter-persistent save :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo iptables -A INPUT -s 192.168.1.75 -p tcp --dport 3132 -j ACCEPT @@ -919,7 +919,7 @@ If you choose the **production** deployment, you will need to install and config **Which deployment should I use?** -In this section, **production deployment** refers only to the recommended **two-machine deployment model** (Cardano block producer + Cardano relay), not to the maturity or production-readiness of the **DMQ** itself. The earlier warning that the DMQ setup is **not suitable for production use on mainnet** still applies. +In this section, **production deployment** refers only to the recommended **two-machine deployment model** (Cardano block producer + Cardano relay), not to the maturity of the **DMQ** itself, which is currently in **beta**. On **testnet**, we recommend the **production** deployment model, but you can use the **naive** deployment for testing purposes only. @@ -956,19 +956,19 @@ The Mithril signer must connect to the DMQ node socket that is on the **same mac :::tip -Here is an **example** set of values for **pre-release-preview** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **YOUR_DMQ_NODE_SOCKET_PATH**: `/dmq/ipc/node.socket` - **YOUR_CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` - **YOUR_CARDANO_SHELLEY_GENESIS_FILE_PATH**: `/cardano/config/shelley-genesis.json` -- **YOUR_CARDANO_NETWORK_MAGIC**: `2` -- **YOUR_DMQ_NETWORK_MAGIC**: `2147483650` +- **YOUR_CARDANO_NETWORK_MAGIC**: `764824073` +- **YOUR_DMQ_NETWORK_MAGIC**: `2912307721` - **YOUR_DMQ_NODE_RELAY_INTERNAL_ADDRESS**: `192.168.1.30` - **YOUR_DMQ_NODE_RELAY_PUBLIC_ADDRESS**: `34.14.65.160` - **YOUR_DMQ_NODE_RELAY_PORT**: `6161` - **YOUR_DMQ_NODE_BLOCK_PRODUCER_INTERNAL_ADDRESS**: `192.168.1.60` - **YOUR_DMQ_NODE_BLOCK_PRODUCER_PORT**: `6161` -- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `34.76.22.193` +- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `35.233.75.24` - **YOUR_DMQ_BOOTSTRAP_PEER_PORT**: `6161` ::: @@ -977,9 +977,9 @@ Here is an **example** set of values for **pre-release-preview** that will be us :::tip -As we are still in a testing stage, we only support the `pre-release-preview` network. +The DMQ node is supported on the `release-mainnet`, `release-preprod` and `pre-release-preview` networks. -You can use these parameters for the **pre-release-preview** network: +You can use these parameters for all the supported networks: - **DMQ_RELEASE_URL**: `https://github.com/IntersectMBO/dmq-node/releases/download/0.7.0.0/dmq-node-linux.tar.gz` @@ -1033,7 +1033,7 @@ sudo chown cardano:cardano $(dirname **YOUR_DMQ_NODE_SOCKET_PATH**) :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo mkdir -p $(dirname /dmq/ipc/node.socket) @@ -1061,7 +1061,7 @@ bash -c 'cat > /opt/dmq/config-relay.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1070,13 +1070,13 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/config-relay.json << EOF { - "NetworkMagic": 2147483650, - "CardanoNetworkMagic": 2, + "NetworkMagic": 2912307721, + "CardanoNetworkMagic": 764824073, "CardanoNodeSocket": "/cardano/ipc/node.socket", "ShelleyGenesisFile": "/cardano/config/shelley-genesis.json", "PeerSharing": true, @@ -1087,7 +1087,7 @@ bash -c 'cat > /opt/dmq/config-relay.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1113,7 +1113,7 @@ bash -c 'cat > /opt/dmq/config-bp.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1122,13 +1122,13 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/config-bp.json << EOF { - "NetworkMagic": 2147483650, - "CardanoNetworkMagic": 2, + "NetworkMagic": 2912307721, + "CardanoNetworkMagic": 764824073, "CardanoNodeSocket": "/cardano/ipc/node.socket", "ShelleyGenesisFile": "/cardano/config/shelley-genesis.json", "PeerSharing": false, @@ -1139,7 +1139,7 @@ bash -c 'cat > /opt/dmq/config-bp.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1198,7 +1198,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/topology-relay.json << EOF @@ -1208,7 +1208,7 @@ bash -c 'cat > /opt/dmq/topology-relay.json << EOF { "accessPoints": [ { - "address": "34.76.22.193", + "address": "35.233.75.24", "port": 6161, "valency": 1 } @@ -1264,7 +1264,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/topology-bp.json << EOF @@ -1328,7 +1328,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/systemd/system/dmq-relay.service << EOF @@ -1402,7 +1402,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/systemd/system/dmq-bp.service << EOF @@ -1469,7 +1469,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat >> /opt/mithril/mithril-signer.env << EOF @@ -1590,7 +1590,7 @@ PARTY_ID=**YOUR_PARTY_ID** AGGREGATOR_ENDPOINT=**YOUR_AGGREGATOR_ENDPOINT** ./ve Here is an example command: ```bash -PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator ./verify_signer_registration.sh +PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator ./verify_signer_registration.sh ``` ::: @@ -1631,10 +1631,10 @@ PARTY_ID=**YOUR_PARTY_ID** AGGREGATOR_ENDPOINT=**YOUR_AGGREGATOR_ENDPOINT** ./ve :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash -PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator ./verify_signer_signature.sh +PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator ./verify_signer_signature.sh ``` ::: @@ -1642,7 +1642,7 @@ PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDP If your signer is contributing, you should see this message: ```bash ->> Congrats, you have signed this certificate: https://aggregator.release-preprod.api.mithril.network/aggregator/certificate/el3p289b03a223244285b2ls10839846ae7a69f1e8362824a383f376f93f723f ! +>> Congrats, you have signed this certificate: https://aggregator.release-mainnet.api.mithril.network/aggregator/certificate/el3p289b03a223244285b2ls10839846ae7a69f1e8362824a383f376f93f723f ! ``` Otherwise, you should see this error message: diff --git a/docs/website/root/networks-matrix.md b/docs/website/root/networks-matrix.md index 8dc99a52994..cfdd0938655 100644 --- a/docs/website/root/networks-matrix.md +++ b/docs/website/root/networks-matrix.md @@ -103,7 +103,7 @@ This network is only for the developers of the Mithril Core team. | **DMQ magic Id** | `2147483650` | | **DMQ node versions** | `0.7.0.0` | | **DMQ bootstrap peers** | `34.38.152.55:6161`,`34.38.152.55:11001`,`34.38.152.55:11002`,`34.38.152.55:11003` | -| **DMQ status** | Unstable 🔴 | +| **DMQ status** | Beta 🟢 | | **Aggregator endpoint** | `https://aggregator.testing-preview.api.mithril.network/aggregator` [:arrow_upper_right:](https://aggregator.testing-preview.api.mithril.network/aggregator) | | **Genesis verification key** | `https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/testing-preview/genesis.vkey` [:arrow_upper_right:](https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/testing-preview/genesis.vkey) | | **Era reader adapter type** | `cardano-chain` | diff --git a/docs/website/versioned_docs/version-maintained/manual/operate/run-aggregator-node.md b/docs/website/versioned_docs/version-maintained/manual/operate/run-aggregator-node.md index 4a1faf0a2b5..ea5deea6cbb 100644 --- a/docs/website/versioned_docs/version-maintained/manual/operate/run-aggregator-node.md +++ b/docs/website/versioned_docs/version-maintained/manual/operate/run-aggregator-node.md @@ -8,7 +8,7 @@ import CompiledBinaries from '../../compiled-binaries.mdx' :::danger -Running multiple Mithril aggregators on a Mithril network is enabled by the DMQ protocol, which is currently **unstable** and not suitable for production use. +Running multiple Mithril aggregators on a Mithril network relies on the DMQ protocol, which is currently in **beta**. Until the DMQ network adoption reaches the required threshold, follower aggregators may not be able to produce valid certificates, and this setup is not suitable for production use. ::: @@ -110,10 +110,10 @@ You can also fetch the minimum supported version for your network using the comm wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."**YOUR_CARDANO_NETWORK**"."cardano-minimum-version"."mithril-aggregator"' ``` -Here is an example for `preprod`: +Here is an example for `mainnet`: ```bash -wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."preprod"."cardano-minimum-version"."mithril-aggregator"' +wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."mainnet"."cardano-minimum-version"."mithril-aggregator"' ``` ::: @@ -265,7 +265,7 @@ The configuration values for the `/opt/mithril/mithril-aggregator.env` file are - `NETWORK`: Cardano network name (eg, `mainnet`, `preprod`, or `preview`) - `NETWORK_MAGIC`: Cardano network magic number (required only if not using `mainnet`, `preprod` or `preview`) - `CARDANO_NODE_SOCKET_PATH`: Path to the IPC file of the Cardano node -- `CARDANO_NODE_VERSION`: Version of the Cardano node running (eg, `10.5.0`) +- `CARDANO_NODE_VERSION`: Version of the Cardano node running (eg, `10.7.1`) - `CHAIN_OBSERVER_TYPE`: Type of chain observer (default: `pallas`) - `ERA_READER_ADAPTER_TYPE`: Type of era reader adapter to use (default: `bootstrap`, use `cardano-chain` for production networks as specified in [Network configurations](../getting-started/network-configurations.md)) - `ERA_READER_ADAPTER_PARAMS`: JSON encoded parameters for the era reader adapter. For `cardano-chain` type, compute using: `jq -nc --arg address $(wget -q -O - **YOUR_ERA_READER_ADDRESS**) --arg verification_key $(wget -q -O - **YOUR_ERA_READER_VERIFICATION_KEY**) '{"address": $address, "verification_key": $verification_key}'` (URLs can be found in the [Network configurations](../getting-started/network-configurations.md)) @@ -275,7 +275,7 @@ The configuration values for the `/opt/mithril/mithril-aggregator.env` file are - **Base configuration** **optional** values are: - - `BLOCKFROST_PARAMETERS`: Parameters to connect to the Blockfrost API. Used to fetch the ticker and name of the registered stake pools. Example: `{"project_id":"preprodWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` + - `BLOCKFROST_PARAMETERS`: Parameters to connect to the Blockfrost API. Used to fetch the ticker and name of the registered stake pools. Example: `{"project_id":"mainnetWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` - `SIGNER_IMPORTER_RUN_INTERVAL`: Time interval at which the pools names and ticker in blockfrost will be imported (in minutes, default: `720`). - The **Cardano database** configuration values are (only needed if supporting Cardano database certification): @@ -300,31 +300,31 @@ The configuration values for the `/opt/mithril/mithril-aggregator.env` file are :::tip -Here is an **example** set of values for **release-preprod** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **Base configuration**: - **SIGNED_ENTITY_TYPES**: `MithrilStakeDistribution,CardanoStakeDistribution,CardanoTransactions` (only supporting stake distributions and transactions, excluding database snapshots) - **SERVER_PORT**: `8080` - **PUBLIC_SERVER_URL**: `https://aggregator.example.com/aggregator` - - **LEADER_AGGREGATOR_ENDPOINT**: `https://aggregator.release-preprod.api.mithril.network/aggregator` + - **LEADER_AGGREGATOR_ENDPOINT**: `https://aggregator.release-mainnet.api.mithril.network/aggregator` - **RUN_INTERVAL**: `60000` - **AGGREGATE_SIGNATURE_TYPE**: `Concatenation` - **STORE_RETENTION_LIMIT**: `5` - - **NETWORK**: `preprod` - - **NETWORK_MAGIC**: `1` + - **NETWORK**: `mainnet` + - **NETWORK_MAGIC**: `764824073` - **CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` - - **CARDANO_NODE_VERSION**: `10.5.0` + - **CARDANO_NODE_VERSION**: `10.7.1` - **CHAIN_OBSERVER_TYPE**: `pallas` - **ERA_READER_ADAPTER_TYPE**: `cardano-chain` - - **ERA_READER_ADAPTER_PARAMS**: `$(jq -nc --arg address $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-preprod/era.addr) --arg verification_key $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-preprod/era.vkey) '{"address": $address, "verification_key": $verification_key}')` - - **GENESIS_VERIFICATION_KEY**: `$(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-preprod/genesis.vkey)` + - **ERA_READER_ADAPTER_PARAMS**: `$(jq -nc --arg address $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-mainnet/era.addr) --arg verification_key $(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-mainnet/era.vkey) '{"address": $address, "verification_key": $verification_key}')` + - **GENESIS_VERIFICATION_KEY**: `$(wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-mainnet/genesis.vkey)` - **DMQ_NODE_SOCKET_PATH**: `/dmq/ipc/node.socket` - **CUSTOM_ORIGIN_TAG_WHITE_LIST**: `EXPLORER,BENCHMARK,CI,NA` - **Optional configuration**: - - **BLOCKFROST_PARAMETERS**: `{"project_id":"preprodWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` + - **BLOCKFROST_PARAMETERS**: `{"project_id":"mainnetWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"}` - **SIGNER_IMPORTER_RUN_INTERVAL**: 720 - **Cardano database configuration**: @@ -413,7 +413,7 @@ EOF` :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /opt/mithril/mithril-aggregator.env << EOF @@ -421,17 +421,17 @@ sudo bash -c 'cat > /opt/mithril/mithril-aggregator.env << EOF SIGNED_ENTITY_TYPES=MithrilStakeDistribution,CardanoStakeDistribution,CardanoTransactions SERVER_PORT=8080 PUBLIC_SERVER_URL=https://aggregator.example.com/aggregator -LEADER_AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator +LEADER_AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator RUN_INTERVAL=60000 AGGREGATE_SIGNATURE_TYPE=Concatenation STORE_RETENTION_LIMIT=5 -NETWORK=preprod -NETWORK_MAGIC=1 +NETWORK=mainnet +NETWORK_MAGIC=764824073 CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket -CARDANO_NODE_VERSION=10.5.0 +CARDANO_NODE_VERSION=10.7.1 CHAIN_OBSERVER_TYPE=pallas ERA_READER_ADAPTER_TYPE=cardano-chain -ERA_READER_ADAPTER_PARAMS={"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"} +ERA_READER_ADAPTER_PARAMS={"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"} DMQ_NODE_SOCKET_PATH=/dmq/ipc/node.socket CUSTOM_ORIGIN_TAG_WHITE_LIST=EXPLORER,BENCHMARK,CI,NA EOF' @@ -442,7 +442,7 @@ If you want to configure **Optional** parameters, append the following variables ```bash sudo bash -c 'cat >> /opt/mithril/mithril-aggregator.env << EOF # Optional configuration -BLOCKFROST_PARAMETERS={"project_id":"preprodWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"} +BLOCKFROST_PARAMETERS={"project_id":"mainnetWuV1ICdtOWfZYfdcxpZ0tsS1N9rVZomQ"} SIGNER_IMPORTER_RUN_INTERVAL=720 EOF' ``` @@ -939,17 +939,17 @@ The DMQ node supports the implementation of a **Decentralized Message Queue** (D :::tip -Here is an **example** set of values for **pre-release-preview** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **YOUR_DMQ_NODE_SOCKET_PATH**: `/dmq/ipc/node.socket` - **YOUR_CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` - **YOUR_CARDANO_SHELLEY_GENESIS_FILE_PATH**: `/cardano/config/shelley-genesis.json` -- **YOUR_CARDANO_NETWORK_MAGIC**: `2` -- **YOUR_DMQ_NETWORK_MAGIC**: `2147483650` +- **YOUR_CARDANO_NETWORK_MAGIC**: `764824073` +- **YOUR_DMQ_NETWORK_MAGIC**: `2912307721` - **YOUR_DMQ_NODE_PUBLIC_ADDRESS**: `34.14.65.160` - **YOUR_DMQ_NODE_PORT**: `6161` -- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `34.76.22.193` -- **YOUR_DMQ_BOOTSTRAP_PEER_PORT**: `11001`. +- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `35.233.75.24` +- **YOUR_DMQ_BOOTSTRAP_PEER_PORT**: `6161`. ::: @@ -957,9 +957,9 @@ Here is an **example** set of values for **pre-release-preview** that will be us :::tip -As we are still in a testing stage, we only support the `pre-release-preview` network. +The DMQ node is supported on the `release-mainnet`, `release-preprod` and `pre-release-preview` networks. -You can use these parameters for the **pre-release-preview** network: +You can use these parameters for all the supported networks: - **DMQ_RELEASE_URL**: `https://github.com/IntersectMBO/dmq-node/releases/download/0.7.0.0/dmq-node-linux.tar.gz` @@ -1013,7 +1013,7 @@ sudo chown cardano:cardano $(dirname **YOUR_DMQ_NODE_SOCKET_PATH**) :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo mkdir -p $(dirname /dmq/ipc/node.socket) @@ -1041,7 +1041,7 @@ bash -c 'cat > /opt/dmq/config.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1050,13 +1050,13 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/config.json << EOF { - "NetworkMagic": 2147483650, - "CardanoNetworkMagic": 2, + "NetworkMagic": 2912307721, + "CardanoNetworkMagic": 764824073, "CardanoNodeSocket": "/cardano/ipc/node.socket", "ShelleyGenesisFile": "/cardano/config/shelley-genesis.json", "PeerSharing": true, @@ -1067,7 +1067,7 @@ bash -c 'cat > /opt/dmq/config.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1117,7 +1117,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/topology.json << EOF @@ -1127,8 +1127,8 @@ bash -c 'cat > /opt/dmq/topology.json << EOF { "accessPoints": [ { - "address": "34.76.22.193", - "port": 11001, + "address": "35.233.75.24", + "port": 6161, "valency": 1 } ], @@ -1181,7 +1181,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/systemd/system/dmq-aggregator.service << EOF @@ -1194,7 +1194,8 @@ Type=simple Restart=always RestartSec=60 User=cardano -ExecStart=/opt/dmq/dmq-node --configuration-file /opt/dmq/config.json --topology-file /opt/dmq/topology.json --local-socket /dmq/ipc/node.socket --host-addr 34.14.65.160 --port 11001 +ExecStart=/opt/dmq/dmq-node --configuration-file /opt/dmq/config.json --topology-file /opt/dmq/topology.json --local-socket /dmq/ipc/node.socket --host-addr 34.14.65.160 --port 6161 + [Install] WantedBy=multi-user.target EOF' @@ -1244,7 +1245,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat >> /opt/mithril/mithril-aggregator.env << EOF @@ -1280,10 +1281,10 @@ You can monitor your aggregator's activity using the [Mithril explorer](https:// https://mithril.network/explorer/?aggregator=**URL_ENCODED_AGGREGATOR_ENDPOINT** ``` -For example, to monitor the `release-preprod` leader aggregator: +For example, to monitor the `release-mainnet` leader aggregator: ``` -https://mithril.network/explorer/?aggregator=https%3A%2F%2Faggregator.release-preprod.api.mithril.network%2Faggregator +https://mithril.network/explorer/?aggregator=https%3A%2F%2Faggregator.release-mainnet.api.mithril.network%2Faggregator ``` To monitor your own aggregator, replace the endpoint with your aggregator's public URL (URL-encoded). @@ -1309,10 +1310,10 @@ If you want to make your follower aggregator publicly discoverable, you should: - Opening an issue in the [Mithril GitHub repository](https://github.com/IntersectMBO/mithril/issues) - Or by creating a pull request that modifies the [`networks.json`](https://github.com/IntersectMBO/mithril/blob/main/networks.json) file and updates the `aggregators` field in the Cardano network you are targeting. - Here is an example command to add an aggregator to the `release-preprod` network configuration: + Here is an example command to add an aggregator to the `release-mainnet` network configuration: ```bash - jq '.preprod.mithril-networks.release-preprodaggregators += [{"name": "My Aggregator", "endpoint": "https://aggregator.example.com/aggregator"}]' networks.json > networks.json.tmp && mv networks.json.tmp networks.json + jq '.mainnet."mithril-networks"[0]."release-mainnet".aggregators += [{"url": "https://aggregator.example.com/aggregator"}]' networks.json > networks.json.tmp && mv networks.json.tmp networks.json ``` :::info diff --git a/docs/website/versioned_docs/version-maintained/manual/operate/run-signer-node.md b/docs/website/versioned_docs/version-maintained/manual/operate/run-signer-node.md index fcc71d6bfbc..3c5aac5063b 100644 --- a/docs/website/versioned_docs/version-maintained/manual/operate/run-signer-node.md +++ b/docs/website/versioned_docs/version-maintained/manual/operate/run-signer-node.md @@ -148,10 +148,10 @@ You can also fetch the minimum supported version for your network using the comm wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."**YOUR_CARDANO_NETWORK**"."cardano-minimum-version"."mithril-signer"' ``` -Here is an example for `preprod`: +Here is an example for `mainnet`: ```bash -wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."preprod"."cardano-minimum-version"."mithril-signer"' +wget -q -O - https://raw.githubusercontent.com/IntersectMBO/mithril/main/networks.json | jq -r '."mainnet"."cardano-minimum-version"."mithril-signer"' ``` ::: @@ -299,14 +299,14 @@ sudo mv mithril-signer /opt/mithril :::tip -Here is an **example** set of values for **release-preprod** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **YOUR_KES_SECRET_KEY_PATH**: `/cardano/keys/kes.skey` - **YOUR_OPERATIONAL_CERTIFICATE_PATH**: `/cardano/keys/node.cert` -- **YOUR_CARDANO_NETWORK**: `preprod` -- **YOUR_AGGREGATOR_ENDPOINT**: `https://aggregator.release-preprod.api.mithril.network/aggregator` +- **YOUR_CARDANO_NETWORK**: `mainnet` +- **YOUR_AGGREGATOR_ENDPOINT**: `https://aggregator.release-mainnet.api.mithril.network/aggregator` - **YOUR_ERA_READER_ADAPTER_TYPE**: `cardano-chain` -- **YOUR_ERA_READER_ADAPTER_PARAMS**: `{"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"}` +- **YOUR_ERA_READER_ADAPTER_PARAMS**: `{"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"}` - **YOUR_RELAY_ENDPOINT**: `192.168.1.50` - **YOUR_RELAY_LISTENING_PORT**: `3132` - **YOUR_BLOCK_PRODUCER_INTERNAL_IP**: `192.168.1.75` @@ -339,14 +339,14 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /opt/mithril/mithril-signer.env << EOF KES_SECRET_KEY_PATH=/cardano/keys/kes.skey OPERATIONAL_CERTIFICATE_PATH=/cardano/keys/node.cert -NETWORK=preprod -AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator +NETWORK=mainnet +AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator RUN_INTERVAL=60000 DB_DIRECTORY=/cardano/db CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket @@ -354,7 +354,7 @@ CARDANO_CLI_PATH=/app/bin/cardano-cli DATA_STORES_DIRECTORY=/opt/mithril/stores STORE_RETENTION_LIMIT=5 ERA_READER_ADAPTER_TYPE=cardano-chain -ERA_READER_ADAPTER_PARAMS={"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"} +ERA_READER_ADAPTER_PARAMS={"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"} RELAY_ENDPOINT=http://192.168.1.50:3132 EOF' ``` @@ -382,14 +382,14 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /opt/mithril/mithril-signer.env << EOF KES_SECRET_KEY_PATH=/cardano/keys/kes.skey OPERATIONAL_CERTIFICATE_PATH=/cardano/keys/node.cert -NETWORK=preprod -AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator +NETWORK=mainnet +AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator RUN_INTERVAL=60000 DB_DIRECTORY=/cardano/db CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket @@ -397,7 +397,7 @@ CARDANO_CLI_PATH=/app/bin/cardano-cli DATA_STORES_DIRECTORY=/opt/mithril/stores STORE_RETENTION_LIMIT=5 ERA_READER_ADAPTER_TYPE=cardano-chain -ERA_READER_ADAPTER_PARAMS={"address": "addr_test1qpkyv2ws0deszm67t840sdnruqgr492n80g3y96xw3p2ksk6suj5musy6w8lsg3yjd09cnpgctc2qh386rtxphxt248qr0npnx", "verification_key": "5b35352c3232382c3134342c38372c3133382c3133362c34382c382c31342c3138372c38352c3134382c39372c3233322c3235352c3232392c33382c3234342c3234372c3230342c3139382c31332c33312c3232322c32352c3136342c35322c3130322c39312c3132302c3230382c3134375d"} +ERA_READER_ADAPTER_PARAMS={"address": "addr1qy72kwgm6kypyc5maw0h8mfagwag8wjnx6emgfnsnhqaml6gx7gg4tzplw9l32nsgclqax7stc4u6c5dn0ctljwscm2sqv0teg", "verification_key": "5b31312c3133342c3231352c37362c3134312c3232302c3131312c3135342c36332c3233302c3131342c31322c38372c37342c39342c3137322c3133322c32372c39362c3138362c3132362c3137382c31392c3131342c33302c3234332c36342c3134312c3131302c38332c38362c31395d"} EOF' ``` @@ -684,7 +684,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/squid/squid.conf << EOF @@ -868,7 +868,7 @@ sudo ufw allow from **YOUR_BLOCK_PRODUCER_INTERNAL_IP** to any port **YOUR_RELAY :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo ufw allow from 192.168.1.75 to any port 3132 proto tcp @@ -886,7 +886,7 @@ sudo service netfilter-persistent save :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo iptables -A INPUT -s 192.168.1.75 -p tcp --dport 3132 -j ACCEPT @@ -919,7 +919,7 @@ If you choose the **production** deployment, you will need to install and config **Which deployment should I use?** -In this section, **production deployment** refers only to the recommended **two-machine deployment model** (Cardano block producer + Cardano relay), not to the maturity or production-readiness of the **DMQ** itself. The earlier warning that the DMQ setup is **not suitable for production use on mainnet** still applies. +In this section, **production deployment** refers only to the recommended **two-machine deployment model** (Cardano block producer + Cardano relay), not to the maturity of the **DMQ** itself, which is currently in **beta**. On **testnet**, we recommend the **production** deployment model, but you can use the **naive** deployment for testing purposes only. @@ -956,19 +956,19 @@ The Mithril signer must connect to the DMQ node socket that is on the **same mac :::tip -Here is an **example** set of values for **pre-release-preview** that will be used in this guide in the **tip** boxes to illustrate some commands: +Here is an **example** set of values for **release-mainnet** that will be used in this guide in the **tip** boxes to illustrate some commands: - **YOUR_DMQ_NODE_SOCKET_PATH**: `/dmq/ipc/node.socket` - **YOUR_CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` - **YOUR_CARDANO_SHELLEY_GENESIS_FILE_PATH**: `/cardano/config/shelley-genesis.json` -- **YOUR_CARDANO_NETWORK_MAGIC**: `2` -- **YOUR_DMQ_NETWORK_MAGIC**: `2147483650` +- **YOUR_CARDANO_NETWORK_MAGIC**: `764824073` +- **YOUR_DMQ_NETWORK_MAGIC**: `2912307721` - **YOUR_DMQ_NODE_RELAY_INTERNAL_ADDRESS**: `192.168.1.30` - **YOUR_DMQ_NODE_RELAY_PUBLIC_ADDRESS**: `34.14.65.160` - **YOUR_DMQ_NODE_RELAY_PORT**: `6161` - **YOUR_DMQ_NODE_BLOCK_PRODUCER_INTERNAL_ADDRESS**: `192.168.1.60` - **YOUR_DMQ_NODE_BLOCK_PRODUCER_PORT**: `6161` -- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `34.76.22.193` +- **YOUR_DMQ_BOOTSTRAP_PEER_ADDRESS**: `35.233.75.24` - **YOUR_DMQ_BOOTSTRAP_PEER_PORT**: `6161` ::: @@ -977,9 +977,9 @@ Here is an **example** set of values for **pre-release-preview** that will be us :::tip -As we are still in a testing stage, we only support the `pre-release-preview` network. +The DMQ node is supported on the `release-mainnet`, `release-preprod` and `pre-release-preview` networks. -You can use these parameters for the **pre-release-preview** network: +You can use these parameters for all the supported networks: - **DMQ_RELEASE_URL**: `https://github.com/IntersectMBO/dmq-node/releases/download/0.7.0.0/dmq-node-linux.tar.gz` @@ -1033,7 +1033,7 @@ sudo chown cardano:cardano $(dirname **YOUR_DMQ_NODE_SOCKET_PATH**) :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo mkdir -p $(dirname /dmq/ipc/node.socket) @@ -1061,7 +1061,7 @@ bash -c 'cat > /opt/dmq/config-relay.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1070,13 +1070,13 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/config-relay.json << EOF { - "NetworkMagic": 2147483650, - "CardanoNetworkMagic": 2, + "NetworkMagic": 2912307721, + "CardanoNetworkMagic": 764824073, "CardanoNodeSocket": "/cardano/ipc/node.socket", "ShelleyGenesisFile": "/cardano/config/shelley-genesis.json", "PeerSharing": true, @@ -1087,7 +1087,7 @@ bash -c 'cat > /opt/dmq/config-relay.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1113,7 +1113,7 @@ bash -c 'cat > /opt/dmq/config-bp.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1122,13 +1122,13 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/config-bp.json << EOF { - "NetworkMagic": 2147483650, - "CardanoNetworkMagic": 2, + "NetworkMagic": 2912307721, + "CardanoNetworkMagic": 764824073, "CardanoNodeSocket": "/cardano/ipc/node.socket", "ShelleyGenesisFile": "/cardano/config/shelley-genesis.json", "PeerSharing": false, @@ -1139,7 +1139,7 @@ bash -c 'cat > /opt/dmq/config-bp.json << EOF "Stdout MachineFormat", "PrometheusSimple suffix 127.0.0.1 12000" ], - "severity": "Debug" + "severity": "Info" } } } @@ -1198,7 +1198,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/topology-relay.json << EOF @@ -1208,7 +1208,7 @@ bash -c 'cat > /opt/dmq/topology-relay.json << EOF { "accessPoints": [ { - "address": "34.76.22.193", + "address": "35.233.75.24", "port": 6161, "valency": 1 } @@ -1264,7 +1264,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash bash -c 'cat > /opt/dmq/topology-bp.json << EOF @@ -1328,7 +1328,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/systemd/system/dmq-relay.service << EOF @@ -1402,7 +1402,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat > /etc/systemd/system/dmq-bp.service << EOF @@ -1469,7 +1469,7 @@ EOF' :::tip -Here is an example of the aforementioned command created with the example set for `pre-release-preview`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash sudo bash -c 'cat >> /opt/mithril/mithril-signer.env << EOF @@ -1590,7 +1590,7 @@ PARTY_ID=**YOUR_PARTY_ID** AGGREGATOR_ENDPOINT=**YOUR_AGGREGATOR_ENDPOINT** ./ve Here is an example command: ```bash -PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator ./verify_signer_registration.sh +PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator ./verify_signer_registration.sh ``` ::: @@ -1631,10 +1631,10 @@ PARTY_ID=**YOUR_PARTY_ID** AGGREGATOR_ENDPOINT=**YOUR_AGGREGATOR_ENDPOINT** ./ve :::tip -Here is an example of the aforementioned command created with the example set for `release-preprod`: +Here is an example of the aforementioned command created with the example set for `release-mainnet`: ```bash -PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-preprod.api.mithril.network/aggregator ./verify_signer_signature.sh +PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator ./verify_signer_signature.sh ``` ::: @@ -1642,7 +1642,7 @@ PARTY_ID=pool1hp72sauk0g0yqm4dzllz0pz6j93gewhllkzphn4hykkfmne43y AGGREGATOR_ENDP If your signer is contributing, you should see this message: ```bash ->> Congrats, you have signed this certificate: https://aggregator.release-preprod.api.mithril.network/aggregator/certificate/el3p289b03a223244285b2ls10839846ae7a69f1e8362824a383f376f93f723f ! +>> Congrats, you have signed this certificate: https://aggregator.release-mainnet.api.mithril.network/aggregator/certificate/el3p289b03a223244285b2ls10839846ae7a69f1e8362824a383f376f93f723f ! ``` Otherwise, you should see this error message: diff --git a/docs/website/versioned_docs/version-maintained/networks-matrix.md b/docs/website/versioned_docs/version-maintained/networks-matrix.md index 8dc99a52994..cfdd0938655 100644 --- a/docs/website/versioned_docs/version-maintained/networks-matrix.md +++ b/docs/website/versioned_docs/version-maintained/networks-matrix.md @@ -103,7 +103,7 @@ This network is only for the developers of the Mithril Core team. | **DMQ magic Id** | `2147483650` | | **DMQ node versions** | `0.7.0.0` | | **DMQ bootstrap peers** | `34.38.152.55:6161`,`34.38.152.55:11001`,`34.38.152.55:11002`,`34.38.152.55:11003` | -| **DMQ status** | Unstable 🔴 | +| **DMQ status** | Beta 🟢 | | **Aggregator endpoint** | `https://aggregator.testing-preview.api.mithril.network/aggregator` [:arrow_upper_right:](https://aggregator.testing-preview.api.mithril.network/aggregator) | | **Genesis verification key** | `https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/testing-preview/genesis.vkey` [:arrow_upper_right:](https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/testing-preview/genesis.vkey) | | **Era reader adapter type** | `cardano-chain` |