@ironwallet/mcp-server 1.0.0-preprod.0

package/dist/signing/ton.js

@@ -0,0 +1,166 @@
+/**
+ * TON signing — matches mobile `ton_net_api_client` (IR-673 RelayV2 path):
+ *
+ *   Relay estimate returns unsigned wallet-transfer bodies as BoC in `txData`
+ *   (hex or base64). The client ed25519-signs each cell hash, wraps the signed
+ *   body in an external message (with wallet init when seqno == 0), and puts the
+ *   external-message BoC hex into both `signature` and `txData` of the forward
+ *   payload.
+ *
+ * Estimate must include `fromPublicKey` (32-byte ed25519 pubkey hex) — same as
+ * mobile `RelayV2EstimateRequest.fromPublicKey` for NetType.ton.
+ *
+ * `sendTon` remains as a direct TonCenter broadcast fallback (pre-relay path).
+ */
+import { Address, WalletContractV4, beginCell, Cell, external, storeMessage, internal, toNano, SendMode, TonClient, } from "@ton/ton";
+import { sign } from "@ton/crypto";
+import { ed25519 } from "@noble/curves/ed25519.js";
+import { getConfig } from "../config.js";
+import { deriveTon } from "../wallet/derive.js";
+import { logError, logInfo } from "../log.js";
+function hexToBytes(h) {
+    return Buffer.from(h.replace(/^0x/, ""), "hex");
+}
+function isHexString(value) {
+    return value.length > 0 && value.length % 2 === 0 && /^[0-9a-fA-F]+$/.test(value);
+}
+function decodeRelayPayload(txData) {
+    let normalized = txData.trim();
+    if (normalized.startsWith("0x") || normalized.startsWith("0X")) {
+        normalized = normalized.slice(2);
+    }
+    if (isHexString(normalized)) {
+        return Buffer.from(normalized, "hex");
+    }
+    return Buffer.from(normalized, "base64");
+}
+function parseRelayTxDataCell(txData) {
+    const bytes = decodeRelayPayload(txData);
+    const cells = Cell.fromBoc(bytes);
+    if (cells.length === 0) {
+        throw new Error("Invalid TON relay txData: empty BoC");
+    }
+    return cells[0];
+}
+/** 32-byte ed25519 public key hex (no 0x), for relay estimate `fromPublicKey`. */
+export function tonPublicKeyHex(mnemonic) {
+    const derived = deriveTon(mnemonic);
+    const seed = hexToBytes(derived.privateKey);
+    return Buffer.from(ed25519.getPublicKey(seed)).toString("hex");
+}
+function secretKeyFromSeed(seed) {
+    const pub = Buffer.from(ed25519.getPublicKey(seed));
+    return Buffer.concat([seed, pub]);
+}
+/**
+ * Sign relay `transactionsToSign` the same way as mobile
+ * `_signRelayWalletTransfer`: signature || unsigned body → external message BoC.
+ */
+export function signTon(ctx, txs) {
+    const seed = hexToBytes(ctx.privateKey);
+    const secretKey = secretKeyFromSeed(seed);
+    const publicKey = Buffer.from(ed25519.getPublicKey(seed));
+    const wallet = WalletContractV4.create({ workchain: 0, publicKey });
+    const destination = Address.parse(ctx.address);
+    const signed = [];
+    for (const tx of txs) {
+        if (!tx.txData)
+            continue;
+        const unsignedCell = parseRelayTxDataCell(tx.txData);
+        const signature = sign(unsignedCell.hash(), secretKey);
+        const signedBody = beginCell()
+            .storeBuffer(signature)
+            .storeSlice(unsignedCell.beginParse())
+            .endCell();
+        const unsignedSlice = unsignedCell.beginParse();
+        unsignedSlice.loadUint(32); // wallet id
+        unsignedSlice.loadUint(32); // valid until
+        const seqno = unsignedSlice.loadUint(32);
+        const externalMessage = seqno === 0
+            ? external({
+                to: destination,
+                init: wallet.init,
+                body: signedBody,
+            })
+            : external({
+                to: destination,
+                body: signedBody,
+            });
+        const externalBocHex = beginCell()
+            .store(storeMessage(externalMessage))
+            .endCell()
+            .toBoc()
+            .toString("hex");
+        signed.push({
+            txID: tx.txId ?? "",
+            signature: externalBocHex,
+            txData: externalBocHex,
+            transactionId: tx.transactionId,
+        });
+    }
+    return signed;
+}
+/** Direct TonCenter broadcast (legacy / fallback; mobile still keeps this path). */
+export async function sendTon(mnemonic, params) {
+    const started = Date.now();
+    const derived = deriveTon(mnemonic);
+    const seed = hexToBytes(derived.privateKey);
+    const secretKey = secretKeyFromSeed(seed);
+    const pub = Buffer.from(ed25519.getPublicKey(seed));
+    const wallet = WalletContractV4.create({ workchain: 0, publicKey: pub });
+    const cfg = getConfig();
+    const apiKey = process.env.IW_TON_API_KEY?.trim();
+    const endpoint = `${cfg.tonApiUrl}/jsonRPC`;
+    logInfo("ton.send.start", {
+        from: derived.address,
+        to: params.to,
+        amount: params.amount,
+        hasMemo: Boolean(params.memo),
+        endpoint,
+        hasApiKey: Boolean(apiKey),
+    });
+    try {
+        const client = new TonClient({
+            endpoint,
+            ...(apiKey ? { apiKey } : {}),
+        });
+        const opened = client.open(wallet);
+        const seqno = await opened.getSeqno();
+        logInfo("ton.send.seqno", { from: derived.address, seqno });
+        const transfer = wallet.createTransfer({
+            seqno,
+            secretKey,
+            sendMode: SendMode.PAY_GAS_SEPARATELY + SendMode.IGNORE_ERRORS,
+            messages: [
+                internal({
+                    to: Address.parse(params.to),
+                    value: toNano(params.amount),
+                    bounce: false,
+                    body: params.memo && params.memo.length > 0 ? params.memo : undefined,
+                }),
+            ],
+        });
+        await opened.send(transfer);
+        const txHash = Buffer.from(transfer.hash()).toString("base64");
+        logInfo("ton.send.ok", {
+            from: derived.address,
+            to: params.to,
+            amount: params.amount,
+            seqno,
+            txHash,
+            elapsedMs: Date.now() - started,
+        });
+        return { txHash };
+    }
+    catch (e) {
+        logError("ton.send.fail", e, {
+            from: derived.address,
+            to: params.to,
+            amount: params.amount,
+            endpoint,
+            elapsedMs: Date.now() - started,
+        });
+        throw e;
+    }
+}
+//# sourceMappingURL=ton.js.map

