HN 日本語サマリー

← 一覧へ戻る
Web開発

X402、静的ブログの収益化練習

X402, a static blog monetization excercise (shtein.me)

30 pointsby morty2818 コメント

要約

Cloudflareの新しいMonetization Gatewayの発表を受け、著者はx402プロトコルとCloudflare Workersを使用して、静的コンテンツの収益化システムを独自に実装しました。この記事では、このシステムを構築するプロセスと、マイクロペイメントによるコンテンツへのアクセス提供について解説しています。

全文翻訳

x402、静的ブログの収益化実験

x402

Cloudflareは数日前に、Monetization Gatewayのローンチに関する発表を行いました。これは多くの理由で革命的です。収益化への高い参入障壁を取り除き、課金対象と最低支払額を非常に精密に制御できます。これにより、インターネットの利用方法が文字通り変わり、インターネットを支える広告経済が時代遅れになる可能性があります。

ブログやAPIなどの収益化に理想的なツールのように思えます。私自身は収益化するものが何もありませんが、この技術は試さずにはいられないほど重要だと感じました。そこで、実際に試してみることにします。

計画

残念ながら、Cloudflareのサービスはまだクローズドベータ(?)のようで、現時点では自由にアクセスできず、ウェイティングリストに登録する必要があります。そこで、私たちは自分たちで実装することになります。それはさらに楽しいことではありませんか?幸い、かなりシンプルなセットアップのようです。ただし、静的ブログにいくつかの動的な要素が追加されますが、1日で追加できないようなものではありません。

では、この仕組みを機能させるために何が必要でしょうか?

  1. 資金を受け取るためのウォレット
  2. 支払い処理ロジックを実行するワーカー
  3. 課金したいリソース

私は1と3を持っていますが、2がありません。ここでは、サイトをCloudflareでホストしているため、Cloudflare Workersを使用します。これにより、実装言語もTypeScriptに決まります。後でローカルサーバーでホストするように再実装するかもしれませんが、実験のスコープを管理可能にするために、今回はCloudflareに留めます。

ミドルウェア

早速始めましょう。まず必要なのは、リクエストを受け取り、支払い後にのみアクセスを許可し、価格表示も処理するミドルウェアです。公式ドキュメントには、Honoでの実装方法の例がありますので、それを使用します。コードがスタンドアロンサーバーではなくCloudflare Workerで実行されること、ウォレットを配置すること、そして例のエンポイントをより有用なものに置き換えることを考慮して、いくつかの変更を加えると、以下のようになります。

import { Hono } from "hono";
import type { MiddlewareHandler } from "hono";
import { paymentMiddleware, x402ResourceServer } from "@x402/hono";
import { ExactEvmScheme } from "@x402/evm/exact/server";
import { ExactSvmScheme } from "@x402/svm/exact/server";
import { HTTPFacilitatorClient } from "@x402/core/server";

const app = new Hono();
const evmAddress = "0xD040AEACCdFf083C5D4cB221F1533e8719a84F0e";
const svmAddress = "HjexCvNzgxJT3Ni7rb98WF4pQGEX2fN7G6Zh26B19mBc";

const facilitatorClient = new HTTPFacilitatorClient({
  url: "https://x402.org/facilitator",
});

let payment: MiddlewareHandler | undefined;

app.use(async (c, next) => {
  payment ??= paymentMiddleware(
    {
      "GET /api/joke": {
        accepts: [
          {
            scheme: "exact",
            price: "$0.01",
            network: "eip155:84532",
            payTo: evmAddress,
          },
          {
            scheme: "exact",
            price: "$0.01",
            network: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
            payTo: svmAddress,
          },
        ],
        description: "A premium, hand-picked joke",
        mimeType: "application/json",
      },
    },
    new x402ResourceServer(facilitatorClient)
      .register("eip155:84532", new ExactEvmScheme())
      .register("solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", new ExactSvmScheme()),
  );
  return payment(c, next);
});

const jokes = [];

app.get("/api/joke", (c) => {
  return c.json({
    joke: jokes[Math.floor(Math.random() * jokes.length)],
  });
});

export default app;

このワーカーには wrangler.jsonc(Cloudflare固有の設定ファイル)も必要です。

{
  "name": "x402-poc",
  "main": "src/index.ts",
  "compatibility_date": "2026-07-01",
  "compatibility_flags": ["nodejs_compat"],
  "env": {
    "production": {
      "name": "x402-poc",
      "routes": [
        { "pattern": "shtein.me/api/*", "zone_name": "shtein.me" }
      ]
    }
  }
}

ここでの2つの分かりにくい点は、nodejs_compat は x402 パッケージが Node の組み込みモジュール(events, crypto, url)をインポートするため必要であり、これがないとビルドが失敗することです。また、ルートは意図的に production 環境のみに配置されています。ルートが定義されていると、wrangler dev はルートのホストをエミュレートするため、ミドルウェアが生成するURLは localhost ではなく実際のドメインを指すようになります。

