# BandwidthGuard Comprehensive System Reference (Stop Paying for Bloated API Payloads)

BandwidthGuard is a free, 100% in-browser developer utility engineered to analyze JSON API payloads, benchmark multi-codec compression (Gzip, Brotli, Zstandard, MessagePack, CBOR), calculate bloat scores (0-100), simulate cloud data transfer (egress) costs across AWS, GCP, Azure, Cloudflare, Fastly, and generate safe contract rewrites and AI prompts.

## Key URLs
- **Landing Page**: https://bandwidthguard.chidkoli.com
- **Analyzer Application**: https://bandwidthguard.chidkoli.com/analyze
- **LLM Summary**: https://bandwidthguard.chidkoli.com/llms.txt
- **Sitemap**: https://bandwidthguard.chidkoli.com/sitemap.xml
- **Author**: Avi Natani (avinatani20@gmail.com)

## Privacy & Security Architecture
- Everything executes client-side in the user's browser using Web Workers and WebAssembly.
- Zero server uploads.
- Zero telemetry or analytics tracking.
- State is persisted solely in the browser's `localStorage` and optionally encoded into URL hash fragments (`#...`) for private sharing.

## Optimization Rules & Diagnostics
1. **Null Stripping**: Remove unneeded `key: null` pairs in JSON serializers where fields are optional.
2. **ISO 8601 to Unix Epoch**: Replace 24-byte strings like `"2026-08-31T12:00:00.000Z"` with 10-digit integers (`1788177600`), saving 14+ bytes per timestamp.
3. **Float Precision Truncation**: Truncate excessive decimal precision (>4 decimal places) on latitude, longitude, and currency calculations.
4. **Columnar Array Structuring**: For arrays of uniform objects `[{"id": 1, "name": "A"}, {"id": 2, "name": "B"}]`, convert to columnar format `{"keys": ["id", "name"], "rows": [[1, "A"], [2, "B"]]}`.
5. **Default Value Omission**: Omit implicit default values (`false`, `0`, `""`) when the client assumes default values.
6. **Binary Codecs**: Use MessagePack (`@msgpack/msgpack`) or CBOR (`cbor-x`) to eliminate string key repetition and string parsing overhead in high-throughput microservices.

## Cloud Bandwidth Pricing Model (USD per GB Egress)
- **AWS EC2**: ~$0.09 / GB (US/EU), higher in APAC/SA.
- **AWS CloudFront**: ~$0.085 / GB.
- **Google Cloud Compute Engine**: ~$0.085 - $0.12 / GB.
- **Google Cloud CDN**: ~$0.08 / GB.
- **Microsoft Azure**: ~$0.087 / GB.
- **Cloudflare**: $0.00 / GB (Free Egress Bandwidth Alliance).
- **Fastly**: ~$0.12 / GB.
- **Hetzner**: ~$0.001 / GB (20TB included).