Skip to content

Autonomous on-chain monetary system for PulseChain with an immutable core and an internal algorithmic value standard - fully self-regulating, oracle-free, and independent of fiat.

License

Notifications You must be signed in to change notification settings

Aqua75/ProjectUSD

Repository files navigation

ProjectUSD

Autonomous Monetary System for PulseChain

Language: ๐Ÿ‡ฌ๐Ÿ‡ง English | ๐Ÿ‡ฉ๐Ÿ‡ช German

"When the code cannot lie, humanity no longer needs to."


๐ŸŒ What is ProjectUSD?

ProjectUSD is a fully on-chain, algorithmic monetary system designed for PulseChain.
It achieves economic stability without banks, without governance, without oracles,
and without centralized intervention of any kind.

It represents the next evolution of decentralized finance:
a self-regulating economic engine powered solely by transparent, immutable logic.


๐Ÿ“˜ Whitepaper V2.1

Available Editions:


๐Ÿงฉ Technical Architecture

ProjectUSD is built from five immutable core modules:

  • VaultEngine โ€“ Collateral, debt, and CR logic
  • Controller โ€“ Autonomous equilibrium engine (R & r-epochs)
  • Oracle โ€“ Medianized, deviation-safe pricing
  • Liquidation & Redemption Engine โ€“ Stability enforcement
  • StabilityPool โ€“ Collective risk absorption

๐Ÿ” Clarification: Internal TWAP Oracle

The โ€œOracleโ€ module in ProjectUSD is not an external price oracle.
It does not use Chainlink, Pyth, DIA, APIs, or any off-chain data.

Instead, it is a pure on-chain TWAP reader that derives price information
exclusively from the ProjectUSD/PLS AMM pool on PulseChain.

  • no external dependencies
  • no governance updates
  • no admin intervention
  • fully deterministic and on-chain

This ensures that ProjectUSD remains an autonomous, oracle-free monetary system while still allowing the controller to observe its own AMM-based market behavior.


A detailed architectural explanation is available at:

โžก /Architecture/README.md


๐Ÿš€ Quickstart for Developers

For developers, auditors, and researchers who want to enter directly into the technical foundations of ProjectUSD, the following documents serve as the primary entry points:

1. Architecture Overview

โžก /Architecture/README.md
A high-level introduction to the system architecture, core modules, and internal data flows.

2. Complete Specifications (SPECS)

โžก /Architecture/specs/README.md
The formal, audit-ready specifications of all core components:

  • VaultEngine
  • Controller
  • Oracle
  • Liquidation & Redemption
  • StabilityPool
  • Security
  • Governance & Freeze
  • KPI Subgraph
  • Incident Runbook

3. Developer Playbook

โžก /Developer_Playbook/README.md
A practical guide for development workflow, standards, conventions, and recommended best practices.

4. Glossary

โžก /Glossary.md
Definitions of terms, mechanisms, variables, economic concepts, and formula notation used throughout the system.


๐Ÿ“‚ Full Technical Specification Library (SPECS)

ProjectUSD contains one of the most complete SPEC frameworks in decentralized finance:

โžก /Architecture/specs/README.md
โžก /Architecture/specs/README.de.md

This section provides the entire audit-ready blueprint of the system, including:

  • VaultEngine SPEC
  • Controller SPEC
  • Oracle SPEC
  • Liquidation & Redemption SPEC
  • StabilityPool SPEC
  • Security SPEC
  • Governance & Freeze SPEC
  • Freeze Checklist
  • KPI Subgraph SPEC
  • Incident Runbook
  • DEX-LP SPEC (optional)

All specifications are modular, consistent, and available in English and German.


๐Ÿ“š Research Library

ProjectUSD provides two curated document collections that extend beyond the technical specifications and deepen the economic foundations of the system.

๐Ÿ“ Articles

โžก /Articles
Analytical essays and conceptual papers covering topics such as:

  • internal value units and purchasing power
  • the meaning of the name ProjectUSD
  • the P R r model
  • theoretical principles of autonomous monetary systems

These texts provide the conceptual framework behind the design and help explain the reasoning that informs the SPECS.

๐Ÿ“‘ Studies

โžก /Studies
Formal research studies covering subjects such as:

  • stability mechanisms and anti reflexivity
  • system game theory
  • collateral models and stress simulations
  • liquidity and arbitrage behaviour
  • long term surplus development
  • gas usage and efficiency models

These studies offer quantitative models, simulations and deeper analytical insights into system behaviour.


๐Ÿ“Œ Status

๐Ÿงฉ Completed architecture & full SPEC blueprint โ€” now open for developers, auditors, and investors.


๐Ÿ”— Discussion & Development

Join the ProjectUSD community on Telegram:

โžก https://t.me/ProjectUSD_Discussion


โš ๏ธ Implementation Notice

This repository contains the official ProjectUSD specifications only.

Smart contract implementations may be developed by independent teams. Whether a specific implementation is secure can only be evaluated through:

  • open audits,
  • peer review,
  • open-source transparency,
  • formal verification,

โ€” not through this document.

ProjectUSD does not publish smart contracts and does not designate any implementation as official.

Users should rely only on implementations that have undergone verification by reputable auditors and whose source code is fully transparent.


๐Ÿท๏ธ ProjectUSD โ€“ Name & Attribution Policy

ProjectUSD is an original open-source concept published by
Aqua75 / PulseChain Community Initiative
under the Creative Commons BY-NC-SA 4.0 license.

This license applies to all documentation, specifications, studies, whitepapers and media in this repository.

However, the name โ€œProjectUSDโ€ and the ProjectUSD logo are protected identifiers of the original PulseChain-based design.

Allowed Use of the Name โ€œProjectUSDโ€

Implementations deployed on PulseChain must:

  1. fully comply with the official ProjectUSD specification, and
  2. pass the consolidation process

to use the name โ€œProjectUSDโ€.

Independent Forks

All other implementations โ€” on PulseChain or elsewhere โ€” must be clearly labeled as independent forks, and must include the attribution:

Based on the โ€œProjectUSDโ€ concept by Aqua75 / PulseChain Community Initiative
https://github.com/Aqua75/ProjectUSD

Unauthorized use of the name or logo outside the PulseChain context
violates the license terms.

ยฉ 2025 Aqua75 โ€” All rights reserved for the name and logo โ€œProjectUSDโ€.


๐Ÿช™ License

Creative Commons BY-NC-SA 4.0
ยฉ 2025 Aqua75 โ€“ PulseChain Community Initiative