Developer Guide

This guide covers API integration, local development, application development, and domain service patterns for Lana Bank.

API Integration

• API Integration Overview — Integration paths for Lana GraphQL APIs
• Quickstart — Make your first API call
• Authentication — Obtain and manage API tokens
• GraphQL Integration — Client setup, queries, mutations, and pagination
• Real-time Subscriptions — Receive event notifications via GraphQL subscriptions

Local Development

• Local Development Setup — Get a working dev environment in minutes
• Authentication (Local) — Keycloak realms, login flows, test credentials
• Authorization — Casbin RBAC model, roles, and permissions
• Configuration — Domain config system and macros
• Testing Strategy — Rust, BATS, and frontend testing

Application Development

• Frontend Applications — Tech stack, patterns, and project structure
• Admin Panel — Admin panel architecture and development
• Shared Components — UI component library
• Credit UI — Credit facility management interface
• GraphQL Development — Apollo Client setup, codegen, and local endpoints

Domain & Services

• Domain Services — DDD module structure and interactions
• Event System — Event sourcing, outbox pattern, public vs private events
• Background Jobs — Job processing, scheduling, and specific jobs
• Cala Ledger Integration — Double-entry accounting engine
• Custody & Portfolio — BitGo/Komainu integration, collateral management
• Testing Self-Custody on Signet — Local Signet wallets, xpub setup, and funding pending facilities

Platform Services

• Infrastructure Services — External dependencies and service layers
• Observability — OpenTelemetry, tracing, Honeycomb
• Audit System — Authorization logging and compliance
• Notification Providers — Runtime SMTP setup, secret handling, and delivery visibility