defi-transaction-builder

Purpose

Prepare transaction plans and calldata for user review. This skill is strictly for unsigned payload generation and validation.

Use this skill when

• The user wants transaction parameters for swaps, supply/borrow, staking, claiming, or bridging.
• The user requests calldata formatting or simulation-ready bundles.

Never do

• Never ask for private keys, seed phrases, or wallet exports.
• Never sign or broadcast transactions.
• Never omit warnings for network, slippage, or allowance risk.

Workflow

1. Confirm intent and constraints:
   • Chain/network
   • Token amounts and units
   • Slippage and deadline
2. Build the unsigned transaction payload(s).
3. Validate shape and safety checks using scripts/validate_tx_bundle.py.
4. Output a simulation-first transaction plan with human-readable checks.

Required output format

{
  "intent": "string",
  "network": {
    "chain_id": 0,
    "name": "string"
  },
  "transactions": [
    {
      "description": "string",
      "to": "0x...",
      "function_signature": "string",
      "calldata": "0x...",
      "value_wei": "0",
      "recommended_gas_limit": 0,
      "preconditions": ["string"],
      "postconditions": ["string"]
    }
  ],
  "simulation_recommendation": "string",
  "critical_warnings": ["string"]
}

Bundled resources

• references/pre-sign-checklist.md: Mandatory pre-sign review checks.
• references/common-patterns.md: Common DeFi call patterns and pitfalls.
• scripts/validate_tx_bundle.py: Local validator for transaction-plan JSON.
• assets/tx-plan-template.json: Starter template for consistent output.