x402 Compute Skill

The x402-compute skill is the agentic interface to the Singularity Cloud Network. It covers three jobs:

SGL Machines — provision and manage VPS/GPU instances on Vultr or DigitalOcean (x402 on Base/Solana/MegaETH/Robinhood Chain, MPP via mppx, or pre-loaded USD credits; OWS auth, API keys, in-place resize).
SGL Grid — inference — call decentralized, confidential (TEE), OpenAI-compatible inference (https://grid.x402compute.cc/v1) with the same x402c_… API key/credits or per-request x402; supports token streaming + end-to-end encryption.
Provide Compute (run a node) — turn a TEE-capable machine into a grid node: stake $SGL, install the sgl CLI, register, attest, and serve a model to earn USDC + SGL. See Provide Compute and the skill’s references/node-operator.md.
Agent Pods — deploy an always-on hosted OpenClaw agent with its own crypto wallet, memory, scheduler, and preinstalled x402 skills; managed or BYOK. See Agent Pods and the skill’s references/agent-pods.md.
Processors — publish your own code as a paid endpoint. Buyers pay you directly in USDC over x402; you pay only for the runtime you use. Every processor is also a connectable MCP server, so agents, harnesses, and LangGraph nodes can call it with just a URL. See Processors and the skill’s references/processors.md.

Primary access method is SSH public key. If no SSH key was provided during provisioning, a one-time password fallback endpoint is available.

Current release: v1.13.0.Security — action may be required. As of v1.13.0 the skill’s scripts no longer read .env files. Credentials come only from environment variables you have exported. If you kept your keys in a .env, source it yourself before running the skill, or you will see Set SOLANA_SECRET_KEY / Set PRIVATE_KEY. Previously load_dotenv() searched upward from the script’s own directory, so a .env in the project you installed the skill into — or any parent of it — could supply the credentials used to sign transactions. In the same release OWS_BIN must be an absolute path to an existing, executable, non-world-writable file, and the unpinned npx -y @open-wallet-standard/core fallback was removed: install @open-wallet-standard/[email protected] explicitly instead.Also since v1.10.0: Agent Pods (one-click hosted OpenClaw agents with their own wallet, an OpenAI-compatible adapter, and curated templates) and Processors (publish your own code as a paid endpoint; buyers pay you directly in USDC over x402 and every processor is a connectable MCP server). x402 Base/Solana/MegaETH/Robinhood payments are live. Pre-loaded USD credits available for payment-free provisioning, extending, and Grid inference. MegaETH uses USDm (ERC-2612 permit) and Robinhood Chain uses USDG (EIP-3009 transferWithAuthorization), both with an embedded facilitator — gasless for users. MPP Tempo USDC.e payments are also live for agent/CLI provisioning.

DigitalOcean is available as an additional compute provider when configured. DigitalOcean plans are prefixed with do: and require SSH key access because DigitalOcean does not expose one-time root passwords through its API.

Base URL

https://compute.x402layer.cc

Auth Model

Management endpoints require one of:

Signature auth headers (X-Auth-*)
API key (X-API-Key)

Supported auth approaches today:

direct Base, Solana, MegaETH, or Robinhood Chain signing keys
optional OpenWallet / OWS for auth + API-key creation + management

Recommended agent flow:

Create API key once via POST /compute/api-keys using direct signing keys or OWS-backed auth.
Store key in COMPUTE_API_KEY.
Use API key for routine list/details/resize/destroy/password fallback calls.

Resize model

POST /compute/instances/:id/resize is a management action, not a second payment flow.
The API preserves the instance’s remaining prepaid dollar credit and recalculates expires_at for the target hourly rate.
Resize stays on the current provider and current region. The backend validates family/spec compatibility before it forwards the provider API call.
Vultr resizes are upgrade-only.
DigitalOcean can increase disk size, but disk-growing resizes require confirm_disk_resize: true because the disk change is irreversible.
Expect downtime during resize. Take a snapshot/backup first.

Credits

Pre-load USD credits to your wallet via a one-time x402 payment, then provision and extend instances without a live blockchain payment each time. Credits are ideal for API-key-driven automation where you want to avoid per-operation payment flows.

Top up: POST /compute/credits/topup with { "amount": 50, "network": "base" }. Omit the X-Payment header to receive a 402 challenge, then pay and retry. Supports all networks: base, solana, megaeth, robinhood.
Check balance: GET /compute/credits/balance with auth headers or API key.
Use credits: Pass "use_credits": true in the provision or extend request body. The server deducts from your credit balance instead of requiring x402/MPP payment.
Auto-refund: If the cloud provider rejects the instance after credits are deducted, the full amount is automatically refunded to your balance.

Credits are scoped per wallet. One credit pool covers all operations (provision + extend) across all providers and regions.

Endpoint Summary

Method	Endpoint	Purpose
`GET`	`/compute/plans`	List VPS/GPU plans
`GET`	`/compute/regions`	List deployment regions
`GET`	`/compute/os`	List OS images
`POST`	`/compute/provision`	Provision Vultr or DigitalOcean instance (x402 or MPP payment)
`GET`	`/compute/instances`	List instances for authenticated wallet
`GET`	`/compute/instances/:id`	Get instance details
`POST`	`/compute/instances/:id/password`	One-time root password fallback
`POST`	`/compute/instances/:id/extend`	Extend prepaid duration (x402 or MPP payment + auth)
`POST`	`/compute/instances/:id/resize`	Resize an instance in place and recalculate remaining prepaid time
`DELETE`	`/compute/instances/:id`	Destroy instance
`GET`	`/compute/credits/balance`	Get credit balance for authenticated wallet
`POST`	`/compute/credits/topup`	Top up credits via x402 payment
`POST`	`/compute/api-keys`	Create API key (signature only)
`GET`	`/compute/api-keys`	List API keys
`DELETE`	`/compute/api-keys/:id`	Revoke API key

Install Skill

skills.sh (portable — Cursor, Claude Code, Codex, Gemini, and more)

npx skills add https://github.com/ivaavimusic/singularity-skill --skill x402-compute

Distributed from the ivaavimusic/singularity-skill repo, which hosts both --skill singularity (marketplace/payments) and --skill x402-compute (Cloud Network compute).

Hosted one-liner

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

Served by the compute skill handler in the gateway (api.x402layer.cc) — always pulls the latest version.

ClawHub / OpenClaw

npx clawhub@latest install x402-compute
pnpm dlx clawhub@latest install x402-compute
bunx clawhub@latest install x402-compute

ClawHub listing: https://clawhub.ai/ivaavimusic/x402-compute

Scripts Included

Script	Purpose
`browse_plans.py`	Browse plans and pricing
`browse_regions.py`	Browse regions
`provision.py`	Provision a compute instance
`create_api_key.py`	Create reusable API key
`list_instances.py`	List instances
`instance_details.py`	Get detailed status
`get_one_time_password.py`	Fetch one-time root password fallback
`extend_instance.py`	Extend instance duration
`resize_instance.py`	Resize an instance in place
`destroy_instance.py`	Destroy instance
`ows_cli.py`	Run OpenWallet / OWS wallet, sign-message, and key commands

Quick Workflow

1) Provision with SSH Key (Recommended)

