Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# AI Agent Guidelines for OpenPayment
# AI Agent Guidelines for integrating OpenPayment SDK and CLI

OpenPayment lets you create x402 stablecoin payment links that settle in USDC on Base.
Links are hosted at [https://openpayment.link](https://openpayment.link).
Expand Down
1 change: 1 addition & 0 deletions CLAUDE.md
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

[![NPM Package](https://img.shields.io/npm/v/openpayment.svg?style=flat-square)](https://www.npmjs.org/package/openpayment)
[![CI](https://github.com/noncept/openpayment/actions/workflows/ci.yml/badge.svg)](https://github.com/noncept/openpayment/actions/workflows/ci.yml)
[![MIT licensed](https://img.shields.io/github/license/noncept/openpayment.svg)](https://github.com/noncept/openpayment/blob/main/LICENSE)
[![MIT licensed](https://img.shields.io/github/license/noncept/openpayment)](https://github.com/noncept/openpayment/blob/main/LICENSE)

## OpenPayment SDK + CLI

SDK and CLI for creating x402 stablecoin payment links that settle in USDC on Base.

Powered by OpenPayment on x402.
Powered by OpenPayment and x402.

## About OpenPayment Link
## About OpenPayment

OpenPayment lets merchants, creators, developers, and AI agents accept USDC payments with shareable payment links and APIs. 0% platform fees, instant settlement to recipient wallet, and no sign-up required. Powered by x402.

Expand Down
3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "openpayment",
"description": "OpenPayment SDK and CLI for creating x402 payment links",
"version": "0.1.0",
"version": "0.1.1",
"type": "module",
"private": true,
"main": "./dist/index.js",
Expand All @@ -18,6 +18,7 @@
},
"files": [
"dist",
"skills",
"AGENTS.md",
"README.md",
"LICENSE"
Expand Down
36 changes: 9 additions & 27 deletions skills/openpayment/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,30 +3,28 @@ name: openpayment
description: Create x402 stablecoin payment links using the OpenPayment CLI.
homepage: https://openpayment.link
# prettier-ignore
metadata: {"openclaw": {"emoji": "💸", "requires": {"bins": ["node"], "install": [{"id": "node", "kind": "node", "package": "openpayment", "bins": ["openpayment"], "label": "Install OpenPayment CLI (npm)"}]}}}
metadata: {"openclaw": {"emoji": "💸", "requires": {"bins": ["node"]}, "install": [{"id": "node", "kind": "node", "package": "openpayment", "bins": ["openpayment"], "label": "Install OpenPayment CLI (npm)"}]}}
---

# OpenPayment Skill

Creates x402 stablecoin payment links via the `openpayment` CLI. All links are hosted at **https://openpayment.link/** and settle in USDC on Base.
Creates x402 stablecoin payment links via the `openpayment` CLI.

All links are hosted at [OpenPayment](https://openpayment.link) and settle in USDC on Base.

Use this skill whenever a user wants to create a payment link, request a stablecoin payment, set up a crypto payment, generate a USDC payment URL, or mentions x402, OpenPayment, or wants to get paid in crypto/stablecoins on Base.
Trigger even if the user says things like "create a payment link", "I want to accept USDC", "generate a crypto payment request", "send me money in stablecoins", or "set up a blockchain payment".

## About OpenPayment Link
## About OpenPayment

OpenPayment lets merchants, creators, developers, and AI agents accept USDC payments with shareable payment links and APIs. 0% platform fees, instant settlement to recipient wallet, and no sign-up required. Powered by x402.

---

## Install

```bash
npm i -g openpayment
```

---

## Core Command

```bash
Expand Down Expand Up @@ -54,8 +52,6 @@ openpayment create \
| `--description` | Payment description (max 500 chars) |
| `--json` | Output as JSON instead of plain text |

---

## Payment Types

| Type | When to use |
Expand All @@ -66,8 +62,6 @@ openpayment create \

**Default to `SINGLE_USE`** unless the user specifies otherwise.

---

## Networks

| Network | Flag value | Description |
Expand All @@ -77,7 +71,7 @@ openpayment create \

**Default to `eip155:8453` (Base Mainnet)** unless the user says "test", "testnet", or "sepolia".

---
Support for other networks will be added soon.

## Currency

Expand All @@ -86,9 +80,7 @@ The default currency is **USDC**.
- Base Mainnet USDC: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- Base Sepolia USDC: `0x036CbD53842c5426634e7929541eC2318f3dCF7e`

Support for custom ERC-20 tokens will be added soon.

---
Support for other stablecoins and custom ERC-20 tokens will be added soon.

## Example Commands

Expand Down Expand Up @@ -147,8 +139,6 @@ openpayment create \
--json
```

---

## Output

**Plain text:**
Expand Down Expand Up @@ -185,8 +175,6 @@ Example:
}
```

---

## Workflow for Handling User Requests

1. **Identify missing info** you need: amount (`--price`), receiver wallet address (`--payTo`). Ask if not provided.
Expand All @@ -197,13 +185,11 @@ Example:

### What to ask if info is missing

- **No wallet address**: "What's recipient EVM wallet address (starting with 0x)?"
- **No wallet address**: "What's the recipient EVM wallet address (starting with 0x)?"
- **No amount**: "How much USDC should the payment be for?"
- **No type specified but context suggests multi-use**: "Should this link be single-use (one payment only) or reusable?", "Should the amount be fixed or editable?"
- **No network specified**: assume Base Mainnet; mention it in your response.

---

## Validation Rules (enforced by CLI before any API call)

- `--type`: must be `SINGLE_USE`, `MULTI_USE`, or `VARIABLE`
Expand All @@ -212,13 +198,9 @@ Example:
- `--network`: must be `eip155:8453` or `eip155:84532`
- `--description`: optional string, max 500 characters

---

## Security Notes

Never ask for or share user private keys.

---
Never ask for or share user private keys and secrets.

## Learn More

Expand Down