obyte-mcp 0.1.0

package/dist/config.js

@@ -0,0 +1,77 @@
+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 function parseNetwork(value, source) {
+    if (value === undefined || value === "")
+        return undefined;
+    if (value === "mainnet" || value === "testnet")
+        return value;
+    throw new ObyteMcpError("CONFIG_ERROR", `${source} must be "mainnet" or "testnet"`, { value });
+}
+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 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,
+        timeoutMs,
+        maxConcurrency,
+        maxOutputBytes,
+        source: {
+            network: networkSource,
+            hubAddress: hubSource,
+            tokenRegistryAddress: registrySource,
+            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"
+        }
+    };
+}
+export function normalizeHubAddress(value) {
+    const raw = normalizeOptionalString(value);
+    if (!raw)
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new ObyteMcpError("CONFIG_ERROR", "Hub address must be a valid URL", { value: raw });
+    }
+    if (parsed.username || parsed.password) {
+        throw new ObyteMcpError("CONFIG_ERROR", "Hub address must not include credentials");
+    }
+    const hostname = parsed.hostname.toLowerCase();
+    const isLocalhost = hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+    if (parsed.protocol !== "https:" && !(parsed.protocol === "http:" && isLocalhost)) {
+        throw new ObyteMcpError("CONFIG_ERROR", "Custom hub URL must use https, except http localhost is allowed for development", { value: raw });
+    }
+    parsed.hash = "";
+    return parsed.toString().replace(/\/+$/, "");
+}
+function normalizeOptionalString(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function pickBoundedNumber(envValue, cliValue, defaultValue, min, max, label) {
+    const raw = envValue !== undefined && envValue !== "" ? Number(envValue) : cliValue;
+    if (raw === undefined)
+        return defaultValue;
+    if (!Number.isInteger(raw) || raw < min || raw > max) {
+        throw new ObyteMcpError("CONFIG_ERROR", `${label} must be an integer from ${min} to ${max}`, { value: raw });
+    }
+    return raw;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,YAAY,CAAC,KAAyB,EAAE,MAAc;IACpE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7D,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,GAAG,MAAM,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,MAAkB,EAAE;IAC3F,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,UAAU,IAAI,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IACvD,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3E,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,IAAI,MAAM,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9D,MAAM,WAAW,GAAG,uBAAuB,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,uBAAuB,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACtE,MAAM,oBAAoB,GAAG,WAAW,IAAI,WAAW,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChI,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAE/G,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,wBAAwB,EAAE,GAAG,CAAC,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,0BAA0B,CAAC,CAAC;IACjK,MAAM,cAAc,GAAG,iBAAiB,CACtC,GAAG,CAAC,qBAAqB,EACzB,GAAG,CAAC,cAAc,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,CACxB,CAAC;IACF,MAAM,cAAc,GAAG,iBAAiB,CACtC,GAAG,CAAC,sBAAsB,EAC1B,GAAG,CAAC,cAAc,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,CACzB,CAAC;IAEF,OAAO;QACL,OAAO;QACP,UAAU;QACV,oBAAoB;QACpB,SAAS;QACT,cAAc;QACd,cAAc;QACd,MAAM,EAAE;YACN,OAAO,EAAE,aAAa;YACtB,UAAU,EAAE,SAAS;YACrB,oBAAoB,EAAE,cAAc;YACpC,SAAS,EAAE,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACjG,cAAc,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACxG,cAAc,EAAE,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAC1G;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,GAAG,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,iCAAiC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,0CAA0C,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,WAAW,GAAG,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,OAAO,CAAC;IACvH,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,WAAW,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,iFAAiF,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7I,CAAC;IAED,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAyB;IACxD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,SAAS,iBAAiB,CACxB,QAA4B,EAC5B,QAA4B,EAC5B,YAAoB,EACpB,GAAW,EACX,GAAW,EACX,KAAa;IAEb,MAAM,GAAG,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACrD,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,GAAG,KAAK,4BAA4B,GAAG,OAAO,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/configSnippets.d.ts

@@ -0,0 +1,5 @@
+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;

package/dist/configSnippets.js

@@ -0,0 +1,71 @@
+export function configSnippet(client, config) {
+    if (client === "claude-code")
+        return claudeCodeCommand(config);
+    if (client === "claude-desktop")
+        return claudeDesktopJson(config);
+    return codexJson(config);
+}
+export function allConfigSnippets(config) {
+    return `# Codex
+
+${codexJson(config)}
+
+# Claude Desktop
+
+${claudeDesktopJson(config)}
+
+# Claude Code
+
+${claudeCodeCommand(config)}
+`;
+}
+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)
+            }
+        }
+    });
+}
+function claudeCodeCommand(config) {
+    return `\`\`\`bash
+claude mcp add --transport stdio obyte -- npx ${commandArgs(config).map(shellQuote).join(" ")}
+\`\`\`
+
+The \`--\` before \`npx\` is required. Without it, Claude Code can parse server flags as Claude flags.`;
+}
+function fencedJson(value) {
+    return `\`\`\`json
+${JSON.stringify(value, null, 2)}
+\`\`\``;
+}
+function shellQuote(value) {
+    if (/^[A-Za-z0-9._/:=-]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=configSnippets.js.map

package/dist/configSnippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSnippets.js","sourceRoot":"","sources":["../src/configSnippets.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,MAAqB;IACrE,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/D,IAAI,MAAM,KAAK,gBAAgB;QAAE,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,OAAO;;EAEP,SAAS,CAAC,MAAM,CAAC;;;;EAIjB,iBAAiB,CAAC,MAAM,CAAC;;;;EAIzB,iBAAiB,CAAC,MAAM,CAAC;CAC1B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,MAAqB;IACxC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAClF,IAAI,MAAM,CAAC,oBAAoB,IAAI,MAAM,CAAC,MAAM,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACpF,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,MAAqB;IACtC,OAAO,UAAU,CAAC;QAChB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;aAC1B;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqB;IAC9C,OAAO,UAAU,CAAC;QAChB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;aAC1B;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqB;IAC9C,OAAO;gDACuC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;;;uGAGU,CAAC;AACxG,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO;EACP,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;OACzB,CAAC;AACR,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,16 @@
+export declare const PACKAGE_NAME = "obyte-mcp";
+export declare const PACKAGE_VERSION = "0.1.0";
+export declare const MAINNET_HUB = "https://obyte.org/api";
+export declare const TESTNET_HUB = "https://testnet.obyte.org/api";
+export declare const MAINNET_TOKEN_REGISTRY_ADDRESS = "O6H6ZIFI57X3PLTYHOCVYPP5A553CYFQ";
+export declare const DEFAULT_TIMEOUT_MS = 20000;
+export declare const MIN_TIMEOUT_MS = 1000;
+export declare const MAX_TIMEOUT_MS = 120000;
+export declare const DEFAULT_MAX_CONCURRENCY = 4;
+export declare const MIN_MAX_CONCURRENCY = 1;
+export declare const MAX_MAX_CONCURRENCY = 10;
+export declare const DEFAULT_MAX_OUTPUT_BYTES = 262144;
+export declare const MIN_MAX_OUTPUT_BYTES = 16384;
+export declare const MAX_MAX_OUTPUT_BYTES = 1048576;
+export declare const WITNESSES_CACHE_TTL_MS: number;
+export declare const MAX_JSON_PAYLOAD_BYTES: number;

package/dist/constants.js

@@ -0,0 +1,17 @@
+export const PACKAGE_NAME = "obyte-mcp";
+export const PACKAGE_VERSION = "0.1.0";
+export const MAINNET_HUB = "https://obyte.org/api";
+export const TESTNET_HUB = "https://testnet.obyte.org/api";
+export const MAINNET_TOKEN_REGISTRY_ADDRESS = "O6H6ZIFI57X3PLTYHOCVYPP5A553CYFQ";
+export const DEFAULT_TIMEOUT_MS = 20_000;
+export const MIN_TIMEOUT_MS = 1_000;
+export const MAX_TIMEOUT_MS = 120_000;
+export const DEFAULT_MAX_CONCURRENCY = 4;
+export const MIN_MAX_CONCURRENCY = 1;
+export const MAX_MAX_CONCURRENCY = 10;
+export const DEFAULT_MAX_OUTPUT_BYTES = 262_144;
+export const MIN_MAX_OUTPUT_BYTES = 16_384;
+export const MAX_MAX_OUTPUT_BYTES = 1_048_576;
+export const WITNESSES_CACHE_TTL_MS = 10 * 60 * 1000;
+export const MAX_JSON_PAYLOAD_BYTES = 64 * 1024;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,+BAA+B,CAAC;AAC3D,MAAM,CAAC,MAAM,8BAA8B,GAAG,kCAAkC,CAAC;AAEjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,10 @@
+export type DiagnosticLevel = "debug" | "info" | "warn" | "error";
+export interface DiagnosticEvent {
+    level: DiagnosticLevel;
+    event: string;
+    message: string;
+    request_id?: string;
+    tool?: string;
+    details?: unknown;
+}
+export declare function writeDiagnostic(diagnostic: DiagnosticEvent): void;

package/dist/diagnostics.js

@@ -0,0 +1,31 @@
+import { PACKAGE_NAME } from "./constants.js";
+export function writeDiagnostic(diagnostic) {
+    const line = {
+        ts: new Date().toISOString(),
+        package: PACKAGE_NAME,
+        level: diagnostic.level,
+        event: diagnostic.event,
+        request_id: diagnostic.request_id,
+        tool: diagnostic.tool,
+        message: diagnostic.message,
+        details: redactDiagnostics(diagnostic.details)
+    };
+    process.stderr.write(`${JSON.stringify(line)}\n`);
+}
+function redactDiagnostics(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value.map(redactDiagnostics);
+    const result = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (/private|secret|seed|mnemonic|passphrase|xprv/i.test(key)) {
+            result[key] = "[redacted]";
+        }
+        else {
+            result[key] = redactDiagnostics(child);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAa9C,MAAM,UAAU,eAAe,CAAC,UAA2B;IACzD,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,OAAO,EAAE,YAAY;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,OAAO,EAAE,iBAAiB,CAAC,UAAU,CAAC,OAAO,CAAC;KAC/C,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAE9D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,IAAI,+CAA+C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,6 @@
+import type { CliOptions } from "./types.js";
+interface DoctorOptions {
+    json: boolean;
+}
+export declare function runDoctor(cliOptions: CliOptions, options: DoctorOptions): Promise<void>;
+export {};

package/dist/doctor.js

@@ -0,0 +1,45 @@
+import { buildRuntimeConfig } from "./config.js";
+import { PACKAGE_NAME, PACKAGE_VERSION } from "./constants.js";
+import { ObyteMcpError } from "./errors.js";
+export async function runDoctor(cliOptions, options) {
+    const checks = [];
+    let config;
+    checks.push(checkNodeVersion());
+    try {
+        config = buildRuntimeConfig(process.env, cliOptions);
+        checks.push({ name: "config", ok: true, message: "Runtime config is valid" });
+    }
+    catch (error) {
+        checks.push({
+            name: "config",
+            ok: false,
+            message: error instanceof ObyteMcpError ? error.message : String(error)
+        });
+    }
+    const result = {
+        package: PACKAGE_NAME,
+        version: PACKAGE_VERSION,
+        ok: checks.every((check) => check.ok),
+        checks,
+        config
+    };
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    }
+    else {
+        process.stdout.write(`${PACKAGE_NAME} ${PACKAGE_VERSION} doctor\n`);
+        for (const check of checks) {
+            process.stdout.write(`${check.ok ? "ok" : "fail"} ${check.name}: ${check.message}\n`);
+        }
+    }
+    if (!result.ok)
+        process.exitCode = 1;
+}
+function checkNodeVersion() {
+    const major = Number(process.versions.node.split(".")[0]);
+    if (major >= 20) {
+        return { name: "node", ok: true, message: `Node ${process.versions.node}` };
+    }
+    return { name: "node", ok: false, message: `Node >=20 is required, current ${process.versions.node}` };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAa5C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAsB,EAAE,OAAsB;IAC5E,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,MAAe,CAAC;IAEpB,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACxE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,eAAe;QACxB,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM;QACN,MAAM;KACP,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,IAAI,eAAe,WAAW,CAAC,CAAC;QACpE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kCAAkC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;AACzG,CAAC"}

package/dist/envelope.d.ts

@@ -0,0 +1,6 @@
+import type { RuntimeConfig, ToolEnvelope, ToolExecutionContext } from "./types.js";
+export declare function createToolContext(config: RuntimeConfig, toolName: string): ToolExecutionContext;
+export declare function successEnvelope(context: ToolExecutionContext, data: unknown): ToolEnvelope;
+export declare function errorEnvelope(context: ToolExecutionContext, error: unknown): ToolEnvelope;
+export declare function envelopeToText(envelope: ToolEnvelope, maxOutputBytes: number): string;
+export declare function executeEnvelope<T>(config: RuntimeConfig, toolName: string, retryCounter: () => number, handler: (context: ToolExecutionContext) => Promise<T>): Promise<string>;

package/dist/envelope.js

@@ -0,0 +1,182 @@
+import { randomUUID } from "node:crypto";
+import { ObyteMcpError, toObyteMcpError } from "./errors.js";
+import { sortKnownMapOutputs } from "./jsonUtils.js";
+export function createToolContext(config, toolName) {
+    return {
+        config,
+        requestId: randomUUID(),
+        toolName,
+        startedAt: Date.now(),
+        retryCount: 0
+    };
+}
+export function successEnvelope(context, data) {
+    return {
+        ok: true,
+        meta: {
+            network: context.config.network,
+            hub: context.config.hubAddress,
+            tool: context.toolName,
+            request_id: context.requestId,
+            duration_ms: Date.now() - context.startedAt,
+            retry_count: context.retryCount,
+            truncated: false
+        },
+        data: sortKnownMapOutputs(context.toolName, data)
+    };
+}
+export function errorEnvelope(context, error) {
+    const normalized = toObyteMcpError(error);
+    return {
+        ok: false,
+        meta: {
+            network: context.config.network,
+            hub: context.config.hubAddress,
+            tool: context.toolName,
+            request_id: context.requestId,
+            duration_ms: Date.now() - context.startedAt,
+            retry_count: context.retryCount,
+            truncated: false
+        },
+        error: {
+            code: normalized.code,
+            message: normalized.message,
+            details: normalized.details
+        }
+    };
+}
+export function envelopeToText(envelope, maxOutputBytes) {
+    const serialized = JSON.stringify(envelope, null, 2);
+    const initialBytes = Buffer.byteLength(serialized, "utf8");
+    if (initialBytes <= maxOutputBytes)
+        return serialized;
+    if (!envelope.ok) {
+        return JSON.stringify(outputTooLargeEnvelope(envelope, initialBytes, maxOutputBytes), null, 2);
+    }
+    const truncated = structuredClone(envelope);
+    if (!truncated.ok)
+        return JSON.stringify(outputTooLargeEnvelope(envelope, initialBytes, maxOutputBytes), null, 2);
+    truncated.meta.truncated = true;
+    truncated.meta.output_bytes_before_truncation = initialBytes;
+    truncated.meta.truncation_reason = "response exceeded OBYTE_MAX_OUTPUT_BYTES";
+    truncated.data = truncateValue(truncated.data, Math.max(1024, Math.floor(maxOutputBytes * 0.7)));
+    let text = JSON.stringify(truncated, null, 2);
+    let bytes = Buffer.byteLength(text, "utf8");
+    while (bytes > maxOutputBytes && truncated.ok) {
+        truncated.data = truncateValue(truncated.data, Math.max(256, Math.floor(maxOutputBytes * 0.45)));
+        text = JSON.stringify(truncated, null, 2);
+        bytes = Buffer.byteLength(text, "utf8");
+        if (isTerminalTruncation(truncated.data))
+            break;
+    }
+    if (bytes > maxOutputBytes) {
+        return JSON.stringify(outputTooLargeEnvelope(envelope, initialBytes, maxOutputBytes), null, 2);
+    }
+    if (truncated.ok)
+        truncated.meta.output_bytes_after_truncation = bytes;
+    return JSON.stringify(truncated, null, 2);
+}
+function outputTooLargeEnvelope(original, initialBytes, maxOutputBytes) {
+    return {
+        ok: false,
+        meta: {
+            ...original.meta,
+            truncated: false,
+            output_bytes_before_truncation: initialBytes,
+            truncation_reason: "response exceeded OBYTE_MAX_OUTPUT_BYTES and could not be safely truncated"
+        },
+        error: {
+            code: "OUTPUT_TOO_LARGE",
+            message: "Tool response exceeded configured output limit",
+            details: { initialBytes, maxOutputBytes }
+        }
+    };
+}
+function truncateValue(value, budgetBytes) {
+    if (value === null || typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (typeof value === "string")
+        return truncateString(value, budgetBytes);
+    if (Array.isArray(value))
+        return truncateArray(value, budgetBytes);
+    if (typeof value === "object")
+        return truncateObject(value, budgetBytes);
+    return String(value);
+}
+function truncateArray(value, budgetBytes) {
+    const result = [];
+    for (let index = 0; index < value.length; index += 1) {
+        let childBudget = Math.floor(budgetBytes / Math.max(1, value.length));
+        let child = truncateValue(value[index], childBudget);
+        let candidate = [...result, child];
+        while (Buffer.byteLength(JSON.stringify(candidate), "utf8") > budgetBytes && childBudget > 128) {
+            childBudget = Math.floor(childBudget * 0.7);
+            child = truncateValue(value[index], childBudget);
+            candidate = [...result, child];
+        }
+        if (Buffer.byteLength(JSON.stringify(candidate), "utf8") > budgetBytes) {
+            result.push({ __truncated__: true, omitted_items: value.length - index });
+            return result;
+        }
+        result.push(candidate[candidate.length - 1]);
+    }
+    return result;
+}
+function truncateObject(value, budgetBytes) {
+    const result = {};
+    const entries = Object.entries(value);
+    for (let index = 0; index < entries.length; index += 1) {
+        const [key, child] = entries[index];
+        let childBudget = Math.floor(budgetBytes / Math.max(1, entries.length));
+        let truncatedChild = truncateValue(child, childBudget);
+        let candidate = {
+            ...result,
+            [key]: truncatedChild
+        };
+        while (Buffer.byteLength(JSON.stringify(candidate), "utf8") > budgetBytes && childBudget > 128) {
+            childBudget = Math.floor(childBudget * 0.7);
+            truncatedChild = truncateValue(child, childBudget);
+            candidate = {
+                ...result,
+                [key]: truncatedChild
+            };
+        }
+        if (Buffer.byteLength(JSON.stringify(candidate), "utf8") > budgetBytes) {
+            result.__truncated_keys__ = entries.slice(index).map(([entryKey]) => entryKey);
+            return result;
+        }
+        result[key] = candidate[key];
+    }
+    return result;
+}
+function truncateString(value, budgetBytes) {
+    const suffix = "...[truncated]";
+    if (Buffer.byteLength(value, "utf8") <= budgetBytes)
+        return value;
+    const target = Math.max(0, budgetBytes - Buffer.byteLength(suffix, "utf8"));
+    let current = "";
+    for (const char of value) {
+        if (Buffer.byteLength(current + char, "utf8") > target)
+            break;
+        current += char;
+    }
+    return current + suffix;
+}
+function isTerminalTruncation(value) {
+    return typeof value === "string" || value === null || typeof value !== "object";
+}
+export async function executeEnvelope(config, toolName, retryCounter, handler) {
+    const beforeRetries = retryCounter();
+    const context = createToolContext(config, toolName);
+    try {
+        const data = await handler(context);
+        context.retryCount = retryCounter() - beforeRetries;
+        return envelopeToText(successEnvelope(context, data), config.maxOutputBytes);
+    }
+    catch (error) {
+        context.retryCount = retryCounter() - beforeRetries;
+        const envelope = error instanceof ObyteMcpError ? errorEnvelope(context, error) : errorEnvelope(context, error);
+        return envelopeToText(envelope, config.maxOutputBytes);
+    }
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+import type { ErrorCode } from "./types.js";
+export declare class ObyteMcpError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: unknown;
+    constructor(code: ErrorCode, message: string, details?: unknown);
+}
+export declare function toObyteMcpError(error: unknown): ObyteMcpError;

package/dist/errors.js

@@ -0,0 +1,22 @@
+export class ObyteMcpError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "ObyteMcpError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export function toObyteMcpError(error) {
+    if (error instanceof ObyteMcpError)
+        return error;
+    if (error instanceof Error) {
+        if (error.name === "AbortError") {
+            return new ObyteMcpError("TIMEOUT", "Hub request timed out");
+        }
+        return new ObyteMcpError("INTERNAL_ERROR", error.message);
+    }
+    return new ObyteMcpError("INTERNAL_ERROR", "Unknown internal error");
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAY;IAChB,OAAO,CAAW;IAE3B,YAAY,IAAe,EAAE,OAAe,EAAE,OAAiB;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,aAAa;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,OAAO,IAAI,aAAa,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,aAAa,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;AACvE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { PACKAGE_NAME, PACKAGE_VERSION } from "./constants.js";
+import { parseCliArgs } from "./cliArgs.js";
+import { buildRuntimeConfig } from "./config.js";
+import { ObyteMcpError, toObyteMcpError } from "./errors.js";
+import { runDoctor } from "./doctor.js";
+import { runServer } from "./server.js";
+import { runSetup } from "./setup.js";
+async function main() {
+    const parsed = parseCliArgs(process.argv.slice(2));
+    if (parsed.command === "help") {
+        process.stdout.write(helpText());
+        return;
+    }
+    if (parsed.command === "version") {
+        process.stdout.write(`${PACKAGE_VERSION}\n`);
+        return;
+    }
+    if (parsed.command === "setup") {
+        await runSetup(parsed.options, parsed.setup);
+        return;
+    }
+    if (parsed.command === "doctor") {
+        await runDoctor(parsed.options, parsed.doctor);
+        return;
+    }
+    const config = buildRuntimeConfig(process.env, parsed.options);
+    await runServer(config);
+}
+function helpText() {
+    return `${PACKAGE_NAME} ${PACKAGE_VERSION}
+
+Local stdio MCP server for querying Obyte hubs.
+
+Usage:
+  ${PACKAGE_NAME} [--network mainnet|testnet] [--hub URL] [--token-registry ADDRESS]
+  ${PACKAGE_NAME} setup [--print-only] [--client codex|claude-desktop|claude-code] [--network mainnet|testnet]
+  ${PACKAGE_NAME} doctor [--json]
+  ${PACKAGE_NAME} --help
+  ${PACKAGE_NAME} --version
+
+Options:
+  --network              Obyte network, default mainnet
+  --hub                  Custom hub URL; https only, except http localhost
+  --token-registry       Token registry AA address
+  --timeout-ms           Hub request timeout, 1000..120000
+  --max-concurrency      Max concurrent hub requests, 1..10
+  --max-output-bytes     Max MCP tool response bytes, 16384..1048576
+
+The default command starts MCP stdio. Do not print logs to stdout in this mode.
+`;
+}
+main().catch((error) => {
+    const normalized = toObyteMcpError(error);
+    const body = normalized instanceof ObyteMcpError ? normalized : toObyteMcpError(error);
+    process.stderr.write(`${body.code}: ${body.message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,eAAe,IAAI,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,GAAG,YAAY,IAAI,eAAe;;;;;IAKvC,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY;;;;;;;;;;;CAWf,CAAC;AACF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,UAAU,YAAY,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACvF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/jsonUtils.d.ts

@@ -0,0 +1,6 @@
+export declare function jsonByteLength(value: unknown): number;
+export declare function assertJsonSize(value: unknown, maxBytes?: number): void;
+export declare function sortMapLike(value: unknown): unknown;
+export declare function sortKnownMapOutputs(toolName: string, data: unknown): unknown;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function redactForError(value: unknown): unknown;