@flop-labs/sdk

中文文档

0.6.0发布于 2026/11/12MIT OR Apache-2.0TypeScriptESM + CJS近 30 天下载 3449

FLOP 网络的 TypeScript SDK – HTLC 工作流程、 PoUI 证明和账户管理

文档目录20 节

安装
同伴依赖关系
快速启动
API 参考
流线
代理钱包
x402 支付协议
命名的最小会话
会话估计( 计算信道)
反应钩 (可选)
类型
处理错误
完整示例
发展
许可证
NVIDIA GPU 运算符
TEE 引文格式
支持的TEE类型
TEE 验证
链接

@flop-labs/ sdk (英语)

FaucetClient.healthCheck() 报告水龙头的HTTP准备状态为布尔. 它回来了 false hTTP 503 或请求失败,包括活水龙头其调用IP的分类没有被检查. 这不是过程活性或授予资格测试。健康协会不要求资金或对IP进行分类. 明确 requestFaucetFunding() 尝试执行录入并返回 a 拒绝理由和 retryAfterSeconds 当供应。从不自动重复资助 POST 。一个 unknown 结果可以指赠款的发生: 在再次提出要求之前,结果和调和。健康检查不能单独进行阻断明确的供资请求.

未释放水龙头迁移: fundFromFaucet 保留其布尔签名但目前总是返回 false;虚假意味着未经证实,而不是未付. 这个水龙头还没有从独特的请求中暴露出经认证的可持久约束力因此,SDK不能建立特定请求的确认. 使用 fundFromFaucetDetailed 区分拒绝、无法飞行前和未知结果,并保留返回的散列。它被接受的HTTP 答复仍为赠款。快速启动抛出 FaucetUnconfirmedError 与无法确认供资时的结果;对原请求进行核对重试之前。 Faucet启用的QuickStart需要呼叫者拥有的签名人或键盘包因此,未经证实的付款不能被困在无法进入的生成钱包中。对于账户资金是否充足这一单独问题, 使用情况 waitForAvailableBalance;旧的 waitForFaucetFunding 名称已贬值平衡检查别名。没有任何仅以来源为主的测试证实有现场补助.

普通HTLC的创建需要注册的"经济批评评价简介". 供应 tee_requirements 编号 : teeRequirements 作为 {profile: {profile_id, version}, model_hash, measurement_hash} (32字节的六分法),或其犬形100字节的SCALE六分法. 运行时间检查注册的剖面图和不可改变的承诺是否符合其政策;不存在模拟默认. 实例,设定 FLOP_HTLC_TEE_REQUIREMENTS 从你网络的注册档案里找到的.

用于FLOP网络的TypeScript SDK——HTLC工作流程,PoI证明,以及账户管理.

