# Aurelius Node 02 — SoCal Pacific Gateway Industrial & Logistics Ground-Truth Node

> Real-time, machine-readable ground-truth oracle for Southern California Pacific Gateway (LA/Long Beach Ports / Alameda Corridor / Inland Empire / Otay Mesa) maritime, intermodal rail, freight trucking, warehousing, air cargo, and energy grid compliance logistics.

## Overview & Agent Capabilities
Aurelius Node 02 operates as an autonomous, high-frequency telemetry node providing verified physical supply chain data across the SoCal logistics ecosystem.

- **Primary Data:** Vessel queues & dwell times, truck gate turn times, Alameda Corridor daily train counts, intermodal rail capacity & spot rates, heavy freight corridor truck speeds, Class-A warehouse vacancy & lease rates, air cargo throughput, CARB compliance, and cross-border wait times.
- **Data Schema:** Machine-readable JSON including \`item_key\`, \`category\`, \`label\`, \`current_value\`, \`unit_of_measure\`, \`trend_direction\`, \`benchmark_baseline\`, \`hub_location\`, \`source_provider\`, \`data_tier\`, and \`status\`.
- **Data Freshness:** Dynamically synced across live oracle telemetry and daily index feeds covering 42 key supply chain indicators.

## System Manifest & x402 Payment Protocol
This node is fully autonomous and micropayment-gated via the **x402 Protocol**.

- **Protocol:** x402 / EIP-3009 (Micropayment Gated)
- **Settlement Network:** Base Mainnet (Chain ID: \`8453\`)
- **Cost:** $0.05 USDC per query
- **Payment Mechanism:** Requires EIP-3009 signed payment authorization payload in the \`x-402-authorization\` request header.

## API Endpoints & Discovery Manifests

### Core Data Matrix
- \`GET https://aurelius-node-02-socal.onrender.com/api/v1/supply\`
  - **Access:** Requires valid x402 payment signature ($0.05 USDC).
  - **Returns:** Full JSON payload containing live 42-item SoCal inventory matrix, port dwell, rail counts, freight rates, and system timestamps.

### System Verification & Metadata
- \`GET https://aurelius-node-02-socal.onrender.com/health\` : Node health status and latency metrics.
- \`GET https://aurelius-node-02-socal.onrender.com/.well-known/agent.json\` : Machine-readable agent discovery manifest and x402 metadata.
- \`GET https://aurelius-node-02-socal.onrender.com/robots.txt\` : Web crawler and automated agent indexing policies.
- \`GET https://aurelius-node-02-socal.onrender.com/.well-known/x402.json\`

## Operator Details
- **Operator:** Aurelius Autonomous Data Systems
- **Coverage Region:** Southern California Pacific Gateway (San Pedro Bay Ports / Alameda Corridor / Inland Empire / Otay Mesa)

## MCP & Tool Integrations
- OpenAPI Spec: https://aurelius-node-02-socal.onrender.com/openapi.json
- x402 Manifest: https://aurelius-node-02-socal.onrender.com/.well-known/agent.json