Developer resources

Resources for building with SadClaw.

SDKs & Libraries

Official SDK

TypeScript/JavaScript SDK for Node.js and browsers:

npm install @sadclaw/sdk

SDK Documentation

CLI

Command-line interface:

npx sadclaw

CLI Documentation

Source Code

Main Repository

github.com/techwebc/sadclaw

Contents:

• /programs/sadclaw-vm - Solana program (Rust)

• /backend - API server (Node.js)

• /web - Frontend (Next.js)

• /cli - CLI tool

• /sdk - TypeScript SDK

License

MIT License - free for commercial and personal use.

API Reference

Base URL

Production: https://api.sadclaw.cloud

Devnet: https://api.devnet.sadclaw.cloud

Authentication

All authenticated endpoints require a JWT token obtained via wallet signature:

# 1. Get challenge
POST /api/auth/challenge
{ "wallet": "7xKX...abc123" }

# Response
{ "message": "Sign this message to authenticate: nonce123" }

# 2. Sign and verify
POST /api/auth/verify
{ "wallet": "7xKX...abc123", "signature": "base58signature" }

# Response
{ "token": "eyJhbG..." }

Endpoints

Endpoint	Method	Auth	Description
/api/tiers	GET	No	List VM tiers
/api/auth/challenge	POST	No	Get auth challenge
/api/auth/verify	POST	No	Verify signature
/api/vms	GET	Yes	List user's VMs
/api/vms/:mint	GET	Yes	Get VM details
/api/vms/:mint/ssh	GET	Yes	Get SSH credentials

Solana Program

Program ID

Mainnet: SADCLAWvmProgram111111111111111111111111111

Devnet: SADCLAWvmDevnet11111111111111111111111111

IDL

The program IDL is available at:

github.com/techwebc/sadclaw/blob/main/programs/sadclaw-vm/idl.json

Testing

Devnet

Test on Solana devnet without real funds:

const client = new SadClawClient({
  rpcUrl: 'https://api.devnet.solana.com',
  keypair: testKeypair,
  apiUrl: 'https://api.devnet.sadclaw.cloud',
});

Getting Devnet USDC

1. Get devnet SOL from solfaucet.com

2. Swap for devnet USDC on Jupiter (devnet)

Examples

Basic Usage

import { SadClawClient } from '@sadclaw/sdk';

const client = new SadClawClient({ rpcUrl, keypair });

// Purchase VM
const vm = await client.purchaseVm({
  tier: 'STANDARD',
  durationHours: 24,
});

// Get SSH access
const ssh = await client.getSshCredentials(vm.nftMint);

Auto-scaling

async function ensureCapacity(minVms: number) {
  const vms = await client.listVms();
  const active = vms.filter(v => v.status === 'active');

  while (active.length < minVms) {
    await client.purchaseVm({ tier: 'STANDARD', durationHours: 6 });
    active.push(await client.listVms().then(v => v[v.length - 1]));
  }
}

Express Middleware

import { SadClawClient } from '@sadclaw/sdk';

const sadclaw = new SadClawClient({ rpcUrl, keypair });

app.use('/api/compute', async (req, res, next) => {
  const vms = await sadclaw.listVms();
  const available = vms.find(v => v.status === 'active');

  if (!available) {
    const vm = await sadclaw.purchaseVm({
      tier: 'MICRO',
      durationHours: 1,
    });
    req.vmHost = vm.ipAddress;
  } else {
    req.vmHost = available.ipAddress;
  }

  next();
});

Integrations

CI/CD

Use SadClaw in GitHub Actions:

- name: Provision test environment
  run: |
    npx sadclaw buy --tier MICRO --duration 2
    VM_IP=$(npx sadclaw list --json | jq -r '.[0].ipAddress')
    echo "VM_IP=$VM_IP" >> $GITHUB_ENV

Docker

Run SadClaw CLI in Docker:

FROM node:18-alpine
RUN npm install -g sadclaw
COPY wallet.json /root/.sadclaw/
CMD ["sadclaw", "list"]

Changelog

See releases on GitHub:

github.com/techwebc/sadclaw/releases