# @gala-chain/launchpad-sdk 中文文档

规范地址：https://npmcn.com/package/%40gala-chain/launchpad-sdk/

版本：10\.0\.0
npm 元数据更新时间：2026-11-09T17:42:10.110Z
中文译文更新时间：2026-11-15T21:16:31.650Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gala-chain/launchpad-sdk
原文对照：https://npmcn.com/package/%40gala-chain/launchpad-sdk/?lang=original
项目主页：https://gitlab.com/gala-games/defi/launchpad/sdk#readme
源码仓库：https://gitlab.com/gala-games/defi/launchpad/sdk

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

- 包体积（解压后）：7 MB，479 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：7 个
- peer 依赖：zod ^4\.3\.6，axios ^1\.20\.0，ethers ^6\.16\.0，bignumber\.js ^11\.1\.5，@gala-chain/api ^3\.3\.0，socket\.io-client ^4\.8\.3，@gala-chain/gala-core-sdk \>=1\.2\.0 \<2
- 首次发布：2025-09-24T21:40:57.754Z
- 最新版本发布：2026-11-09T17:39:42.149Z
- 近 30 天下载量：6002（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：290（近 12 个月 171 个）

## 中文简介

Gala Launchpad 后端的 TypeScript SDK : 启动板 令牌, 池, 连接曲线交易和引文, 令牌创建, 持有者, 图表, 用户, API 密钥, 禁止, 节制, 监督者, 旗帜, 反应, 消息, 通知, 流和流聊天, W

## 安装

```sh
npm install @gala-chain/launchpad-sdk
```

也可以使用：`pnpm add @gala-chain/launchpad-sdk`、`yarn add @gala-chain/launchpad-sdk`、`bun add @gala-chain/launchpad-sdk`

## README

# @gala-chain/ 发射板- sdk

SDK标志 `@gala-chain/api` 财务报告和审定财务报表 `ethers`;不取决于 `@gala-chain/connect`。 。 。 .

