obyte-mcp 0.1.1 → 0.2.0

package/dist/amounts.d.ts

@@ -0,0 +1,43 @@
+import type { AaStateVarsReader, SymbolOptions } from "./symbols.js";
+import type { Network } from "./types.js";
+export declare const BASE_DECIMALS = 9;
+export declare const AMOUNTS_NOTE = "Raw on-ledger amounts are integers in the asset's smallest units. display_total is already divided by 10^decimals; present display values to users, never raw integers. base is GBYTE with 9 decimals. explorer_asset_url lists the asset's description and holders (explorer amounts are already in display units).";
+/** Explorer page listing an asset's description and holders. */
+export declare function assetExplorerUrl(network: Network, symbolOrAsset: string): string;
+export interface AssetAmountSummary {
+    asset: string;
+    symbol: string | null;
+    decimals: number | null;
+    raw_total: number;
+    display_total: string | null;
+    explorer_asset_url?: string;
+}
+export interface BalanceAmountSummary {
+    totals_by_asset: Record<string, AssetAmountSummary>;
+    amounts_note: string;
+    unresolved_assets?: string[];
+}
+/**
+ * Converts a raw smallest-units integer into a human display string without
+ * floating point artifacts, e.g. formatAmount(2500000000, 9) === "2.5".
+ */
+export declare function formatAmount(rawAmount: number, decimals: number): string | null;
+/**
+ * Sums raw amounts per asset from either hub balance shape:
+ * - get_balances: { address: { asset: { stable, pending } } }
+ * - AA balances:  { asset: number }
+ */
+export declare function collectAssetTotals(balances: unknown): Record<string, number>;
+export interface SummarizeOptions extends SymbolOptions {
+    resolve?: boolean;
+    maxResolvedAssets?: number;
+    /** When set, each asset summary gets an explorer_asset_url for that network. */
+    network?: Network;
+}
+/**
+ * Builds a per-asset totals summary with symbols, decimals, and display amounts.
+ * base always resolves to GBYTE/9 without touching the registry; custom assets
+ * are resolved through the registry when available, failures degrade to nulls
+ * and are listed in unresolved_assets so agents know to resolve before display.
+ */
+export declare function summarizeBalanceAmounts(reader: AaStateVarsReader, balances: unknown, options?: SummarizeOptions): Promise<BalanceAmountSummary>;

package/dist/amounts.js

@@ -0,0 +1,117 @@
+import { MAINNET_EXPLORER, TESTNET_EXPLORER } from "./constants.js";
+import { isPlainObject } from "./jsonUtils.js";
+import { getDecimalsBySymbolOrAsset, getSymbolByAsset } from "./symbols.js";
+export const BASE_DECIMALS = 9;
+export const AMOUNTS_NOTE = "Raw on-ledger amounts are integers in the asset's smallest units. display_total is already divided by 10^decimals; present display values to users, never raw integers. base is GBYTE with 9 decimals. explorer_asset_url lists the asset's description and holders (explorer amounts are already in display units).";
+/** Explorer page listing an asset's description and holders. */
+export function assetExplorerUrl(network, symbolOrAsset) {
+    const base = network === "testnet" ? TESTNET_EXPLORER : MAINNET_EXPLORER;
+    return `${base}/asset/${encodeURIComponent(symbolOrAsset)}`;
+}
+/**
+ * Converts a raw smallest-units integer into a human display string without
+ * floating point artifacts, e.g. formatAmount(2500000000, 9) === "2.5".
+ */
+export function formatAmount(rawAmount, decimals) {
+    if (typeof rawAmount !== "number" || !Number.isFinite(rawAmount))
+        return null;
+    if (!Number.isInteger(decimals) || decimals < 0 || decimals > 30)
+        return null;
+    if (decimals === 0)
+        return String(rawAmount);
+    if (!Number.isSafeInteger(rawAmount))
+        return String(rawAmount / 10 ** decimals);
+    const negative = rawAmount < 0;
+    const digits = String(Math.abs(rawAmount)).padStart(decimals + 1, "0");
+    const whole = digits.slice(0, -decimals);
+    const frac = digits.slice(-decimals).replace(/0+$/, "");
+    return `${negative ? "-" : ""}${whole}${frac ? `.${frac}` : ""}`;
+}
+/**
+ * Sums raw amounts per asset from either hub balance shape:
+ * - get_balances: { address: { asset: { stable, pending } } }
+ * - AA balances:  { asset: number }
+ */
+export function collectAssetTotals(balances) {
+    const totals = {};
+    if (!isPlainObject(balances))
+        return totals;
+    const add = (asset, value) => {
+        let raw;
+        if (typeof value === "number") {
+            raw = value;
+        }
+        else if (isPlainObject(value)) {
+            const stable = typeof value.stable === "number" ? value.stable : 0;
+            const pending = typeof value.pending === "number" ? value.pending : 0;
+            raw = stable + pending;
+        }
+        if (raw !== undefined)
+            totals[asset] = (totals[asset] ?? 0) + raw;
+    };
+    for (const [key, entry] of Object.entries(balances)) {
+        const values = isPlainObject(entry) ? Object.values(entry) : [];
+        if (values.length > 0 && values.every((value) => isPlainObject(value))) {
+            // Address -> asset map (get_balances shape); sum across addresses.
+            for (const [asset, value] of Object.entries(entry))
+                add(asset, value);
+        }
+        else {
+            add(key, entry);
+        }
+    }
+    return totals;
+}
+/**
+ * Builds a per-asset totals summary with symbols, decimals, and display amounts.
+ * base always resolves to GBYTE/9 without touching the registry; custom assets
+ * are resolved through the registry when available, failures degrade to nulls
+ * and are listed in unresolved_assets so agents know to resolve before display.
+ */
+export async function summarizeBalanceAmounts(reader, balances, options = {}) {
+    const totals = collectAssetTotals(balances);
+    const customAssets = Object.keys(totals).filter((asset) => asset !== "base");
+    const maxResolved = options.maxResolvedAssets ?? 10;
+    const toResolve = options.resolve === false ? [] : customAssets.slice(0, maxResolved);
+    const resolved = new Map(await Promise.all(toResolve.map(async (asset) => {
+        const [symbol, decimals] = await Promise.all([
+            getSymbolByAsset(reader, asset, options).catch(() => null),
+            getDecimalsBySymbolOrAsset(reader, asset, options).catch(() => null)
+        ]);
+        return [asset, { symbol, decimals }];
+    })));
+    const totalsByAsset = {};
+    const unresolved = [];
+    for (const [asset, rawTotal] of Object.entries(totals)) {
+        if (asset === "base") {
+            totalsByAsset[asset] = {
+                asset,
+                symbol: "GBYTE",
+                decimals: BASE_DECIMALS,
+                raw_total: rawTotal,
+                display_total: formatAmount(rawTotal, BASE_DECIMALS),
+                ...(options.network ? { explorer_asset_url: assetExplorerUrl(options.network, "GBYTE") } : {})
+            };
+            continue;
+        }
+        const info = resolved.get(asset);
+        const decimals = info?.decimals ?? null;
+        const symbol = info?.symbol ?? null;
+        totalsByAsset[asset] = {
+            asset,
+            symbol,
+            decimals,
+            raw_total: rawTotal,
+            display_total: decimals === null ? null : formatAmount(rawTotal, decimals),
+            // Unknown assets get a prefix fallback "symbol"; only registry-confirmed symbols make clean explorer URLs.
+            ...(options.network ? { explorer_asset_url: assetExplorerUrl(options.network, decimals !== null && symbol ? symbol : asset) } : {})
+        };
+        if (decimals === null)
+            unresolved.push(asset);
+    }
+    const summary = { totals_by_asset: totalsByAsset, amounts_note: AMOUNTS_NOTE };
+    if (unresolved.length > 0)
+        summary.unresolved_assets = unresolved;
+    return summary;
+}
+//# sourceMappingURL=amounts.js.map

