配额与速率限制 (Quotas & Limits)

Quasar Cloud 按组织计量资源消耗，计费单位为 配额点数 (Quota Units)。Quasar Community Edition（开源社区版）拥有相同的计费接口，但其初始限制预设极高（100,000,000 点余额与每秒 100,000 次请求上限），完全不会对独立自建节点构成约束。

🧪 公开测试版政策

Quasar Cloud 当前处于公开测试阶段，面向所有开发者免费开放：

每个新创建的组织自动获得 1,000 个免费配额点数。
公测期间暂停点数充值通道。如果您的应用即将耗尽配额，请使用账户注册邮箱直接致信 [email protected] 申请免费扩容。
测试期间，平台功能特性、并发限流指标及赠送额度可能会根据网络负载动态调整。

🧮 配额消耗费率表

API 操作	消耗配额 (Units)
同步上链交易 (`POST /v1/engine/pulsar/sync`)，生产环境 App	10
同步上链交易，测试环境 App (`sk_test_`)	5
Webhook 投递通知	1（仅在首次投递尝试时计费）
查询历史交易 (`GET /v1/engine/pulsar/history`)	0（免费）
健康检查探测 (`GET /v1/engine/monitoring/health`)	0（公开免鉴权接口）

每次有效的同步请求均计入计量，包括触发 duplicate: true（因相同 txKey 已存在）的重复请求。重复请求不会创建新记录，也不会发起二次链上追踪，因此客户端重试 onRemoteCreate 是幂等安全的，但会扣减基础调用点数。

📉 配额耗尽时的降级机制

交易同步接口仍将继续接收数据，保障终端用户的钱包交易永不丢弃：此时 API 返回 mode: "lazy"（状态码由 200 转为 HTTP 202 Accepted），交易进入异步延迟追踪队列。
其他需要 API 密钥的请求（包括历史交易列表查询）将直接拒绝并返回 402 Payment Required，直至账户配额恢复。

您可以在 Quasar 控制台随时查看配额消耗趋势；当余额偏低时平台会自动发送邮件告警。公测期间请联系 [email protected] 获取更多配额。

🚦 平台其他安全限额

限制项	参数值
每秒请求数 (RPS)	按组织隔离（Quasar Cloud 默认为 5 req/s）；超出限制将返回 HTTP 429
单页历史交易记录上限	limit 参数最大为 100 条（默认为 10 条）
历史查询深度	分页最多可回溯 10,000 笔交易；更深的页面返回 `400 page_too_deep`（请改用状态、网络、钱包或 `txKey` 过滤）
单个组织可创建的应用数量	最多 30 个 App
单应用 Webhook 终端节点数量	最多 20 个 Endpoints
localhost Webhook 调试节点	单组织限 1 个（配合 CLI 中继进行本地开发调试）
Webhook 接收端超时时限	单次投递最多等待 10 秒

此外，所有同步交易体还必须符合 Pulsar 的数据安全规格校验（文本字段与 payload 载荷长度上限）；非法结构将直接拒绝并返回 HTTP 400。