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

# 概述

> 通过一个 TypeScript 接口在多个交易场所交易永续合约，各交易场所特有的签名方式由 SDK 处理。

LI.FI Perps 是一个 TypeScript SDK，通过一个统一接口在多个交易场所交易永续期货。你调用相同的方法即可在任意受支持的交易场所下单，该交易场所的签名方案、凭证生命周期和行情数据结构均由 SDK 处理。

它要解决的不是路由问题。每个永续合约交易场所都有各自的授权模型、订单语义和推送协议，因此通常支持第二个交易场所就意味着要再写一套集成。而在这里，交易场所只是一个参数。

## 你将获得什么

<CardGroup cols={2}>
  <Card title="一个接口，多个交易场所" icon="layer-group">
    无论由哪个交易场所执行，都用相同的调用方式下单、修改和取消订单。
  </Card>

  <Card title="无需每笔订单弹出钱包" icon="pen-nib">
    用户在设置阶段签名一次。此后的交易由 SDK 管理的凭证进行授权。
  </Card>

  <Card title="内置推送能力" icon="signal-stream">
    通过 WebSocket 获取价格、订单簿、成交和订单状态，连接按通道共享。
  </Card>

  <Card title="端到端类型化" icon="code">
    线路类型来自核心 SDK 与每个交易场所插件共用的一个零依赖包。
  </Card>
</CardGroup>

## 支持的交易场所

| 交易场所        | 形态                                         | 交易如何被授权               |
| ----------- | ------------------------------------------ | --------------------- |
| Hyperliquid | 在其自有 L1 上的订单簿式永续合约                         | 由 SDK 管理的代理钱包，由用户批准一次 |
| Lighter     | 主网，加上在 Robinhood Chain 上的一个部署，统一在一个标准化合约背后 | 一个在链上注册的 Lighter 原生密钥 |
| Ondo        | 基于会话的交易场所                                  | 使用用户注册的交易场所密钥在客户端签署请求 |

每个交易场所都维护各自的设置状态和各自的交易签名方。在其中一个完成设置，并不代表在另一个也已完成设置。各交易场所特有的行为详见[交易场所](/perps/venues)。

## 各个包如何配合

核心 SDK 是一个包，每个交易场所是另一个包。你安装核心包，再加上你所需的交易场所对应的包。

```bash theme={"system"}
npm install @lifi/perps-sdk @lifi/perps-sdk-provider-hyperliquid
```

| 包                                      | 适用场景        |
| -------------------------------------- | ----------- |
| `@lifi/perps-sdk`                      | 每个项目都需要     |
| `@lifi/perps-sdk-provider-hyperliquid` | Hyperliquid |
| `@lifi/perps-sdk-provider-lighter`     | Lighter     |
| `@lifi/perps-sdk-provider-ondo`        | Ondo        |

底层是一个零依赖的线路类型包。各交易场所插件直接依赖它，并将核心 SDK 作为对等依赖，因此无论项目注册了多少个交易场所，最终都只会有一份 SDK。

SDK 暴露两层接口。服务函数是底层接口，接受一个客户端并返回交易场所数据。`PerpsClient` 位于其上层，负责整条操作流水线，也是大多数集成会使用的方式。

## 访问权限

<Warning>
  Perps 不通过公共 API 主机提供服务。SDK 面向一个受限访问的接口，未获授权的请求会被拒绝。仅从 Partner Portal 获取 API 密钥并不足够；Perps API 的访问权限需要单独授予。
</Warning>

<Card title="联系 LI.FI 销售团队" icon="handshake" href="https://li.fi/contact-us/">
  联系我们为你的集成商开通 Perps API 访问权限，确保你的集成所指向的环境是真正可以访问的。
</Card>

## 后续步骤

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/perps/quickstart" horizontal>
    安装、创建客户端、读取行情、下单。
  </Card>

  <Card title="概念" icon="diagram-project" href="/perps/concepts" horizontal>
    创建、授权、执行这一模式，以及凭证存放在哪里。
  </Card>

  <Card title="交易场所" icon="building-columns" href="/perps/venues" horizontal>
    各交易场所的签名模型、设置、存款和提款。
  </Card>

  <Card title="完整 SDK 参考" icon="book" href="https://public-perps-docs.mintlify.app/" horizontal>
    方法级参考、API 参考和错误码。
  </Card>
</CardGroup>