python scripts/provision.py vcg-a100-1c-2g-6gb lax --months 1 --ssh-key-file ~/.ssh/id_ed25519.pub

1b) Provision with MPP / mppx

npx mppx https://compute.x402layer.cc/compute/provision \
  -X POST \
  -J '{"plan":"vc2-1c-1gb","region":"ewr","os_id":2284,"label":"mpp-vps","prepaid_hours":24,"ssh_public_key":"ssh-ed25519 AAAA... agent"}'

If the MPP provision does not include wallet/API-key auth, the response includes a one-time management_api_key. Store it and use it for later instance management. DigitalOcean example:

npx mppx https://compute.x402layer.cc/compute/provision \
  -X POST \
  -J '{"plan":"do:s-1vcpu-1gb","provider":"digitalocean","region":"nyc3","os_id":123456789,"label":"do-vps","prepaid_hours":24,"ssh_public_key":"ssh-ed25519 AAAA... agent"}'

1c) Provision with Credits

# Step 1: Top up credits (one-time x402 payment)
curl -X POST https://compute.x402layer.cc/compute/credits/topup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $COMPUTE_API_KEY" \
  -d '{"amount": 100, "network": "base"}'
# Returns 402 → pay → credits added

# Step 2: Provision using credits (no payment needed)
curl -X POST https://compute.x402layer.cc/compute/provision \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $COMPUTE_API_KEY" \
  -d '{
    "plan": "vc2-1c-1gb",
    "region": "ewr",
    "os_id": 2284,
    "label": "credit-vps",
    "prepaid_hours": 720,
    "ssh_public_key": "ssh-ed25519 AAAA... agent",
    "use_credits": true
  }'

# Step 3: Check remaining balance
curl https://compute.x402layer.cc/compute/credits/balance \
  -H "X-API-Key: $COMPUTE_API_KEY"

2) Create API Key for Agents

python scripts/create_api_key.py --label "my-agent"
export COMPUTE_API_KEY="x402c_..."

2b) Optional OpenWallet / OWS auth path

npm install -g @open-wallet-standard/core
export OWS_WALLET="compute-wallet"
export COMPUTE_AUTH_MODE="ows"
python scripts/create_api_key.py --label "my-agent"

3) Manage Instances

python scripts/list_instances.py
python scripts/instance_details.py <instance_id>
python scripts/resize_instance.py <instance_id> vc2-2c-4gb
python scripts/extend_instance.py <instance_id> --hours 720
python scripts/destroy_instance.py <instance_id>

MPP-paid extension requires compute auth:

npx mppx https://compute.x402layer.cc/compute/instances/<instance_id>/extend \
  -X POST \
  -H "X-API-Key: $COMPUTE_API_KEY" \
  -J '{"extend_hours":720}'

Resize uses the same management auth, but does not require x402 or MPP payment:

curl -X POST https://compute.x402layer.cc/compute/instances/<instance_id>/resize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $COMPUTE_API_KEY" \
  -d '{"plan":"vc2-2c-4gb"}'

DigitalOcean disk growth example:

curl -X POST https://compute.x402layer.cc/compute/instances/<instance_id>/resize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $COMPUTE_API_KEY" \
  -d '{"plan":"do:s-2vcpu-4gb","confirm_disk_resize":true}'

4) One-Time Password Fallback (Only if no SSH key)

python scripts/get_one_time_password.py <instance_id>

This works once per instance. Repeated calls return 409.

OWS scope note

OWS is great for compute auth and management/API-key flows
Direct x402 provision and extend still use the current Base, Solana, MegaETH, or Robinhood Chain payment-signing paths
MPP provision and extend use mppx, Tempo Wallet, or another MPP-capable client

Payment options

Option	Status	Notes
x402 Base USDC	Live	Existing UI/script flow
x402 Solana USDC	Live	Existing script flow
x402 MegaETH USDm	Live	ERC-2612 permit flow; embedded facilitator; gasless for users
x402 Robinhood USDG	Live	EIP-3009 `transferWithAuthorization`; embedded facilitator; single-tx settle; gasless for users
MPP Tempo USDC.e	Live	Tested with `npx mppx`; returns `Payment-Receipt`
Credits	Live	Pre-load USD via x402 topup; provision/extend with `use_credits: true`
MPP Stripe cards	Pending	Requires Stripe Machine Payments / Shared Payment Token access

Compute providers

Provider	Status	Notes
Vultr	Live	One-time password fallback available; resize is upgrade-only
DigitalOcean	Code-ready	Requires `DIGITALOCEAN_API_TOKEN`; SSH key required; disk growth is irreversible

Security Notes

Wallet/agent can only access its own instances.
Replay protection uses signed nonce + timestamp.
MPP replay protection uses a shared Cloudflare Durable Object replay store.
Payment wallet must match authenticated wallet.
Resize preserves remaining prepaid value by changing expiry instead of charging a second payment.
Passwords are not returned in standard list/details/provision responses.
One-time password endpoint is owner-authenticated and single-use.
Credit deduction uses PostgreSQL row-level locking to prevent double-spend under concurrent requests.
Failed provider calls trigger automatic credit refund before the error response is returned.

References

Skill definition: skills/x402-compute/SKILL.md
Skill API reference: skills/x402-compute/references/api-reference.md
OWS reference: skills/x402-compute/references/openwallet-ows.md
Hosted installer: https://api.x402layer.cc/skill/x402-compute/install

Overview

User Guide

Slayer Agent

Core flows

Staking Engine

Singularity Cloud Network

Contract Addresses

ERC8004

Skills

Singularity Payments

Agentic Fundraisers

Enterprise

x402 Compute Skill

x402 Compute Skill

Base URL

Auth Model

Resize model

Credits

Endpoint Summary

Install Skill

skills.sh (portable — Cursor, Claude Code, Codex, Gemini, and more)

Hosted one-liner

ClawHub / OpenClaw

Scripts Included

Quick Workflow

1) Provision with SSH Key (Recommended)

1b) Provision with MPP / mppx

1c) Provision with Credits

2) Create API Key for Agents

2b) Optional OpenWallet / OWS auth path

3) Manage Instances

4) One-Time Password Fallback (Only if no SSH key)

OWS scope note

Payment options

Compute providers

Security Notes

References

​x402 Compute Skill

​Base URL

​Auth Model

​Resize model

​Credits

​Endpoint Summary

​Install Skill

​skills.sh (portable — Cursor, Claude Code, Codex, Gemini, and more)

​Hosted one-liner

​ClawHub / OpenClaw

​Scripts Included

​Quick Workflow

​1) Provision with SSH Key (Recommended)

​1b) Provision with MPP / mppx

​1c) Provision with Credits

​2) Create API Key for Agents

​2b) Optional OpenWallet / OWS auth path

​3) Manage Instances

​4) One-Time Password Fallback (Only if no SSH key)

​OWS scope note

​Payment options

​Compute providers

​Security Notes

​References

x402 Compute Skill

Base URL

Auth Model

Resize model

Credits

Endpoint Summary

Install Skill

skills.sh (portable — Cursor, Claude Code, Codex, Gemini, and more)

Hosted one-liner

ClawHub / OpenClaw

Scripts Included

Quick Workflow

1) Provision with SSH Key (Recommended)

1b) Provision with MPP / mppx

1c) Provision with Credits

2) Create API Key for Agents

2b) Optional OpenWallet / OWS auth path

3) Manage Instances

4) One-Time Password Fallback (Only if no SSH key)

OWS scope note

Payment options

Compute providers

Security Notes

References