Peether Protocol / PTDT Settlement API

This repository is the original peether-protocol workspace for the PTDT Settlement Protocol.

As of April 21, 2026, the public project has been split into two clean, active repositories:

• Backend API: https://github.com/pinkpeether/ptdt-settlement-api
• Frontend UI: https://github.com/pinkpeether/ptdt-settlement-frontend

Use those split repositories for current public release work, deployment, and ongoing development.

Current Repository Status

pinkpeether/peether-protocol is retained as the original protocol/API workspace and historical reference. It contains the earlier backend implementation, deployment notes, security notes, and operator documentation.

The latest reviewed public backend release is now in:

https://github.com/pinkpeether/ptdt-settlement-api

The latest reviewed frontend release is now in:

https://github.com/pinkpeether/ptdt-settlement-frontend

What PTDT Settlement Protocol Provides

PTDT Settlement Protocol is settlement infrastructure for ride-hailing and mobility networks. It is designed to expose a public proof layer around:

• Ride/operator settlement simulation
• PTDT-denominated protocol fee flow
• 60% burn / 40% staker distribution logic
• Receipt verification
• Settlement explorer visibility
• Protocol financial rollups
• Activity and status checkpoints
• Developer, partner, and market-facing proof surfaces

Active Backend Surfaces

The active backend release exposes public and protected API surfaces including:

• GET /api/v1/health
• GET /api/v1/token/supply
• GET /api/v1/token/price
• GET /api/v1/token/liquidity
• GET /api/v1/token/stats
• GET /api/v1/explorer/bootstrap
• GET /api/v1/explorer/latest
• GET /api/v1/explorer/search?q=...
• GET /api/v1/receipt/:id
• GET /api/v1/receipt/:id/verify
• GET /api/v1/sandbox/examples
• POST /api/v1/sandbox/estimate
• POST /api/v1/sandbox/settle
• GET /api/v1/financials/summary
• GET /api/v1/activity/overview
• GET /api/v1/status/overview
• GET /api/v1/developers/overview
• GET /api/v1/partners/overview
• GET /api/v1/markets/overview

Protected operator, quote, payment, payout, analytics, and webhook routes remain behind authentication where applicable.

Active Frontend Surfaces

The active frontend release includes:

• Settlement protocol home
• Settlement cockpit
• Operator console
• Explorer
• Receipt verification
• Protocol financials
• Activity checkpoint
• Status checkpoint
• Developers checkpoint
• Partners checkpoint
• Markets checkpoint
• Operator simulation case study
• App Alpha Phase 1

Network Reference

• Network: Binance Smart Chain
• Chain ID: 56
• PTDT token: 0x66c6Fc5E7F99272134a52DF9E88D94eD83E89278
• LP pair reference: 0xF3a06E9Dc5d89B2fD8d7d30946c9aeddc5e01E28

Local Backend Setup

For the active backend repo:

git clone https://github.com/pinkpeether/ptdt-settlement-api.git
cd ptdt-settlement-api
npm install
cp .env.example .env
npm run build
npm start

Development server:

npm run dev

Local Frontend Setup

For the active frontend repo:

git clone https://github.com/pinkpeether/ptdt-settlement-frontend.git
cd ptdt-settlement-frontend
npm install
cp .env.example .env
npm run dev

Build:

npm run build

Documentation

Important documentation in this repository:

• docs/PTDT-Settlement-Protocol-Public-Overview.md
• docs/OPERATOR-GUIDE.md
• START_HERE.md
• INTEGRATION_GUIDE.md
• QUICK_REFERENCE.md
• DEPLOYMENT.md
• SECURITY.md

Some older docs in this repository were written before the backend/frontend split. Where there is a conflict, use the active split repositories as the current source of truth.

Repository Notes

• Do not commit .env or production secrets.
• Use .env.example templates in the active repositories.
• Generated folders such as node_modules and dist should remain uncommitted.
• The active public release has moved to the split repos listed above.

License

MIT License. See LICENSE.