ローカルでの実行:

npx wrangler dev

そしてテストリクエストを送信すると、ペイウォールが表示されます。

curl -i http://localhost:8787/api/joke
HTTP/1.1 402 Payment Required
Content-Length: 2
Content-Type: application/json
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cDovL2xvY2FsaG9zdDo4Nzg3L2FwaS9qb2tlIiwiZGVzY3JpcHRpb24iOiJBIHByZW1pdW0sIGhhbmQtcGlja2VkIGpva2UiLCJtaW1lVHlwZSI6ImFwcGxpY2F0aW9uL2pzb24ifSwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMyIiwiYW1vdW50IjoiMTAwMDAiLCJhc3NldCI6IjB4MDM2Q2JENTM4NDJjNTQyNjYzNGU3OTI5NTQxZUMyMzE4ZjNkQ0Y3ZSIsInBheVRvIjoiMHhEMDQwQUVBQ0NkRmYwODNDNUQ0Y0IyMjFGMTUzM2U4NzE5YTg0RjBlIiwibWF4VGltZW91dFNlY29uZHMiOjMwMCwiZXh0cmEiOnsibmFtZSI6IlVTREMiLCJ2ZXJzaW9uIjoiMiJ9fSx7InNjaGVtZSI6ImV4YWN0IiwibmV0d29yayI6InNvbGFuYTpFdFdUUkFCWmFZcTZpTWZlWUtvdVJ1MTY2VlUyeHFhMSIsImFtb3VudCI6IjEwMDAwIiwiYXNzZXQiOiI0ek1NQzlzcnQ1Umk1WDE0R0FnWGhhSGlpM0duUEFFRVJZUEpnWkpEbmNEVSIsInBheVRvIjoiSGpleEN2TnpneEpUM05pN3JiOThXRjRwUUdFWDJmTjdHNlpoMjZCMTltQmMiLCJtYXhUaW1lb3V0U2Vjb25kcyI6MzAwLCJleHRyYSI6eyJmZWVQYXllciI6IkNLUEtKV05kSkVxYTgxeDdDa1oxNEJWUGlZNnkxNlN4czdvd3pucXRXWXA1In19XX0=

PAYMENT-REQUIRED ヘッダーは、受け入れ可能な支払い方法と価格のリストをBase64エンコードしたものです。

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "http://localhost:8787/api/joke",
    "description": "A premium, hand-picked joke",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:84532",
      "amount": "10000",
      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "payTo": "0xD040AEACCdFf083C5D4cB221F1533e8719a84F0e",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USDC",
        "version": "2"
      }
    },
    {
      "scheme": "exact",
      "network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
      "amount": "10000",
      "asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
      "payTo": "HjexCvNzgxJT3Ni7rb98WF4pQGEX2fN7G6Zh26B19mBc",
      "maxTimeoutSeconds": 300,
      "extra": {
        "feePayer": "CKPKJWNdJEqa81x7CkZ14BVPiY6y16Sxs7owznqtWYp5"
      }
    }
  ]
}

これがまさに求めているもので、2つのテストネットで正確に1セントの金額が表示されています。では、支払ってみましょうか?この形式でテストするには、支払いを行い、確認付きでリクエストを再送信できるプログラム的なクライアントが必要になります。しかし、この特定のユースケースでは、ブラウザからのエンドユーザーがそれができるかどうかを確認したいのです。幸い、できます!同じURLをブラウザで開くと、以下の画面が表示されます。

[画像: browser-failed-paywall.png]

これは、これを機能させるために何をする必要があるかを平易な英語で示しています。では、実行しましょう。

npm install @x402/paywall
 import { HTTPFacilitatorClient } from "@x402/core/server";
+import { createPaywall, evmPaywall, svmPaywall } from "@x402/paywall";
@@
     new x402ResourceServer(facilitatorClient)
       .register("eip155:84532", new ExactEvmScheme())
       .register("solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", new ExactSvmScheme()),
+    { appName: "Igor's corner", testnet: true },
+    createPaywall().withNetwork(evmPaywall).withNetwork(svmPaywall).build(),
   );
   return payment(c, next);
 });

そして今アクセスを試みると、支払いを支援してくれる素敵なUIが表示されます。

[画像: browser-success-paywall.png]

トップアップリンクが表示されているのは、現在テストネットを使用しているためです。本番環境では表示されません。MetaMaskで支払ってみましょう。

まずMetaMaskを接続します。

[画像: mm-connected.png]

次に、実際の支払いに進みます。

[画像: signature-request.png]

そして最後に、支払ったコンテンツにアクセスできます。

[画像: success.png]

この最終リクエストに関するいくつかの観察事項:

クライアントは PAYMENT-SIGNATURE ヘッダーで支払いを確認する署名を送信します。これは以下のようにデコードされます。

{
  "x402Version": 2,
  "payload": {
    "authorization": {
      "from": "0xAF40224e2B8fF2B4840c99d8458A0Fd803b15a0e",
      "to": "0xD040AEACCdFf083C5D4cB221F1533e8719a84F0e",
      "value": "10000",
      "validAfter": "1783263532",
      "validBefore": "1783264432",
      "nonce": "0x82806d883f9d46e376b9dc9c065560521f1c9064cf58d1d4ea53e9e3be5f01df"
    },
    "signature": "0x7284c4c0da5cd029fff1f07fd4e5ff5b5c51bf13064b9a50e787f83f6e67555a419b85db77f27cb47a2101e03c38b93d1af9e6e4a3b2712675f35c975ea284d51c"
  },
  "resource": {
    "url": "http://localhost:8787/api/joke",
    "description": "A premium, hand-picked joke",
    "mimeType": "application/json"
  },
  "accepted": {
    "scheme": "exact",
    "network": "eip155:84532",
    "amount": "10000",
    "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
    "payTo": "0xD040AEACCdFf083C5D4cB221F1533e8719a84F0e",
    "maxTimeoutSeconds": 300,
    "extra": {
      "name": "USDC",
      "version": "2"
    }
  }
}

ご覧の通り、支払いが行われたことを確認するためにミドルウェアが必要とするすべての情報が含まれています。そのため、成功した PAYMENT-RESPONSE ヘッダーを返します。

{
  "success": true,
  "payer": "0xAF40224e2B8fF2B4840c99d8458A0Fd803b15a0e",
  "transaction": "0x88aefe88050c4faaa650383460451ba1faebe3bdc398793970592e6a4ae787dc",
  "network": "eip155:84532"
}

そして、実際のコンテンツを含むレスポンスボディが返されます。

もう一つの興味深い点は、ブラウザが支払われたコンテンツを別のURLで開いたことです。これはレスポンスから作成されたインメモリオブジェクトのURLです。最初はリフレッシュ時の二重支払いを防ぐためのUIかと思いましたが、そうではないようです。ペイウォールはバックグラウンドでコンテンツを取得し、レスポンスがHTMLではなくJSONであるため、その場でレンダリングするものがなく、レスポンスから作成されたインメモリオブジェクトURLにナビゲートします。プロトコル自体は従量課金制なので、APIを呼び出すたびに課金されます。

完了

さて、すべてが機能していることが確認できたので、本番ネットワークに切り替えて公開しましょう。

 const facilitatorClient = new HTTPFacilitatorClient({
-  url: "https://x402.org/facilitator"
+  url: "https://facilitator.payai.network"
 });
@@
-            network: "eip155:84532",
+            network: "eip155:8453",
@@
-            network: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+            network: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
@@
     new x402ResourceServer(facilitatorClient)
-      .register("eip155:84532", new ExactEvmScheme())
-      .register("solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", new ExactSvmScheme()),
-    { appName: "Igor's corner", testnet: true },
+      .register("eip155:8453", new ExactEvmScheme())
+      .register("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", new ExactSvmScheme()),
+    { appName: "Igor's corner", testnet: false },

x402.org のファシリテーターはテストネットのみを処理するため、実際のネットワークでは Dexter PayAI を参照します。PayAI は、SMS認証や登録なしで、Base および Solana メインネットを処理する無料のファシリテーターです。Dexter も同様の機能を提供するはずでしたが、それがアナウンスしたトランザクションは実際のネットワークに到達せず、支払いタイムアウトが発生しました。PayAI ではすべてがスムーズに機能します。

これで完了です。以下のボタンを押して自分で試すことができます。その前に、Base または Solana ネットワークで USDC をウォレットにチャージするのを忘れないでください。

🎩 プレミアムジョーク ($0.01) を入手

Summary

x402 はAIエージェントのペイウォール化に優れているだけでなく、ブログの収益化にも十分に役立ちます。「Buy Me a Coffee」のようなサービスに手間をかけたり、広告でユーザーを煩わせたりする必要はありません。これは、x402財団がシンプルなx402 クライアント実装をページに提供しているおかげです。

静的サイトに簡単に統合できますが、ある程度のコンピューティングリソースは必要です。ただし、それほど多くはありません。

実装中に気づいた制限事項は以下の通りです。

  • DOMに埋め込まれる動的コンテンツに対して、ネットワークをまたいだ支払いをアウトオブザボックスで実現するソリューションはありません。
  • プロトコルは一度限りの支払いに限定されています。つまり、サブスクリプションのような追加機能や、以前の支払い情報に基づいてコンテンツを2回目に提供したい場合は、自分で構築する必要があります。