@ironwallet/mcp-server 1.0.0-preprod.0

package/dist/tools/swap.js

@@ -0,0 +1,343 @@
+/**
+ * MCP tools for Swap Proxy (SWP): discovery, estimate, execute, status.
+ */
+import { z } from "zod";
+import { canSwap, parseNetworkId } from "../config.js";
+import { getBalance } from "../api/balances.js";
+import { assetKey, createSwap, estimateSwap, executeSwap, getSwapStatus, listSwapAssetsFrom, listSwapAssetsTo, listSwapNetworks, resolveSwapAsset, } from "../api/swap.js";
+import { signSwapTransactions } from "../signing/swap.js";
+import { enforcePolicy } from "../policy.js";
+import { logInfo } from "../log.js";
+const assetInputSchema = z.object({
+    network: z.string().describe("Network id, e.g. ethereum, bsc, bitcoin."),
+    symbol: z.string().describe("Asset symbol, e.g. ETH, USDT."),
+    address: z
+        .string()
+        .optional()
+        .nullable()
+        .describe("Token contract address. Omit/null for the native coin."),
+    decimals: z
+        .number()
+        .int()
+        .optional()
+        .describe("Token decimals. If omitted, resolved via SWP catalog (paged). Prefer passing decimals (+ address for tokens) from list_swap_assets."),
+});
+async function enrichAssets(items, addresses) {
+    return Promise.all(items.map(async (asset) => {
+        const net = parseNetworkId(asset.network);
+        const executable = Boolean(net && canSwap(net));
+        const walletAddress = net ? addresses[net] : undefined;
+        const receivable = Boolean(walletAddress);
+        let balance;
+        let balanceRaw;
+        if (walletAddress && net) {
+            try {
+                const bal = await getBalance(net, walletAddress, asset.address ?? undefined);
+                balance = bal.formatted;
+                balanceRaw = bal.raw;
+            }
+            catch {
+                // best-effort enrichment
+            }
+        }
+        return {
+            ...asset,
+            walletAddress,
+            balance,
+            balanceRaw,
+            executable,
+            receivable,
+        };
+    }));
+}
+async function buildSide(token, assetIn, walletAddress, amount, correlationId, fromForToLookup) {
+    const asset = await resolveSwapAsset(token, assetIn, {
+        correlationId,
+        fromForToLookup,
+    });
+    return {
+        asset,
+        address: walletAddress,
+        ...(amount !== undefined ? { amount } : {}),
+    };
+}
+function requireSellAddress(addresses, network) {
+    const networkId = parseNetworkId(network);
+    if (!networkId) {
+        throw new Error(`Unknown or unsupported sell network "${network}".`);
+    }
+    if (!canSwap(networkId)) {
+        throw new Error(`Swap sell/signing is not supported on "${networkId}" in this MCP build.`);
+    }
+    const address = addresses[networkId];
+    if (!address) {
+        throw new Error(`No ${networkId} address in the keystore for sell side. Re-open the wallet session to sync addresses.`);
+    }
+    return { networkId, address };
+}
+/** Buy side only needs a receive address — not local swap signing. */
+function requireBuyAddress(addresses, network) {
+    const networkId = parseNetworkId(network);
+    if (!networkId) {
+        throw new Error(`Unknown or unsupported buy network "${network}". MCP has no keystore address for it.`);
+    }
+    const address = addresses[networkId];
+    if (!address) {
+        throw new Error(`No ${networkId} address in the keystore for buy/receive side. Re-open the wallet session to sync addresses.`);
+    }
+    return { networkId, address };
+}
+/** Shared prep for estimate_swap / execute_swap (session, maxMode, sides). */
+async function prepareSwapSides(helpers, opts) {
+    const { entry, mnemonic, token } = await helpers.session(opts.wallet, opts.correlationId);
+    const sell = requireSellAddress(entry.addresses, opts.from.network);
+    const buy = requireBuyAddress(entry.addresses, opts.to.network);
+    const useMax = Boolean(opts.maxMode);
+    let sellAmount = opts.amount;
+    if (useMax && !sellAmount) {
+        const bal = await getBalance(sell.networkId, sell.address, opts.from.address ?? undefined);
+        sellAmount = bal.formatted;
+        if (Number(bal.raw) <= 0) {
+            throw new Error(`maxMode requested but ${opts.from.symbol} balance on ${sell.networkId} is zero.`);
+        }
+    }
+    if (!sellAmount) {
+        throw new Error("amount is required unless maxMode is true.");
+    }
+    const fromSide = await buildSide(token, opts.from, sell.address, sellAmount, opts.correlationId);
+    const toSide = await buildSide(token, opts.to, buy.address, undefined, opts.correlationId, fromSide.asset);
+    return {
+        entry,
+        mnemonic,
+        token,
+        sell,
+        buy,
+        useMax,
+        sellAmount,
+        fromSide,
+        toSide,
+    };
+}
+export function registerSwapTools(server, helpers) {
+    const { ok, withToolLog, session } = helpers;
+    server.registerTool("list_swap_networks", {
+        title: "List swap networks",
+        description: "List networks available for Swap Proxy (SWP). Use before listing swap assets.",
+        inputSchema: {
+            wallet: z.string().optional(),
+        },
+    }, async ({ wallet }) => withToolLog("list_swap_networks", { wallet }, async ({ correlationId }) => {
+        const { token } = await session(wallet, correlationId);
+        const networks = await listSwapNetworks(token, { correlationId });
+        return ok({
+            correlationId,
+            networks: networks.map((n) => {
+                const id = parseNetworkId(n.name);
+                return {
+                    ...n,
+                    networkId: id,
+                    executable: Boolean(id && canSwap(id)),
+                };
+            }),
+        });
+    }));
+    server.registerTool("list_swap_assets", {
+        title: "List swap assets",
+        description: "List tradable assets from Swap Proxy. direction=from lists sell assets; direction=to requires fromNetwork/fromSymbol (and fromAddress for tokens) and lists buy assets. Enriches with wallet address and balance when possible.",
+        inputSchema: {
+            wallet: z.string().optional(),
+            direction: z.enum(["from", "to"]),
+            fromNetwork: z.string().optional(),
+            fromSymbol: z.string().optional(),
+            fromAddress: z.string().optional().nullable(),
+            search: z.string().optional(),
+            networks: z.array(z.string()).optional(),
+            page: z.number().int().positive().optional(),
+            pageSize: z.number().int().positive().max(100).optional(),
+        },
+    }, async (args) => withToolLog("list_swap_assets", args, async ({ correlationId }) => {
+        const { entry, token } = await session(args.wallet, correlationId);
+        let page;
+        if (args.direction === "from") {
+            page = await listSwapAssetsFrom(token, {
+                search: args.search,
+                networks: args.networks,
+                page: args.page,
+                pageSize: args.pageSize,
+            }, { correlationId });
+        }
+        else {
+            if (!args.fromNetwork || !args.fromSymbol) {
+                throw new Error("direction=to requires fromNetwork and fromSymbol (from a prior list_swap_assets from call).");
+            }
+            page = await listSwapAssetsTo(token, {
+                from: {
+                    network: args.fromNetwork,
+                    symbol: args.fromSymbol,
+                    address: args.fromAddress ?? null,
+                },
+                search: args.search,
+                networks: args.networks,
+                page: args.page,
+                pageSize: args.pageSize,
+            }, { correlationId });
+        }
+        const items = await enrichAssets(page.items, entry.addresses);
+        return ok({
+            correlationId,
+            direction: args.direction,
+            page: page.page,
+            pageSize: page.pageSize,
+            total: page.total,
+            items,
+        });
+    }));
+    server.registerTool("estimate_swap", {
+        title: "Estimate swap",
+        description: "Get a Swap Proxy quote (amounts, fees, operationId). Quote can expire — prefer execute_swap for sending (it re-estimates). Amount is a decimal string; set maxMode=true to sell the full balance (backend corrects amount).",
+        inputSchema: {
+            wallet: z.string().optional(),
+            from: assetInputSchema,
+            to: assetInputSchema,
+            amount: z
+                .string()
+                .optional()
+                .describe("Sell amount as decimal string. Required unless maxMode."),
+            maxMode: z.boolean().optional(),
+        },
+    }, async ({ wallet, from, to, amount, maxMode }) => withToolLog("estimate_swap", { wallet, from, to, amount, maxMode }, async ({ correlationId }) => {
+        const prep = await prepareSwapSides(helpers, {
+            wallet,
+            from,
+            to,
+            amount,
+            maxMode,
+            correlationId,
+        });
+        const est = await estimateSwap(prep.token, {
+            from: prep.fromSide,
+            to: prep.toSide,
+            maxMode: prep.useMax,
+        }, { correlationId });
+        return ok({
+            correlationId,
+            operationId: est.operationId,
+            provider: est.provider,
+            amountFrom: est.from.amount ?? prep.sellAmount,
+            amountTo: est.to.amount,
+            correctedAmountFrom: est.correctedAmountFrom,
+            correctedAmountTo: est.correctedAmountTo,
+            fees: est.details?.fees,
+            details: est.details,
+            from: est.from,
+            to: est.to,
+            note: "Quote may expire. Call execute_swap to create+sign+broadcast (it performs a fresh estimate).",
+        });
+    }));
+    server.registerTool("execute_swap", {
+        title: "Execute swap",
+        description: "Execute a swap via Swap Proxy: fresh estimate → create → local sign → execute. Does NOT use the transfer relay. Returns operationId and txHash; poll with get_swap_status.",
+        inputSchema: {
+            wallet: z.string().optional(),
+            from: assetInputSchema,
+            to: assetInputSchema,
+            amount: z
+                .string()
+                .optional()
+                .describe("Sell amount as decimal string. Required unless maxMode."),
+            maxMode: z.boolean().optional(),
+        },
+    }, async ({ wallet, from, to, amount, maxMode }) => withToolLog("execute_swap", { wallet, from, to, amount, maxMode }, async ({ correlationId, started }) => {
+        const prep = await prepareSwapSides(helpers, {
+            wallet,
+            from,
+            to,
+            amount,
+            maxMode,
+            correlationId,
+        });
+        enforcePolicy(prep.entry, {
+            kind: "swap",
+            network: prep.sell.networkId,
+        });
+        logInfo("tool.execute_swap.estimate", {
+            correlationId,
+            from: assetKey(prep.fromSide.asset),
+            to: assetKey(prep.toSide.asset),
+            amount: prep.sellAmount,
+            maxMode: prep.useMax,
+        });
+        const est = await estimateSwap(prep.token, {
+            from: prep.fromSide,
+            to: prep.toSide,
+            maxMode: prep.useMax,
+        }, { correlationId });
+        if (!est.operationId) {
+            throw new Error("Swap estimate returned no operationId.");
+        }
+        // Mobile: from.amount = requested sellAmount; correctedAmountFrom separate.
+        const corrected = est.correctedAmountFrom ?? est.from.amount ?? prep.sellAmount;
+        enforcePolicy(prep.entry, {
+            kind: "swap",
+            network: prep.sell.networkId,
+            amount: corrected,
+        });
+        const createFrom = {
+            ...prep.fromSide,
+            amount: prep.sellAmount,
+        };
+        const created = await createSwap(prep.token, {
+            operationId: est.operationId,
+            correctedAmountFrom: corrected,
+            from: createFrom,
+            to: prep.toSide,
+            maxMode: prep.useMax,
+        }, { correlationId });
+        if (created.txsToSign.length === 0) {
+            throw new Error("Swap create returned no transactions to sign.");
+        }
+        if (!created.swapOrderId) {
+            throw new Error("Swap create returned no swapOrderId (order.uid). Cannot execute.");
+        }
+        const signed = await signSwapTransactions(prep.sell.networkId, prep.mnemonic, created.txsToSign);
+        if (signed.length === 0) {
+            throw new Error("No transactions were signed for this swap.");
+        }
+        const executed = await executeSwap(prep.token, {
+            operationId: created.operationId,
+            swapOrderId: created.swapOrderId,
+            from: createFrom,
+            to: prep.toSide,
+            signedTransactions: signed,
+        }, { correlationId });
+        const preferred = signed.find((t) => t.type === "MainTransfer" || t.type === "ExternalContractCall") ?? signed[0];
+        return ok({
+            correlationId,
+            operationId: executed.operationId,
+            swapOrderId: created.swapOrderId,
+            txHash: executed.txHash ?? preferred?.txHash,
+            amountFrom: corrected,
+            amountTo: est.to.amount,
+            provider: created.provider ?? est.provider,
+            fromNetwork: prep.sell.networkId,
+            toNetwork: prep.buy.networkId,
+            elapsedMs: Date.now() - started,
+            note: "Poll get_swap_status with operationId until complete. Do not re-execute blindly after a timeout.",
+        });
+    }));
+    server.registerTool("get_swap_status", {
+        title: "Get swap status",
+        description: "Poll Swap Proxy order/operation status by operationId.",
+        inputSchema: {
+            wallet: z.string().optional(),
+            operationId: z.string(),
+        },
+    }, async ({ wallet, operationId }) => withToolLog("get_swap_status", { wallet, operationId }, async ({ correlationId }) => {
+        const { token } = await session(wallet, correlationId);
+        const status = await getSwapStatus(token, operationId, {
+            correlationId,
+        });
+        return ok({ correlationId, ...status });
+    }));
+}
+//# sourceMappingURL=swap.js.map

