createSelfFacilitator

このコンテンツはまだ日本語訳がありません。

createSelfFacilitator(params): Facilitator

Builds a facilitator that verifies and broadcasts exact-EVM EIP-3009 payments using a locally-held EOA private key (gas payer).

Intended for self-hosted paywalls and testnet (Polygon Amoy) where the Coinbase CDP facilitator is not guaranteed to support the chain.

Concurrent settle() calls: under any meaningful load (e.g. an LLM agent fan-out) you will issue multiple transferWithAuthorization broadcasts from the same facilitator EOA in parallel. Without local nonce sequencing those broadcasts race for the same on-chain nonce and only one lands. Pass viem’s nonceManager when constructing the facilitator account to make this safe — see @example below.

Parameters

params

CreateSelfFacilitatorParams

Returns

Facilitator

Example

import { createPublicClient, createWalletClient, http } from "viem";
import { nonceManager, privateKeyToAccount } from "viem/accounts";
import { createSelfFacilitator, polygonAmoy } from "kawasekit";

// `nonceManager` is REQUIRED whenever you expect concurrent settlements.
const account = privateKeyToAccount(
  process.env.FACILITATOR_PK as `0x${string}`,
  { nonceManager },
);
const transport = http(process.env.RPC_URL);
const facilitator = createSelfFacilitator({
  network: "testnet", // must agree with polygonAmoy.isTestnet === true
  walletClient: createWalletClient({ chain: polygonAmoy, transport, account }),
  publicClient: createPublicClient({ chain: polygonAmoy, transport }),
});