Sulkta-OSS/aldabra
3
0
Fork 0
Code Issues 1 Pull requests 5 Projects Releases Packages Wiki Activity Actions

docs: scrub internal host references from public docs

Browse source 
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.
This commit is contained in:
Sulkta 2026-05-10 18:24:57 -07:00
parent 2587143a03
commit 91dcde6aab
4 changed files with 11 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

6
README.md
View file

@ -11,9 +11,9 @@ for LLM-first usage (send, receive, mint, Plutus interaction).
The existing Cardano MCP servers are either read-only doc gateways The existing Cardano MCP servers are either read-only doc gateways
([Jimmyh-world/Cardano_MCP](https://github.com/Jimmyh-world/Cardano_MCP)) ([Jimmyh-world/Cardano_MCP](https://github.com/Jimmyh-world/Cardano_MCP))
or built on Blockfrost ([web3-mcp](https://github.com/strangelove-ventures/web3-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 which is a centralized API we deliberately don't depend on. We want a
runs its own Koios + Ogmios endpoints on dedicated servers; we want a wallet wallet that talks directly to Koios + Ogmios endpoints — public, self-
that talks directly to those. hosted, or whatever the operator points it at.
Also: it's the first Sulkta Rust project — useful as a workout for Also: it's the first Sulkta Rust project — useful as a workout for
ci-runner's Rust toolchain (per `Sulkta-Coop/infra-repo` ci-runner's Rust toolchain (per `Sulkta-Coop/infra-repo`

4
crates/aldabra-chain/Cargo.toml
View file

@ -1,8 +1,8 @@
# aldabra-chain — pluggable backends for chain queries. # aldabra-chain — pluggable backends for chain queries.
# #
# A `ChainBackend` trait abstracts over Koios (HTTPS), Ogmios (WS/HTTP), # A `ChainBackend` trait abstracts over Koios (HTTPS), Ogmios (WS/HTTP),
# or any future option. Phase 1 ships with a Koios implementation since # or any future option. Phase 1 ships with a Koios implementation
# Sulkta already runs Koios endpoints. # pointing at the public `api.koios.rest` instance by default.
# #
# Submission paths land in phase 2. Read-only queries first. # Submission paths land in phase 2. Read-only queries first.

4
crates/aldabra-chain/src/koios.rs
View file

@ -15,8 +15,8 @@
//! - preprod: `https://preprod.koios.rest/api/v1` //! - preprod: `https://preprod.koios.rest/api/v1`
//! - preview: `https://preview.koios.rest/api/v1` //! - preview: `https://preview.koios.rest/api/v1`
//! //!
//! Sulkta-hosted Koios on dedicated servers (when it lands) drops in here too — //! A self-hosted Koios deployment drops in transparently — same API,
//! it's the same API. //! whatever URL the operator points at.
use std::collections::BTreeMap; use std::collections::BTreeMap;
use std::time::Duration; use std::time::Duration;

6
crates/aldabra-chain/src/lib.rs
View file

@ -12,8 +12,10 @@
//! ## Backends //! ## Backends
//! //!
//! - [`koios::KoiosClient`] — Koios REST client (POST `/address_utxos`, //! - [`koios::KoiosClient`] — Koios REST client (POST `/address_utxos`,
//! `/address_info`). Sulkta runs its own Koios on dedicated servers; the //! `/address_info`). Points at any Koios endpoint —
//! public `https://api.koios.rest/api/v1` works as a fallback. //! `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. //! - Ogmios (TODO) — websocket client.
use serde::{Deserialize, Serialize}; use serde::{Deserialize, Serialize};