@odatano/core-mcp 0.1.0

package/dist/tools/indexer.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { makeRunner } from './shared.js';
+/*
+ * ODATANO v2.0 chain crawler / pre-sync (CardanoIndexerService). Status only;
+ * pauseCrawler / resumeCrawler are Admin operations and never exposed.
+ */
+export function registerIndexerTools(server, ctx) {
+    const { client, config } = ctx;
+    const run = makeRunner(ctx);
+    server.registerTool('get_sync_status', {
+        description: 'Chain crawler / pre-sync status on the host (ODATANO >= 2.0): running, syncStatus (idle / syncing / ' +
+            'synced / error), last indexed slot + height, chain tip height, syncProgress, consecutive errors. ' +
+            'When synced, query_entity over Blocks / Transactions answers from local data with no backend round-trip.',
+        inputSchema: {},
+    }, run(async () => client.callFunction('indexer', 'getStatus')));
+    server.registerTool('get_reorg_log', {
+        description: 'Recent chain reorganisations handled by the crawler (newest first): fork slot/height, blocks rolled ' +
+            'back, detected time. Empty when none occurred since the cursor start.',
+        inputSchema: {
+            limit: z.number().int().min(1).max(config.maxRows).optional().describe(`Max entries (default ${Math.min(20, config.maxRows)})`),
+        },
+    }, run(async (args) => {
+        const payload = (await client.queryEntity('indexer', 'ReorgLog', {
+            orderby: 'detectedAt desc',
+            top: args.limit ?? Math.min(20, config.maxRows),
+        }));
+        return Array.isArray(payload?.value) ? payload.value : payload;
+    }));
+}
+//# sourceMappingURL=indexer.js.map

package/dist/tools/indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../src/tools/indexer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,GAAgB;IACtE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAE5B,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,sGAAsG;YACtG,mGAAmG;YACnG,0GAA0G;QAC5G,WAAW,EAAE,EAAE;KAChB,EACD,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAC7D,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,sGAAsG;YACtG,uEAAuE;QACzE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SAChI;KACF,EACD,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,EAAE;YAC/D,OAAO,EAAE,iBAAiB;YAC1B,GAAG,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC;SAChD,CAAC,CAA4B,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/query.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServiceKey } from '../config.js';
+import { type ToolContext } from './shared.js';
+/** Read-only entities an agent may query, mapped to the service that serves them. */
+export declare const ENTITY_SERVICE: Record<string, ServiceKey>;
+/** v2.0 entities, only offered when the capability probe found the service. */
+export declare const V2_ENTITY_SERVICE: Record<string, ServiceKey>;
+export interface QueryCapabilities {
+    worker: boolean;
+    indexer: boolean;
+}
+export declare function registerQueryTools(server: McpServer, ctx: ToolContext, caps: QueryCapabilities): void;

