Pendle PT 收益策略

围绕本金代币（Principal Token）构建的固定收益工作流策略技能。

该可发布包的范围被有意限定为以下几项：

• 分析 / 监控
• 执行规划
• 面向托管钱包的操作指引
• 手动执行回退机制

它不包含原始私钥签名代码。 它不包含直接提交交易的辅助工具（此类工具会读取本地钱包私钥）。

钱包设计哲学

默认采用最安全且切实可行的钱包路径。

优先级顺序如下：

1. 具备策略控制能力的托管钱包 — 首选
2. 由用户手动执行的交易流程 — 回退方案
3. 本公开包中不默认启用运行时原始私钥签名

本公开包的设计目标是避免将私钥导出或运行时私钥注入作为标准路径进行规范化。

首选钱包路径：Privy 或其他托管钱包层

本技能的首选执行模型是具备策略控制、支出限额及显式操作员配置的托管钱包系统。

在可用时，请使用 Privy 等托管钱包服务提供商。这是面向智能体（agentic）执行的首选部署模式。

为何此路径更优：

• 避免将原始私钥导出设为默认行为
• 支持基于策略的管控与更安全的操作边界
• 更契合生产环境中的智能体工作流
• 更符合智能体链上系统所预期的安全态势

本包当前行为

本包协助智能体完成以下任务：

• 扫描并排序市场
• 规划存入（deposit）、赎回（redeem）、退出（exit）和展期（rollover）操作
• 在本地 JSON 状态中追踪持仓
• 监控到期日并准备下一步操作
• 清晰说明预期采用的托管钱包路径或手动执行路径

实际交易提交应通过以下任一方式完成：

• 由宿主环境编排的托管钱包后端（例如 Privy）
• 或由用户手动执行的钱包流程

若宿主环境已安装 privy 技能，建议优先使用该钱包层执行交易，并仅将本技能用于 Pendle 市场/持仓逻辑及执行规划。

支持的执行模式

模式 1 — 通过 Privy 或等效托管钱包执行

首选模式。

当运行时环境满足以下条件时使用此模式：

• 已配置托管型智能体钱包系统
• 具备策略控制 / 支出限额
• 支持带防护机制的服务器端交易执行

在此模式下，本技能应执行以下步骤：

1. 扫描 / 排序市场
2. 预览拟执行的 Pendle 操作
3. 请求明确确认
4. 将执行路由至托管钱包后端
5. 更新 data/positions.json

当 privy 技能可用时，优先选择该集成路径。

模式 2 — 用户手动执行的交易流程

回退模式。

当未配置托管钱包时使用此模式。

在此模式下，本技能应执行以下步骤：

1. 扫描 / 排序市场
2. 预估金额、APY、到期日及滑点
3. 准备下一步操作或交易计划
4. 提示用户通过其钱包提交交易
5. 在执行确认后记录持仓

执行前必需披露事项

在执行或执行规划前，智能体必须明确传达以下要点：

1. 本操作可能导致真实的链上交易。
2. 必须清晰说明所用钱包路径：
   • 托管钱包后端
   • 手动外部钱包执行
3. 适用 Gas 费与滑点。
4. PT 收益仅在持有至到期时才为固定值。
5. 底层资产风险依然存在。
6. 提前退出可能实现的收益低于到期价值。

切勿模糊规划与执行之间的界限。

安全与确认规则

硬性规则

除非宿主环境或用户确认交易确实已完成，否则不得将交易呈现为“已执行”。

确认标准

必须要求明确的确认，例如：

• Confirm Pendle deposit
• Confirm Pendle redeem
• Confirm Pendle withdraw
• Confirm Pendle rollover

该确认应发生在用户已查看以下全部信息之后：

• 市场 / 持仓名称
• 链（chain）
• 预计转入 / 转出金额
• 滑点或价格影响预估
• 到期日
• 显著风险提示
• 将采用的钱包路径

硬性终止条件

若出现以下任一情况，则不得继续推进执行规划（视同可执行）：

• 报价 / 路由 API 调用失败
• 目标规模下流动性过低
• 滑点超出阈值
• 钱包路径不明确
• 用户未明确授权下一步操作

本技能支持的功能

分析与监控

• 扫描活跃的 Pendle PT 市场
• 按 APY、流动性、风险及到期匹配度对相对稳定的 PT 市场进行排序
• 比较“持有至面值”与“临近面值轮动”策略思路
• 在 data/positions.json 中追踪持仓
• 监控到期日并识别可展期标的
• 生成状态报告与手动操作计划

执行规划

