Quick Start

Picoin currently operates as an early distributed local testnet.

The project supports:

• Proof of Pi mining;
• validator approvals;
• retroactive audits;
• scientific compute accounting;
• treasury accounting;
• multi-miner testing.

Clone the Repository

git clone https://github.com/devcoffeecoin/PICOIN.git cd PICOIN/picoin-proof-of-pi

Create Virtual Environment

python -m venv .venv

Activate Environment

Windows:

..venv\Scripts\activate

Linux/macOS:

source .venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Run the API

uvicorn app.main:app --reload

---

Running Local Testnet

Picoin includes local multi-miner testing tools.

Example:

python -m picoin testnet continuous --miners 3 --loops 3 --workers 1

This command executes:

• distributed mining simulation;
• validator approvals;
• retroactive audits;
• reward accounting;
• chain validation.

---

Mining Commands

Picoin currently supports local mining execution.

Example:

python -m picoin mine once

Continuous mining:

python -m picoin mine continuous

The mining workflow includes:

• task assignment;
• deterministic computation;
• commit-reveal;
• validator approvals;
• retroactive audits.

---

Science Commands

Picoin includes a Science Compute accounting layer.

Examples:

Stake for Science Compute Access:

python -m picoin science stake --amount 31416

Create Scientific Job:

python -m picoin science create-job --type ai_inference --metadata-hash HASH --storage-pointer POINTER

View Science Jobs:

python -m picoin science jobs

Check Science Reserve:

python -m picoin reserve status

---

Treasury Commands

Picoin includes a Scientific Development Treasury.

Examples:

Treasury Status:

python -m picoin treasury status

Treasury Claim:

python -m picoin treasury claim

The treasury currently uses:

• timelocked accounting;
• governance-ready structure;
• future multisig support.

---

Health Checks

Picoin includes integrated protocol health checks.

Health checks validate:

• blockchain integrity;
• reward accounting;
• validator availability;
• reserve consistency;
• balance consistency;
• database state.

---

Docker Testnet

Future versions of Picoin are expected to support distributed Docker-based testnets.

Planned configurations include:

• bootstrap node;
• miner nodes;
• validator nodes;
• auditor nodes;
• distributed networking.

---

Running Multiple Nodes

Picoin is evolving toward distributed multi-node operation.

Future distributed testnet versions are expected to support:

• peer discovery;
• node synchronization;
• distributed validation;
• gossip propagation;
• distributed consensus.