API Documentation

MoltLaunch is a verification protocol for AI agents on Solana — hardware identity, STARK proofs, and Sybil detection. This is the API reference.

📍 Base URL

https://web-production-419d9.up.railway.app

Quick Start

1. Register identity

curl -X POST https://web-production-419d9.up.railway.app/api/identity/register \
  -H "Content-Type: application/json" \
  -d '{"agentId":"my-agent","identityHash":"sha256:abc...","includesHardware":true}'

2. Verify agent

curl -X POST https://web-production-419d9.up.railway.app/api/verify/deep \
  -H "Content-Type: application/json" \
  -d '{"agentId":"my-agent","capabilities":["trading"]}'

3. Full SAP validation

curl -X POST https://web-production-419d9.up.railway.app/api/validate \
  -H "Content-Type: application/json" \
  -d '{"agentId":"my-agent","validationType":["identity","scoring","sybil","proof"],"trustRequired":3}'

Verification API

POST /api/verify/deep

Deep verification with code analysis, capability testing, and security scoring.

// Request
{ "agentId": "x", "capabilities": ["trading"], "apiEndpoint": "https://..." }

// Response
{ "verified": true, "score": 87, "tier": "deep", "checks": { ... } }

POST /api/verify/quick

Quick verification — basic capability checks, returns a PoA score 0–100.

// Request
{ "agentId": "x", "capabilities": ["analysis"] }

// Response
{ "verified": true, "score": 75, "tier": "quick" }

GET /api/verify/status/:agentId

Check current verification status for an agent.

// Response
{ "agentId": "x", "verified": true, "score": 87, "tier": "deep", "expiresAt": "..." }

Identity & Sybil Detection

POST /api/identity/register

// Request
{ "agentId": "x", "identityHash": "sha256:...", "includesHardware": true }

// Response
{ "registered": true, "trustLevel": 1 }

POST /api/identity/tpm/challenge

Request a TPM attestation challenge nonce for hardware-bound identity.

// Request
{ "agentId": "x" }

// Response
{ "challenge": "base64-nonce", "expiresIn": 300 }

POST /api/identity/tpm/verify

Submit TPM attestation response to complete hardware verification.

// Request
{ "agentId": "x", "challenge": "base64-nonce", "attestation": "base64-signed" }

// Response
{ "hwVerified": true, "trustLevel": 3 }

GET /api/identity/sybil-check

Check Sybil similarity between two agents. Query: ?agent1=X&agent2=Y

// Response
{ "isSybil": false, "confidence": 0.02, "clusterSize": 1 }

POST /api/identity/table-check

Batch check multiple agent IDs against the identity table.

// Request
{ "agentIds": ["agent-a", "agent-b", "agent-c"] }

// Response
{ "results": [ { "agentId": "agent-a", "registered": true }, ... ] }

STARK Proofs

POST /api/stark/generate/:agentId

Generate a STARK proof of agent verification state.

// Response
{ "proof": "0xabc...", "publicInputs": { "scoreAbove": 60, "isVerified": true } }

POST /api/stark/consistency/:agentId

Prove behavioral consistency — actions match declared capabilities over time.

// Response
{ "consistent": true, "proof": "0x...", "windowDays": 30, "actionCount": 142 }

POST /api/stark/streak/:agentId

Prove uptime streak — agent continuously active for N days.

// Response
{ "streakDays": 45, "proof": "0x...", "since": "2026-01-01T00:00:00Z" }

POST /api/stark/stability/:agentId

Prove score stability — score hasn't dropped below threshold in N days.

// Response
{ "stable": true, "proof": "0x...", "minScore": 75, "windowDays": 30 }

Execution Traces

POST /api/traces

Submit an execution trace (actions, results, timestamps).

// Request
{ "agentId": "x", "actions": [
    { "type": "api_call", "target": "jupiter", "success": true, "durationMs": 230 }
] }

GET /api/traces/:agentId

List execution traces. Supports ?limit= and ?offset=.

// Response
{ "traces": [ { "id": "...", "actionCount": 2, "successRate": 1.0, "createdAt": "..." } ] }

GET /api/traces/:agentId/score

Get computed behavioral score from all traces.

// Response
{ "behavioralScore": 18, "totalTraces": 42, "avgSuccessRate": 0.95 }

SAP Validation

POST /api/validate

Unified validation — runs identity + scoring + Sybil + STARK proof in one call.

// Request
{
  "agentId": "x",
  "validationType": ["identity", "scoring", "sybil", "proof"],
  "trustRequired": 3
}

// Response
{
  "valid": true,
  "score": 87,
  "trustLevel": 3,
  "identity": { "registered": true, "hwVerified": true, "sybilScore": 0.01 },
  "proof": { "stark": "0xabc...", "onChain": "tx:5kR..." }
}

Solana Integration

POST /api/anchor/verification

Write a verification attestation on-chain via the Anchor program.

// Request
{ "agentId": "x", "score": 87, "trustLevel": 3, "wallet": "YOUR_WALLET" }

// Response
{ "tx": "5kR...", "slot": 123456 }

GET /api/solana/balance/:address

Get SOL balance for a wallet address.

// Response
{ "address": "ABC...", "balanceLamports": 5000000000, "balanceSOL": 5.0 }

GET /api/jupiter/quote

Get a swap quote from Jupiter. Query: ?inputMint=So11...&outputMint=USDC&amount=1000000

// Response
{ "inputMint": "So11...", "outAmount": "142350", "priceImpactPct": "0.01" }

GET /api/oracles/pyth/price/:symbol

Get real-time price from Pyth oracle. Example: /api/oracles/pyth/price/SOL

// Response
{ "symbol": "SOL", "price": 142.35, "confidence": 0.12 }

On-Chain Program

Deployed on Solana Devnet

6AZSAhq4iJTwCfGEVssoa1p3GnBqGkbcQ1iDdP1U1pSb

14 instructions · Explorer · GitHub IDL