Home

StableBridge Platform

Enterprise-grade cross-border B2B payments using a fiat → stablecoin → fiat "sandwich" model.

StableBridge eliminates the latency and cost of traditional correspondent banking by using stablecoins as the settlement rail. It converts sender fiat to USDC on-chain, transfers via Base L2, and converts back to recipient fiat.

MVP Corridor: US → DE (USD → EUR) via Stripe ACH + Base/USDC + Modulr SEPA

---

Technology Stack

Component	Technology
Language	Java 25
Framework	Spring Boot 4.0.3
Build	Gradle 9.3.1 (Kotlin DSL)
Database	PostgreSQL 18 (per-service)
Cache	Redis 8
Messaging	Apache Kafka (Redpanda locally)
Workflows	Temporal (durable execution)
Search	Elasticsearch 9
Secrets	HashiCorp Vault
Blockchain	Base L2 + USDC (Circle)
CI/CD	GitHub Actions + SonarCloud
Containers	Docker + EKS (production)

---

Architecture at a Glance

Aspect	Approach
Pattern	Hexagonal Architecture (Ports & Adapters) with DDD
Workflows	Temporal durable execution for saga orchestration
Messaging	Event-driven with Kafka (transactional outbox, at-least-once delivery)
Data	PostgreSQL per service, TimescaleDB for FX time-series, Redis caching
Security	OAuth2 + API keys, mTLS service-to-service, HashiCorp Vault
Observability	OpenTelemetry tracing, structured JSON logging, SonarCloud

---

Wiki Navigation

Architecture & Design

• Architecture Overview — System architecture, layers, and communication patterns
• Service Catalog — All 14 microservices with responsibilities and status
• Payment Flow — End-to-end payment lifecycle and saga orchestration
• Design Patterns — Pattern catalog (hexagonal, outbox, state machine, CQRS)
• Architecture Decision Records — Key ADRs with rationale

Development

• Getting Started — Prerequisites, setup, and quick start guide
• Project Structure — Module layout, package conventions, and dependency rules
• Coding Standards — Naming, style, layer rules, and API conventions
• Testing Standards — Test strategy, fixtures, assertions, and quality gates
• Database Conventions — Schema, migrations, and persistence patterns
• Event Driven Architecture — Kafka topics, outbox pattern, and consumer patterns

Operations & Security

• Security Architecture — Authentication, authorization, secrets, and threat model
• Infrastructure and Deployment — Local dev, Docker Compose, CI/CD, and production
• Monitoring and Observability — Logging, metrics, tracing, and alerting

Project Management

• Implementation Roadmap — 7-phase roadmap from infrastructure to intelligence
• Contributing Guide — Branch naming, PR process, commit conventions, and code review

Reference

• Glossary — Terms and definitions for the stablecoin payments domain
• Troubleshooting — Common issues and solutions
• FAQ — Frequently asked questions

---

Quick Links

Resource	Location
Source Code	GitHub Repository
CI Pipeline	GitHub Actions
Code Quality	SonarCloud Dashboard
API Docs	Service-specific Swagger UI at /swagger-ui.html
Playbook	playbook/ directory in repo

---

Current Status

Phase	Name	Services	Status
0	Infrastructure Foundation	K8s, Kafka, DBs, Temporal, CI/CD	Done
1	Identity & Merchant	S10 API Gateway, S11 Onboarding, S13 IAM	Done
2	Core Payment Logic	S1 Orchestrator, S2 Compliance, S6 FX	Done
3	Value Movement MVP	S3 On-Ramp, S4 Blockchain, S5 Off-Ramp, S7 Ledger	Done
4	Operational Maturity	S8 Partner Mgmt, S9 Notifications	Planned
5	Merchant Experience	S12 Transaction History	Planned
6	Intelligence & Scale	S14 Agentic Gateway + multi-chain/corridor	Planned

3,500+ tests across 10 implemented services. Phase 3 complete.