package/dist/signing/ton.js.map

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

package/dist/signing/tron.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tron forward signing, matching the mobile app's tron_client signer:
+ *
+ *  - The estimate returns `txId` = the transaction hash (hex).
+ *  - Sign the raw 32-byte txId bytes directly with secp256k1 (no extra hashing).
+ *  - Signature bytes = r(32) || s(32) || v(1), where v is 27/28 (web3dart's
+ *    recovery id + 27). Encoded as a 130-char hex string.
+ *  - `txData` and `txID` are returned unchanged from the estimate.
+ */
+import type { SignContext, SignedTransaction, TransactionToSign } from "./types.js";
+export declare function signTron(ctx: SignContext, txs: TransactionToSign[]): SignedTransaction[];

package/dist/signing/tron.js

@@ -0,0 +1,39 @@
+/**
+ * Tron forward signing, matching the mobile app's tron_client signer:
+ *
+ *  - The estimate returns `txId` = the transaction hash (hex).
+ *  - Sign the raw 32-byte txId bytes directly with secp256k1 (no extra hashing).
+ *  - Signature bytes = r(32) || s(32) || v(1), where v is 27/28 (web3dart's
+ *    recovery id + 27). Encoded as a 130-char hex string.
+ *  - `txData` and `txID` are returned unchanged from the estimate.
+ */
+import { SigningKey, getBytes, hexlify, zeroPadValue } from "ethers";
+import { logInfo } from "../log.js";
+export function signTron(ctx, txs) {
+    const key = new SigningKey(ctx.privateKey);
+    const signed = [];
+    logInfo("sign.tron.start", { address: ctx.address, txCount: txs.length });
+    for (const item of txs) {
+        if (!item.txId)
+            throw new Error("Tron transactionToSign has no txId.");
+        if (!item.txData)
+            throw new Error("Tron transactionToSign has no txData.");
+        const digest = getBytes("0x" + item.txId.replace(/^0x/, ""));
+        const sig = key.sign(digest);
+        const r = getBytes(zeroPadValue(sig.r, 32)); // 32 bytes
+        const s = getBytes(zeroPadValue(sig.s, 32)); // 32 bytes
+        const v = sig.v; // 27 or 28
+        const raw = new Uint8Array(65);
+        raw.set(r, 0);
+        raw.set(s, 32);
+        raw[64] = v;
+        signed.push({
+            signature: hexlify(raw).replace(/^0x/, ""), // 130 hex chars, no 0x prefix
+            txData: item.txData,
+            txID: item.txId,
+            transactionId: item.transactionId,
+        });
+    }
+    return signed;
+}
+//# sourceMappingURL=tron.js.map

