# Cardano-cli-plutus-脚本 > **这是一项指导技能。** 提供模板和解释。要执行，请使用“cardano-cli-plutus-scripts-operator”。 ## 何时使用 * 学习Plutus脚本交易模式 * 了解数据、赎回者、抵押品 * 获取脚本交互的模板 ## 操作规则（必须遵守） * 确认网络和脚本版本（V2/V3） * 从不执行——只提供模板 * 始终包括抵押品处理 * 使用新的协议参数 ## Docker 后备模式如果本地未安装“cardano-cli”，请使用此技能文件夹中的包装器脚本在 Docker 中运行**cardano-cli**（Cardano 节点容器映像包括 CLI）。 chmod +x {baseDir}/scripts/cardano-cli.sh {baseDir}/scripts/cardano-cli.sh 版本注意事项： * 包装器将当前目录作为“/work”安装到容器中，以便“pparams.json”、“tx.body”、“datum.json”等文件正常工作。 * 如果您有本地节点套接字，请在运行之前设置“CARDANO_NODE_SOCKET_PATH”，以便“query”命令起作用。 * 使用“CARDANO_DOCKER_IMAGE=ghcr.io/intersectmbo/cardano-node:”覆盖图像。 ## 关键概念 ### 脚本版本 * **V1** (Alonzo)：传统，功能有限 * **V2** (Babbage)：参考脚本，内联数据 * **V3** (Conway)：治理、简化界面 ### 数据处理 * **内联数据** ：使用 UTxO 存储在链上 * **数据哈希** ：仅在链上进行哈希，消费时提供完整数据 * **无数据** : 对于某些 V3 脚本 ### 抵押品 * 所有普利拓斯脚本交易都需要 * 必须是仅限 ADA 的 UTxO * 如果脚本意外失败则放弃 * 通常 1-5 ADA 就足够了 ## 工作流程模板 ### 在脚本地址锁定资金 # 1.导出脚本地址 Cardano-cli conway 地址构建 \ --支付脚本文件 script.plutus \ --testnet-magic 1 \ --out-文件脚本.addr # 2. 创建数据文件 echo '{"constructor": 0, "fields": []}' > datum.json # 3. 使用内联数据锁定 Cardano-cli conway 交易构建 \ --testnet-magic 1 \ --tx-in #<索引> \ --tx-out "$(cat script.addr)+5000000" \ --tx-out-inline-datum-file datum.json \ --change-address <付款地址> \ --out-文件 tx.unsigned # 签名并提交 ### 从脚本中支出 # 1. 创建救赎者 echo '{"constructor": 0, "fields": []}' >赎回者.json # 2.构建脚本花费 Cardano-cli conway 交易构建 \ --testnet-magic 1 \ --tx-in <脚本-utxo>#<索引> \ --tx-in-script-file script.plutus \ --tx-in-inline-datum-present \ --tx-in-redeemer-file redeemer.json \ --tx-in-collateral <抵押-utxo>#<索引> \ --tx-out <收件人>+<金额> \ --change-address <付款地址> \ --out-文件 tx.unsigned # 签名（使用抵押密钥）并提交 ### 带参考脚本 # 脚本已在参考 UTxO 上链 Cardano-cli conway 交易构建 \ --testnet-magic 1 \ --tx-in <脚本-utxo>#<索引> \ --spending-tx-in-reference # \ --spending-plutus-script-v2 \ --spending-reference-tx-in-inline-datum-present \ --spending-reference-tx-in-redeemer-file redeemer.json \ --tx-in-collateral <抵押品>#<索引> \ --tx-out <收件人>+<金额> \ --change-address <付款地址> \ --out-文件 tx.unsigned ## 示例 ### 示例：简单的验证器支出 **用户请求：**“从我的总是成功的脚本中支出” **回应：** # === 从永远成功的脚本中支出 === SCRIPT_ADDR=$(cat script.addr) PAYMENT_ADDR=$(cat base.addr) # 1.查询脚本UTxO Cardano-cli conway 查询 utxo \ --地址 $SCRIPT_ADDR \ --testnet-magic 1 # 注意 UTxO 哈希值和索引 # 2.查询支付UTxO（抵押品） Cardano-cli conway 查询 utxo \ --地址 $PAYMENT_ADDR \ --testnet-magic 1 # 选择仅 ADA 的 UTxO 作为抵押品 # 3. 创建赎回者（对于永远成功，可以是单位） echo '{"constructor": 0, "fields": []}' >赎回者.json # 4. 构建交易 Cardano-cli conway 交易构建 \ --testnet-magic 1 \ --tx-in <脚本-utxo>#0 \ --tx-in-script-file 总是成功.plutus \ --tx-in-inline-datum-present \ --tx-in-redeemer-file redeemer.json \ --tx-in-collateral <抵押品-utxo>#0 \ --tx-out“$PAYMENT_ADDR+4500000”\ --更改地址 $PAYMENT_ADDR \ --out-文件 tx.unsigned # 5.签名并提交（使用操作员技巧） ## 调试 ### 计算执行成本 Cardano-cli conway 交易构建 \ ... \ --calculate-plutus-script-cost cost.json 猫成本.json | jq . ### 常见故障 * **ExUnitsTooBig** ：脚本超出执行预算 * **CollateralNotFound** ：抵押品缺失或无效 * **DatumMismatch** ：提供的数据与哈希值不匹配 * **ScriptFailure** ：验证器返回 False ## 安全/钥匙处理 * 首先在预生产/预览上测试脚本 * 使用最少的抵押品 * 数据/救赎者是公开的——没有秘密 * 重建后验证脚本哈希 ## 参考文献 * `共享/原理.md` * `cardano-cli-plutus-scripts-operator` （用于执行） * `aiken-smart-contracts`（用于编写验证器）

Cardano Cli Plutus 脚本

包含技能