• 预览 USDC → PT 的兑换路径
• 制定 PT 存入计划
• 制定 PT 赎回或 PT → USDC 退出计划
• 制定到期后的展期流程
• 在外部确认执行后记录并监控持仓

本包为面向托管钱包设计，同时兼容手动执行。不附带私钥运行时签名代码。

策略概览

核心循环为：扫描 → 选择 → 预览 → 确认 → 通过托管钱包或外部手动执行 → 追踪 → 监控 → 展期。

1. 扫描活跃的 Pendle PT 市场
2. 筛选底层资产相对稳定、到期窗口可接受的市场
3. 按 APY、流动性、风险及执行可行性对候选市场排序
4. 预览拟执行路径并展示关键交易细节
5. 声明将采用的钱包路径
6. 在进入下一步前请求明确确认
7. 通过托管钱包后端或手动外部钱包流程执行
8. 更新 data/positions.json
9. 监控到期或临近到期状态，并重复上述流程

参数与默认值

承诺期限分级

除非用户明确要求短期资金停放，或另行指定偏好，否则默认采用长期承诺。

市场过滤器

命令

scan

使用内置的扫描与排序脚本查找候选市场。

推荐流程：

cd scripts
python3 scan-markets.py --active-only
python3 rank-markets.py 
  --stable-only 
  --stable-subtype stable-major stable-synthetic stable-rwa 
  --chains ethereum base arbitrum 
  --min-days 1 
  --max-days 100 
  --min-liquidity 1000000
python3 report-markets.py --top 20

deposit

1. 验证市场有效性
2. 预览兑换路径、APY、到期日及滑点
3. 声明将采用的钱包路径
4. 请求明确确认
5. 若使用托管钱包后端，则将执行路由至该后端
6. 否则准备手动交易计划并提示用户签名
7. 在执行确认后记录持仓

redeem

1. 检查 PT 是否已到期或具备退出条件
2. 预览赎回 / 退出路径
3. 声明将采用的钱包路径
4. 请求明确确认
5. 若使用托管钱包后端，则将执行路由至该后端
6. 否则准备手动交易计划并提示用户签名
7. 在执行确认后更新 data/positions.json

withdraw

1. 预览 PT → USDC 提前退出路径
2. 警告提前退出可能实现的收益低于到期价值
3. 声明将采用的钱包路径
4. 请求明确确认
5. 相应准备或路由退出流程

status

读取 data/positions.json 并汇总活跃持仓、预期价值、到期时间表及整体预期收益率。

monitor

用于周期性检查。标记已到期及即将到期的持仓，并准备下一步操作：

• 持有
• 赎回
• 赎回后展期
• 人工复核

rollover

1. 识别临近到期的现有持仓
2. 扫描下一个最优候选市场
3. 预览组合退出 + 下一入场计划
4. 声明将采用的钱包路径
5. 请求明确确认
6. 路由至托管钱包后端，或准备分步手动操作流程

本技能包含的文件

持仓追踪 Schema

所有持仓均以 JSON 数组形式存储于 data/positions.json 中。

[
  {
    "id": "pos_001",
    "status": "active | redeemed | withdrawn_early | rolling",
    "chain": "ethereum",
    "chain_id": 1,
    "market_address": "0x...",
    "market_name": "PT-sUSDe 25JUN2026",
    "pt_address": "0x...",
    "underlying_asset": "sUSDe",
    "underlying_address": "0x...",
    "deposit_token": "USDC",
    "deposit_amount_usd": 10000.00,
    "deposit_amount_raw": "10000000000",
    "pt_amount_received": "10234000000000000000000",
    "effective_apy_at_entry": 0.112,
    "entry_date": "2026-04-03T14:30:00Z",
    "entry_tx_hash": "0x...",
    "maturity_date": "2026-06-25T00:00:00Z",
    "days_to_maturity_at_entry": 83,
    "expected_value_at_maturity_usd": 10254.00,
    "redemption_date": null,
    "redemption_tx_hash": null,
    "realized_yield_usd": null,
    "withdrawal_date": null,
    "withdrawal_tx_hash": null,
    "realized_pnl_usd": null,
    "rollover_history": [],
    "notes": ""
  }
]

与 pendle-pt-research 的关系

本技能与 pendle-pt-research 存在功能重叠，但被设计为可独立运行。若两者均已安装，建议使用 research 技能进行更广泛的市场发现，而本技能则专注于执行导向的筛选、持仓追踪与展期规划。

可移植性说明

本包被有意设计为高度可移植，因其不捆绑任何依赖私钥的签名代码。宿主环境可：

• 将执行路由至 Privy 等托管钱包提供商
• 采用手动外部签名
• 在本包之外适配宿主专属的执行工具，同时保留市场与持仓逻辑于本包内