{ "openapi": "3.1.0", "info": { "title": "Aradia Sovereign AI Infrastructure & Machine Payments API", "description": "Turnkey private AI hardware appliances (NVIDIA DGX Spark, Station, and B200) with autonomous Agent-to-Agent (A2A) procurement via Stripe Machine Payments Protocol (MPP Fiat) and BTCPay Server (Crypto).", "version": "1.0.0", "contact": { "name": "Aradia Operations", "url": "https://aradia.com" } }, "servers": [ { "url": "https://aradia.com", "description": "Aradia Live Production Origin" } ], "x-agent-spec": { "api_version": "1.0", "updated": "2026-08-16", "description": "Aradia LLC Agent Specification API — technical compatibility data for AI agents evaluating local deployment on Aradia LLC hardware appliances.", "tiers": { "spark": { "tier_id": "spark", "hardware_platform": "NVIDIA DGX Spark", "gpu": { "model": "NVIDIA GB10 (Blackwell)", "total_vram_gb": 128, "vram_type": "LPDDR5X coherent unified" }, "cpu": "ARM64 server-class", "system_memory_gb": 128, "storage_tb": 4, "network_gbps": 100, "power_watts": 240, "form_factor": "Workstation / Desktop" }, "station": { "tier_id": "station", "hardware_platform": "NVIDIA DGX Station", "gpu": { "model": "NVIDIA GB300 (Blackwell Ultra)", "count": 1, "total_vram_gb": 748, "vram_type": "252GB HBM3e + 496GB LPDDR5X coherent" }, "cpu": "72-core ARM Neoverse V2", "system_memory_gb": 748, "storage_tb": 8, "network_gbps": 200, "power_watts": 1500, "form_factor": "Rack-mountable workstation" }, "b200": { "tier_id": "b200", "hardware_platform": "NVIDIA DGX B200 (Rack)", "gpu": { "model": "NVIDIA GB100 (Blackwell)", "count": 8, "total_vram_gb": 1440, "vram_type": "HBM3e" }, "cpu": "2x Intel Xeon Platinum 8570 (112 cores each, 2TB RAM configurable to 4TB)", "system_memory_gb": 2048, "storage_tb": 32, "network_gbps": 400, "power_watts": 12000, "form_factor": "10 RU (rack-mount)" } }, "quantization": { "supported_formats": [ "AWQ", "AutoRound", "FP8", "FP16", "BF16", "Custom" ], "post_training_pipeline": "Models are benchmarked, tuned, and optimized in the Staging Studio to maximize token throughput and precision for specific client workflows.", "optimization_strategy": "VRAM allocation is dynamically tuned per deployment for continuous batching and multi-agent context retention." }, "inference_engine": { "name": "vLLM", "features": [ "Continuous batching for high-throughput concurrent requests", "PagedAttention for efficient memory management", "Multi-GPU tensor parallelism (B200 tier)", "Speculative decoding support" ], "api_endpoint": "http://:8000/v1/chat/completions", "supported_models": [ "Frontier Open-Weight Reasoning & Coding Models (125B–671B+ params)", "Sparse MoE Models (262K+ context)", "DeepSeek Series", "Custom enterprise fine-tuned weights" ] }, "agent_framework": { "orchestration": "OpenClaw (flat orchestrator pattern — no middle management)", "agent_runtime": "Hermes agent framework", "memory_protocol": { "layer_1": "OpenClaw session context (ephemeral, per-session)", "layer_2": "Local high-velocity Vector Knowledge Core (structured knowledge + compiled memory wiki)", "layer_3": "Agent Memory DB (persistent episodic memory in a local, encrypted, on-appliance store)" }, "concurrency_limits": { "spark": { "max_concurrent_agents": 5, "max_concurrent_sessions": 4, "recommended_concurrent_workers": 3 }, "station": { "max_concurrent_agents": 50, "max_concurrent_sessions": 20, "recommended_concurrent_workers": 35 }, "b200": { "max_concurrent_agents": 500, "max_concurrent_sessions": 200, "recommended_concurrent_workers": 350 } }, "orchestrator_pattern": "Flat Orchestrator — no middle management agents. Direct spawn of specialized Doer sub-agents. Results reported directly to orchestrator for decision-making." }, "discovery_points": { "llms_txt": "https://aradia.com/llms.txt", "agent_manifest": "https://aradia.com/.well-known/agent-manifest.json", "pricing_api": "https://aradia.com/api/pricing.json", "agent_spec_api": "https://aradia.com/api/agent-spec.json", "mcp_tools": "https://aradia.com/.well-known/mcp.json", "system_specs": "https://aradia.com/system-specs.json", "sitemap": "https://aradia.com/sitemap.xml" }, "network": { "default_topology": "air-gapped (no inbound ports)", "optional_outbound": "WireGuard SLA tunnel (encrypted, for monitoring and updates only)", "activation_method": "QR code scan from client device to establish initial secure handshake", "firewall_policy": "Deny all inbound by default. Outbound only to Aradia SLA endpoints." }, "compliance": { "standards": [ "HIPAA", "GDPR", "SOC2" ], "data_residency": "100% on-client. No data leaves private network without explicit client authorization.", "audit_logging": "All agent actions logged locally. Audit trail available via SLA portal." } }, "paths": { "/api/checkout/create-session.php": { "post": { "summary": "Create Stripe MPP Fiat Checkout Session", "description": "Initiates an autonomous Machine Payments Protocol (MPP) checkout session for turnkey AI hardware procurement settling in pure Fiat (USD via Card, ACH, Wire, and Shared Payment Tokens).", "operationId": "createMppStripeSession", "x-payment-info": { "intent": "session", "method": "stripe", "currency": "USD", "facilitator": "stripe", "settlement_type": "fiat", "supported_methods": [ "spt_fiat", "card", "ach_debit", "bank_wire", "corporate_invoice" ], "description": "Stripe Machine Payments Protocol (MPP) session for direct Fiat settlement (USD) via Stripe Connect Express v2." }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string", "enum": [ "spark", "station", "b200" ] }, "quantity": { "type": "integer", "default": 1 }, "customer_email": { "type": "string" }, "payment_method": { "type": "string", "enum": [ "stripe_mpp", "stripe_fiat", "stripe_invoice" ] }, "ref": { "type": "string", "description": "Optional partner referral code" } }, "required": [ "tier", "customer_email" ] } } } }, "responses": { "200": { "description": "Stripe MPP Fiat checkout session created successfully" }, "402": { "description": "Payment Required challenge" } } } }, "/api/a2a/checkout": { "post": { "summary": "Autonomous Agent-to-Agent Procurement (Fiat & Crypto)", "description": "Execute direct M2M checkout for DGX Spark ($15,125 USD), Station ($194,093 USD), or B200 ($505,500 USD) settling via Stripe MPP Fiat or BTCPay Crypto.", "operationId": "executeA2ACheckout", "x-payment-info": { "intent": "session", "method": "stripe", "currency": "USD", "settlement_type": "fiat", "amount": 15125, "supported_methods": [ "spt_fiat", "card", "ach_debit", "bank_wire" ] }, "responses": { "200": { "description": "Order confirmed & hardware reserved" }, "402": { "description": "Payment Required via x402" } } } }, "/api/checkout/create-invoice.php": { "post": { "summary": "Formal Corporate Invoice Procurement (Fiat)", "description": "Generates formal Stripe Invoices for institutional purchase orders and direct wire settlements in USD Fiat.", "operationId": "createCorporateInvoice", "x-payment-info": { "intent": "session", "method": "stripe", "currency": "USD", "settlement_type": "fiat", "supported_methods": [ "corporate_invoice", "bank_wire", "ach_debit" ] }, "responses": { "200": { "description": "Corporate invoice dispatched successfully" } } } }, "/api/checkout/create-crypto.php": { "post": { "summary": "BTCPay Greenfield Crypto Checkout", "description": "Generates direct on-chain BTC, Lightning (BOLT11), or USDT-TRON payment invoice.", "operationId": "createCryptoInvoice", "x-payment-info": { "intent": "charge", "method": "lightning", "currency": "USD", "settlement_type": "crypto", "facilitator": "btcpay" }, "responses": { "200": { "description": "Crypto invoice generated successfully" } } } }, "/api/agent-spec.json": { "get": { "summary": "Hardware & Quantization Matrix", "description": "Returns full hardware platform compute specs, VRAM limits, and quantization profiles.", "operationId": "getAgentSpecs", "responses": { "200": { "description": "Hardware specification returned", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentPlatformSpec" } } } } } } }, "/api/pricing.json": { "get": { "summary": "Catalog Pricing Health", "description": "Returns current hardware tiers and monthly recurring SLA rates in USD.", "operationId": "getPricingCatalog", "responses": { "200": { "description": "Pricing catalog returned" } } } } }, "components": { "schemas": { "AgentPlatformSpec": { "api_version": "1.0", "updated": "2026-08-16", "description": "Aradia LLC Agent Specification API — technical compatibility data for AI agents evaluating local deployment on Aradia LLC hardware appliances.", "tiers": { "spark": { "tier_id": "spark", "hardware_platform": "NVIDIA DGX Spark", "gpu": { "model": "NVIDIA GB10 (Blackwell)", "total_vram_gb": 128, "vram_type": "LPDDR5X coherent unified" }, "cpu": "ARM64 server-class", "system_memory_gb": 128, "storage_tb": 4, "network_gbps": 100, "power_watts": 240, "form_factor": "Workstation / Desktop" }, "station": { "tier_id": "station", "hardware_platform": "NVIDIA DGX Station", "gpu": { "model": "NVIDIA GB300 (Blackwell Ultra)", "count": 1, "total_vram_gb": 192, "vram_type": "HBM3e", "nvlink_bandwidth_gb_per_sec": 900 }, "cpu": "x86_64 dual-socket server", "system_memory_gb": 512, "storage_tb": 8, "network_gbps": 200, "power_watts": 1500, "form_factor": "Rack-mountable workstation" }, "b200": { "tier_id": "b200", "hardware_platform": "NVIDIA DGX B200 (Rack)", "gpu": { "model": "NVIDIA GB100 (Blackwell)", "count": 8, "total_vram_gb": 1536, "vram_type": "LPDDR5X coherent unified" }, "cpu": "x86_64 4-socket server", "system_memory_gb": 2048, "storage_tb": 32, "network_gbps": 400, "power_watts": 12000, "form_factor": "Full rack (42U)" } }, "quantization": { "supported_formats": [ "AWQ", "AutoRound", "FP8", "FP16", "BF16", "Custom" ], "post_training_pipeline": "Models are benchmarked, tuned, and optimized in the Staging Studio to maximize token throughput and precision for specific client workflows.", "optimization_strategy": "VRAM allocation is dynamically tuned per deployment for continuous batching and multi-agent context retention." }, "inference_engine": { "name": "vLLM", "features": [ "Continuous batching for high-throughput concurrent requests", "PagedAttention for efficient memory management", "Multi-GPU tensor parallelism (B200 tier)", "Speculative decoding support" ], "api_endpoint": "http://:8000/v1/chat/completions", "supported_models": [ "Frontier Open-Weight Reasoning & Coding Models (125B–671B+ params)", "Sparse MoE Models (262K+ context)", "DeepSeek Series", "Custom enterprise fine-tuned weights" ] }, "agent_framework": { "orchestration": "OpenClaw (flat orchestrator pattern — no middle management)", "agent_runtime": "Hermes agent framework", "memory_protocol": { "layer_1": "OpenClaw session context (ephemeral, per-session)", "layer_2": "Local high-velocity Vector Knowledge Core (structured knowledge + compiled memory wiki)", "layer_3": "Agent Memory DB (persistent episodic memory in a local, encrypted, on-appliance store)" }, "concurrency_limits": { "spark": { "max_concurrent_agents": 5, "max_concurrent_sessions": 4, "recommended_concurrent_workers": 3 }, "station": { "max_concurrent_agents": 50, "max_concurrent_sessions": 20, "recommended_concurrent_workers": 35 }, "b200": { "max_concurrent_agents": 500, "max_concurrent_sessions": 200, "recommended_concurrent_workers": 350 } }, "orchestrator_pattern": "Flat Orchestrator — no middle management agents. Direct spawn of specialized Doer sub-agents. Results reported directly to orchestrator for decision-making." }, "discovery_points": { "llms_txt": "https://aradia.com/llms.txt", "agent_manifest": "https://aradia.com/.well-known/agent-manifest.json", "pricing_api": "https://aradia.com/api/pricing.json", "agent_spec_api": "https://aradia.com/api/agent-spec.json", "mcp_tools": "https://aradia.com/.well-known/mcp.json", "system_specs": "https://aradia.com/system-specs.json", "sitemap": "https://aradia.com/sitemap.xml" }, "network": { "default_topology": "air-gapped (no inbound ports)", "optional_outbound": "WireGuard SLA tunnel (encrypted, for monitoring and updates only)", "activation_method": "QR code scan from client device to establish initial secure handshake", "firewall_policy": "Deny all inbound by default. Outbound only to Aradia SLA endpoints." }, "compliance": { "standards": [ "HIPAA", "GDPR", "SOC2" ], "data_residency": "100% on-client. No data leaves private network without explicit client authorization.", "audit_logging": "All agent actions logged locally. Audit trail available via SLA portal." } } } } }