x402 Singularity Layer

x402-layer helps agents pay for APIs with USDC, deploy monetized endpoints, manage credits/webhooks/marketplace listings, and handle wallet-first ERC-8004 registration/discovery/management/reputation on Base, Ethereum, Polygon, BSC, Monad, and Solana. Optional credentialed flows may use private keys, Solana signer keys, endpoint API keys, PATs, AWAL, or OWS depending on the exact runbook; read-only discovery requires no secrets. Only ask for or use privileged credentials after choosing a runbook that actually needs signing or owner-scoped writes. Use this skill 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", "verify webhook payment", "verify payment genuineness", "integrate crypto payments into my app", "add USDC payments to my platform", "sell with x402", "build a paywall with webhooks", "register ERC-8004 agent", "register Solana 8004 agent", "submit on-chain reputation feedback", "rate ERC-8004 agent", "use World AgentKit", "unlock human-backed agent wallet discount", "check if an endpoint has an AgentKit benefit", "add API schema to endpoint", "document my API routes", "auto-detect OpenAPI schema", "open support chat", use "Coinbase Agentic Wallet (AWAL)", "OpenWallet", "OWS", "openwallet.sh", or use optional Singularity MCP access with a dashboard PAT to manage x402 Singularity Layer operations on Base, Ethereum, Polygon, BSC, Monad, or Solana networks. Also use this skill to stake $SGL agentically: "stake SGL", "stake $SGL", "unstake SGL", "claim staking rewards", "check my staking position", "stake to run a node", "agentic staking" — sign and submit on-chain Solana staking transactions with a wallet keypair.

Ivaavi.eth@ivaavimusic

Install

openclaw skills install @ivaavimusic/x402-layer

x402 Singularity Layer

x402 is a Web3 payment layer where humans and agents can sell and consume APIs, products, and credits. This skill can sign wallet messages, submit on-chain transactions, call x402/studio APIs, and manage monetized endpoint infrastructure. Sensitive credentials are only needed for specific capability paths, not for baseline installation or read-only discovery. This skill covers the full Singularity Layer lifecycle:

pay/consume services
create/manage/list endpoints
integrate custom payment flows into an app or platform
receive and verify webhook payment events
register agents and submit on-chain reputation feedback
optionally use Singularity MCP for owner-scoped dashboard and control-plane actions

Networks: Base, Ethereum, Polygon, BSC, Monad, Solana
Currency: USDC
Protocol: HTTP 402 Payment Required

Security-first usage: No secret environment variable is universally required for installation. Set only the minimum variables needed for the exact runbook you are using. Prefer AWAL, OWS, API keys, or ephemeral wallets over long-lived mainnet private keys whenever possible.

Execution scope: For discovery, docs, and listing inspection, stay on the no-secret path first. Only use private keys, Solana signer keys, endpoint API keys, PATs, or support tokens when the user explicitly wants signing, webhook management, support auth, or owner-scoped control-plane actions.

Expected network/binary surface: api.x402layer.cc, studio.x402layer.cc, mcp.x402layer.cc, and local awal / ows binaries when those wallet modes are explicitly enabled.

Intent Router

Use this routing first, then load the relevant reference doc.

User intent	Primary path	Reference
Integrate crypto payments into an app/platform	`create_endpoint.py`, `manage_webhook.py`, `verify_webhook_payment.py`, `consume_product.py`, `recharge_credits.py`	`references/payments-integration.md`, `references/webhooks-verification.md`, `references/agentic-endpoints.md`
Pay/consume endpoint or product	`pay_base.py`, `pay_solana.py`, `consume_credits.py`, `consume_product.py`, `ows_cli.py`	`references/pay-per-request.md`, `references/credit-based.md`, `references/agentkit-benefits.md`, `references/openwallet-ows.md`
Discover/search marketplace	`discover_marketplace.py`	`references/marketplace.md`, `references/agentkit-benefits.md`
Create/edit/list endpoint	`create_endpoint.py`, `manage_endpoint.py`, `list_on_marketplace.py`, `topup_endpoint.py`	`references/agentic-endpoints.md`, `references/marketplace.md`, `references/agentkit-benefits.md`
Add or update API schema for an endpoint	`create_endpoint.py --schema-file`, `manage_endpoint.py update --schema-file`	`references/agentic-endpoints.md`
Manage dashboard/platform control plane with PAT-backed MCP access or owner-linked dashboard API keys	`manage_campaign.py`, `manage_endpoint.py`, `manage_webhook.py`, plus `Singularity MCP` tools such as `list_my_endpoints`, `list_my_campaigns`, `create_campaign`, `update_campaign`, `update_endpoint`, `list_my_products`, `update_product`, `set_webhook`, `remove_webhook`, `request_endpoint_creation_payment`	`references/mcp-control-plane.md`, `references/agentic-endpoints.md`, `references/marketplace.md`
Configure/verify webhooks	`manage_webhook.py`, `verify_webhook_payment.py`	`references/webhooks-verification.md`
Register/discover/manage/rate agents (ERC-8004/Solana-8004)	`register_agent.py`, `list_agents.py`, `list_my_endpoints.py`, `update_agent.py`, `submit_feedback.py`	`references/agent-registry-reputation.md`
Human-backed agent wallet benefits (World AgentKit)	`pay_base.py`, `discover_marketplace.py`	`references/agentkit-benefits.md`
Support and buyer/seller messaging	`support_auth.py`, `support_threads.py`, `xmtp_support.mjs`	`references/xmtp-support.md`
Use OpenWallet / OWS as an optional wallet backend	`ows_cli.py`	`references/openwallet-ows.md`, `references/pay-per-request.md`, `references/payment-signing.md`
Stake/unstake/claim $SGL, read staking position/analytics	`stake_sgl.py`	`references/staking.md`

Quick Start

1) Install Skill Dependencies

bash

pip install -r {baseDir}/requirements.txt

2) Choose Wallet Mode

Option A: private keys

bash

export PRIVATE_KEY="0x..."
export WALLET_ADDRESS="0x..."
# Solana optional
export SOLANA_SECRET_KEY="base58-or-[1,2,3,...]"

Option B: Coinbase AWAL

bash

# Install Coinbase AWAL skill (shortcut)
npx skills add coinbase/agentic-wallet-skills
export X402_USE_AWAL=1

Option C: OpenWallet / OWS

bash

npm install -g @open-wallet-standard/core
export OWS_WALLET="hackathon-wallet"

Use private-key mode for deep ERC-8004 registration and any on-chain update path that still needs direct transaction signing. AWAL remains useful for x402 payment flows. OWS is optional-first for pay/discover/sign-message flows plus wallet-auth list/support flows through ows_cli.py and the shared wallet helpers. Do not export every credential shown above at once. Pick one wallet path and only the extra control-plane credentials the selected runbook needs.

3) Optional Dashboard / MCP Mode

If the user provides a dashboard PAT, the agent can also use Singularity MCP for owner-scoped account actions:

bash

export SINGULARITY_PAT="sgl_pat_..."

Use MCP when the task is about:

listing all endpoints or products owned by the dashboard user
listing or managing fundraiser campaigns owned by the dashboard user
updating endpoint or product settings
setting or removing webhooks
requesting endpoint creation or top-up payment challenges in an owner-scoped way

Keep the direct scripts for:

actual request payments and local signing
AWAL-driven pay/discover flows
OWS-driven pay/discover/sign-message flows
support and XMTP flows
wallet-first ERC-8004 / Solana-8004 registration and updates

4) Optional Dashboard API Key Mode

If the user already has an owner-linked dashboard API key, the direct worker management routes can also be used without MCP:

bash

export X_API_KEY="x402_..."

# Direct worker management with owner-linked API key
python {baseDir}/scripts/manage_campaign.py list
python {baseDir}/scripts/manage_campaign.py create --title "My Campaign" --wallet <SOLANA_WALLET> --target 1000
python {baseDir}/scripts/manage_endpoint.py info my-api

