​

x402 Compute Skill

• SGL Machines — provision and manage VPS/GPU instances on Vultr or DigitalOcean (x402 on Base/Solana/MegaETH, 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.

​

Base URL

​

Auth Model

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

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

1. Create API key once via POST /compute/api-keys using direct signing keys or OWS-backed auth.
2. Store key in COMPUTE_API_KEY.
3. 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

• 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.
• 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.

​

Endpoint Summary

​

Install Skill

​

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

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

​

Hosted one-liner

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

​

ClawHub / OpenClaw

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

​

Scripts Included

​

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"}'

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>

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

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"}'

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>

​

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, or MegaETH payment-signing paths
• MPP provision and extend use mppx, Tempo Wallet, or another MPP-capable client

​

Payment options

​

Compute providers

​

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