用途:集成与操作 Charms,面向可编程比特币资产。适用于 Charms 应用开发、spell 创建与证明生成、commit 与 spell 交易提交、检查已有交易中的 spell、钱包 charm 清单,以及 API 与钱包集成等具体实现与运维任务,而非通用协议理论。
环境要求:需要 bash、curl、jq 和 charms CLI;应用开发需要 Rust 与 wasm32-wasip1 目标;比特币铸造与钱包流程需要连接节点的 bitcoin-cli(快速迭代可用 testnet4)。
主要能力与用法:先选择执行路径——应用与 spell 生命周期(新建应用、构建、验证密钥、检查、证明、提交)、spell schema 与校验调试、钱包与 API 集成(wallet list、tx show-spell、server endpoint)。运行预检脚本:scripts/check-charms-prereqs.sh app|spell|wallet|server。应用与 spell 操作流程:用 charms app new 搭建应用,构建并派生应用验证密钥,用 charms spell check 校验 spell,用 charms spell prove 生成可打包交易。schema 与校验问题:确认应用标识与 VK,确认 ins 与 outs 和交易实际一致,私密输入保持在链下并通过私密输入文件路径传入。钱包与 API:检查钱包中带 charm 的输出,从已知交易解码 spell 内容,运行 charms server 并以 JSON 或 CBOR 模式调用 /spells/prove。
常用命令:charms app new my-token;charms app build;charms app vk "$app_bin";charms spell check --app-bins="$app_bin" --prev-txs="$prev_txs";charms spell prove --app-bins="$app_bin" --prev-txs="$prev_txs" --funding-utxo="$funding_utxo" --funding-utxo-value="$funding_utxo_value" --change-address="$change_address";charms wallet list --json;charms tx show-spell --chain bitcoin --tx "$tx_hex" --json;charms server --ip 0.0.0.0 --port 17784。
限制与安全:迭代时使用低价值 UTXO 与 testnet4;在验证 commit 与 spell 交易十六进制之前,切勿提交打包交易;prover 与钱包密钥不得出现在日志和源码管理中。参考文件包括 app-and-spell-workflow、spell-format-and-validation、wallet-and-server-integration。