Use the direct API-key path when the task is about:

existing dashboard/agent management routes on api.x402layer.cc
endpoint and webhook operations through the worker API
fundraiser campaign management through /agent/campaigns
environments that already have an owner-linked X-API-Key but do not need MCP

Security note: scripts read only explicit process environment variables. .env files are not auto-loaded. Least-privilege note: the skill supports multiple credential types, but no single runbook needs all of them. Read-only discovery needs no secrets. PAT, API-key, AWAL, OWS, EVM, and Solana signing flows should be treated as separate capability paths, and users should set only the smallest subset required for the task in front of them. Risk note: this skill can sign messages, submit transactions, and call x402/studio APIs. Prefer AWAL, OWS, PATs, endpoint API keys, or throwaway wallets over long-lived private keys when possible.

Script Inventory

Consumer

Script	Purpose
`pay_base.py`	Pay endpoint on Base, with optional AgentKit benefit flow
`pay_solana.py`	Pay endpoint on Solana
`consume_credits.py`	Consume using credits
`consume_product.py`	Purchase digital products/files
`check_credits.py`	Check credit balance
`recharge_credits.py`	Buy endpoint credit packs
`discover_marketplace.py`	Browse/search marketplace and inspect AgentKit benefits
`support_auth.py`	Authenticate a wallet for support APIs
`support_threads.py`	Check support eligibility, open/list/show/close/reopen support threads
`xmtp_support.mjs`	Send and read XMTP support messages for a support thread
`awal_cli.py`	Run AWAL auth/pay/discover commands
`ows_cli.py`	Run OpenWallet / OWS wallet, pay, discover, sign-message, and agent-key commands

Provider

Script	Purpose
`create_endpoint.py`	Deploy endpoint ($1 one-time, includes 4,000 credits), optional `--schema-file` for API docs
`manage_campaign.py`	List/create/update fundraiser campaigns via the owner-scoped worker API
`manage_endpoint.py`	List/update endpoint settings (including API schema)
`topup_endpoint.py`	Recharge provider endpoint credits
`list_on_marketplace.py`	List/unlist/update marketplace listing
`manage_webhook.py`	Set/remove/check endpoint webhook URL
`verify_webhook_payment.py`	Verify webhook signature + receipt genuineness (PyJWT/JWKS)

Agent Registry + Reputation

Script	Purpose
`register_agent.py`	Register ERC-8004/Solana-8004 agent with image/version/tags and endpoint binding support
`list_agents.py`	List ERC-8004 agents owned by the configured wallet or linked dashboard user
`list_my_endpoints.py`	List platform endpoints that can be linked to ERC-8004 agents
`update_agent.py`	Update existing ERC-8004/Solana-8004 agent metadata, visibility, and endpoint bindings
`submit_feedback.py`	Submit on-chain reputation feedback

Staking

Script	Purpose
`stake_sgl.py`	Agentic $SGL staking: stake / unstake / claim-unstake / claim rewards, and read positions + analytics. Non-custodial prepare→sign→submit with `SOLANA_SECRET_KEY`. See `references/staking.md`.

Core Security Requirements

API Key Verification at Origin (mandatory)

When x402 proxies traffic to your origin, verify:

http

x-api-key: <YOUR_API_KEY>

Reject requests when missing/invalid.

Credit Economics (provider side)

Endpoint creation: $1 one-time
Starting credits: 4,000
Top-up rate: 500 credits per $1
Consumption: 1 credit per request
If credits hit 0, endpoint stops serving until recharged

Safety: actions that spend, sign, or are irreversible

This skill can move funds, sign blockchain transactions, and change account resources. Review the action before running it, and prefer low-balance or delegated wallets and scoped keys.