package/dist/tools/query.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { makeRunner } from './shared.js';
+/** Read-only entities an agent may query, mapped to the service that serves them. */
+export const ENTITY_SERVICE = {
+    // CardanoODataService — the indexer cache (populated by Get* reads and by the v2.0 crawler)
+    NetworkInformation: 'odata',
+    Blocks: 'odata',
+    Epochs: 'odata',
+    Pools: 'odata',
+    Dreps: 'odata',
+    Assets: 'odata',
+    AssetHistory: 'odata',
+    Transactions: 'odata',
+    TransactionInputs: 'odata',
+    TransactionOutputs: 'odata',
+    TransactionInputAssets: 'odata',
+    TransactionOutputAssets: 'odata',
+    TransactionMetadata: 'odata',
+    Accounts: 'odata',
+    Addresses: 'odata',
+    AddressAssets: 'odata',
+    AddressUTxOs: 'odata',
+    AddressTransactions: 'odata',
+    UTxOAssets: 'odata',
+    LedgerProtocolParameters: 'odata',
+    // CardanoTransactionService — build / submission audit trail
+    TransactionBuilds: 'transaction',
+    TransactionBuildInputs: 'transaction',
+    TransactionBuildOutputs: 'transaction',
+    TransactionBuildInputAssets: 'transaction',
+    TransactionBuildOutputAssets: 'transaction',
+    TransactionSubmissions: 'transaction',
+    TransactionSubmissionErrors: 'transaction',
+    AddressTransactionBuilds: 'transaction',
+    // CardanoSignService — signing workflow audit trail
+    SigningRequests: 'sign',
+    SignatureVerifications: 'sign',
+    AddressSigningRequests: 'sign',
+};
+/** v2.0 entities, only offered when the capability probe found the service. */
+export const V2_ENTITY_SERVICE = {
+    WalletJobs: 'worker',
+    WorkerWallets: 'worker',
+    SyncState: 'indexer',
+    ReorgLog: 'indexer',
+};
+export function registerQueryTools(server, ctx, caps) {
+    const { client, config } = ctx;
+    const run = makeRunner(ctx);
+    const entityMap = { ...ENTITY_SERVICE };
+    for (const [name, service] of Object.entries(V2_ENTITY_SERVICE)) {
+        if ((service === 'worker' && caps.worker) || (service === 'indexer' && caps.indexer)) {
+            entityMap[name] = service;
+        }
+    }
+    const entityNames = Object.keys(entityMap);
+    server.registerTool('query_entity', {
+        description: 'Generic OData V4 query over the ODATANO entity sets (the indexer cache: everything previously ' +
+            'fetched by the get_* tools, plus - on hosts with the v2.0 crawler - contiguously pre-synced blocks ' +
+            'and transactions). Standard OData syntax: $filter (e.g. "fee gt 500000 and blockHeight ge 1000000"), ' +
+            '$select, $expand (e.g. "inputs,outputs" on Transactions), $orderby, $top/$skip, $count. Numeric ' +
+            'Int64/Decimal fields are returned as strings (CAP 10). Read-only; write verbs are rejected upstream ' +
+            `with 405. Results are capped at ${config.maxRows} rows unless top is set lower; use skip to page. ` +
+            `Entities: ${entityNames.join(', ')}.`,
+        inputSchema: {
+            entity: z.enum(entityNames).describe('Entity set name'),
+            filter: z.string().max(4000).optional().describe('OData $filter expression'),
+            select: z.string().max(1000).optional().describe('Comma-separated $select list'),
+            expand: z.string().max(500).optional().describe('Comma-separated $expand list (compositions/associations)'),
+            orderby: z.string().max(500).optional().describe('$orderby, e.g. "blockHeight desc"'),
+            top: z.number().int().min(1).max(config.maxRows).optional()
+                .describe(`Max rows (1-${config.maxRows}, default ${config.maxRows})`),
+            skip: z.number().int().nonnegative().optional().describe('Rows to skip (paging)'),
+            count: z.boolean().optional().describe('Include the total match count as `count`'),
+        },
+    }, run(async (args) => {
+        const service = entityMap[args.entity];
+        const payload = (await client.queryEntity(service, args.entity, {
+            filter: args.filter,
+            select: args.select,
+            expand: args.expand,
+            orderby: args.orderby,
+            top: args.top ?? config.maxRows,
+            skip: args.skip,
+            count: args.count,
+        }));
+        // Collection responses are { value: [...] } (+ count when requested).
+        const rows = Array.isArray(payload?.value) ? payload.value : [];
+        return {
+            entity: args.entity,
+            service,
+            returned: rows.length,
+            ...(payload?.count !== undefined ? { count: payload.count } : {}),
+            rows,
+        };
+    }));
+}
+//# sourceMappingURL=query.js.map

package/dist/tools/query.js.map

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

package/dist/tools/read.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolContext } from './shared.js';
+/**
+ * Read tools over CardanoODataService. All upstream operations are OData
+ * actions (POST); each fetches from the configured backends on a cache miss
+ * and UPSERTs into the ODATANO indexer, so repeated calls are cheap.
+ * Lookups return `{ found: false }` on 404 instead of an error.
+ */
+export declare function registerReadTools(server: McpServer, ctx: ToolContext): void;

package/dist/tools/read.js

