v0.5.0 Mock transaction witnesses and fee calculation support

Additional Signature Witness Support for Transaction Building

Support extra transaction signature witnesses (#11) for inputs from multi-sig (aka native-script) or multiple addresses, similar to the --witness-count parameter in the cardano-cli cardano-cli transaction calculate-min-fee command.

cscli transaction simple-payment build --network testnet --from addr_test1vq5zuhh9685fup86syuzmu3e6eengzv8t46mfqxg086cvqqc5zr4t --to addr_test1vpuuxlat45yxvtsk44y4pmwk854z4v9k879yfe99q3g3aagqqzar3 --ada 420 --message "thx for lunch" --mock-witness-count 2

Installation

The easiest way is to install the .NET SDK and install the global tool cscli.

dotnet tool install --global cscli

Alternatively, please download the platform-specific binaries in the release Assets below

Assets SHA256 Checksums

cscli.win-x64.exe: D37390DF304BE91E35AD2AA3EDC2BAE98358FD50A782C3F804FD689395894B7C
cscli.linux-x64: FE812BADB86179528B1088B4781DE6EDE2E8105AB40C527E1E3201FDF31BEFE5
cscli.osx-x64: 0AB90B28FECA9F6167A8BB520FC266E21D24A601FCDE6282B97A7353BC140FCF

Usage and Overview

Please see the README documentation

v0.4.0 New Transaction Commands & Change Key/Address Commands

New Transaction Commands

Build Simple Payment Transaction

Creates (+ optionally signs & submits) a transaction for a payment of ADA from an address to another address.

$ cscli transaction simple-payment build --network testnet --from addr_test1vq5zuhh9685fup86syuzmu3e6eengzv8t46mfqxg086cvqqc5zr4t --to addr_test1vpuuxlat45yxvtsk44y4pmwk854z4v9k879yfe99q3g3aagqqzar3 --ada 420 --message "thx for lunch"
84a50081825820dcfe996519321071430c812525393f431d75208428852491e9c0c6788dad5f9201018282581d6079c37fabad08662e16ad4950edd63d2a2ab0b63f8a44e4a504511ef51a1908b10082581d60282e5ee5d1e89e04fa81382df239d6733409875d75b480c879f586001a5cf39dd9021a00029ee5031a03afdc580758200088270ea98923127ef4c2e05b665b81b5a6c9fca1582eed1171ba17648f7b3da0f582a11902a2a1636d73676d74687820666f72206c756e636880

Build and Submit Signed Simple Payment

$ cscli transaction simple-payment build --submit true --signing-key addr_xsk1fzw9r482t0ekua7rcqewg3k8ju5d9run4juuehm2p24jtuzz4dg4wpeulnqhualvtx9lyy7u0h9pdjvmyhxdhzsyy49szs6y8c9zwfp0eqyrqyl290e6dr0q3fvngmsjn4aask9jjr6q34juh25hczw3euust0dw --network testnet --from addr_test1vq5zuhh9685fup86syuzmu3e6eengzv8t46mfqxg086cvqqc5zr4t --to addr_test1vpuuxlat45yxvtsk44y4pmwk854z4v9k879yfe99q3g3aagqqzar3 --ada 420 --message "thx for lunch"
5853cc86af075cc547a5a20658af54841f37a5832532a704c583ed4f010184a5

Build Signed Simple Payment Tx with cardano-cli Output File

$ cscli transaction simple-payment build --out-file tx.txsigned --signing-key addr_xsk1fzw9r482t0ekua7rcqewg3k8ju5d9run4juuehm2p24jtuzz4dg4wpeulnqhualvtx9lyy7u0h9pdjvmyhxdhzsyy49szs6y8c9zwfp0eqyrqyl290e6dr0q3fvngmsjn4aask9jjr6q34juh25hczw3euust0dw --network testnet --from addr_test1vq5zuhh9685fup86syuzmu3e6eengzv8t46mfqxg086cvqqc5zr4t --to addr_test1vpuuxlat45yxvtsk44y4pmwk854z4v9k879yfe99q3g3aagqqzar3 --ada 420 --message "thx for lunch"
84a500818258205853cc86af075cc547a5a20658af54841f37a5832532a704c583ed4f010184a501018282581d6079c37fabad08662e16ad4950edd63d2a2ab0b63f8a44e4a504511ef51a1908b10082581d60282e5ee5d1e89e04fa81382df239d6733409875d75b480c879f586001a43e80724021a0002c24d031a03afe00c0758200088270ea98923127ef4c2e05b665b81b5a6c9fca1582eed1171ba17648f7b3da10081825820de9503426759fa18624657f5bcc932f38220ec9eceb262907caf2d198b6e0faa584025f49ad0cb27c0a297ebd2237134be2803b19d11c6e52416d3d7beba130bbc2bd95eb9b7e9e7410d7efcd5c2abd338dd62100d86b26308636335b533873bb508f582a11902a2a1636d73676d74687820666f72206c756e636880
$ cat tx.txsigned
{
  "type": "Tx AlonzoEra",
  "description": "",
  "cborHex": "84a500818258205853cc86af075cc547a5a20658af54841f37a5832532a704c583ed4f010184a501018282581d6079c37fabad08662e16ad4950edd63d2a2ab0b63f8a44e4a504511ef51a1908b10082581d60282e5ee5d1e89e04fa81382df239d6733409875d75b480c879f586001a43e80724021a0002c24d031a03afe00c0758200088270ea98923127ef4c2e05b665b81b5a6c9fca1582eed1171ba17648f7b3da10081825820de9503426759fa18624657f5bcc932f38220ec9eceb262907caf2d198b6e0faa584025f49ad0cb27c0a297ebd2237134be2803b19d11c6e52416d3d7beba130bbc2bd95eb9b7e9e7410d7efcd5c2abd338dd62100d86b26308636335b533873bb508f582a11902a2a1636d73676d74687820666f72206c756e636880"
}

Sign Transaction

Signs (aka append VKey Witnesses) for a transaction from one or more signing keys.

$ cscli transaction sign --signing-keys addr_xsk1fzw9r482t0ekua7rcqewg3k8ju5d9run4juuehm2p24jtuzz4dg4wpeulnqhualvtx9lyy7u0h9pdjvmyhxdhzsyy49szs6y8c9zwfp0eqyrqyl290e6dr0q3fvngmsjn4aask9jjr6q34juh25hczw3euust0dw --network testnet --cbor-hex 84a50081825820dcfe996519321071430c812525393f431d75208428852491e9c0c6788dad5f9201018282581d6079c37fabad08662e16ad4950edd63d2a2ab0b63f8a44e4a504511ef51a1908b10082581d60282e5ee5d1e89e04fa81382df239d6733409875d75b480c879f586001a5cf39dd9021a00029ee5031a03afdc580758200088270ea98923127ef4c2e05b665b81b5a6c9fca1582eed1171ba17648f7b3da0f582a11902a2a1636d73676d74687820666f72206c756e636880
84a50081825820dcfe996519321071430c812525393f431d75208428852491e9c0c6788dad5f9201018282581d6079c37fabad08662e16ad4950edd63d2a2ab0b63f8a44e4a504511ef51a1908b10082581d60282e5ee5d1e89e04fa81382df239d6733409875d75b480c879f586001a5cf39dd9021a00029ee5031a03afdc580758200088270ea98923127ef4c2e05b665b81b5a6c9fca1582eed1171ba17648f7b3da10081825820de9503426759fa18624657f5bcc932f38220ec9eceb262907caf2d198b6e0faa5840d856197bc4f4cb62439ea9c2781e9764855685c3809364ef759b1926047d7bb326fecf2ee1144c5d49cf2f53feb432fa1af30e00d8d69c4145e6494fd1979a0cf582a11902a2a1636d73676d74687820666f72206c756e636880

View Transaction

Views a JSON representation of the transaction including the transaction ID.

$ cscli transaction view --network testnet --cbor-hex 84a50081825820dcfe996519321071430c812525393f431d75208428852491e9c0c6788dad5f9201018282581d6079c37fabad08662e16ad4950edd63d2a2ab0b63f8a44e4a504511ef51a1908b10082581d60282e5ee5d1e89e04fa81382df239d6733409875d75b480c879f586001a5cf39dd9021a00029ee5031a03afdc580758200088270ea98923127ef4c2e05b665b81b5a6c9fca1582eed1171ba17648f7b3da0f582a11902a2a1636d73676d74687820666f72206c756e636880
{
  "id": "be9b3070e17f9f0c3e5477b315a35b9c5be0ec355f6c6bfb4beee42270413a25",
  "isValid": true,
  "transactionBody": {
    "inputs": [
      {
        "transactionId": "dcfe996519321071430c812525393f431d75208428852491e9c0c6788dad5f92",
        "transactionIndex": 1
      }
    ],
    "outputs": [
      {
        "address": "addr_test1vpuuxlat45yxvtsk44y4pmwk854z4v9k879yfe99q3g3aagqqzar3",
        "value": {
          "lovelaces": 420000000,
          "nativeAssets": []
        }
      },
      {
        "address": "addr_test1vq5zuhh9685fup86syuzmu3e6eengzv8t46mfqxg086cvqqc5zr4t",
        "value": {
          "lovelaces": 1559469529,
          "nativeAssets": []
        }
      }
    ],
    "mint": [],
    "fee": 171749,
    "ttl": 61856856,
    "auxiliaryDataHash": "0088270ea98923127ef4c2e05b665b81b5a6c9fca1582eed1171ba17648f7b3d",
    "transactionStartInterval": null
  },
  "transactionWitnessSet": null,
  "auxiliaryData": {
    "metadata": {
      "674": {
        "msg": "thx for lunch"
      }
    }
  }
}

New Key Commands

Derive Change Key

Derives the extended signing key for a change payment.

$ cscli wallet key change derive --recovery-phrase "$(cat phrase.en.prv)" --account-index 1 --address-index 4
addr_xsk19z8es3n4m7jxj94xn4u7kg90nkc47mnkjuyxe4s8dz7smu2z4dg3x62qfr6vylfdkm74j7pza5y0y49fur8vxjtch99tn37l28u6r5q7fyncguqdz0my887wxklhg46x53x04st7ldj75fku0rctfxvtvcnfm2kq

Derive Change Address

Derives the address for a change payment.

$ cscli wallet address change derive --recovery-phrase "$(cat phrase.en.prv)" --account-index 1 --address-index 4 --payment-address-type base --network mainnet
addr1q9mhv3z67h6tnpasrggsd9qd22u00qvkk8mlg0ppnxkmp4zupvkzyt42349mnkhgu8ghqzgtsqvzmvu2w675560fvvds9fe7ek

Installation

The easiest way is to install the .NET SDK and install the global tool cscli.

dotnet tool install --global cscli

Alternatively, please download the platform-specific binaries in the release Assets below

Assets SHA256 Checksums

cscli.win-x64.exe: 10D6E941DDDA46687786AFA0A38AFB26A1AAC653152CE740D83E92A5E9786281
cscli.linux-x64: 5F4CEC282F723A3C5E30A3FCF26803F917F99ED3EC1B4487EA264095A1143940
cscli.osx-x64: 2187C5841BD519999155CB12A66662A5E6D40BE0023EDC36937CB6AB61FA9273
cscli.osx-arm64: 8954CD1E143EC3426AF0126B46872DD20AE046E07D2ED352D32668FA2FC41AA7

Usage and Overview

Please see the README documentation

v0.3.0 Key Derivation and Conversion Commands

Changes

New Wallet Key Commands

Derive Account Key

Derives the account extended signing key (standard bech32 format) from a recovery-phrase and optional passphrase at a particular index (default 0).

cscli wallet key account derive --recovery-phrase "<recovery_phrase>" [--language <language>] [--passphrase <passphrase>] [--account-index <derivation_index>]

Convert Verification Key

Converts a signing key to a verification key (standard bech32 format) and optionally writes to a cardano-cli compatible vkey file.

cscli wallet key verification convert --signing-key <signing_key> [--verification-key-file <output_vkey_path>]

Installation

The easiest way is to install the .NET SDK and install the global tool cscli.

dotnet tool install --global cscli

Alternatively, please download the platform-specific binaries in the release Assets below

Assets SHA256 Checksums

cscli.win-x64.exe: 33F58E16A1BC3577E54D0ADBACF43E6CF548A1181A350B9F41997229272DDD99
cscli.linux-x64: DD92C309A58AC8F2BD4761A9D89B4BCE3E5F27973FC6805C33EBA294C8C897C8
cscli.osx-x64: E0A94E6C7F481BDD080B2A934B0B3C7A4DA2C89C9837F64538460EB9FECE85FE

Usage and Overview

Please see the README documentation

v0.2.0 On-chain Querying Commands

Changes

New On-chain Querying Commands

Query commands:

• query tip --network <network>
• query protocol-parameters --network <network>
• query info account --network <network>--stake-address <bech32_stake_address>
• query asset account --network <network> --stake-address <bech32_stake_address>
• query info address --network <network> --address <bech32_payment_address>
• query info transaction --network <network> --tx-id <transaction_hash>

Transaction Commands:

• transaction submit --network <network> --cbor-hex <hex_string>

Installation

The easiest way is to install the .NET SDK and install the global tool cscli.

dotnet tool install --global cscli

Alternatively, please download the platform-specific binaries in the release Assets below

Assets SHA256 Checksums

cscli.win-x64.exe: 267A2D907F475B69B22905023F58C7CB8259FD8D68A40E51F68DAF609B62BF00
cscli.linux-x64: 6E4F4D2CDB1959DD90944F5F4EC15D5E461512F6633770407041FC630CBBF562
cscli.osx-x64: F3D022926A972CB009A51078BFA046DEE3513D8D57EB79F3C02F48C32851B4CC
cscli-osx-arm64: 185AB1BB585F0E2DEDF5367B317D965DEAB0970972B4260345209B2EBBC6757E

Usage and Overview

Please see the README documentation

Bech32 Encoding/Decoding and Blake2b Hashing Commands

Changes

Added new commands for Cardano's most common hashing and encoding operations

    cscli bech32 encode --value "<hex_string>" --prefix "<string>"
    cscli bech32 decode --value "<bech32_string>"
    cscli blake2b hash --value "<hex_string>" --length <digest_length>

With these you can now:

• Derive addresses manually from the verification key
• Derive policyIds from the policy script
• Derive assetIds from the policyId and assetname
• Derive the transactionHash from the tx body

Installation

The easiest way is to install the .NET SDK and install the global tool cscli.

dotnet tool install --global cscli

Alternatively, please download the platform-specific binaries in the release Assets below

Usage and Overview

Please see the README documentation

v0.0.5

Changes

Implemented cip1855 for generating policy keys from recovery phrases, a crucial piece for minting native assets.
Switched stake key derivation to non-extended stake vkey outputs for cardano-cli compatibility.
Improved README documentation

Installation

The easiest way is to install the .NET SDK and install the global tool cscli.

dotnet tool install --global cscli

Alternatively, please download the platform-specific binaries in the release Assets below

Usage and Overview

Please see the README documentation

v0.0.4

The first official release of cscli: v0.0.4 🎉

Installation

The easiest way is to install the .NET SDK and install the global tool cscli.

dotnet install --global cscli

Alternatively, please download the platform-specific binaries in the release Assets below

Usage and Overview

Please see the README documentation