🎯

cardano-cli-plutus-scripts-operator

🎯Skill

from thamacroman/cardano-agent-skills

VibeIndex|
What it does

Executes Plutus script transactions on Cardano, requiring explicit human verification and collateral management.

πŸ“¦

Part of

thamacroman/cardano-agent-skills(15 items)

cardano-cli-plutus-scripts-operator

Installation

Quick InstallInstall with npx
npx skills add Flux-Point-Studios/cardano-agent-skills
Quick InstallInstall with npx
npx add-skill Flux-Point-Studios/cardano-agent-skills -a claude-code
Quick InstallInstall with npx
npx add-skill Flux-Point-Studios/cardano-agent-skills --skill cardano-cli-wallets --skill cardano-cli-transactions -a claude-code
πŸ“– Extracted from docs: thamacroman/cardano-agent-skills
2Installs
-
AddedFeb 4, 2026

Skill Details

SKILL.md

"Execute Plutus script transactions: script spends, datum/redeemer submission. Manual invoke only."

Overview

# cardano-cli-plutus-scripts-operator

> OPERATOR SKILL: Executes Plutus script transactions. Requires explicit human invocation due to collateral risk.

When to use

  • When ready to spend from a script address
  • After reviewing guidance from cardano-cli-plutus-scripts

Operating rules (must follow)

  • ALWAYS verify collateral UTxO is ADA-only
  • Confirm script hash matches expected
  • Validate datum/redeemer JSON before use
  • REQUIRE explicit confirmation before submit
  • Test on preprod/preview before mainnet

Pre-flight checklist

```

[ ] Network: ___________

[ ] Script file (.plutus) verified

[ ] Script hash matches on-chain

[ ] Datum JSON validated

[ ] Redeemer JSON validated

[ ] Collateral UTxO selected (ADA-only!)

[ ] Protocol parameters fresh

```

Execution workflow

Step 1: Verify script

```bash

# Get script hash

cardano-cli conway transaction policyid \

--script-file script.plutus

# Derive script address

cardano-cli conway address build \

--payment-script-file script.plutus \

--testnet-magic 1 \

--out-file script.addr

```

Step 2: Query script UTxO

```bash

cardano-cli conway query utxo \

--address $(cat script.addr) \

--testnet-magic 1

```

Step 3: Prepare collateral

```bash

# Must be ADA-only UTxO at your payment address

cardano-cli conway query utxo \

--address \

--testnet-magic 1

# Select one with only ADA (no tokens)

```

Step 4: Build script spend

```bash

cardano-cli conway transaction build \

--testnet-magic 1 \

--tx-in # \

--tx-in-script-file script.plutus \

--tx-in-inline-datum-present \

--tx-in-redeemer-file redeemer.json \

--tx-in-collateral # \

--tx-out + \

--change-address \

--out-file tx.unsigned

```

Step 5: Sign and submit

```bash

# Sign (collateral signer required)

cardano-cli conway transaction sign \

--tx-file tx.unsigned \

--signing-key-file payment.skey \

--testnet-magic 1 \

--out-file tx.signed

# ⚠️ CONFIRM before submit

echo "=== SCRIPT SPEND CONFIRMATION ==="

echo "Script: $(cat script.addr | head -c 20)..."

echo "Spending UTxO: "

echo "Collateral: "

echo "Output to: "

cardano-cli conway transaction submit \

--testnet-magic 1 \

--tx-file tx.signed

```

Debugging failed scripts

```bash

# If script fails, check execution units

cardano-cli conway transaction build \

... \

--calculate-plutus-script-cost cost.json

# Review cost.json for budget issues

cat cost.json | jq .

```

Safety / key handling

  • Collateral is at risk if script fails unexpectedly
  • Use minimal collateral (1-5 ADA typically sufficient)
  • Keep datum/redeemer free of secrets
  • Verify script logic on testnet first

References

  • cardano-cli-plutus-scripts (guidance skill)
  • shared/PRINCIPLES.md

More from this repository10

🎯
meshjs-cardano🎯Skill

Enables seamless Cardano dApp development using MeshJS, providing wallet connections, transaction building, and script interactions in TypeScript/JavaScript.

🎯
hydra-head-troubleshooter🎯Skill

Troubleshoots Hydra Head node connectivity and synchronization issues by systematically diagnosing network, configuration, and peer-related problems.

🎯
koios-agent-wallet🎯Skill

Generates and manages Cardano key-based wallets, enabling wallet creation, stake address registration, pool staking, and transactions via KoiosProvider.

🎯
hydra-head🎯Skill

Provides step-by-step guidance for setting up and managing Hydra Head nodes with best practices and configuration templates.

🎯
aiken-dex-security-audit🎯Skill

Skill

🎯
cardano-cli-wallets-operator🎯Skill

Skill

🎯
cardano-cli-transactions-operator🎯Skill

Executes Cardano CLI transactions with manual confirmation, ensuring safe and reproducible transaction builds and submissions.

🎯
aiken-smart-contracts🎯Skill

Enables rapid Aiken smart contract development on Cardano, generating validators, blueprints, and .plutus artifacts with safe, version-controlled workflows.

🎯
cardano-cli-transactions🎯Skill

Generates comprehensive Cardano CLI transaction templates for ADA transfers, multi-output transactions, native token transfers, and metadata-enriched transactions across different networks.

🎯
cardano-cli-doctor🎯Skill

Skill