lotus/documentation/testing-with-gui.md

# Pond UI

Pond is a graphical testbed for [Lotus](https://docs.lotu.sh). Using it will setup a seperate local network which is helpful for debugging. Pond will spin up nodes, connect them in a given topology, start them mining, and observe how they function over time.

## Build

```sh
$ make pond
```

## Run

```sh
$ ./pond run
```

Now go to http://127.0.0.1:2222.

## What can I test?

- The `Spawn Node` button starts a new lotus Node in a new draggable window.
- Click `[Spawn Storage Miner]` to start mining. This require's the node's wallet to have funds.
- Click on `[Client]` to open the Node's client interface and propose a deal with an existing Miner. If successful you'll see a payment channel open up with that Miner.

Don't leave Pond unattended for long periods of time (10h+), the web-ui tends to eventually consume all the available RAM.

## Troubleshooting

- Turn it off and on - Start at the top
- `rm -rf ~/.lotus ~/.lotusstorage/`
- Verify you have the correct versions of dependencies
- If stuck on a bad fork, try `lotus chain sethead --genesis`
- If that didn't help, open a new issue, ask in the [Community forum](https://discuss.filecoin.io) or reach out via [Community chat](https://github.com/filecoin-project/community#chat).
documentation: correctly represents pond's purpose which is to test in a separate local network 2019-12-02 00:28:19 +00:00			`# Pond UI`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: correctly represents pond's purpose which is to test in a separate local network 2019-12-02 00:28:19 +00:00			`Pond is a graphical testbed for [Lotus](https://docs.lotu.sh). Using it will setup a seperate local network which is helpful for debugging. Pond will spin up nodes, connect them in a given topology, start them mining, and observe how they function over time.`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: light copy adjustments before major revision 2019-12-02 00:08:53 +00:00			`## Build`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`$ make pond`
			```

documentation: light copy adjustments before major revision 2019-12-02 00:08:53 +00:00			`## Run`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`$ ./pond run`
			```

			`Now go to http://127.0.0.1:2222.`

documentation: correctly represents pond's purpose which is to test in a separate local network 2019-12-02 00:28:19 +00:00			`## What can I test?`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			- The `Spawn Node` button starts a new lotus Node in a new draggable window.
documentation: light copy adjustments before major revision 2019-12-02 00:08:53 +00:00			- Click `[Spawn Storage Miner]` to start mining. This require's the node's wallet to have funds.
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			- Click on `[Client]` to open the Node's client interface and propose a deal with an existing Miner. If successful you'll see a payment channel open up with that Miner.

			`Don't leave Pond unattended for long periods of time (10h+), the web-ui tends to eventually consume all the available RAM.`

			`## Troubleshooting`

			`- Turn it off and on - Start at the top`
			- `rm -rf ~/.lotus ~/.lotusstorage/`
			`- Verify you have the correct versions of dependencies`
			- If stuck on a bad fork, try `lotus chain sethead --genesis`
			`- If that didn't help, open a new issue, ask in the [Community forum](https://discuss.filecoin.io) or reach out via [Community chat](https://github.com/filecoin-project/community#chat).`