package/dist/tools/swap.js.map

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

package/dist/tools/transfer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for balance reads and transfer relay (estimate → sign → forward).
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolHelpers } from "./helpers.js";
+export declare function registerTransferTools(server: McpServer, helpers: ToolHelpers): void;

package/dist/tools/transfer.js

@@ -0,0 +1,284 @@
+/**
+ * MCP tools for balance reads and transfer relay (estimate → sign → forward).
+ */
+import { z } from "zod";
+import { canSend } from "../config.js";
+import { resolveEntry } from "../keystore/store.js";
+import { estimate, forward, operationState } from "../api/relay.js";
+import { getBalance } from "../api/balances.js";
+import { parseUnits, formatUnits } from "ethers";
+import { signForward } from "../signing/index.js";
+import { tonPublicKeyHex } from "../signing/ton.js";
+import { enforcePolicy } from "../policy.js";
+import { logInfo, logWarn } from "../log.js";
+import { networkEnum } from "./helpers.js";
+/**
+ * Estimate a transfer and, if the amount + fee would exceed the balance, reduce
+ * the amount to `balance - fee` and re-estimate. Fees for native coins are paid
+ * in the coin (`coinFee`); for tokens the gasless fee is paid in the token
+ * (`tokenFee`). The returned `est` always matches the returned `amount`.
+ */
+async function resolveAmountForFee(opts) {
+    const { network, token, address, to, tokenAddress, memo, fromPublicKey, correlationId, } = opts;
+    const bal = await getBalance(network, address, tokenAddress);
+    const decimals = bal.decimals;
+    const balanceRaw = BigInt(bal.raw);
+    logInfo("send.resolve_amount.start", {
+        correlationId,
+        network,
+        address,
+        to,
+        requestedAmount: opts.amount,
+        balance: bal.formatted,
+        balanceRaw: bal.raw,
+        symbol: bal.symbol,
+        decimals,
+        tokenAddress,
+        hasFromPublicKey: Boolean(fromPublicKey),
+    });
+    let amount = opts.amount;
+    let adjusted = false;
+    let est = await estimate(network, token, {
+        fromAddress: address,
+        toAddress: to,
+        tokenAddress,
+        amount,
+        memo,
+        fromPublicKey,
+    }, { correlationId });
+    const feeOf = (e) => BigInt((tokenAddress ? e.estimateResult?.tokenFee : e.estimateResult?.coinFee) ??
+        "0");
+    const amountRawOf = (e, amt) => {
+        const fromEst = e.estimateResult?.amount;
+        if (fromEst != null && /^\d+$/.test(fromEst))
+            return BigInt(fromEst);
+        return parseUnits(amt, decimals);
+    };
+    // A few passes in case the fee shifts slightly when the amount changes.
+    for (let i = 0; i < 4; i++) {
+        const feeRaw = feeOf(est);
+        const requestedRaw = amountRawOf(est, amount);
+        logInfo("send.resolve_amount.pass", {
+            correlationId,
+            pass: i,
+            amount,
+            amountRaw: requestedRaw.toString(),
+            feeRaw: feeRaw.toString(),
+            fee: formatUnits(feeRaw, decimals),
+            balanceRaw: balanceRaw.toString(),
+            fits: requestedRaw + feeRaw <= balanceRaw,
+            adjusted,
+            estimateTraceId: est.traceId,
+        });
+        if (requestedRaw + feeRaw <= balanceRaw) {
+            logInfo("send.resolve_amount.ok", {
+                correlationId,
+                amount,
+                adjusted,
+                requestedAmount: opts.amount,
+                fee: formatUnits(feeRaw, decimals),
+                symbol: bal.symbol,
+            });
+            return {
+                est,
+                amount,
+                adjusted,
+                requestedAmount: opts.amount,
+                balance: bal.formatted,
+                fee: formatUnits(feeRaw, decimals),
+                symbol: bal.symbol,
+            };
+        }
+        const correctedRaw = balanceRaw - feeRaw;
+        if (correctedRaw <= 0n) {
+            throw new Error(`Balance ${bal.formatted} ${bal.symbol} is too low to cover the fee ` +
+                `(${formatUnits(feeRaw, decimals)} ${bal.symbol}).`);
+        }
+        const prev = amount;
+        amount = formatUnits(correctedRaw, decimals);
+        adjusted = true;
+        logWarn("send.resolve_amount.adjust", {
+            correlationId,
+            pass: i,
+            fromAmount: prev,
+            toAmount: amount,
+            fee: formatUnits(feeRaw, decimals),
+            balance: bal.formatted,
+            symbol: bal.symbol,
+        });
+        est = await estimate(network, token, {
+            fromAddress: address,
+            toAddress: to,
+            tokenAddress,
+            amount,
+            memo,
+            fromPublicKey,
+        }, { correlationId });
+    }
+    throw new Error("Could not fit the amount under balance minus fee (fee kept changing). Try a smaller amount.");
+}
+export function registerTransferTools(server, helpers) {
+    const { ok, withToolLog, session } = helpers;
+    server.registerTool("get_balance", {
+        title: "Get balance",
+        description: "Get the balance for a wallet on a network. Optionally pass a token contract address; omit for the native coin.",
+        inputSchema: {
+            wallet: z.string().optional().describe("Wallet name. Optional if only one exists."),
+            network: networkEnum,
+            tokenAddress: z
+                .string()
+                .optional()
+                .describe("Token contract address. Omit for the native coin."),
+        },
+    }, async ({ wallet, network, tokenAddress }) => withToolLog("get_balance", { wallet, network, tokenAddress }, async ({ correlationId }) => {
+        const entry = resolveEntry(wallet);
+        const address = entry.addresses[network];
+        if (!address) {
+            throw new Error(`Wallet "${entry.name}" has no ${network} address.`);
+        }
+        const result = await getBalance(network, address, tokenAddress);
+        return ok({ ...result, correlationId });
+    }));
+    server.registerTool("estimate_transfer", {
+        title: "Estimate transfer",
+        description: "Estimate fees for a transfer without sending. Returns fees and the number of transactions that would be signed.",
+        inputSchema: {
+            wallet: z.string().optional(),
+            network: networkEnum,
+            to: z.string().describe("Recipient address."),
+            amount: z.string().describe("Amount in asset units (decimal string)."),
+            tokenAddress: z
+                .string()
+                .optional()
+                .describe("Token contract address. Omit for the native coin."),
+            memo: z.string().optional(),
+        },
+    }, async ({ wallet, network, to, amount, tokenAddress, memo }) => withToolLog("estimate_transfer", { wallet, network, to, amount, tokenAddress, hasMemo: Boolean(memo) }, async ({ correlationId }) => {
+        if (!canSend(network)) {
+            throw new Error(`Sending on "${network}" is not supported.`);
+        }
+        const { entry, mnemonic, token } = await session(wallet, correlationId);
+        const address = entry.addresses[network];
+        const fromPublicKey = network === "ton" ? tonPublicKeyHex(mnemonic) : undefined;
+        const est = await estimate(network, token, {
+            fromAddress: address,
+            toAddress: to,
+            tokenAddress,
+            amount,
+            memo,
+            fromPublicKey,
+        }, { correlationId });
+        return ok({
+            amount: est.estimateResult?.amount,
+            coinFee: est.estimateResult?.coinFee,
+            tokenFee: est.estimateResult?.tokenFee,
+            transactionsToSign: est.estimateResult?.transactionsToSign?.length ?? 0,
+            traceId: est.traceId,
+            correlationId,
+        });
+    }));
+    server.registerTool("send_transfer", {
+        title: "Send transfer",
+        description: "Send a transfer: sign locally with the wallet's key and broadcast via the Ironwallet forward relay (estimate -> sign -> forward) for EVM, Tron, Bitcoin, Litecoin, Doge, Solana, XRP and TON. Returns the transaction hash (and operation id where applicable).",
+        inputSchema: {
+            wallet: z.string().optional(),
+            network: networkEnum,
+            to: z.string().describe("Recipient address."),
+            amount: z.string().describe("Amount in asset units (decimal string)."),
+            tokenAddress: z
+                .string()
+                .optional()
+                .describe("Token contract address. Omit for the native coin."),
+            memo: z.string().optional(),
+        },
+    }, async ({ wallet, network, to, amount, tokenAddress, memo }) => withToolLog("send_transfer", { wallet, network, to, amount, tokenAddress, hasMemo: Boolean(memo) }, async ({ correlationId, started }) => {
+        if (!canSend(network)) {
+            throw new Error(`Sending on "${network}" is not supported.`);
+        }
+        const { entry, mnemonic, token } = await session(wallet, correlationId);
+        const address = entry.addresses[network];
+        logInfo("tool.send_transfer.session", {
+            correlationId,
+            wallet: entry.name,
+            fromAddress: address,
+            network,
+        });
+        const fromPublicKey = network === "ton" ? tonPublicKeyHex(mnemonic) : undefined;
+        const resolved = await resolveAmountForFee({
+            network,
+            token,
+            address,
+            to,
+            tokenAddress,
+            amount,
+            memo,
+            fromPublicKey,
+            correlationId,
+        });
+        enforcePolicy(entry, {
+            kind: "transfer",
+            network,
+            toAddress: to,
+            amount: resolved.amount,
+        });
+        const params = {
+            fromAddress: address,
+            toAddress: to,
+            tokenAddress,
+            amount: resolved.amount,
+            memo,
+            fromPublicKey,
+        };
+        const txs = resolved.est.estimateResult?.transactionsToSign ?? [];
+        if (txs.length === 0) {
+            throw new Error("Estimate returned no transactions to sign.");
+        }
+        logInfo("tool.send_transfer.sign.start", {
+            correlationId,
+            network,
+            txCount: txs.length,
+            amount: resolved.amount,
+            adjustedForFee: resolved.adjusted,
+        });
+        const signStarted = Date.now();
+        const signed = await signForward(network, mnemonic, txs);
+        logInfo("tool.send_transfer.sign.ok", {
+            correlationId,
+            network,
+            elapsedMs: Date.now() - signStarted,
+            signedCount: signed.length,
+        });
+        const result = await forward(network, token, params, resolved.est, signed, { correlationId });
+        return ok({
+            txHash: result.txHash,
+            operationId: result.operationId,
+            chainId: result.chainId,
+            amountSent: resolved.amount,
+            adjustedForFee: resolved.adjusted,
+            requestedAmount: resolved.requestedAmount,
+            correlationId,
+            elapsedMs: Date.now() - started,
+            ...(resolved.adjusted
+                ? {
+                    note: `Requested ${resolved.requestedAmount} exceeded balance minus fee; reduced to ${resolved.amount} ${resolved.symbol} (fee ${resolved.fee} ${resolved.symbol}).`,
+                }
+                : {}),
+        });
+    }));
+    server.registerTool("get_operation_status", {
+        title: "Get operation status",
+        description: "Poll the state of a forward operation by its operation id.",
+        inputSchema: {
+            wallet: z.string().optional(),
+            network: networkEnum,
+            operationId: z.string(),
+        },
+    }, async ({ wallet, network, operationId }) => withToolLog("get_operation_status", { wallet, network, operationId }, async ({ correlationId }) => {
+        const { token } = await session(wallet, correlationId);
+        const state = await operationState(network, token, operationId, {
+            correlationId,
+        });
+        return ok({ ...state, correlationId });
+    }));
+}
+//# sourceMappingURL=transfer.js.map