Skip to content

ivaavimusic/SGL_DOCS_2025

Repository files navigation

x402 Singularity Layer Documentation

x402 Singularity Layer

Version 1.0.0 ClawHub Skill Network: Base Network: Solana Network: Ethereum Network: Polygon Network: BSC Network: Monad Currency: USDC

Internet's unified commerce layer for Homo-Agentic economy.
Powered by EventHorizon Labs


🚀 Quick Install (For AI Agents)

Install the x402-layer skill with a single command:

Option 1: ClawHub (Recommended)

ClawHub

clawhub install ivaavimusic/x402-layer

Option 2: Self-hosted

curl -fsSL https://api.x402layer.cc/skill/x402-layer/install | bash

Or specify a custom directory:

curl -fsSL https://api.x402layer.cc/skill/x402-layer/install | bash -s ./my-skills/x402-layer

Skill API Endpoints

Endpoint Description
/skill/x402-layer JSON manifest with file list
/skill/x402-layer/install Shell install script
/skill/x402-layer/SKILL.md Main skill instructions
/skill/x402-layer/requirements.txt Python dependencies
/skill/x402-layer/scripts/{name}.py Individual Python scripts

Overview

Welcome to the official documentation for x402 Singularity Layer (SGL). This repository contains guides, API references, and architectural details for integrating with the x402 ecosystem.

x402 Studio is the primary tool for developers to create, manage, and monitor their endpoints. Use the Studio to generate API keys, configure payments, and view analytics.

Launch x402 Studio

Documentation Structure

Our documentation is organized into the following sections:

For developers and creators getting started with x402.

  • Getting Started: Initial setup and concepts.
  • Creating Endpoints: How to deploy your first monetized endpoint.
  • Wallet Connection: Managing identities and payments.

Technical details for AI agents and programmatic access.

  • Introduction: How agents interact with the protocol.
  • Pay-Per-Request: Direct 402 payment flow with EIP-712.
  • Credit-Based Access: High-speed credit consumption.
  • Marketplace API: Service discovery protocol.
  • Agent Management: Programmatic endpoint control.
  • OpenClaw Skill: Production-ready skill for OpenClaw agents.
  • Singularity Skill: Portable full-platform skill for skills.sh-compatible agents.
  • x402 Compute Skill: Provision and manage VPS/GPU compute with x402 payments.

Production-ready skill for OpenClaw agents covering payments, endpoint ops, webhooks, and agent registry flows:

Script Purpose
pay_base.py Pay for endpoints on Base (recommended default)
pay_solana.py Pay for endpoints on Solana with the sponsored PayAI flow
consume_credits.py Use pre-purchased credits (fastest)
consume_product.py Purchase digital products (files)
check_credits.py Check your credit balance
recharge_credits.py Buy credit packs (Consumer)
topup_endpoint.py Add credits to YOUR endpoint (Provider)
create_endpoint.py Deploy new monetized endpoint ($1)
manage_endpoint.py View/update your endpoints
discover_marketplace.py Browse available services
list_on_marketplace.py Publish endpoint publicly

Core Concepts

  • Endpoints: Monetizable APIs or assets protected by x402.
  • Agents: AI entities capable of rigorous commerce.
  • Payment Facilitator: The transparent middleware handling crypto transitions.

Contributing

We welcome contributions! Please open an issue or submit a pull request for any improvements.


x402 Icon

© 2025 EventHorizon Labs. All rights reserved.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors