Metadata-Version: 2.4
Name: adaup
Version: 0.2.0
Summary: A Python package for interacting with Cardano.
Home-page: https://github.com/dquadrant/kuber
Author: Sudip Bhattarai
Author-email: sudip@bhattarai.me
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: tqdm
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary



## Installation

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



```bash
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:

```bash
cardano node preview
```

You can also specify a different network or node version:

```bash
cardano node mainnet 
```

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

```bash
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:

```bash
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.
    ```bash
    cardano hydra bootstrap preview  2
    ```

2.  **Start 1st Hydra Node:**
    

    ```bash
    cardano hydra node preview  0
    ```
2.  **Start 2nd Hydra Node in different terminal:**
    

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

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

    ```bash
    cardano hydra tui  0
    ```

4.  **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.

    ```bash
    cardano hydra reset preview
    ```

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

    ```bash
    cardano hydra prune preview
    ```
