组装交易

构建并发送 CKB 交易，无需手工选择输入或计算手续费。只需声明所需的输出，CCC 会自动匹配输入、计算手续费并生成找零——整个过程仅需调用几个 API 即可完成。

完成本指南后你将能够

• 转账 CKB：向任意地址发送指定金额，自动完成输入选择和手续费计算
• 清空钱包：将钱包全部余额归集到单个输出
• 理解每笔 CCC 交易通用的声明 → 填充 → 手续费 → 发送模式

核心概念

CKB 上的每个输出都必须以 Shannon 声明其容量（1 CKB = 10⁸ Shannon）。使用 ccc.fixedPointFrom(amount) 将 CKB 面值转换为内部表示：

ccc.fixedPointFrom(100)    // 100 CKB → 10_000_000_000n Shannon
ccc.fixedPointFrom("0.01") // 0.01 CKB → 1_000_000n Shannon

CKB 转账

适用场景：向另一个地址发送指定数量的 CKB——最常见的交易类型。

以下四个步骤体现了声明 → 填充 → 手续费 → 发送模式，每笔 CKB 交易都遵循这一流程：

import { ccc } from "@ckb-ccc/ccc";

const receiver = await signer.getRecommendedAddress();
const { script: lock } = await ccc.Address.fromString(receiver, signer.client);

const tx = ccc.Transaction.from({
  outputs: [{ capacity: ccc.fixedPointFrom(100), lock }],
});

await tx.completeInputsByCapacity(signer);

await tx.completeFeeBy(signer);

const txHash = await signer.sendTransaction(tx);
console.log("Transaction hash:", txHash); // "0x..." — 32 字节十六进制哈希

转出全部 CKB

适用场景：完全清空钱包——迁移到新地址、归集 Cell 等。无需指定固定容量，而是先收集所有输入，再从输出中扣除手续费：

import { ccc } from "@ckb-ccc/ccc";

const receiver = await signer.getRecommendedAddress();
const { script: lock } = await ccc.Address.fromString(receiver, signer.client);

// 暂不设置容量，待收集所有输入后再填充
const tx = ccc.Transaction.from({
  outputs: [{ lock }],
});

// 收集 signer 持有的所有 Cell 作为输入
await tx.completeInputsAll(signer);

// 从索引 0 的输出中扣除手续费，将剩余 CKB 全部归入该输出
await tx.completeFeeChangeToOutput(signer, 0);

const txHash = await signer.sendTransaction(tx);

手续费计算

CCC 自动从节点获取当前中位手续费率，无需手动设置。completeFeeBy 和 completeFeeChangeToOutput 均已内置处理。

如需精细控制（如优先级交易），可传入以 Shannon/kB 为单位的固定手续费率：

await tx.completeFeeBy(signer, 2000); // 固定费率 2000 Shannon/kB

API 参考

常见问题

completeInputsByCapacity 抛出"not enough capacity"错误 signer 持有的 Cell 总容量不足以覆盖输出加最小找零 Cell（61 CKB）。请向该地址充值，或减少输出金额。

交易被拒，报错"InsufficientCellCapacity" 每个 Cell 必须持有至少足够支付其链上存储费用的 CKB（基础 Cell 最低 61 CKB）。请确保每个输出的 capacity 满足最低要求。

需要添加自定义 cell deps 或 witnesses ccc.Transaction.from() 接受完整的 TransactionLike——可在 outputs 之外传入 cellDeps、headerDeps、witnesses 和 inputs。CCC 的自动填充方法是追加而非覆盖你已提供的内容。

下一步

• 消息签名——无需发送交易即可证明地址所有权。
• UDT 代币——在 CKB 上发行和转移用户自定义代币（User-Defined Token，简称 UDT）。
• Spore 协议——创建链上数码物（Digital Object，简称 DOB）。