Acqua

Getting started

You can use acqua simply by installing via pip on your Terminal.

pip install acqua

Sample output when running install command

And build required images with build command. The following shows you how to build a Testnet Sui Validator node with one-command.

acqua pull --mainnet

Sample output when running pull command

The initial pull may take some time as it is downloading source codes from different repositories and interfacing with Docker Daemon to build according to flagged requirements. Once the pull process completes, you can begin deploying local network with middlewares as such:

acqua deploy --mainnet

Note: If you do not have postgres:latest image in your local Docker image registry, this may take some time to deploy on your first run.

Sample output when running deploy command

You will have docker containers running in the backend, ready to be interfaced by your local environment applications you are developing.

Dashboard

Acqua not only facilitates the deployment of Bitcoin services such as the Sui Validator node with a PoW relay, but allows you to view Node's Blockchain Information, Mempool Information, Peripheral Details and etc.

In order to view relevant metrics, launch the dashboard using the following command.

acqua dashboard

Sample output when running dashboard command

Contributions

Prerequisites

• python version 3.9 and above
• uv
• docker

Set up local environment

The following guide walks through setting up your local working environment using pyenv as Python version manager and uv as Python package manager. If you do not have pyenv installed, run the following command.

Install using Homebrew (Darwin)

brew install pyenv --head

Install using standalone installer (Darwin and Linux)

curl https://pyenv.run | bash

If you do not have uv installed, run the following command.

Install using Homebrew (Darwin)

brew install uv

Install using standalone installer (Darwin and Linux)

curl -LsSf https://astral.sh/uv/install.sh | sh

Once you have pyenv Python version manager installed, you can install any version of Python above version 3.8 for this project. The following commands help you set up and activate a Python virtual environment where uv can download project dependencies from the PyPI open-sourced registry defined under pyproject.toml file.

Set up environment and synchronize project dependencies

pyenv shell 3.11.9
uv venv  --python-preference system
source .venv/bin/activate
uv sync --dev

Now you have the entire project set-up and ready to be tinkered with. Try out the standard acqua command which brings up a help menu.

Launch Acqua Help

$ acqua
>  Usage: acqua [OPTIONS] COMMAND [ARGS]...
> 
>  acqua 
> 
> Options:
>   --help  Show this message and exit.
> 
> Commands:
>   auth       Persist authentications in desired run-control file.
>   build      Build peripheral images for the desired cluster.
>   clean      Remove all active "acqua-*" containers, drop network.
>   dashboard  Dashboard for checking current state of images deployed.
>   deploy     Deploy cluster.
>   pull       Pull core and peripheral images from GitHub container registry

Known issues

You may run into this setback when first running this project. This is a docker-py issue widely known as of October 2022.

docker.errors.DockerException:
  Error while fetching server API version: (
    'Connection aborted.', FileNotFoundError(
      2, 'No such file or directory'
    )
  )

See the following issue for Mac OSX troubleshooting. docker from_env and pull is broken on mac Recommended fix is to run the following command:

sudo ln -s "$HOME/.docker/run/docker.sock" /var/run/docker.sock

License

This project is licensed under the terms of the MIT license.