book: deploy 10.3.1 pre-release refs

Author: johnalotoski

mdbook/README-book.md

@@ -24,4 +24,4 @@ _Use the nagivation panel on the left to explore [The Cardano Book][book]._
 
 <br />
 
-<center><sub><sup><span style="color:lightgray; font-style:italic">STAGING:3cc3d6edaaf2baafcba04446e950e7aff9e79f49-dirty</span></sup></sub></center>
+<center><sub><sup><span style="color:lightgray; font-style:italic">abbb59e6eb590e4578655141540a44c2021e7b33</span></sup></sub></center>

static/book.play.dev.cardano.org/README-book.html

@@ -193,7 +193,7 @@ <h3 id="documentation"><a class="header" href="#documentation">Documentation</a>
 <br />
 <hr />
 <br />
-<center><sub><sup><span style="color:lightgray; font-style:italic">8e1800dcef131cfb979cafe4a2c2b310568c9f88</span></sup></sub></center>
+<center><sub><sup><span style="color:lightgray; font-style:italic">abbb59e6eb590e4578655141540a44c2021e7b33</span></sup></sub></center>
 
                     </main>
 

static/book.play.dev.cardano.org/adv-preprod.html

@@ -179,10 +179,11 @@ <h1 class="menu-title">The Cardano Operations Book</h1>
                 <div id="content" class="content">
                     <main>
                         <h2 id="advanced-configuration-pre-production-testnet"><a class="header" href="#advanced-configuration-pre-production-testnet">Advanced Configuration: Pre-Production Testnet</a></h2>
-<p>There is currently no pre-release version available for the pre-production environment.</p>
-<p>The latest version available is cardano-node release <code>10.2.1</code>.</p>
+<p>Users wanting to test a cardano-node pre-release version on the preprod
+environment may obtain compatible configuration files below.</p>
+<p>The latest version available is cardano-node pre-release <code>10.3.1</code>.</p>
 <h4 id="configuration-files"><a class="header" href="#configuration-files">Configuration files</a></h4>
-<p>Compatible with cardano-node release <a href="https://github.com/IntersectMBO/cardano-node/releases/tag/10.2.1">10.2.1</a></p>
+<p>Compatible with cardano-node pre-release <a href="https://github.com/IntersectMBO/cardano-node/releases/tag/10.3.1">10.3.1</a></p>
 <pre><code>NOTE:
 The non-block-producer node config has `PeerSharing` enabled by
 default, so should not be used with block-producers.
@@ -196,12 +197,33 @@ <h4 id="configuration-files"><a class="header" href="#configuration-files">Confi
 <li><a href="environments-pre/preprod/db-sync-config.json">DB Sync Config</a></li>
 <li><a href="environments-pre/preprod/submit-api-config.json">Submit API Config</a></li>
 <li><a href="environments-pre/preprod/topology.json">Node Topology</a></li>
+<li><a href="environments-pre/preprod/topology-genesis-mode.json">Node Topology (Genesis mode)</a></li>
+<li><a href="environments-pre/preprod/peer-snapshot.json">Peer Snapshot</a></li>
 <li><a href="environments-pre/preprod/byron-genesis.json">Byron Genesis</a></li>
 <li><a href="environments-pre/preprod/shelley-genesis.json">Shelley Genesis</a></li>
 <li><a href="environments-pre/preprod/alonzo-genesis.json">Alonzo Genesis</a></li>
 <li><a href="environments-pre/preprod/conway-genesis.json">Conway Genesis</a></li>
 <li><a href="environments-pre/preprod/guardrails-script.plutus">Compiled guardrails script</a></li>
 </ul>
