@runonflux/flux-cloud-mcp 0.1.0

package/dist/fluxapi.js

@@ -0,0 +1,165 @@
+/**
+ * FluxOS HTTP client.
+ *
+ * Every FluxOS response is `{ status: 'success' | 'error', data }`; `unwrap`
+ * turns the error shape into a thrown Error with the node's message.
+ *
+ * POST bodies are sent as text/plain, never application/json. FluxOS installs
+ * `express.json()` globally, but the handlers this server needs
+ * (/apps/appregister, /apps/appupdate, /apps/calculatefiatandfluxprice,
+ * /apps/verifyapp*specifications, /apps/getpublickey) read the raw request
+ * stream themselves. With a JSON content type the middleware has already
+ * consumed the stream, the handler's 'end' listener never fires and the
+ * request hangs until a gateway 504. The payload is still JSON text.
+ */
+export class FluxApiError extends Error {
+    endpoint;
+    constructor(message, endpoint) {
+        super(message);
+        this.endpoint = endpoint;
+        this.name = 'FluxApiError';
+    }
+}
+export function unwrap(payload, endpoint) {
+    const response = payload;
+    if (response && response.status === 'success')
+        return response.data;
+    if (response && response.status === 'error') {
+        const data = response.data;
+        const message = typeof data === 'string' ? data : (data?.message ?? data?.name ?? 'unknown FluxOS error');
+        throw new FluxApiError(`${endpoint}: ${message}`, endpoint);
+    }
+    throw new FluxApiError(`${endpoint}: unexpected response ${JSON.stringify(payload).slice(0, 300)}`, endpoint);
+}
+export function sessionHeader(session) {
+    return JSON.stringify(session);
+}
+export class FluxClient {
+    baseUrl;
+    defaultTimeoutMs;
+    constructor(baseUrl, defaultTimeoutMs = 60000) {
+        this.baseUrl = baseUrl;
+        this.defaultTimeoutMs = defaultTimeoutMs;
+    }
+    async raw(method, pathname, options = {}) {
+        const headers = {};
+        let body;
+        if (options.body !== undefined) {
+            headers['Content-Type'] = 'text/plain';
+            body = typeof options.body === 'string' ? options.body : JSON.stringify(options.body);
+        }
+        if (options.session)
+            headers.zelidauth = sessionHeader(options.session);
+        const url = `${this.baseUrl}${pathname}`;
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers,
+                ...(body === undefined ? {} : { body }),
+                signal: AbortSignal.timeout(options.timeoutMs ?? this.defaultTimeoutMs),
+            });
+        }
+        catch (error) {
+            throw new FluxApiError(`${url}: ${error.message}`, pathname);
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            throw new FluxApiError(`${url}: HTTP ${response.status} ${text.slice(0, 200)}`, pathname);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new FluxApiError(`${url}: non-JSON response ${text.slice(0, 200)}`, pathname);
+        }
+    }
+    async get(pathname, options = {}) {
+        return unwrap(await this.raw('GET', pathname, options), pathname);
+    }
+    async post(pathname, body, options = {}) {
+        return unwrap(await this.raw('POST', pathname, { ...options, body }), pathname);
+    }
+}
+/** FluxOS refuses registrations on nodes with fewer peers than this. */
+export const MIN_OUTGOING_PEERS = 8;
+export const MIN_INCOMING_PEERS = 4;
+export async function listNodeEndpoints(api) {
+    const nodes = await api.get('/daemon/viewdeterministiczelnodelist', {
+        timeoutMs: 120000,
+    });
+    return nodes
+        .filter((node) => node.ip && node.network === 'ipv4')
+        .map((node) => {
+        const [ip, port] = node.ip.split(':');
+        return { endpoint: `http://${ip}:${port ?? '16127'}`, ip: ip ?? '', tier: node.tier };
+    });
+}
+export async function nodeHealth(node) {
+    const [outgoing, incoming, info] = await Promise.all([
+        node.get('/flux/connectedpeersinfo', { timeoutMs: 12000 }),
+        node.get('/flux/incomingconnectionsinfo', { timeoutMs: 12000 }),
+        node
+            .get('/flux/info', { timeoutMs: 12000 })
+            .catch(() => undefined),
+    ]);
+    return {
+        outgoing: outgoing.length,
+        incoming: incoming.length,
+        ok: outgoing.length >= MIN_OUTGOING_PEERS && incoming.length >= MIN_INCOMING_PEERS,
+        arcaneVersion: info?.flux?.arcaneVersion,
+    };
+}
+function shuffle(list) {
+    const copy = [...list];
+    for (let i = copy.length - 1; i > 0; i -= 1) {
+        const j = Math.floor(Math.random() * (i + 1));
+        const a = copy[i];
+        copy[i] = copy[j];
+        copy[j] = a;
+    }
+    return copy;
+}
+/**
+ * Probe random nodes until `count` of them meet the peer thresholds. With
+ * `arcane` only ArcaneOS nodes qualify: they alone hold the key that
+ * decrypts enterprise specifications, so only they can validate or accept one.
+ */
+export async function findHealthyNodes(api, count, options = {}) {
+    const { arcane = false, batchSize = 12, maxProbes = 240, log = () => { } } = options;
+    const pool = shuffle(await listNodeEndpoints(api));
+    const healthy = [];
+    let probed = 0;
+    while (healthy.length < count && probed < Math.min(maxProbes, pool.length)) {
+        const batch = pool.slice(probed, probed + batchSize);
+        probed += batch.length;
+        const results = await Promise.all(batch.map(async (candidate) => {
+            const client = new FluxClient(candidate.endpoint);
+            try {
+                const health = await nodeHealth(client);
+                if (!health.ok)
+                    return undefined;
+                if (arcane && !health.arcaneVersion)
+                    return undefined;
+                return { ...candidate, client, health };
+            }
+            catch {
+                return undefined;
+            }
+        }));
+        for (const result of results)
+            if (result)
+                healthy.push(result);
+        log(`probed ${probed} nodes, ${healthy.length} usable`);
+    }
+    if (!healthy.length) {
+        throw new Error(`No ${arcane ? 'ArcaneOS ' : ''}FluxOS node with enough peers found after probing ${probed} candidates`);
+    }
+    return healthy.slice(0, count);
+}
+/** `http://ip:port` for an app instance reported by /apps/location. */
+export function instanceEndpoint(ip) {
+    const [host, port] = ip.split(':');
+    return `http://${host}:${port ?? '16127'}`;
+}
+//# sourceMappingURL=fluxapi.js.map

