adaup 0.2.0

A Python package for interacting with Cardano.

Installation

⚠️ Warning: Only x86/64 Linux platform is supported.

pip install adaup

SystemWide Installation

sudo pip install --upgrade adaup --break-system-packages

After installation, the cardano executable will be available in your PATH.

Usage

The cardano executable provides a command-line interface to manage Cardano and Hydra nodes.

Running a Cardano Node

To start a Cardano node for a specific network (e.g., preview or preprod or mainnet ), use the node command:

cardano node preview

You can also specify a different network or node version:

cardano node mainnet 

For a local single-node development network with prepackaged genesis material and an auto-funded default wallet in ~/.cardano/keys, use:

cardano node devnet

This starts a local node at ~/.cardano/devnet/node.socket using cardano-node 11.0.1, regenerates payment.*, stake.* and payment.addr under ~/.cardano/keys on each run, and funds that address with 1000000000000 lovelace (1,000,000 ADA) from the devnet faucet. The packaged devnet genesis funds the faucet with enough lovelace for repeated local bootstraps.

Running Cardano CLI Commands

To execute cardano-cli commands, use the cli subcommand followed by the cardano-cli arguments:

export CARDANO_NODE_SOCKET_PATH=~/.cardano/preview/node.socket
cardano cli query tip --testnet-magic 2
cardano cli query tip --testnet-magic=2 --socket-path=~/.cardano/preview/node.socket ## socket path in the cli

Running a Hydra Cluster

To set up and run a Hydra cluster:

1. Bootstrap Hydra Node Credentials: Generate the necessary folders and credentials for your Hydra nodes. This will create hydra-{n} directories under $HOME/.cardano/<network_name>/.

   e.g. this will generate configuration for running 2 hydra nodes.

   cardano hydra bootstrap preview  2
   

2. Start 1st Hydra Node:

   cardano hydra node preview  0
   

3. Start 2nd Hydra Node in different terminal:

   cardano hydra node preview  1
   

   Note the command to run this node is available at ~/.cardano/preview/hydra-0/run.sh

4. Watch hydra status in Hydra TUI : To interact with a running Hydra node, you can open the Text User Interface (TUI):

   cardano hydra tui  0
   

5. Reset Hydra Head Data : Shutdown you nodes, and use reset command to restart a new hydra head with same configurations. You can then start the nodes again.

   cardano hydra reset preview
   

6. Prune Hydra Cluster : To remove all keys, data and cluster information. You need to bootstrap the cluster again.

   cardano hydra prune preview