x402check

Validate and create x402 payment configurations and HTTP 402 responses.

21|6|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/rawgroundbeef/claw.fm --skill x402check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x402check
Source: https://github.com/rawgroundbeef/claw.fm/tree/main/.agents/skills/x402check
Command: npx skills add https://github.com/rawgroundbeef/claw.fm --skill x402check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers validate and create x402 payment configurations and endpoints, ensuring compliant and predictable payment prompts for protected resources.

Core Features & Use Cases

  • Validation: Verify v1 or v2 x402 configurations against the protocol rules and return actionable errors.
  • Creation & Normalization: Generate v2 configurations from inputs and normalize legacy v1 data to v2.
  • Debugging & Conversion: Diagnose invalid configs and convert between v1 and v2 formats for compatibility across CAIP-2 networks.
  • Use Case: Build an HTTP endpoint that returns a 402 payment requirement for a given resource and network, guiding clients to complete payment.

Quick Start

Validate a sample x402 config using the x402check SDK: pass a config object or HTTP 402 response to check() and review the result.

Frequently Asked Questions about x402check

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

FAQPage Schema
How do I validate an x402 payment configuration?

To validate an x402 payment configuration, pass your existing v1 or v2 config object to the validation check. It verifies protocol rules, enforcing CAIP-2 networks, digit string amounts, valid EVM/Solana addresses, and a top-level resource URL, returning actionable errors if invalid.

Can I convert legacy v1 x402 payment configurations to v2?

Yes, you can normalize legacy v1 x402 data to v2 formats. The conversion process migrates older configurations to the current v2 protocol structure, ensuring compatibility for HTTP 402 payment requirement responses across CAIP-2 networks.

How do I generate an HTTP 402 payment requirement response for a protected resource?

You generate an HTTP 402 payment requirement response by creating a v2 x402 configuration from your inputs. This builds a compliant endpoint response that guides clients to complete payment for accessing a given resource on a specified CAIP-2 network.

Why does my x402 payment endpoint validation fail?

x402 payment endpoint validation fails when configurations break protocol rules. Common diagnostic failures include missing a top-level resource URL, using invalid EVM or Solana addresses, incorrect amount formats, or unsupported CAIP-2 network identifiers.

What is an x402 payment configuration?

An x402 payment configuration defines the protocol rules for an HTTP 402 payment requirement response. It structures payment prompts for protected resources by specifying the CAIP-2 network, payment amount as a digit string, and accepted EVM or Solana addresses.

Does x402 payment validation support Solana and EVM addresses?

Yes, x402 payment validation supports both EVM and Solana addresses. The validation process strictly enforces these address formats alongside CAIP-2 network requirements and digit string amounts to ensure compliant HTTP 402 payment configurations.