package/dist/signing/tron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron.js","sourceRoot":"","sources":["../../src/signing/tron.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,QAAQ,CACtB,GAAgB,EAChB,GAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,OAAO,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1E,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAE3E,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;QACxD,MAAM,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;QACxD,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW;QAE5B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAC/B,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACd,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACf,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,8BAA8B;YAC1E,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/signing/types.d.ts

@@ -0,0 +1,23 @@
+/** A transaction the backend estimate returned for the client to sign. */
+export interface TransactionToSign {
+    transactionId?: string;
+    txId?: string;
+    txData?: string;
+    extraData?: string;
+    type?: string;
+    value?: string;
+    valueEx?: string;
+}
+/** The signed transaction shape sent back in the forward request. */
+export interface SignedTransaction {
+    txID: string;
+    signature: string;
+    txData: string;
+    transactionId?: string;
+}
+export interface SignContext {
+    /** 0x-prefixed private key for the network. */
+    privateKey: string;
+    /** Sender address (network formatted). */
+    address: string;
+}

package/dist/signing/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/signing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signing/types.ts"],"names":[],"mappings":""}

package/dist/signing/xrp.d.ts

@@ -0,0 +1,11 @@
+/**
+ * XRP forward / swap signing, matching the mobile app's xrp_net_client:
+ *
+ *   - `txData` = an XRPL transaction blob (hex).
+ *   - Decode → set SigningPubKey → autofill Sequence/Fee/LastLedgerSequence →
+ *     secp256k1 sign → re-encode signed blob.
+ *   - Forward/SWP payload: `signature` = TxnSignature hex, `txData` = signed
+ *     blob hex, `txID` = transaction hash.
+ */
+import type { SignContext, SignedTransaction, TransactionToSign } from "./types.js";
+export declare function signXrp(ctx: SignContext, txs: TransactionToSign[]): Promise<SignedTransaction[]>;

package/dist/signing/xrp.js

