Service: Investment Process Management
The Investment Process Management engine is the full-stack infrastructure powering compliant, transparent, and modern capital formation for tokenized RWAs. It addresses the core problems slowing digital capital formation—complex onboarding, disconnected payments, manual compliance, limited visibility, security gaps, and illiquidity—by orchestrating a seamless, end-to-end digital experience. It manages the entire investor journey, from initial verification to final token distribution and ongoing post-investment tracking, ensuring efficiency, compliance, and trust for investors, issuers, and operators.
This engine delivers value across the ecosystem:
For Investors: Frictionless onboarding, full transparency into portfolio and payouts, enhanced trust through regulated escrow and security.
For Issuers: Faster capital formation, automated compliance (filings, KYC), increased operational efficiency, and enhanced investor confidence.
For Operators: Scalable multi-issuer architecture, reduced legal exposure through built-in rules and audit trails, and a future-proof foundation ready for tokenization and secondary markets.
Core Technical Components & APIs
This engine is a sophisticated orchestrator that sits at the center of the platform's financial operations.
Primary Models:
Investment Model: The central record this engine creates and manages through its lifecycle.
Offer Model: The source of truth for the terms, status, and funding goals this engine works towards.
Profile Model: The source of truth for investor identity and compliance status.
Governing Logic:
Investment Status Lifecycle: The strict state machine that this engine enforces.
Funding Status Lifecycle: The granular payment status this engine monitors.
Primary APIs:
investment-api: Used by the Investor Portal to create and manage individual investments.
offer-api: Used to manage subscription mechanism and trigger the closing of an offer.
evm-api: Called by the engine to issue tokens to an investor.
e-signature-api: Called by the engine to orchestrate the signing of legal agreements.
payment-api: Called by the engine to initiate payment transfers.
The Process Lifecycle: A Step-by-Step Breakdown
The engine manages the investment journey through distinct, automated phases.
Phase 1: Unified Onboarding & Verification
While primarily handled by the Regulatory Compliance Engine, this engine acts as the trigger and consumer of verification results.
Eligibility Check: Before allowing an investment flow to start, it calls the kyc-api and profile-api to confirm the investor Profile meets all KYC, AML, Accreditation, and regulation-specific (e.g., Reg CF limits, MiFID II) requirements for the target Offer.
Share Availability Check: It calls the RWA Tokenization Engine to validate that enough shares are available before allowing the investor to proceed.
Phase 2: Investment Commitment & Documentation
Orchestrates the user's journey through the multi-step application.
Seamless Application Flow: Guides the investor through selecting the investment amount, confirming ownership (Profile), and choosing a funding method via the Investor Portal. It validates share availability against the Offer ledger (managed by the RWA Tokenization Engine).
Automated Document Generation & Signing: Dynamically generates subscription agreements using Offer and Profile data. The engine guides the user through the steps, calling the Electronic Signature Service to present and execute legal agreements.
Record Creation: Upon successful submission of the final "Review" step, the engine creates the Investment record with a CONFIRMED/LEGALLY CONFIRMED status.
Phase 3: Integrated Funding & Smart Escrow
Manages the secure collection and reconciliation of investment funds across multiple payment rails.
Payment Orchestration: The engine performs a final check with the Regulatory Compliance Engine. Upon LEGALLY CONFIRMED status (post-compliance checks), it calls the payment-api or wallet-api to initiate the appropriate fund transfer (ACH, wire, wallet balance, stablecoin via evm-api) to the designated regulated smart escrow account.
Real-time Status Tracking: Monitors webhooks and API responses from payment providers to update the Investment 's funding_status (Initiate, Received, Failed, etc.).
Automated Reconciliation: Matches incoming funds in escrow to pending investments, reducing manual effort and errors.
Phase 4: Offer Closing, Settlement & Token Issuance
Manages the successful closing of the Offer and the final steps of the investment.
Condition Monitoring & Enforcement: Continuously tracks the aggregate funding status, subscription %, and compliance verification across all Investments linked to an Offer. Prevents premature closing.
Automated Fund Release: Upon administrator confirmation of a successful close, orchestrates the release of funds from escrow to the issuer via the payment-api. Updates funding_status to `SETTLED`.
On-Chain Token Distribution: Triggers the final token distribution by calling the evm-api to transfer the correct number of tokens from the offer treasury wallet to each investor's EVM Wallet, creating EVM Transfer records.
Status Finalization: Cascades the final Offer status (CLOSED_SUCCESSFULLY or CLOSED_UNSUCCESSFULLY) down to all associated Investment records.
Phase 5: Post-Investment Management
Provides data and triggers for ongoing investor relations and servicing.
Cap Table Synchronization: Ensures the final list of CLOSED_SUCCESSFULLY investments provides accurate data for cap table management (potentially syncing with Transfer Agents or EVM Contract, holder lists).
Distribution Trigger: Provides the necessary data (investor, holding amount) to the Smart Disctribution Service when returns are to be paid.
Investor Reporting Data: Makes investment status, transaction history, and document links available via the investment-api for display in the Investor Portal.
Advanced Scenarios & Platform Resilience
Investment Cancellation: The engine manages the full cancellation workflow, from an investor's request and an admin's approval to triggering the correct refund logic based on the investment's current status and payment method.
Offer Failure: If an Offer is closed unsuccessfully, the engine orchestrates the bulk refund process via the payment-api or wallet-api, creating all necessary Transaction records to refund capital to investors.
Payment Failures: The engine gracefully handles a FAILED funding_status from a payment provider, updating the Investment's functional-spec/state-lifecycle/investment-state-lifecyclestatus appropriately and triggering notifications for the user and administrators, and potentially allows for retry attempts depending on the failure reason.
Immutable Audit Trail: Ensures every status change, payment attempt, signature, and cancellation action related to an Investment is logged immutably, often anchored or verifiable via blockchain records where applicable.