用途:说明 @1sat/actions 中每个操作共用的机制,包括 Action/Context 模式、两阶段签名(createAction/signAction)、BEEF 解析、动作注册表以及 baskets/tags。具体操作细节由同级领域技能覆盖。
主要能力:所有操作均为 Action,带 meta(name、description、category、input schema)和 execute(ctx, input)。可配合任何 BRC-100 兼容钱包(OneSatWallet、浏览器扩展、wallet-remote 等)。动作在全局 actionRegistry 中注册,可用 actionRegistry.list()、actionRegistry.get('sendBsv')、actionRegistry.toMcpTools() 查询或转为 MCP 工具定义。
使用方式:用 createContext(wallet, { services, chain: 'main', debug: true }) 建上下文;meta.requiresServices 为 true 的动作必须在上下文中提供 services。再执行 action.execute(ctx, input),交易类动作返回 tx?: number[](AtomicBEEF),非十六进制字符串。花自定义脚本(序数、锁、代币)先 createAction 构建交易,再用 completeSignedAction 签名并最终化,它负责 BEEF 合并、脚本校验、signAction 及失败时 abortAction;普通转账(sendBsv/sendAllBsv)为单阶段,无此流程。owned 的 id-first P1SAT 资产仅传 { id },动作通过 loadBasketOutputBeef(basket, id) 加载;外部输入需传 inputBEEF 或依赖 services 拉取。
适用场景:向钱包用户提供 BSV、序数、BSV21 代币、OpNS、锁仓、BAP 身份、签名与社交等操作的统一接口,以及为 MCP 工具生成动作定义。
限制:该技能只讲共享机制,具体操作需查看同级 payments、inscriptions、ordinals、tokens、locks、signing、identity、social、opns、sweep 等技能。自定义底层构建可考虑 @1sat/core 与 @1sat/templates,但代币部署/铸造/销毁和序数操作已有对应 Action。环境要求为 bun add @1sat/actions @bsv/sdk。资料未提供收费与价格信息。