docs: Merge #3416

cardano-foundation · Aug 3, 2022 · ac1dc9f · ac1dc9f
1 parent 898364b
commit ac1dc9f
Show file tree

Hide file tree

Showing 61 changed files with 108 additions and 66 deletions.
diff --git a/-/all.html b/-/all.html
@@ -26,7 +26,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/-/tags.html b/-/tags.html
@@ -26,7 +26,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/-/tasks.html b/-/tasks.html
@@ -26,7 +26,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/api/edge/swagger.yaml b/api/edge/swagger.yaml
@@ -2202,13 +2202,55 @@ components:
         minimum_utxo_value:
           <<: *amount
           description: |
-            The minimum ada / Lovelace quantity required for new transaction outputs.
+            The absolute minimum quantity of ada required for a new transaction
+            output created with the wallet.
+
+            In general, the ledger rules require that every transaction output
+            has a minimum quantity of ada. This minimum quantity is determined
+            by an era-specific function whose value increases as the number of
+            different assets increases, as the quantity of any individual asset
+            increases, as the length of the target address increases, and if a
+            datum hash is added.
+
+            Therefore, the value reported by this field should only be viewed
+            as an absolute minimum, and only applies to outputs that send ada
+            (and no other assets) to Shelley-era addresses. If an output
+            contains other assets, specifies a datum hash, or sends funds to a
+            Byron-era address, then the minimum value required by the ledger
+            (and the wallet) will be higher than the value reported by this
+            field.
+
+            When using the wallet to construct or balance a transaction, if the
+            caller specifies an output with a non-zero ada quantity, then the
+            wallet will verify that the specified quantity is not less than the
+            minimum quantity required by the ledger, and if this verification
+            step fails, return an error that reports the required minimum. If
+            the caller specifies an output without an ada quantity, then the
+            wallet will automatically assign a minimal ada quantity to that
+            output.
+
+            In the Shelley, Allegra, and Mary eras, the `minimum_utxo_value`
+            field was equivalent to the ledger `minUTxOValue` protocol
+            parameter.
+
+            In the Alonzo era, the `minUTxOValue` protocol parameter was
+            replaced by the `coinsPerUTxOWord` protocol parameter. In this era,
+            the minimum ada quantity for an output was determined by
+            multiplying the `coinsPerUTxOWord` parameter by the length (in
+            8-byte words) of the in-memory representation of that output, which
+            was not dependent on the length of the address. Therefore, in this
+            era, specifying a longer address would not require an increase in
+            the minimum ada quantity.
+
+            In the Babbage era, the `coinsPerUTxOWord` protocol parameter was
+            replaced by the `coinsPerUTxOByte` protocol parameter. In this era,
+            the minimum ada quantity for an output is determined by multiplying
+            the `coinsPerUTxOByte` parameter by the length (in bytes) of the
+            serialised representation of the output, which is dependent on the
+            length of the address (among other factors).  Therefore, in this
+            era, specifying a longer address will require an increase in the
+            minimum ada quantity.
 
-            It is only applicable for pure-ada outputs. If outputs contain other assets
-            or a datum hash, the true minimum will be higher than this value.
-
-            With Alonzo, `minimum_utxo_value` is not a real protocol parameter, but rather
-            derived from from the Alonzo genesis `adaPerUTxOWord`.
         eras: *ApiEraInfo
         maximum_collateral_input_count:
           <<: *collateralInputCount

diff --git a/archives.html b/archives.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/archives/jormungandr.html b/archives/jormungandr.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/archives/jormungandr/Docker-jormungandr.html b/archives/jormungandr/Docker-jormungandr.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/archives/jormungandr/cardano-wallet-jormungandr-manual.html b/archives/jormungandr/cardano-wallet-jormungandr-manual.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts.html b/concepts.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/address-derivation.html b/concepts/address-derivation.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/byron-address-format.html b/concepts/byron-address-format.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/coin-selection.html b/concepts/coin-selection.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/hierarchical-deterministic-wallets.html b/concepts/hierarchical-deterministic-wallets.html
@@ -37,7 +37,7 @@
 <script async id='MathJax-script' src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js'></script>
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/master-key-generation.html b/concepts/master-key-generation.html
@@ -30,7 +30,7 @@
 <script src='https://cdnjs.cloudflare.com/ajax/libs/prism/1.26.0/plugins/autoloader/prism-autoloader.min.js'></script>
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/recovery-phrases.html b/concepts/recovery-phrases.html
@@ -31,7 +31,7 @@
 <script async id='MathJax-script' src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js'></script>
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/transaction-lifecycle.html b/concepts/transaction-lifecycle.html
@@ -49,7 +49,7 @@
 </script>
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/concepts/utxo.html b/concepts/utxo.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing.html b/contributing.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Hydra.html b/contributing/Hydra.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Logging-Guidelines.html b/contributing/Logging-Guidelines.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Nix.html b/contributing/Nix.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Notes-from-upgrading-GHC-version.html b/contributing/Notes-from-upgrading-GHC-version.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Release-Process.html b/contributing/Release-Process.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Swagger-Development.html b/contributing/Swagger-Development.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Testing.html b/contributing/Testing.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/contributing/Updating-Dependencies.html b/contributing/Updating-Dependencies.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design.html b/design.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/Eras.html b/design/Eras.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/Notes-about-BIP-44.html b/design/Notes-about-BIP-44.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/Specifying-exceptions-with-Servant-and-Swagger.html b/design/Specifying-exceptions-with-Servant-and-Swagger.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/WalletId.html b/design/WalletId.html
@@ -41,7 +41,7 @@
 <script async id='MathJax-script' src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js'></script>
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/records.html b/design/records.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/records/2021-01-17-nix-flake.html b/design/records/2021-01-17-nix-flake.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/specs.html b/design/specs.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/design/specs/light-mode.html b/design/specs/light-mode.html
@@ -49,7 +49,7 @@
 </script>
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/developers.html b/developers.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/developers/Architecture.html b/developers/Architecture.html
@@ -49,7 +49,7 @@
 </script>
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>

diff --git a/developers/Building.html b/developers/Building.html
@@ -27,7 +27,7 @@
 
 
 
-  <link href='tailwind.css?instanceId=59926af5-97e4-40ef-8428-4660581f6f6f' rel='stylesheet' type='text/css' />
+  <link href='tailwind.css?instanceId=f18b8765-7a19-4548-8a6a-26cc6e3aafe0' rel='stylesheet' type='text/css' />
 
   <!-- Heist error element -->
   <style type='text/css'>