用途:该技能通过 Grimoire CLI 或 @grimoirelabs/core 与 @grimoirelabs/venues,在 NitroRPC 应用会话生命周期中执行 Yellow 场所适配器相关动作。适用于需要在 spell 中处理会话生命周期、并希望用确定性 CLI 校验 Yellow 流程的场景。
主要能力与动作:session_open、session_update、session_close_settle,以及 session_transfer 辅助方法。典型手工流程为 open → updates 循环 → close/settle,并发出 emit 事件。
必要用法:优先使用 grimoire simulate ... 与 grimoire cast ... --dry-run。命令包括 grimoire validate <spell>、grimoire simulate <spell> [--no-state] [--json]、grimoire cast <spell> --dry-run [--no-state] [--json]。安装可用 npm i -g @grimoirelabs/cli,或免安装 npx -y @grimoirelabs/cli ...。环境变量:YELLOW_RPC_URL(必需)、YELLOW_APP_ID(推荐)、YELLOW_CHAIN_ID(可选)。
限制与注意:Yellow 目前没有专门的 grimoire venue yellow ... 元数据 CLI,VM 运行需在 spell params 中提供显式会话负载。建议将 Yellow 动作放入独立 spell/技能以隔离故障。更新意图必须为 operate、deposit 或 withdraw 之一;会话版本在更新时必须恰好加 1;更新分配不能为空;签名需满足配置的 quorum/signer 集合。