用途：为 Cardano 代理（agent）快速搭建基于密钥的钱包，使用 MeshJS 的 MeshWallet 与 KoiosProvider，覆盖生成钱包、注册质押地址、委托质押、发送 ADA 以及签名提交 dApp 预构建交易。默认主网，除非用户明确要求 preprod/preview/guild；不确定时先确认网络。
主要能力：用 scripts/generate-key-based-wallet.js 生成支付与质押密钥对（无助记词、无需 cardano-cli），输出 base 地址、stake 地址及 PAYMENT_SKEY_CBOR_HEX / STAKE_SKEY_CBOR_HEX；用 MeshWallet 以 CLI 密钥或 root 私钥加载钱包；用 KoiosProvider 读取 UTxO、账户信息并提交交易；用 MeshTxBuilder 发送 ADA、注册并委托质押；签名并提交 dApp（如 Nexus）构建的未签名交易。
使用方式：先确认密钥来源（CLI 签名密钥或 root 私钥）与运行环境（Node.js/浏览器、TS/JS）。生成钱包：cd skills/koios-agent-wallet 后运行 NETWORK=mainnet node scripts/generate-key-based-wallet.js，可选 WALLET_DIR=./wallet 落盘。向 base 地址充值后，用 KOIOS_NETWORK=api MODE=stake REGISTER_STAKE=1 POOL_ID=pool1... PAYMENT_SKEY_CBOR_HEX=<...> STAKE_SKEY_CBOR_HEX=<...> node scripts/agent-wallet.js 一步完成注册与委托。发送 ADA 用 MODE=send 与 RECIPIENT_ADDR、SEND_LOVELACE。签名提交 dApp 交易用 MODE=sign-submit 与 TX_CBOR_HEX。Koios 基础地址：主网 https://api.koios.rest，preprod https://preprod.koios.rest，preview https://preview.koios.rest，guild https://guild.koios.rest。
适用场景：代理运行时需要无助记词的钱包操作、质押委托、发送 ADA、配合托管 dApp 完成铸造等签名提交。
限制：代理运行时不得使用助记词签名或质押，仅用 CLI 密钥或 root 密钥；绝不索取助记词或私钥。质押需要质押签名密钥，仅有支付密钥无法签名质押证书；首次委托必须 REGISTER_STAKE=1，且需预留约 2 ADA 质押押金加手续费。MeshWallet.signTx() 只添加支付密钥见证，质押证书还需质押密钥见证。Pool ID 建议使用 Cardanoscan 等可信来源的 bech32（pool1...），手动 hex 转换可能出错。依赖 @meshsdk/core、@emurgo/cardano-serialization-lib-nodejs，hex POOL_ID 还需 bech32。