lily-protocol/lily-backend

Lily Backend is the server-side foundation for Lily Protocol, a platform described as autonomous agent finance infrastructure for AI agents on the Stellar blockchain network. In plain terms, it provides the backend plumbing that allows AI agents, software programs that act independently, to manage financial operations such as wallets, payments, and identity on the Stellar network. The backend exposes a developer API over HTTP, handling tasks like registering agents, validating requests, and orchestrating protocol features. It is built with TypeScript on top of Node.js 22 and uses the Express 5 web framework to define routes. Validation of incoming requests and environment configuration uses Zod, a schema-checking library that catches bad data before it reaches business logic. Security is handled through Helmet (a middleware that sets security-related HTTP headers), a CORS allowlist (a rule that controls which origins may call the API), and rate limiting. Logging uses Pino for structured output, meaning logs are machine-readable JSON rather than plain text. The project is organized into modules, each feature like agents or health checks lives in its own folder, making it straightforward for contributors to add new capabilities without touching unrelated code. Docker support is included so the service can be run locally or deployed in a container. Automated checks for linting, building, and testing run via GitHub Actions on every change. The server starts on port 4000 by default and already includes a local environment file to simplify getting started.