openfacilitator

Implement x402 payment workflows for Express and Hono APIs with on-chain settlement.

71|22|Updated Apr 6, 2020
One-click install
npx skills add https://github.com/nirholas/agenti --skill openfacilitator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openfacilitator
Source: https://github.com/nirholas/agenti/tree/main/packages/protocols/x402-open-facilitator/skills/openfacilitator
Command: npx skills add https://github.com/nirholas/agenti --skill openfacilitator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

OpenFacilitator x402 payments allow developers to monetize API access across Ethereum, Base, Solana, and Stacks with a simple, secure flow that handles verification and on-chain settlement automatically.

Core Features & Use Cases

  • Middleware adapters for Express and Hono that handle the 402 flow and payment context injection.
  • Support for manual verify + settle and multi-network patterns (V1 and V2) with optional refund protection.
  • Use cases include API paywalls, dynamic pricing, server-side signing patterns, and cross-chain payments.

Quick Start

Install the @openfacilitator/sdk and integrate the middleware to protect endpoints using the 402 flow.

Frequently Asked Questions about openfacilitator

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

FAQPage Schema
How do I add crypto payments to an Express or Hono API?

To add crypto payments to an Express or Hono API, use middleware adapters that intercept requests and enforce the 402 payment flow. This injects payment context and handles verification automatically.

What are x402 payments and how do they work for API paywalls?

x402 payments monetize API access by returning a 402 status code that requires crypto payment. The workflow validates payment payloads and executes on-chain settlement to grant access.

Does the x402 payment flow support Solana and Base networks?

Yes, the x402 payment flow supports Solana and Base networks, alongside Ethereum and Stacks. It handles multi-network patterns with specific network mapping for cross-chain payments.

Can I implement dynamic pricing and refund protection with x402?

Yes, you can implement dynamic pricing and optional refund protection within the x402 workflow. The SDK provides helper utilities to configure pricing and secure settlement patterns.

How do I handle payment verification and retries for blockchain settlement?

You handle payment verification and retries using helper utilities that validate payment payloads and manage errors. The SDK supports both manual verify plus settle and server-side signing patterns.