x402Compute

GPU compute marketplace powered by x402 and MPP payments. Provision cloud instances on Vultr or DigitalOcean, pay with USDC on Base or Solana, or use MPP with Tempo-compatible clients such as mppx.

🖥️ Compute API is available at compute.x402layer.cc

Current release: v1.2.0. x402 Base/Solana remains live, MPP Tempo USDC.e payments are live, and DigitalOcean is code-ready as an additional provider once its API token is configured. Stripe card payments are code-ready pending Stripe Machine Payments access.

Provider support: Vultr is live. DigitalOcean plans appear with a do: prefix and require SSH key access.

Overview

x402Compute lets you provision GPU-powered virtual machines using x402 or MPP payment flows. Instances are provisioned via Vultr or DigitalOcean infrastructure and can be managed entirely through the API or the Compute Dashboard. Compute auth and management flows also support optional OpenWallet / OWS usage.

💳 Pay-Per-Provision

Pay with x402 USDC or MPP Tempo USDC.e. No subscriptions required.

⏳ Extend Anytime

Extend your instance's lifetime from 1 week to 6 months.

🔌 Full API Access

SSH access, root control, and full API for programmatic management.

☁️ Multi-Provider

Vultr live, DigitalOcean code-ready for extra capacity.

Instance Lifecycle

1. Browse Plans2. Provision (x402 or MPP Pay)3. Active4. Extend / Destroy5. Expired

API Reference

Base URL: https://compute.x402layer.cc

Auth: Management endpoints require either signed auth headers (X-Auth-*) or anX-API-Key issued viaPOST /compute/api-keys. You can use direct Base/Solana signing keys or optional OWS-backed auth for API-key creation and management. Paid provision and extend support x402, and MPP clients can pay with Authorization: Payment.

MethodEndpointDescriptionAuth
GET/compute/plansList available GPU plans with pricingNone
GET/compute/regionsList available deployment regionsNone
GET/compute/osList available OS imagesNone
POST/compute/provisionProvision a new Vultr or DigitalOcean instancex402 / MPP
POST/compute/api-keysCreate API key for agentsSignature only
GET/compute/api-keysList API keysSignature or X-API-Key
DELETE/compute/api-keys/:idRevoke API keySignature only
GET/compute/instancesList your instancesSignature or X-API-Key
GET/compute/instances/:idGet instance detailsSignature or X-API-Key
DELETE/compute/instances/:idDestroy an instanceSignature or X-API-Key
POST/compute/instances/:id/passwordRetrieve one-time root password fallbackSignature or X-API-Key
POST/compute/instances/:id/extendExtend instance lifetimex402 / MPP + Auth

Quick Start

1. Browse Available Plans

curl https://compute.x402layer.cc/compute/plans

# Response includes GPU plans with pricing:
# {
#   "plans": [
#     {
#       "id": "vcg-a100-1c-2g-6gb",
#       "name": "A100 1 GPU",
#       "vcpu_count": 12,
#       "ram": 120832,
#       "gpu_vram_gb": 80,
#       "monthly_cost": 90,
#       ...
#     }
#   ]
# }

2. Provision an Instance

The provision endpoint returns a 402 response with x402 and MPP payment requirements. Use the x402-compute skill, an x402-aware client, or npx mppx to handle payment automatically.

# Step 1: Request provision — get 402 challenge
curl -X POST https://compute.x402layer.cc/compute/provision \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "plan": "vcg-a100-1c-2g-6gb",
    "region": "lax",
    "os_id": 2284,
    "label": "my-gpu-instance",
    "prepaid_hours": 720,
    "ssh_public_key": "ssh-ed25519 AAAA... user@host",
    "network": "base"
  }'

# Step 2: Pay via x402 (handled automatically by x402 clients)
# Step 3: Instance is provisioned. SSH access uses your public key (no password returned).

2a. 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 you do not include wallet/API-key auth, the response includes management_api_key.
# Store it once and use it for list/details/extend/destroy calls.

2b. Provision on DigitalOcean

# DigitalOcean plans are prefixed with do:
# DigitalOcean requires SSH key access; password fallback is Vultr-only.
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"}'

2c. 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"

# Then use COMPUTE_API_KEY for routine management
python scripts/list_instances.py

OWS scope: OWS is currently best for compute auth and management/API-key flows. Provision and extend still use the current direct Base or Solana payment-signing paths.

2d. One-Time Password Fallback (Optional)

# Use only if you did not provide ssh_public_key
curl -X POST https://compute.x402layer.cc/compute/instances/YOUR_ID/password \
  -H "X-API-Key: your_api_key"

# Returns root username + password once.
# Subsequent requests return 409.

3. List Your Instances

curl https://compute.x402layer.cc/compute/instances \
  -H "X-API-Key: your_api_key"

# Returns all instances with status, IP, expiry, etc.

4. Extend an Instance

# Extend by 720 hours (1 month)
curl -X POST https://compute.x402layer.cc/compute/instances/YOUR_ID/extend \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "extend_hours": 720,
    "network": "base"
  }'

# Returns 402 challenge → pay → instance extended

4a. Extend with MPP / mppx

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

# MPP extension requires compute auth so the server can verify instance ownership.

5. Destroy an Instance

curl -X DELETE https://compute.x402layer.cc/compute/instances/YOUR_ID \
  -H "X-API-Key: your_api_key"

# Instance is destroyed immediately

Payment Flow

x402Compute supports x402 and MPP payment protocols for provisioning and extending instances:

1. Request → 402 Challenge

Send a provision/extend request. The server responds with HTTP 402 containing x402 JSON requirements and MPP WWW-Authenticate: Payment headers.

2. Client Pays

An x402-aware client sends X-Payment. An MPP-aware client sends Authorization: Payment and receives Payment-Receipt on success.

3. Verify → Settle → Provision

The server verifies the payment through the x402 facilitator or MPP method handler, then provisions or extends the instance.

Supported Payment Options

Base (EVM)

USDC on Base • 100% reliable • Recommended

Solana

USDC on Solana • ~75% success rate • Retry recommended

MPP Tempo

Tempo mainnet USDC.e • Works with mppx CLI • Live

MPP Stripe Cards

Code-ready • Pending Stripe Machine Payments / SPT access

Resources