Skip to content

Latest commit

 

History

History
69 lines (37 loc) · 3.9 KB

TESTNET.md

File metadata and controls

69 lines (37 loc) · 3.9 KB
Raw

TestNet User Guide

A public TestNet is now online to help node operators practice running MobileCoin network infrastructure. Interested individuals and organizations are invited to participate and share feedback with the developers.

In addition to bug reports and code contributions, we are seeking feedback on the clarity of our documentation, any criticisms you may have of our design, and any other constructive feedback you would like to share.

MobileCoin Inc. will be announcing details on a formal bug bounty program in the coming weeks.

Sign up to receive TestNet mobilecoins

Register to participate in the MobileCoin TestNet to receive an allocation of mobilecoins.

  1. Sign up using our online form.

  2. You will receive an email containing a master key that you can use to claim mobilecoins in the TestNet ledger. Anyone who knows your master key will be able to spend your money, so keep it secret!

Send Your First Payment

You can make your first MobileCoin payment right now!

  1. Download the TestNet client package for mac or linux.

  2. Expand the package archive and launch the "MobileCoin TestNet" client, an app bundle (mac) or shell script (linux).

  3. Enter the master key you received in your email and confirm your balance.

  4. Try completing a payment to the sample request code you received in your email.

  5. Create your own payment request and share it in the MobileCoin forum.

Run a TestNet Watcher Node

If you have a Linux-compatible home computer, or if you are willing to operate a Linux-compatible server in the cloud, you can run a watcher node in the MobileCoin TestNet.

  1. Clone the official MobileCoin repository at Github.

  2. Make sure you've installed Docker and Python.

  3. Launch the MobileCoin build system Docker container using the command: ./mob prompt

  4. At the container prompt, compile and launch the mobilecoind daemon using the TestNet quickstart script: ./start-testnet-client.sh

  5. Use your master key with the TestNet client, or as the root entropy in one of the mobilecoind example clients or your own code!

  6. Exchange payment request information with other community members at the MobileCoin Forum.

  7. Collaborate to help stress test the validator nodes to help discover potential problems.

Run a TestNet Validator Node

If you have an SGX-capable machine, or if you are willing to operate an SGX-capable server in the cloud, you can run a validator node in the MobileCoin TestNet.

  1. Send an email to [email protected] and let us know how you'd like to get involved!

MobileCoin TestNet Schedule

The MobileCoin ledger will be reset at the end of each TestNet period to accommodate breaking changes. Each time the ledger is reset, new TestNet mobilecoins will be allocated to all registered users.

During Operating Hours our goal will be to maintain 100% uptime. We plan to rehearse enclave updates that will cause service interruption during maintenance hours.

Period Start Date End Date Operating Hours
1 Wed Apr 22 Wed Apr 29 M-F 10AM-5PM PST
2 Wed Apr 29 Wed May 13 M-F 10AM-5PM PST
3 Wed May 13 (TBD) M-F 10AM-5PM PST

Getting Help

For troubleshooting and questions, please visit the community forum at https://community.mobilecoin.com. You can also open a technical support ticket via email to [email protected].