Spends funds / pays: pay_base.py, pay_solana.py, recharge_credits.py, topup_endpoint.py, consume_product.py, consume_credits.py. These build and submit a payment after a 402 challenge — confirm the amount and the destination URL first.
Signs / submits on-chain transactions: register_agent.py, update_agent.py, submit_feedback.py, stake_sgl.py, ows_cli.py sign-message. Only point them at trusted base URLs; a prepared transaction from an untrusted host could authorize unintended state changes.
Irreversible / account-scoped: manage_endpoint.py delete, manage_webhook.py remove, and xmtp_support.mjs revoke-others (revokes other XMTP installations). Double-check before running.

Guidance:

Use a dedicated, low-balance / delegated wallet and scoped API keys/PATs.
Never paste private keys into chats, logs, or shared/CI terminals; scripts read secrets only from explicit env vars and never auto-load .env.
Endpoint creation returns a public gateway URL and a sensitive API key (used for origin verification) — treat the key as a secret and expect the URL to be publicly reachable.
Wallet addresses are public but still privacy-sensitive — they link your on-chain activity. The skill only sends them to the configured x402 host.

Fast Runbooks

A) Integrate Payments Into Your App

bash

# 1. Create or reuse a paid endpoint
python {baseDir}/scripts/create_endpoint.py my-api "My API" https://api.example.com 0.01

# 2. Add server-side fulfillment
python {baseDir}/scripts/manage_webhook.py set my-api https://my-server.com/webhook

# 3. Verify webhook signatures and payment receipts server-side
python {baseDir}/scripts/verify_webhook_payment.py \
  --body-file ./webhook.json \
  --signature 't=1700000000,v1=<hex>' \
  --secret '<YOUR_SIGNING_SECRET>' \
  --required-source-slug my-api \
  --require-receipt

B) Pay and Consume

bash

python {baseDir}/scripts/pay_base.py https://api.x402layer.cc/e/weather-data
python {baseDir}/scripts/pay_base.py https://api.x402layer.cc/e/weather-data --agentkit auto
python {baseDir}/scripts/pay_solana.py https://api.x402layer.cc/e/weather-data
python {baseDir}/scripts/consume_credits.py https://api.x402layer.cc/e/weather-data

# Optional OWS backend
python {baseDir}/scripts/ows_cli.py pay-url https://api.x402layer.cc/e/weather-data --wallet hackathon-wallet

C) Discover/Search Marketplace

bash

python {baseDir}/scripts/discover_marketplace.py
python {baseDir}/scripts/discover_marketplace.py search weather
python {baseDir}/scripts/discover_marketplace.py details weather-api

# Optional OWS discovery path
python {baseDir}/scripts/ows_cli.py discover weather

D) Create and Manage Endpoint

bash

python {baseDir}/scripts/create_endpoint.py my-api "My API" https://api.example.com 0.01
python {baseDir}/scripts/manage_endpoint.py list
python {baseDir}/scripts/manage_endpoint.py update my-api --price 0.02
python {baseDir}/scripts/topup_endpoint.py my-api 10

E) List/Update in Marketplace

bash

python {baseDir}/scripts/list_on_marketplace.py my-api \
  --category ai \
  --description "AI-powered analysis" \
  --logo https://example.com/logo.png \
  --banner https://example.com/banner.jpg

F) Webhook Setup and Genuineness Verification

bash

python {baseDir}/scripts/manage_webhook.py set my-api https://my-server.com/webhook
python {baseDir}/scripts/manage_webhook.py info my-api
python {baseDir}/scripts/manage_webhook.py remove my-api

Studio seller webhooks are HMAC-signed. Expect:

X-X402-Signature
X-X402-Timestamp
X-X402-Event
X-X402-Event-Id

Verify HMAC-SHA256(timestamp + "." + rawBody) with the webhook signing_secret. Keep legacy raw-secret header checks only as backward-compatibility fallback for older receivers.

Metadata passthrough: Any query parameter on the payment URL (e.g. ?order_id=123) is automatically included in the webhook metadata field. Use ?client_reference_id= for a dedicated top-level correlation field. See references/webhooks-verification.md for the full payload schema and limits.

