mcpField
Y
yield-hunter

yield-hunter

github.com/aibtcdev其他11148 次安装1 天前更新
代码仓库

关于 yield-hunter

yield-hunter 是一个命令行 Skill,可监控钱包中的 sBTC 余额,并将符合条件的资金存入 Zest Protocol 借贷池。它适合希望定期存款并设置最低余额、流动储备和检查间隔的钱包持有者。

主要功能

  1. 01自动向 Zest Protocol 存入 sBTC
  2. 02可配置存款门槛和储备额
  3. 03可调整余额检查间隔
  4. 04查看状态、活动并控制进程
  5. 05持久保存配置和状态

适用场景

  1. 01余额达到门槛时存入 sBTC
  2. 02保留指定数量的 sBTC 流动资金
  3. 03查看存款活动和当前 Zest 仓位

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill yield-hunter

安装后在 Claude Code 中输入/yield-hunter确认已加载。

附带文件AGENT.mdyield-hunter.ts

详细介绍

收益挖掘器技能

提供一个自动化收益挖掘守护进程,用于监控你的钱包 sBTC 余额,并自动存入 Zest Protocol 的借贷池以赚取收益。守护进程在前台运行,可使用 Ctrl+C 或 stop 子命令停止。

状态会在不同运行期间持久化到 ~/.aibtc/yield-hunter-state.json。

要求:

  • 仅限主网(Zest Protocol 仅支持主网)
  • 已解锁的钱包,且有 sBTC 余额
  • 有 STX 余额用于支付交易手续费(Stacks Gas 以 STX 而非 sBTC 支付)

用法

bun run yield-hunter/yield-hunter.ts <subcommand> [options]

子命令

start

启动自动化收益挖掘。在前台运行,直至停止。

bun run yield-hunter/yield-hunter.ts start [--threshold 10000] [--reserve 0] [--interval 600]

选项:

  • --threshold <sats>(可选)——存入前 sBTC 余额的最低门槛,单位为聪(默认值:10000 = 0.0001 sBTC)
  • --reserve <sats>(可选)——保留为流动资金、永不存入的 sBTC 数量,单位为聪(默认值:0——全部存入)
  • --interval <seconds>(可选)——检查间隔,单位为秒(默认值:600 = 10 分钟)

功能:

  1. 验证钱包已解锁且位于主网
  2. 获取当前 Zest Protocol 年化收益率(APY)
  3. 立即检查一次余额
  4. 按配置的间隔定期执行检查
  5. 当钱包中的 sBTC >=(门槛 + 储备)时,将(余额 - 储备)存入 Zest

输出:

{
  "success": true,
  "message": "Yield hunter started",
  "pid": 12345,
  "config": {
    "minDepositThreshold": "10000",
    "minDepositThresholdFormatted": "0.00010000 sBTC",
    "reserve": "0",
    "reserveFormatted": "0.00000000 sBTC",
    "checkIntervalSeconds": 600,
    "asset": "sBTC"
  },
  "note": "Running in foreground. Press Ctrl+C to stop."
}
stop

停止正在运行的收益挖掘器进程。

bun run yield-hunter/yield-hunter.ts stop

向正在运行的守护进程发送 SIGTERM。现有的 Zest 仓位不会受到影响。

输出:

{
  "success": true,
  "message": "Yield hunter stopped (PID: 12345)",
  "stats": {
    "checksRun": 24,
    "depositsExecuted": 3,
    "totalDeposited": "300000",
    "totalDepositedFormatted": "0.00300000 sBTC"
  }
}
status

获取当前收益挖掘器的状态、配置和近期活动。

bun run yield-hunter/yield-hunter.ts status

当钱包处于活跃状态且位于主网时,还会获取当前钱包余额和 Zest 仓位。

输出:

{
  "running": true,
  "pid": 12345,
  "network": "mainnet",
  "config": {
    "minDepositThreshold": "10000",
    "minDepositThresholdFormatted": "0.00010000 sBTC",
    "reserve": "0",
    "reserveFormatted": "0.00000000 sBTC",
    "effectiveThreshold": "10000",
    "checkIntervalMs": 600000,
    "checkIntervalSeconds": 600,
    "asset": "sBTC"
  },
  "stats": {
    "lastCheck": "2024-01-01T12:00:00.000Z",
    "totalDeposited": "300000",
    "totalDepositedFormatted": "0.00300000 sBTC",
    "checksRun": 24,
    "depositsExecuted": 3,
    "lastError": null,
    "currentApy": "5.00%"
  },
  "currentPosition": {
    "walletSbtc": "150000",
    "walletSbtcFormatted": "0.00150000 sBTC",
    "availableToDeposit": "150000",
    "availableToDepositFormatted": "0.00150000 sBTC",
    "zestSupplied": "300000",
    "zestSuppliedFormatted": "0.00300000 sBTC",
    "zestBorrowed": "0"
  },
  "recentLogs": [
    { "timestamp": "2024-01-01T12:00:00.000Z", "type": "info", "message": "Wallet sBTC: 0.00150000 sBTC" }
  ]
}
configure

更新收益挖掘器配置。更改会立即保存,并在下一检查周期生效。

bun run yield-hunter/yield-hunter.ts configure [--threshold 20000] [--reserve 5000] [--interval 300]

选项:

  • --threshold <sats>(可选)——新的最低存入门槛,单位为聪
  • --reserve <sats>(可选)——新的储备金额,单位为聪
  • --interval <seconds>(可选)——新的检查间隔,单位为秒(最低:10)

输出:

{
  "success": true,
  "changes": [
    "Deposit threshold set to 0.00020000 sBTC",
    "Reserve set to 0.00005000 sBTC"
  ],
  "config": {
    "minDepositThreshold": "20000",
    "minDepositThresholdFormatted": "0.00020000 sBTC",
    "reserve": "5000",
    "reserveFormatted": "0.00005000 sBTC",
    "checkIntervalMs": 600000,
    "checkIntervalSeconds": 600,
    "asset": "sBTC"
  },
  "note": "Changes saved. The running daemon will pick them up on the next check cycle."
}

注意事项

  • 状态存储在 ~/.aibtc/yield-hunter-state.json
  • PID 跟踪使用 ~/.aibtc/yield-hunter.pid
  • 存款通过 borrow-helper 合约调用 Zest Protocol 的 supply 函数
  • 交易手续费以 STX 支付——请确保有足够的 STX 余额支付手续费
  • 守护进程在前台运行;如需在后台运行,请使用进程管理器(例如 tmux、screen 或 pm2)
  • 守护进程未运行时也可使用 status(读取持久化状态)
  • 守护进程未运行时也可使用 configure(更改会在下次 start 时生效)

评论

支持 Markdown