Liquidity Provider Onboarding & Agreement Management

[kelly-musk]

📋 Description

[cite_start]This issue defines the gatekeeping and legal framework for the cNGN ecosystem's "Market Makers"[cite: 74]. [cite_start]Unlike retail users, Institutional Liquidity Providers (LPs) require a structured onboarding pipeline that includes the digital execution of Liquidity Provision Agreements (LPAs) and the white-listing of their specific Stellar public keys to interact with privileged Aframp liquidity pools[cite: 74, 84].

🎯 Objective

[cite_start]Automate the legal and technical readiness of institutional partners, ensuring that every entity providing liquidity is contractually bound and technically authorized to participate in cNGN market operations[cite: 74, 84].

🛠️ Technical Requirements

• Onboarding Workflow:
  • [cite_start]Implement a multi-step "Partner Portal" for document submission (Certificate of Incorporation, Tax IDs)[cite: 84].
  • [cite_start]Integration with a digital signature service (e.g., DocuSign API) for signing the Master Liquidity Agreement[cite: 74].
• Credential & Key Management:
  • [cite_start]System to capture and verify the LP's Stellar "G-address"[cite: 74].
  • [cite_start]Automated "Allow-listing" in the API Key Scoping & Permission Model (Revert "POST /api/onramp" #74) to grant access to liquidity-specific endpoints[cite: 43].
• Compliance Integration:
  • [cite_start]Link the onboarding flow to the KYC/KYB Integration (Implement Database Cleanup Worker #95) to ensure the institution passes global sanctions screening[cite: 54].
• Agreement Tracking:
  • [cite_start]Maintain a versioned database of signed agreements with automated "Expiry Alerts" 30 days before a contract ends[cite: 74].

✅ Acceptance Criteria

• [cite_start][ ] An LP cannot access liquidity APIs until their signed agreement is hashed and stored in the Audit Trail (Create Dockerfile and Docker Compose Setup #117)[cite: 56, 74].
• [cite_start][ ] The system supports "Trial" vs "Full" LP statuses with different volume caps[cite: 74].
• [cite_start][ ] Administrators can revoke an LP's technical access instantly if a breach of agreement occurs[cite: 74].
• [cite_start][ ] The onboarding dashboard provides a real-time status (e.g., DOCUMENTS_PENDING, LEGAL_REVIEW, ACTIVE)[cite: 74].

🔴 Priority: Critical

Labels: Liquidity-Ops, Partner-Onboarding, Compliance

---

[henrypeters]

@henrypeters has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hi maintainer, I would love to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @henrypeters to this issue.

[drips-wave]

Congratulations, @henrypeters! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @henrypeters: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