What makes x402 Singularity Layer notable?

1.7K downloads. Trust evidence available

How should x402 Singularity Layer be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

x402 Singularity Layer

This skill should be used when the user asks to "create x402 endpoint", "deploy monetized API", "pay for API with USDC", "check x402 credits", "consume API c...

OpenClaw

View on ClawHub

Rank

Safety

Downloads

1.7k

Updated

Apr 15, 2026

Version

1.2.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 4/15/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Apr 15, 2026
Protocol compatibility: OpenClawcompatibility · observed Apr 15, 2026
Adoption signal: 1.7K downloadsadoption · observed Apr 15, 2026
Latest release: 1.2.1release · observed Feb 27, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn73xndw522wt8y06avyd39a8h7ztbeh:x402-layer

Install using `clawhub skill install kn73xndw522wt8y06avyd39a8h7ztbeh:x402-layer` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/ivaavimusic/x402-layer before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-ivaavimusic-x402-layer/snapshot"

Documentation

CLAWHUB

63,431 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: x402-layer
version: 1.2.1
description: |
  This skill should be used when the user asks to "create x402 endpoint",
  "deploy monetized API", "pay for API with USDC", "check x402 credits",
  "consume API credits", "list endpoint on marketplace", "buy API credits",
  "topup endpoint", "browse x402 marketplace", "set up webhook",
  "receive payment notifications", "manage endpoint webhook",
  use "Coinbase Agentic Wallet (AWAL)", or manage x402 Singularity Layer
  operations on Base or Solana networks.
homepage: https://studio.x402layer.cc/docs/agentic-access/openclaw-skill
metadata:
  clawdbot:
    emoji: "⚡"
    homepage: https://studio.x402layer.cc
    os:
      - linux
      - darwin
    requires:
      bins:
        - python3
      env:
        # Core credentials (required for payments)
        - WALLET_ADDRESS
        - PRIVATE_KEY
        # Solana payments (required for Solana network)
        - SOLANA_SECRET_KEY
        # Provider operations (required for endpoint management)
        - X_API_KEY
        - API_KEY
        # AWAL mode (optional - for Coinbase Agentic Wallet)
        - X402_USE_AWAL
        - X402_AUTH_MODE
        - X402_PREFER_NETWORK
        - AWAL_PACKAGE
        - AWAL_BIN
        - AWAL_FORCE_NPX
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - WebFetch
---


# x402 Singularity Layer

x402 is a **Web3 payment layer** enabling AI agents to:
- 💰 **Pay** for API access using USDC
- 🚀 **Deploy** monetized endpoints
- 🔍 **Discover** services via marketplace
- 📊 **Manage** endpoints and credits
- 🔔 **Webhooks** — receive payment notifications

**Networks:** Base (EVM) • Solana  
**Currency:** USDC  
**Protocol:** HTTP 402 Payment Required

---

## Quick Start

### 1. Install Dependencies
```bash
pip install -r {baseDir}/requirements.txt
```

### 2. Set Up Wallet (Choose One Mode)

#### Option A: Private Keys (existing mode)
```bash
# For Base (EVM)
export PRIVATE_KEY="0x..."
export WALLET_ADDRESS="0x..."

# For Solana (optional)
export SOLANA_SECRET_KEY="[1,2,3,...]"  # JSON array
```

#### Option B: Coinbase Agentic Wallet (AWAL)

For Base payments without exposing private keys, use Coinbase Agentic Wallet:

```bash
# First, install and set up AWAL (one-time setup)
npx skills add coinbase/agentic-wallet-skills

# Then enable AWAL mode for this skill
export X402_USE_AWAL=1
```

