@buildonspark/issuer-sdk

中文文档
0.2.2发布于 2026/11/04Apache-2.0TypeScriptESM + CJS近 30 天下载 1.7万

SDK 发行信号

中文使用文档
文档目录10 节
  1. 安装
  2. 快速启动
  3. 初始化发行人钱包
  4. 创建一个托肯
  5. 薄荷图案
  6. 检查发行人托肯余额
  7. 冻结/解冻托肯斯
  8. 烧掉托肯斯
  9. 查询托肯交易
  10. 平台支持

Spark 发行器 SDK

Spark是最快,最便宜,而且最UX友好的方式,在Bitcoin上建立金融应用程序和推出本土资产. 比特币(Bitcoin L2)让开发者以近乎零的成本立即移动比特币和比特币本土资产(包括稳定币),同时保持与比特币基础设施的完全连接.

完整文件,访问 https://docs.spark.money (英语)

安装

npm install @buildonspark/issuer-sdk @buildonspark/spark-sdk
# or
yarn add @buildonspark/issuer-sdk @buildonspark/spark-sdk
# or
pnpm add @buildonspark/issuer-sdk @buildonspark/spark-sdk

快速启动

初始化发行人钱包

import { IssuerSparkWallet } from "@buildonspark/issuer-sdk";

// Create a new issuer wallet (generates a new mnemonic)
const { wallet, mnemonic } = await IssuerSparkWallet.create({
  options: {
    network: "MAINNET", // or "REGTEST" for testing
  },
});

// Or initialize with an existing mnemonic
const wallet = await IssuerSparkWallet.initialize({
  mnemonicOrSeed: "your twelve word mnemonic phrase here ...",
  options: {
    network: "MAINNET",
  },
});

创建一个托肯

const token = await wallet.createToken({
  tokenName: "My Token",
  tokenTicker: "MTK",
  decimals: 8,
  maxSupply: 1000000n,
  isFreezable: true,
});

console.log(`Token created: ${token.tokenIdentifier}`);

薄荷图案

// Mint tokens to your own wallet
const mintResult = await wallet.mintTokens({
  tokenIdentifier: "spark1...",
  tokenAmount: 10000n,
});

// To distribute tokens to others, mint first then transfer
await wallet.mintTokens({
  tokenIdentifier: "spark1...",
  tokenAmount: 5000n,
});

await wallet.transferTokens({
  tokenIdentifier: "spark1...",
  receiverSparkAddress: "sp1q...",
  tokenAmount: 5000n,
});

检查发行人托肯余额

// Get balance for all tokens you've issued
const balances = await wallet.getIssuerTokenBalances();
for (const [tokenId, info] of balances) {
  console.log(`${info.tokenMetadata.tokenName}: ${info.balance}`);
}

冻结/解冻托肯斯

// Freeze tokens at a Spark address (requires isFreezable: true during creation)
await wallet.freezeTokens({
  tokenIdentifier: "spark1...",
  sparkAddress: "sp1q...",
});

// Unfreeze tokens at a Spark address
await wallet.unfreezeTokens({
  tokenIdentifier: "spark1...",
  sparkAddress: "sp1q...",
});

烧掉托肯斯

const burnResult = await wallet.burnTokens({
  tokenIdentifier: "spark1...",
  tokenAmount: 1000n,
});

查询托肯交易

const transactions = await wallet.getTokenTransactions({
  tokenIdentifier: "spark1...",
  limit: 50,
});

for (const tx of transactions) {
  console.log(`TX: ${tx.id}, Amount: ${tx.amount}`);
}

平台支持

SDK支持多个 JavaScript 运行时间 :

  • 浏览器
  • 节点.js
  • 原生反应

版本与发布记录

@buildonspark/issuer-sdk 共发布 166 个版本,首次发布于 2025/02/26;过去 12 个月发布了 58 个版本。

版本发布日期距今
0.2.2latest2026/11/044 天前
0.2.12026/10/1524 天前
0.2.02026/09/301 个月前
0.1.492026/09/221 个月前
0.1.482026/09/121 个月前
0.1.472026/08/282 个月前

其他发布通道:experimental → 0.1.17-experimental.0。

关于 @buildonspark/issuer-sdk 的常见问题

@buildonspark/issuer-sdk 是什么?

SDK 发行信号

如何安装 @buildonspark/issuer-sdk?

在项目目录运行 npm install @buildonspark/issuer-sdk,或使用 pnpm add / yarn add / bun add。

@buildonspark/issuer-sdk 支持 TypeScript 吗?

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

@buildonspark/issuer-sdk 支持 ESM 还是 CommonJS?

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

@buildonspark/issuer-sdk 需要什么版本的 Node.js?

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

@buildonspark/issuer-sdk 可以商用吗?

@buildonspark/issuer-sdk 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@buildonspark/issuer-sdk 的下载量有多少?

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

@buildonspark/issuer-sdk 还在维护吗?

最新版本 0.2.2 发布于 2026/11/04(4 天前);至今共发布 166 个版本,其中过去 12 个月发布了 58 个;首次发布于 2025/02/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。