package/dist/fluxapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluxapi.js","sourceRoot":"","sources":["../src/fluxapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAGnB;IAFlB,YACE,OAAe,EACC,QAAgB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,aAAQ,GAAR,QAAQ,CAAQ;QAGhC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,MAAM,CAAI,OAAgB,EAAE,QAAgB;IAC1D,MAAM,QAAQ,GAAG,OAAsC,CAAC;IACxD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACpE,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA8B,CAAC;QACrD,MAAM,OAAO,GACX,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,IAAI,IAAI,sBAAsB,CAAC,CAAC;QAC5F,MAAM,IAAI,YAAY,CAAC,GAAG,QAAQ,KAAK,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,IAAI,YAAY,CACpB,GAAG,QAAQ,yBAAyB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAC3E,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAQD,MAAM,OAAO,UAAU;IAEH;IACC;IAFnB,YACkB,OAAe,EACd,mBAAmB,KAAK;QADzB,YAAO,GAAP,OAAO,CAAQ;QACd,qBAAgB,GAAhB,gBAAgB,CAAQ;IACxC,CAAC;IAEJ,KAAK,CAAC,GAAG,CACP,MAAsB,EACtB,QAAgB,EAChB,UAA0B,EAAE;QAE5B,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAwB,CAAC;QAC7B,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC;YACvC,IAAI,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAExE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;QACzC,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC1B,MAAM;gBACN,OAAO;gBACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC;aACxE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,YAAY,CAAC,GAAG,GAAG,KAAM,KAAe,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,YAAY,CAAC,GAAG,GAAG,UAAU,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,YAAY,CAAC,GAAG,GAAG,uBAAuB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,QAAgB,EAAE,UAA0B,EAAE;QACzD,OAAO,MAAM,CAAI,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,QAAgB,EAAE,IAAa,EAAE,UAA0B,EAAE;QACzE,OAAO,MAAM,CAAI,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrF,CAAC;CACF;AAyBD,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAe;IACrD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,GAAG,CAAsB,sCAAsC,EAAE;QACvF,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;IACH,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC;SACpD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,IAAI,IAAI,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACxF,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB;IAC/C,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,IAAI,CAAC,GAAG,CAAY,0BAA0B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACrE,IAAI,CAAC,GAAG,CAAY,+BAA+B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC1E,IAAI;aACD,GAAG,CAAwC,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;aAC9E,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;KAC1B,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,EAAE,EAAE,QAAQ,CAAC,MAAM,IAAI,kBAAkB,IAAI,QAAQ,CAAC,MAAM,IAAI,kBAAkB;QAClF,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAI,IAAS;IAC3B,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;QACvB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;QACvB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAe,EACf,KAAa,EACb,UAKI,EAAE;IAEN,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,SAAS,GAAG,EAAE,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,GAAE,CAAC,EAAE,GAAG,OAAO,CAAC;IACpF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO,OAAO,CAAC,MAAM,GAAG,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,EAAE;oBAAE,OAAO,SAAS,CAAC;gBACjC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa;oBAAE,OAAO,SAAS,CAAC;gBACtD,OAAO,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QACF,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,IAAI,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,GAAG,CAAC,UAAU,MAAM,WAAW,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,MAAM,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,qDAAqD,MAAM,aAAa,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,UAAU,IAAI,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadConfig } from './config.js';
+import { createServer } from './server.js';
+async function main() {
+    const config = loadConfig();
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`flux-cloud-mcp ready (api ${config.apiUrl}, keys ${config.ownerWif && config.payerWif ? 'configured' : 'missing'})\n`);
+}
+main().catch((error) => {
+    process.stderr.write(`flux-cloud-mcp failed to start: ${error.message}\n`);
+    process.exit(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,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA6B,MAAM,CAAC,MAAM,UAAU,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,KAAK,CACvH,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAoC,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;IACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/keys.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Key material and signatures.
+ *
+ *   Flux ID (ZelID)  a Bitcoin-style P2PKH address ("1..."), derived from a
+ *                    secp256k1 key. Owns apps, signs messages and sessions.
+ *   Payment address  a Flux transparent address ("t1...") from a second key.
+ *                    Holds FLUX and pays deployment fees.
+ *
+ * Both use the same WIF encoding (version byte 0x80), so one WIF can be read
+ * as either identity; which role it plays is decided by the caller.
+ */
+export interface Identity {
+    wif: string;
+    publicKey: string;
+    /** Flux ID / ZelID: the app owner address ("1..."). */
+    zelid: string;
+    /** Flux transparent address ("t1..."), the one that can hold FLUX. */
+    fluxAddress: string;
+}
+export declare function identityFromWif(wif: string): Identity;
+export declare function generateIdentity(): Identity;
+/**
+ * Standard Bitcoin signed-message signature, base64. This is what FluxOS
+ * `signatureVerifier.verifySignature` checks for a "1..." owner.
+ */
+export declare function signMessage(message: string, wif: string): string;
+export declare function verifyMessage(message: string, zelid: string, signature: string): boolean;
+export interface Session {
+    zelid: string;
+    signature: string;
+    loginPhrase: string;
+}
+/**
+ * A self-issued FluxOS session.
+ *
+ * FluxOS accepts a login phrase it never issued as long as it starts with a
+ * 13-digit millisecond timestamp less than 16 hours old, is 40-70 characters
+ * long, and is signed by the ZelID (verificationHelperUtils.verifyUserSession).
+ * That means one signed phrase authenticates against every node on the
+ * network, with no login round-trip and no node affinity.
+ */
+export declare function createSession(ownerWif: string): Session;
+/** The same session for the whole process, re-issued well before it ages out. */
+export declare function currentSession(ownerWif: string): Session;

package/dist/keys.js

@@ -0,0 +1,79 @@
+/**
+ * Key material and signatures.
+ *
+ *   Flux ID (ZelID)  a Bitcoin-style P2PKH address ("1..."), derived from a
+ *                    secp256k1 key. Owns apps, signs messages and sessions.
+ *   Payment address  a Flux transparent address ("t1...") from a second key.
+ *                    Holds FLUX and pays deployment fees.
+ *
+ * Both use the same WIF encoding (version byte 0x80), so one WIF can be read
+ * as either identity; which role it plays is decided by the caller.
+ */
+import { randomBytes } from 'node:crypto';
+import utxolib from '@runonflux/utxo-lib';
+import bitcoinMessage from 'bitcoinjs-message';
+function keyPairFromWif(wif) {
+    try {
+        return utxolib.ECPair.fromWIF(wif, utxolib.networks.flux);
+    }
+    catch (error) {
+        throw new Error(`Not a valid WIF private key: ${error.message}`, { cause: error });
+    }
+}
+export function identityFromWif(wif) {
+    const flux = keyPairFromWif(wif);
+    const bitcoin = utxolib.ECPair.fromWIF(wif, utxolib.networks.bitcoin);
+    return {
+        wif,
+        publicKey: flux.getPublicKeyBuffer().toString('hex'),
+        zelid: bitcoin.getAddress(),
+        fluxAddress: flux.getAddress(),
+    };
+}
+export function generateIdentity() {
+    const pair = utxolib.ECPair.makeRandom({ network: utxolib.networks.flux, compressed: true });
+    return identityFromWif(pair.toWIF());
+}
+/**
+ * Standard Bitcoin signed-message signature, base64. This is what FluxOS
+ * `signatureVerifier.verifySignature` checks for a "1..." owner.
+ */
+export function signMessage(message, wif) {
+    const pair = keyPairFromWif(wif);
+    return bitcoinMessage.sign(message, pair.d.toBuffer(32), pair.compressed).toString('base64');
+}
+export function verifyMessage(message, zelid, signature) {
+    try {
+        return bitcoinMessage.verify(message, zelid, signature);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * A self-issued FluxOS session.
+ *
+ * FluxOS accepts a login phrase it never issued as long as it starts with a
+ * 13-digit millisecond timestamp less than 16 hours old, is 40-70 characters
+ * long, and is signed by the ZelID (verificationHelperUtils.verifyUserSession).
+ * That means one signed phrase authenticates against every node on the
+ * network, with no login round-trip and no node affinity.
+ */
+export function createSession(ownerWif) {
+    const identity = identityFromWif(ownerWif);
+    const loginPhrase = `${Date.now()}${randomBytes(16).toString('hex')}`;
+    return { zelid: identity.zelid, signature: signMessage(loginPhrase, ownerWif), loginPhrase };
+}
+const SESSION_TTL_MS = 8 * 60 * 60 * 1000;
+let cachedSession;
+/** The same session for the whole process, re-issued well before it ages out. */
+export function currentSession(ownerWif) {
+    if (cachedSession &&
+        cachedSession.wif === ownerWif &&
+        Date.now() - cachedSession.issuedAt < SESSION_TTL_MS) {
+        return cachedSession.session;
+    }
+    cachedSession = { session: createSession(ownerWif), wif: ownerWif, issuedAt: Date.now() };
+    return cachedSession.session;
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

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

package/dist/pricing.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Pricing.
+ *
+ * Flux Cloud has two price tables and this server deliberately quotes only one:
+ *
+ *   USD table   what Flux Cloud (home.runonflux.io) charges. Per-resource USD
+ *               rates, a $0.99 minimum, hardware and term discounts, converted
+ *               to FLUX at market rate with a 5% discount for paying in FLUX.
+ *               Served by every node at POST /apps/calculatefiatandfluxprice.
+ *               THIS IS THE PRICE.
+ *
+ *   chain table what consensus enforces as the bare minimum for a message to
+ *               be accepted (messageVerifier.js). It has no USD floor and is
+ *               several times lower. It is used here only as a safety guard
+ *               before broadcasting a payment, never shown as a quote.
+ */
+import type { FluxClient } from './fluxapi.js';
+import type { AppSpec } from './spec.js';
+export interface UsdRates {
+    cpu: number;
+    ram: number;
+    hdd: number;
+    minPrice: number;
+    port: number;
+    scope: number;
+    staticip: number;
+    fluxmultiplier: number;
+    multiplier: number;
+    minUSDPrice: number;
+}
+/** Bundled fallback, identical to ZelBack/config/default.js `usdprice` (Sept 2026). */
+export declare const DEFAULT_USD_RATES: UsdRates;
+export interface ChainPriceInterval {
+    height: number;
+    cpu: number;
+    ram: number;
+    hdd: number;
+    minPrice: number;
+    port: number;
+    scope: number;
+    staticip: number;
+}
+export interface DeploymentInformation {
+    price: ChainPriceInterval[];
+    address: string;
+    minimumInstances?: number;
+    maximumInstances?: number;
+    minBlocksAllowance?: number;
+    maxBlocksAllowance?: number;
+    blocksLasting?: number;
+}
+export interface Quote {
+    /** The price, in US dollars, for the whole term. */
+    usd: number;
+    /** FLUX to send for the whole term, at market rate, with the pay-in-FLUX discount applied. */
+    flux: number;
+    /** Discount in percent for paying with FLUX rather than card. */
+    fluxDiscountPercent: number | string;
+    /** Term length in blocks and in network months. */
+    expireBlocks: number;
+    months: number;
+    usdPerMonth: number;
+    /** FLUX/USD market rate implied by the quote. */
+    fluxUsdRate: number | null;
+    source: 'flux-cloud' | 'local-estimate';
+}
+/** Live USD quote from the network, for a registration or an update of an existing app. */
+export declare function quoteFromNetwork(api: FluxClient, spec: AppSpec): Promise<Quote>;
+export declare function fetchUsdRates(statsUrl: string): Promise<UsdRates>;
+/** FLUX price in USD, the way FluxOS derives it: BTC/USD from the rates service times FLUX/BTC. */
+export declare function fetchFluxUsdRate(ratesUrl: string): Promise<number>;
+/**
+ * Monthly USD price of a specification, mirroring appPricePerMonth() with the
+ * USD table. Per-instance price is a third of the resource total (one
+ * instance of three), then multiplied out to the instance count.
+ */
+export declare function usdPerMonth(spec: AppSpec, rates?: UsdRates): number;
+/**
+ * Local mirror of the Flux Cloud USD price for a NEW registration, used for
+ * instant what-if estimates and to sanity check the network's answer. It does
+ * not know about update credits or marketplace multipliers, so the network
+ * quote stays authoritative.
+ */
+export declare function estimateUsd(spec: AppSpec, rates?: UsdRates): number;
+export declare function estimateQuote(spec: AppSpec, rates: UsdRates, fluxUsdRate: number): Quote;
+export declare function chainInterval(table: ChainPriceInterval[], height: number): ChainPriceInterval;
+/**
+ * The minimum FLUX consensus will accept for this message at `height`
+ * (messageVerifier.js). For updates the network additionally credits the
+ * unused part of the previous term, so the true minimum is lower still; using
+ * the registration formula errs on the safe side.
+ */
+export declare function consensusMinimumFlux(spec: AppSpec, table: ChainPriceInterval[], height: number): number;

package/dist/pricing.js

@@ -0,0 +1,192 @@
+/**
+ * Pricing.
+ *
+ * Flux Cloud has two price tables and this server deliberately quotes only one:
+ *
+ *   USD table   what Flux Cloud (home.runonflux.io) charges. Per-resource USD
+ *               rates, a $0.99 minimum, hardware and term discounts, converted
+ *               to FLUX at market rate with a 5% discount for paying in FLUX.
+ *               Served by every node at POST /apps/calculatefiatandfluxprice.
+ *               THIS IS THE PRICE.
+ *
+ *   chain table what consensus enforces as the bare minimum for a message to
+ *               be accepted (messageVerifier.js). It has no USD floor and is
+ *               several times lower. It is used here only as a safety guard
+ *               before broadcasting a payment, never shown as a quote.
+ */
+import { BLOCKS_PER_MONTH, isPortEnterprise, totalResources } from './spec.js';
+/** Bundled fallback, identical to ZelBack/config/default.js `usdprice` (Sept 2026). */
+export const DEFAULT_USD_RATES = {
+    cpu: 0.15,
+    ram: 0.05,
+    hdd: 0.02,
+    minPrice: 0.01,
+    port: 2,
+    scope: 4,
+    staticip: 2,
+    fluxmultiplier: 0.95,
+    multiplier: 1,
+    minUSDPrice: 0.99,
+};
+/** Live USD quote from the network, for a registration or an update of an existing app. */
+export async function quoteFromNetwork(api, spec) {
+    const price = await api.post('/apps/calculatefiatandfluxprice', spec, { timeoutMs: 60000 });
+    const months = spec.expire / BLOCKS_PER_MONTH;
+    const usd = Number(price.usd);
+    const flux = Number(price.flux);
+    const discount = typeof price.fluxDiscount === 'number' ? price.fluxDiscount : 0;
+    const rate = flux > 0 && usd > 0 ? (usd / flux) * (1 - discount / 100) : null;
+    return {
+        usd,
+        flux,
+        fluxDiscountPercent: price.fluxDiscount,
+        expireBlocks: spec.expire,
+        months: round2(months),
+        usdPerMonth: months > 0 ? round2(usd / months) : usd,
+        fluxUsdRate: rate === null ? null : Number(rate.toFixed(4)),
+        source: 'flux-cloud',
+    };
+}
+export async function fetchUsdRates(statsUrl) {
+    try {
+        const response = await fetch(`${statsUrl}/apps/getappspecsusdprice`, {
+            signal: AbortSignal.timeout(10000),
+        });
+        const payload = (await response.json());
+        if (payload.status === 'success' && payload.data && payload.data.cpu)
+            return payload.data;
+    }
+    catch {
+        // fall through to the bundled table
+    }
+    return DEFAULT_USD_RATES;
+}
+/** FLUX price in USD, the way FluxOS derives it: BTC/USD from the rates service times FLUX/BTC. */
+export async function fetchFluxUsdRate(ratesUrl) {
+    const response = await fetch(`${ratesUrl}/rates`, { signal: AbortSignal.timeout(10000) });
+    const payload = (await response.json());
+    const usd = payload[0]?.find((rate) => rate.code === 'USD');
+    const fluxInBtc = payload[1]?.FLUX;
+    if (!usd || fluxInBtc === undefined)
+        throw new Error('Rates service returned no FLUX/USD rate');
+    return usd.rate * fluxInBtc;
+}
+function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+function ceil2(value) {
+    return Math.ceil(value * 100) / 100;
+}
+/**
+ * Monthly USD price of a specification, mirroring appPricePerMonth() with the
+ * USD table. Per-instance price is a third of the resource total (one
+ * instance of three), then multiplied out to the instance count.
+ */
+export function usdPerMonth(spec, rates = DEFAULT_USD_RATES) {
+    const res = totalResources(spec);
+    const enterprisePorts = spec.compose.flatMap((c) => c.ports.filter(isPortEnterprise)).length;
+    let total = res.cpu * rates.cpu * 10 + (res.ram * rates.ram) / 100 + res.hdd * rates.hdd;
+    if (spec.nodes.length || spec.enterprise)
+        total += rates.scope;
+    if (spec.staticip)
+        total += rates.staticip;
+    total += enterprisePorts * rates.port;
+    let price = ceil2(total / 3);
+    const extra = spec.instances - 1;
+    if (extra > 0) {
+        if (price < 0.5 && extra > 2)
+            price += extra * 0.5;
+        else
+            price = (Math.ceil(price * extra * 100) + Math.ceil(price * 100)) / 100;
+    }
+    if (price < rates.minUSDPrice)
+        price = Number(rates.minUSDPrice.toFixed(2));
+    return price;
+}
+/**
+ * Local mirror of the Flux Cloud USD price for a NEW registration, used for
+ * instant what-if estimates and to sanity check the network's answer. It does
+ * not know about update credits or marketplace multipliers, so the network
+ * quote stays authoritative.
+ */
+export function estimateUsd(spec, rates = DEFAULT_USD_RATES) {
+    const months = spec.expire / BLOCKS_PER_MONTH;
+    let price = Number((usdPerMonth(spec, rates) * months).toFixed(2));
+    const res = totalResources(spec);
+    if (spec.instances < 4) {
+        if (res.cpu < 3 && res.ram < 6000 && res.hdd < 150)
+            price *= 0.8;
+        else if (res.cpu < 7 && res.ram < 29000 && res.hdd < 370)
+            price *= 0.9;
+    }
+    if (spec.compose.some((c) => c.containerData.includes('g:')))
+        price *= 0.8;
+    price = Number((price * rates.multiplier).toFixed(2));
+    if (price < rates.minUSDPrice)
+        price = rates.minUSDPrice;
+    if (months >= 9)
+        price *= 0.88;
+    else if (months >= 6)
+        price *= 0.94;
+    else if (months >= 3)
+        price *= 0.97;
+    price = Number(price.toFixed(2));
+    if (price < rates.minUSDPrice)
+        price = rates.minUSDPrice;
+    return price;
+}
+export function estimateQuote(spec, rates, fluxUsdRate) {
+    const usd = estimateUsd(spec, rates);
+    const months = spec.expire / BLOCKS_PER_MONTH;
+    return {
+        usd,
+        flux: round2((usd / fluxUsdRate) * rates.fluxmultiplier),
+        fluxDiscountPercent: round2(100 - rates.fluxmultiplier * 100),
+        expireBlocks: spec.expire,
+        months: round2(months),
+        usdPerMonth: months > 0 ? round2(usd / months) : usd,
+        fluxUsdRate: Number(fluxUsdRate.toFixed(4)),
+        source: 'local-estimate',
+    };
+}
+// ---------------------------------------------------------------------------
+// Consensus floor. Guard only; never quoted.
+// ---------------------------------------------------------------------------
+export function chainInterval(table, height) {
+    const applicable = table.filter((entry) => entry.height < height);
+    const last = applicable[applicable.length - 1];
+    if (!last)
+        throw new Error(`No chain price interval applies at height ${height}`);
+    return last;
+}
+function chainPerMonth(spec, interval) {
+    const res = totalResources(spec);
+    const enterprisePorts = spec.compose.flatMap((c) => c.ports.filter(isPortEnterprise)).length;
+    let total = res.cpu * interval.cpu * 10 + (res.ram * interval.ram) / 100 + res.hdd * interval.hdd;
+    if (spec.nodes.length || spec.enterprise)
+        total += interval.scope;
+    if (spec.staticip)
+        total += interval.staticip;
+    total += enterprisePorts * interval.port;
+    let price = ceil2(total / 3);
+    const extra = spec.instances - 1;
+    if (extra > 0) {
+        if (price < 0.5 && extra > 2)
+            price += extra * 0.5;
+        else
+            price = (Math.ceil(price * extra * 100) + Math.ceil(price * 100)) / 100;
+    }
+    return price;
+}
+/**
+ * The minimum FLUX consensus will accept for this message at `height`
+ * (messageVerifier.js). For updates the network additionally credits the
+ * unused part of the previous term, so the true minimum is lower still; using
+ * the registration formula errs on the safe side.
+ */
+export function consensusMinimumFlux(spec, table, height) {
+    const interval = chainInterval(table, height);
+    const required = ceil2(chainPerMonth(spec, interval) * (spec.expire / BLOCKS_PER_MONTH));
+    return Math.max(required, interval.minPrice);
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The Flux Cloud MCP server: tools, resources and prompts.
+ *
+ * Every price shown to an agent is the Flux Cloud USD price. The consensus
+ * minimum is never surfaced as a quote.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Config } from './config.js';
+import { walletFromConfig } from './deploy.js';
+export declare const SERVER_NAME = "flux-cloud";
+export declare const SERVER_VERSION = "0.1.0";
+export declare function createServer(config: Config): McpServer;
+export { walletFromConfig };