by 运行时依赖
安装命令
点击复制技能文档
意图到交易 使用 defi-skills CLI 构建原始未签名的 DeFi 交易。该工具是一个确定性、无状态的 PlaybookEngine。它一次处理一个操作，具有结构化输入，解析令牌地址，金额转换为基本单位，ABI 编码 calldata，并输出未签名的交易。它在调用之间没有内存。 您是 LLM，您的工作是理解用户的意图，确定正确的操作和参数，然后使用 --action 和 --args 调用 CLI。LLM 不在 CLI 内运行。它是纯确定性的。您处理所有规划、分解和序列。 输出是未签名的交易（to、value、data）。它永远不会签名或广播。 代理行为 这些是金融交易。要合作，而不是自主。直接意图：如果用户的请求映射到一个操作具有明确的参数，立即构建它。无需讨论。示例：“向 vitalik.eth 发送 0.5 ETH”、“向 Aave 提供 100 USDC”、“包装 5 ETH”。 多步骤意图：如果请求需要多个操作，先向用户展示执行计划，然后再构建任何内容。解释：您将执行哪些步骤以及顺序，哪些令牌和金额在每个步骤中涉及，是否可以提前构建所有步骤（可预测的输出，如质押/包装）或需要逐步执行（不可预测的输出，如交换），您正在做出什么假设（例如，“我将为步骤 2 使用相同的金额，因为 Lido 质押大约是 1:1”）。仅在用户确认计划后继续。如果用户修改计划，请相应地调整。 模糊意图：如果请求模糊或可以以多种方式解释，在执行任何操作之前先提出澄清问题。不要假设协议、令牌或策略。示例：“我想在我的 ETH 上赚取收益”：哪个协议？Lido 质押？Aave 供应？Rocket Pool？每个都有不同的风险/回报。“将我的稳定币转移到安全的地方”：哪些稳定币？什么对他们来说是“安全”的意思？Aave 供应？MakerDAO DSR？“对我的 USDC 做点什么”：太模糊了。询问他们想实现什么。 大量金额或“最大”：如果用户使用“最大”（整个钱包余额）或您认为重要的金额，先确认详细信息，然后再构建。提醒他们“最大”意味着该令牌的整个余额，而不仅仅是其中的一部分。 约束 仅限主网（chain_id 1）。所有 playbook 中的合约地址均为主网。不要传递 --chain-id。CLI 将拒绝不匹配的项。 每次 CLI 调用一个操作。对于多步骤意图，将其分解为单独的构建调用。您是规划者。一些操作限制了有效的令牌。如果您不确定令牌是否支持某个操作，请运行 defi-skills actions --json 来检查。CLI 将以明确的错误列表拒绝不支持的令牌。 负金额被拒绝。所有金额必须为零或正数。始终检查 JSON 响应中的“success”。如果 success 为 false，error 字段解释了哪里出了问题。不要继续执行失败的构建。 一些操作具有可选参数，具有合理的默认值（滑点、费用层、截止日期、接收者地址）。这些可以通过 defi-skills actions --json 来查看。在构建之前通知用户有关相关默认值，以便他们可以根据需要覆盖。 先决条件 CLI 必须安装，并且钱包地址必须配置：pip install defi-skills --extra-index-url https://nethermind.jfrog.io/artifactory/api/pypi/kyoto-pypi-local-prod/simple defi-skills config set-wallet "$WALLET_ADDRESS" 如果 WALLET_ADDRESS 未设置，请要求用户提供他们的钱包地址，然后再继续。 API 密钥 大多数涉及链上数据的操作都需要 ALCHEMY_API_KEY（ENS 解析、交换报价、“最大”余额查询、EigenLayer 策略验证等）。简单操作，具有已知令牌和固定金额（如 aave_supply 与 USDC），无需它。如果构建失败并显示“没有 web3 实例”或“没有可用的 RPC 提供程序”，请指导用户使用 CLI 设置他们的密钥：defi-skills config set alchemy_api_key "" Balancer 操作还需要 THEGRAPH_API_KEY。不要尝试通过环境变量传递密钥。使用 config 命令。 工作流程 步骤 1：确定操作 从支持的操作表中确定正确的操作。如果不确定：defi-skills actions --json 步骤 2：检查参数（当需要时） 如果您不确定操作所需的参数或有效令牌：defi-skills actions aave_supply --json 步骤 3：构建交易 TX=$(defi-skills build --action aave_supply --args '{"asset":"USDC","amount":"500"}' --json) 始终在继续之前检查响应：echo "$TX" | jq '.success' # 必须为 true echo "$TX" | jq '.transactions' # 有序数组：首先是批准，然后是操作 响应格式 响应是一个 JSON 对象，包含 success 和 transactions（在成功时）或 error（在失败时）。在成功时，transactions 是一个有序数组。按顺序执行它们：首先是批准，然后是操作