x402Compute

GPU compute marketplace powered by x402 and MPP payments, with optional pre-loaded USD credits. Provision cloud instances on Vultr or DigitalOcean, pay with USDC on Base or Solana, USDm on MegaETH, use MPP with Tempo-compatible clients, or spend from your credit balance.

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

Current release: v1.4.0. x402 Base/Solana/MegaETH payments are live. Pre-loaded USD credits now available for payment-free provisioning and extending. MegaETH uses USDm (ERC-2612 permit) with an embedded facilitator — gasless for users. MPP Tempo USDC.e payments are also live.

Provider support: Vultr is live. DigitalOcean plans appear with a do: prefix and require SSH key access. In-place resize is now available on both providers with provider-specific safeguards.

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, including safe in-place resize.

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

↕ Safe Resize

Resize on the same provider while preserving remaining prepaid dollar credit.

💰 Pre-loaded Credits

Top up USD credits once, then provision and extend without per-operation payments.

🔌 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 Plans→2. Provision (x402 / MPP / Credits)→3. Active→4. Resize / Extend / Destroy→5. Expired

Resize Model

Billing: resize is a management action, not a second x402 or MPP purchase. The API preserves remaining prepaid dollar credit and recalculates expires_at for the target hourly rate.

Scope: resize stays on the current provider and region, and the backend validates plan-family/spec compatibility before calling the provider API.

Provider rules: Vultr is upgrade-only. DigitalOcean disk growth is irreversible and requires confirm_disk_resize: true.

Ops note: expect downtime during resize and take a snapshot/backup first.

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/MegaETH 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.

Method	Endpoint	Description	Auth
GET	/compute/plans	List available GPU plans with pricing	None
GET	/compute/regions	List available deployment regions	None
GET	/compute/os	List available OS images	None
POST	/compute/provision	Provision a new instance (x402, MPP, or credits)	x402 / MPP / Credits
GET	/compute/credits/balance	Get credit balance for wallet	Signature or X-API-Key
POST	/compute/credits/topup	Top up credits via x402 payment	x402 + Auth
POST	/compute/api-keys	Create API key for agents	Signature only
GET	/compute/api-keys	List API keys	Signature or X-API-Key
DELETE	/compute/api-keys/:id	Revoke API key	Signature only
GET	/compute/instances	List your instances	Signature or X-API-Key
GET	/compute/instances/:id	Get instance details	Signature or X-API-Key
DELETE	/compute/instances/:id	Destroy an instance	Signature or X-API-Key
POST	/compute/instances/:id/password	Retrieve one-time root password fallback	Signature or X-API-Key
POST	/compute/instances/:id/extend	Extend instance lifetime	x402 / MPP / Credits + Auth
POST	/compute/instances/:id/resize	Resize in place and recalculate remaining prepaid time	Signature or X-API-Key

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 Credits

Pre-load USD credits via a one-time x402 payment, then provision without per-operation payment flows. Pass use_credits: true to deduct from your balance.

# 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

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

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

2b. 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/resize/extend/destroy calls.

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

2d. 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, Solana, or MegaETH payment-signing paths, while resize uses normal management auth only.

2e. 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.

3b. Resize an Existing Instance

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

# Resize preserves remaining prepaid dollar credit and recalculates expiry.
# No x402 or MPP payment is required for this route.

# DigitalOcean disk growth requires explicit confirmation
curl -X POST https://compute.x402layer.cc/compute/instances/YOUR_ID/resize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $COMPUTE_API_KEY" \
  -d '{
    "plan": "do:s-2vcpu-4gb",
    "confirm_disk_resize": true
  }'

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, MPP, and credit-based payment for provisioning and extending instances. Resize uses compute auth only and does not create a new payment challenge:

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

MegaETH

USDm on MegaETH • ERC-2612 permit • Gasless for users • ~10ms finality

MPP Tempo

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

Credits

Pre-load USD via x402 topup • Provision/extend with use_credits: true • Live

MPP Stripe Cards

Code-ready • Pending Stripe Machine Payments / SPT access