diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help.cli index 82614eb69b..a36b73926a 100644 --- a/cardano-cli/test/cardano-cli-golden/files/golden/help.cli +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help.cli @@ -3194,6 +3194,7 @@ Usage: cardano-cli mary text-view decode-cbor --in-file FILE [--out-file FILE] Usage: cardano-cli mary transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -3458,6 +3459,126 @@ Usage: cardano-cli mary transaction build --socket-path SOCKET_PATH Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m +Usage: cardano-cli mary transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + Usage: cardano-cli mary transaction sign (--tx-body-file FILE | --tx-file FILE) [--signing-key-file FILE [--address STRING]] @@ -4380,6 +4501,7 @@ Usage: cardano-cli alonzo text-view decode-cbor --in-file FILE [--out-file FILE] Usage: cardano-cli alonzo transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -4646,6 +4768,126 @@ Usage: cardano-cli alonzo transaction build --socket-path SOCKET_PATH Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m +Usage: cardano-cli alonzo transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + Usage: cardano-cli alonzo transaction sign ( --tx-body-file FILE | --tx-file FILE @@ -5598,6 +5840,7 @@ Usage: cardano-cli babbage text-view decode-cbor --in-file FILE Usage: cardano-cli babbage transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -5864,6 +6107,126 @@ Usage: cardano-cli babbage transaction build --socket-path SOCKET_PATH Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m +Usage: cardano-cli babbage transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + Usage: cardano-cli babbage transaction sign ( --tx-body-file FILE | --tx-file FILE @@ -7241,6 +7604,7 @@ Usage: cardano-cli conway text-view decode-cbor --in-file FILE [--out-file FILE] Usage: cardano-cli conway transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -7533,6 +7897,137 @@ Usage: cardano-cli conway transaction build --socket-path SOCKET_PATH Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m +Usage: cardano-cli conway transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--vote-file FILE + [--vote-script-file FILE + [ --vote-redeemer-cbor-file CBOR FILE + | --vote-redeemer-file JSON FILE + | --vote-redeemer-value JSON VALUE + ]]] + [--proposal-file FILE + [--proposal-script-file FILE + [ --proposal-redeemer-cbor-file CBOR FILE + | --proposal-redeemer-file JSON FILE + | --proposal-redeemer-value JSON VALUE + ]]] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + Usage: cardano-cli conway transaction sign ( --tx-body-file FILE | --tx-file FILE @@ -8482,6 +8977,7 @@ Usage: cardano-cli latest text-view decode-cbor --in-file FILE [--out-file FILE] Usage: cardano-cli latest transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -8748,6 +9244,126 @@ Usage: cardano-cli latest transaction build --socket-path SOCKET_PATH Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m +Usage: cardano-cli latest transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + Usage: cardano-cli latest transaction sign ( --tx-body-file FILE | --tx-file FILE diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/alonzo_transaction.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/alonzo_transaction.cli index 6a064b01c7..f4069516e8 100644 --- a/cardano-cli/test/cardano-cli-golden/files/golden/help/alonzo_transaction.cli +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/alonzo_transaction.cli @@ -1,6 +1,7 @@ Usage: cardano-cli alonzo transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -24,6 +25,9 @@ Available commands: Please note the order of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m build Build a balanced transaction (automatically calculates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + build-estimate Build a balanced transaction without access to a live node (automatically estimates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m sign Sign a transaction witness Create a transaction witness diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/alonzo_transaction_build-estimate.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/alonzo_transaction_build-estimate.cli new file mode 100644 index 0000000000..826d8d149d --- /dev/null +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/alonzo_transaction_build-estimate.cli @@ -0,0 +1,382 @@ +Usage: cardano-cli alonzo transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + +Available options: + --script-valid Assertion that the script is valid. (default) + --script-invalid Assertion that the script is invalid. If a + transaction is submitted with such a script, the + script will fail and the collateral will be taken. + --shelley-key-witnesses INT + Specify the number of Shelley key witnesses the + transaction requires. + --byron-key-witnesses Int + Specify the number of Byron key witnesses the + transaction requires. + --protocol-params-file FILE + Filepath of the JSON-encoded protocol parameters file + --total-utxo-value VALUE The total value of the UTxO that exists at the tx + inputs being spent. + --tx-in TX-IN TxId#TxIx + --spending-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --spending-plutus-script-v2 + Specify a plutus script v2 reference script. + --spending-plutus-script-v3 + Specify a plutus script v3 reference script. + --spending-reference-tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --spending-reference-tx-in-inline-datum-present + Inline datum present at transaction input. + --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --tx-in-script-file FILE The file containing the script to witness the + spending of the transaction input. + --tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-in-inline-datum-present + Inline datum present at transaction input. + --tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --read-only-tx-in-reference TX-IN + Specify a read only reference input. This reference + input is not witnessing anything it is simply + provided in the plutus script context. + --required-signer FILE Input filepath of the signing key (zero or more) + whose signature is required. + --required-signer-hash HASH + Hash of the verification key (zero or more) whose + signature is required. + --tx-in-collateral TX-IN TxId#TxIx + --tx-out-return-collateral ADDRESS VALUE + The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in Lovelace. In the situation where your collateral + txin over collateralizes the transaction, you can + optionally specify a tx out of your choosing to + return the excess Lovelace. + --tx-total-collateral INTEGER + The total amount of collateral that will be collected + as fees in the event of a Plutus script failure. Must + be used in conjuction with + "--tx-out-return-collateral". + --tx-out ADDRESS VALUE The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in the multi-asset syntax (including simply + Lovelace). + --tx-out-datum-hash HASH The script datum hash for this tx output, as the raw + datum hash (in hex). + --tx-out-datum-hash-cbor-file CBOR FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-file JSON FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-value JSON VALUE + The script datum hash for this tx output, by hashing + the script datum given here in JSON syntax. There is + no schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-datum-embed-cbor-file CBOR FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-file JSON FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-value JSON VALUE + The script datum to embed in the tx for this output, + given here in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-out-inline-datum-cbor-file CBOR FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-file JSON FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-value JSON VALUE + The script datum to embed in the tx output as an + inline datum, given here in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-reference-script-file FILE + Reference script input file. + --change-address ADDRESS Address where ADA in excess of the tx fee will go to. + --mint VALUE Mint multi-asset value(s) with the multi-asset cli + syntax. You must specify a script witness. + --mint-script-file FILE The file containing the script to witness the minting + of assets for a particular policy Id. + --mint-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-minting-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --policy-id HASH Policy id of minting script. + --mint-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --mint-plutus-script-v2 Specify a plutus script v2 reference script. + --mint-plutus-script-v3 Specify a plutus script v3 reference script. + --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --policy-id HASH Policy id of minting script. + --invalid-before SLOT Time that transaction is valid from (in slots). + --invalid-hereafter SLOT Time that transaction is valid until (in slots). + --certificate-file FILE Filepath of the certificate. This encompasses all + types of certificates (stake pool certificates, stake + key certificates etc). Optionally specify a script + witness. + --certificate-script-file FILE + The file containing the script to witness the use of + the certificate. + --certificate-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --certificate-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --certificate-plutus-script-v2 + Specify a plutus script v2 reference script. + --certificate-plutus-script-v3 + Specify a plutus script v3 reference script. + --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal WITHDRAWAL The reward withdrawal as StakeAddress+Lovelace where + StakeAddress is the Bech32-encoded stake address + followed by the amount in Lovelace. Optionally + specify a script witness. + --withdrawal-script-file FILE + The file containing the script to witness the + withdrawal of rewards. + --withdrawal-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --withdrawal-plutus-script-v2 + Specify a plutus script v2 reference script. + --withdrawal-plutus-script-v3 + Specify a plutus script v3 reference script. + --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --json-metadata-no-schema + Use the "no schema" conversion from JSON to tx + metadata (default). + --json-metadata-detailed-schema + Use the "detailed schema" conversion from JSON to tx + metadata. + --auxiliary-script-file FILE + Filepath of auxiliary script(s) + --metadata-json-file FILE + Filepath of the metadata file, in JSON format. + --metadata-cbor-file FILE + Filepath of the metadata, in raw CBOR format. + --update-proposal-file FILE + Filepath of the update proposal. + --out-file FILE Output filepath of the JSON TxBody. + -h,--help Show this help text diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/babbage_transaction.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/babbage_transaction.cli index 7ce4e29691..d999ca5ec8 100644 --- a/cardano-cli/test/cardano-cli-golden/files/golden/help/babbage_transaction.cli +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/babbage_transaction.cli @@ -1,6 +1,7 @@ Usage: cardano-cli babbage transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -24,6 +25,9 @@ Available commands: Please note the order of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m build Build a balanced transaction (automatically calculates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + build-estimate Build a balanced transaction without access to a live node (automatically estimates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m sign Sign a transaction witness Create a transaction witness diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/babbage_transaction_build-estimate.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/babbage_transaction_build-estimate.cli new file mode 100644 index 0000000000..5a10fc44b3 --- /dev/null +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/babbage_transaction_build-estimate.cli @@ -0,0 +1,382 @@ +Usage: cardano-cli babbage transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + +Available options: + --script-valid Assertion that the script is valid. (default) + --script-invalid Assertion that the script is invalid. If a + transaction is submitted with such a script, the + script will fail and the collateral will be taken. + --shelley-key-witnesses INT + Specify the number of Shelley key witnesses the + transaction requires. + --byron-key-witnesses Int + Specify the number of Byron key witnesses the + transaction requires. + --protocol-params-file FILE + Filepath of the JSON-encoded protocol parameters file + --total-utxo-value VALUE The total value of the UTxO that exists at the tx + inputs being spent. + --tx-in TX-IN TxId#TxIx + --spending-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --spending-plutus-script-v2 + Specify a plutus script v2 reference script. + --spending-plutus-script-v3 + Specify a plutus script v3 reference script. + --spending-reference-tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --spending-reference-tx-in-inline-datum-present + Inline datum present at transaction input. + --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --tx-in-script-file FILE The file containing the script to witness the + spending of the transaction input. + --tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-in-inline-datum-present + Inline datum present at transaction input. + --tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --read-only-tx-in-reference TX-IN + Specify a read only reference input. This reference + input is not witnessing anything it is simply + provided in the plutus script context. + --required-signer FILE Input filepath of the signing key (zero or more) + whose signature is required. + --required-signer-hash HASH + Hash of the verification key (zero or more) whose + signature is required. + --tx-in-collateral TX-IN TxId#TxIx + --tx-out-return-collateral ADDRESS VALUE + The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in Lovelace. In the situation where your collateral + txin over collateralizes the transaction, you can + optionally specify a tx out of your choosing to + return the excess Lovelace. + --tx-total-collateral INTEGER + The total amount of collateral that will be collected + as fees in the event of a Plutus script failure. Must + be used in conjuction with + "--tx-out-return-collateral". + --tx-out ADDRESS VALUE The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in the multi-asset syntax (including simply + Lovelace). + --tx-out-datum-hash HASH The script datum hash for this tx output, as the raw + datum hash (in hex). + --tx-out-datum-hash-cbor-file CBOR FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-file JSON FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-value JSON VALUE + The script datum hash for this tx output, by hashing + the script datum given here in JSON syntax. There is + no schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-datum-embed-cbor-file CBOR FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-file JSON FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-value JSON VALUE + The script datum to embed in the tx for this output, + given here in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-out-inline-datum-cbor-file CBOR FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-file JSON FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-value JSON VALUE + The script datum to embed in the tx output as an + inline datum, given here in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-reference-script-file FILE + Reference script input file. + --change-address ADDRESS Address where ADA in excess of the tx fee will go to. + --mint VALUE Mint multi-asset value(s) with the multi-asset cli + syntax. You must specify a script witness. + --mint-script-file FILE The file containing the script to witness the minting + of assets for a particular policy Id. + --mint-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-minting-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --policy-id HASH Policy id of minting script. + --mint-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --mint-plutus-script-v2 Specify a plutus script v2 reference script. + --mint-plutus-script-v3 Specify a plutus script v3 reference script. + --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --policy-id HASH Policy id of minting script. + --invalid-before SLOT Time that transaction is valid from (in slots). + --invalid-hereafter SLOT Time that transaction is valid until (in slots). + --certificate-file FILE Filepath of the certificate. This encompasses all + types of certificates (stake pool certificates, stake + key certificates etc). Optionally specify a script + witness. + --certificate-script-file FILE + The file containing the script to witness the use of + the certificate. + --certificate-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --certificate-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --certificate-plutus-script-v2 + Specify a plutus script v2 reference script. + --certificate-plutus-script-v3 + Specify a plutus script v3 reference script. + --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal WITHDRAWAL The reward withdrawal as StakeAddress+Lovelace where + StakeAddress is the Bech32-encoded stake address + followed by the amount in Lovelace. Optionally + specify a script witness. + --withdrawal-script-file FILE + The file containing the script to witness the + withdrawal of rewards. + --withdrawal-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --withdrawal-plutus-script-v2 + Specify a plutus script v2 reference script. + --withdrawal-plutus-script-v3 + Specify a plutus script v3 reference script. + --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --json-metadata-no-schema + Use the "no schema" conversion from JSON to tx + metadata (default). + --json-metadata-detailed-schema + Use the "detailed schema" conversion from JSON to tx + metadata. + --auxiliary-script-file FILE + Filepath of auxiliary script(s) + --metadata-json-file FILE + Filepath of the metadata file, in JSON format. + --metadata-cbor-file FILE + Filepath of the metadata, in raw CBOR format. + --update-proposal-file FILE + Filepath of the update proposal. + --out-file FILE Output filepath of the JSON TxBody. + -h,--help Show this help text diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/conway_transaction.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/conway_transaction.cli index c9b96b761c..44c0dd0abe 100644 --- a/cardano-cli/test/cardano-cli-golden/files/golden/help/conway_transaction.cli +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/conway_transaction.cli @@ -1,6 +1,7 @@ Usage: cardano-cli conway transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -24,6 +25,9 @@ Available commands: Please note the order of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m build Build a balanced transaction (automatically calculates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + build-estimate Build a balanced transaction without access to a live node (automatically estimates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m sign Sign a transaction witness Create a transaction witness diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/conway_transaction_build-estimate.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/conway_transaction_build-estimate.cli new file mode 100644 index 0000000000..b8f231ee10 --- /dev/null +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/conway_transaction_build-estimate.cli @@ -0,0 +1,416 @@ +Usage: cardano-cli conway transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--vote-file FILE + [--vote-script-file FILE + [ --vote-redeemer-cbor-file CBOR FILE + | --vote-redeemer-file JSON FILE + | --vote-redeemer-value JSON VALUE + ]]] + [--proposal-file FILE + [--proposal-script-file FILE + [ --proposal-redeemer-cbor-file CBOR FILE + | --proposal-redeemer-file JSON FILE + | --proposal-redeemer-value JSON VALUE + ]]] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + +Available options: + --script-valid Assertion that the script is valid. (default) + --script-invalid Assertion that the script is invalid. If a + transaction is submitted with such a script, the + script will fail and the collateral will be taken. + --shelley-key-witnesses INT + Specify the number of Shelley key witnesses the + transaction requires. + --byron-key-witnesses Int + Specify the number of Byron key witnesses the + transaction requires. + --protocol-params-file FILE + Filepath of the JSON-encoded protocol parameters file + --total-utxo-value VALUE The total value of the UTxO that exists at the tx + inputs being spent. + --tx-in TX-IN TxId#TxIx + --spending-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --spending-plutus-script-v2 + Specify a plutus script v2 reference script. + --spending-plutus-script-v3 + Specify a plutus script v3 reference script. + --spending-reference-tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --spending-reference-tx-in-inline-datum-present + Inline datum present at transaction input. + --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --tx-in-script-file FILE The file containing the script to witness the + spending of the transaction input. + --tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-in-inline-datum-present + Inline datum present at transaction input. + --tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --read-only-tx-in-reference TX-IN + Specify a read only reference input. This reference + input is not witnessing anything it is simply + provided in the plutus script context. + --required-signer FILE Input filepath of the signing key (zero or more) + whose signature is required. + --required-signer-hash HASH + Hash of the verification key (zero or more) whose + signature is required. + --tx-in-collateral TX-IN TxId#TxIx + --tx-out-return-collateral ADDRESS VALUE + The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in Lovelace. In the situation where your collateral + txin over collateralizes the transaction, you can + optionally specify a tx out of your choosing to + return the excess Lovelace. + --tx-total-collateral INTEGER + The total amount of collateral that will be collected + as fees in the event of a Plutus script failure. Must + be used in conjuction with + "--tx-out-return-collateral". + --tx-out ADDRESS VALUE The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in the multi-asset syntax (including simply + Lovelace). + --tx-out-datum-hash HASH The script datum hash for this tx output, as the raw + datum hash (in hex). + --tx-out-datum-hash-cbor-file CBOR FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-file JSON FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-value JSON VALUE + The script datum hash for this tx output, by hashing + the script datum given here in JSON syntax. There is + no schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-datum-embed-cbor-file CBOR FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-file JSON FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-value JSON VALUE + The script datum to embed in the tx for this output, + given here in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-out-inline-datum-cbor-file CBOR FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-file JSON FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-value JSON VALUE + The script datum to embed in the tx output as an + inline datum, given here in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-reference-script-file FILE + Reference script input file. + --change-address ADDRESS Address where ADA in excess of the tx fee will go to. + --mint VALUE Mint multi-asset value(s) with the multi-asset cli + syntax. You must specify a script witness. + --mint-script-file FILE The file containing the script to witness the minting + of assets for a particular policy Id. + --mint-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-minting-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --policy-id HASH Policy id of minting script. + --mint-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --mint-plutus-script-v2 Specify a plutus script v2 reference script. + --mint-plutus-script-v3 Specify a plutus script v3 reference script. + --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --policy-id HASH Policy id of minting script. + --invalid-before SLOT Time that transaction is valid from (in slots). + --invalid-hereafter SLOT Time that transaction is valid until (in slots). + --certificate-file FILE Filepath of the certificate. This encompasses all + types of certificates (stake pool certificates, stake + key certificates etc). Optionally specify a script + witness. + --certificate-script-file FILE + The file containing the script to witness the use of + the certificate. + --certificate-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --certificate-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --certificate-plutus-script-v2 + Specify a plutus script v2 reference script. + --certificate-plutus-script-v3 + Specify a plutus script v3 reference script. + --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal WITHDRAWAL The reward withdrawal as StakeAddress+Lovelace where + StakeAddress is the Bech32-encoded stake address + followed by the amount in Lovelace. Optionally + specify a script witness. + --withdrawal-script-file FILE + The file containing the script to witness the + withdrawal of rewards. + --withdrawal-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --withdrawal-plutus-script-v2 + Specify a plutus script v2 reference script. + --withdrawal-plutus-script-v3 + Specify a plutus script v3 reference script. + --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --json-metadata-no-schema + Use the "no schema" conversion from JSON to tx + metadata (default). + --json-metadata-detailed-schema + Use the "detailed schema" conversion from JSON to tx + metadata. + --auxiliary-script-file FILE + Filepath of auxiliary script(s) + --metadata-json-file FILE + Filepath of the metadata file, in JSON format. + --metadata-cbor-file FILE + Filepath of the metadata, in raw CBOR format. + --vote-file FILE Filepath of the vote. + --vote-script-file FILE The file containing the script to witness a vote + --vote-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --vote-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --vote-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --proposal-file FILE Filepath of the proposal. + --proposal-script-file FILE + The file containing the script to witness a proposal + --proposal-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --proposal-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --proposal-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --out-file FILE Output filepath of the JSON TxBody. + -h,--help Show this help text diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/latest_transaction.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/latest_transaction.cli index c101f6a801..b420a63295 100644 --- a/cardano-cli/test/cardano-cli-golden/files/golden/help/latest_transaction.cli +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/latest_transaction.cli @@ -1,6 +1,7 @@ Usage: cardano-cli latest transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -24,6 +25,9 @@ Available commands: Please note the order of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m build Build a balanced transaction (automatically calculates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + build-estimate Build a balanced transaction without access to a live node (automatically estimates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m sign Sign a transaction witness Create a transaction witness diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/latest_transaction_build-estimate.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/latest_transaction_build-estimate.cli new file mode 100644 index 0000000000..e572321d76 --- /dev/null +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/latest_transaction_build-estimate.cli @@ -0,0 +1,382 @@ +Usage: cardano-cli latest transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + +Available options: + --script-valid Assertion that the script is valid. (default) + --script-invalid Assertion that the script is invalid. If a + transaction is submitted with such a script, the + script will fail and the collateral will be taken. + --shelley-key-witnesses INT + Specify the number of Shelley key witnesses the + transaction requires. + --byron-key-witnesses Int + Specify the number of Byron key witnesses the + transaction requires. + --protocol-params-file FILE + Filepath of the JSON-encoded protocol parameters file + --total-utxo-value VALUE The total value of the UTxO that exists at the tx + inputs being spent. + --tx-in TX-IN TxId#TxIx + --spending-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --spending-plutus-script-v2 + Specify a plutus script v2 reference script. + --spending-plutus-script-v3 + Specify a plutus script v3 reference script. + --spending-reference-tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --spending-reference-tx-in-inline-datum-present + Inline datum present at transaction input. + --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --tx-in-script-file FILE The file containing the script to witness the + spending of the transaction input. + --tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-in-inline-datum-present + Inline datum present at transaction input. + --tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --read-only-tx-in-reference TX-IN + Specify a read only reference input. This reference + input is not witnessing anything it is simply + provided in the plutus script context. + --required-signer FILE Input filepath of the signing key (zero or more) + whose signature is required. + --required-signer-hash HASH + Hash of the verification key (zero or more) whose + signature is required. + --tx-in-collateral TX-IN TxId#TxIx + --tx-out-return-collateral ADDRESS VALUE + The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in Lovelace. In the situation where your collateral + txin over collateralizes the transaction, you can + optionally specify a tx out of your choosing to + return the excess Lovelace. + --tx-total-collateral INTEGER + The total amount of collateral that will be collected + as fees in the event of a Plutus script failure. Must + be used in conjuction with + "--tx-out-return-collateral". + --tx-out ADDRESS VALUE The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in the multi-asset syntax (including simply + Lovelace). + --tx-out-datum-hash HASH The script datum hash for this tx output, as the raw + datum hash (in hex). + --tx-out-datum-hash-cbor-file CBOR FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-file JSON FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-value JSON VALUE + The script datum hash for this tx output, by hashing + the script datum given here in JSON syntax. There is + no schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-datum-embed-cbor-file CBOR FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-file JSON FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-value JSON VALUE + The script datum to embed in the tx for this output, + given here in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-out-inline-datum-cbor-file CBOR FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-file JSON FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-value JSON VALUE + The script datum to embed in the tx output as an + inline datum, given here in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-reference-script-file FILE + Reference script input file. + --change-address ADDRESS Address where ADA in excess of the tx fee will go to. + --mint VALUE Mint multi-asset value(s) with the multi-asset cli + syntax. You must specify a script witness. + --mint-script-file FILE The file containing the script to witness the minting + of assets for a particular policy Id. + --mint-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-minting-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --policy-id HASH Policy id of minting script. + --mint-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --mint-plutus-script-v2 Specify a plutus script v2 reference script. + --mint-plutus-script-v3 Specify a plutus script v3 reference script. + --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --policy-id HASH Policy id of minting script. + --invalid-before SLOT Time that transaction is valid from (in slots). + --invalid-hereafter SLOT Time that transaction is valid until (in slots). + --certificate-file FILE Filepath of the certificate. This encompasses all + types of certificates (stake pool certificates, stake + key certificates etc). Optionally specify a script + witness. + --certificate-script-file FILE + The file containing the script to witness the use of + the certificate. + --certificate-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --certificate-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --certificate-plutus-script-v2 + Specify a plutus script v2 reference script. + --certificate-plutus-script-v3 + Specify a plutus script v3 reference script. + --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal WITHDRAWAL The reward withdrawal as StakeAddress+Lovelace where + StakeAddress is the Bech32-encoded stake address + followed by the amount in Lovelace. Optionally + specify a script witness. + --withdrawal-script-file FILE + The file containing the script to witness the + withdrawal of rewards. + --withdrawal-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --withdrawal-plutus-script-v2 + Specify a plutus script v2 reference script. + --withdrawal-plutus-script-v3 + Specify a plutus script v3 reference script. + --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --json-metadata-no-schema + Use the "no schema" conversion from JSON to tx + metadata (default). + --json-metadata-detailed-schema + Use the "detailed schema" conversion from JSON to tx + metadata. + --auxiliary-script-file FILE + Filepath of auxiliary script(s) + --metadata-json-file FILE + Filepath of the metadata file, in JSON format. + --metadata-cbor-file FILE + Filepath of the metadata, in raw CBOR format. + --update-proposal-file FILE + Filepath of the update proposal. + --out-file FILE Output filepath of the JSON TxBody. + -h,--help Show this help text diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/mary_transaction.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/mary_transaction.cli index b14fdcfb21..24bfb695aa 100644 --- a/cardano-cli/test/cardano-cli-golden/files/golden/help/mary_transaction.cli +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/mary_transaction.cli @@ -1,6 +1,7 @@ Usage: cardano-cli mary transaction ( build-raw | build + | build-estimate | sign | witness | assemble @@ -24,6 +25,9 @@ Available commands: Please note the order of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m build Build a balanced transaction (automatically calculates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + build-estimate Build a balanced transaction without access to a live node (automatically estimates fees) + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m sign Sign a transaction witness Create a transaction witness diff --git a/cardano-cli/test/cardano-cli-golden/files/golden/help/mary_transaction_build-estimate.cli b/cardano-cli/test/cardano-cli-golden/files/golden/help/mary_transaction_build-estimate.cli new file mode 100644 index 0000000000..0104f2b2b4 --- /dev/null +++ b/cardano-cli/test/cardano-cli-golden/files/golden/help/mary_transaction_build-estimate.cli @@ -0,0 +1,382 @@ +Usage: cardano-cli mary transaction build-estimate + [ --script-valid + | --script-invalid + ] + --shelley-key-witnesses INT + [--byron-key-witnesses Int] + --protocol-params-file FILE + --total-utxo-value VALUE + (--tx-in TX-IN + [ --spending-tx-in-reference TX-IN + ( --spending-plutus-script-v2 + | --spending-plutus-script-v3 + ) + ( --spending-reference-tx-in-datum-cbor-file CBOR FILE + | --spending-reference-tx-in-datum-file JSON FILE + | --spending-reference-tx-in-datum-value JSON VALUE + | --spending-reference-tx-in-inline-datum-present + ) + ( --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + | --spending-reference-tx-in-redeemer-file JSON FILE + | --spending-reference-tx-in-redeemer-value JSON VALUE + ) + | --simple-script-tx-in-reference TX-IN + | --tx-in-script-file FILE + [ + ( --tx-in-datum-cbor-file CBOR FILE + | --tx-in-datum-file JSON FILE + | --tx-in-datum-value JSON VALUE + | --tx-in-inline-datum-present + ) + ( --tx-in-redeemer-cbor-file CBOR FILE + | --tx-in-redeemer-file JSON FILE + | --tx-in-redeemer-value JSON VALUE + )] + ]) + [--read-only-tx-in-reference TX-IN] + [ --required-signer FILE + | --required-signer-hash HASH + ] + [--tx-in-collateral TX-IN] + [--tx-out-return-collateral ADDRESS VALUE] + --tx-total-collateral INTEGER + [--tx-out ADDRESS VALUE + [ --tx-out-datum-hash HASH + | --tx-out-datum-hash-cbor-file CBOR FILE + | --tx-out-datum-hash-file JSON FILE + | --tx-out-datum-hash-value JSON VALUE + | --tx-out-datum-embed-cbor-file CBOR FILE + | --tx-out-datum-embed-file JSON FILE + | --tx-out-datum-embed-value JSON VALUE + | --tx-out-inline-datum-cbor-file CBOR FILE + | --tx-out-inline-datum-file JSON FILE + | --tx-out-inline-datum-value JSON VALUE + ] + [--tx-out-reference-script-file FILE]] + --change-address ADDRESS + [--mint VALUE + ( --mint-script-file FILE + [ --mint-redeemer-cbor-file CBOR FILE + | --mint-redeemer-file JSON FILE + | --mint-redeemer-value JSON VALUE + ] + | --simple-minting-script-tx-in-reference TX-IN + --policy-id HASH + | --mint-tx-in-reference TX-IN + ( --mint-plutus-script-v2 + | --mint-plutus-script-v3 + ) + ( --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + | --mint-reference-tx-in-redeemer-file JSON FILE + | --mint-reference-tx-in-redeemer-value JSON VALUE + ) + --policy-id HASH + )] + [--invalid-before SLOT] + [--invalid-hereafter SLOT] + [--certificate-file FILE + [ --certificate-script-file FILE + [ --certificate-redeemer-cbor-file CBOR FILE + | --certificate-redeemer-file JSON FILE + | --certificate-redeemer-value JSON VALUE + ] + | --certificate-tx-in-reference TX-IN + ( --certificate-plutus-script-v2 + | --certificate-plutus-script-v3 + ) + ( --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + | --certificate-reference-tx-in-redeemer-file JSON FILE + | --certificate-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [--withdrawal WITHDRAWAL + [ --withdrawal-script-file FILE + [ --withdrawal-redeemer-cbor-file CBOR FILE + | --withdrawal-redeemer-file JSON FILE + | --withdrawal-redeemer-value JSON VALUE + ] + | --withdrawal-tx-in-reference TX-IN + ( --withdrawal-plutus-script-v2 + | --withdrawal-plutus-script-v3 + ) + ( --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + | --withdrawal-reference-tx-in-redeemer-file JSON FILE + | --withdrawal-reference-tx-in-redeemer-value JSON VALUE + ) + ]] + [ --json-metadata-no-schema + | --json-metadata-detailed-schema + ] + [--auxiliary-script-file FILE] + [ --metadata-json-file FILE + | --metadata-cbor-file FILE + ] + [--update-proposal-file FILE] + --out-file FILE + + Build a balanced transaction without access to a live node (automatically estimates fees) + + Please note the order[93;22;23;24m of some cmd options is crucial. If used incorrectly may produce undesired tx body. See nested [] notation above for details.[0;22;23;24m + +Available options: + --script-valid Assertion that the script is valid. (default) + --script-invalid Assertion that the script is invalid. If a + transaction is submitted with such a script, the + script will fail and the collateral will be taken. + --shelley-key-witnesses INT + Specify the number of Shelley key witnesses the + transaction requires. + --byron-key-witnesses Int + Specify the number of Byron key witnesses the + transaction requires. + --protocol-params-file FILE + Filepath of the JSON-encoded protocol parameters file + --total-utxo-value VALUE The total value of the UTxO that exists at the tx + inputs being spent. + --tx-in TX-IN TxId#TxIx + --spending-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --spending-plutus-script-v2 + Specify a plutus script v2 reference script. + --spending-plutus-script-v3 + Specify a plutus script v3 reference script. + --spending-reference-tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --spending-reference-tx-in-inline-datum-present + Inline datum present at transaction input. + --spending-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --spending-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --tx-in-script-file FILE The file containing the script to witness the + spending of the transaction input. + --tx-in-datum-cbor-file CBOR FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-file JSON FILE + The script datum, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-datum-value JSON VALUE + The script datum, in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-in-inline-datum-present + Inline datum present at transaction input. + --tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --read-only-tx-in-reference TX-IN + Specify a read only reference input. This reference + input is not witnessing anything it is simply + provided in the plutus script context. + --required-signer FILE Input filepath of the signing key (zero or more) + whose signature is required. + --required-signer-hash HASH + Hash of the verification key (zero or more) whose + signature is required. + --tx-in-collateral TX-IN TxId#TxIx + --tx-out-return-collateral ADDRESS VALUE + The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in Lovelace. In the situation where your collateral + txin over collateralizes the transaction, you can + optionally specify a tx out of your choosing to + return the excess Lovelace. + --tx-total-collateral INTEGER + The total amount of collateral that will be collected + as fees in the event of a Plutus script failure. Must + be used in conjuction with + "--tx-out-return-collateral". + --tx-out ADDRESS VALUE The transaction output as ADDRESS VALUE where ADDRESS + is the Bech32-encoded address followed by the value + in the multi-asset syntax (including simply + Lovelace). + --tx-out-datum-hash HASH The script datum hash for this tx output, as the raw + datum hash (in hex). + --tx-out-datum-hash-cbor-file CBOR FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-file JSON FILE + The script datum hash for this tx output, by hashing + the script datum in the given JSON file. The file + must follow the special JSON schema for script data. + --tx-out-datum-hash-value JSON VALUE + The script datum hash for this tx output, by hashing + the script datum given here in JSON syntax. There is + no schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-datum-embed-cbor-file CBOR FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-file JSON FILE + The script datum to embed in the tx for this output, + in the given JSON file. The file must follow the + special JSON schema for script data. + --tx-out-datum-embed-value JSON VALUE + The script datum to embed in the tx for this output, + given here in JSON syntax. There is no schema: + (almost) any JSON value is supported, including + top-level strings and numbers. + --tx-out-inline-datum-cbor-file CBOR FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-file JSON FILE + The script datum to embed in the tx output as an + inline datum, in the given JSON file. The file must + follow the special JSON schema for script data. + --tx-out-inline-datum-value JSON VALUE + The script datum to embed in the tx output as an + inline datum, given here in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --tx-out-reference-script-file FILE + Reference script input file. + --change-address ADDRESS Address where ADA in excess of the tx fee will go to. + --mint VALUE Mint multi-asset value(s) with the multi-asset cli + syntax. You must specify a script witness. + --mint-script-file FILE The file containing the script to witness the minting + of assets for a particular policy Id. + --mint-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --simple-minting-script-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a simple reference script attached. + --policy-id HASH Policy id of minting script. + --mint-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --mint-plutus-script-v2 Specify a plutus script v2 reference script. + --mint-plutus-script-v3 Specify a plutus script v3 reference script. + --mint-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --mint-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --policy-id HASH Policy id of minting script. + --invalid-before SLOT Time that transaction is valid from (in slots). + --invalid-hereafter SLOT Time that transaction is valid until (in slots). + --certificate-file FILE Filepath of the certificate. This encompasses all + types of certificates (stake pool certificates, stake + key certificates etc). Optionally specify a script + witness. + --certificate-script-file FILE + The file containing the script to witness the use of + the certificate. + --certificate-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --certificate-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --certificate-plutus-script-v2 + Specify a plutus script v2 reference script. + --certificate-plutus-script-v3 + Specify a plutus script v3 reference script. + --certificate-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --certificate-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal WITHDRAWAL The reward withdrawal as StakeAddress+Lovelace where + StakeAddress is the Bech32-encoded stake address + followed by the amount in Lovelace. Optionally + specify a script witness. + --withdrawal-script-file FILE + The file containing the script to witness the + withdrawal of rewards. + --withdrawal-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --withdrawal-tx-in-reference TX-IN + TxId#TxIx - Specify a reference input. The reference + input must have a plutus reference script attached. + --withdrawal-plutus-script-v2 + Specify a plutus script v2 reference script. + --withdrawal-plutus-script-v3 + Specify a plutus script v3 reference script. + --withdrawal-reference-tx-in-redeemer-cbor-file CBOR FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-file JSON FILE + The script redeemer, in the given JSON file. The file + must follow the special JSON schema for script data. + --withdrawal-reference-tx-in-redeemer-value JSON VALUE + The script redeemer, in JSON syntax. There is no + schema: (almost) any JSON value is supported, + including top-level strings and numbers. + --json-metadata-no-schema + Use the "no schema" conversion from JSON to tx + metadata (default). + --json-metadata-detailed-schema + Use the "detailed schema" conversion from JSON to tx + metadata. + --auxiliary-script-file FILE + Filepath of auxiliary script(s) + --metadata-json-file FILE + Filepath of the metadata file, in JSON format. + --metadata-cbor-file FILE + Filepath of the metadata, in raw CBOR format. + --update-proposal-file FILE + Filepath of the update proposal. + --out-file FILE Output filepath of the JSON TxBody. + -h,--help Show this help text