XRPLHub — XRPLScore, MPT issuer risk & payment pre-checks

XRPLHub.io — 后端

xrplhub.io 的生产应用：部署在 Vercel 上的 Next.js（App Router、TypeScript），通过 Prisma 使用 Neon Postgres，通过轮换使用的公共节点池读取 XRP Ledger，并使用 Xaman / Crossmark / GemWallet 签名。已发布的代码中没有任何 AI 或大模型。

功能

产品	说明
XRPLScore	根据 8 项公开账本信号为 XRPL 钱包打分，分数范围为 300–850（使用一个引擎，src/lib/xrplscore.ts）。免费查询可能由 15 分钟缓存提供；响应会说明这一点（fromCache、cacheAgeSeconds）。
交易服务	付费链上操作（信任线、托管、AMM、NFT，等等）。我们构建精确的交易；购买者在自己的钱包中签名。服务数量仅由 src/app/api/execute/serviceCatalog.ts 中的 BUILDABLE_SERVICE_IDS 决定。
B2B API	以 RLUSD/XRP 出售的密钥（/api/v1/*、/api/monitor/*、/api/screen/ofac、借贷端点）。套餐见 src/lib/plans.ts；配额严格执行（达到上限时返回 HTTP 429）。
x402 按次付费	为评分、报告和筛查端点按请求付费（通过 t54 XRPL Facilitator 使用 RLUSD；通过 Coinbase 的 Facilitator 在 Base 上使用 USDC）。
持续监控	监控钱包、HMAC 签名的 Webhook、稀疏的经证明观察结果。每天一次，并非实时。请参阅 docs/MONITORING.md。
OFAC 筛查回执	对照 OFAC SDN 名单中的 XRP 地址进行精确匹配检查，并记录为回执；回执仅证明流程已执行，绝不表示某个地址无违规记录或受到制裁。
MPT / 凭证查询	只读查看 Multi-Purpose Token 发行方和 XLS-70 凭证，并分别标注其覆盖范围。
社区资助	每份申请都由人工审核；不会自动作出决定或发放款项。目前暂停受理申请（src/lib/grantsStatus.ts 中的 GRANT_APPLICATIONS_OPEN），因为已获批的资助正在等待资金。捐赠仍开放。

XRPLHub 不是银行、信用局、消费者报告机构或受监管实体，其返回的任何内容均不构成法律、财务或合规建议。

本代码库明确遵循的原则

• 所有价格均由服务端决定。 src/lib/servicePrices.ts 是唯一的价格表。不会读取客户端发送的金额或货币信息。
• 付款只在账本上验证一次。 src/lib/paymentGate.ts 会检查一笔已验证且成功的付款：付款必须是以 XRP 或来自真实发行方的 RLUSD 支付给资金库、金额足以覆盖价格；每个付款哈希在数据库中只能使用一次。
• 匹配发票时不设扫描窗口。 结账发票（src/lib/rlusd.ts）已知交易哈希时按哈希精确查找；否则会从发票创建时起回溯遍历资金库的历史记录——零星小额交易无法让真实付款从视野中消失。只有完整读取账本后，发票才会关闭。
• 地址拼写错误会被拒绝，不会进入筛查。 所有地址都会经过 src/lib/address.ts（base58check）处理。
• 缓存评分绝不会用于证明。 scripts/check-attestation-freshness.mjs 会在 npm run build 中运行；若任何证明模块导入缓存或获取依赖缓存的评分路由，就会导致构建失败。
• 部分数据不会被当作完整数据。 账本读取失败时会返回 503 或 degraded / complete:false 标志，绝不会给出看似完整无误的答案。
• 每项判断的响应中都附有免责声明。
• 资金库是一个单密钥 XRPL 账户。 账本上没有签名者列表；在实际配置之前，任何内容都不得声称其受到多重签名保护。

目录结构

src/app/api/…      route handlers (payments, scoring, screening, monitoring, x402, MCP, admin, cron)
src/app/…          the site (homepage, pricing, donate, verify pages)
src/lib/…          engine, pricing + payment gate, x402, monitoring, screening, MPT/credentials, watchdog
prisma/schema.prisma
scripts/           build gates (freshness, service parity) and operator scripts
docs/              AUTONOMY.md (what runs unattended), MONITORING.md, CREDENTIAL-SPEC.md, calibration notes

在本地运行

npm install
cp .env.example .env        # fill in DATABASE_URL and the keys you need
npx prisma db push          # creates/updates tables on your Neon database
npm run dev

npm run build 会运行两项构建门禁（证明新鲜度、服务一致性），然后执行 prisma generate，最后运行 next build，并强制检查 TypeScript 错误。

主要环境变量（见 .env.example；未设置的变量会明确报错，不会静默处理）：

变量	用途
DATABASE_URL	Neon Postgres
TREASURY_ADDRESS、RLUSD_ISSUER、RLUSD_CURRENCY	付款去向，以及计入统计的 RLUSD
XUMM_API_KEY、XUMM_API_SECRET	Xaman 登录和付款请求
ADMIN_API_TOKEN	每个管理路由（未设置时会安全拒绝请求）
CRON_SECRET	两个每日定时任务
CREDENTIAL_SIGNING_SECRET	付费链下证书（未设置时不会签发任何证书）
ANCHOR_WALLET_SEED、MPT_ANCHOR_ENABLED	链上 Merkle 根锚定
BITHOMP_API_KEY	MPT 注册表持有者数量
CDP_API_KEY_ID、CDP_API_KEY_SECRET	USDC-on-Base x402 促进器
ERROR_WEBHOOK_URL、HEALTHCHECK_PING_URL	警报和外部故障监测开关

运维

docs/AUTONOMY.md 是无人值守运行事项的准确信息来源，包括每天 06:00 和 07:00 UTC 运行的两个 Vercel 定时任务、过期内容及其过期时间、监控程序，以及长期离开后应首先检查的事项。每次推送到 main 都会触发部署；重新部署时请关闭 Vercel 构建缓存。

联系邮箱：[email protected]