@gala-chain/launchpad-sdk

中文文档
10.0.0发布于 2026/11/10MITTypeScriptESM + CJS近 30 天下载 6002

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

中文使用文档
文档目录8 节
  1. 安装
  2. 配置
  3. 启动盘写入
  4. Token 写着
  5. GSwap DEX 软件
  6. 价格
  7. 主机
  8. 进一步阅读

@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 用于从 9.x 移动,以及 移动到9.0md 早期的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。 。 。 .

安装

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) (中文(简体) ). 将准确的版本固定在应用程序构建中 .

@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。 。 。 .

配置

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()数字 :

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| 别名 :

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():

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 覆盖发射板主机 .

进一步阅读

版本与发布记录

@gala-chain/launchpad-sdk 共发布 290 个版本,首次发布于 2025/09/25;过去 12 个月发布了 171 个版本。

版本发布日期距今
10.0.0latest2026/11/106 天前
10.0.0-beta.82026/11/078 天前
10.0.0-beta.72026/11/078 天前
10.0.0-beta.62026/11/078 天前
10.0.0-beta.52026/11/078 天前
10.0.0-beta.42026/11/069 天前

其他发布通道:beta → 8.1.0。

关于 @gala-chain/launchpad-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 和提交记录判断。