跳到主要内容

无 Gas 集成指南

Status Network 在协议层面提供无 Gas 交易。你不需要 paymasters 或中继器。作为开发者，核心任务是根据发送方状态正确地估算和展示费用。

核心规则

使用 linea_estimateGas RPC 方法作为准备交易 UX 时 Gas 费用的唯一数据来源。

其他 JSON-RPC 方法参考，请参阅 JSON-RPC API。

具有 Karma 感知能力的费用估算​

在 Linea 上，linea_estimateGas 已经是估算 Gas 的推荐方式。 它在单次调用中返回 gasLimit、baseFeePerGas 和 priorityFeePerGas，其中费用字段已考虑了压缩交易大小、L1 验证成本以及 L1/L2 Gas 价格比率——这些是 eth_ 命名空间方法无法捕获的因素。

Status Network 进一步扩展了 linea_estimateGas，使其费用字段同时纳入我们的 Karma 系统；符合条件的用户费用可能降为零，而被列入拒绝名单的用户费用则可能增加。

图示：使用 linea_estimateGas 的 Gas 估算流程

这就是为什么开发者在 Status Network 上估算交易成本或为用户预填 EIP-1559 费用字段时，应该使用 linea_estimateGas。

更多信息

关于 Karma 及其对 Gas 费用和交易特权影响的详细说明，请参阅 Karmic 代币经济学 页面。

关于我们无 Gas 系统如何实现和执行的技术细节，请参阅无 Gas 交易文档。

linea_estimateGas 请求/响应结构​

请求​

linea_estimateGas 接受与 eth_estimateGas 相同的交易调用对象。 它使用与 eth_estimateGas 相同的 EVM 执行逻辑返回 gasLimit，同时返回反映 Linea L2 专属定价和 Status Network Karma 规则的费用字段——全部在单次响应中完成。

important

始终包含 from。 没有它，节点无法应用 Karma/配额/拒绝名单逻辑。

响应​

linea_estimateGas 返回的对象包含：

  • gasLimit：十六进制数量——EVM 执行的估算 Gas 单位（与 eth_estimateGas 计算方式相同）
  • baseFeePerGas：十六进制数量——下一个区块的基础费用，已考虑 Status Network 上的 Karma 规则
  • priorityFeePerGas：十六进制数量——建议的优先费用，已考虑 Status Network 上的 Karma 规则

这些费用字段可能与 eth_ 命名空间调用（如 eth_gasPrice、eth_maxPriorityFeePerGas 或 eth_feeHistory）返回的值有显著差异——后者不了解 Linea 的 L2 专属定价或 Status Network 的 Karma 调整。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "gasLimit": "0x5208",
    "baseFeePerGas": "0x0",
    "priorityFeePerGas": "0x0"
  }
}

迁移指南：从多次 eth_ 调用迁移到 linea_estimateGas​

本节介绍如何从常见的"通过多次 eth_ 调用实现 EIP-1559"流程迁移到单次 linea_estimateGas 调用，后者能在 Status Network 上提供更准确的 L2 专属费用数据和 Karma 感知定价。

迁移前：使用 eth_ 命名空间的常见 EIP-1559 估算流程​

在许多 EVM 链上，典型的 EIP-1559 估算流程如下：

  1. 通过 eth_estimateGas 估算 Gas 限制
  2. 通过 eth_maxPriorityFeePerGas 和/或 eth_feeHistory 获取 maxPriorityFeePerGas
  3. 通过 eth_getBlockByNumber 获取 baseFeePerGas
  4. 构建 EIP-1559 交易，使用：
    • gas
    • maxPriorityFeePerGas
    • maxFeePerGas，通常为 2⋅baseFeePerGas+maxPriorityFeePerGas2 \cdot \mathrm{baseFeePerGas} + \mathrm{maxPriorityFeePerGas}
# 1) Gas 限制（EVM 执行）
curl -X POST -H "Content-Type: application/json" \
  --data '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"eth_estimateGas",
    "params":[{
      "from":"0xYOUR_SENDER",
      "to":"0xCONTRACT_OR_RECIPIENT",
      "data":"0xYOUR_CALLDATA",
      "value":"0x0"
    }]
  }' \
  https://YOUR_RPC_URL

# 2) 获取建议小费金额
curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":2,"method":"eth_maxPriorityFeePerGas","params":[]}' \
  https://YOUR_RPC_URL

# 3) 获取基础费用
curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":3,"method":"eth_getBlockByNumber","params":["pending",false]}' \
  https://YOUR_RPC_URL

迁移后：使用 linea_estimateGas 的 Status Network Gas 估算流程​

在 Status Network 上，你应该从 linea_estimateGas 获取费用建议，因为正确的费用推荐取决于 Karma：

  • 账户可能有资格获得无 Gas 交易
  • 被列入拒绝名单的账户可能需要支付溢价 Gas 费用
curl -X POST -H "Content-Type: application/json" \
  --data '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"linea_estimateGas",
    "params":[{
      "from":"0xYOUR_SENDER",
      "to":"0xCONTRACT_OR_RECIPIENT",
      "data":"0xYOUR_CALLDATA",
      "value":"0x0"
    }]
  }' \
  https://YOUR_STATUS_NETWORK_RPC_URL
工具集成

许多以太坊库在内部调用 eth_estimateGas（例如 provider.estimateGas(...)）。在 Status Network 上，继续使用这些库进行标准 eth_ 方法调用，但在构建或向用户展示交易参数时，显式通过 linea_estimateGas 获取 Gas 限制和费用字段。

在 UI 中处理费用场景​

1) 无 Gas​

当 baseFeePerGas 和 priorityFeePerGas 均为零时：

  • 显示清晰的免费交易状态。
  • 跳过不必要的费用警告。

2) 溢价费用​

当发送方被列入拒绝名单（超出配额或 RLN 策略）时：

  • 显示费用金额，并说明由于配额或垃圾邮件策略，将收取溢价 Gas 费用。
  • 明确告知发送方可以支付费用，或等待配额窗口刷新。
  • 保持交易可执行；不要强制阻止。

常见陷阱​

陷阱解决方案
使用 eth_ 方法进行费用决策（eth_gasPrice、eth_maxPriorityFeePerGas、eth_feeHistory）使用 linea_estimateGas
调用 linea_estimateGas 时省略 from始终传入发送方地址以获得 Karma 感知的估算
硬编码费用假设根据返回的 baseFeePerGas 和 priorityFeePerGas 值构建费用 UI
假设所有用户都是无 Gas 的处理两种状态：无 Gas（零费用）和被拒绝名单（溢价费用）
在重试之间缓存估算值在发送前重新估算——发送方的 Karma 状态可能已发生变化

下一步​