GitHub Actions 24/7 鏈上錢包餘額監聽器,零月費的免費方案

上一篇談 Cloudflare Workers,這篇講 GitHub Actions — 兩者都是「免月費 always-on 雲端」的好搭檔,但用途不同:Workers 接收外部 HTTP,Actions 則適合「定時拉資料 + 寫狀態」。

場景:24/7 監聽鏈上錢包餘額

需求:你想知道某個 ETH/Base 地址什麼時候收到第一筆款項。傳統作法 → 自架 server / 訂閱第三方 API(月費)。GitHub Actions 公開 repo 給你:每 5 分鐘執行一次 cron + 無限分鐘配額 + 自動 commit 結果到 repo。

三步驟

1. .github/workflows/poll.yml:schedule: - cron: '*/5 * * * *'

2. job 內 curl https://mainnet.base.org -d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x...","latest"]}'

3. 比對前次餘額,變動則 git commit -m "balance change: +0.001 ETH" + gh issue create

為什麼是 24/7

GitHub Actions 公開 repo 不限分鐘數;cron schedule 由 GitHub 排程器觸發,你的 Mac 關機完全不影響。實測延遲:cron 5 分鐘是「最快理論值」,實際抖動 +1~3 分鐘。

限制

1. 5 分鐘是最低 cron 間隔(GitHub 強制)。需要秒級 → 用 Workers cron triggers。

2. workflow 內 secret 注意 — 公開 repo 的 secrets 不會洩漏,但 fork PR 的 workflow 拿不到 secrets(這是設計)。

3. 寫入頻繁 → repo 會膨脹。把狀態檔放 state/ 子目錄並做 git gc 排程。

Repo 模板

已開源:github.com/relayhop/... 的 verify_seed.yml 即此模式實作,每 5 分鐘輪詢 Base USDC 餘額。

下篇:用 Cloudflare Workers + GitHub Actions 組合做 LN 收款 webhook 接收器(0 月費)。