package/dist/amounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amounts.js","sourceRoot":"","sources":["../src/amounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAI5E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,MAAM,CAAC,MAAM,YAAY,GACvB,sTAAsT,CAAC;AAEzT,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,aAAqB;IACtE,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACzE,OAAO,GAAG,IAAI,UAAU,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC;AAC9D,CAAC;AAiBD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,QAAgB;IAC9D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9E,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,MAAM,CAAC,SAAS,GAAG,EAAE,IAAI,QAAQ,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IAE5C,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,KAAc,EAAQ,EAAE;QAClD,IAAI,GAAuB,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,GAAG,GAAG,KAAK,CAAC;QACd,CAAC;aAAM,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC;QACzB,CAAC;QACD,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;IACpE,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvE,mEAAmE;YACnE,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;gBAAE,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnG,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AASD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAyB,EACzB,QAAiB,EACjB,UAA4B,EAAE;IAE9B,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAEtF,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,MAAM,OAAO,CAAC,GAAG,CACf,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YAC1D,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SACrE,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAU,CAAC;IAChD,CAAC,CAAC,CACH,CACF,CAAC;IAEF,MAAM,aAAa,GAAuC,EAAE,CAAC;IAC7D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACrB,aAAa,CAAC,KAAK,CAAC,GAAG;gBACrB,KAAK;gBACL,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,aAAa;gBACvB,SAAS,EAAE,QAAQ;gBACnB,aAAa,EAAE,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC;gBACpD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/F,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC;QACpC,aAAa,CAAC,KAAK,CAAC,GAAG;YACrB,KAAK;YACL,MAAM;YACN,QAAQ;YACR,SAAS,EAAE,QAAQ;YACnB,aAAa,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC;YAC1E,2GAA2G;YAC3G,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpI,CAAC;QACF,IAAI,QAAQ,KAAK,IAAI;YAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAyB,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;IACrG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,iBAAiB,GAAG,UAAU,CAAC;IAClE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cliArgs.d.ts

@@ -1,6 +1,7 @@
 import type { CliOptions } from "./types.js";
