Stellar-Kolo/kolo-backend

选用指南

AI 根据 README 整理 · 2026/10/14 16:51:15

使用方式

通过Node.js运行，提供API和WhatsApp webhook入口，使用命令行启动开发服务器。

查看 README 依据

| [kolo-backend](https://github.com/Stellar-Kolo/kolo-backend) | WhatsApp, API, data, Stellar, and Soroban coordination (this repository) | | [kolo-contracts](https://github.com/Stellar-Kolo/kolo-contracts) | Rust Soroban contract for group savings rules | ## Main components - `src/controllers/`, `src/routes/`, `src/middleware/` — API and WhatsApp webhook entry points, signature checks, and request controls. - `src/services/` — user, group, payment request, payout, WhatsApp, Stellar, and Soroban operations.

Requires Node.js, PostgreSQL, and Redis. Configure the environment for the services being used. The application requires encryption and WhatsApp webhook secrets at startup; keep all credentials in local environment configuration or a secret manager, never in Git. ```bash npm ci npm run dev ``` Available scripts: ```bash npm start npm test ``` Apply Prisma migrations and generate the Prisma client for your development database before running database-backed flows. Configure Stellar Testnet and a Soroban Testnet RPC endpoint for integration work. ## Current status and limitations

部署要求

需要Node.js、PostgreSQL和Redis，并配置加密和WhatsApp webhook密钥。

查看 README 依据

Requires Node.js, PostgreSQL, and Redis. Configure the environment for the services being used. The application requires encryption and WhatsApp webhook secrets at startup; keep all credentials in local environment configuration or a secret manager, never in Git. ```bash npm ci npm run dev ``` Available scripts: ```bash npm start npm test ``` Apply Prisma migrations and generate the Prisma client for your development database before running database-backed flows. Configure Stellar Testnet and a Soroban Testnet RPC endpoint for integration work. ## Current status and limitations

已知限制

项目处于积极开发阶段，非生产级金融服务；前端和后端未完全集成，部分功能为原型或模拟；资产面额不一致（目标USDC但部分路径使用XLM）；平台托管钱包密钥，非自托管。

查看 README 依据

- The frontend and backend are not yet a fully connected product. Some frontend data, authentication, and wallet routes are prototypes. - Worker implementations exist, but not all are started by the current server entry point. Verify worker lifecycle before relying on a background flow. - Contract deployment, member lifecycle, contribution handling, and payout orchestration are still being aligned with the current Soroban ABI. - The contract code has a Stellar Testnet deployment for review, but no savings group has been initialized. This is not an active savings service.

- Asset denomination is inconsistent: the product brief targets USDC, while implemented payment and command paths include XLM. Contract amounts are integer base units and require exact asset decimal handling. - Some user-facing operations, including group withdrawal, are marked or implemented as mocked. A success message in a command path is not evidence of an on-chain transfer.

- Platform-managed wallet signing material is encrypted at rest in the current design. Kolo is not currently a self-custody wallet product; key custody and operational safeguards remain part of product and security work. Use Stellar Testnet for development. Do not use production keys or describe the service as ready to custody funds or run real savings circles. ## Stellar development notes - Keep the configured Stellar network, Horizon endpoint, Soroban RPC endpoint, and network passphrase aligned.