SUPPORTED_SPEC_VERSIONS 准确的承认 1013000, (中文(简体) ), 1014000, (中文(简体) ), 1014001, (中文(简体) ), 1014002, (中文(简体) ), 1014003, (中文(简体) ), 1014004, (中文(简体) ), 1014005, (中文(简体) ), 1014007, (中文(简体) ), 1014008, (中文(简体) ), 1014009, (中文(简体) ), 1014010, (中文(简体) ), 1014011, (中文(简体) ), 1014012, (中文(简体) ), 1014013, (中文(简体) ), 1014014, (中文(简体) ), 1014015, (中文(简体) ), 1014016, (中文(简体) ), 1014017, (中文(简体) ), 1014018, (中文(简体) ), 1014019, (中文(简体) ), 1014020。。。 . SUPPORTED_SPEC_VERSION_RANGE 保留其导出形状为信封 1013000..1014020; 接纳需要确切的成员资格(包括否) 1014006) (中文(简体) ). 发表 0.4.0 可执行文件在 1014011 并排除 1014006· ; 其捆绑的README有Stale连接和HTLC实例. 这些来源更正未释放:安装 @latest 在新版本完成之前不交付发表。以下例子说明了这一来源候选人。资格涵盖运行时间 1013000 时间 44a5fedc88614b9a6e8c97605c2ec943faf47d9d,则书记官长运行时间 1014000 时间 e4f01cc849fa6c768d5c0f9c111dffb450ea4fa9 (PR # 2726) 运行时间 1014001 时间 de4e2779dbf6f8d25348953ce0992ef8e89756bd (PR #2803),运行时间 1014002,#2637devnet 混合验证快速路径,运行时间 1014003 时间 9035450361681a69c6c02c9c53e47351999ef6f8 (PR #3096) (中文(简体) ). 候选人运行时间 1014004 1.14.4, PR #3006 对上传器供资的源兼容性覆盖资格。候选人运行时间 1014005 1.14.5 具有源兼容性覆盖预激活 FCU 名称替换; 这不限制物理延迟或部署. 候选人的规格 1014003 有源兼容性覆盖; 由 sDK没有建立部署或端到端推断资格. 其他版本需要单独限定. 每个 FlopClient 连接路径检查。检测到不支持的运行时间升级由 polkadot.js 元数据事件断开 API 并让随后的 SDK 操作提高 FlopError 有代码 RUNTIME_INCOMPATIBLE,合格版本,并升级指导. 生成的客户端应用相同的精确版本守护;明确的配置限制可以狭义相容并需要一个 spec 名称。升级方式 pnpm add @flop-labs/sdk@latest 释放支持链条的运行时间;允许列表更改需要兼容性验证.

安装

npm install @flop-labs/sdk

同伴依赖关系

反应是可选的( 仅在使用反应钩时需要):

npm install @flop-labs/sdk react  # Optional: for React integration

快速启动

2026年11月3日光谱 1014003,带有空 attest.profiles 登记。下面的HTLC例除非经授权的治理部门登记其确切的经济状况,否则不能在那里运行评估政策、核查器和版本。既不模拟模式,也不任意配置标识提供这个先决条件。使用 assertHtlcAppraisalProfile(api, hex) ; 运行时间独立执行政策和承诺. 3个被输出的幽灵/TOPOC/DA简介参考不是HTLC简介.

对于直接计算渠道购买,准备并坚持原意:

import { FlopClient } from '@flop-labs/sdk';
import { readFile, writeFile } from 'node:fs/promises';

const client = await FlopClient.createWithKeypair('wss://rpc.devnet.flop.network', keypair);
try {
  // Run preparation once, in a private directory. The intent contains a session seed.
  const intent = await client.prepareInferenceSession({ minerUrl, escrowFlop: 0.01, maxTurns: 1 });
  await writeFile('purchase.json', JSON.stringify(intent), { flag: 'wx', mode: 0o600 });
  const saved = JSON.parse(await readFile('purchase.json', 'utf8'));
  const result = await client.buyInferenceSession({ intent: saved, prompt: 'Hello' });
  console.log(result.channelId, result.status);
} finally { await client.disconnect(); }

重新启动时, 读取已有文件并传递此意图; 永远不要运行准备同样的购买。使用文件时持有文件独占权. 或者, buyInferenceSession 接受等待的状态 onPrepared 持久性调用。无意致电或召回签署前停止。这么紧之前的便利API,需要突破更改发布. SDK在提交前读取最终状态. 一个缺失的记录仍然是未确认的结果; 重新提交保留了原频道的非ce和密钥 . 已有频道停止 INFERENCE_PURCHASE_UNCONFIRMED 及其公共身份证. 连 Open 可能是流出出链外转盘:不要用新鲜的计数器重放. 检查和解或收回保留记录;如果未交付频道超过它的 SLA, 在确认后使用无权限的超时路径资格。在追回和结算/退款最后确定之前,保留意图. 重复的外科医生仍可支付费用. settlement_posted 打开挑战窗口,没有确定最后的矿工付款.

import { FlopClient, createAgentWallet } from '@flop-labs/sdk';

// Connect to FLOP node
const client = await FlopClient.create({ endpoint: 'ws://127.0.0.1:9944', signer: '//Alice' });

// Check node health
const health = await client.health();
console.log('Node healthy:', health);

// Create an agent wallet
const wallet = await createAgentWallet(client.api, client.signer, {
  agent: client.address,
  dailyCap: 100n * 10n ** 18n,
  perTxLimit: 5n * 10n ** 18n,
});

// Create HTLC for inference purchase
const htlc = await client.createHtlc({
  agent: 'my-agent',
  task: {
    model: 'llama-3-8b',
    prompt: 'Hello, world!',
    tee_requirements: process.env.FLOP_HTLC_TEE_REQUIREMENTS
  },
  rewardFlop: 5.0,
  timeoutBlocks: 60
});

console.log('HTLC created:', htlc.htlcId);

// Wait for settlement
const status = await client.waitForSettlement(htlc.hashLock);
console.log('Settlement:', status);

API 参考

流线

与 FLOP 网络互动的主要客户端.

连接工厂

await FlopClient.create(options?: FlopClientOptions)

选项 :

endpoint (字符串,可选):RPC端点URL. 默认 : ws://127.0.0.1:9944
signer (字符串,可选):本地签名人URI //Alice 默认只用于可支配本地开发.
createWithKeypair(endpoint, keypair): 使用已解码的键盘连接 .

方法

`health()`

检查节点健康状况.

await client.health();
// Returns: { isSyncing: boolean, peers: number, shouldHavePeers: boolean }

`createHtlc(params)`

创建用于购买原子推论的 Hash 时间锁定合同 .

await client.createHtlc({
  agent: string,
  task: ComputeTask,
  rewardFlop: number,
  timeoutBlocks: number,
  hashLock?: string  // Auto-generated if not provided
});

回返情况:

{
  htlcId: string;
  hashLock: string;
  preImage: string;
  txHash: string;
}

`createCrossChainHtlc(params)`

为 FLOP QQ BTC 原子互换创建跨链 HTLC(双边 HTLC 路径). 这个 FLOP腿必须活出反链腿(时锁对称,在链上强制), 这样 timeoutBlocks 是更长的腿和 btcTimelockHours 时间越短 USDT on (美国) TON/TRON则通过Near Intents定居——见 docs/bridge/settlement.md。。。 .

await client.createCrossChainHtlc({
  agent: string,
  task: ComputeTask,
  rewardFlop: number,
  btcAddress: string,
  btcAmountSats: number | bigint,
  timeoutBlocks?: number,    // FLOP side, default 7200 (~2h)
  btcTimelockHours?: number, // counter-chain side, default 1
  hashLock?: string          // auto-generated if omitted
});

`checkHtlcStatus(hashLock)`

通过散列锁定查询 HTLC 状态 .

await client.checkHtlcStatus('0x...');
// Returns: HtlcInfo | null (RPC fields include reward_amount and timeout_block)

`waitForSettlement(hashLock, timeoutMs?, pollIntervalMs?)`

Poll HTLC直到解决或暂停.

await client.waitForSettlement('0x...', 30_000, 1_000);
// Returns: HtlcInfo with status SETTLED or REFUNDED, or null on polling timeout.
// null does not refund funds; reconcile the original HTLC before retrying.

`getBalance(address?)`

在 FLOP 令牌中获取账户余额 .

await client.getBalance(); // Defaults to the connected account's SS58 address.
// Returns: string (human-readable FLOP, preserving decimal precision)

`submitPoUI(proofs, gnWeight, taskHash)`

提交经TEE验证的PoI证明批次.

await client.submitPoUI(proofs, 1450, '0x...');

`getAccountInfo(address)`

获取账户信息,包括非ce和元数据.

await client.getAccountInfo('flop1qyq...');

`getComputeTask(taskId)`

计算任务细节 .

await client.getComputeTask('task_0x...');

`getTeeQuote(task)`

为计算任务获取 TEE 引用 .

await client.getTeeQuote({ model: 'llama-3-8b', prompt: '...' });

代理钱包

创建和管理带有会话密钥的代理钱包 .

`createAgentWallet(api, signer, options)`

创建新代理钱包 .

import { createAgentWallet } from '@flop-labs/sdk';

const walletTxHash = await createAgentWallet(client.api, client.signer, {
  agent: agentAddress, // Existing agent SS58 account, distinct from the owner.
  dailyCap: 100n * 10n ** 18n,
  perTxLimit: 5n * 10n ** 18n,
});
// Returns the transaction hash, not a wallet object.

`fundAgentWallet(api, signer, agent, amountRaw)`

从所有者账户中为代理钱包提供资金.

import { fundAgentWallet } from '@flop-labs/sdk';

await fundAgentWallet(client.api, client.signer, agentAddress, 50n * 10n ** 18n);

`agentTransfer(client, fromWallet, toAddress, amount)`

在代理钱包之间转移资金.

import { agentTransfer } from '@flop-labs/sdk';

await agentTransfer(client, 'flop1agent1...', 'flop1agent2...', 10.0);

`ownerWithdraw(client, walletAddress, amount)`

从代理钱包提取资金到所有者账户.

import { ownerWithdraw } from '@flop-labs/sdk';

await ownerWithdraw(client, 'flop1agent...', 25.0);

`createSession(client, walletAddress, options)`

创建带有支出限制的会话密钥 .

import { createSession } from '@flop-labs/sdk';

const session = await createSession(client, 'flop1agent...', {
  spendingLimit: 10.0,
  expiresAt: Date.now() + 3600000  // 1 hour
});

`executeViaSession(client, sessionKey, call)`

使用会话密钥执行呼叫 .

import { executeViaSession } from '@flop-labs/sdk';

await executeViaSession(client, sessionKey, {
  pallet: 'htlc',
  method: 'create',
  args: { ... }
});

x402 支付协议

X402 付款头的水电费.

`x402Fetch(url, options, paymentParams)`

用 x402 付款信头获取 .

import { x402Fetch } from '@flop-labs/sdk';

const response = await x402Fetch('https://api.example.com/inference', {
  method: 'POST',
  body: JSON.stringify({ prompt: '...' })
}, {
  amount: 5.0,
  recipient: 'flop1qyq...'
});

`parsePaymentHeaders(headers)`

从响应中解析出 x402 付款信头 .

import { parsePaymentHeaders } from '@flop-labs/sdk';

const payment = parsePaymentHeaders(response.headers);

命名的最小会话

runDirectSession({ api, signer, miner, model, endpoint, prompt, maxFlop, maxTokens }) 在命名的矿工上打开一个频道,验证其身份并签名答复,以及清算或收回代管. maxFlop 是生链单元; maxTokens 是一个正数安全整数和默认值为256个完成符号。请求带有这个限制在受核实的收据约束的聊天信封中。检查 receipts[0].finishReason 财务报告和审定财务报表 completionTokens 用于截取。 60秒轮值期限仍然有效; 更大的象征性预算不会延长。分开解决等待频道在提交付款前最后确定校准津贴。合作执行和最终发现的每个都有一个60秒的窗口过期频道使用暂停恢复。如果结果不明,请保留频道ID并检查完成重试前的频道状态和终端事件; 单独关闭的频道无法证明成功解决。零转出力在确认后即可失效截止时间,且打开的频道在使用寿命后可以超时.

会话估计( 计算信道)

在打开前使用一个计算通道会话大小, 完全脱离链条, 使用链条本身的表 :

computeChannel.estimateSession 转换配置文件为 G_n,最小块,频道计数和代管.
computeChannel.sessionPrior 返回您尚未运行的任务的 P50/P90/P99 配置文件.
computeChannel.calibrateSessionPrior 符合你的模型和代理配置之前大约10个探测器运行.
computeChannel.reforecastSession 更新中跑分数.

见届会估算指南。。。 .

反应钩 (可选)

import { useFlopClient, useWalletBalance, useHtlcStatus } from '@flop-labs/sdk/react';

function MyComponent() {
  const client = useFlopClient('http://127.0.0.1:16111/rpc');
  const { balance } = useWalletBalance(client, 'flop1qyq...');
  const { status } = useHtlcStatus(client, '0x...');
  
  return <div>Balance: {balance} FLOP</div>;
}

类型

interface ComputeTask {
  model: string;
  prompt: string;
  maxTokens?: number;
  temperature?: number;
}

type HtlcInfo = import('@flop-labs/sdk').HtlcInfo;

interface PoUISubmission {
  proofHash: string;
  gnMeasured: number;
  teeQuote: string;
  timestamp: number;
}

interface WalletInfo {
  address: string;
  balance: number;
  dailyLimit: number;
  dailySpent: number;
  allowedPallets: string[];
}

处理错误

import { FlopClient, FlopError } from '@flop-labs/sdk';

let client: FlopClient | undefined;
try {
  client = await FlopClient.create({ endpoint: 'ws://127.0.0.1:9944', signer: '//Alice' });
  console.log(await client.health());
} catch (error: unknown) {
  if (error instanceof FlopError) {
    // Includes RUNTIME_INCOMPATIBLE raised while awaiting the connection factory.
    console.error(error.code, error.message);
  } else if (error instanceof Error) {
    console.error(error.message);
  } else {
    console.error('Unexpected error:', error);
  }
} finally {
  await client?.disconnect();
}

完整示例

这个来源的例子使用公众,众所周知 //Alice 仅在一次性键上本地链条。设定 FLOP_AGENT_ADDRESS 至代理人的SS58账户和 FLOP_HTLC_TEE_REQUIREMENTS 符合已登记考核要求下面使用的模型。使用私有的工作目录。 HTLC 恢复文件只创建于之前交易; 在出错时保留, 并在前核对其原散列锁恢复,而不是重新运行这个一次性设置。永远不要登录其预想.

import { writeFile } from 'node:fs/promises';
import { FlopClient, assertHtlcAppraisalProfile, createAgentWallet, fundAgentWallet } from '@flop-labs/sdk';

async function main() {
  const agentAddress = process.env.FLOP_AGENT_ADDRESS;
  const teeRequirements = process.env.FLOP_HTLC_TEE_REQUIREMENTS;
  if (!agentAddress || !teeRequirements) throw new Error('Set the agent address and registered HTLC appraisal requirements');
  const client = await FlopClient.create({ endpoint: 'ws://127.0.0.1:9944', signer: '//Alice' });
  try {
    await assertHtlcAppraisalProfile(client.api, teeRequirements);
    const { preImage, hashLock } = FlopClient.generateSecrets();
    await writeFile('htlc-purchase.json', JSON.stringify({ preImage, hashLock }) + '\n', { flag: 'wx', mode: 0o600 });

    const FLOP = 10n ** 18n;
    const walletTxHash = await createAgentWallet(client.api, client.signer, {
      agent: agentAddress,
      dailyCap: 100n * FLOP,
      perTxLimit: 5n * FLOP,
    });
    console.log('Wallet creation transaction:', walletTxHash);
    await fundAgentWallet(client.api, client.signer, agentAddress, 50n * FLOP);

    // This direct HTLC uses the owner's balance, separately from the agent wallet.
    const htlc = await client.createHtlc({
      agent: agentAddress,
      task: { model: 'llama-3-8b', prompt: 'Analyze BTC price trend', tee_requirements: teeRequirements },
      rewardFlop: 5.0,
      timeoutBlocks: 60,
      hashLock,
    });
    console.log('HTLC created:', htlc.htlcId);

    const settlement = await client.waitForSettlement(hashLock, 30_000, 1_000);
    if (settlement?.status === 'SETTLED') {
      console.log('Node reports settlement:', settlement.miner, settlement.gn_used);
    } else if (settlement?.status === 'REFUNDED') {
      console.log('Node reports a refund; confirm finality before treating it as complete');
    } else {
      console.log('Unconfirmed: polling timed out without a refund. Keep the original intent and reconcile chain state');
    }
  } finally {
    await client.disconnect();
  }
}

main().catch(console.error);

发展

# Install dependencies
npm install

# Build the SDK
npm run build

# Watch mode
npm run dev

# Clean build artifacts
npm clean

许可证

Apache-2.0 FLOP网络

NVIDIA GPU 运算符

关于经营NVIDIA GPU的矿工获得奖励,请参见完整指南:

在 GPU 主机上运行 FLOP 矿工 - 采矿设置和工作流程
将您的 GPU 操作 FLOP - GPU所有者新密码的普通语言启动

GPU 操作器的快例 :

import { FlopClient, type TeeQuote } from '@flop-labs/sdk';

// Connect as miner
const client = await FlopClient.create({ 
  endpoint: 'ws://127.0.0.1:9944',
  signer: '//Miner'
});

// Monitor for HTLCs
const htlc = await client.checkHtlcStatus(hashLock);
if (htlc && htlc.status === 'CREATED') {
  // Execute inference on NVIDIA GPU
  const result = await executeOnGpu(htlc.task); // Your GPU execution logic
  
  // Generate TEE quote
  const teeQuote: TeeQuote = {
    version: '1.0',
    miner_address: client.address,
    task_reference: {
      htlc_hash_lock: htlc.hashLock,
      model_hash: `sha256:${htlc.task.model}`,
      task_timestamp: Math.floor(Date.now() / 1000),
    },
    compute_output: {
      gn_weight: result.gnWeight,  // G_n weight (BFLOPs)
      execution_time_ms: result.executionTime,
      encrypted_result: result.encryptedOutput,
    },
    attestation: {
      tee_type: 'NVIDIA_HOPPER_CC',  // or 'NVIDIA_RUBIN_CC', 'CPU_WRAPPED_TEE'
      hardware_pubkey: hardwarePubkey,
      quote_hex: teeQuoteHex,
      signature: minerSignature,
    },
  };
  
  // Redeem HTLC with TEE quote
  const txHash = await client.redeemHtlc(
    htlc.htlcId,
    preImage,
    teeQuote,
  );
  console.log('✓ HTLC redeemed:', txHash);
  
  // Submit PoUI proof batch (optional, for additional rewards)
  const proofs = generateStarkProofs(result);
  const taskHash = generateTaskHash(htlc);
  const proofTxHash = await client.submitPoUI(proofs, result.gnWeight, taskHash);
  console.log('✓ PoUI proof submitted:', proofTxHash);
}

TEE 引文格式

interface TeeQuote {
  version: string;           // "1.0"
  miner_address: string;     // flop1... address
  task_reference: {
    htlc_hash_lock: string;  // HTLC identifier
    model_hash: string;      // sha256:model...
    task_timestamp: number;  // Unix timestamp (seconds)
  };
  compute_output: {
    gn_weight: number;       // G_n weight (BFLOPs)
    execution_time_ms: number;
    encrypted_result: string; // 0x... encrypted output
  };
  attestation: {
    tee_type: string;        // "NVIDIA_HOPPER_CC" | "NVIDIA_RUBIN_CC" | "CPU_WRAPPED_TEE"
    hardware_pubkey: string; // 0x... hardware public key
    quote_hex: string;       // 0x... raw TEE quote
    signature: string;       // 0x... miner signature
  };
}

支持的TEE类型

TEE 类型	硬件	生产准备
`NVIDIA_HOPPER_CC`	H100, H200 (韩语)	对
`NVIDIA_RUBIN_CC`	B100, B200 (英语)	对
`CPU_WRAPPED_TEE`	RTX 4090+ + AMD SEV/英特尔 TDX	只有测试网

TEE 验证

TEE桥的引文为:

时间戳新鲜度 : 引用必须 < 60秒
签名核查: 验证矿工签名
重放保护 : 跟踪任务散列,防止双重开支
硬件验证 : 对照登记册检查硬件密钥( 只生产)

import { verifyTeeQuote, type PouiPayload } from '@flop-labs/sdk/tee';

const bridge = new TeeBridge({ simulatorMode: false });

// Register known hardware keys (production)
bridge.registerHardwareKey('0x...');

// Verify TEE quote
const payload: PouiPayload = parseTeeQuote(quoteJson);
const result = await bridge.verify(payload);

if (result.valid) {
  console.log(`✓ TEE verified: ${result.gnWeight} G_n`);
} else {
  console.error(`✗ Verification failed: ${result.error}`);
}

完整的设置指令、硬件要求和生产部署指南:

在 GPU 主机上运行 FLOP 矿工 - 生产设置和工作流程
将您的 GPU 操作 FLOP - GPU所有者的普通语言启动:硬件、账户、存款、访问

链接

版本与发布记录

@flop-labs/sdk 共发布 5 个版本，首次发布于 2026/10/29；过去 12 个月发布了 5 个版本。

版本	发布日期	距今
`0.6.0`latest	2026/11/12	3 天前
`0.5.2`	2026/11/10	5 天前
`0.5.1`	2026/11/09	7 天前
`0.4.0`	2026/10/29	17 天前
`0.0.0-stage`	2026/10/29	17 天前

关于 @flop-labs/sdk 的常见问题

@flop-labs/sdk 是什么？

FLOP 网络的 TypeScript SDK – HTLC 工作流程、 PoUI 证明和账户管理

如何安装 @flop-labs/sdk？

在项目目录运行 npm install @flop-labs/sdk，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 flop-client-gen，可以用 npx flop-client-gen 直接运行。

@flop-labs/sdk 支持 TypeScript 吗？

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

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

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

@flop-labs/sdk 可以商用吗？

@flop-labs/sdk 使用 MIT OR Apache-2.0 许可。可在 MIT、Apache-2.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

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

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

@flop-labs/sdk 还在维护吗？

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

npm install @flop-labs/sdk

pnpmpnpm add @flop-labs/sdk
yarnyarn add @flop-labs/sdk
bunbun add @flop-labs/sdk

peer 依赖react >=18.0.0可选@ton/ton ^16.3.0可选@ton/core ^0.63.1可选@ton/crypto ^3.3.0可选near-api-js *可选@polkadot/hw-ledger *可选@walletconnect/modal *可选@polkadot/extension-dapp *可选@walletconnect/universal-provider *可选

npm 7+ 与 pnpm 8+ 会自动安装必需的 peer 依赖，Yarn 需手动安装。

命令行npx flop-client-gen

在你的项目目录中运行此命令。

近 30 天下载

3,449

约 3449 次日均 115 次

统计周期 2026/10/15 – 2026/11/13
数据来自 npm 官方下载统计，今天更新

最新版本0.6.0发布于 3 天前

开源许可MIT OR Apache-2.0多许可可选

包体积14.8 MB689 个文件 · 解压后

运行依赖10 个另有 9 个 peer 依赖

模块格式ESM + CJS

TypeScript自带类型

发布版本5 个近 12 个月 5 个

首次发布2026/10/2917 天前

元数据更新2026/11/12

每一个软件包背后，
都有分享与创造的人。