Nick Stavros

我將帶你了解一個真實運作中的 x402 服務底層機制——包含只有在實際付款時才發現的兩個 bug,以及我們在第一天就修正的定價錯誤。

快速聲明:本服務由我所監督的自主 Claude-based 代理 Conway 完成設計、編碼與部署。我並非開發者;所有程式碼皆由代理撰寫,我僅負責核准任何不可逆操作。這也是本次實驗的一部分。

問題

每筆交易都始於一個沒人預算的問題:我在付給誰?向 Base 地址發送通常意味著貼上十六進位字串並祈禱。鏈本身知道該地址是合約還是錢包、是否曾被使用、持有什麼資產——但直到 x402 出現之前,還沒有辦法將這些資訊打包成可透過機器按需支付而無需 API 金鑰註冊的服務。

因此:Conway Address IntelGET /report/{address} 以 $0.02 USDC 透過 HTTP 402 即時支付,回傳結構化盡職調查報告。免費的 /overview/{address} 則提供預覽(合約 vs 錢包、持有資金、活動等級),完全不需要錢包。

整個支付層只需約 10 行程式碼

透過 x402-express,中介軟體會以簽署的條款回應 402,透過 facilitator 驗證買方的 USDC 授權,並在你的處理程序回應後完成結算:

import { paymentMiddleware } from "x402-express";
import { facilitator } from "@coinbase/x402"; // mainnet, auth via CDP keys

app.use(paymentMiddleware(
  PAY_TO_WALLET,
  { "GET /report/*": { price: "$0.02", network: "base" } },
  facilitator,
));

Enter fullscreen mode Exit fullscreen mode

買方端使用 x402-fetch 同樣簡短:

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";

const payFetch = wrapFetchWithPayment(fetch, privateKeyToAccount(KEY));
const res = await payFetch("https://.../report/0x4200...0006");
// 402 → sign EIP-3009 USDC auth → retry → 200. Buyer needs zero ETH; facilitator pays gas.

Enter fullscreen mode Exit fullscreen mode

只有在實際付款時才發現的三件事

1. 結算發生在你的處理程序回應「之後」。 我們在處理程序內記錄收據,但每筆實際付款都被記為「SIMULATED」——結算標頭尚不存在。修正方式:在 res.on("finish") 中讀取 X-PAYMENT-RESPONSE。我們第一筆真實 testnet 結算在帳本中永遠被錯誤標記,之後追加了更正紀錄。帳本不會被編輯。

2. 在支付層之前進行驗證,否則買方可能為無用資料付費。 中介軟體順序很重要:我們的地址驗證在 paymentMiddleware 之前執行,因此 GET /report/0xNOTANADDRESS 會得到 400 回應,告知「你尚未被收取費用」——這在結構上是正確的,因為條款甚至未被提供。

3. 使用真實金錢測試失敗路徑。 我們將服務指向一個失效的 RPC,並進行真實(testnet)付款嘗試:處理程序回應 503,而中介軟體——僅對 2xx 回應進行結算——未向買方收取費用。「失敗的請求不會被收取費用」現在是我們親眼見證的事實,而非僅僅是期望。

定價教訓

我們以 $0.50/report 推出。後來我們觀察市場:x402 服務多集中在 $0.02–0.03/次。以 20 倍於中位數的價格,沒人會衝動測試你——而當你的買方是其他人的代理時,衝動測試正是整個漏斗的頂端。我們將價格調整為 $0.02,並提供免費預覽。邊際成本接近零(純 RPC 讀取),因此任何價格的每次呼叫都是利潤;關鍵在於量能與整合,而非加價。

發現的雞生蛋困境

有趣的是:主要的 x402 發現索引(Bazaar)會在你第一次「結算」時自動列入——沒有提交表單。因此全新服務需要第一個付費客戶才能被付費客戶發現。我們的解決方案:提供任何人都能整合且無需資金的免費端點、在 /.well-known/x402 提供機器可讀的資訊清單、誠實的 /status 頁面(計數器在每次部署後重置——頁面會說明這點),並出現在 x402 開發者實際討論的地方。

立即免費試用

curl https://conway-address-intel-production.up.railway.app/overview/0x420000000000000000000000im00000000000006

Enter fullscreen mode Exit fullscreen mode

完整報告可透過任何 x402 用戶端以 2¢ 取得。資訊清單:/.well-known/x402 · 狀態:/status · 常見問題:/faq

誠實說明範圍:僅提供公開在鏈上的即時資料。非安全審計、非詐騙偵測、非財務建議。若你的 x402 用戶端在我們的 402 流程中遇到問題,請告訴我——代理會快速修正。

截至發佈時,本服務已結算零美元主網金額——我們第一位買方的 2¢ 將真正把我們列入地圖(Bazaar 在首次結算時建立索引)。想要在 AI 代理的附加式帳本中留下永久紀錄嗎?現在就可以。

web3 #base #x402 #agents