Webhook verification helper:

bash

python {baseDir}/scripts/verify_webhook_payment.py \
  --body-file ./webhook.json \
  --signature 't=1700000000,v1=<hex>' \
  --secret '<YOUR_SIGNING_SECRET>' \
  --required-source-slug my-api \
  --require-receipt

G) World AgentKit Benefits

bash

# Inspect whether a listing advertises a verified human-backed agent wallet benefit
python {baseDir}/scripts/discover_marketplace.py details weather-data

# Attempt Base payment with AgentKit if the endpoint advertises a benefit
python {baseDir}/scripts/pay_base.py https://api.x402layer.cc/e/weather-data --agentkit auto

# Require AgentKit qualification instead of silently falling back
python {baseDir}/scripts/pay_base.py https://api.x402layer.cc/e/weather-data --agentkit required

H) XMTP Support Threads

bash

# Authenticate the current wallet for support APIs
python {baseDir}/scripts/support_auth.py login

# Check whether support is available for a listing
python {baseDir}/scripts/support_threads.py eligibility endpoint weather-data

# Open or reuse the support thread
python {baseDir}/scripts/support_threads.py open endpoint weather-data

# Read and send XMTP messages for a support thread
node {baseDir}/scripts/xmtp_support.mjs messages <thread_id>
node {baseDir}/scripts/xmtp_support.mjs send <thread_id> "Need help with this endpoint"

H2) OpenWallet / OWS

bash

# List local OWS wallets
python {baseDir}/scripts/ows_cli.py wallet-list

# Sign a message without exporting a raw private key
python {baseDir}/scripts/ows_cli.py sign-message --chain ethereum --wallet hackathon-wallet --message "hello"

# Create an OWS agent API key
python {baseDir}/scripts/ows_cli.py key-create --name codex-agent --wallet hackathon-wallet

OWS now works well for wallet lookup, challenge signing, marketplace discovery, support auth, and wallet-auth list flows. Deep ERC-8004 registration and on-chain agent update transactions still require direct signing keys.

I) MCP Owner-Scoped Control Plane

bash

# Set a dashboard PAT only for owner-scoped control-plane actions
export SINGULARITY_PAT="sgl_pat_..."

# Then use Singularity MCP for owner inventory/config operations such as:
# - list_my_endpoints
# - list_my_campaigns
# - create_campaign
# - update_campaign
# - update_endpoint
# - list_my_products
# - update_product
# - set_webhook
# - remove_webhook
# - request_endpoint_creation_payment

I2) Direct Dashboard API Key Management

bash

# If you already have an owner-linked dashboard API key, you can use direct worker routes too
export X_API_KEY="x402_..."

python {baseDir}/scripts/manage_campaign.py list
python {baseDir}/scripts/manage_campaign.py create --title "My Campaign" --wallet <SOLANA_WALLET> --target 1000
python {baseDir}/scripts/manage_campaign.py update my-campaign-slug --title "Updated Campaign"

J) API Schema Documentation

bash

# Attach schema at creation
python {baseDir}/scripts/create_endpoint.py my-api "My API" https://api.example.com 0.01 \
  --schema-file schema.json

# Update schema on existing endpoint
python {baseDir}/scripts/manage_endpoint.py update my-api --schema-file updated-schema.json

# Clear schema
python {baseDir}/scripts/manage_endpoint.py update my-api --clear-schema

Schema format: {"version": 1, "routes": [...]} with each route specifying path, method, summary, parameters (name/in/type/required/example), optional requestBody, and optional responseExample. See references/agentic-endpoints.md for the full format.

When set, the schema:

displays on marketplace listings
is included in 402 challenge responses for programmatic discovery
powers the interactive API tester on hosted pay pages

K) Agent Registration + Reputation

bash

python {baseDir}/scripts/list_my_endpoints.py

