Metadata-Version: 2.1
Name: xrpl-sidechain-cli
Version: 1.0.0b2
Summary: A CLI that helps you set up an XRPL sidechain.
Home-page: https://github.com/xpring-eng/sidechain-cli
License: MIT
Keywords: xrp,xrpl,cryptocurrency
Author: Mayukha Vadari
Author-email: mvadari@ripple.com
Requires-Python: >=3.7.1,<4.0.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Jinja2 (>=3.1.2,<4.0.0)
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: docker (>=6.0.0,<7.0.0)
Requires-Dist: httpx (>=0.18.1,<0.19.0)
Requires-Dist: psutil (>=5.9.2,<6.0.0)
Requires-Dist: tabulate (>=0.8.9,<0.9.0)
Requires-Dist: websockets (>=10.3,<11.0)
Requires-Dist: xrpl-py (>=1.7.0b0,<2.0.0)
Project-URL: Repository, https://github.com/xpring-eng/sidechain-cli
Description-Content-Type: text/markdown

# xrpl-sidechain-cli

## Install

```bash
pip install xrpl-sidechain-cli
```
NOTE: if you're looking at the repo before it's published, this won't work. Instead, you'll do this:
```bash
git clone https://github.com/xpring-eng/sidechain-cli.git
cd sidechain-cli
# install poetry
curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -
poetry install
poetry shell
```

Install rippled and the xbridge witness.

rippled: https://xrpl.org/install-rippled.html

witness: https://github.com/seelabs/xbridge_witness

## Get started

```bash
export XCHAIN_CONFIG_DIR={filepath where you want your config files stored}
export RIPPLED_EXE={rippled exe filepath}
export WITNESSD_EXE={witnessd exe filepath}
./scripts/tutorial.sh
```

To stop the servers:
```bash
sidechain-cli server stop --all
```

## Use Commands

```bash
sidechain-cli --help
```

Each subcommand also has a `--help` flag, to tell you what fields you'll need.

