CO2 Router.DEV
Technical Documentation, APIs, & Cryptographic Proofs
Auditable Developer Infrastructure

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.

Reproducible Interactive Sandbox

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.

Developer Packages

MCP Integration & SDK Installation

Model Context Protocol (MCP)Production Ready

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/mcp
• co2router_route — Authorizes & routes pre-execution workloads
• co2router_explain — Returns emissions & water reasoning
• co2router_proof — Verifies SHA-256 Merkle proofs
• co2router_replay — Proves deterministic replay invariance
Requires Ed25519 entitlement token: route:authorize, route:decide, route:execute
TypeScript / Python SDKv1.0.1

Wrap 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
});
Dual Payment Rails SupportedBase x402 + Stripe
Engineering Transparency

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.

[REJECTED & PURGED] Synthetic Provider AdaptersZero-Mock Mandate

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.

Current Production Architecture: 100% direct telemetry from verified grid operators (EIA-930, GB Carbon Intensity, Energi Data DK, Fingrid, WattTime MOER) backed by local Redis TTL caching. If no verified grid authority is available, the decision fails open safely with an explicit telemetry flag, never a fake number.
[REJECTED & PURGED] Ambient Tool AuthoritySecurity Law

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.

Current Production Architecture: Mandatory Ed25519 entitlement token validation. Every agent request requires a signed license verifying installation audience and discrete scopes (route:authorize, route:decide, route:execute).
[REJECTED & PURGED] Public HTTP Engine ExposurePrivate-by-Contract

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.

Current Production Architecture: The decision engine runs strictly private-by-contract at /internal/v1/routing-decisions protected by internalServiceGuard. Public calls can only enter through the authenticated MCP or customer control plane broker.
Academic & Industry Standards

Infrastructure & Security Maturity Scorecard

Evaluated against NIST CSF 2.0, CIS Critical Security Controls v8, and GHG Protocol Scope 2 Quality Criteria.

Composite Maturity Rating
8.8 / 10 — Enterprise Grade Production

Qualified for tier-1 financial, healthcare, and enterprise cloud routing workloads.

Audit Status: VERIFIED ZERO-MOCK
CI/CD Pipeline: 550 TESTS PASSING
Idempotency: SHA-256 ACID BOUND
Evaluation DimensionStandard FrameworkScoreVerified Architectural Evidence
1. Telemetry Provenance & GHG DefensibilityGHG Protocol Scope 2 & ISO 14064-39.2 / 10100% direct grid APIs (EIA-930, GB Carbon, Fingrid, Energi Data DK). Zero synthetic curve approximations.
2. Cryptographic Non-RepudiationRFC 8785 Canonical JSON & Ed255199.0 / 10Deterministic SHA-256 state receipts, Merkle tree root accumulation, and offline verifiable signatures.
3. Access Control & Least PrivilegeNIST SP 800-207 Zero Trust Architecture9.0 / 10Zero ambient authority. Multi-scope Ed25519 tokens (route:authorize, route:decide, route:execute).
4. Financial Settlement Railsx402 Protocol & ACID Invariants8.7 / 10Base Mainnet (eip155:8453) micro-settlement with deterministic receiptHash preventing double-billing.
5. Fault Tolerance & ResilienceGoogle SRE Reliability Standards8.5 / 10Active circuit breakers (CLOSED → OPEN → HALF_OPEN), exponential retries, and database transaction rollbacks.
6. Containerization & OrchestrationCIS Docker Benchmark v1.67.5 / 10Multi-stage Dockerfiles configured for rootless execution. Host port mapping isolated to prevent local collisions.
Go-To-Market Program

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:

Week 1: Passive Telemetry & Emissions Audit
Weeks 2–3: Shadow Routing & Policy Calibration
Weeks 4–5: Live Pre-Execution Dispatch
Week 6: Executive ESG & ROI Report
Schedule Technical Onboarding Call →