diff --git a/README.md b/README.md index cceaa4b..3e77536 100644 --- a/README.md +++ b/README.md @@ -10,10 +10,10 @@ Routstr Improvement Protocols (RIPs) are modular specification documents definin |---|---|---| | RIP-01 | [Proxy / Payments](RIP-01.md) | Standard for OpenAI-compatible API Proxy with integrated Cashu micropayments. | | RIP-02 | [Discovery](RIP-02.md) | Nostr event specifications for Provider Announcements (Kind 38421) and Recommendations (Kind 38000). | -| RIP-03 | [Client Specification](RIP-03.md) | Standards for client behavior, including ephemeral auth, wallet management, and auto-topup. | +| RIP-03 | [Clients](RIP-03.md) | Standards for client behavior, including ephemeral auth, wallet management, and auto-topup. | | RIP-04 | [Auditing](RIP-04.md) | Protocols for basic Uptime, Reliability, and Feature Verification checks. | -| RIP-05 | [Pricing Algorithm](RIP-05.md) | Standardized unit of account (Millisats), cost calculation logic, and client-side verification. | -| RIP-06 | [Routing Algorithms](RIP-06.md) | Algorithms for provider selection, scoring (Price/Trust/Perf), and failover hierarchies. | +| RIP-05 | [Pricing](RIP-05.md) | Standardized unit of account (Millisats), cost calculation logic, and client-side verification. | +| RIP-06 | [Routing](RIP-06.md) | Algorithms for provider selection, scoring (Price/Trust/Perf), and failover hierarchies. | | RIP-07 | [Admin API](RIP-07.md) | Internal API specification for node management (Settings, Upstreams, Models, Wallet). | | RIP-08 | [Payment Methods](RIP-08.md) | Gateways for funding sessions via Lightning (Bolt11), NWC, Bolt12, and On-Chain Bitcoin. | | RIP-09 | [Evaluations](RIP-09.md) | Advanced "Mystery Shopping" benchmarks for Model Authenticity, Performance, and Safety. | diff --git a/RIP-01.md b/RIP-01.md index 23a294f..627de1e 100644 --- a/RIP-01.md +++ b/RIP-01.md @@ -1,4 +1,4 @@ -# RIP-01: OpenAI-API Proxy with Cashu Payments +# RIP-01: Proxy / Payments Defines the HTTP proxy interface forwarding OpenAI-compatible API requests, with per-request micropayment handling via Cashu tokens. diff --git a/RIP-02.md b/RIP-02.md index 2f75692..8bb2e3b 100644 --- a/RIP-02.md +++ b/RIP-02.md @@ -1,4 +1,4 @@ -# RIP-02: Node Listing +# RIP-02: Discovery Nodes announce their presence and capabilities via Nostr events for client discovery, following NIP-91. diff --git a/RIP-03.md b/RIP-03.md index c3c248e..e3d4324 100644 --- a/RIP-03.md +++ b/RIP-03.md @@ -1,4 +1,4 @@ -# RIP-03: Client Specification +# RIP-03: Clients This document defines the standard behavior and architectural requirements for a Routstr client. A Routstr client acts as the bridge between user applications (agents, IDEs, scripts) and the distributed network of AI service providers. diff --git a/RIP-05.md b/RIP-05.md index 419e6f0..c1a5f8d 100644 --- a/RIP-05.md +++ b/RIP-05.md @@ -67,7 +67,7 @@ To prevent "hidden fees" or overcharging, clients should verify the cost charged 2. **Track Usage**: The client records the `usage` (prompt_tokens, completion_tokens) returned in the API response. 3. **Calculate Expected Cost**: - ```python + ``` Expected_Cost = (usage.prompt_tokens * cached_rates.prompt) + (usage.completion_tokens * cached_rates.completion) + ... @@ -75,7 +75,7 @@ To prevent "hidden fees" or overcharging, clients should verify the cost charged 4. **Calculate Actual Cost**: - ```python + ``` Actual_Cost = Original_Token_Value - Refunded_Token_Value ``` diff --git a/RIP-06.md b/RIP-06.md index 862f8a5..c0a3aa5 100644 --- a/RIP-06.md +++ b/RIP-06.md @@ -1,4 +1,4 @@ -# RIP-06: Routing Algorithms +# RIP-06: Routing This document defines standard algorithms for provider selection, scoring, and failover. These algorithms are shared across the ecosystem—used by smart clients for local selection and by routing nodes (aggregators) for recursive request handling.