这个项目能做什么

Sierpe 是一个自托管服务器,用于索引你注册的 Stellar 智能合约,并将其完整历史存储在你自己的 Postgres 数据库中。它会捕获事件、合约状态变更与当前快照、解码后的代币转账(SEP-41、CAP-67 muxed)、SAC 资产的经典 trustline,以及代币进出合约的流动。 关键能力包括: - 在数据源允许的情况下从创世区块回填,包括通过 -full 镜像重放 History Archives,以覆盖超出约 7 天 RPC 保留窗口的范围,并以针对 RPC 数据的字节等价证明作为门控。 - 遵循 getEvents v2 语义的 REST API,支持过滤器、不透明游标和扫描状态。每个响应都会声明覆盖范围与缺口,因此空结果能够区分“不存在”与“尚未索引”。 - 位于 / 的内嵌管理 UI,覆盖完整 API 表面。 - 通过带认证的 API 在运行时注册合约——无需 fork 或自定义代码。索引器会根据链上 spec 对合约进行分类,并跟随链尖。 - 面向公网域名部署的可选全表面 Basic Auth。 - 通过 Docker 容器部署在空 Postgres 旁边,支持 Railway、Docker Compose 或通用容器选项。典型项目的目标成本低于每月 10 美元。 该项目当前为 v1.10.2,事件、合约状态、代币转账、trustline 和代币流动功能已完整,并已在 mainnet 上投入生产运行。Mainnet 加固工作已覆盖共享回填扫描、缺口修剪、带并行工作者的稀疏修复计划、原始 movement XDR,以及已归档合约注册。 路线图项目包括合约类发现(注册一个 wasm hash 以索引由其部署的所有合约),以及通过签名 webhook 和 broker sink 进行推送投递,同时正在探索 MCP server。采用 Apache-2.0 许可。