From a40cf60d5dff114bfd82aa74db767433564a29c0 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Sat, 23 May 2026 06:32:21 +0530
Subject: Phase 10a: component metadata v1.1.0, README, CHANGELOG

- idf_component.yml updated: v1.1.0, description, url, IDF >=5.3
- README.md with integration guide, API reference, dependencies
- CHANGELOG.md tracking v1.0.0 and v1.1.0 releases
- All 21 unit tests pass, ESP-IDF build passes
---
 components/tollgate_core/CHANGELOG.md      | 19 ++++++++
 components/tollgate_core/README.md         | 71 ++++++++++++++++++++++++++++++
 components/tollgate_core/idf_component.yml | 13 ++++--
 3 files changed, 99 insertions(+), 4 deletions(-)
 create mode 100644 components/tollgate_core/CHANGELOG.md
 create mode 100644 components/tollgate_core/README.md

(limited to 'components')

diff --git a/components/tollgate_core/CHANGELOG.md b/components/tollgate_core/CHANGELOG.md
new file mode 100644
index 0000000..b6d664f
--- /dev/null
+++ b/components/tollgate_core/CHANGELOG.md
@@ -0,0 +1,19 @@
+# Changelog
+
+## 1.1.0 (2026-05-23)
+
+- Added `tollgate_core_beacon` — WiFi vendor IE construction (hash_mint, hash_npub, build_ie)
+- Added `tollgate_core_market` — market table logic (parse_ie, find_cheapest, update_ssid)
+- Platform-agnostic `tollgate_beacon_config_t` input struct for IE construction
+- `tollgate_vendor_ie_t` abstraction decouples market parsing from ESP WiFi types
+
+## 1.0.0 (2026-05-22)
+
+- Initial release
+- Session management (time + bytes based)
+- Cashu token decode and allotment calculation
+- Per-client firewall with sandbox mode
+- DNS server with per-client hijack/forward
+- Mining payment tracking (nbits→difficulty, hashprice, share→allotment)
+- Stratum proxy with job management
+- Platform abstraction via `tollgate_platform_t` callbacks
diff --git a/components/tollgate_core/README.md b/components/tollgate_core/README.md
new file mode 100644
index 0000000..d83d634
--- /dev/null
+++ b/components/tollgate_core/README.md
@@ -0,0 +1,71 @@
+# tollgate_core
+
+ESP-IDF component providing paid WiFi hotspot logic with Cashu e-cash payments.
+
+## Features
+
+- **Session management** — time-based and bytes-based sessions with auto-expiry
+- **Cashu token processing** — decode Cashu e-cash tokens, calculate allotments, multi-mint support
+- **Per-client firewall** — whitelist-based NAT filtering with sandbox mode
+- **DNS server** — per-client DNS hijack/forward with DoT rejection
+- **Mining payment** — Stratum share tracking, hashprice calculation, difficulty conversion
+- **Stratum proxy** — transparent TCP proxy for mining traffic with job management
+- **Beacon price** — WiFi vendor IE construction for price/mint/geohash advertising
+- **Market scanner** — discover and compare nearby TollGate prices
+
+## Integration
+
+### 1. Implement platform callbacks
+
+```c
+#include "tollgate_platform.h"
+
+static tollgate_platform_t platform = {
+    .get_price_sats = my_get_price,
+    .get_step_ms = my_get_step_ms,
+    .get_mint_url = my_get_mint_url,
+    .get_metric = my_get_metric,
+    .get_time_ms = my_get_time_ms,
+    // ... other callbacks
+};
+```
+
+### 2. Initialize
+
+```c
+#include "tollgate_core.h"
+
+esp_ip4_addr_t ap_ip;
+IP4_ADDR(&ap_ip, 192, 168, 4, 1);
+tollgate_core_init(&platform, ap_ip);
+
+esp_ip4_addr_t dns;
+IP4_ADDR(&dns, 8, 8, 8, 8);
+tollgate_core_dns_start(dns);
+```
+
+### 3. Process payments
+
+```c
+tollgate_core_process_payment(client_ip, cashu_token_string);
+```
+
+### 4. Tick
+
+Call `tollgate_core_tick()` periodically (e.g., every second) to expire sessions.
+
+## API Reference
+
+See `include/tollgate_core.h` for the public API and `include/tollgate_platform.h` for platform callbacks.
+
+## Dependencies
+
+- ESP-IDF >= 5.3
+- mbedtls (SHA-256, HMAC)
+- cJSON
+- lwip
+- esp_wifi (for beacon/market features)
+
+## License
+
+Proprietary — see repository for details.
diff --git a/components/tollgate_core/idf_component.yml b/components/tollgate_core/idf_component.yml
index 112aa18..cdf2ee3 100644
--- a/components/tollgate_core/idf_component.yml
+++ b/components/tollgate_core/idf_component.yml
@@ -1,6 +1,11 @@
-version: "1.0.0"
-description: TollGate core component — Cashu payment processing, per-client DNS/firewall, session management for paid WiFi hotspots
-url: https://github.com/nicoulaj/esp32-tollgate
+version: "1.1.0"
+description: |
+  TollGate core component for paid WiFi hotspots with Cashu e-cash payments.
+  Provides session management, per-client DNS/firewall, Cashu token processing,
+  mining payment tracking, beacon price advertising, and market scanning.
+  Platform-agnostic via tollgate_platform_t callbacks for easy integration
+  with any ESP32 firmware (TollGate, NerdQAxePlus, BitAxe, etc.).
+url: https://git.orangesync.tech/npub12m5exm2uk3xa674cc5r0hlyvccs5xxn7qv83ezuteefv5972nquq4j4szl/esp32-tollgate
 dependencies:
   idf:
-    version: ">=5.4.0"
+    version: ">=5.3.0"
-- 
cgit v1.2.3