Solana 开发者平台

Solana 开发者平台（SDP）是一个用于构建 Solana 应用的企业级开发平台，支持钱包、代币发行、支付、合规检查以及托管仪表盘。

状态

SDP 是主网前软件。公共仓库和 API 旨在用于企业开发、评估和 devnet 集成。

此代码库尚未经过审计。请勿在没有自行审查、测试和安全评估的情况下，将其用于托管生产资金、运行主网金融工作流或保护受监管的生产活动。

完全自托管仍在进行中。该仓库包含本地开发和基础设施辅助工具，但目前主要支持的路径是托管平台和面向 devnet 的开发。

托管平台可在 https://platform.solana.com 访问，公共文档位于 https://platform.solana.com/docs。

本仓库包含什么？

• apps/sdp-api: 部署到 Cloud Run 的 Node.js API，OpenAPI 源，路由处理器，Postgres/Redis 集成
• apps/sdp-web: 仪表盘应用
• apps/sdp-docs: 公共文档站点和生成的 API 参考
• packages/sdp-types: 共享运行时类型和产品常量
• packages/sdp-earn: Earn 提供商集成（Ground 金库基础设施；多提供商架构 — 参见其 README）
• packages/sdp-api-integration: 面向维护者的集成测试框架
• infra: 本地和部署基础设施辅助工具
• docs/ops: 操作员和维护者笔记

支持的公共 API 领域包括 health、API keys、wallets、projects、issuance、payments 和 compliance。内部路由和特定提供商的运维细节不属于公共接口的一部分。

Local Development

先决条件：

• Node.js 22+
• pnpm 10.16+
• Git
• Docker 或其他兼容 Compose 的容器运行时，用于本地 Postgres 和 Redis

安装依赖：

pnpm install

创建一个本地 API 环境文件：

cp apps/sdp-api/.env.local.example apps/sdp-api/.env.local

对于本地开发网工作，请在 apps/sdp-api/.env.local 中设置 SOLANA_RPC_URL=https://api.devnet.solana.com。

启动本地 Postgres 和 Redis 服务，然后启动应用程序：

pnpm db:postgres:up
pnpm --filter @sdp/api db:postgres:bootstrap
pnpm dev

有用的本地 URL：

• API: http://localhost:8787
• API 文档: http://localhost:8787/docs
• 仪表盘: http://localhost:3000

某些由提供商支持的功能需要单独的供应商凭证，例如托管提供商、合规提供商、法币通道、仪表盘身份验证和集成测试。

检查

常用检查：

pnpm --filter @sdp/api test
pnpm --filter @sdp/api typecheck
pnpm --filter sdp-docs check:links
pnpm --filter sdp-docs build
pnpm typecheck

生成的工件应使用其所属脚本重新生成，而不是手动编辑：

pnpm -C apps/sdp-api openapi:generate
pnpm -C apps/sdp-docs generate:api
pnpm -C apps/sdp-docs generate:ai

贡献

在提交拉取请求之前，请阅读 CONTRIBUTING.md、AGENTS.md 以及 本地开发说明。请为行为变更包含测试，并确保公开文档与 OpenAPI 源保持一致。

许可证

本项目采用 MIT 许可证 授权。

安全

请使用 SECURITY.md 中的流程报告安全问题。请勿为漏洞或疑似密钥公开创建问题。