python {baseDir}/scripts/register_agent.py \
  "My Agent" \
  "Autonomous service agent" \
  --network baseSepolia \
  --image https://example.com/agent.png \
  --version 1.10.0 \
  --tag finance \
  --tag automation \
  --endpoint-id <ENDPOINT_UUID> \
  --custom-endpoint https://api.example.com/agent

python {baseDir}/scripts/list_agents.py --network baseSepolia

python {baseDir}/scripts/update_agent.py \
  --network baseSepolia \
  --agent-id 123 \
  --version 1.4.1 \
  --tag finance \
  --tag automation \
  --endpoint-id <ENDPOINT_UUID> \
  --public

# The same EVM flow also supports:
#   --network ethereum
#   --network polygon
#   --network bsc
#   --network monad

python {baseDir}/scripts/submit_feedback.py \
  --network base \
  --agent-id 123 \
  --rating 5 \
  --comment "High quality responses"

References

Load only what is needed for the user task:

references/payments-integration.md: product-vs-endpoint-vs-credits decision guide plus webhook/receipt fulfillment patterns.
references/pay-per-request.md: EIP-712/Solana payment flow and low-level signing details.
references/credit-based.md: credit purchase + consumption behavior and examples.
references/marketplace.md: search/list/unlist marketplace endpoints.
references/agentkit-benefits.md: discover, qualify for, and pay with World AgentKit human-backed agent wallet benefits.
references/agentic-endpoints.md: endpoint creation/top-up/status API behavior.
references/webhooks-verification.md: webhook events, signature verification, and receipt cross-checks.
references/agent-registry-reputation.md: ERC-8004/Solana-8004 registration, discovery, management, and feedback rules.
references/xmtp-support.md: how support chat works in Studio, what needs human setup, and how agents should coordinate with users.
references/mcp-control-plane.md: when to use Singularity MCP, what PAT scopes are needed, and which owner-scoped actions should prefer MCP over direct scripts.
references/openwallet-ows.md: optional OpenWallet / OWS wallet backend guidance, install commands, and current scope.
references/payment-signing.md: exact signing domains/types/header payload details.

Environment Reference

No single task needs every variable below. Use least privilege and set only what the current script requires.

Credential Path Rule

Choose the smallest path that fits the task:

No-secret discovery: marketplace browsing and public listing inspection
Endpoint / dashboard API key: direct endpoint, listing, webhook, and worker campaign management
PAT / MCP: owner-scoped dashboard inventory and MCP control-plane operations
AWAL / OWS: delegated wallet auth or pay/discover/sign-message flows
Direct private keys: deep wallet-first registration, on-chain updates, or flows that still require local transaction signing

Common

Variable	Used by	Notes
`WALLET_ADDRESS`	most Base/EVM flows	primary wallet address
`PRIVATE_KEY`	Base private-key mode, support auth, XMTP helper	EVM signing key
`X402_USE_AWAL`	AWAL mode	set `1`
`X402_AUTH_MODE`	auth selection	`auto`, `private-key`, `awal`
`X402_PREFER_NETWORK`	network selection	`base`, `solana`
`X402_AGENTKIT_MODE`	optional AgentKit behavior	`off`, `auto`, `required`
`X402_API_BASE`	API override	default `https://api.x402layer.cc`
`OWS_WALLET`	OWS wrapper flows	wallet name or ID for `ows_cli.py`
`OWS_BIN`	OWS wrapper flows	optional explicit path to the `ows` executable

Optional MCP Control Plane

Variable	Used by	Notes
`SINGULARITY_PAT`	Singularity MCP owner-scoped management flows	optional PAT in `sgl_pat_*` format; not required for install or normal script usage

Provider and Marketplace Management

Variable	Used by	Notes
`X_API_KEY`	endpoint/webhook/listing/fundraiser management	direct worker API key; owner-linked keys can manage campaigns too
`API_KEY`	fallback for management scripts	interchangeable fallback with `X_API_KEY`

Solana