@@ -0,0 +1,122 @@
+/**
+ * XRP forward / swap signing, matching the mobile app's xrp_net_client:
+ *
+ *   - `txData` = an XRPL transaction blob (hex).
+ *   - Decode → set SigningPubKey → autofill Sequence/Fee/LastLedgerSequence →
+ *     secp256k1 sign → re-encode signed blob.
+ *   - Forward/SWP payload: `signature` = TxnSignature hex, `txData` = signed
+ *     blob hex, `txID` = transaction hash.
+ */
+import { encode, decode, encodeForSigning } from "ripple-binary-codec";
+import { sign as rippleSign } from "ripple-keypairs";
+import { SigningKey } from "ethers";
+import { sha512 } from "@noble/hashes/sha2.js";
+import { getConfig } from "../config.js";
+import { httpJson } from "../api/http.js";
+import { logInfo } from "../log.js";
+const TX_HASH_PREFIX = Uint8Array.from([0x54, 0x58, 0x4e, 0x00]); // "TXN\0"
+/** XRPL JSON-RPC ({ method, params: [ {...} ] } envelope). */
+async function xrpRpc(method, params) {
+    const cfg = getConfig();
+    const res = await httpJson(cfg.xrpRpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ method, params: [params] }),
+    }, { retry: true });
+    const result = res.result;
+    if (!result)
+        throw new Error(`XRPL ${method} returned no result.`);
+    if (result.error)
+        throw new Error(`XRPL ${method} failed: ${result.error}`);
+    return result;
+}
+async function accountSequence(account) {
+    const r = await xrpRpc("account_info", {
+        account,
+        ledger_index: "current",
+    });
+    const seq = r.account_data?.Sequence;
+    if (seq == null)
+        throw new Error("Could not read XRP account Sequence.");
+    return seq;
+}
+async function openLedgerFee() {
+    try {
+        const r = await xrpRpc("fee", {});
+        return r.drops?.open_ledger_fee ?? r.drops?.base_fee ?? "12";
+    }
+    catch {
+        return "12";
+    }
+}
+async function currentLedgerIndex() {
+    const r = await xrpRpc("ledger_current", {});
+    return r.ledger_current_index ?? 0;
+}
+function txHash(signedBlobHex) {
+    const blob = Uint8Array.from(Buffer.from(signedBlobHex, "hex"));
+    const buf = new Uint8Array(TX_HASH_PREFIX.length + blob.length);
+    buf.set(TX_HASH_PREFIX, 0);
+    buf.set(blob, TX_HASH_PREFIX.length);
+    return Buffer.from(sha512(buf).slice(0, 32)).toString("hex").toUpperCase();
+}
+export async function signXrp(ctx, txs) {
+    if (txs.length === 0)
+        throw new Error("XRP transactionToSign list is empty.");
+    logInfo("sign.xrp.start", {
+        address: ctx.address,
+        txCount: txs.length,
+    });
+    const pubKey = SigningKey.computePublicKey(ctx.privateKey, true)
+        .replace(/^0x/, "")
+        .toUpperCase();
+    const ripplePriv = ("00" + ctx.privateKey.replace(/^0x/, "")).toUpperCase();
+    let nextSequence;
+    const fee = await openLedgerFee();
+    const ledger = await currentLedgerIndex();
+    const signed = [];
+    for (const item of txs) {
+        if (!item.txData)
+            throw new Error("XRP transactionToSign has no txData.");
+        const tx = decode(item.txData.replace(/^0x/, "").toUpperCase());
+        tx.SigningPubKey = pubKey;
+        if (tx.Account == null)
+            tx.Account = ctx.address;
+        if (tx.Sequence == null) {
+            if (nextSequence === undefined) {
+                nextSequence = await accountSequence(ctx.address);
+            }
+            tx.Sequence = nextSequence;
+            nextSequence += 1;
+        }
+        else if (typeof tx.Sequence === "number") {
+            nextSequence = tx.Sequence + 1;
+        }
+        if (tx.Fee == null)
+            tx.Fee = fee;
+        if (tx.LastLedgerSequence == null) {
+            tx.LastLedgerSequence = ledger + 20;
+        }
+        const signingData = encodeForSigning(tx);
+        tx.TxnSignature = rippleSign(signingData, ripplePriv);
+        const signedBlob = encode(tx);
+        const hash = txHash(signedBlob);
+        logInfo("sign.xrp.tx", {
+            address: ctx.address,
+            transactionId: item.transactionId,
+            txID: hash,
+            sequence: tx.Sequence,
+            fee: tx.Fee,
+            lastLedgerSequence: tx.LastLedgerSequence,
+            signedBlobLen: signedBlob.length,
+        });
+        signed.push({
+            signature: tx.TxnSignature,
+            txData: signedBlob,
+            txID: hash,
+            transactionId: item.transactionId,
+        });
+    }
+    return signed;
+}
+//# sourceMappingURL=xrp.js.map