@@ -0,0 +1,173 @@
+import { z } from 'zod';
+import { assetUnit, bech32Address, clampedInt, drepId, hex56, hex64, hexString, poolId, stakeAddress, } from '../schemas.js';
+import { makeRunner } from './shared.js';
+/**
+ * Read tools over CardanoODataService. All upstream operations are OData
+ * actions (POST); each fetches from the configured backends on a cache miss
+ * and UPSERTs into the ODATANO indexer, so repeated calls are cheap.
+ * Lookups return `{ found: false }` on 404 instead of an error.
+ */
+export function registerReadTools(server, ctx) {
+    const { client } = ctx;
+    const run = makeRunner(ctx);
+    // ── Chain & network ────────────────────────────────────────────────
+    server.registerTool('get_network_info', {
+        description: 'Network summary of the ODATANO host: configured Cardano network (mainnet / preview / preprod), ' +
+            'current tip (block, slot, epoch) and backend health. Call once before submitting anything so ' +
+            'you know which network the host talks to.',
+        inputSchema: {},
+    }, run(async () => client.callAction('odata', 'GetNetworkInformation')));
+    server.registerTool('get_latest_block', {
+        description: 'The most recent Cardano block seen by the host (hash, height, slot, epoch, time, tx count).',
+        inputSchema: {},
+    }, run(async () => client.callAction('odata', 'GetLatestBlock')));
+    server.registerTool('get_block', {
+        description: 'Block details by block hash. Returns found:false (not an error) when the block is unknown.',
+        inputSchema: {
+            hash: hex64('hash').describe('Block hash (blake2b-256, 64 hex)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetBlockByHash', { hash: args.hash }), {
+        notFoundAs: (args) => ({ hash: args.hash }),
+    }));
+    server.registerTool('get_epoch', {
+        description: 'Epoch details (start/end time, block and tx counts, output, fees, active stake). ' +
+            'Omit epochNumber for the current epoch.',
+        inputSchema: {
+            epochNumber: z.number().int().nonnegative().optional().describe('Epoch number; omit for the latest epoch'),
+        },
+    }, run(async (args) => args.epochNumber === undefined
+        ? client.callAction('odata', 'GetLatestEpoch')
+        : client.callAction('odata', 'GetEpochByNumber', { epochNumber: args.epochNumber }), { notFoundAs: (args) => ({ epochNumber: args.epochNumber }) }));
+    server.registerTool('get_protocol_parameters', {
+        description: 'Current ledger protocol parameters (min fee coefficients, min UTxO / coinsPerUtxoByte, max tx size, ' +
+            'Plutus cost models, collateral percentage, ...). Use when reasoning about fees, min-ADA or script budgets.',
+        inputSchema: {},
+    }, run(async () => client.callAction('odata', 'GetLedgerProtocolParameters')));
+    server.registerTool('get_transaction', {
+        description: 'Transaction by hash: block, slot, fee, size, deposit, validity, asset movements. ' +
+            'Set includeInputsOutputs to also return the resolved inputs and outputs (addresses, lovelace, assets, datums). ' +
+            'Returns found:false when the transaction is unknown to all backends.',
+        inputSchema: {
+            hash: hex64('hash').describe('Transaction hash (64 hex)'),
+            includeInputsOutputs: z.boolean().optional()
+                .describe('Also return inputs and outputs (one extra request); default false'),
+        },
+    }, run(async (args) => {
+        const tx = await client.callAction('odata', 'GetTransactionByHash', { hash: args.hash });
+        if (!args.includeInputsOutputs)
+            return tx;
+        // The action indexed the tx (and its inputs/outputs). Expand via a
+        // collection query: ODATANO's key-read handler serves the row straight
+        // from the indexer and ignores $expand, the collection path honours it.
+        const page = (await client.queryEntity('odata', 'Transactions', {
+            filter: `hash eq '${args.hash}'`,
+            expand: 'inputs,outputs',
+            top: 1,
+        }));
+        return page?.value?.[0] ?? tx;
+    }, { notFoundAs: (args) => ({ hash: args.hash }) }));
+    server.registerTool('get_transaction_metadata', {
+        description: 'On-chain metadata of a transaction as a list of { label, json } entries (CIP-20 messages, ' +
+            'label-1447 financial anchors, CIP-25 NFT metadata, ...). Empty list when the tx carries none.',
+        inputSchema: {
+            txHash: hex64('txHash').describe('Transaction hash (64 hex)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetMetadataByTxHash', { txHash: args.txHash }), {
+        notFoundAs: (args) => ({ txHash: args.txHash }),
+    }));
+    server.registerTool('parse_transaction_cbor', {
+        description: 'Decode hex transaction CBOR (signed or unsigned) into structured fields: inputs, outputs, fee, ' +
+            'validity interval, mint, metadata, required signers, witness summary. Pure function - no network, ' +
+            'no DB write. Use it to inspect an unsigned build before asking a human to sign, or to check a ' +
+            'signed CBOR before submitting. Capped at 128 KiB of hex.',
+        inputSchema: {
+            cbor: hexString('cbor', 131072).describe('Hex-encoded transaction CBOR'),
+        },
+    }, run(async (args) => client.callAction('odata', 'ParseTransactionCbor', { cbor: args.cbor }), { keepCbor: true }));
+    // ── Address, UTxO & assets ─────────────────────────────────────────
+    server.registerTool('get_address', {
+        description: 'Address summary: lovelace balance, native-asset balances, stake address, tx count. ' +
+            'Returns found:false when the address has never appeared on-chain.',
+        inputSchema: {
+            address: bech32Address.describe('Bech32 payment address (addr… / addr_test…)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetAddressByBech32', { address: args.address }), {
+        notFoundAs: (args) => ({ address: args.address }),
+    }));
+    server.registerTool('get_utxos', {
+        description: 'Unspent outputs. Pass EITHER address (bech32) OR credential (28-byte payment credential hash, 56 hex) - ' +
+            'the credential form aggregates every bech32 address sharing that payment key/script hash (Koios-only, ' +
+            'always fresh). Each UTxO: txHash, outputIndex, lovelace, assets, inline datum / datum hash, reference script.',
+        inputSchema: {
+            address: bech32Address.optional().describe('Bech32 payment address'),
+            credential: hex56('credential').optional().describe('Payment credential hash (56 hex)'),
+        },
+    }, run(async (args) => {
+        if (!!args.address === !!args.credential) {
+            throw new Error('pass exactly one of address / credential');
+        }
+        return args.address
+            ? client.callAction('odata', 'GetUTxOsByAddress', { address: args.address })
+            : client.callAction('odata', 'GetUTxOsByCredential', { credential: args.credential });
+    }, { notFoundAs: (args) => ({ address: args.address, credential: args.credential }) }));
+    server.registerTool('get_address_assets', {
+        description: 'Native assets held by an address: unit (policyId+assetNameHex), quantity, decoded asset name.',
+        inputSchema: {
+            address: bech32Address.describe('Bech32 payment address'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetAssetsByAddress', { address: args.address }), {
+        notFoundAs: (args) => ({ address: args.address }),
+    }));
+    server.registerTool('get_address_transactions', {
+        description: 'Most recent transactions touching an address (newest first): txHash, block, slot, time.',
+        inputSchema: {
+            address: bech32Address.describe('Bech32 payment address'),
+            limit: clampedInt('limit', 1, 100, 20).describe('Max transactions (1-100, default 20)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetLatestTransactionsByAddress', { address: args.address, limit: args.limit }), { notFoundAs: (args) => ({ address: args.address }) }));
+    server.registerTool('get_asset_info', {
+        description: 'Native asset by unit (policyId + assetNameHex): total supply, mint/burn tx count, first mint, ' +
+            'CIP-25 (on-chain, label 721) and CIP-26 (off-chain registry) metadata where available.',
+        inputSchema: {
+            unit: assetUnit.describe('policyId (56 hex) + assetNameHex (0-64 hex)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetAssetInfo', { unit: args.unit }), {
+        notFoundAs: (args) => ({ unit: args.unit }),
+    }));
+    server.registerTool('get_asset_history', {
+        description: 'Mint / burn events of a native asset, most recent first: txHash, quantity delta, block time ' +
+            '(time may be null when only Blockfrost is available).',
+        inputSchema: {
+            unit: assetUnit.describe('policyId (56 hex) + assetNameHex (0-64 hex)'),
+            limit: clampedInt('limit', 1, 100, 20).describe('Max events (1-100, default 20)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetAssetHistory', { unit: args.unit, limit: args.limit }), {
+        notFoundAs: (args) => ({ unit: args.unit }),
+    }));
+    // ── Staking & governance ───────────────────────────────────────────
+    server.registerTool('get_account', {
+        description: 'Stake account by stake address: controlled amount, rewards, withdrawals, delegated pool, DRep delegation.',
+        inputSchema: {
+            stakeAddress: stakeAddress.describe('Bech32 stake address (stake… / stake_test…)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetAccountByStakeAddress', { stakeAddress: args.stakeAddress }), {
+        notFoundAs: (args) => ({ stakeAddress: args.stakeAddress }),
+    }));
+    server.registerTool('get_pool', {
+        description: 'Stake pool by pool id: ticker, name, pledge, margin, fixed cost, live/active stake, saturation, delegators.',
+        inputSchema: {
+            poolId: poolId.describe('Bech32 pool id (pool1…)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetPoolById', { poolId: args.poolId }), {
+        notFoundAs: (args) => ({ poolId: args.poolId }),
+    }));
+    server.registerTool('get_drep', {
+        description: 'Governance DRep by id: voting power, active status, anchor URL/hash, delegator count.',
+        inputSchema: {
+            drepId: drepId.describe('Bech32 DRep id (drep1… / drep_script1…)'),
+        },
+    }, run(async (args) => client.callAction('odata', 'GetDrepById', { drepId: args.drepId }), {
+        notFoundAs: (args) => ({ drepId: args.drepId }),
+    }));
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/shared.d.ts

@@ -0,0 +1,31 @@
+import { type OdatanoClient } from '../client.js';
+import type { OdatanoMcpConfig } from '../config.js';
+export interface ToolContext {
+    client: OdatanoClient;
+    config: OdatanoMcpConfig;
+}
+export type ToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export interface RunOptions<A> {
+    /** Keep CBOR/script hex fields verbatim (tools whose job is returning them). */
+    keepCbor?: boolean;
+    /** Turn an upstream 404 into `{ found: false, ...detail(args) }` instead of an error. */
+    notFoundAs?: (args: A) => Record<string, unknown>;
+}
+/** Fixed sentence appended to every build tool description. */
+export declare const UNSIGNED_HINT: string;
+export declare const JSON_HINT = " JSON parameters may be passed as a JSON string or as a native JSON value.";
+/**
+ * Uniform handler wrapper: JSON success payloads (trimmed), API errors reported
+ * as tool errors (isError) with status + ODATANO code so the agent can react
+ * (401 -> credentials, 429 -> back off, 400 ODATANO_INVALID_INPUT -> fix args)
+ * instead of crashing the call. Two upstream outcomes are NOT errors for an
+ * agent and are normalised: 404 on a lookup (`found: false`) and 409
+ * ODATANO_TX_ALREADY_SUBMITTED (`alreadySubmitted: true`).
+ */
+export declare function makeRunner(ctx: ToolContext): <A>(fn: (args: A) => Promise<unknown>, opts?: RunOptions<A>) => (args: A) => Promise<ToolResult>;

package/dist/tools/shared.js

@@ -0,0 +1,42 @@
+import { OdatanoApiError } from '../client.js';
+import { notFound, trimResult } from '../output.js';
+/** Fixed sentence appended to every build tool description. */
+export const UNSIGNED_HINT = ' Returns UNSIGNED CBOR (unsignedTxCbor) + fee + buildId; NOTHING is signed or submitted. ' +
+    'Hand the buildId to create_signing_request so a human / wallet can sign, then submit_signed_transaction.';
+export const JSON_HINT = ' JSON parameters may be passed as a JSON string or as a native JSON value.';
+/**
+ * Uniform handler wrapper: JSON success payloads (trimmed), API errors reported
+ * as tool errors (isError) with status + ODATANO code so the agent can react
+ * (401 -> credentials, 429 -> back off, 400 ODATANO_INVALID_INPUT -> fix args)
+ * instead of crashing the call. Two upstream outcomes are NOT errors for an
+ * agent and are normalised: 404 on a lookup (`found: false`) and 409
+ * ODATANO_TX_ALREADY_SUBMITTED (`alreadySubmitted: true`).
+ */
+export function makeRunner(ctx) {
+    return function run(fn, opts = {}) {
+        return async (args) => {
+            try {
+                const raw = await fn(args);
+                const result = trimResult(raw, { maxRows: ctx.config.maxRows, keepCbor: opts.keepCbor });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            catch (err) {
+                if (err instanceof OdatanoApiError) {
+                    if (err.status === 404 && opts.notFoundAs) {
+                        const body = notFound({ ...opts.notFoundAs(args), message: err.message });
+                        return { content: [{ type: 'text', text: JSON.stringify(body, null, 2) }] };
+                    }
+                    if (err.status === 409 && err.code === 'ODATANO_TX_ALREADY_SUBMITTED') {
+                        const body = { alreadySubmitted: true, httpStatus: 409, code: err.code, message: err.message };
+                        return { content: [{ type: 'text', text: JSON.stringify(body, null, 2) }] };
+                    }
+                    const detail = { httpStatus: err.status, code: err.code ?? null, message: err.message };
+                    return { content: [{ type: 'text', text: JSON.stringify(detail, null, 2) }], isError: true };
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: 'text', text: message }], isError: true };
+            }
+        };
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

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

package/dist/tools/sign.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolContext } from './shared.js';
+export declare function registerSignTools(server: McpServer, ctx: ToolContext): void;

package/dist/tools/sign.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { bech32Address, hexString, network, uuid } from '../schemas.js';
+import { makeRunner } from './shared.js';
+/*
+ * Signing handoff, verification and submit. The MCP server never signs:
+ * a build becomes a signing request whose instructions a human, a CIP-30
+ * wallet or a CLI fulfil; the agent then verifies and/or submits the signed
+ * CBOR. HSM signing (SignWithHsm / SignAndSubmitWithHsm) is deliberately not
+ * exposed - that is a server-held key, i.e. the wallet the agent must not have.
+ */
+const signerType = z.enum(['cardano-cli', 'browser-wallet', 'hardware-wallet', 'custom'])
+    .describe('Which kind of signer produced the CBOR');
+export function registerSignTools(server, ctx) {
+    const { client } = ctx;
+    const run = makeRunner(ctx);
+    server.registerTool('create_signing_request', {
+        description: 'Turn a build into a signing request for EXTERNAL signing: returns signingRequestId, the unsigned CBOR, ' +
+            'human-readable signing instructions and a ready-to-run cardano-cli command. This is the artefact you ' +
+            'hand to the human / wallet owner. State machine: pending -> verified (verify_signature) -> submitted ' +
+            '(submit_verified_transaction). Persisted for audit.',
+        inputSchema: {
+            buildId: uuid('buildId').describe('Build id from a build_* tool'),
+            message: z.string().max(500).optional().describe('Optional note shown to the signer (what this tx is for)'),
+        },
+    }, run(async (args) => client.callAction('sign', 'CreateSigningRequest', args), {
+        keepCbor: true,
+        notFoundAs: (args) => ({ buildId: args.buildId }),
+    }));
+    server.registerTool('get_signing_request', {
+        description: 'Signing request by id: status (pending / verified / submitted / failed), build, instructions, tx hash once submitted.',
+        inputSchema: {
+            signingRequestId: uuid('signingRequestId').describe('Signing request id'),
+        },
+    }, run(async (args) => client.callAction('sign', 'GetSigningRequest', { signingRequestId: args.signingRequestId }), {
+        keepCbor: true,
+        notFoundAs: (args) => ({ signingRequestId: args.signingRequestId }),
+    }));
+    server.registerTool('list_signing_requests', {
+        description: 'Signing requests created for a sender address (newest first): id, status, buildId, created time.',
+        inputSchema: {
+            address: bech32Address.describe('Sender address (bech32)'),
+        },
+    }, run(async (args) => client.callAction('sign', 'GetSigningRequestsByAddress', { address: args.address }), {
+        notFoundAs: (args) => ({ address: args.address }),
+    }));
+    server.registerTool('verify_signature', {
+        description: 'Verify a signed transaction CBOR against its signing request WITHOUT submitting: checks that the body ' +
+            'matches the build and that valid Ed25519 witnesses exist for the fee payer and every required signer. ' +
+            'Stores the verification for audit and moves the request to "verified". Optionally binds the request ' +
+            'to a sender address.',
+        inputSchema: {
+            signingRequestId: uuid('signingRequestId').describe('Signing request id'),
+            signedTxCbor: hexString('signedTxCbor').describe('Signed transaction CBOR (hex)'),
+            signerType,
+            signerInfo: z.string().max(100).optional().describe('Free-text signer info (wallet name, operator, ...)'),
+            address: bech32Address.optional().describe('Optional sender address for ownership verification'),
+        },
+    }, run(async (args) => client.callAction('sign', 'VerifySignature', args)));
+    server.registerTool('verify_data_signature', {
+        description: 'Verify a CIP-30 signData (COSE_Sign1) message signature against a bech32 address: Ed25519 signature ' +
+            'valid, signer key hashes to the address payment credential, and (optionally) the signed payload equals ' +
+            'expectedPayload (anti-replay). Stateless - no DB write, no key access. Use for wallet-based login / ' +
+            'consent proofs. Returns { valid, reason?, signedPayload, signerVkh }.',
+        inputSchema: {
+            address: bech32Address.describe('Address the wallet claimed to sign with'),
+            coseSignature: hexString('coseSignature').describe('Hex COSE_Sign1 CBOR (the `signature` field from signData)'),
+            coseKey: hexString('coseKey').describe('Hex COSE_Key CBOR (the `key` field from signData)'),
+            expectedPayload: z.string().max(10000).optional().describe('Optional expected UTF-8 payload; when set the signed payload must equal it'),
+        },
+    }, run(async (args) => client.callAction('sign', 'VerifyDataSignature', args)));
+    server.registerTool('submit_signed_transaction', {
+        description: 'Submit an ALREADY SIGNED transaction CBOR to the Cardano network. Two modes: with buildId the host ' +
+            'checks the CBOR against the recorded build and links the submission to it; without buildId pass ' +
+            'network and the raw signed CBOR is submitted as-is (parse_transaction_cbor first if unsure). ' +
+            'This tool only submits - the CBOR must already carry valid witnesses; the host will reject unsigned ' +
+            'or mis-signed CBOR. Returns { id (submissionId), txHash, status }. A duplicate submit returns ' +
+            'alreadySubmitted:true rather than an error.',
+        inputSchema: {
+            signedTxCbor: hexString('signedTxCbor').describe('Signed transaction CBOR (hex)'),
+            buildId: uuid('buildId').optional().describe('Build id to submit against (preferred)'),
+            network: network.optional().describe('Required when no buildId: the network the host must submit to (safety check)'),
+        },
+    }, run(async (args) => {
+        if (args.buildId) {
+            return client.callAction('transaction', 'SubmitTransaction', { buildId: args.buildId, signedTxCbor: args.signedTxCbor });
+        }
+        if (!args.network)
+            throw new Error('pass buildId, or network for a raw signed CBOR submit');
+        return client.callAction('transaction', 'SubmitSignedTransaction', { signedTxCbor: args.signedTxCbor, network: args.network });
+    }));
+    server.registerTool('submit_verified_transaction', {
+        description: 'Verify + submit in one step for a signing request: runs the same checks as verify_signature, then ' +
+            'submits, updates the request to "submitted" and records the submission. deferSubmit=true returns ' +
+            'immediately with the tx hash and status pending while the network submit happens detached (track via ' +
+            'get_signing_request / get_submission_status).',
+        inputSchema: {
+            signingRequestId: uuid('signingRequestId').describe('Signing request id'),
+            signedTxCbor: hexString('signedTxCbor').describe('Signed transaction CBOR (hex)'),
+            signerType,
+            signerInfo: z.string().max(100).optional().describe('Free-text signer info'),
+            address: bech32Address.optional().describe('Optional sender address for ownership verification'),
+            deferSubmit: z.boolean().optional().describe('Return after verify + claim; submit runs detached'),
+        },
+    }, run(async (args) => client.callAction('sign', 'SubmitVerifiedTransaction', args)));
+    server.registerTool('get_submission_status', {
+        description: 'Status of a transaction submission by submission id: pending -> submitted -> confirmed | failed. ' +
+            'With refresh=true the host re-queries the chain for confirmation before answering (bound action ' +
+            'CheckSubmissionStatus; only meaningful while status is submitted).',
+        inputSchema: {
+            submissionId: uuid('submissionId').describe('Submission id (`id` from a submit_* result)'),
+            refresh: z.boolean().optional().describe('Re-check the chain for confirmation first (default false)'),
+        },
+    }, run(async (args) => {
+        if (args.refresh) {
+            return client.callBoundAction('transaction', 'TransactionSubmissions', args.submissionId, 'CardanoTransactionService.CheckSubmissionStatus');
+        }
+        return client.readEntity('transaction', 'TransactionSubmissions', args.submissionId);
+    }, { notFoundAs: (args) => ({ submissionId: args.submissionId }) }));
+}
+//# sourceMappingURL=sign.js.map

package/dist/tools/sign.js.map

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

package/dist/tools/worker.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolContext } from './shared.js';
+export declare function registerWorkerTools(server: McpServer, ctx: ToolContext): void;