> **Note**: See [Coinbase AWAL docs](https://docs.cdp.coinbase.com/agentic-wallet/welcome) for full setup instructions. You'll need to authenticate and fund your AWAL wallet with USDC on Base.

Once AWAL is configured, all Base payment scripts will automatically use it instead of PRIVATE_KEY.

---

## ⚠️ Security Notice

> **IMPORTANT**: This skill handles private keys for signing blockchain transactions.
>
> - **Never use your primary custody wallet** - Create a dedicated wallet with limited funds
> - **Private keys are used locally only** - They sign transactions locally and are never transmitted
> - **Signed payloads are sent to

_meta.json

{
  "ownerId": "kn73xndw522wt8y06avyd39a8h7ztbeh",
  "slug": "x402-layer",
  "version": "1.2.1",
  "publishedAt": 1772198367315
}

references/agentic-endpoints.md

# Agentic Endpoint Creation

Deploy your own monetized API endpoints programmatically.

## Endpoint
POST https://api.x402layer.cc/agent/endpoints

## Pricing
Create: $1 (4,000 credits included)
Top-up: $1 = 500 credits

## Create Flow
1. POST with endpoint config (name, slug, origin_url, chain)
2. Get 402 challenge
3. Sign with EIP-712
4. Send X-Payment header
5. Receive gateway URL and API key

## Top-Up
PUT /agent/endpoints/<slug> with topup_amount

## Check Status
GET /agent/endpoints/<slug> with x-api-key header

references/credit-based.md

# Credit-Based Access

For high-frequency or latency-sensitive API calls. Pre-purchase credits, consume instantly.

## Why Use Credits?

- Zero latency (no blockchain wait)
- Zero gas fees per request
- Simple header-based access

## Usage

### Check Balance
```bash
curl "https://api.x402layer.cc/api/credits/balance?endpoint=<slug>" \
  -H "x-wallet-address: 0xYourWallet..."
```

### Consume Endpoint
```bash
curl "https://api.x402layer.cc/e/<slug>" \
  -H "x-wallet-address: 0xYourWallet..." \
  -H "Content-Type: application/json" \
  -d "{\"prompt\": \"your request\"}"
```

### Insufficient Credits Response
When out of credits, you get a 402 with purchase options:

```json
{
  "error": "Insufficient credits",
  "current_balance": 0,
  "purchase_url": "https://studio.x402layer.cc/pay/credits/<slug>",
  "credit_package": {"size": 69, "price": 0.01},
  "accepts": [...]
}
```

## Purchasing Credits

Use the standard 402 flow on the `purchase_url`:

1. GET the purchase URL
2. Parse 402 challenge  
3. Sign EIP-712 payment
4. Send with X-Payment header
5. Credits added to wallet

## Example Python

```python
import requests

def call_with_credits(url, wallet, data):
    resp = requests.post(url, 
        json=data,
        headers={"x-wallet-address": wallet})
    
    if resp.status_code == 402:
        print("Need credits!", resp.json()["purchase_url"])
        return None
    
    return resp.json()
```

## Scripts

- `check_credits.py` - Query balance
- `consume_with_credits.py` - Use credits
- `recharge_credits.py` - Top up via payment

references/marketplace.md

# Marketplace Discovery

Browse, search, and consume x402 marketplace services.

## Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/marketplace` | GET | List all public listings |
| `/api/marketplace/search?q=<term>` | GET | Search by keyword |
| `/api/marketplace/featured` | GET | Featured listings |
| `/api/marketplace/<slug>` | GET | Single endpoint details |
| `/api/marketplace/list` | POST | List endpoint (provider) |
| `/api/marketplace/unlist` | POST | Remove from marketplace |

## Categories
`ai`, `data`, `finance`, `utility`, `social`, `gaming`

## Example: Browse All

```bash
python discover_marketplace.py
```

## Example: Consume Found Service

```bash
# Get details for an endpoint
python discover_marketplace.py details weather-api

# Pay and consume
python pay_base.py https://api.x402layer.cc/e/weather-api
```

## Scripts

- `discover_marketplace.py` - Browse/search marketplace
- `list_on_marketplace.py` - List/unlist your endpoint

Github ReposUpdated 8h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.