Deterministic Pre-Execution Carbon Routing
The developer hub for CO2 Router. Explore reproducible proof cases, test live pre-execution routing in the interactive sandbox, review our radical transparency post-mortems on failed approaches, and inspect our academic infrastructure maturity scoring.
Live Pre-Execution Decision Engine
Click "Run Live Decision →" to execute real-time pre-execution environmental routing.
Zero synthetic stubs. Validates live balancing authorities, water stress, and Ed25519 signature digest.
MCP Integration & SDK Installation
Deploy the pre-compiled standalone binary to any AI agent harness (Claude Desktop, Cursor, Windsurf, LangChain). Operates offline with zero cloud dependency.
npx -y @co2router/mcpco2router_route — Authorizes & routes pre-execution workloadsco2router_explain — Returns emissions & water reasoningco2router_proof — Verifies SHA-256 Merkle proofsco2router_replay — Proves deterministic replay invarianceroute:authorize, route:decide, route:executeWrap your existing LLM or batch dispatch calls with a single line of code. Automatic fallback and SLA protection.
import { CO2Router } from '@co2router/sdk';
const router = new CO2Router({ apiKey: process.env.CO2ROUTER_KEY });
const decision = await router.route({
target: 'openai:gpt-4o',
regions: ['us-east-1', 'eu-north-1', 'gb-south'],
slaMaxLatencyMs: 150
});What We Tried, What Failed, & Why We Cut It
Production systems are defined by what you refuse to compromise on. Here are the architectural dead-ends we encountered and purged.
Why Math.random() & Synthetic Carbon Curves Were Completely Ripped Out
What we tried: In early prototypes, when upstream regional grid balancing authorities suffered high latency, fallback adapters used statistical synthetic variations to estimate regional carbon intensity.
Why it failed: Corporate sustainability auditors and the GHG Protocol Corporate Standard (Scope 2 location-based accounting) reject any synthetic or non-anchored emissions claims as unverified greenwashing. If a platform claims carbon savings based on synthetic curves, the customer fails their SEC and EU CSRD audits.
Why Ambient Tool Authority Was Banned in AI Agent Contexts
What we tried: Giving AI agents ambient access to routing and payment tools without per-session capability-scoped cryptographic licenses.
Why it failed: Autonomous agents could suffer prompt injection, enter recursive execution loops, or exhaust enterprise compute budgets without organizational guardrails.
route:authorize, route:decide, route:execute).Why Decision Engine APIs Are Guarded on Private VPC Networks
What we tried: Exposing internal routing decisioning directly on public HTTP endpoints authenticated only by bearer tokens.
Why it failed: Public routing endpoints expose critical infrastructure to replay attacks, distributed denial-of-service, and network eavesdropping of sensitive compute telemetry.
/internal/v1/routing-decisions protected by internalServiceGuard. Public calls can only enter through the authenticated MCP or customer control plane broker.Infrastructure & Security Maturity Scorecard
Evaluated against NIST CSF 2.0, CIS Critical Security Controls v8, and GHG Protocol Scope 2 Quality Criteria.
Qualified for tier-1 financial, healthcare, and enterprise cloud routing workloads.
| Evaluation Dimension | Standard Framework | Score | Verified Architectural Evidence |
|---|---|---|---|
| 1. Telemetry Provenance & GHG Defensibility | GHG Protocol Scope 2 & ISO 14064-3 | 9.2 / 10 | 100% direct grid APIs (EIA-930, GB Carbon, Fingrid, Energi Data DK). Zero synthetic curve approximations. |
| 2. Cryptographic Non-Repudiation | RFC 8785 Canonical JSON & Ed25519 | 9.0 / 10 | Deterministic SHA-256 state receipts, Merkle tree root accumulation, and offline verifiable signatures. |
| 3. Access Control & Least Privilege | NIST SP 800-207 Zero Trust Architecture | 9.0 / 10 | Zero ambient authority. Multi-scope Ed25519 tokens (route:authorize, route:decide, route:execute). |
| 4. Financial Settlement Rails | x402 Protocol & ACID Invariants | 8.7 / 10 | Base Mainnet (eip155:8453) micro-settlement with deterministic receiptHash preventing double-billing. |
| 5. Fault Tolerance & Resilience | Google SRE Reliability Standards | 8.5 / 10 | Active circuit breakers (CLOSED → OPEN → HALF_OPEN), exponential retries, and database transaction rollbacks. |
| 6. Containerization & Orchestration | CIS Docker Benchmark v1.6 | 7.5 / 10 | Multi-stage Dockerfiles configured for rootless execution. Host port mapping isolated to prevent local collisions. |
Deploy the 6-Week Production Pilot
We partner directly with enterprise DevOps, SRE, and AI engineering teams to pilot CO2 Router in your environment with guaranteed zero disruption: