Skip to content

docs(cn): sync new pages and updates from recent merged PRs (second part) #185

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ChuhanJin merged 1 commit into from
Aug 4, 2026
Merged

docs(cn): sync new pages and updates from recent merged PRs (second part) #185

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .gitbook/cn/contributing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "关于本文档"
description: "Injective 开发者文档由 Injective Labs 的开发者关系团队撰写和维护。"
icon: info
updatedAt: "2026-03-30"
---

[Injective Labs](https://injective.com) 是 Injective 区块链背后的核心团队。

## 参与贡献

本文档为开源项目。
如果你发现错误或希望改进某个页面，请在以下地址提交 pull request：
[`github.com/InjectiveLabs/injective-docs`](https://github.com/InjectiveLabs/injective-docs)。

欢迎社区贡献！

## 最近更新

最近一次重大更新于 2026 年 3 月完成。
72 changes: 72 additions & 0 deletions .gitbook/cn/defi/trading/oracle-feed-sources.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
---
title: "预言机价格源"
description: "Injective 上非加密永续合约市场的预言机价格源和合约规范。"
updatedAt: "2026-06-04"
---

下表列出了 Injective 上可用的非加密永续合约市场，包括资产说明、最大杠杆倍数，以及为每个市场指数价格提供支撑的底层预言机价格源。

## 股票

| 交易对 | 说明 | 底层资产 | 最大杠杆 |
|------------|-------------|------------|--------------|
| CRCL/USDC PERP | CRCL 跟踪 Circle Internet Group, Inc. 1 股普通股的价值。Circle 是一家全球性数字金融服务公司，也是全球最大的美元支持稳定币之一 USDC 的发行方。 | [CRCL / USD](https://app.pyth.com/explore/Equity.US.CRCL%2FUSD) | 25x |
| RKLB/USDC PERP | RKLB 跟踪 Rocket Lab USA, Inc. 1 股普通股的价值。Rocket Lab 为商业、民用和国防客户提供火箭发射服务、航天器组件和太空系统。 | [RKLB / USD](https://app.pyth.com/explore/Equity.US.RKLB%2FUSD) | 10x |
| AMZN/USDC PERP | AMZN 跟踪 Amazon.com, Inc. 1 股普通股的价值。亚马逊经营全球在线零售业务、AWS 云基础设施、数字媒体服务和物流业务。 | [AMZN / USD](https://app.pyth.com/explore/Equity.US.AMZN%2FUSD) | 25x |
| NVDA/USDC PERP | NVDA 跟踪 NVIDIA Corporation 1 股普通股的价值。NVIDIA 生产用于游戏、数据中心、机器学习和高级计算的 GPU、加速计算系统和 AI 平台。 | [NVDA / USD](https://app.pyth.com/explore/Equity.US.NVDA%2FUSD) | 25x |
| COIN/USDC PERP | COIN 跟踪 Coinbase Global, Inc. 1 股普通股的价值。Coinbase 运营一家领先的加密货币交易所和数字资产平台，为零售和机构客户提供交易、托管和质押服务。 | [COIN / USD](https://app.pyth.com/explore/Equity.US.COIN%2FUSD) | 25x |
| ORCL/USDC PERP | ORCL 跟踪 Oracle Corporation 1 股普通股的价值。Oracle 为全球企业和政府提供企业软件、云基础设施和数据库管理系统。 | [ORCL / USD](https://app.pyth.com/explore/Equity.US.ORCL%2FUSD) | 10x |
| INTC/USDC PERP | INTC 跟踪 Intel Corporation 1 股普通股的价值。Intel 是全球最大的半导体制造商之一，生产用于计算和通信的微处理器、芯片组和集成电路。 | [INTC / USD](https://app.pyth.com/explore/Equity.US.INTC%2FUSD) | 10x |
| MU/USDC PERP | MU 跟踪 Micron Technology, Inc. 1 股普通股的价值。Micron 设计和制造存储器与存储半导体产品，包括用于计算机、移动设备和数据中心的 DRAM 和 NAND 闪存产品。 | [MU / USD](https://app.pyth.com/explore/Equity.US.MU%2FUSD) | 10x |
| DELL/USDC PERP | DELL 跟踪 Dell Technologies Inc. 1 股普通股的价值。Dell 为全球企业和消费者提供 IT 基础设施、个人电脑、服务器、存储解决方案和云服务。 | [DELL / USD](https://app.pyth.com/explore/Equity.US.DELL%2FUSD) | 10x |
| SNDK/USDC PERP | SNDK 跟踪 SanDisk Corporation 1 股普通股的价值。SanDisk 设计和制造闪存产品，包括面向消费和企业应用的固态硬盘和 NAND 存储解决方案。 | [SNDK / USD](https://app.pyth.com/explore/Equity.US.SNDK%2FUSD) | 10x |
| AAPL/USDC PERP | AAPL 跟踪 Apple Inc. 1 股普通股的价值。Apple 开发和销售消费电子产品、软件与服务，包括 iPhone、Mac、iPad、Apple Watch，以及不断增长的数字服务生态系统。 | [AAPL / USD](https://app.pyth.com/explore/Equity.US.AAPL%2FUSD) | 25x |
| TSLA/USDC PERP | TSLA 跟踪 Tesla, Inc. 1 股普通股的价值。Tesla 设计和制造电动汽车、电池储能系统和太阳能产品，并开发自动驾驶软件。 | [TSLA / USD](https://app.pyth.com/explore/Equity.US.TSLA%2FUSD) | 25x |
| MSFT/USDC PERP | MSFT 跟踪 Microsoft Corporation 1 股普通股的价值。Microsoft 提供软件、云计算服务和硬件，包括 Windows、Azure、Microsoft 365 以及 Xbox 游戏平台。 | [MSFT / USD](https://app.pyth.com/explore/Equity.US.MSFT%2FUSD) | 25x |
| META/USDC PERP | META 跟踪 Meta Platforms, Inc. 1 股普通股的价值。Meta 拥有 Facebook、Instagram 和 WhatsApp 等主流社交与消息平台，并在广告、AI、虚拟现实和元宇宙产品方面进行投入。 | [META / USD](https://app.pyth.com/explore/Equity.US.META%2FUSD) | 25x |
| GOOGL/USDC PERP | GOOGL 跟踪 Alphabet Inc. 1 股普通股的价值。Alphabet 是 Google 的母公司，经营搜索、广告、云计算和 AI 业务，并在自动驾驶汽车和生命科学等领域进行投入。 | [GOOGL / USD](https://app.pyth.com/explore/Equity.US.GOOGL%2FUSD) | 25x |
| PLTR/USDC PERP | PLTR 跟踪 Palantir Technologies Inc. 1 股普通股的价值。Palantir 开发数据分析和 AI 软件平台，被政府机构和大型企业用于情报、运营和决策。 | [PLTR / USD](https://app.pyth.com/explore/Equity.US.PLTR%2FUSD) | 25x |
| HOOD/USDC PERP | HOOD 跟踪 Robinhood Markets, Inc. 1 股普通股的价值。Robinhood 运营一家总部位于美国的零售券商平台，提供股票、期权和加密货币的免佣金交易。 | [HOOD / USD](https://app.pyth.com/explore/Equity.US.HOOD%2FUSD) | 25x |
| AVGO/USDC PERP | AVGO 跟踪 Broadcom Inc. 1 股普通股的价值。Broadcom 设计和提供广泛的半导体与基础设施软件解决方案，用于数据中心、网络、存储和无线通信。 | [AVGO / USD](https://app.pyth.com/explore/Equity.US.AVGO%2FUSD) | 10x |

## Pre-IPO

| 交易对 | 说明 | 底层资产 | 最大杠杆 |
|------------|-------------|------------|--------------|
| SPCX/USDC PERP | SPCX 代表 Space Exploration Technologies Corp. A 类普通股每股隐含价值的 Pre-IPO 市场。SpaceX 制造并发射火箭和航天器，运营 Starlink 宽带网络，并持有 xAI。 | SPCX/USDC | 5x |

## 指数

| 交易对 | 说明 | 底层资产 | 最大杠杆 |
|------------|-------------|------------|--------------|
| TRADFI/USDC PERP | TRADFI 提供对广泛的美国大盘股票基准的敞口。 | [Pyth Feed](https://app.pyth.com/explore/Equity.US.SPY%2FUSD) | 50x |
| TTI/USDC PERP | TTI 提供对以科技股为主的美国股票基准的敞口。 | [Pyth Feed](https://app.pyth.com/explore/Equity.US.QQQ%2FUSD) | 50x |

## ETF

| 交易对 | 说明 | 底层资产 | 最大杠杆 |
|------------|-------------|------------|--------------|
| GLD/USDC PERP | GLD 跟踪 1 份黄金支持的交易所交易产品的价值。该产品旨在反映实物黄金金条的价格表现，让投资者无需直接持有实物即可获得对黄金的敞口。 | [GLD / USD](https://app.pyth.com/explore/Equity.US.GLD%2FUSD) | 50x |

## 商品

| 交易对 | 说明 | 底层资产 | 最大杠杆 |
|------------|-------------|------------|--------------|
| XAU/USDC PERP | XAU 跟踪 1 金衡盎司黄金的价值。黄金是一种在全球范围内交易的贵金属，被用于储备、投资产品、珠宝以及对冲通胀的投资组合。 | [XAU / USD](https://app.pyth.com/explore/Metal.XAU%2FUSD) | 50x |
| XAG/USDC PERP | XAG 跟踪 1 金衡盎司白银的价值。白银是一种贵金属，在电子产品、太阳能板和医疗器械等领域有广泛的工业应用，同时也是一种投资资产。 | [XAG / USD](https://app.pyth.com/explore/Metal.XAG%2FUSD) | 50x |

## 外汇

| 交易对 | 说明 | 底层资产 | 最大杠杆 |
|------------|-------------|------------|--------------|
| EURUSD/USDC PERP | EURUSD 跟踪 EUR/USD 汇率。欧元（EUR）在整个欧元区使用，是全球外汇交易中流动性最高的货币之一。 | [EUR / USD](https://app.pyth.com/explore/FX.EUR%2FUSD) | 100x |
| GBPUSD/USDC PERP | GBPUSD 跟踪 GBP/USD 汇率。英镑（GBP）是英国的官方货币，也是世界上历史最悠久、交易最活跃的货币之一。 | [GBP / USD](https://app.pyth.com/explore/FX.GBP%2FUSD) | 100x |
| AUDUSD/USDC PERP | AUDUSD 跟踪 AUD/USD 汇率。澳大利亚元（AUD）是澳大利亚的官方货币，与铁矿石和煤炭等大宗商品出口密切相关。 | [AUD / USD](https://app.pyth.com/explore/FX.AUD%2FUSD) | 100x |
| NZDUSD/USDC PERP | NZDUSD 跟踪 NZD/USD 汇率。新西兰元（NZD）是新西兰的官方货币，受农产品出口和全球风险偏好影响。 | [NZD / USD](https://app.pyth.com/explore/FX.NZD%2FUSD) | 100x |
| USDCHF/USDC PERP | USDCHF 跟踪 USD/CHF 汇率。瑞士法郎（CHF）是瑞士的官方货币，由于瑞士的政治中立和金融稳定，被普遍视为避险货币。 | [USD / CHF](https://app.pyth.com/explore/FX.USD%2FCHF) | 100x |
| USDCAD/USDC PERP | USDCAD 跟踪 USD/CAD 汇率。加拿大元（CAD）是加拿大的官方货币，鉴于加拿大是重要的原油出口国，其汇率与油价高度相关。 | [USD / CAD](https://app.pyth.com/explore/FX.USD%2FCAD) | 100x |
| USDJPY/USDC PERP | USDJPY 跟踪 USD/JPY 汇率。日元（JPY）是日本的官方货币，也是全球流动性最好的货币之一，在市场承压期间常被用作避险资产。 | [USD / JPY](https://app.pyth.com/explore/FX.USD%2FJPY) | 100x |
| USDSEK/USDC PERP | USDSEK 跟踪 USD/SEK 汇率。瑞典克朗（SEK）是瑞典的官方货币，对全球风险偏好和欧洲经济状况较为敏感。 | [USD / SEK](https://app.pyth.com/explore/FX.USD%2FSEK) | 50x |
| USDNOK/USDC PERP | USDNOK 跟踪 USD/NOK 汇率。挪威克朗（NOK）是挪威的官方货币，与油价高度相关，反映挪威作为主要石油出口国的地位。 | [USD / NOK](https://app.pyth.com/explore/FX.USD%2FNOK) | 50x |
| USDSGD/USDC PERP | USDSGD 跟踪 USD/SGD 汇率。新加坡元（SGD）是新加坡的官方货币，由新加坡金融管理局按有管理的浮动汇率政策管理。 | [USD / SGD](https://app.pyth.com/explore/FX.USD%2FSGD) | 50x |
| USDHKD/USDC PERP | USDHKD 跟踪 USD/HKD 汇率。港元（HKD）是香港的官方货币，采用与美元挂钩的联系汇率制度。 | [USD / HKD](https://app.pyth.com/explore/FX.USD%2FHKD) | 50x |
219 changes: 219 additions & 0 deletions .gitbook/cn/developers-ai/x402.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,219 @@
---
title: x402
description: >-
在 Injective 上使用 x402。
面向人类用户和 AI 智能体的稳定币支付通道。
updatedAt: "2026-06-01"
---

x402 是一个开放协议，它借助长期未被使用的 `402 Payment Required` HTTP 状态码，将支付嵌入到 HTTP 请求的生命周期中。在支付可在一个区块内结算（约 650 毫秒）的 Injective EVM 上，x402 可以将任意 API 端点变成按请求付费的服务，无需 API key、订阅或注册。

<iframe className="w-1\/2 aspect-video rounded-xl" src="https://youtube.com/embed/vHJ7wPGv_ZM?rel=0&autoplay=1&cc_load_policy=0" title="x402 payment with USDC on Injective (1 min) - YouTube" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen frameborder="0" />

[_x402 payment with USDC on Injective (1 min) - YouTube_](https://youtube.com/watch?v=vHJ7wPGv_ZM)

在本教程中，你将：

- 理解 x402 如何将支付集成到 HTTP 协议中
- 使用 x402 演示应用获取一份门槛为 0.01 USDC x402 支付的市场数据
- 从你的 EVM 钱包手动签署并在链上结算一笔 USDC 支付
- 了解 x402 为何天然契合自主 AI 智能体
- 使用 `@injectivelabs/x402` 库为你自己的 Express API 端点添加支付保护

## 前置条件

| 工具 | 最低版本 | 版本检查 | 安装 |
|---|---|---|---|
| 浏览器 | 任意现代浏览器 | - | - |
| EVM 钱包浏览器扩展 | - | - | [MetaMask](https://metamask.io) 或 [Rabby](https://rabby.io) |
| Node.js | 18 | `node -v` | [nodejs.org](https://nodejs.org) |

你还需要：

- 将你的 EVM 钱包连接到 Injective 网络（主网或测试网）
- 钱包中持有 INJ 代币用于支付 gas 费
- 钱包中持有少量 USDC（几美分就足以完成支付）

## 开始使用

在浏览器中打开 x402 演示页面：[`agents.injective.com/x402`](https://agents.injective.com/x402)。

![x402 demo start](/img/x402-demo-start.png)

在继续下一节之前，请确保你的 EVM 钱包扩展已连接到 Injective 网络。

## 什么是 x402？

x402 将支付嵌入到 HTTP 协议中，
服务器在返回数据之前，会作为 API 响应流程的一部分要求并收取支付。

### 一次 x402 交互中会发生什么？

当客户端调用一个受 x402 保护的 HTTP 端点时，交互过程如下：

1. 客户端向该 API 端点发送一次正常的 HTTP 请求。
2. 服务器返回 `402 Payment Required` 和一份价格报价。
3. 客户端*签署*一笔 USDC 转账交易，但该交易尚未被广播到网络。
4. 一个 x402 *facilitator*（结算方）将已签名的支付提交到区块链并等待确认。
5. 客户端重试原始请求，这次带上已完成支付的详细信息。
6. 服务器通过 facilitator 验证收据，并返回所请求的数据。

![x402 interaction steps](/img/x402-demo-interaction-steps.png)

### x402 免去了哪些步骤？

无需预先注册、API key 管理、订阅或信用卡。
这意味着服务器可以在一次 HTTP 会话中完成报价、验证支付并交付数据。

facilitator 处理所有区块链交互，让你的 API 服务器保持 web 原生形态：

| Facilitator 的职责 | 它帮你屏蔽了什么 |
|---|---|
| 验证支付签名 | 服务器上的加密验证代码 |
| 将交易提交到链上 | RPC 端点管理 |
| Gas 估算与费用 | Gas 计算逻辑 |
| 等待链上确认 | 区块轮询：你只收到一个 yes/no |

### x402 只适用于以太坊吗？

x402 与网络无关：
该开放标准同时支持 EVM 兼容网络、SVM 兼容网络等。
本教程演示如何在 *Injective* 上使用 x402。

### 为什么在 Injective 上使用 x402？

Injective 具有非常高的吞吐量和极低的延迟：
出块时间约为 650 毫秒，
并具备确定性的单区块最终性。
这意味着 x402 支付可以以接近信用卡支付的速度完成结算，
而成本却远远低于信用卡。
这解锁了新的应用场景，包括按次付费和小额支付。
由于 x402 交易也是完全程序化的，
它们非常适合 AI 智能体使用。

## 手动 x402 支付

按以下步骤触发手动 x402 支付流程，
以便观察钱包签名的过程：

（1）在演示页面点击 "Pay it yourself"。

![select pay it yourself](/img/x402-demo-method-selector.png)

（2）在市场选择器中，选择你喜欢的任意一个市场。
（本例中选择 "TSLA/USDC PERP" 市场。）

![select market](/img/x402-demo-market-selector.png)

（3）点击 "Pay 1 cent" 发起 x402 支付。

![make payment](/img/x402-demo-make-payment.png)

（4）当钱包弹出提示时，检查 USDC 转账详情，然后点击 "Sign" 授权支付。

![sign message](/img/x402-demo-sign-message.png)

演示页面将显示 "Success!"，并展示所选的价格。
（本例中显示 "TSLA/USDC PERP" 的价格。）

![completed successfully](/img/x402-demo-completed-successfully.png)

这表明支付已在 Injective EVM 上完成结算，
并且服务器已交付受保护的数据。

## x402 如何实现智能体支付？

x402 让 API 变得可被程序化支付。
当调用方是 AI 智能体而非人类时，
这一特性变得至关重要。

传统的计费模型
（API key、OAuth 流程、按月订阅）
需要人类来设置和维护凭据。
当 AI 智能体自主运行或跨大量用户扩展时，预先注册的凭据会成为瓶颈和安全隐患：
密钥会过期，配额被共享，每接入一个新服务都需要人为参与。

x402 消除了这一瓶颈。
持有 USDC 余额的智能体可以在无需预先注册的情况下调用任何受 x402 保护的端点。
API 报价，智能体签署支付，数据以程序化的方式返回。
这一过程按每次请求执行，链上收据构成不可篡改的审计记录。
个别 API 调用中不需要人类介入。

在 Injective 上，x402 提供了这样的支付原语：
让智能体在运行时获取市场数据、触发交易并调用各类服务。
无需人类提前进行任何设置或操作。

<Info>
x402 标准是开源且与网络无关的。
它由 Coinbase 发起，并对所有网络开放实现。
完整规范请参阅 [x402 协议文档](https://docs.x402.org/introduction)。
</Info>

## 使用 x402 保护你自己的 API 端点

![npm install](/img/x402-demo-npm-install.png)

创建一个带有 x402 保护端点的 Node.js 服务器：

1. 进入你的项目目录（或使用 `npm init -y` 新建一个）。
2. 在终端运行 `npm install @injectivelabs/x402` 安装 x402 库。
3. 创建 `server.js` 并从 `@injectivelabs/x402/middleware` 导入 `express` 和 `injectivePaymentMiddleware`。
4. 在中间件栈中调用 `injectivePaymentMiddleware`，指定要保护的端点、支付网络、USDC 资产地址，以及以最小单位表示的金额。

<Info>
一个最小示例：

```js server.js
import express from 'express';
import { injectivePaymentMiddleware } from '@injectivelabs/x402/middleware';

const app = express();

app.use(
injectivePaymentMiddleware(
{
'GET /perps': {
accepts: [{
// Injective EVM (chain ID 1776)
network: 'eip155:1776',
// USDC on Injective EVM
asset: '0xa00C59fF5a080D2b954d0c75e46E22a0c371235a',
// $0.01 (USDC uses 6 decimal places)
amount: '10000',
}],
},
},
{ facilitatorUrl: process.env.X402_FACILITATOR_URL }
)
);

app.get('/perps', (_req, res) => res.json({ data: "... your data here ..." }));

```

使用了 npm 上的 [`@injectivelabs/x402`](https://www.npmjs.com/package/@injectivelabs/x402)。
</Info>

任何在请求头中携带有效 USDC 支付收据的 HTTP 客户端
（包括 AI 智能体）都能获得响应。
你无需在服务器上实现 API key，甚至无需实现用户账号系统。

## 后续步骤

恭喜！
你已使用 x402 协议在 Injective EVM 上完成了一次 API 请求付费，
并了解了如何通过一次中间件调用来保护你自己的端点。

以下是你所学到的内容：

- x402 如何使用 HTTP `402 Payment Required` 状态码为 API 响应加上支付门槛
- facilitator 如何将 RPC、gas 与签名验证从你的服务器中抽离
- 如何借助演示应用和 EVM 钱包触发并签署 x402 USDC 支付
- 为什么 x402 天然契合以编程方式调用 API 的 AI 智能体
- 如何为 Express 服务器添加 `injectivePaymentMiddleware`

延伸阅读：

- [x402 协议规范](https://x402.org)：本库所实现的开放标准
- [Injective 上的 AI 开发者](/developers-ai)：在 Injective 上构建 AI 原生应用的工具与技能
- [Injective EVM 文档](/evm)：Injective 上的 EVM 开发
Loading