# @gmsol-labs/gmsol-sdk 中文文档

规范地址：https://npmcn.com/package/%40gmsol-labs/gmsol-sdk/

版本：0\.11\.0
npm 元数据更新时间：2026-11-09T13:43:17.567Z
中文译文更新时间：2026-11-16T17:34:37.879Z
软件包许可：SEE LICENSE IN LICENSE

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gmsol-labs/gmsol-sdk
原文对照：https://npmcn.com/package/%40gmsol-labs/gmsol-sdk/?lang=original
项目主页：https://github.com/gmsol-labs/gmx-solana#readme
源码仓库：https://github.com/gmsol-labs/gmx-solana

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.4 MB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-03-26T12:51:15.005Z
- 最新版本发布：2026-11-09T13:43:17.352Z
- 近 30 天下载量：3143（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：52（近 12 个月 13 个）

## 中文简介

GMX-Solana是GMX在索拉纳区块链上的延伸.

## 安装

```sh
npm install @gmsol-labs/gmsol-sdk
```

也可以使用：`pnpm add @gmsol-labs/gmsol-sdk`、`yarn add @gmsol-labs/gmsol-sdk`、`bun add @gmsol-labs/gmsol-sdk`

## README

# GMX-索拉纳

[![Crates.io](https://img.shields.io/crates/v/gmsol-sdk.svg)](https://crates.io/crates/gmsol-sdk) [![Docs.rs](https://docs.rs/gmsol-sdk/badge.svg)](https://docs.rs/gmsol-sdk) [![npm](https://img.shields.io/npm/v/@gmsol-labs/gmsol-sdk.svg)](https://www.npmjs.com/package/@gmsol-labs/gmsol-sdk) [![Build Status](https://img.shields.io/github/actions/workflow/status/gmsol-labs/gmx-solana/ci-sdk.yml?label=CI)](https://github.com/gmsol-labs/gmx-solana/actions?query=branch%3Amain)

[实例](https://github.com/gmsol-labs/gmx-solana/tree/main/examples)

## 审计

| 程序 | 上次审计日期 | 版本 |
| --- | --- | --- |
| [gmsol 存储](https://github.com/gmsol-labs/gmx-solana/tree/main/programs/store) | [2026-10-09 (英语)](https://github.com/gmsol-labs/gmx-solana-audits/blob/main/GMX_Solana_Audit_Report_October_9_2026_Zenith.pdf) | [8af1e70 (韩语)](https://github.com/gmsol-labs/gmx-solana/tree/8af1e70c0c0b6ff9d6b41ba4997910588fbcec28) |
| [gmsol - 仓库](https://github.com/gmsol-labs/gmx-solana/tree/main/programs/treasury) | [2026-10-09 (英语)](https://github.com/gmsol-labs/gmx-solana-audits/blob/main/GMX_Solana_Audit_Report_October_9_2026_Zenith.pdf) | [8af1e70 (韩语)](https://github.com/gmsol-labs/gmx-solana/tree/8af1e70c0c0b6ff9d6b41ba4997910588fbcec28) |
| [gmsol- 时锁](https://github.com/gmsol-labs/gmx-solana/tree/main/programs/timelock) | [2026-10-09 (英语)](https://github.com/gmsol-labs/gmx-solana-audits/blob/main/GMX_Solana_Audit_Report_October_9_2026_Zenith.pdf) | [8af1e70 (韩语)](https://github.com/gmsol-labs/gmx-solana/tree/8af1e70c0c0b6ff9d6b41ba4997910588fbcec28) |
| [gmsol - 竞争](https://github.com/gmsol-labs/gmx-solana/tree/main/programs/competition) | [2026-10-09 (英语)](https://github.com/gmsol-labs/gmx-solana-audits/blob/main/GMX_Solana_Audit_Report_October_9_2026_Zenith.pdf) | [8af1e70 (韩语)](https://github.com/gmsol-labs/gmx-solana/tree/8af1e70c0c0b6ff9d6b41ba4997910588fbcec28) |
| [gmsol - 流动性提供者](https://github.com/gmsol-labs/gmx-solana/tree/main/programs/liquidity-provider) | [2026-10-09 (英语)](https://github.com/gmsol-labs/gmx-solana-audits/blob/main/GMX_Solana_Audit_Report_October_9_2026_Zenith.pdf) | [8af1e70 (韩语)](https://github.com/gmsol-labs/gmx-solana/tree/8af1e70c0c0b6ff9d6b41ba4997910588fbcec28) |

## 一体化

### 方法1:使用Rust SDK

在您的 `Cargo.toml`数字 :

```toml
[dependencies]
gmsol-sdk = { version = "0.10", features = ["client"] }
```

创建一个 `Client` 并开始使用核心 API:

```rust
use gmsol_sdk::{
    Client,
    ops::ExchangeOps,
    solana_utils::{
        cluster::Cluster,
        solana_sdk::{pubkey::Pubkey, signature::read_keypair_file},
    },
};

let keypair =
    read_keypair_file(std::env::var("KEYPAIR")?)?;
let market_token: Pubkey = std::env::var("MARKET_TOKEN")?.parse()?;

let client = Client::new(Cluster::Mainnet, &keypair)?;
let store = client.find_store_address("");

let (txn, order) = client
    .market_increase(
        &store,
        &market_token,
        true,
        5_000_000,
        true,
        500_000_000_000_000_000_000,
    )
    .build_with_address()
    .await?;

let signature = txn.send().await?;
```

### 方法2:使用 `declare_program!`

#### 1\. 启动一个新的Rust项目并增加依赖性

创建一个新的 Rust 项目并包含 `anchor_lang` 财务报告和审定财务报表 `bytemuck` 作为依赖关系:

```toml
[dependencies]
anchor-lang = "0.31.1"
bytemuck = { version = "1.19.0", features = ["min_const_generics", "derive"] }
```

#### 2\. 将IDL下载和存储于 `{PROJECT_ROOT}/idls/`

您可以使用 `anchor` CLI或直接从探险家下载([`gmsol-store` 程序](https://explorer.solana.com/address/Gmso1uvJnLbawvw7yezdfCDcPydwW2s2iqG3w6MDucLo/anchor-program) 财务报告和审定财务报表 [`gmsol-treasury` 程序](https://explorer.solana.com/address/GTuvYD5SxkTq4FLG6JV1FQ5dkczr1AfgDcBHaFsBdtBg/anchor-program)) (中文(简体) ).

下载后,移动到 `{PROJECT_ROOT}/idls/` 目录.

你的项目结构现在应该是这样的:

```bash
{PROJECT_ROOT}/
├── .gitignore
├── Cargo.lock
├── Cargo.toml
├── idls
│   ├── gmsol_store.json
│   └── gmsol_treasury.json
└── src
    └── lib.rs
```

#### 3\. 宣布方案 `lib.rs`

使用 `declare_program!` 登记 `gmsol-store` 财务报告和审定财务报表 `gmsol-treasury` 程序:

```rust
use anchor_lang::declare_program;

declare_program!(gmsol_store);
declare_program!(gmsol_treasury);
```

#### 4\. 建立和打开文档

运行以下命令生成并查看文档 :

```bash
cargo doc --open
```

如果构建成功,它将自动打开您默认的网页浏览器中的文档 .

#### 5\. 实例项目

工作执行,请查看 [gmx- solana- 程序](https://github.com/gmsol-labs/gmx-solana-programs)。 。 。 .

## 已知问题

### 保管人

-   订单保管人可以使用不同时间戳的价格进行互换限制订单,这会导致输出量不同.
    
-   订单保管人要选择不超过实际发生的网络费的执行费. 此外,秩序保管人可以指定的执行费被程序封顶. 即使实际支付的网络费超过这个上限,也不会影响请求的可执行性.
    
-   恶意命令保持者可以通过操纵命令的执行命令来取得一致的利润,但这种风险可以通过部署足够多的高频和可信赖的命令保持者来缓解,因为成功的攻击需要恶意命令保持者确保它所创造的命令不会在有效的价格时间窗口内被执行,这一般是30秒.
    
-   恶意的 " 秩序保管人 " 可能通过关闭其他 " 秩序保管人 " 设立的可索赔账户来提取租金。 然而,由于可索赔的账户通常是在执行命令的同一交易中设立和关闭的,这种情况极为罕见.
    
-   恶意用户可能会故意造成市场失衡,造成高价格影响,从而妨碍命令的执行,这应当代价高昂并难以获益.
    

### 价格影响

-   可以通过使用位置和互换以及跨市场、链条、叉子和其他协议的交易来降低价格影响,通过虚拟库存跟踪,部分减轻了影响.
    
-   一个用户可以通过使用高杠杆位置来降低价格影响,这与MIN COLLATERAL FACTOR FOR OPEN INTEREST MULTIPLIER值部分减轻.
    
-   价格影响值的计算不考虑费用和价格影响本身的影响,在大多数情况下,对价格影响计算的影响应该很小.
    

### 市场托肯价格

-   游泳池的价值很少,但有可能变为负值,因为撞击PoolAmount和待取的PnL被从游泳池中的符值中减去后,这种情况就可能发生.
    
-   由于正负位置价格影响不同,在位置影响池中可能出现虚拟象征性金额的积累,会影响市场标志物的定价,必要时应逐步分配位置影响池.
    

### 虚拟库存

-   虚拟盘点(以互换方式)跟踪集合中的令牌数量,必须确保每组中的令牌都是同一类并有同一类的十进制,即组合中的长式令牌应该有同一类的十进制,组合中的短式令牌应该有同一类的十进制,假设UDC有6个十进制,WBTC有8个十进制,如WSOL-USDC,WSOL-WBTC等市场不应该分组.

### 高尔夫

-   在利用率通常很低的市场中,可以通过暂时增加利用率来利用GLV转变的特点。 一旦守护者执行转向,攻击者可以将利用率回落到正常水平. 定位费和价格影响的设计应使这次攻击的费用足以弥补GLV的损失.
    
-   在GLV中可能有一些GM市场高于其最大pnl to pool factor for traders. 如果这个 GM 市场的最大值 pnl for depositers 高于最大值 pnl for depositers, 那么在存款期间, GM 市场的价值将低于交易商实现上限利润后的价值。 恶意用户可以观察到这种条件下的GM市场,并存入含有GLV的GLV,以便从不久之后的ADLs中获利. 要避免此最大值 pnl factor for depositers ,请小于或等于最大值 pnl factor for traders.
    
-   从技术上讲,市场价值有可能变为负值. 在这种情况下,GLV在市场价值变为正值之前是无法使用的.
    
-   由于高百分率系数或高保留使用率,GM标志可能变得不流动。 用户可以将液态GM符号存入GLV,从不同的市场取出流动性,使GLV留下液态符号. glv max market token value and glv max market token mount 参数应该考虑到市场的风险性,以避免来自有风险市场的GM符号过多.
    

## 发展

### 先决条件

-   [锈](https://www.rust-lang.org/tools/install)
-   [索拉纳 v 2.1.2.1](https://docs.anza.xyz/cli/install)
-   [锁定 v0.31.1](https://www.anchor-lang.com/docs/installation)
-   [节点](https://nodejs.org/en/download)
-   [刚刚](https://github.com/casey/just?tab=readme-ov-file#installation)

### 图标

进行所有测试:

```bash
just
```

用来使用 `gmsol` 开发模式中的 CLI :

```bash
just cli
```

安装 `gmsol` CLI: 爱丽丝

```bash
just install-cli
```

使用以下命令来验证CLI被正确安装:

```bash
gmsol -V
```

### 解决问题

#### 1\. 启动失败 `test-validator` 关于 MacOS 的

**错误消息 :**

```bash
Error: failed to start validator: Failed to create ledger at test-ledger: io error: Error checking to unpack genesis archive: Archive error: extra entry found: "._genesis.bin" Regular
```

**可能的解决方案 :**

检查 [本评论](https://github.com/solana-labs/solana/issues/35629#issuecomment-2501133871)。 。 。 .

## 常见问题

### @gmsol-labs/gmsol-sdk 是什么？

GMX-Solana是GMX在索拉纳区块链上的延伸\.

### 如何安装 @gmsol-labs/gmsol-sdk？

在项目目录运行 npm install @gmsol-labs/gmsol-sdk，或使用 pnpm add / yarn add / bun add。

### @gmsol-labs/gmsol-sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @gmsol-labs/gmsol-sdk 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @gmsol-labs/gmsol-sdk 可以商用吗？

@gmsol-labs/gmsol-sdk 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @gmsol-labs/gmsol-sdk 的下载量有多少？

根据 npm 官方下载统计，@gmsol-labs/gmsol-sdk 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,143 次，日均约 105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gmsol-labs/gmsol-sdk 还在维护吗？

最新版本 0\.11\.0 发布于 2026/11/09（7 天前）；至今共发布 52 个版本，其中过去 12 个月发布了 13 个；首次发布于 2025/03/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

