AI 代理與腳本如何透過 API 自動購買 EVM Gas
為機器人、自主 AI 代理與 CI 測試流水線打造的自動化微量 Gas 充值指南,免 API 金鑰、免註冊帳號、免 KYC 驗證。
自主軟體代理與後端腳本經常遇到冷啟動 Gas 問題。當代理生成全新的外部擁有帳戶(EOA)以領取空投、歸集代幣或調用智能合約時,該地址原生餘額為零,無法向驗證節點支付交易手續費。
為解決此問題,開發者需要一套 api 購買 eth gas 的方案。相較於中心化交易所繁瑣的 KYC 與身分憑據,1gwei.dev 提供開放式 HTTP 加油站服務,讓 腳本錢包 gas 充值 流程能以 免 api key gas 儲值 的輕量方式運作。
AI 代理需要原生 Gas 餘額,而不僅是支付協議
x402 等新興協議允許代理透過穩定幣支付 HTTP 服務費用。然而在區塊鏈上,EVM 交易仍必須消耗原生燃料來執行位元組碼。持有鏈下額度的代理若錢包缺乏 原生 gas 餘額 eoa,依舊無法移動鏈上資產。
無論是在 Ethereum (ETH)、Arbitrum (ETH)、Base (ETH)、Robinhood (ETH)、Polygon (POL)、HyperEVM (HYPE)、BNB Chain (BNB) 還是 Sepolia (ETH) 測試網,驗證節點都只接受真正的底層原生幣。
加油站 API 對比 Paymaster 與代付轉發器
Paymaster 僅贊助帳戶抽象的 UserOperation
ERC-4337 Paymaster 允許智慧合約帳戶使用 ERC-20 代幣扣除手續費或進行免 Gas 交易,但前提是該錢包架構必須專門支援帳戶抽象合約。
加油站直接將原生 Gas 打入任何普通 EOA 錢包
一般的開發腳本與私鑰無法使用 Paymaster。專屬的 openapi 加油站 透過訂單發票模式,直接將微量原生 Gas 轉入目的地址,無須依賴額外的合約代付架構。
程式化訂單調用流程:報價、下單、付款與輪詢
完整的整合指南記載於機器純文字規格 llms.txt gas 文件 與 llms-full.txt,由四個輕量級 HTTP 步驟組成。
1. 獲取即時價格報價
呼叫 GET /api/quote?chain={chain}ðAmount={amount},在下單前確認即時的 invoiceUsd 與網絡基準手續費。
2. 建立 Gas 訂單
發送 POST /api/orders,帶入 destAddress、chain、ethAmount 與 method(LN、XMR 或 x402)。可選填 ref 推薦人地址或 sendAt 排程發送時間。
3. 結算支付發票
若是閃電網路,代理讀取 bolt11 發票並透過 閃電網路發票 gas api 結算;若是門羅幣,透過 程式化門羅幣支付 gas 轉入 payment.address;若是 x402,則在 Base 上轉入 USDC。
4. 輪詢直到發放完成
每 3 至 8 秒輪詢 GET /api/orders/{id}。付款確認後狀態會切換為 paid 並轉為 sent,代理隨後即可執行 輪詢訂單 txhash 確認鏈上交易最終性。
多鏈代幣參數與充值額度設定
雖然下單請求參數名稱為 ethAmount,但它代表目標網絡的原生代幣:在 Polygon 上代表 POL,在 HyperEVM 上代表 HYPE,在 BNB Chain 上代表 BNB。
請透過 GET /api/meta 查詢每條鏈的即時上下限與預設值。由於本服務專為微量加油設計而非大額代幣兌換,單筆訂單上限經過刻意限制以維護系統流動性。
自動化 CI 流水線與 Sepolia 測試網注水
自動化測試套件與 CI 執行器常因公共測試網水龍頭乾涸或要求 GitHub 身分驗證及驗證碼而中斷。
借助 sepolia gas api ci 自動化 流程,測試套件能在部署臨時測試合約前依需求即時購買 Sepolia ETH,完全無須人工介入。
錯誤處理、安全性與隱私權邊界
鏈上轉帳不可逆:發送訂單前,腳本務必先對目的地址進行校驗和(checksum)驗證。
在隱私與保管責任方面:資金由我們的熱錢包發出,而非來自去中心化智能合約池。1gwei.dev 並不會讓你的錢包地址無法追蹤,區塊瀏覽器上也絕無隱藏鏈上發放交易。我們保證的是沒有任何身分證件、帳號註冊或交易所帳戶連結會將資金來源與目的地址綁定。
常見問題
AI 代理如何免 KYC 為 EVM 錢包充值 Gas?
代理可呼叫 1gwei.dev 的公開 REST API 建立包含目標地址與網絡的訂單,程式化支付閃電網路或門羅幣發票,並輪詢訂單直到原生 Gas 交易廣播。
Paymaster API 與加油站 API 有何不同?
Paymaster API 為智慧帳戶代付 UserOperation 手續費;加油站 API 則直接將原生 Gas(ETH、POL、HYPE、BNB)轉入標準 EOA 地址,以便執行任何普通交易。
建議的訂單輪詢間隔是多少?
建議每 3 到 8 秒輪詢一次 GET /api/orders/{id}。快於 2 秒可能觸發頻率限制,慢於 10 秒則會增加不必要的等待延遲。
呼叫 POST /api/orders 需要哪些必要參數?
必須提供 destAddress(接收 0x 地址)、chain(網絡鍵值如 base 或 hyperevm)、ethAmount(原生 Gas 數量)以及 method('LN'、'XMR' 或 'x402')。
CI/CD 流程能使用此 API 為 Sepolia 測試錢包注水嗎?
可以。CI 腳本能自動下單購買 Sepolia 測試網 ETH 並結算發票,無驗證碼、無 GitHub 帳號綁定,也無水龍頭排隊限制。
自動化腳本的付款隱私如何保障?
透過門羅幣或閃電網路付款時,鏈上不會記錄任何發送者身分。熱錢包轉向目標地址的交易在瀏覽器上公開可查,但無任何連結指向代理的資金來源。