Gala Launchpad的TypeScript SDK曝光了外观为10.0的API(当前包放出:10.0.0). 它提供读取的API用于发行板数据,打出出出行板的提交和网关后支持的符号交易. DEX是一个单独的SDK, `@gala-chain/gswap-sdk` (此软件包没有DEX客户端,也不依赖它),网关-基因片段(签名人,钱包助手和提供者,反应钩子,和桥接服务)由 `@gala-chain/gala-core-sdk`。见 [(原始内容存档于2012-10-10). md](https://npmcn.com/package/%40gala-chain/launchpad-sdk/MIGRATING-TO-10.0.md) 用于从 9.x 移动,以及 [移动到9.0md](https://npmcn.com/package/%40gala-chain/launchpad-sdk/MIGRATING-TO-9.0.md) 早期的9.0迁移.

10.0 API类服务方法 `sdk.launchpad` (书写和交易), `sdk.tokens` (电话和游泳池读), `sdk.streaming`, (中文(简体) ), `sdk.messages`, (中文(简体) ), `sdk.moderation`, (中文(简体) ), `sdk.admin`,以及 `sdk.account`寿命周期和身份识别方法 继续 `LaunchpadSDK`通用GalaChain桥、包装、平衡、转移、锁和NFT收集操作 可从 `@gala-chain/gala-core-sdk`。 。 。 .

## 安装

```bash
pnpm add @gala-chain/launchpad-sdk @gala-chain/gala-core-sdk @gala-chain/api axios bignumber.js ethers socket.io-client zod
```

这个 `latest` ditt-tag 得到 10. 0. 0 (9. x) 没有外观; 见 [(原始内容存档于2012-10-10). md](https://npmcn.com/package/%40gala-chain/launchpad-sdk/MIGRATING-TO-10.0.md)) (中文(简体) ). 将准确的版本固定在应用程序构建中 .

`@gala-chain/gala-core-sdk` 而其他的都是对等依赖性:在此软件包旁边安装它们。 桥接或包裹符的应用程序安装了桥接自己的同平方(`ethers`, (中文(简体) ), `@solana/web3.js`, (中文(简体) ), `@solana/spl-token`将桥舱交给SDK: `new LaunchpadSDK({ ..., bridge: () => import('@gala-chain/gala-core-sdk/bridge') })` (装入一桥或包裹取出). 这个软件包从不装入模块或索拉纳本身,所以一个没有桥接捆绑和安装的应用程序也不装入;如果没有装入器,桥接和包装方法就投出一个 `ConfigurationError` 名称 `bridge` 选项.

对于DEX,安装 `@gala-chain/gswap-sdk` 此软件包旁边的 2. 0 : `pnpm add @gala-chain/gswap-sdk`。 。 。 .

## 配置

```ts
import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';

const sdk = createLaunchpadSDK({ env: 'stage' });

const pools = await sdk.tokens.fetchPools({ pageSize: 10 });
console.log(pools);
```

`Environment` 实值 `'prod' | 'stage'`SDK 默认为 `prod`;它不从习惯推断环境 `baseUrl`启用 `gatewayBaseUrl` 为链网关覆盖.

## 启动盘写入

发售板的买卖,并提交到捆绑商. 结果暴露了 `bundleId`, (中文(简体) ), `uniqueKey`,以及 `wait()`数字 :

```ts
const submission = await sdk.launchpad.buyWithNative({
  vaultAddress: 'client|example-token',
  quantity: '1',
  expectedAmount: '1',
});

const result = await submission.wait();
console.log(submission.bundleId, result);
```

SDK 每个字都写着 `dtoOperation` 其呼吁`asset-channel_basic-asset_Launchpad:BuyWithNative` (例如上文)。 连锁拒绝签字的DTO 没有它,或用另一个呼叫,它是 一部分是签字的,所以是在签字前设定的,之后没有任何东西可以添加. 你一无所有 自己; 一个DTO,你签 在自己的需要 Gala -core -sdk's `withDtoOperation`。 。 。 .

## Token 写着

转接、烧伤、锁和解锁直接通向GalaChain网关(签名后由 `@gala-chain/gala-core-sdk`是因为 `GatewayWrites`)并报告链式交易编号并阻断 网关 `x-transaction-id` 财务报告和审定财务报表 `x-block-number` 头. 它们被制作成SDK的钱包,或者,为了 SDK 配置为 `{ signer, walletAddress }`,作为该身份(a) `eth|` 账户或a `client|` 别名 :

```ts
const { transactionId, blockNumber } = await sdk.tokens.transferToken({
  to: 'eth|9876543210987654321098765432109876543210',
  tokenId: 'GALA|Unit|none|none', // or tokenName: 'anime' for a launchpad token
  amount: '1', // whole tokens, sent as written
});

const locked = await sdk.tokens.lockTokens({ tokens: [{ tokenName: 'anime', amount: '100' }] });
console.log(locked.transactionId, locked.blockNumber);
```

发送到一个 `client|` 接收者,或者在没有发射板SDK的情况下写入,使用 `GatewayWrites` 从 `@gala-chain/gala-core-sdk` 直接说.

从不将私钥放入源控制. 对于可写入的 SDK,通过所支持的钱包配置提供一个符号.

## GSwap DEX 软件

DEX 调用 `@gala-chain/gswap-sdk`是因为 `GSwap` 客户端。 一个交易两者的应用 同一密钥的客户端( e)`sdk.dex` 不见了,同样 `fetchAllDexSeasons`, (中文(简体) ), `fetchCurrentDexSeason`, (中文(简体) ), `fetchDexLeaderboardBySeasonId`, (中文(简体) ), `fetchCurrentDexLeaderboard`, (中文(简体) ), `fetchDexAggregatedVolumeSummary` 财务报告和审定财务报表 `onDexPoolCreation`它们是 `gSwap.leaderboard.*`, (中文(简体) ), `gSwap.market.getVolumeSummary()` 财务报告和审定财务报表 `gSwap.pools.watchNewPools()`:

```ts
import BigNumber from 'bignumber.js';
import { PrivateKeySigner } from '@gala-chain/gala-core-sdk';
import { GSwap } from '@gala-chain/gswap-sdk';

const gSwap = new GSwap({
  env: 'stage',
  signer: new PrivateKeySigner(process.env.PRIVATE_KEY!),
  walletAddress: sdk.getAddress(), // the launchpad SDK built with the same key
});

const quote = await gSwap.quoting.quoteExactInput(
  'GALA|Unit|none|none',
  'GUSDC|Unit|none|none',
  '100',
);

const swap = await gSwap.swaps.swap(
  'GALA|Unit|none|none',
  'GUSDC|Unit|none|none',
  quote.feeTier,
  // The least you accept: a swap is applied seconds after the quote, so a bound equal to the quote
  // is rejected whenever the price moves in between.
  { exactIn: '100', amountOutMinimum: new BigNumber(quote.amountOut).multipliedBy('0.99').toFixed() },
);
// The swap is queued (swap.mode === 'queued'); confirm() resolves the applied trade
// or throws the chain's rejection.
const applied = await swap.confirm();
console.log(applied.transactionId, applied.result);
```

使用 `gSwap.pools`, (中文(简体) ), `gSwap.positions`, (中文(简体) ), `gSwap.symbols`, (中文(简体) ), `gSwap.assets`, (中文(简体) ), `gSwap.market` 财务报告和审定财务报表 `gSwap.leaderboard` 用于发现池子、流动性、标识符、用户资产、价格和数量以及交易竞争。 DEX读取没有签名;状态变化的DEX呼叫需要客户端的签名器. 可运行的 DEX 演示和引导 `packages/gswap-sdk/examples/demos`。 。 。 .

## 价格

`sdk.tokens.fetchTokenPrice({ tokenName })` 定价一个出纸符(连接曲线,或交换后端在毕业后). 这需要 `tokenName` 仅限: `fetchGalaPrice`, (中文(简体) ), `fetchTokenPrice({ tokenId })`, (中文(简体) ), `fetchPriceHistory` 财务报告和审定财务报表 `fetchAllPriceHistory` 不见了 按类键排列的任何令牌的价格和价格系列是gswap-sdk的 `gSwap.market.getPrice(tokenId)` 财务报告和审定财务报表 `gSwap.market.getPriceSeries(key, timeframe)`· ; `sdk.tokens.resolveTokenClassKey(name)` 给一个发射板的钥匙。 同名的MCP工具仍然有效.

## 主机

`env: 'stage'` 选择用于发射板读取和DEX读取的Gala后端 `gateway-testnet.galachain.com` 用于网关操作。 生产主机值由 `env: 'prod'`· ; `baseUrl` 覆盖发射板主机 .

## 进一步阅读

-   [移动到 9. 0](https://npmcn.com/package/%40gala-chain/launchpad-sdk/MIGRATING-TO-9.0.md)
-   更改日志 : `CHANGELOG.md` 在软件包根中
-   [API 参考](https://npmcn.com/package/%40gala-chain/launchpad-sdk/docs/API-REFERENCE.md)
-   [实例](https://npmcn.com/package/%40gala-chain/launchpad-sdk/EXAMPLES.md)
-   [s- sdk](https://npmcn.com/package/%40gala-chain/gswap-sdk/README.md): DEX SDK, 有自己的可运行演示

## 常见问题

### @gala-chain/launchpad-sdk 是什么？

Gala Launchpad 后端的 TypeScript SDK : 启动板 令牌, 池, 连接曲线交易和引文, 令牌创建, 持有者, 图表, 用户, API 密钥, 禁止, 节制, 监督者, 旗帜, 反应, 消息, 通知, 流和流聊天, W

### 如何安装 @gala-chain/launchpad-sdk？

在项目目录运行 npm install @gala-chain/launchpad-sdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.3\.6）、axios（^1\.20\.0）、ethers（^6\.16\.0）、bignumber\.js（^11\.1\.5）、@gala-chain/api（^3\.3\.0）、socket\.io-client（^4\.8\.3）、@gala-chain/gala-core-sdk（\>=1\.2\.0 \<2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gala-chain/launchpad-sdk 支持 TypeScript 吗？

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

### @gala-chain/launchpad-sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gala-chain/launchpad-sdk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gala-chain/launchpad-sdk 可以商用吗？

@gala-chain/launchpad-sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gala-chain/launchpad-sdk 的下载量有多少？

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

### @gala-chain/launchpad-sdk 还在维护吗？

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