- Integrated Zod validation schemas across various API routes to ensure input integrity and improve error handling. - Updated `mapping-service`, `orchestrator`, `packet-service`, and `webhook-service` to utilize validation middleware for request parameters and bodies. - Improved error handling in webhook management, packet generation, and compliance routes to provide clearer feedback on request failures. - Added new validation schemas for various endpoints, enhancing overall API robustness and maintainability. - Updated dependencies in `package.json` to include the new validation library.
Orchestrator Service
ISO-20022 orchestrator service managing trigger state machine and rail adapters.
Features
- ISO-20022 message routing and normalization
- Trigger state machine (CREATED → VALIDATED → SUBMITTED → PENDING → SETTLED/REJECTED)
- On-chain fund locking and release
- Rail adapter coordination (Fedwire, SWIFT, SEPA, RTGS)
- Event publishing
State Machine
CREATED → VALIDATED → SUBMITTED_TO_RAIL → PENDING → SETTLED
↓
REJECTED
API Endpoints
GET /v1/orchestrator/triggers/:triggerId- Get triggerGET /v1/orchestrator/triggers- List triggersPOST /v1/orchestrator/triggers/:triggerId/validate-and-lock- Validate and lockPOST /v1/orchestrator/triggers/:triggerId/mark-submitted- Mark submittedPOST /v1/orchestrator/triggers/:triggerId/confirm-settled- Confirm settledPOST /v1/orchestrator/triggers/:triggerId/confirm-rejected- Confirm rejectedPOST /v1/iso/inbound- Route inbound ISO-20022 messagePOST /v1/iso/outbound- Route outbound ISO-20022 message
Rails
Supported payment rails:
fedwire- Fedwireswift- SWIFTsepa- SEPArtgs- RTGS
Configuration
REST_API_URL- Main REST API URLRPC_URL- Blockchain RPC URLPRIVATE_KEY- Signer private key