Apache-2.0 License · Public Repository

Open source software.

Reusable TypeScript libraries and deterministic safety gates for financial agent coordination.

Repository: github.com/sadik-tofik/equb-flowApache-2.0

EqubFlow is licensed under the Apache 2.0 license. The core domain package is completely independent of blockchain I/O or cloud services, allowing any team building rotating savings or group payment agents to reuse its logic.

View source on GitHub >>

Four reusable packages

1. packages/domain/src/classifier.ts

The Payment Classifier

A pure TypeScript engine that takes an observed transfer and round expectations, returning deterministic classification (exact match, short amount, duplicate transfer, wrong currency, or unknown sender) with exact integer base units.

2. packages/domain/src/decision-chain.ts

The Record Verifier

Deterministic RFC 8785 JSON canonicalization (JCS) paired with SHA-256 hash chaining. Can run in Node.js, browsers via WebCrypto, or standalone Python scripts without discrepancies.

3. packages/domain/src/authorizer.ts

The Payout Authorizer

Deterministic safety gate that evaluates round status, pause state, and covered contributions. Forbids duplicate payouts, wrong recipients, or unauthorized fund movements regardless of agent prompt hallucinations.

4. packages/db/migrations & RLS tests

Append-Only Ledger Schemas

Database migration scripts and row-level security policies enforcing append-only invariants on decision records, preventing any update or delete operations.

How to run the tests

Run the comprehensive Vitest test suite with a single command:

Terminal

# Clone the repository
git clone https://github.com/sadik-tofik/equb-flow.git
cd equbflow
# Install dependencies with pnpm
pnpm install
# Run the domain invariant test suite (61 tests)
pnpm --filter @equbflow/domain test

How to contribute

We welcome bug reports, threat model expansions, and contract optimizations. Please review our threat model in docs/03-Threat-Model.md before submitting pull requests. Every pull request must include tests for touched requirements.