+<h4 id="ouroboros-genesis-mode"><a class="header" href="#ouroboros-genesis-mode">Ouroboros Genesis Mode</a></h4>
+<p>For those preferring to use Genesis mode over bootstrap peers, the Genesis mode
+topology file given above can be used in place of the default topology file.
+The following requirements will also need to be met:</p>
+<ul>
+<li>
+<p>The node config will need to have <code>ConsensusMode</code> set to <code>GenesisMode</code></p>
+</li>
+<li>
+<p>The peer snapshot file, provided above, will need to exist at the path
+declared at <code>peerSnapshotFile</code> in the genesis mode topology file: an absolute
+path, or a relative path with respect to the node server invocation directory</p>
+</li>
+</ul>
+<h4 id="guardrails-reference-script-utxo"><a class="header" href="#guardrails-reference-script-utxo">Guardrails reference script UTxO</a></h4>
+<p>For convenience, the guardrails script has been put on a UTxO so that it can be used as reference script in
+Treasury Withdrawal and Update Protocol Parameter proposals.</p>
+<p>Guardrails script address: <code>addr_test1wrazf7es2yngqh8jzexpv8v99g88xvx0nz83le2cea755eqf68ll6</code>
+Guardrails script UTxO: <code>9aabbac24d1e39cb3e677981c84998a4210bae8d56b0f60908eedb9f59efffc8#0</code></p>
 
                     </main>
 

static/book.play.dev.cardano.org/adv-preview.html

@@ -179,10 +179,11 @@ <h1 class="menu-title">The Cardano Operations Book</h1>
                 <div id="content" class="content">
                     <main>
                         <h2 id="advanced-configuration-preview-testnet"><a class="header" href="#advanced-configuration-preview-testnet">Advanced Configuration: Preview Testnet</a></h2>
-<p>There is currently no pre-release version available for the preview environment.</p>
-<p>The latest version available is cardano-node release <code>10.2.1</code>.</p>
+<p>Users wanting to test a cardano-node pre-release version on the preview
+environment may obtain compatible configuration files below.</p>
+<p>The latest version available is cardano-node pre-release <code>10.3.1</code>.</p>
 <h4 id="configuration-files"><a class="header" href="#configuration-files">Configuration files</a></h4>
-<p>Compatible with cardano-node release <a href="https://github.com/IntersectMBO/cardano-node/releases/tag/10.2.1">10.2.1</a></p>
+<p>Compatible with cardano-node pre-release <a href="https://github.com/IntersectMBO/cardano-node/releases/tag/10.3.1">10.3.1</a></p>
 <pre><code>NOTE:
 The non-block-producer node config has `PeerSharing` enabled by
 default, so should not be used with block-producers.
@@ -196,12 +197,33 @@ <h4 id="configuration-files"><a class="header" href="#configuration-files">Confi
 <li><a href="environments-pre/preview/db-sync-config.json">DB Sync Config</a></li>
 <li><a href="environments-pre/preview/submit-api-config.json">Submit API Config</a></li>
 <li><a href="environments-pre/preview/topology.json">Node Topology</a></li>
+<li><a href="environments-pre/preview/topology-genesis-mode.json">Node Topology (Genesis mode)</a></li>
+<li><a href="environments-pre/preview/peer-snapshot.json">Peer Snapshot</a></li>
 <li><a href="environments-pre/preview/byron-genesis.json">Byron Genesis</a></li>
 <li><a href="environments-pre/preview/shelley-genesis.json">Shelley Genesis</a></li>
 <li><a href="environments-pre/preview/alonzo-genesis.json">Alonzo Genesis</a></li>
 <li><a href="environments-pre/preview/conway-genesis.json">Conway Genesis</a></li>
 <li><a href="environments-pre/preview/guardrails-script.plutus">Compiled guardrails script</a></li>
 </ul>
+<h4 id="ouroboros-genesis-mode"><a class="header" href="#ouroboros-genesis-mode">Ouroboros Genesis Mode</a></h4>
+<p>For those preferring to use Genesis mode over bootstrap peers, the Genesis mode
+topology file given above can be used in place of the default topology file.
+The following requirements will also need to be met:</p>
+<ul>
+<li>
+<p>The node config will need to have <code>ConsensusMode</code> set to <code>GenesisMode</code></p>
+</li>
+<li>
+<p>The peer snapshot file, provided above, will need to exist at the path
+declared at <code>peerSnapshotFile</code> in the genesis mode topology file: an absolute
+path, or a relative path with respect to the node server invocation directory</p>
+</li>
+</ul>
+<h4 id="guardrails-reference-script-utxo"><a class="header" href="#guardrails-reference-script-utxo">Guardrails reference script UTxO</a></h4>
+<p>For convenience, the guardrails script has been put on a UTxO so that it can be used as reference script in
+Treasury Withdrawal and Protocol Parameter Change proposals.</p>
+<p>Guardrails script address: <code>addr_test1wrazf7es2yngqh8jzexpv8v99g88xvx0nz83le2cea755eqf68ll6</code>
+Guardrails script UTxO: <code>f3f61635034140e6cec495a1c69ce85b22690e65ab9553ef408d524f58183649#0</code></p>
 
                     </main>
 

