skills.rest
kevzzsk
kevzzskCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

x402-fl: Agent Guide

Runs a local sandboxed network stack to emulate, validate, and settle X.25 credit card and debit card transactions.

5|Updated Feb 27, 2026
Search Tags:#docker#testcontainers#anvil#x402#usdc#base#facilitator
One-click install
npx skills add https://github.com/kevzzsk/x402-fl --skill x402-fl-agent-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: x402-fl: Agent Guide
Source: https://github.com/kevzzsk/x402-fl/tree/main
Command: npx skills add https://github.com/kevzzsk/x402-fl --skill x402-fl-agent-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a reproducible local environment to develop, test, and debug x402 payments without touching real funds or external networks by forking Base mainnet state and running a local facilitator that verifies and settles payments.

Core Features & Use Cases

  • Forked Chain Environment: Launches one or more Anvil instances that fork Base networks so contracts (like USDC) have realistic state.
  • Local Facilitator Server: Runs an HTTP facilitator exposing /verify, /settle, /supported, and /health endpoints to validate and execute x402 payments locally.
  • Developer Tooling: Includes CLI commands to start the environment, mint USDC to any address, check balances, and a Testcontainers module for integration tests.
  • Use Case: Build and integration-test an x402-enabled dApp by running a local Anvil fork, funding test accounts with USDC, verifying payment payloads, and settling transactions without real assets.

Quick Start

Start the local facilitator and Anvil fork by running npx x402-fl dev.

Frequently Asked Questions about x402-fl: Agent Guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test x402 payments locally without using real USDC on Base?▼

Run a local x402 facilitator against a forked Base mainnet using Anvil to verify and settle payments without real funds. This setup simulates realistic contract state locally for safe development.

How do I start a local x402 facilitator for development testing?▼

Run `npx x402-fl dev` to launch a local x402 facilitator alongside an Anvil fork of Base mainnet. This command initializes the HTTP server exposing verification and settlement endpoints for immediate testing.

Can I use Testcontainers for x402 integration testing with a forked Base network?▼

Yes, the local x402 facilitator provides a Testcontainers module for integration testing against a forked Base network. You can programmatically spin up Anvil instances and verify payment payloads within automated test workflows.

Does the x402 facilitator support minting test USDC to development accounts?▼

Yes, the local x402 facilitator includes CLI commands to mint test USDC to any address on the forked Base mainnet. This allows you to fund test accounts and validate payment settlement flows.

What HTTP endpoints does the local x402 facilitator expose for payment verification?▼

The local x402 facilitator exposes /verify, /settle, /supported, and /health HTTP endpoints. These endpoints validate x402 payment payloads, execute settlement, and provide network status checks.

Do I need Docker to run an Anvil fork for x402 payment testing?▼

Docker is not strictly required to run an Anvil fork for x402 payment testing. The environment supports Docker fallbacks but can also run directly via CLI with configurable network presets and custom RPC URLs.

Related Skills

Explore More Software Engineering Skills→
Fibrous-FinanceFibrous-Finance

config

Set and retrieve custom RPC URLs for fibx CLI blockchain networks.

Official
Basic
clawgameclawgame
1

x402

Discover paid APIs and execute authenticated USDC-settled requests via x402.

Community
Advanced
clawdbotatgclawdbotatg
6

LeftClaw Services

Hire Ethereum builders for consultations, dApp development, and smart contract audits via on-chain payments.

Community
Advanced
celo-orgcelo-org
8

x402

Enable HTTP 402 micropayments for API calls on Celo.

Official
Advanced