SDK 安装

部署绑定包与整合兼容包已在 npm 发布 0.1.1，对应 2026 年 10 月 28 日的正式 MVR 主网发布。产品 SDK 仍为 0.1.0，可与更新后的绑定一起使用。

可使用导出的部署对象，或通过 MVR 解析已审查的包版本，无需在应用代码中复制包 ID。地址参考列出包与共享对象的身份。

安装

新接入项目请安装所需产品 SDK 及部署绑定：

npm install @interest-protocol/blast-presale-sdk@0.1.0 @interest-protocol/blast-launchpad-sdk@0.1.0 @interest-protocol/blast-migrators-sdk@0.1.0 @interest-protocol/blast-deployments-sdk@0.1.1 @mysten/sui@2.26.2 @mysten/move-bytecode-template@0.4.1

可以省略不使用的产品 SDK。部署包 0.1.1 与产品 SDK 0.1.0 配合使用；此次绑定更新不要求产品包升级版本。以上 Sui 和 Move 字节码模板版本是本次发布验证过的 peer 依赖版本。Node.js 接入请使用 22.18 或更新版本。链上 SDK 也支持具备 ES2023、BigInt 和 TextEncoder 的浏览器及其他运行环境。

现有项目也可使用兼容的整合包：

npm install @interest-protocol/blast-sdk@0.1.1 @mysten/sui@2.26.2 @mysten/move-bytecode-template@0.4.1

它保留根导入及 @interest-protocol/blast-sdk/presale、/launchpad、/migrators、/deployments 等子路径。独立包与兼容导入使用相同实现。

使用正式绑定

部署导出包含各产品的包、共享对象及匹配的依赖。迁移器部署也包含其发射平台配置：

import { PresaleCalls } from "@interest-protocol/blast-presale-sdk";
import { LaunchpadCalls } from "@interest-protocol/blast-launchpad-sdk";
import { MigratorCalls } from "@interest-protocol/blast-migrators-sdk";
import {
  MAINNET_PRESALE_DEPLOYMENT,
  MAINNET_LAUNCHPAD_DEPLOYMENT,
  MAINNET_MIGRATORS_DEPLOYMENT,
} from "@interest-protocol/blast-deployments-sdk";

const presale = new PresaleCalls(MAINNET_PRESALE_DEPLOYMENT);
const launchpad = new LaunchpadCalls(MAINNET_LAUNCHPAD_DEPLOYMENT);
const migrators = new MigratorCalls(MAINNET_MIGRATORS_DEPLOYMENT);

这些构造函数不提交交易。还可使用导出的 MAINNET_ADMIN_DEPLOYMENT 与 MAINNET_PARTNERS_DEPLOYMENT。整合包用户可从 @interest-protocol/blast-sdk/deployments 导入相同绑定。

通过 MVR 解析

使用主网 Sui 客户端，在构建调用前解析已审查的包：

import { SuiGrpcClient } from "@mysten/sui/grpc";
import { PresaleCalls } from "@interest-protocol/blast-presale-sdk";
import { LaunchpadCalls } from "@interest-protocol/blast-launchpad-sdk";
import { MigratorCalls } from "@interest-protocol/blast-migrators-sdk";
import { resolveMainnetDeployments } from "@interest-protocol/blast-deployments-sdk";

const client = new SuiGrpcClient({
  network: "mainnet",
  baseUrl: "https://fullnode.mainnet.sui.io:443",
});
const deployments = await resolveMainnetDeployments(client);
const presale = new PresaleCalls(deployments.presale);
const launchpad = new LaunchpadCalls(deployments.launchpad);
const migrators = new MigratorCalls(deployments.migrators);

resolveMainnetDeployments 通过客户端的缓存 MVR API 批量解析五个固定版本名称：@blastpackages/admin/1、@blastpackages/partners/1、@blastpackages/launchpad/1、@blastpackages/migrators/1 和 @blastpackages/presale/1，返回 admin、partners、launchpad、migrators 和 presale 部署对象。

MVR 解析包 ID。共享对象 ID、其 initialSharedVersion、原始类型身份和 timelock 依赖仍固定为 SDK 已审查的发布。非主网客户端、缺失或不匹配的包身份以及解析失败都会报错，不会在失败时回退到静态绑定。

/1 后缀固定原生包版本，解析器不会自动采用未来升级。选择后续包版本前，需要更新为已审查的 SDK 绑定。共享对象的 initialSharedVersion 是首次共享版本，不是最新对象版本或运行代数。

从 0.1.0 绑定升级

将 @interest-protocol/blast-deployments-sdk 或整合包 @interest-protocol/blast-sdk 更新到 0.1.1。接入当前发布时，请移除指向旧合约栈的显式绑定。0.1.1 的 CANONICAL_MAINNET_*、MAINNET_*_DEPLOYMENT 和 getPresaleDeployment("mainnet") 均选择正式 MVR 合约栈。已有预售仍属于创建它的包，应保留与其匹配的历史绑定。

选择包

@interest-protocol/blast-deployments-sdk 和 @interest-protocol/blast-sdk 已发布 0.1.1。 表中其他包仍为 0.1.0。

npm 包	用途
@interest-protocol/blast-presale-sdk	预售调用、读取、预览和事件
@interest-protocol/blast-launchpad-sdk	联合曲线创建、交易、读取和事件
@interest-protocol/blast-migrators-sdk	交易平台迁移、LP 金库和手续费收取
@interest-protocol/blast-deployments-sdk	正式身份、访问检查和交易平台读取器
@interest-protocol/blast-admin-sdk	ACL 读取与管理调用
@interest-protocol/blast-partners-sdk	链上合作伙伴管理和付款预览
@interest-protocol/blast-holder-rewards-sdk	持币奖励记账和操作流程
@interest-protocol/blast-core	共享数学、交易和奖励基础功能
@interest-protocol/blast-coin-sdk	独立创建代币
@interest-protocol/blast-cctp-sdk	EVM USDC 存款参数和 ABI
@interest-protocol/blast-sui-sdk	blastSUI 读取、预览和交易
@interest-protocol/blast-boosts-sdk	Boosts 读取和交易
@interest-protocol/blast-sdk	整合根导入及兼容产品子路径

独立的 @interest-protocol/blast-partner-client 是需认证的 REST 只读客户端，不是链上合作伙伴 SDK，见合作伙伴 API 指南。npm 包已发布不代表其中每个产品或路径都已部署并开放使用。

发布范围

已发布的 0.1.1 绑定构建自 SDK 源码 ff2b5c7。当前合约源码为 52effbc。

已发布 SDK 的 BLAST_DEPLOYMENTS 仍为空；在登记验证过的生产部署前，evaluateProtocolAccess 会拒绝生产签名。静态绑定和成功的 MVR 解析用于标识调用，仍需在链上核对财库设置、支付币种与适配器准入及交易平台可用性。合约包已发布不代表产品已具备上线条件。