@douglas-agent/sandbank-cloud

@douglas-agent/sandbank-cloud

Sandbank Cloud adapter for Sandbank with built-in x402 payment support.

Connect to Sandbank Cloud — managed bare-metal KVM sandboxes with sub-second start times. Pay per sandbox with USDC via the x402 payment protocol, or use an API token for authenticated access.

Install

pnpm add @douglas-agent/sandbank-core @douglas-agent/sandbank-cloud

Usage

x402 Payment (pay-per-use)

import { createProvider } from '@douglas-agent/sandbank-core'
import { SandbankCloudAdapter } from '@douglas-agent/sandbank-cloud'

const provider = createProvider(
  new SandbankCloudAdapter({
    walletPrivateKey: process.env.WALLET_PRIVATE_KEY,
  })
)

const sandbox = await provider.create({
  image: 'codebox',
  resources: { cpu: 2, memory: 1024 },
  ports: [[0, 7681], [0, 8080]],
})

const { stdout } = await sandbox.exec('node -e "console.log(42)"')
console.log(stdout) // 42

await provider.destroy(sandbox.id)

API Token (authenticated access)

const provider = createProvider(
  new SandbankCloudAdapter({
    apiToken: process.env.SANDBANK_API_TOKEN,
  })
)

Configuration

Option	Description
url	Sandbank Cloud API URL (default: https://cloud.sandbank.dev)
walletPrivateKey	EVM wallet private key (hex, 0x prefix) for x402 USDC payments
apiToken	Bearer token for authenticated (internal) access — bypasses x402

Capabilities

Capability	Supported
exec.stream	✅
port.expose	✅

How x402 Payment Works

• POST /v1/boxes returns HTTP 402 with payment requirements
• The adapter signs a USDC payment on Base (eip155:8453) using your wallet
• The request is retried with the payment signature header
• The sandbox is created — $0.02 per sandbox (includes 10 min)

License

MIT