lotus/documentation/en/unclassified/dev-tools-pond-ui.md
Hector Sanjuan fe52c47570 Docs review and re-organization
This:

* Re-organizes the docs into sections that align with what docs.filecoin.io becoming:
  * An installation section
  * A "getting started" section (lotus client focused)
  * A "storing" section (lotus client focused)
  * A "mining" section (miner focused)
  * A "build" section (developer focused)
  * An legacy "architecture" section is left in the last place.

A few high-value documentation pages have been reviewed and updated with the latest recommendations:

* Installation section and lotus setup
* Miner setup
* etc.
...

Other pages have been correctly merged into the new relevant sections. Some pages have not been touched. The filesystem layout of the documentation has been changed into folders corresponding to the sections (as requested by @cw). Some pages that were not linked at all and/or where hidden, have been moved to "unclassified".

This should make the porting of the Lotus documentation to docs.filecoin.io much easier, while ensuring it is more up to date than it was before.

For the moment, this breaks most links as link-aliasing is not supported in lotus-docs.
2020-09-03 16:35:16 +02:00

1.1 KiB

Pond UI

Pond is a graphical testbed for Lotus. Using it will setup a separate 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

make pond

Run

./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 Miner] to start a Lotus Miner. This require's the node's wallet to have funds.
  • Click on [Client] to open the Lotus 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 more than 10 hours, the web client will eventually consume all available RAM.

Troubleshooting

  • Turn it off and on - Start at the top
  • rm -rf ~/.lotus ~/.lotusminer/, this command will delete chain sync data, stored wallets, and other configurations so be careful.
  • Verify you have the correct versions of dependencies
  • If stuck on a bad fork, try lotus chain sethead --genesis