GuidanceGate is a financial guidance AI agent that uses XRPL blockchain technology to create transparent, on-chain consent for vulnerable populations. Unlike traditional financial apps where consent can be hidden or changed, GuidanceGate uses XRPL trustlines to create permanent, auditable records of user opt-in. This ensures vulnerable users, including individuals with disabilities, caregivers, and low-income families, can safely access financial guidance resources with full transparency and control.

Financial guidance apps often hide consent in terms of service, leaving vulnerable users without transparency. I built GuidanceGate to change that. I was inspired by two ideas: blockchain transparency and financial inclusion. What if XRPL trustlines could represent explicit, on-chain consent? What if an AI agent only showed resources from issuers users explicitly opted into?

This led to GuidanceGate, a trustline-gated financial guidance platform. I learned that XRPL’s native features work well for consent management. Trustlines create permanent, auditable records. AccountLines queries enable real-time verification. I also learned that Crossmark wallet integration requires handling multiple SDK paths and response formats, and that serverless architecture works well for XRPL queries.

I built GuidanceGate in phases: first, the core XRPL client and serverless API endpoints on Vercel; next, Crossmark wallet integration for trustline creation and payments; then, a Dify AI agent that gates access based on real-time ledger queries; finally, three specialized issuers, Community Aid, InclusiveCare, and CalmBridge.

The biggest challenge was Crossmark wallet integration. The SDK has multiple response formats, and Crossmark sometimes showed "Transaction Successful" while my code couldn't parse the response. I solved this by implementing fallback logic checking multiple SDK paths and adding recursive hash extraction to handle different response structures.

The result demonstrates how blockchain can serve social good. By repurposing XRPL trustlines for consent management, I've created a transparent, auditable system that protects vulnerable users while enabling financial inclusion. Every opt-in and payment is recorded on-chain, creating accountability that traditional apps cannot match.

Built With

Share this project:

Updates