SkillsAdd

miraland-labs/x402-agent-skills · Archived

pr402

>- Entry point for x402 integrations on Solana via pr402 (ipay.sh). Use when the user mentions pr402, x402 on Solana, ipay.sh, agentic payments, or HTTP 402 but the role (seller vs buyer) is unclear — or when orienting before picking a stack. Route to pr402-seller for monetizing APIs and pr402-buyer for paying agents. Do not implement seller or buyer flows here; hand off to the specialist skill.

Installation

$ npx skills add miraland-labs/x402-agent-skills --skill pr402
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

pr402-buyer Same source · more installs
miraland-labs/x402-agent-skills

>- Integrate an x402 buyer agent on Solana via pr402 (ipay.sh): HTTP 402 challenges, build-exac…

31 installs
pr402-seller Same source · more installs
miraland-labs/x402-agent-skills

>- Integrate an x402 seller on Solana via pr402 (ipay.sh): HTTP 402 gates, SplitVault onboardin…

23 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from miraland-labs/x402-agent-skills.

npx skills add miraland-labs/x402-agent-skills
pr402-buyer 31 pr402-seller 23

Browse all from miraland-labs/x402-agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License LICENSE
Default branch main
Open issues 1
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.1.0
More metadata
author
miraland-labs
version
1.1.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,459 B
  • docs SUMMARY.md 410 B

History

  1. First recorded snapshot · 14 installs

SKILL.md

pr402 (x402 on Solana)

Router skill only. Orient the user, pick seller vs buyer, then continue in the specialist skill — do not implement gates, payments, or SDK wiring in this file.

Choose a path

User goal Load / install Starter repo
Monetize an HTTP API (402 gate, SplitVault, discovery) pr402-seller x402-seller-starter
Subscription API (hourly/daily/monthly on exact) pr402-seller → subscription reference x402-subscription-starter
Build a paying agent (402 challenge → pay → retry with proof) pr402-buyer x402-buyer-starter
Buy subscription access (pay /subscribe → Bearer JWT) pr402-buyer → subscription reference x402-subscription-client
Both seller and buyer in one product Install both specialist skills Both starters above
Conditional delivery / oracle escrow Stop — sla-escrow rail + oracles Not covered by default integrator skills

Default rail for new integrators: exact (SplitVault instant settlement via pr402). Treat sla-escrow as a separate path.

Install (skills CLI)

All integrator skills (-y), or one at a time (interactive):

npx skills add miraland-labs/x402-agent-skills --skill pr402 --skill pr402-seller --skill pr402-buyer -y
npx skills add miraland-labs/x402-agent-skills --skill pr402
npx skills add miraland-labs/x402-agent-skills --skill pr402-seller
npx skills add miraland-labs/x402-agent-skills --skill pr402-buyer

List all skills in this repo:

npx skills add miraland-labs/x402-agent-skills --list

Skills.sh listing: miraland-labs/x402-agent-skills.

Shared production defaults

URL
Facilitator (Mainnet) https://ipay.sh
Facilitator API prefix /api/v1/facilitator
Devnet / preview testing https://preview.ipay.sh
Canonical runbook ipay.sh/agent-integration.md
OpenAPI ipay.sh/openapi.json
MCP tool catalog ipay.sh/agent-tools.json

GitHub layout (virtual hub)

The x402 hub coordinates docs and x402-cli only. Clone each project from its own repo:

Project GitHub
pr402 SDK / MCP source miralandlabs/pr402 (individual account — not miraland-labs)
Seller starter miraland-labs/x402-seller-starter
Buyer starter miraland-labs/x402-buyer-starter
Agent skills (this repo) miraland-labs/x402-agent-skills
Oracles / escrow miraland-labs/oracles
Subscription seller starter miraland-labs/x402-subscription-starter
Subscription buyer SDK miraland-labs/x402-subscription-client
Subscription auth (Tier B) miralandlabs/subscription-auth

Agent workflow

  1. Clarify role — seller (accepts USDC for API calls) vs buyer (pays for API calls) vs both.
  2. Hand off — open pr402-seller or pr402-buyer (install if missing) for step-by-step implementation.
  3. Prefer starters + published SDK/MCP over hand-rolling verify/settle payloads unless debugging.
  4. Never commit keypairs — merchant/payer secrets via env vars outside the repo.
  5. Forge marketplace (digital goods) — buyer path may use @http402/forge-client; see pr402-buyer references.

Quick pointers (not full runbooks)

Need Where
Seller onboarding CLI pr402-seller → references/onboarding-cli.md
Seller runtime SDK gate pr402-seller → references/runtime-sdk.md
Buyer MCP / createPay402Fetch pr402-buyer → references/mcp-and-sdk.md
Buyer HTTP 402 retry flow pr402-buyer → references/exact-payment-flow.md
Subscription seller (JWT window on exact) pr402-seller → references/subscription-exact-rail.md
Subscription buyer (subscribe + Bearer) pr402-buyer → references/subscription-client.md
Forge purchases pr402-buyer → references/forge-marketplace.md

Related skills

  • pr402-seller — monetize HTTP APIs
  • pr402-buyer — paying agents and MCP hosts