-export type CommandName = "server" | "setup" | "doctor" | "help" | "version";
-export type ClientName = "codex" | "claude-desktop" | "claude-code";
+export type CommandName = "server" | "setup" | "install" | "doctor" | "help" | "version";
+export type ClientName = "codex" | "claude-desktop" | "claude-code" | "vscode";
+export declare const CLIENT_NAMES: readonly ClientName[];
 export interface ParsedCli {
     command: CommandName;
     options: CliOptions;
@@ -8,6 +9,11 @@ export interface ParsedCli {
         printOnly: boolean;
         client?: ClientName;
     };
+    install: {
+        dryRun: boolean;
+        client?: ClientName;
+        serverName?: string;
+    };
     doctor: {
         json: boolean;
     };

package/dist/cliArgs.js

@@ -1,15 +1,17 @@
 import { ObyteMcpError } from "./errors.js";
 import { parseNetwork } from "./config.js";
+export const CLIENT_NAMES = ["vscode", "codex", "claude-desktop", "claude-code"];
 export function parseCliArgs(argv) {
     const parsed = {
         command: "server",
         options: {},
         setup: { printOnly: false },
+        install: { dryRun: false },
         doctor: { json: false }
     };
     const args = [...argv];
     const first = args[0];
-    if (first === "setup" || first === "doctor") {
+    if (first === "setup" || first === "install" || first === "doctor") {
         parsed.command = first;
         args.shift();
     }
@@ -29,6 +31,10 @@ export function parseCliArgs(argv) {
             parsed.setup.printOnly = true;
             continue;
         }
+        if (arg === "--dry-run") {
+            parsed.install.dryRun = true;
+            continue;
+        }
         if (arg === "--json") {
             parsed.doctor.json = true;
             continue;
@@ -49,6 +55,26 @@ export function parseCliArgs(argv) {
             index += 1;
             continue;
         }
+        if (arg === "--mainnet-hub") {
+            parsed.options.mainnetHubAddress = requireString(next, "--mainnet-hub");
+            index += 1;
+            continue;
+        }
+        if (arg === "--testnet-hub") {
+            parsed.options.testnetHubAddress = requireString(next, "--testnet-hub");
+            index += 1;
+            continue;
+        }
+        if (arg === "--mainnet-token-registry") {
+            parsed.options.mainnetTokenRegistryAddress = requireString(next, "--mainnet-token-registry");
+            index += 1;
+            continue;
+        }
+        if (arg === "--testnet-token-registry") {
+            parsed.options.testnetTokenRegistryAddress = requireString(next, "--testnet-token-registry");
+            index += 1;
+            continue;
+        }
         if (arg === "--timeout-ms") {
             parsed.options.timeoutMs = parseInteger(requireString(next, "--timeout-ms"), "--timeout-ms");
             index += 1;
@@ -65,7 +91,14 @@ export function parseCliArgs(argv) {
             continue;
         }
         if (arg === "--client") {
-            parsed.setup.client = parseClient(requireString(next, "--client"));
+            const client = parseClient(requireString(next, "--client"));
+            parsed.setup.client = client;
+            parsed.install.client = client;
+            index += 1;
+            continue;
+        }
+        if (arg === "--name") {
+            parsed.install.serverName = requireString(next, "--name");
             index += 1;
             continue;
         }
@@ -90,8 +123,8 @@ function parseInteger(value, label) {
     return number;
 }
 function parseClient(value) {
-    if (value === "codex" || value === "claude-desktop" || value === "claude-code")
+    if (value === "codex" || value === "claude-desktop" || value === "claude-code" || value === "vscode")
         return value;
-    throw new ObyteMcpError("CONFIG_ERROR", "--client must be codex, claude-desktop, or claude-code", { value });
+    throw new ObyteMcpError("CONFIG_ERROR", "--client must be vscode, codex, claude-desktop, or claude-code", { value });
 }
 //# sourceMappingURL=cliArgs.js.map

package/dist/cliArgs.js.map

@@ -1 +1 @@
-{"version":3,"file":"cliArgs.js","sourceRoot":"","sources":["../src/cliArgs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cliArgs.js","sourceRoot":"","sources":["../src/cliArgs.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,4 +1,7 @@
-import type { CliOptions, Network, RuntimeConfig } from "./types.js";
+import type { CliOptions, EnvelopeConfig, Network, RuntimeConfig } from "./types.js";
+export declare const NETWORKS: readonly Network[];
 export declare function parseNetwork(value: string | undefined, source: string): Network | undefined;
 export declare function buildRuntimeConfig(env?: NodeJS.ProcessEnv, cli?: CliOptions): RuntimeConfig;
+/** Narrows the full runtime config to the fields the response envelope needs for one network. */
+export declare function envelopeConfig(config: RuntimeConfig, network: Network): EnvelopeConfig;
 export declare function normalizeHubAddress(value: string | undefined): string | undefined;

package/dist/config.js

@@ -1,5 +1,6 @@
 import { DEFAULT_MAX_CONCURRENCY, DEFAULT_MAX_OUTPUT_BYTES, DEFAULT_TIMEOUT_MS, MAINNET_HUB, MAINNET_TOKEN_REGISTRY_ADDRESS, MAX_MAX_CONCURRENCY, MAX_MAX_OUTPUT_BYTES, MAX_TIMEOUT_MS, MIN_MAX_CONCURRENCY, MIN_MAX_OUTPUT_BYTES, MIN_TIMEOUT_MS, TESTNET_HUB } from "./constants.js";
 import { ObyteMcpError } from "./errors.js";
+export const NETWORKS = ["mainnet", "testnet"];
 export function parseNetwork(value, source) {
     if (value === undefined || value === "")
         return undefined;
@@ -9,36 +10,64 @@ export function parseNetwork(value, source) {
 }
 export function buildRuntimeConfig(env = process.env, cli = {}) {
     const envNetwork = parseNetwork(env.OBYTE_NETWORK, "OBYTE_NETWORK");
-    const network = envNetwork ?? cli.network ?? "mainnet";
-    const networkSource = envNetwork ? "env" : cli.network ? "cli" : "default";
-    const envHub = normalizeHubAddress(env.OBYTE_HUB_ADDRESS);
-    const cliHub = normalizeHubAddress(cli.hubAddress);
-    const hubAddress = envHub ?? cliHub ?? (network === "testnet" ? TESTNET_HUB : MAINNET_HUB);
-    const hubSource = envHub ? "env" : cliHub ? "cli" : "default";
-    const envRegistry = normalizeOptionalString(env.OBYTE_TOKEN_REGISTRY_ADDRESS);
-    const cliRegistry = normalizeOptionalString(cli.tokenRegistryAddress);
-    const tokenRegistryAddress = envRegistry ?? cliRegistry ?? (network === "mainnet" ? MAINNET_TOKEN_REGISTRY_ADDRESS : undefined);
-    const registrySource = envRegistry ? "env" : cliRegistry ? "cli" : network === "mainnet" ? "default" : "unset";
+    const defaultNetwork = envNetwork ?? cli.network ?? "mainnet";
+    const defaultNetworkSource = envNetwork ? "env" : cli.network ? "cli" : "default";
+    const networks = {
+        mainnet: buildNetworkConfig("mainnet", env, cli, defaultNetwork),
+        testnet: buildNetworkConfig("testnet", env, cli, defaultNetwork)
+    };
     const timeoutMs = pickBoundedNumber(env.OBYTE_REQUEST_TIMEOUT_MS, cli.timeoutMs, DEFAULT_TIMEOUT_MS, MIN_TIMEOUT_MS, MAX_TIMEOUT_MS, "OBYTE_REQUEST_TIMEOUT_MS");
     const maxConcurrency = pickBoundedNumber(env.OBYTE_MAX_CONCURRENCY, cli.maxConcurrency, DEFAULT_MAX_CONCURRENCY, MIN_MAX_CONCURRENCY, MAX_MAX_CONCURRENCY, "OBYTE_MAX_CONCURRENCY");
     const maxOutputBytes = pickBoundedNumber(env.OBYTE_MAX_OUTPUT_BYTES, cli.maxOutputBytes, DEFAULT_MAX_OUTPUT_BYTES, MIN_MAX_OUTPUT_BYTES, MAX_MAX_OUTPUT_BYTES, "OBYTE_MAX_OUTPUT_BYTES");
     return {
-        network,
-        hubAddress,
-        tokenRegistryAddress,
+        defaultNetwork,
+        defaultNetworkSource,
+        networks,
         timeoutMs,
         maxConcurrency,
         maxOutputBytes,
-        source: {
-            network: networkSource,
-            hubAddress: hubSource,
-            tokenRegistryAddress: registrySource,
+        limitsSource: {
             timeoutMs: env.OBYTE_REQUEST_TIMEOUT_MS ? "env" : cli.timeoutMs !== undefined ? "cli" : "default",
             maxConcurrency: env.OBYTE_MAX_CONCURRENCY ? "env" : cli.maxConcurrency !== undefined ? "cli" : "default",
             maxOutputBytes: env.OBYTE_MAX_OUTPUT_BYTES ? "env" : cli.maxOutputBytes !== undefined ? "cli" : "default"
         }
     };
 }
+/** Narrows the full runtime config to the fields the response envelope needs for one network. */
+export function envelopeConfig(config, network) {
+    return { network, hubAddress: config.networks[network].hubAddress, maxOutputBytes: config.maxOutputBytes };
+}
+function buildNetworkConfig(network, env, cli, defaultNetwork) {
+    const isDefault = network === defaultNetwork;
+    const upper = network.toUpperCase();
+    const hub = resolveSourced([
+        [normalizeHubAddress(env[`OBYTE_${upper}_HUB_ADDRESS`]), "env"],
+        [normalizeHubAddress(network === "mainnet" ? cli.mainnetHubAddress : cli.testnetHubAddress), "cli"],
+        [isDefault ? normalizeHubAddress(env.OBYTE_HUB_ADDRESS) : undefined, "env"],
+        [isDefault ? normalizeHubAddress(cli.hubAddress) : undefined, "cli"]
+    ], [network === "testnet" ? TESTNET_HUB : MAINNET_HUB, "default"]);
+    const registryDefault = network === "mainnet" ? MAINNET_TOKEN_REGISTRY_ADDRESS : undefined;
+    const registry = resolveSourced([
+        [normalizeOptionalString(env[`OBYTE_${upper}_TOKEN_REGISTRY_ADDRESS`]), "env"],
+        [normalizeOptionalString(network === "mainnet" ? cli.mainnetTokenRegistryAddress : cli.testnetTokenRegistryAddress), "cli"],
+        [isDefault ? normalizeOptionalString(env.OBYTE_TOKEN_REGISTRY_ADDRESS) : undefined, "env"],
+        [isDefault ? normalizeOptionalString(cli.tokenRegistryAddress) : undefined, "cli"]
+    ], [registryDefault, registryDefault ? "default" : "unset"]);
+    return {
+        network,
+        hubAddress: hub.value,
+        tokenRegistryAddress: registry.value,
+        hubSource: hub.source,
+        tokenRegistrySource: registry.source
+    };
+}
+function resolveSourced(candidates, fallback) {
+    for (const [value, source] of candidates) {
+        if (value !== undefined)
+            return { value, source };
+    }
+    return { value: fallback[0], source: fallback[1] };
+}
 export function normalizeHubAddress(value) {
     const raw = normalizeOptionalString(value);
     if (!raw)

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/configSnippets.d.ts

@@ -1,5 +1,20 @@
 import type { ClientName } from "./cliArgs.js";
-import type { CliOptions, Network, RuntimeConfig } from "./types.js";
-export declare function configSnippet(client: ClientName, config: RuntimeConfig): string;
-export declare function allConfigSnippets(config: RuntimeConfig): string;
-export declare function cliOptionsFromNetwork(network: Network): CliOptions;
+import type { RuntimeConfig } from "./types.js";
+export declare const DEFAULT_SERVER_NAME = "obyte";
+export interface Invocation {
+    command: string;
+    args: string[];
+}
+/** The `npx` arguments that launch the server with the given runtime config. */
+export declare function commandArgs(config: RuntimeConfig): string[];
+/** The `command`/`args` for the entry written into a JSON-style client config (`npx obyte-mcp ...`). */
+export declare function serverEntry(config: RuntimeConfig): Invocation;
+/** The client CLI command that registers the server (for clients that expose a CLI). */
+export declare function installInvocation(client: ClientName, config: RuntimeConfig, serverName: string): Invocation | undefined;
+export declare function configSnippet(client: ClientName, config: RuntimeConfig, serverName?: string): string;
+export declare function allConfigSnippets(config: RuntimeConfig, serverName?: string): string;
+export declare function vscodeSnippet(config: RuntimeConfig, serverName?: string): string;
+export declare function codexSnippet(config: RuntimeConfig, serverName?: string): string;
+export declare function claudeDesktopSnippet(config: RuntimeConfig, serverName?: string): string;
+export declare function claudeCodeSnippet(config: RuntimeConfig, serverName?: string): string;
+export declare function shellQuote(value: string): string;

package/dist/configSnippets.js

@@ -1,69 +1,118 @@
-export function configSnippet(client, config) {
+export const DEFAULT_SERVER_NAME = "obyte";
+/** The `npx` arguments that launch the server with the given runtime config. */
+export function commandArgs(config) {
+    const args = ["-y", "obyte-mcp"];
+    if (config.defaultNetwork !== "mainnet")
+        args.push("--network", config.defaultNetwork);
+    if (config.networks.mainnet.hubSource !== "default")
+        args.push("--mainnet-hub", config.networks.mainnet.hubAddress);
+    if (config.networks.testnet.hubSource !== "default")
+        args.push("--testnet-hub", config.networks.testnet.hubAddress);
+    if (isOverride(config.networks.mainnet.tokenRegistrySource) && config.networks.mainnet.tokenRegistryAddress) {
+        args.push("--mainnet-token-registry", config.networks.mainnet.tokenRegistryAddress);
+    }
+    if (isOverride(config.networks.testnet.tokenRegistrySource) && config.networks.testnet.tokenRegistryAddress) {
+        args.push("--testnet-token-registry", config.networks.testnet.tokenRegistryAddress);
+    }
+    return args;
+}
+function isOverride(source) {
+    return source === "env" || source === "cli";
+}
+/** The `command`/`args` for the entry written into a JSON-style client config (`npx obyte-mcp ...`). */
+export function serverEntry(config) {
+    return { command: "npx", args: commandArgs(config) };
+}
+/** The client CLI command that registers the server (for clients that expose a CLI). */
+export function installInvocation(client, config, serverName) {
+    const args = commandArgs(config);
+    if (client === "claude-code") {
+        return { command: "claude", args: ["mcp", "add", "--transport", "stdio", serverName, "--", "npx", ...args] };
+    }
+    if (client === "codex") {
+        return { command: "codex", args: ["mcp", "add", serverName, "--", "npx", ...args] };
+    }
+    if (client === "vscode") {
+        return { command: "code", args: ["--add-mcp", JSON.stringify({ name: serverName, command: "npx", args })] };
+    }
+    return undefined; // claude-desktop has no CLI; it is configured by writing its JSON file
+}
+export function configSnippet(client, config, serverName = DEFAULT_SERVER_NAME) {
     if (client === "claude-code")
-        return claudeCodeCommand(config);
+        return claudeCodeSnippet(config, serverName);
     if (client === "claude-desktop")
-        return claudeDesktopJson(config);
-    return codexJson(config);
+        return claudeDesktopSnippet(config, serverName);
+    if (client === "vscode")
+        return vscodeSnippet(config, serverName);
+    return codexSnippet(config, serverName);
 }
-export function allConfigSnippets(config) {
-    return `# Codex
+export function allConfigSnippets(config, serverName = DEFAULT_SERVER_NAME) {
+    return `## VS Code
+
+${vscodeSnippet(config, serverName)}
+
+## Codex CLI
 
-${codexJson(config)}
+${codexSnippet(config, serverName)}
 
-# Claude Desktop
+## Claude Desktop
 
-${claudeDesktopJson(config)}
+${claudeDesktopSnippet(config, serverName)}
 
-# Claude Code
+## Claude Code
 
-${claudeCodeCommand(config)}
+${claudeCodeSnippet(config, serverName)}
 `;
 }
-export function cliOptionsFromNetwork(network) {
-    return { network };
-}
-function commandArgs(config) {
-    const args = ["-y", "obyte-mcp", "--network", config.network];
-    if (config.source.hubAddress !== "default")
-        args.push("--hub", config.hubAddress);
-    if (config.tokenRegistryAddress && config.source.tokenRegistryAddress !== "default") {
-        args.push("--token-registry", config.tokenRegistryAddress);
-    }
-    return args;
-}
-function codexJson(config) {
-    return fencedJson({
-        mcpServers: {
-            obyte: {
-                command: "npx",
-                args: commandArgs(config)
-            }
-        }
-    });
-}
-function claudeDesktopJson(config) {
-    return fencedJson({
-        mcpServers: {
-            obyte: {
-                command: "npx",
-                args: commandArgs(config)
-            }
+export function vscodeSnippet(config, serverName = DEFAULT_SERVER_NAME) {
+    const entry = serverEntry(config);
+    const body = fencedJson({
+        servers: {
+            [serverName]: { type: "stdio", command: entry.command, args: entry.args }
         }
     });
+    return `Add to \`.vscode/mcp.json\` (workspace) or your user \`settings.json\` under \`"mcp"\`:
+
+${body}
+
+Or register it from a terminal:
+
+${fencedShell(`code --add-mcp '${JSON.stringify({ name: serverName, command: entry.command, args: entry.args })}'`)}`;
 }
-function claudeCodeCommand(config) {
-    return `\`\`\`bash
-claude mcp add --transport stdio obyte -- npx ${commandArgs(config).map(shellQuote).join(" ")}
+export function codexSnippet(config, serverName = DEFAULT_SERVER_NAME) {
+    const entry = serverEntry(config);
+    const argsToml = entry.args.map((value) => JSON.stringify(value)).join(", ");
+    return `Add to \`~/.codex/config.toml\`:
+
+\`\`\`toml
+[mcp_servers.${serverName}]
+command = ${JSON.stringify(entry.command)}
+args = [${argsToml}]
 \`\`\`
 
-The \`--\` before \`npx\` is required. Without it, Claude Code can parse server flags as Claude flags.`;
+Or register it from a terminal (newer Codex CLI):
+
+${fencedShell(`codex mcp add ${serverName} -- ${entry.command} ${entry.args.map(shellQuote).join(" ")}`)}`;
+}
+export function claudeDesktopSnippet(config, serverName = DEFAULT_SERVER_NAME) {
+    const entry = serverEntry(config);
+    return `Edit \`claude_desktop_config.json\` and restart Claude Desktop:
+
+${fencedJson({ mcpServers: { [serverName]: { command: entry.command, args: entry.args } } })}`;
+}
+export function claudeCodeSnippet(config, serverName = DEFAULT_SERVER_NAME) {
+    const entry = serverEntry(config);
+    return `${fencedShell(`claude mcp add --transport stdio ${serverName} -- ${entry.command} ${entry.args.map(shellQuote).join(" ")}`)}
+
+The \`--\` before \`${entry.command}\` is required. Without it, Claude Code can parse server flags as Claude flags.`;
 }
 function fencedJson(value) {
-    return `\`\`\`json
-${JSON.stringify(value, null, 2)}
-\`\`\``;
+    return `\`\`\`json\n${JSON.stringify(value, null, 2)}\n\`\`\``;
+}
+function fencedShell(command) {
+    return `\`\`\`bash\n${command}\n\`\`\``;
 }
-function shellQuote(value) {
+export function shellQuote(value) {
     if (/^[A-Za-z0-9._/:=-]+$/.test(value))
         return value;
     return `'${value.replace(/'/g, "'\\''")}'`;