> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# logsSubscribe

> 订阅交易日志。

## 端点

主网和开发网上可用的 Websockets URL：

* **Mainnet** `wss://mainnet.helius-rpc.com/?api-key=<api-key>`
* **Devnet** `wss://devnet.helius-rpc.com/?api-key=<api-key>`

<Note>Websockets 有 10 分钟的不活动计时器；强烈建议实施健康检查并每分钟发送 ping 以保持 websocket 连接活跃。</Note>

## 授权

<ParamField query="api-key" type="string" required>
  您的 Helius API 密钥。您可以在[仪表板](https://dashboard.helius.dev/api-keys)上免费获取一个。
</ParamField>

## 请求体

<ParamField body="params" type="array" required>
  <Expandable title="properties" defaultOpen>
    <ParamField body="filter" type="string | object" required>
      接收结果的日志过滤条件，按账户类型过滤。目前支持以下过滤器类型：

      * `all` - 订阅除简单投票交易之外的所有交易
      * `allWithVotes` - 订阅包括简单投票交易在内的所有交易
      * 包含以下字段的 JSON 对象：
        * `mentions: [ <string> ]` - 包含单个 Pubkey 的数组（以 base-58 编码字符串形式）；如果存在，仅订阅提到此地址的交易

      注意：`mentions` 字段当前每次方法调用仅支持一个 Pubkey 字符串。列出额外地址将导致错误。
    </ParamField>

    <ParamField body="config" type="object">
      配置对象，包含以下字段：

      <ParamField body="commitment" type="string">
        订阅的承诺级别。可以是 `finalized`、`confirmed` 或 `processed`。
      </ParamField>
    </ParamField>
  </Expandable>
</ParamField>

## 响应

<ResponseField name="result" type="integer">
  订阅 ID（用于取消订阅）
</ResponseField>

## 通知格式

通知将是一个 RpcResponse JSON 对象，其值等于：

* `signature: <string>` - 交易签名 base58 编码。
* `err: <object|null>` - 如果交易失败，则为错误；如果交易成功，则为 null。请参阅 TransactionError 定义。
* `logs: <array[string]>` - 交易指令在执行期间输出的日志消息数组。

<RequestExample>
  ```json Request theme={"system"}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "logsSubscribe",
    "params": [
      {
        "mentions": ["11111111111111111111111111111111"]
      },
      {
        "commitment": "finalized"
      }
    ]
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={"system"}
  {
    "jsonrpc": "2.0",
    "result": 24040,
    "id": 1
  }
  ```

  ```json Notification theme={"system"}
  {
    "jsonrpc": "2.0",
    "method": "logsNotification",
    "params": {
      "result": {
        "context": {
          "slot": 5208469
        },
        "value": {
          "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
          "err": null,
          "logs": [
            "SBF program 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri success"
          ]
        }
      },
      "subscription": 24040
    }
  }
  ```
</ResponseExample>