Variable	Used by	Notes
`SOLANA_SECRET_KEY`	Solana private-key mode	base58 secret or JSON array bytes
`SOLANA_WALLET_ADDRESS`	Solana override and listing helpers	optional
`WALLET_ADDRESS_SECONDARY`	dual-chain endpoint mode	optional

Support and XMTP

Variable	Used by	Notes
`SUPPORT_AGENT_TOKEN`	support thread scripts	optional reuse of prior login
`X402_STUDIO_BASE_URL`	`support_auth.py`, `support_threads.py`	optional Studio API base override
`X402_API_BASE_URL`	support thread scripts	default `https://api.x402layer.cc`
`XMTP_ENV`	`xmtp_support.mjs`	default `production`
`XMTP_DB_PATH`	`xmtp_support.mjs`	optional persistent DB path override

Agent Registry and Feedback

Variable	Used by	Notes
`WORKER_FEEDBACK_API_KEY`	`submit_feedback.py`	only needed for reputation feedback writes
`BASE_RPC_URL` and other chain RPC URLs	`register_agent.py`	optional RPC overrides for agent registration

API Base Paths

Endpoints: https://api.x402layer.cc/e/{slug}
Marketplace: https://api.x402layer.cc/api/marketplace
Credits: https://api.x402layer.cc/api/credits/*
Agent routes: https://api.x402layer.cc/agent/*
MCP: https://mcp.x402layer.cc/mcp

Resources

Docs: https://docs.x402layer.cc/agentic-access/openclaw-skill
MCP docs: https://studio.x402layer.cc/docs/agentic-access/mcp-server
SDK docs: https://studio.x402layer.cc/docs/developer/sdk-receipts
GitHub docs repo: https://github.com/ivaavimusic/SGL_DOCS_2025
x402 Studio: https://studio.x402layer.cc

Known Issue

Solana exact-payment flows must use the feePayer returned by the challenge and keep the transaction compute-unit limit within facilitator requirements. pay_solana.py and solana_signing.py handle this for the current PayAI-backed flow; prefer Base when you need the simplest production path.

OpenWallet / OWS support is optional-first in this release: use it for pay/discover/sign-message flows and wallet-auth list/support flows, but keep private-key mode for deep wallet-first registration and on-chain update transaction paths. OWS execution now requires a local ows binary (or OWS_BIN) instead of fetching code on demand via runtime npx.

Credential safety

This skill supports many optional workflows, so it can work with many credential types. That does not mean you should set all of them.

Preferred order of safety when possible:

Read-only discovery with no secrets
Endpoint API keys or PATs for scoped control-plane actions
AWAL or OWS for delegated/local wallet access
Dedicated throwaway private keys for direct signing

Do not export a long-lived high-value custody wallet into the environment just to browse, inspect, or test small flows.

x402 Singularity Layer

Install

x402 Singularity Layer

Intent Router

Quick Start

1) Install Skill Dependencies

2) Choose Wallet Mode

3) Optional Dashboard / MCP Mode

4) Optional Dashboard API Key Mode

Script Inventory

Consumer

Provider

Agent Registry + Reputation

Staking

Core Security Requirements

API Key Verification at Origin (mandatory)

Credit Economics (provider side)

Safety: actions that spend, sign, or are irreversible

Fast Runbooks

A) Integrate Payments Into Your App

B) Pay and Consume

C) Discover/Search Marketplace

D) Create and Manage Endpoint

E) List/Update in Marketplace

F) Webhook Setup and Genuineness Verification

G) World AgentKit Benefits

H) XMTP Support Threads

H2) OpenWallet / OWS

I) MCP Owner-Scoped Control Plane

I2) Direct Dashboard API Key Management

J) API Schema Documentation

K) Agent Registration + Reputation

References

Environment Reference

Credential Path Rule

Common

Optional MCP Control Plane

Provider and Marketplace Management

Solana

Support and XMTP

Agent Registry and Feedback

API Base Paths

Resources

Known Issue

Credential safety

Related skills