PMF Protocol

This repository is PMF's generated public protocol release mirror. It contains reusable vault and oracle contracts, interfaces, specifications, and focused tests. PMF's monorepo remains authoritative. The explicit export allowlist excludes production operations, deployment credentials, live-address manifests, and monorepo services.

Components

• PMFVault: ERC-4626 accounting with signed AP quotes, queued redemptions, basket-bound order intents, solver fills, residual inventory handling, fees, and wind-down controls.
• PMFBasketOracle, PMFBasketOracleRouter, and PMFPricingRouter: signed basket publication and delayed source routing.
• FateDepositRouter: an optional asynchronous deposit integration; it is not required by the vault core.

Development

npm ci
npm run compile
npm test
npm run lint
npm run coverage:check
npm run check:vault-interface
npm run verify:export-manifest

Interfaces

• Current manifests match the source in this snapshot.
• Legacy manifests are immutable deployment interfaces and do not match the current source.

Documentation

• Architecture
• Vault specification
• Security guidance

Provenance

export-manifest.json identifies the source commit, whether the source tree was clean, the Solidity compiler version, an aggregate Solidity digest, and every exported file hash. Only exports with sourceTreeClean: true and preview: false are release candidates.

Questions and reports

Use Issues for concrete bugs and Discussions for protocol design and implementation questions.

See SECURITY.md for vulnerability reporting and RELEASING.md for snapshot publishing.