From 91dcde6aabdf45965d5c5c061054f331c858cdfb Mon Sep 17 00:00:00 2001
From: Sulkta <oss@sulkta.com>
Date: Sun, 10 May 2026 18:24:57 -0700
Subject: [PATCH] docs: scrub internal host references from public docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Removed mentions of dedicated servers + Sulkta-runs-its-own-Koios claims from
README + module doc-comments + Cargo.toml descriptions. aldabra works
against any Koios endpoint — public api.koios.rest, preprod/preview,
or operator-self-hosted — so the docs now reflect that capability
neutrally instead of advertising our internal infra.
---
 README.md                         | 6 +++---
 crates/aldabra-chain/Cargo.toml   | 4 ++--
 crates/aldabra-chain/src/koios.rs | 4 ++--
 crates/aldabra-chain/src/lib.rs   | 6 ++++--
 4 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index b5535e3..83e85cd 100644
--- a/README.md
+++ b/README.md
@@ -11,9 +11,9 @@ for LLM-first usage (send, receive, mint, Plutus interaction).
 The existing Cardano MCP servers are either read-only doc gateways
 ([Jimmyh-world/Cardano_MCP](https://github.com/Jimmyh-world/Cardano_MCP))
 or built on Blockfrost ([web3-mcp](https://github.com/strangelove-ventures/web3-mcp))
-which is a centralized API we deliberately don't depend on. Sulkta
-runs its own Koios + Ogmios endpoints on dedicated servers; we want a wallet
-that talks directly to those.
+which is a centralized API we deliberately don't depend on. We want a
+wallet that talks directly to Koios + Ogmios endpoints — public, self-
+hosted, or whatever the operator points it at.
 
 Also: it's the first Sulkta Rust project — useful as a workout for
 ci-runner's Rust toolchain (per `Sulkta-Coop/infra-repo`
diff --git a/crates/aldabra-chain/Cargo.toml b/crates/aldabra-chain/Cargo.toml
index cc1e50d..4ee0445 100644
--- a/crates/aldabra-chain/Cargo.toml
+++ b/crates/aldabra-chain/Cargo.toml
@@ -1,8 +1,8 @@
 # aldabra-chain — pluggable backends for chain queries.
 #
 # A `ChainBackend` trait abstracts over Koios (HTTPS), Ogmios (WS/HTTP),
-# or any future option. Phase 1 ships with a Koios implementation since
-# Sulkta already runs Koios endpoints.
+# or any future option. Phase 1 ships with a Koios implementation
+# pointing at the public `api.koios.rest` instance by default.
 #
 # Submission paths land in phase 2. Read-only queries first.
 
diff --git a/crates/aldabra-chain/src/koios.rs b/crates/aldabra-chain/src/koios.rs
index 92e6e36..72a6270 100644
--- a/crates/aldabra-chain/src/koios.rs
+++ b/crates/aldabra-chain/src/koios.rs
@@ -15,8 +15,8 @@
 //! - preprod:  `https://preprod.koios.rest/api/v1`
 //! - preview:  `https://preview.koios.rest/api/v1`
 //!
-//! Sulkta-hosted Koios on dedicated servers (when it lands) drops in here too —
-//! it's the same API.
+//! A self-hosted Koios deployment drops in transparently — same API,
+//! whatever URL the operator points at.
 
 use std::collections::BTreeMap;
 use std::time::Duration;
diff --git a/crates/aldabra-chain/src/lib.rs b/crates/aldabra-chain/src/lib.rs
index 03927e0..702a0ec 100644
--- a/crates/aldabra-chain/src/lib.rs
+++ b/crates/aldabra-chain/src/lib.rs
@@ -12,8 +12,10 @@
 //! ## Backends
 //!
 //! - [`koios::KoiosClient`] — Koios REST client (POST `/address_utxos`,
-//!   `/address_info`). Sulkta runs its own Koios on dedicated servers; the
-//!   public `https://api.koios.rest/api/v1` works as a fallback.
+//!   `/address_info`). Points at any Koios endpoint —
+//!   `https://api.koios.rest/api/v1` for the public mainnet instance,
+//!   the preprod/preview equivalents for testnets, or a self-hosted
+//!   Koios at any URL.
 //! - Ogmios (TODO) — websocket client.
 
 use serde::{Deserialize, Serialize};