package/dist/signing/xrp.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared MCP tool helpers: response shaping, logging wrapper, wallet session.
+ */
+import { z } from "zod";
+import { type NetworkId } from "../config.js";
+import type { WalletEntry } from "../keystore/types.js";
+export declare const networkEnum: z.ZodEnum<[NetworkId, ...NetworkId[]]>;
+export declare function ok(payload: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function fail(err: unknown): {
+    isError: true;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export type ToolOk = ReturnType<typeof ok>;
+export type ToolFail = ReturnType<typeof fail>;
+/**
+ * Wrap every MCP tool handler with start/ok/fail JSONL logging and a
+ * correlation id. Nested modules (http/relay/auth/…) reuse the same id when
+ * callers pass it through.
+ */
+export declare function withToolLog<TArgs extends Record<string, unknown> | undefined>(tool: string, args: TArgs, fn: (ctx: {
+    correlationId: string;
+    started: number;
+}) => Promise<ToolOk>): Promise<ToolOk | ToolFail>;
+/** Resolve wallet + decrypt mnemonic + obtain a Bearer token. */
+export declare function session(walletName: string | undefined, correlationId?: string): Promise<{
+    entry: WalletEntry;
+    mnemonic: string;
+    token: string;
+}>;
+export type ToolHelpers = {
+    ok: typeof ok;
+    withToolLog: typeof withToolLog;
+    session: typeof session;
+};

package/dist/tools/helpers.js

@@ -0,0 +1,80 @@
+/**
+ * Shared MCP tool helpers: response shaping, logging wrapper, wallet session.
+ */
+import { z } from "zod";
+import { ALL_NETWORKS } from "../config.js";
+import { resolveEntry, syncAddresses, unlockMnemonic, } from "../keystore/store.js";
+import { requirePassphrase } from "../passphrase.js";
+import { getAccessToken } from "../api/auth.js";
+import { logError, logInfo, newCorrelationId, } from "../log.js";
+export const networkEnum = z.enum(ALL_NETWORKS);
+export function ok(payload) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(payload, null, 2) },
+        ],
+    };
+}
+export function fail(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [{ type: "text", text: `Error: ${message}` }],
+    };
+}
+/**
+ * Wrap every MCP tool handler with start/ok/fail JSONL logging and a
+ * correlation id. Nested modules (http/relay/auth/…) reuse the same id when
+ * callers pass it through.
+ */
+export async function withToolLog(tool, args, fn) {
+    const correlationId = newCorrelationId(tool.replace(/[^a-z0-9]+/gi, "").slice(0, 12) || "tool");
+    const started = Date.now();
+    logInfo("tool.start", { correlationId, tool, args: args ?? {} });
+    try {
+        const result = await fn({ correlationId, started });
+        logInfo("tool.ok", {
+            correlationId,
+            tool,
+            elapsedMs: Date.now() - started,
+            isError: false,
+        });
+        return result;
+    }
+    catch (e) {
+        logError("tool.fail", e, {
+            correlationId,
+            tool,
+            elapsedMs: Date.now() - started,
+            args: args ?? {},
+        });
+        return fail(e);
+    }
+}
+/** Resolve wallet + decrypt mnemonic + obtain a Bearer token. */
+export async function session(walletName, correlationId) {
+    const started = Date.now();
+    logInfo("session.start", { correlationId, wallet: walletName ?? "<default>" });
+    try {
+        const resolved = resolveEntry(walletName);
+        const mnemonic = unlockMnemonic(resolved, requirePassphrase());
+        const entry = syncAddresses(resolved, mnemonic);
+        const token = await getAccessToken(mnemonic, { correlationId });
+        logInfo("session.ok", {
+            correlationId,
+            wallet: entry.name,
+            elapsedMs: Date.now() - started,
+            addressCount: Object.keys(entry.addresses).length,
+        });
+        return { entry, mnemonic, token };
+    }
+    catch (e) {
+        logError("session.fail", e, {
+            correlationId,
+            wallet: walletName ?? "<default>",
+            elapsedMs: Date.now() - started,
+        });
+        throw e;
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tool registrations. Design rule: the mnemonic never crosses the agent
+ * boundary. Tools return addresses, balances, estimates, and tx hashes — never
+ * seed words. There is intentionally no export_seed / import_wallet tool.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTools(server: McpServer): void;

package/dist/tools/index.js

@@ -0,0 +1,16 @@
+/**
+ * MCP tool registrations. Design rule: the mnemonic never crosses the agent
+ * boundary. Tools return addresses, balances, estimates, and tx hashes — never
+ * seed words. There is intentionally no export_seed / import_wallet tool.
+ */
+import { ok, session, withToolLog } from "./helpers.js";
+import { registerWalletTools } from "./wallets.js";
+import { registerTransferTools } from "./transfer.js";
+import { registerSwapTools } from "./swap.js";
+export function registerTools(server) {
+    const helpers = { ok, withToolLog, session };
+    registerWalletTools(server, helpers);
+    registerTransferTools(server, helpers);
+    registerSwapTools(server, helpers);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAC7C,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/tools/swap.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Swap Proxy (SWP): discovery, estimate, execute, status.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolHelpers } from "./helpers.js";
+export declare function registerSwapTools(server: McpServer, helpers: ToolHelpers): void;