static/book.play.dev.cardano.org/environments-pre/preprod/config-bp.json

@@ -3,18 +3,24 @@
   "AlonzoGenesisHash": "7e94a15f55d1e82d10f09203fa1d40f8eede58fd8066542cf6566008068ed874",
   "ByronGenesisFile": "byron-genesis.json",
   "ByronGenesisHash": "d4b8de7a11d929a323373cbab6c1a9bdc931beffff11db111cf9d57356ee1937",
+  "ConsensusMode": "PraosMode",
   "ConwayGenesisFile": "conway-genesis.json",
   "ConwayGenesisHash": "0eb6adaec3fcb1fe286c1b4ae0da2a117eafc3add51e17577d36dd39eddfc3db",
   "EnableP2P": true,
   "LastKnownBlockVersion-Alt": 0,
   "LastKnownBlockVersion-Major": 2,
   "LastKnownBlockVersion-Minor": 0,
-  "MinNodeVersion": "10.1.4",
+  "MinBigLedgerPeersForTrustedState": 5,
+  "MinNodeVersion": "10.2.1",
   "PeerSharing": false,
   "Protocol": "Cardano",
   "RequiresNetworkMagic": "RequiresMagic",
   "ShelleyGenesisFile": "shelley-genesis.json",
   "ShelleyGenesisHash": "162d29c4e1cf6b8a84f2d692e67a3ac6bc7851bc3e6e4afe64d15778bed8bd86",
+  "SyncTargetNumberOfActiveBigLedgerPeers": 30,
+  "SyncTargetNumberOfActivePeers": 0,
+  "SyncTargetNumberOfEstablishedBigLedgerPeers": 50,
+  "SyncTargetNumberOfKnownBigLedgerPeers": 100,
   "TargetNumberOfActivePeers": 20,
   "TargetNumberOfEstablishedPeers": 40,
   "TargetNumberOfKnownPeers": 100,

static/book.play.dev.cardano.org/environments-pre/preprod/config.json

@@ -3,18 +3,24 @@
   "AlonzoGenesisHash": "7e94a15f55d1e82d10f09203fa1d40f8eede58fd8066542cf6566008068ed874",
   "ByronGenesisFile": "byron-genesis.json",
   "ByronGenesisHash": "d4b8de7a11d929a323373cbab6c1a9bdc931beffff11db111cf9d57356ee1937",
+  "ConsensusMode": "PraosMode",
   "ConwayGenesisFile": "conway-genesis.json",
   "ConwayGenesisHash": "0eb6adaec3fcb1fe286c1b4ae0da2a117eafc3add51e17577d36dd39eddfc3db",
   "EnableP2P": true,
   "LastKnownBlockVersion-Alt": 0,
   "LastKnownBlockVersion-Major": 2,
   "LastKnownBlockVersion-Minor": 0,
-  "MinNodeVersion": "10.1.4",
+  "MinBigLedgerPeersForTrustedState": 5,
+  "MinNodeVersion": "10.2.1",
   "PeerSharing": true,
   "Protocol": "Cardano",
   "RequiresNetworkMagic": "RequiresMagic",
   "ShelleyGenesisFile": "shelley-genesis.json",
   "ShelleyGenesisHash": "162d29c4e1cf6b8a84f2d692e67a3ac6bc7851bc3e6e4afe64d15778bed8bd86",
+  "SyncTargetNumberOfActiveBigLedgerPeers": 30,
+  "SyncTargetNumberOfActivePeers": 0,
+  "SyncTargetNumberOfEstablishedBigLedgerPeers": 50,
+  "SyncTargetNumberOfKnownBigLedgerPeers": 100,
   "TargetNumberOfActivePeers": 20,
   "TargetNumberOfEstablishedPeers": 40,
   "TargetNumberOfKnownPeers": 150,