Three normative amendments identified during the gap-analysis and now
captured as a standalone doc. Each amendment cites the implementation
impact on PRs A-G and lists follow-up tickets that extend (not regress)
the already-landed code.
\u00a75.1 Transaction Coordinator trust model:
- names the operator the Workflow Authority
- requires SoD between Coordinator operator, Identity service, and
Ledger Anchor
- requires signed state transitions verifiable by participants
- CurrenciCombo ref topology: issuing bank runs it (single-party
hosted); federated and neutral-utility topologies are future work
and can swap in without changing the API.
\u00a79.2 Commit rule (accepted != settled):
- enumerates the exact SWIFT/ISO-20022 messages that count as
settlement: pacs.002 ACSC, camt.025 ACSC, camt.054 CRDT,
MT910/MT900
- ACCP/ACSP/PDNG do NOT satisfy COMMIT; stay in VALIDATING until
settlement evidence or timer expiry -> ABORTED
- wires explicitly to PR E's camt parsers + PR B's exception taxonomy.
\u00a74.1 Instrument irrevocability matrix:
- UNWIND_PENDING is a Coordinator state, not a guarantee the
underlying banking artefacts reverse
- separate instrument-leg and payment-leg matrices based on
observable progress (dispatched / acknowledged / accepted /
settled)
- irrevocable once instrument.acknowledged; only remaining control
plane actions are accelerated expiry, counter-guarantee, or
legal discharge
- refines the reason payload on ABORTED -> UNWIND_PENDING; no
transition-table change.
Lands docs-only; no code change. Implementation follow-ups enumerated
in "Summary of downstream tickets".
- Added quick start instructions in README.md for first-time setup, including commands for complete setup, verification, and service start.
- Revised FINAL_STATUS.md to reflect the project's infrastructure completion and readiness for execution, detailing scripts created and documentation status.
- Added multi-platform deployment architecture details (Web App, PWA, DApp) to README.md.
- Included comprehensive troubleshooting guides and fix scripts in README.md.
- Enhanced CHANGELOG.md with new features, fixes, and improvements, including TypeScript error resolutions and updated documentation structure.
- Revised development setup instructions in DEV_SETUP.md to reflect changes in script usage and environment variable setup.
- Revised the development setup section in CURRENT_STATUS.md for clarity and completeness.
- Improved environment variable validation with default values in env.ts.
- Enhanced error handling in errorHandler.ts to provide clearer feedback on validation issues.
- Added a new section in CURRENT_STATUS.md detailing prerequisites and quick start instructions for development setup.
- Updated environment variable validation to include defaults for missing variables in env.ts.
- Improved error handling in errorHandler.ts for better validation feedback.
- Made various code adjustments across services to ensure robustness and clarity.
- Added AccessControl to ComboHandler for role-based access management.
- Implemented gas estimation for plan execution and improved gas limit checks.
- Updated execution and preparation methods to enforce step count limits and role restrictions.
- Enhanced error handling in orchestrator API endpoints with AppError for better validation feedback.
- Integrated request timeout middleware for improved request management.
- Updated Swagger documentation to reflect new API structure and parameters.
- Integrated ECDSA for signature verification in ComboHandler.
- Updated event emissions to include additional parameters for better tracking.
- Improved gas tracking during execution of combo plans.
- Enhanced database interactions for storing and retrieving plans, including conflict resolution and status updates.
- Added new dependencies for security and database management in orchestrator.
