@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/fund-layer.js

@@ -1,973 +1 @@
-import { GasTokenType } from "@wowok/wowok";
-const GAS_TOKENS = [
-    {
-        type: "0x2::wow::WOW",
-        symbol: "WOW",
-        decimals: 9,
-        name: "Wowok Token",
-        description: "Default platform gas token for all WoWok operations. 1 WOW = 10^9 MIST. Available on testnet and mainnet.",
-    },
-];
-const TESTNET_TOKENS = [];
-function buildMainnetTokensFromSDK() {
-    try {
-        const { MAINNET_BRIDGE_CONFIG } = require("@wowok/wowok");
-        if (!MAINNET_BRIDGE_CONFIG?.tokens)
-            return [];
-        const seen = new Set();
-        return MAINNET_BRIDGE_CONFIG.tokens
-            .filter((t) => {
-            if (seen.has(t.wowTypeTag))
-                return false;
-            seen.add(t.wowTypeTag);
-            return true;
-        })
-            .map((t) => ({
-            type: t.wowTypeTag,
-            symbol: t.symbol,
-            decimals: t.wowDecimals,
-            name: `${t.symbol} (Bridge)`,
-            description: t.description ?? `Bridge token on WOW mainnet. ${t.wowDecimals} decimals.`,
-        }));
-    }
-    catch {
-        return [];
-    }
-}
-export const OFFICIAL_TOKEN_REGISTRY = {
-    gas: GAS_TOKENS,
-    testnet: TESTNET_TOKENS,
-    mainnet: buildMainnetTokensFromSDK(),
-};
-export function getRegistryForNetwork(network) {
-    return [
-        ...OFFICIAL_TOKEN_REGISTRY.gas,
-        ...(network === "testnet" ? OFFICIAL_TOKEN_REGISTRY.testnet : []),
-        ...(network === "mainnet" ? OFFICIAL_TOKEN_REGISTRY.mainnet : []),
-    ];
-}
-export function findInRegistryByType(tokenType, network) {
-    const gasMatch = OFFICIAL_TOKEN_REGISTRY.gas.find((t) => t.type === tokenType);
-    if (gasMatch)
-        return gasMatch;
-    const netTokens = getRegistryForNetwork(network);
-    return netTokens.find((t) => t.type === tokenType);
-}
-export function findInRegistryBySymbol(symbol, network) {
-    const lower = symbol.toLowerCase();
-    const gasMatches = OFFICIAL_TOKEN_REGISTRY.gas.filter((t) => t.symbol.toLowerCase() === lower);
-    const netTokens = getRegistryForNetwork(network);
-    const netMatches = netTokens.filter((t) => t.symbol.toLowerCase() === lower && !gasMatches.some((g) => g.type === t.type));
-    return [...gasMatches, ...netMatches];
-}
-export async function resolveTokenByType(tokenType, network) {
-    const registryEntry = findInRegistryByType(tokenType, network);
-    if (registryEntry) {
-        return {
-            type: registryEntry.type,
-            symbol: registryEntry.symbol,
-            decimals: registryEntry.decimals,
-            name: registryEntry.name,
-            source: "registry",
-            verified: true,
-        };
-    }
-    const memKey = `${cacheNet(network)}::${tokenType}`;
-    const memHit = RESOLUTION_CACHE.get(memKey);
-    if (memHit)
-        return memHit;
-    try {
-        const { TokenInfo } = await import("@wowok/wowok");
-        const tokenInfo = TokenInfo.Instance();
-        const fetched = await tokenInfo.fetch(tokenType, undefined, network);
-        if (fetched) {
-            const resolution = {
-                type: fetched.type,
-                symbol: fetched.symbol ?? "",
-                decimals: fetched.decimals ?? 0,
-                name: fetched.name ?? "",
-                source: "cache",
-                verified: false,
-            };
-            RESOLUTION_CACHE.set(memKey, resolution);
-            return resolution;
-        }
-    }
-    catch {
-    }
-    return undefined;
-}
-export async function resolveTokensBySymbol(symbol, network, preferredType) {
-    const results = [];
-    const registryMatches = findInRegistryBySymbol(symbol, network);
-    for (const entry of registryMatches) {
-        results.push({
-            type: entry.type,
-            symbol: entry.symbol,
-            decimals: entry.decimals,
-            name: entry.name,
-            source: "registry",
-            verified: true,
-        });
-    }
-    try {
-        const { query_local_token_list } = await import("@wowok/wowok");
-        const cached = await query_local_token_list({ symbol });
-        for (const token of cached) {
-            if (results.some((r) => r.type === token.type))
-                continue;
-            results.push({
-                type: token.type,
-                symbol: token.symbol ?? "",
-                decimals: token.decimals ?? 0,
-                name: token.name ?? "",
-                source: "cache",
-                verified: false,
-            });
-        }
-    }
-    catch {
-    }
-    if (preferredType) {
-        results.sort((a, b) => {
-            if (a.type === preferredType)
-                return -1;
-            if (b.type === preferredType)
-                return 1;
-            if (a.verified && !b.verified)
-                return -1;
-            if (!a.verified && b.verified)
-                return 1;
-            return 0;
-        });
-    }
-    return results;
-}
-const AMOUNT_WITH_SYMBOL = /^(\d+(?:\.\d+)?)\s*([A-Za-z][A-Za-z0-9]*)$/;
-export function isAmountWithSymbol(value) {
-    if (typeof value !== "string")
-        return false;
-    const match = value.match(AMOUNT_WITH_SYMBOL);
-    if (!match)
-        return false;
-    const symbol = match[2];
-    return symbol.length >= 2 && symbol.length <= 10;
-}
-export async function parseAmount(amount, tokenType, network) {
-    const originalInput = amount;
-    const resolution = await resolveTokenByType(tokenType, network);
-    const precisionKnown = resolution !== undefined;
-    const decimals = resolution?.decimals ?? 9;
-    const symbol = resolution?.symbol ?? "";
-    const source = resolution?.source ?? "onchain";
-    const verified = resolution?.verified ?? false;
-    if (typeof amount === "string") {
-        const match = amount.match(AMOUNT_WITH_SYMBOL);
-        if (match) {
-            if (!precisionKnown) {
-                throw new Error(`TOKEN PRECISION UNKNOWN for ${tokenType} — REFUSING to convert "${amount}". ` +
-                    `The token's decimals could not be resolved from the official registry, local cache, ` +
-                    `or on-chain metadata, and guessing decimals would forge a wrong on-chain value. ` +
-                    `Retry (the on-chain lookup may have been transient), or pass a pure numeric value ` +
-                    `in smallest units only if you are certain of the raw u64 amount. ` +
-                    knownTokenSuggestions(network));
-            }
-            const numericPart = parseFloat(match[1]);
-            const symbolPart = match[2];
-            if (symbol && symbolPart.toLowerCase() !== symbol.toLowerCase()) {
-                throw new Error(`Amount symbol "${symbolPart}" does not match the expected token symbol "${symbol}" ` +
-                    `(type: ${tokenType}). Either use the correct symbol or pass a pure numeric value ` +
-                    `in smallest units (e.g., ${(numericPart * Math.pow(10, decimals)).toFixed(0)}).`);
-            }
-            const smallestUnit = displayToSmallestUnit(numericPart, decimals);
-            return {
-                smallestUnit,
-                displayAmount: `${numericPart} ${symbolPart}`,
-                originalInput,
-                tokenType,
-                tokenSymbol: symbol || symbolPart,
-                decimals,
-                converted: true,
-                source,
-                verified,
-                precision_known: true,
-            };
-        }
-    }
-    let smallestUnit;
-    try {
-        smallestUnit = BigInt(amount);
-    }
-    catch {
-        throw new Error(`Invalid amount: "${amount}". Expected a number, a numeric string (smallest unit), ` +
-            `or a display-format string like "2.5WOW" (matching the token's symbol).`);
-    }
-    const displayValue = precisionKnown
-        ? smallestToDisplay(smallestUnit, decimals)
-        : `${smallestUnit.toString()} raw smallest units (token precision unknown)`;
-    return {
-        smallestUnit,
-        displayAmount: precisionKnown && symbol ? `${displayValue} ${symbol}` : displayValue,
-        originalInput,
-        tokenType,
-        tokenSymbol: symbol,
-        decimals,
-        converted: false,
-        source,
-        verified,
-        precision_known: precisionKnown,
-    };
-}
-function displayToSmallestUnit(display, decimals) {
-    const str = display.toString();
-    const [wholePart, fracPart = ""] = str.split(".");
-    const paddedFrac = fracPart.padEnd(decimals, "0").slice(0, decimals);
-    const combined = wholePart + paddedFrac;
-    return BigInt(combined || "0");
-}
-export function smallestToDisplay(value, decimals) {
-    const sign = value < 0n ? "-" : "";
-    const abs = value < 0n ? -value : value;
-    const divisor = BigInt(10) ** BigInt(decimals);
-    const whole = abs / divisor;
-    const frac = abs % divisor;
-    if (frac === 0n)
-        return `${sign}${whole.toString()}`;
-    const fracStr = frac.toString().padStart(decimals, "0").replace(/0+$/, "");
-    return `${sign}${whole.toString()}.${fracStr}`;
-}
-export function displayStringToSmallest(display, decimals) {
-    const trimmed = display.trim();
-    if (!/^\d+(\.\d+)?$/.test(trimmed)) {
-        throw new Error(`Invalid display amount: "${display}". Expected a non-negative decimal number like "2.5".`);
-    }
-    const [whole, frac = ""] = trimmed.split(".");
-    if (frac.length > decimals) {
-        throw new Error(`Too many decimal places: "${display}" has ${frac.length}, but this token supports at most ${decimals} (decimals: ${decimals}).`);
-    }
-    const paddedFrac = frac.padEnd(decimals, "0");
-    return BigInt(whole + paddedFrac);
-}
-export function generateFundConfirmation(fields, ambiguities = []) {
-    const hasAmbiguity = ambiguities.length > 0;
-    const parts = [
-        "MONEY TRANSACTION CONFIRMATION REQUIRED",
-        "",
-    ];
-    for (const field of fields) {
-        const verifiedTag = field.verified ? " [VERIFIED]" : " [UNVERIFIED]";
-        const sourceTag = ` (source: ${field.source})`;
-        parts.push(`  • ${field.context}: ${field.displayAmount}${verifiedTag}${sourceTag}`);
-        if (field.converted) {
-            parts.push(`    (converted from display format to smallest unit)`);
-        }
-    }
-    if (hasAmbiguity) {
-        parts.push("", "AMBIGUITY WARNING — multiple tokens share the same symbol:");
-        for (const amb of ambiguities) {
-            parts.push(`  Symbol "${amb.symbol}" matches:`);
-            for (const c of amb.candidates) {
-                const vTag = c.verified ? " [VERIFIED]" : " [UNVERIFIED]";
-                parts.push(`    - type: ${c.type}, decimals: ${c.decimals}${vTag} (source: ${c.source})`);
-            }
-            parts.push(`    → Specify the full type string in type_parameter to disambiguate.`);
-        }
-    }
-    parts.push("", "This operation involves money. Please confirm before proceeding.");
-    return {
-        requiresConfirmation: true,
-        reason: hasAmbiguity
-            ? "Money transaction with ambiguous token symbol — user must specify full type"
-            : "Money transaction requires user confirmation",
-        fields,
-        ambiguities,
-        message: parts.join("\n"),
-    };
-}
-function extractTokenType(data, operationType, objectTokenType) {
-    if (data?.object && typeof data.object === "object" && data.object.type_parameter) {
-        return data.object.type_parameter;
-    }
-    if (operationType === "payment" && data?.type_parameter) {
-        return data.type_parameter;
-    }
-    if (objectTokenType) {
-        return objectTokenType;
-    }
-    return GasTokenType;
-}
-const MONETARY_FIELDS = {
-    service: [
-        { path: "sales.sales", context: "Service sale price", isArray: true, amountField: "price" },
-        { path: "compensation_fund_add.balance", context: "Service compensation fund deposit" },
-        { path: "order_new.buy.total_pay.balance", context: "Order payment amount" },
-        { path: "discount.discount_value", context: "Discount value" },
-    ],
-    arbitration: [
-        { path: "dispute.fee.balance", context: "Arbitration dispute fee" },
-        { path: "fee", context: "Arbitration fee" },
-    ],
-    reward: [
-        { path: "coin_add.balance", context: "Reward coin add" },
-    ],
-    treasury: [
-        { path: "deposit.coin.balance", context: "Treasury deposit amount" },
-        { path: "withdraw.amount.fixed", context: "Treasury withdrawal amount" },
-    ],
-    payment: [
-        { path: "revenue", context: "Payment amount", isArray: true, amountField: "amount.balance" },
-    ],
-    allocation: [
-        { path: "coin.balance", context: "Allocation funding amount" },
-    ],
-};
-function getNestedValue(obj, path) {
-    const parts = path.split(".");
-    let current = obj;
-    for (const part of parts) {
-        if (current == null)
-            return undefined;
-        current = current[part];
-    }
-    return current;
-}
-export async function processFundOperation(data, operationType, network, options) {
-    const result = {
-        convertedData: data,
-        warnings: [],
-        errors: [],
-        confirmation: null,
-    };
-    const fields = MONETARY_FIELDS[operationType];
-    if (!fields) {
-        return result;
-    }
-    const tokenType = extractTokenType(data, operationType, options?.objectTokenType);
-    const confirmationFields = [];
-    const ambiguities = [];
-    const seenSymbols = new Map();
-    for (const fieldDesc of fields) {
-        const isArr = fieldDesc.isArray === true;
-        const amountField = fieldDesc.amountField;
-        if (isArr && amountField) {
-            const arr = getNestedValue(data, fieldDesc.path);
-            if (Array.isArray(arr)) {
-                for (let i = 0; i < arr.length; i++) {
-                    const item = arr[i];
-                    const parts = amountField.split(".");
-                    let parentObj = item;
-                    for (let j = 0; j < parts.length - 1; j++) {
-                        parentObj = parentObj?.[parts[j]];
-                        if (parentObj == null)
-                            break;
-                    }
-                    const finalKey = parts[parts.length - 1];
-                    if (parentObj && parentObj[finalKey] != null) {
-                        const path = `${fieldDesc.path}[${i}].${amountField}`;
-                        await processSingleField(parentObj, finalKey, path, fieldDesc.context, tokenType, network, result, confirmationFields, ambiguities, seenSymbols);
-                    }
-                }
-            }
-        }
-        else {
-            const lastDot = fieldDesc.path.lastIndexOf(".");
-            const parentPath = lastDot >= 0 ? fieldDesc.path.slice(0, lastDot) : "";
-            const finalKey = lastDot >= 0 ? fieldDesc.path.slice(lastDot + 1) : fieldDesc.path;
-            const parentObj = parentPath ? getNestedValue(data, parentPath) : data;
-            if (parentObj && parentObj[finalKey] != null) {
-                await processSingleField(parentObj, finalKey, fieldDesc.path, fieldDesc.context, tokenType, network, result, confirmationFields, ambiguities, seenSymbols);
-            }
-        }
-    }
-    if (confirmationFields.length > 0) {
-        result.confirmation = generateFundConfirmation(confirmationFields, ambiguities);
-        const totalAmounts = confirmationFields.length;
-        const hasUnverified = confirmationFields.some((f) => !f.verified);
-        const hasAmbiguity = ambiguities.length > 0;
-        if (hasAmbiguity) {
-            result.warnings.push(`AMBIGUOUS TOKEN: ${ambiguities.length} token symbol(s) have multiple candidates. ` +
-                `User must specify full type string in type_parameter to disambiguate. ` +
-                `See confirmation message for details.`);
-        }
-        if (hasUnverified) {
-            result.warnings.push(`UNVERIFIED TOKEN: some monetary fields use tokens not in the official registry. ` +
-                `Precision was resolved from cache/on-chain. Verify the token type before proceeding.`);
-        }
-        result.warnings.push(`MONEY CONFIRMATION: ${totalAmounts} monetary field(s) require user confirmation. ` +
-            `Token type: ${tokenType}. Use env.confirmed=true after user consent.`);
-    }
-    return result;
-}
-async function processSingleField(parentObj, fieldKey, fieldPath, context, tokenType, network, result, confirmationFields, ambiguities, seenSymbols) {
-    const value = parentObj[fieldKey];
-    if (value == null)
-        return;
-    try {
-        const parsed = await parseAmount(value, tokenType, network);
-        if (!parsed.precision_known) {
-            result.errors.push(`FUND INPUT BLOCKED at ${fieldPath}: token precision unavailable for ${tokenType}. ` +
-                `The raw value ${JSON.stringify(value)} was NOT converted or confirmed. ` +
-                `Retry after the token info resolves (registry → cache → on-chain), ` +
-                `or use a known token. ${knownTokenSuggestions(network)}`);
-            return;
-        }
-        if (parsed.converted) {
-            parentObj[fieldKey] = parsed.smallestUnit.toString();
-        }
-        confirmationFields.push({
-            path: fieldPath,
-            displayAmount: parsed.displayAmount,
-            tokenType: parsed.tokenType,
-            tokenSymbol: parsed.tokenSymbol,
-            verified: parsed.verified,
-            source: parsed.source,
-            converted: parsed.converted,
-            context,
-        });
-        if (parsed.tokenSymbol && parsed.source !== "registry") {
-            const symbolKey = parsed.tokenSymbol.toLowerCase();
-            let candidates = seenSymbols.get(symbolKey);
-            if (!candidates) {
-                const allMatches = await resolveTokensBySymbol(parsed.tokenSymbol, network, tokenType);
-                if (allMatches.length > 1) {
-                    candidates = allMatches;
-                    seenSymbols.set(symbolKey, candidates);
-                    ambiguities.push({
-                        symbol: parsed.tokenSymbol,
-                        candidates: candidates.map((c) => ({
-                            type: c.type,
-                            decimals: c.decimals,
-                            source: c.source,
-                            verified: c.verified,
-                        })),
-                    });
-                }
-            }
-        }
-    }
-    catch (err) {
-        result.errors.push(`FUND INPUT BLOCKED at ${fieldPath}: ${err.message}`);
-    }
-}
-export function generateSkillsHint(confirmation) {
-    if (!confirmation || !confirmation.requiresConfirmation)
-        return null;
-    const hasAmbiguity = confirmation.ambiguities.length > 0;
-    if (hasAmbiguity) {
-        return ("SKILLS HINT: This money transaction has ambiguous token symbols. " +
-            "If the wowok-safety skill is installed, it can guide the user through " +
-            "interactive disambiguation. Otherwise, the MCP fund layer has already " +
-            "listed all candidates in the confirmation message — ask the user to " +
-            "specify the full token type string in type_parameter.");
-    }
-    return ("SKILLS HINT: This money transaction requires user confirmation. " +
-        "If the wowok-safety skill is installed, it provides R1-R10 confirmation " +
-        "dialogue scripts. Otherwise, present the confirmation message to the user " +
-        "and proceed only after explicit consent (env.confirmed=true).");
-}
-export async function formatChainValue(raw, tokenType, network) {
-    let rawStr;
-    try {
-        rawStr = BigInt(raw).toString();
-    }
-    catch {
-        rawStr = String(raw);
-    }
-    const resolution = await resolveTokenByType(tokenType, network);
-    if (resolution && typeof resolution.decimals === "number") {
-        let display = rawStr;
-        try {
-            display = smallestToDisplay(BigInt(rawStr), resolution.decimals);
-        }
-        catch {
-        }
-        const symbol = resolution.symbol || "";
-        const text = symbol
-            ? `${display} ${symbol} (decimals: ${resolution.decimals}; 1 ${symbol} = 10^${resolution.decimals} raw units; raw: ${rawStr})`
-            : `${display} (decimals: ${resolution.decimals}; 1 unit = 10^${resolution.decimals} raw units; raw: ${rawStr})`;
-        return {
-            raw: rawStr,
-            display,
-            symbol: symbol || undefined,
-            decimals: resolution.decimals,
-            token_type: tokenType,
-            precision_known: true,
-            text,
-        };
-    }
-    return {
-        raw: rawStr,
-        display: rawStr,
-        token_type: tokenType,
-        precision_known: false,
-        text: `${rawStr} raw smallest units (token precision unavailable for ${tokenType} — ` +
-            `cannot convert to unit value. Conversion rule once decimals N is known: ` +
-            `unit = raw / 10^N. Re-run the query to retry the on-chain precision lookup.)`,
-    };
-}
-export function registryDisplayHint(tokenType, network) {
-    if (!tokenType)
-        return undefined;
-    const entry = findInRegistryByType(tokenType, network);
-    if (!entry)
-        return undefined;
-    return { decimals: entry.decimals, symbol: entry.symbol };
-}
-const RESOLUTION_CACHE = new Map();
-const OBJECT_TYPE_CACHE = new Map();
-function cacheNet(network) {
-    return network ?? "default";
-}
-function isCacheableObjectRef(ref) {
-    return /^0x[0-9a-fA-F]{20,}$/.test(ref);
-}
-export function clearFundResolutionCaches() {
-    RESOLUTION_CACHE.clear();
-    OBJECT_TYPE_CACHE.clear();
-}
-export function knownTokenSuggestions(network) {
-    const tokens = getRegistryForNetwork(network)
-        .map(t => `${t.symbol} (${t.type}, ${t.decimals} decimals)`);
-    return tokens.length > 0
-        ? `Known tokens: ${tokens.join("; ")}.`
-        : "No officially-known tokens on this network.";
-}
-export function formatAmountText(raw, decimals, symbol) {
-    let rawStr;
-    try {
-        rawStr = BigInt(raw).toString();
-    }
-    catch {
-        rawStr = String(raw);
-    }
-    if (decimals === undefined) {
-        return `${rawStr} smallest units (token precision unknown)`;
-    }
-    let display = rawStr;
-    try {
-        display = smallestToDisplay(BigInt(rawStr), decimals);
-    }
-    catch {
-    }
-    return symbol
-        ? `${display} ${symbol} (decimals: ${decimals}; raw: ${rawStr})`
-        : `${display} (decimals: ${decimals}; raw: ${rawStr})`;
-}
-export async function convertTokenValue(tokenType, value, network) {
-    const resolution = await resolveTokenByType(tokenType, network);
-    const decimals = resolution?.decimals;
-    const symbol = resolution?.symbol || undefined;
-    const base = { token_type: tokenType, symbol, decimals };
-    if (value.raw !== undefined) {
-        let rawStr;
-        try {
-            rawStr = BigInt(value.raw).toString();
-        }
-        catch {
-            return {
-                ...base,
-                precision_known: decimals !== undefined,
-                direction: "raw_to_unit",
-                input: String(value.raw),
-                output: "",
-                error: `Invalid raw value: "${String(value.raw)}" — expected a non-negative integer (u64 smallest units).`,
-                text: `Cannot convert: invalid raw value "${String(value.raw)}".`,
-            };
-        }
-        if (decimals === undefined) {
-            return {
-                ...base,
-                precision_known: false,
-                direction: "raw_to_unit",
-                input: rawStr,
-                output: rawStr,
-                text: `${rawStr} raw smallest units (token precision unavailable for ${tokenType} — ` +
-                    `cannot convert to unit value. Rule once decimals N is known: unit = raw / 10^N.)`,
-            };
-        }
-        let unit = rawStr;
-        try {
-            unit = smallestToDisplay(BigInt(rawStr), decimals);
-        }
-        catch { }
-        return {
-            ...base,
-            precision_known: true,
-            direction: "raw_to_unit",
-            input: rawStr,
-            output: unit,
-            text: symbol
-                ? `${rawStr} raw = ${unit} ${symbol} (decimals: ${decimals}; 1 ${symbol} = 10^${decimals} raw units)`
-                : `${rawStr} raw = ${unit} (decimals: ${decimals}; 1 unit = 10^${decimals} raw units)`,
-        };
-    }
-    const unitStr = String(value.unit ?? "").trim();
-    if (decimals === undefined) {
-        return {
-            ...base,
-            precision_known: false,
-            direction: "unit_to_raw",
-            input: unitStr,
-            output: "",
-            error: `Token precision unavailable for ${tokenType} — REFUSING to convert "${unitStr}" to raw units. ` +
-                `Guessing decimals would forge a wrong on-chain value. Retry after the precision lookup succeeds, ` +
-                `or check the token's coin metadata.`,
-            text: `Cannot convert "${unitStr}" to raw units: token precision unknown for ${tokenType}.`,
-        };
-    }
-    try {
-        const raw = displayStringToSmallest(unitStr, decimals);
-        return {
-            ...base,
-            precision_known: true,
-            direction: "unit_to_raw",
-            input: unitStr,
-            output: raw.toString(),
-            text: symbol
-                ? `${unitStr} ${symbol} = ${raw.toString()} raw smallest units (decimals: ${decimals}; 1 ${symbol} = 10^${decimals} raw units)`
-                : `${unitStr} = ${raw.toString()} raw smallest units (decimals: ${decimals}; 1 unit = 10^${decimals} raw units)`,
-        };
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        return {
-            ...base,
-            precision_known: true,
-            direction: "unit_to_raw",
-            input: unitStr,
-            output: "",
-            error: msg,
-            text: `Cannot convert "${unitStr}" to raw units: ${msg}`,
-        };
-    }
-}
-export const TOKEN_GENERIC_OBJECT_TYPES = [
-    "Treasury",
-    "Allocation",
-    "Arbitration",
-    "Arb",
-    "Payment",
-    "Reward",
-    "Service",
-];
-export function extractGenericTokenType(typeRaw) {
-    if (!typeRaw || typeof typeRaw !== "string")
-        return undefined;
-    const lt = typeRaw.indexOf("<");
-    if (lt < 0)
-        return undefined;
-    let depth = 0;
-    for (let i = lt; i < typeRaw.length; i++) {
-        const ch = typeRaw[i];
-        if (ch === "<")
-            depth++;
-        else if (ch === ">") {
-            depth--;
-            if (depth === 0) {
-                return typeRaw.slice(lt + 1, i).trim() || undefined;
-            }
-        }
-    }
-    return undefined;
-}
-export async function resolveObjectTokenType(objectRef, network) {
-    if (!objectRef || typeof objectRef !== "string")
-        return undefined;
-    const cacheable = isCacheableObjectRef(objectRef);
-    const memKey = `${cacheNet(network)}::${objectRef}`;
-    if (cacheable) {
-        const memHit = OBJECT_TYPE_CACHE.get(memKey);
-        if (memHit)
-            return memHit;
-    }
-    try {
-        const { query_objects } = await import("@wowok/wowok");
-        const res = await query_objects({ objects: [objectRef], network });
-        const obj = res?.objects?.[0];
-        if (!obj)
-            return undefined;
-        const typeRaw = obj.type_raw ?? obj.content_raw?.type ?? undefined;
-        const resolution = {
-            tokenType: extractGenericTokenType(typeRaw),
-            objectType: obj.type,
-            typeRaw,
-        };
-        if (cacheable)
-            OBJECT_TYPE_CACHE.set(memKey, resolution);
-        return resolution;
-    }
-    catch {
-        return undefined;
-    }
-}
-export async function resolveOperationObjectTokenType(data, operationType, network) {
-    if (!data)
-        return undefined;
-    if (data.object && typeof data.object === "object" && typeof data.object.type_parameter === "string") {
-        return data.object.type_parameter;
-    }
-    if (operationType === "payment" && typeof data.type_parameter === "string") {
-        return data.type_parameter;
-    }
-    if (typeof data.object === "string" && data.object.length > 0) {
-        const resolved = await resolveObjectTokenType(data.object, network);
-        return resolved?.tokenType;
-    }
-    return undefined;
-}
-const RECEIVE_TOKEN_FIELDS = {
-    treasury: ["receive"],
-    allocation: ["received_coins"],
-    reward: ["receive"],
-    service: ["compensation_fund_receive"],
-    arbitration: ["receive"],
-};
-const COIN_PARAM_FIELDS = {
-    treasury: ["deposit.coin"],
-    allocation: ["coin"],
-    reward: ["coin_add"],
-    arbitration: ["dispute.fee"],
-    service: ["compensation_fund_add", "order_new.buy.total_pay"],
-};
-export async function validateOperationTokenMatch(data, operationType, objectTokenType, network) {
-    const result = { errors: [], warnings: [], objectTokenType };
-    if (!data || !objectTokenType)
-        return result;
-    const objectLabel = typeof data.object === "string" ? data.object : "the target object";
-    const mismatchMsg = (provided, context) => `TOKEN TYPE MISMATCH (${context}): ${objectLabel} only accepts ${objectTokenType} ` +
-        `(its generic token type is fixed and immutable), but ${provided} was provided. ` +
-        `Use ${objectTokenType} for this operation, or target a different object.`;
-    for (const field of RECEIVE_TOKEN_FIELDS[operationType] ?? []) {
-        const v = data[field];
-        if (v && typeof v === "object" && typeof v.token_type === "string" && v.token_type !== objectTokenType) {
-            result.errors.push(mismatchMsg(v.token_type, `field '${field}.token_type'`));
-        }
-    }
-    for (const path of COIN_PARAM_FIELDS[operationType] ?? []) {
-        const coinParam = getNestedValue(data, path);
-        if (coinParam && typeof coinParam === "object" && typeof coinParam.coin === "string") {
-            const coinRef = coinParam.coin;
-            const resolved = await resolveObjectTokenType(coinRef, network);
-            if (resolved?.tokenType) {
-                if (resolved.tokenType !== objectTokenType) {
-                    result.errors.push(mismatchMsg(resolved.tokenType, `coin '${coinRef}' at '${path}'`));
-                }
-            }
-            else if (resolved === undefined) {
-                result.warnings.push(`Could not resolve coin object '${coinRef}' (${path}) to verify its token type ` +
-                    `matches ${objectTokenType}. The on-chain type check will reject a mismatch at execution.`);
-            }
-        }
-    }
-    return result;
-}
-const OBJECT_MONEY_FIELDS = {
-    Treasury: ["balance", "inflow", "outflow"],
-    Allocation: ["balance"],
-    Arbitration: ["fee", "balance"],
-    Reward: ["balance"],
-    Service: ["compensation_fund"],
-    Payment: ["amount"],
-    Arb: ["fee"],
-};
-export async function annotateObjectMonetaryFields(obj, network) {
-    if (!obj || typeof obj !== "object" || typeof obj.type !== "string")
-        return;
-    let tokenType = extractGenericTokenType(obj.type_raw);
-    const displays = {};
-    const annotate = async (path, raw, tt) => {
-        if (raw === null || raw === undefined)
-            return;
-        if (typeof raw !== "string" && typeof raw !== "number" && typeof raw !== "bigint")
-            return;
-        displays[path] = tt
-            ? await formatChainValue(raw, tt, network)
-            : {
-                raw: String(raw),
-                display: String(raw),
-                token_type: "",
-                precision_known: false,
-                text: `${String(raw)} raw smallest units (token type could not be determined for this field — ` +
-                    `no conversion applied. Showing the true raw value; re-run the query to retry resolution.)`,
-            };
-    };
-    if (!tokenType && (obj.type === "Order" || obj.type === "Discount") && typeof obj.service === "string") {
-        try {
-            const svc = await resolveObjectTokenType(obj.service, network);
-            tokenType = svc?.tokenType;
-        }
-        catch {
-        }
-    }
-    for (const field of OBJECT_MONEY_FIELDS[obj.type] ?? []) {
-        await annotate(field, obj[field], tokenType);
-    }
-    switch (obj.type) {
-        case "Service":
-            if (Array.isArray(obj.sales)) {
-                for (let i = 0; i < obj.sales.length; i++) {
-                    await annotate(`sales[${i}].price`, obj.sales[i]?.price, tokenType);
-                }
-            }
-            break;
-        case "Order":
-            await annotate("amount", obj.amount, tokenType);
-            if (Array.isArray(obj.items)) {
-                for (let i = 0; i < obj.items.length; i++) {
-                    await annotate(`items[${i}].price`, obj.items[i]?.price, tokenType);
-                }
-            }
-            break;
-        case "Payment":
-            if (Array.isArray(obj.record)) {
-                for (let i = 0; i < obj.record.length; i++) {
-                    await annotate(`record[${i}].amount`, obj.record[i]?.amount, tokenType);
-                }
-            }
-            break;
-        case "Reward":
-            if (Array.isArray(obj.guards)) {
-                for (let i = 0; i < obj.guards.length; i++) {
-                    const amount = obj.guards[i]?.amount;
-                    if (amount && typeof amount === "object" && amount.type === 1) {
-                        await annotate(`guards[${i}].amount.value`, amount.value, tokenType);
-                    }
-                }
-            }
-            break;
-        case "Arb":
-            await annotate("indemnity.amount", obj.indemnity?.amount, tokenType);
-            break;
-        case "Discount":
-            await annotate("benchmark", obj.benchmark, tokenType);
-            if (obj.discount_type === 1) {
-                await annotate("off", obj.off, tokenType);
-            }
-            break;
-    }
-    if (Object.keys(displays).length > 0) {
-        obj._money_display = displays;
-    }
-}
-const TABLE_ITEM_MONEY_FIELDS = {
-    TableItem_TreasuryHistory: ["amount"],
-    TableItem_RewardRecord: ["total"],
-};
-export async function resolveParentObjectTokenType(parentRef, network) {
-    const res = await resolveObjectTokenType(parentRef, network);
-    if (!res)
-        return undefined;
-    if (res.objectType && TOKEN_GENERIC_OBJECT_TYPES.includes(res.objectType)) {
-        return res.tokenType;
-    }
-    return undefined;
-}
-export async function annotateTableItemMonetaryFields(item, parentTokenType, network) {
-    if (!item || typeof item !== "object" || typeof item.type !== "string")
-        return;
-    const displays = {};
-    const annotate = async (path, raw) => {
-        if (raw === null || raw === undefined)
-            return;
-        if (typeof raw !== "string" && typeof raw !== "number" && typeof raw !== "bigint")
-            return;
-        displays[path] = parentTokenType
-            ? await formatChainValue(raw, parentTokenType, network)
-            : {
-                raw: String(raw),
-                display: String(raw),
-                token_type: "",
-                precision_known: false,
-                text: `${String(raw)} raw smallest units (parent object token type could not ` +
-                    `be resolved — no conversion applied)`,
-            };
-    };
-    for (const field of TABLE_ITEM_MONEY_FIELDS[item.type] ?? []) {
-        await annotate(field, item[field]);
-    }
-    if (item.type === "TableItem_RewardRecord" && Array.isArray(item.record)) {
-        for (let i = 0; i < item.record.length; i++) {
-            await annotate(`record[${i}].amount`, item.record[i]?.amount);
-        }
-    }
-    if (Object.keys(displays).length > 0) {
-        item._money_display = displays;
-    }
-}
-export async function annotateEventMonetaryFields(event, network) {
-    if (!event || typeof event !== "object")
-        return;
-    const isNewOrder = event.type === "NewOrderEvent" ||
-        (typeof event.type === "string" && event.type.includes("::order::NewOrderEvent"));
-    if (!isNewOrder)
-        return;
-    const pj = event.parsedJson_raw ?? {};
-    const raw = event.amount ?? pj.amount;
-    if (raw === null || raw === undefined)
-        return;
-    if (typeof raw !== "string" && typeof raw !== "number" && typeof raw !== "bigint")
-        return;
-    let tokenType;
-    const service = event.service ?? pj.service;
-    if (typeof service === "string" && service) {
-        try {
-            tokenType = (await resolveObjectTokenType(service, network))?.tokenType;
-        }
-        catch {
-        }
-    }
-    event._money_display = {
-        amount: tokenType
-            ? await formatChainValue(raw, tokenType, network)
-            : {
-                raw: String(raw),
-                display: String(raw),
-                token_type: "",
-                precision_known: false,
-                text: `${String(raw)} raw smallest units (order's Service token type could not be ` +
-                    `resolved — showing the true raw value; re-run the query to retry.)`,
-            },
-    };
-}
-export async function annotateEventsMonetaryFields(events, network) {
-    if (!Array.isArray(events))
-        return;
-    for (const ev of events) {
-        try {
-            await annotateEventMonetaryFields(ev, network);
-        }
-        catch {
-        }
-    }
-}
-export async function annotateBalanceChanges(changes, network) {
-    if (!Array.isArray(changes))
-        return;
-    for (const change of changes) {
-        try {
-            const coinType = change?.coin_type;
-            const raw = change?.amount;
-            if (typeof coinType !== "string" || !coinType)
-                continue;
-            if (typeof raw !== "string" && typeof raw !== "number" && typeof raw !== "bigint")
-                continue;
-            change._money_display = {
-                amount: await formatChainValue(raw, coinType, network),
-            };
-        }
-        catch {
-        }
-    }
-}
-export async function prepareFundOperation(data, operationType, network) {
-    const objectTokenType = await resolveOperationObjectTokenType(data, operationType, network);
-    const match = await validateOperationTokenMatch(data, operationType, objectTokenType, network);
-    const processed = await processFundOperation(data, operationType, network, { objectTokenType });
-    return {
-        ...processed,
-        warnings: [...match.warnings, ...processed.warnings],
-        matchErrors: match.errors,
-        blockingErrors: [...match.errors, ...processed.errors],
-        objectTokenType,
-    };
-}
+import{GasTokenType}from'@wowok/wowok';const GAS_TOKENS=[{'type':'0x2::wow::WOW','symbol':'WOW','decimals':0x9,'name':'Wowok\x20Token','description':'Default\x20platform\x20gas\x20token\x20for\x20all\x20WoWok\x20operations.\x201\x20WOW\x20=\x2010^9\x20MIST.\x20Available\x20on\x20testnet\x20and\x20mainnet.'}],TESTNET_TOKENS=[];function buildMainnetTokensFromSDK(){try{const {MAINNET_BRIDGE_CONFIG:a}=require('@wowok/wowok');if(!a?.['tokens'])return[];const b=new Set();return a['tokens']['filter'](c=>{if(b['has'](c['wowTypeTag']))return![];return b['add'](c['wowTypeTag']),!![];})['map'](c=>({'type':c['wowTypeTag'],'symbol':c['symbol'],'decimals':c['wowDecimals'],'name':c['symbol']+'\x20(Bridge)','description':c['description']??'Bridge\x20token\x20on\x20WOW\x20mainnet.\x20'+c['wowDecimals']+'\x20decimals.'}));}catch{return[];}}export const OFFICIAL_TOKEN_REGISTRY={'gas':GAS_TOKENS,'testnet':TESTNET_TOKENS,'mainnet':buildMainnetTokensFromSDK()};export function getRegistryForNetwork(a){return[...OFFICIAL_TOKEN_REGISTRY['gas'],...a==='testnet'?OFFICIAL_TOKEN_REGISTRY['testnet']:[],...a==='mainnet'?OFFICIAL_TOKEN_REGISTRY['mainnet']:[]];}export function findInRegistryByType(a,b){const c=OFFICIAL_TOKEN_REGISTRY['gas']['find'](e=>e['type']===a);if(c)return c;const d=getRegistryForNetwork(b);return d['find'](e=>e['type']===a);}export function findInRegistryBySymbol(a,b){const c=a['toLowerCase'](),d=OFFICIAL_TOKEN_REGISTRY['gas']['filter'](g=>g['symbol']['toLowerCase']()===c),e=getRegistryForNetwork(b),f=e['filter'](g=>g['symbol']['toLowerCase']()===c&&!d['some'](h=>h['type']===g['type']));return[...d,...f];}export async function resolveTokenByType(a,b){const c=findInRegistryByType(a,b);if(c)return{'type':c['type'],'symbol':c['symbol'],'decimals':c['decimals'],'name':c['name'],'source':'registry','verified':!![]};const d=cacheNet(b)+'::'+a,e=RESOLUTION_CACHE['get'](d);if(e)return e;try{const {TokenInfo:f}=await import('@wowok/wowok'),g=f['Instance'](),h=await g['fetch'](a,undefined,b);if(h){const i={'type':h['type'],'symbol':h['symbol']??'','decimals':h['decimals']??0x0,'name':h['name']??'','source':'cache','verified':![]};return RESOLUTION_CACHE['set'](d,i),i;}}catch{}return undefined;}export async function resolveTokensBySymbol(a,b,c){const d=[],e=findInRegistryBySymbol(a,b);for(const f of e){d['push']({'type':f['type'],'symbol':f['symbol'],'decimals':f['decimals'],'name':f['name'],'source':'registry','verified':!![]});}try{const {query_local_token_list:g}=await import('@wowok/wowok'),h=await g({'symbol':a});for(const i of h){if(d['some'](j=>j['type']===i['type']))continue;d['push']({'type':i['type'],'symbol':i['symbol']??'','decimals':i['decimals']??0x0,'name':i['name']??'','source':'cache','verified':![]});}}catch{}return c&&d['sort']((j,k)=>{if(j['type']===c)return-0x1;if(k['type']===c)return 0x1;if(j['verified']&&!k['verified'])return-0x1;if(!j['verified']&&k['verified'])return 0x1;return 0x0;}),d;}const AMOUNT_WITH_SYMBOL=/^(\d+(?:\.\d+)?)\s*([A-Za-z][A-Za-z0-9]*)$/;export function isAmountWithSymbol(a){if(typeof a!=='string')return![];const b=a['match'](AMOUNT_WITH_SYMBOL);if(!b)return![];const c=b[0x2];return c['length']>=0x2&&c['length']<=0xa;}export async function parseAmount(a,b,c){const d=a,e=await resolveTokenByType(b,c),f=e!==undefined,g=e?.['decimals']??0x9,h=e?.['symbol']??'',i=e?.['source']??'onchain',j=e?.['verified']??![];if(typeof a==='string'){const m=a['match'](AMOUNT_WITH_SYMBOL);if(m){if(!f)throw new Error('TOKEN\x20PRECISION\x20UNKNOWN\x20for\x20'+b+'\x20—\x20REFUSING\x20to\x20convert\x20\x22'+a+'\x22.\x20'+'The\x20token\x27s\x20decimals\x20could\x20not\x20be\x20resolved\x20from\x20the\x20official\x20registry,\x20local\x20cache,\x20'+'or\x20on-chain\x20metadata,\x20and\x20guessing\x20decimals\x20would\x20forge\x20a\x20wrong\x20on-chain\x20value.\x20'+'Retry\x20(the\x20on-chain\x20lookup\x20may\x20have\x20been\x20transient),\x20or\x20pass\x20a\x20pure\x20numeric\x20value\x20'+'in\x20smallest\x20units\x20only\x20if\x20you\x20are\x20certain\x20of\x20the\x20raw\x20u64\x20amount.\x20'+knownTokenSuggestions(c));const n=parseFloat(m[0x1]),o=m[0x2];if(h&&o['toLowerCase']()!==h['toLowerCase']())throw new Error('Amount\x20symbol\x20\x22'+o+'\x22\x20does\x20not\x20match\x20the\x20expected\x20token\x20symbol\x20\x22'+h+'\x22\x20'+('(type:\x20'+b+').\x20Either\x20use\x20the\x20correct\x20symbol\x20or\x20pass\x20a\x20pure\x20numeric\x20value\x20')+('in\x20smallest\x20units\x20(e.g.,\x20'+(n*Math['pow'](0xa,g))['toFixed'](0x0)+').'));const p=displayToSmallestUnit(n,g);return{'smallestUnit':p,'displayAmount':n+'\x20'+o,'originalInput':d,'tokenType':b,'tokenSymbol':h||o,'decimals':g,'converted':!![],'source':i,'verified':j,'precision_known':!![]};}}let k;try{k=BigInt(a);}catch{throw new Error('Invalid\x20amount:\x20\x22'+a+'\x22.\x20Expected\x20a\x20number,\x20a\x20numeric\x20string\x20(smallest\x20unit),\x20'+'or\x20a\x20display-format\x20string\x20like\x20\x222.5WOW\x22\x20(matching\x20the\x20token\x27s\x20symbol).');}const l=f?smallestToDisplay(k,g):k['toString']()+'\x20raw\x20smallest\x20units\x20(token\x20precision\x20unknown)';return{'smallestUnit':k,'displayAmount':f&&h?l+'\x20'+h:l,'originalInput':d,'tokenType':b,'tokenSymbol':h,'decimals':g,'converted':![],'source':i,'verified':j,'precision_known':f};}function displayToSmallestUnit(a,b){const c=a['toString'](),[d,e='']=c['split']('.'),f=e['padEnd'](b,'0')['slice'](0x0,b),g=d+f;return BigInt(g||'0');}export function smallestToDisplay(a,b){const c=a<0x0n?'-':'',d=a<0x0n?-a:a,e=BigInt(0xa)**BigInt(b),f=d/e,g=d%e;if(g===0x0n)return''+c+f['toString']();const h=g['toString']()['padStart'](b,'0')['replace'](/0+$/,'');return''+c+f['toString']()+'.'+h;}export function displayStringToSmallest(a,b){const c=a['trim']();if(!/^\d+(\.\d+)?$/['test'](c))throw new Error('Invalid\x20display\x20amount:\x20\x22'+a+'\x22.\x20Expected\x20a\x20non-negative\x20decimal\x20number\x20like\x20\x222.5\x22.');const [d,e='']=c['split']('.');if(e['length']>b)throw new Error('Too\x20many\x20decimal\x20places:\x20\x22'+a+'\x22\x20has\x20'+e['length']+',\x20but\x20this\x20token\x20supports\x20at\x20most\x20'+b+'\x20(decimals:\x20'+b+').');const f=e['padEnd'](b,'0');return BigInt(d+f);}export function generateFundConfirmation(a,b=[]){const d=b['length']>0x0,e=['MONEY\x20TRANSACTION\x20CONFIRMATION\x20REQUIRED',''];for(const f of a){const g=f['verified']?'\x20[VERIFIED]':'\x20[UNVERIFIED]',h='\x20(source:\x20'+f['source']+')';e['push']('\x20\x20•\x20'+f['context']+':\x20'+f['displayAmount']+g+h),f['converted']&&e['push']('\x20\x20\x20\x20(converted\x20from\x20display\x20format\x20to\x20smallest\x20unit)');}if(d){e['push']('','AMBIGUITY\x20WARNING\x20—\x20multiple\x20tokens\x20share\x20the\x20same\x20symbol:');for(const i of b){e['push']('\x20\x20Symbol\x20\x22'+i['symbol']+'\x22\x20matches:');for(const j of i['candidates']){const k=j['verified']?'\x20[VERIFIED]':'\x20[UNVERIFIED]';e['push']('\x20\x20\x20\x20-\x20type:\x20'+j['type']+',\x20decimals:\x20'+j['decimals']+k+'\x20(source:\x20'+j['source']+')');}e['push']('\x20\x20\x20\x20→\x20Specify\x20the\x20full\x20type\x20string\x20in\x20type_parameter\x20to\x20disambiguate.');}}return e['push']('','This\x20operation\x20involves\x20money.\x20Please\x20confirm\x20before\x20proceeding.'),{'requiresConfirmation':!![],'reason':d?'Money\x20transaction\x20with\x20ambiguous\x20token\x20symbol\x20—\x20user\x20must\x20specify\x20full\x20type':'Money\x20transaction\x20requires\x20user\x20confirmation','fields':a,'ambiguities':b,'message':e['join']('\x0a')};}function extractTokenType(a,b,c){if(a?.['object']&&typeof a['object']==='object'&&a['object']['type_parameter'])return a['object']['type_parameter'];if(b==='payment'&&a?.['type_parameter'])return a['type_parameter'];if(c)return c;return GasTokenType;}const MONETARY_FIELDS={'service':[{'path':'sales.sales','context':'Service\x20sale\x20price','isArray':!![],'amountField':'price'},{'path':'compensation_fund_add.balance','context':'Service\x20compensation\x20fund\x20deposit'},{'path':'order_new.buy.total_pay.balance','context':'Order\x20payment\x20amount'},{'path':'discount.discount_value','context':'Discount\x20value'}],'arbitration':[{'path':'dispute.fee.balance','context':'Arbitration\x20dispute\x20fee'},{'path':'fee','context':'Arbitration\x20fee'}],'reward':[{'path':'coin_add.balance','context':'Reward\x20coin\x20add'}],'treasury':[{'path':'deposit.coin.balance','context':'Treasury\x20deposit\x20amount'},{'path':'withdraw.amount.fixed','context':'Treasury\x20withdrawal\x20amount'}],'payment':[{'path':'revenue','context':'Payment\x20amount','isArray':!![],'amountField':'amount.balance'}],'allocation':[{'path':'coin.balance','context':'Allocation\x20funding\x20amount'}]};function getNestedValue(a,b){const c=b['split']('.');let d=a;for(const e of c){if(d==null)return undefined;d=d[e];}return d;}export async function processFundOperation(a,b,c,d){const e={'convertedData':a,'warnings':[],'errors':[],'confirmation':null},f=MONETARY_FIELDS[b];if(!f)return e;const g=extractTokenType(a,b,d?.['objectTokenType']),h=[],k=[],l=new Map();for(const m of f){const n=m['isArray']===!![],o=m['amountField'];if(n&&o){const p=getNestedValue(a,m['path']);if(Array['isArray'](p))for(let q=0x0;q<p['length'];q++){const r=p[q],s=o['split']('.');let t=r;for(let v=0x0;v<s['length']-0x1;v++){t=t?.[s[v]];if(t==null)break;}const u=s[s['length']-0x1];if(t&&t[u]!=null){const w=m['path']+'['+q+'].'+o;await processSingleField(t,u,w,m['context'],g,c,e,h,k,l);}}}else{const x=m['path']['lastIndexOf']('.'),y=x>=0x0?m['path']['slice'](0x0,x):'',z=x>=0x0?m['path']['slice'](x+0x1):m['path'],A=y?getNestedValue(a,y):a;A&&A[z]!=null&&await processSingleField(A,z,m['path'],m['context'],g,c,e,h,k,l);}}if(h['length']>0x0){e['confirmation']=generateFundConfirmation(h,k);const B=h['length'],C=h['some'](E=>!E['verified']),D=k['length']>0x0;D&&e['warnings']['push']('AMBIGUOUS\x20TOKEN:\x20'+k['length']+'\x20token\x20symbol(s)\x20have\x20multiple\x20candidates.\x20'+'User\x20must\x20specify\x20full\x20type\x20string\x20in\x20type_parameter\x20to\x20disambiguate.\x20'+'See\x20confirmation\x20message\x20for\x20details.'),C&&e['warnings']['push']('UNVERIFIED\x20TOKEN:\x20some\x20monetary\x20fields\x20use\x20tokens\x20not\x20in\x20the\x20official\x20registry.\x20'+'Precision\x20was\x20resolved\x20from\x20cache/on-chain.\x20Verify\x20the\x20token\x20type\x20before\x20proceeding.'),e['warnings']['push']('MONEY\x20CONFIRMATION:\x20'+B+'\x20monetary\x20field(s)\x20require\x20user\x20confirmation.\x20'+('Token\x20type:\x20'+g+'.\x20Use\x20env.confirmed=true\x20after\x20user\x20consent.'));}return e;}async function processSingleField(a,b,c,d,e,f,g,h,i,j){const k=a[b];if(k==null)return;try{const l=await parseAmount(k,e,f);if(!l['precision_known']){g['errors']['push']('FUND\x20INPUT\x20BLOCKED\x20at\x20'+c+':\x20token\x20precision\x20unavailable\x20for\x20'+e+'.\x20'+('The\x20raw\x20value\x20'+JSON['stringify'](k)+'\x20was\x20NOT\x20converted\x20or\x20confirmed.\x20')+'Retry\x20after\x20the\x20token\x20info\x20resolves\x20(registry\x20→\x20cache\x20→\x20on-chain),\x20'+('or\x20use\x20a\x20known\x20token.\x20'+knownTokenSuggestions(f)));return;}l['converted']&&(a[b]=l['smallestUnit']['toString']());h['push']({'path':c,'displayAmount':l['displayAmount'],'tokenType':l['tokenType'],'tokenSymbol':l['tokenSymbol'],'verified':l['verified'],'source':l['source'],'converted':l['converted'],'context':d});if(l['tokenSymbol']&&l['source']!=='registry'){const m=l['tokenSymbol']['toLowerCase']();let n=j['get'](m);if(!n){const o=await resolveTokensBySymbol(l['tokenSymbol'],f,e);o['length']>0x1&&(n=o,j['set'](m,n),i['push']({'symbol':l['tokenSymbol'],'candidates':n['map'](p=>({'type':p['type'],'decimals':p['decimals'],'source':p['source'],'verified':p['verified']}))}));}}}catch(p){g['errors']['push']('FUND\x20INPUT\x20BLOCKED\x20at\x20'+c+':\x20'+p['message']);}}export function generateSkillsHint(a){if(!a||!a['requiresConfirmation'])return null;const b=a['ambiguities']['length']>0x0;if(b)return'SKILLS\x20HINT:\x20This\x20money\x20transaction\x20has\x20ambiguous\x20token\x20symbols.\x20'+'If\x20the\x20wowok-safety\x20skill\x20is\x20installed,\x20it\x20can\x20guide\x20the\x20user\x20through\x20'+'interactive\x20disambiguation.\x20Otherwise,\x20the\x20MCP\x20fund\x20layer\x20has\x20already\x20'+'listed\x20all\x20candidates\x20in\x20the\x20confirmation\x20message\x20—\x20ask\x20the\x20user\x20to\x20'+'specify\x20the\x20full\x20token\x20type\x20string\x20in\x20type_parameter.';return'SKILLS\x20HINT:\x20This\x20money\x20transaction\x20requires\x20user\x20confirmation.\x20'+'If\x20the\x20wowok-safety\x20skill\x20is\x20installed,\x20it\x20provides\x20R1-R10\x20confirmation\x20'+'dialogue\x20scripts.\x20Otherwise,\x20present\x20the\x20confirmation\x20message\x20to\x20the\x20user\x20'+'and\x20proceed\x20only\x20after\x20explicit\x20consent\x20(env.confirmed=true).';}export async function formatChainValue(a,b,c){let d;try{d=BigInt(a)['toString']();}catch{d=String(a);}const e=await resolveTokenByType(b,c);if(e&&typeof e['decimals']==='number'){let f=d;try{f=smallestToDisplay(BigInt(d),e['decimals']);}catch{}const g=e['symbol']||'',h=g?f+'\x20'+g+'\x20(decimals:\x20'+e['decimals']+';\x201\x20'+g+'\x20=\x2010^'+e['decimals']+'\x20raw\x20units;\x20raw:\x20'+d+')':f+'\x20(decimals:\x20'+e['decimals']+';\x201\x20unit\x20=\x2010^'+e['decimals']+'\x20raw\x20units;\x20raw:\x20'+d+')';return{'raw':d,'display':f,'symbol':g||undefined,'decimals':e['decimals'],'token_type':b,'precision_known':!![],'text':h};}return{'raw':d,'display':d,'token_type':b,'precision_known':![],'text':d+'\x20raw\x20smallest\x20units\x20(token\x20precision\x20unavailable\x20for\x20'+b+'\x20—\x20'+'cannot\x20convert\x20to\x20unit\x20value.\x20Conversion\x20rule\x20once\x20decimals\x20N\x20is\x20known:\x20'+'unit\x20=\x20raw\x20/\x2010^N.\x20Re-run\x20the\x20query\x20to\x20retry\x20the\x20on-chain\x20precision\x20lookup.)'};}export function registryDisplayHint(a,b){if(!a)return undefined;const c=findInRegistryByType(a,b);if(!c)return undefined;return{'decimals':c['decimals'],'symbol':c['symbol']};}const RESOLUTION_CACHE=new Map(),OBJECT_TYPE_CACHE=new Map();function cacheNet(a){return a??'default';}function isCacheableObjectRef(a){return/^0x[0-9a-fA-F]{20,}$/['test'](a);}export function clearFundResolutionCaches(){RESOLUTION_CACHE['clear'](),OBJECT_TYPE_CACHE['clear']();}export function knownTokenSuggestions(a){const b=getRegistryForNetwork(a)['map'](c=>c['symbol']+'\x20('+c['type']+',\x20'+c['decimals']+'\x20decimals)');return b['length']>0x0?'Known\x20tokens:\x20'+b['join'](';\x20')+'.':'No\x20officially-known\x20tokens\x20on\x20this\x20network.';}export function formatAmountText(a,b,c){let d;try{d=BigInt(a)['toString']();}catch{d=String(a);}if(b===undefined)return d+'\x20smallest\x20units\x20(token\x20precision\x20unknown)';let e=d;try{e=smallestToDisplay(BigInt(d),b);}catch{}return c?e+'\x20'+c+'\x20(decimals:\x20'+b+';\x20raw:\x20'+d+')':e+'\x20(decimals:\x20'+b+';\x20raw:\x20'+d+')';}export async function convertTokenValue(a,b,c){const d=await resolveTokenByType(a,c),f=d?.['decimals'],g=d?.['symbol']||undefined,h={'token_type':a,'symbol':g,'decimals':f};if(b['raw']!==undefined){let j;try{j=BigInt(b['raw'])['toString']();}catch{return{...h,'precision_known':f!==undefined,'direction':'raw_to_unit','input':String(b['raw']),'output':'','error':'Invalid\x20raw\x20value:\x20\x22'+String(b['raw'])+'\x22\x20—\x20expected\x20a\x20non-negative\x20integer\x20(u64\x20smallest\x20units).','text':'Cannot\x20convert:\x20invalid\x20raw\x20value\x20\x22'+String(b['raw'])+'\x22.'};}if(f===undefined)return{...h,'precision_known':![],'direction':'raw_to_unit','input':j,'output':j,'text':j+'\x20raw\x20smallest\x20units\x20(token\x20precision\x20unavailable\x20for\x20'+a+'\x20—\x20'+'cannot\x20convert\x20to\x20unit\x20value.\x20Rule\x20once\x20decimals\x20N\x20is\x20known:\x20unit\x20=\x20raw\x20/\x2010^N.)'};let k=j;try{k=smallestToDisplay(BigInt(j),f);}catch{}return{...h,'precision_known':!![],'direction':'raw_to_unit','input':j,'output':k,'text':g?j+'\x20raw\x20=\x20'+k+'\x20'+g+'\x20(decimals:\x20'+f+';\x201\x20'+g+'\x20=\x2010^'+f+'\x20raw\x20units)':j+'\x20raw\x20=\x20'+k+'\x20(decimals:\x20'+f+';\x201\x20unit\x20=\x2010^'+f+'\x20raw\x20units)'};}const i=String(b['unit']??'')['trim']();if(f===undefined)return{...h,'precision_known':![],'direction':'unit_to_raw','input':i,'output':'','error':'Token\x20precision\x20unavailable\x20for\x20'+a+'\x20—\x20REFUSING\x20to\x20convert\x20\x22'+i+'\x22\x20to\x20raw\x20units.\x20'+'Guessing\x20decimals\x20would\x20forge\x20a\x20wrong\x20on-chain\x20value.\x20Retry\x20after\x20the\x20precision\x20lookup\x20succeeds,\x20'+'or\x20check\x20the\x20token\x27s\x20coin\x20metadata.','text':'Cannot\x20convert\x20\x22'+i+'\x22\x20to\x20raw\x20units:\x20token\x20precision\x20unknown\x20for\x20'+a+'.'};try{const l=displayStringToSmallest(i,f);return{...h,'precision_known':!![],'direction':'unit_to_raw','input':i,'output':l['toString'](),'text':g?i+'\x20'+g+'\x20=\x20'+l['toString']()+'\x20raw\x20smallest\x20units\x20(decimals:\x20'+f+';\x201\x20'+g+'\x20=\x2010^'+f+'\x20raw\x20units)':i+'\x20=\x20'+l['toString']()+'\x20raw\x20smallest\x20units\x20(decimals:\x20'+f+';\x201\x20unit\x20=\x2010^'+f+'\x20raw\x20units)'};}catch(m){const n=m instanceof Error?m['message']:String(m);return{...h,'precision_known':!![],'direction':'unit_to_raw','input':i,'output':'','error':n,'text':'Cannot\x20convert\x20\x22'+i+'\x22\x20to\x20raw\x20units:\x20'+n};}}export const TOKEN_GENERIC_OBJECT_TYPES=['Treasury','Allocation','Arbitration','Arb','Payment','Reward','Service'];export function extractGenericTokenType(a){if(!a||typeof a!=='string')return undefined;const b=a['indexOf']('<');if(b<0x0)return undefined;let c=0x0;for(let d=b;d<a['length'];d++){const e=a[d];if(e==='<')c++;else{if(e==='>'){c--;if(c===0x0)return a['slice'](b+0x1,d)['trim']()||undefined;}}}return undefined;}export async function resolveObjectTokenType(a,b){if(!a||typeof a!=='string')return undefined;const c=isCacheableObjectRef(a),d=cacheNet(b)+'::'+a;if(c){const e=OBJECT_TYPE_CACHE['get'](d);if(e)return e;}try{const {query_objects:f}=await import('@wowok/wowok'),g=await f({'objects':[a],'network':b}),h=g?.['objects']?.[0x0];if(!h)return undefined;const i=h['type_raw']??h['content_raw']?.['type']??undefined,j={'tokenType':extractGenericTokenType(i),'objectType':h['type'],'typeRaw':i};if(c)OBJECT_TYPE_CACHE['set'](d,j);return j;}catch{return undefined;}}export async function resolveOperationObjectTokenType(a,b,c){if(!a)return undefined;if(a['object']&&typeof a['object']==='object'&&typeof a['object']['type_parameter']==='string')return a['object']['type_parameter'];if(b==='payment'&&typeof a['type_parameter']==='string')return a['type_parameter'];if(typeof a['object']==='string'&&a['object']['length']>0x0){const d=await resolveObjectTokenType(a['object'],c);return d?.['tokenType'];}return undefined;}const RECEIVE_TOKEN_FIELDS={'treasury':['receive'],'allocation':['received_coins'],'reward':['receive'],'service':['compensation_fund_receive'],'arbitration':['receive']},COIN_PARAM_FIELDS={'treasury':['deposit.coin'],'allocation':['coin'],'reward':['coin_add'],'arbitration':['dispute.fee'],'service':['compensation_fund_add','order_new.buy.total_pay']};export async function validateOperationTokenMatch(a,b,c,d){const e={'errors':[],'warnings':[],'objectTokenType':c};if(!a||!c)return e;const f=typeof a['object']==='string'?a['object']:'the\x20target\x20object',g=(h,i)=>'TOKEN\x20TYPE\x20MISMATCH\x20('+i+'):\x20'+f+'\x20only\x20accepts\x20'+c+'\x20'+('(its\x20generic\x20token\x20type\x20is\x20fixed\x20and\x20immutable),\x20but\x20'+h+'\x20was\x20provided.\x20')+('Use\x20'+c+'\x20for\x20this\x20operation,\x20or\x20target\x20a\x20different\x20object.');for(const h of RECEIVE_TOKEN_FIELDS[b]??[]){const i=a[h];i&&typeof i==='object'&&typeof i['token_type']==='string'&&i['token_type']!==c&&e['errors']['push'](g(i['token_type'],'field\x20\x27'+h+'.token_type\x27'));}for(const j of COIN_PARAM_FIELDS[b]??[]){const k=getNestedValue(a,j);if(k&&typeof k==='object'&&typeof k['coin']==='string'){const l=k['coin'],m=await resolveObjectTokenType(l,d);if(m?.['tokenType'])m['tokenType']!==c&&e['errors']['push'](g(m['tokenType'],'coin\x20\x27'+l+'\x27\x20at\x20\x27'+j+'\x27'));else m===undefined&&e['warnings']['push']('Could\x20not\x20resolve\x20coin\x20object\x20\x27'+l+'\x27\x20('+j+')\x20to\x20verify\x20its\x20token\x20type\x20'+('matches\x20'+c+'.\x20The\x20on-chain\x20type\x20check\x20will\x20reject\x20a\x20mismatch\x20at\x20execution.'));}}return e;}const OBJECT_MONEY_FIELDS={'Treasury':['balance','inflow','outflow'],'Allocation':['balance'],'Arbitration':['fee','balance'],'Reward':['balance'],'Service':['compensation_fund'],'Payment':['amount'],'Arb':['fee']};export async function annotateObjectMonetaryFields(a,b){if(!a||typeof a!=='object'||typeof a['type']!=='string')return;let c=extractGenericTokenType(a['type_raw']);const d={},e=async(f,g,h)=>{if(g===null||g===undefined)return;if(typeof g!=='string'&&typeof g!=='number'&&typeof g!=='bigint')return;d[f]=h?await formatChainValue(g,h,b):{'raw':String(g),'display':String(g),'token_type':'','precision_known':![],'text':String(g)+'\x20raw\x20smallest\x20units\x20(token\x20type\x20could\x20not\x20be\x20determined\x20for\x20this\x20field\x20—\x20'+'no\x20conversion\x20applied.\x20Showing\x20the\x20true\x20raw\x20value;\x20re-run\x20the\x20query\x20to\x20retry\x20resolution.)'};};if(!c&&(a['type']==='Order'||a['type']==='Discount')&&typeof a['service']==='string')try{const f=await resolveObjectTokenType(a['service'],b);c=f?.['tokenType'];}catch{}for(const g of OBJECT_MONEY_FIELDS[a['type']]??[]){await e(g,a[g],c);}switch(a['type']){case'Service':if(Array['isArray'](a['sales']))for(let h=0x0;h<a['sales']['length'];h++){await e('sales['+h+'].price',a['sales'][h]?.['price'],c);}break;case'Order':await e('amount',a['amount'],c);if(Array['isArray'](a['items']))for(let j=0x0;j<a['items']['length'];j++){await e('items['+j+'].price',a['items'][j]?.['price'],c);}break;case'Payment':if(Array['isArray'](a['record']))for(let k=0x0;k<a['record']['length'];k++){await e('record['+k+'].amount',a['record'][k]?.['amount'],c);}break;case'Reward':if(Array['isArray'](a['guards']))for(let l=0x0;l<a['guards']['length'];l++){const m=a['guards'][l]?.['amount'];m&&typeof m==='object'&&m['type']===0x1&&await e('guards['+l+'].amount.value',m['value'],c);}break;case'Arb':await e('indemnity.amount',a['indemnity']?.['amount'],c);break;case'Discount':await e('benchmark',a['benchmark'],c);a['discount_type']===0x1&&await e('off',a['off'],c);break;}Object['keys'](d)['length']>0x0&&(a['_money_display']=d);}const TABLE_ITEM_MONEY_FIELDS={'TableItem_TreasuryHistory':['amount'],'TableItem_RewardRecord':['total']};export async function resolveParentObjectTokenType(a,b){const c=await resolveObjectTokenType(a,b);if(!c)return undefined;if(c['objectType']&&TOKEN_GENERIC_OBJECT_TYPES['includes'](c['objectType']))return c['tokenType'];return undefined;}export async function annotateTableItemMonetaryFields(a,b,c){if(!a||typeof a!=='object'||typeof a['type']!=='string')return;const d={},e=async(f,g)=>{if(g===null||g===undefined)return;if(typeof g!=='string'&&typeof g!=='number'&&typeof g!=='bigint')return;d[f]=b?await formatChainValue(g,b,c):{'raw':String(g),'display':String(g),'token_type':'','precision_known':![],'text':String(g)+'\x20raw\x20smallest\x20units\x20(parent\x20object\x20token\x20type\x20could\x20not\x20'+'be\x20resolved\x20—\x20no\x20conversion\x20applied)'};};for(const f of TABLE_ITEM_MONEY_FIELDS[a['type']]??[]){await e(f,a[f]);}if(a['type']==='TableItem_RewardRecord'&&Array['isArray'](a['record']))for(let g=0x0;g<a['record']['length'];g++){await e('record['+g+'].amount',a['record'][g]?.['amount']);}Object['keys'](d)['length']>0x0&&(a['_money_display']=d);}export async function annotateEventMonetaryFields(a,b){if(!a||typeof a!=='object')return;const c=a['type']==='NewOrderEvent'||typeof a['type']==='string'&&a['type']['includes']('::order::NewOrderEvent');if(!c)return;const d=a['parsedJson_raw']??{},e=a['amount']??d['amount'];if(e===null||e===undefined)return;if(typeof e!=='string'&&typeof e!=='number'&&typeof e!=='bigint')return;let f;const g=a['service']??d['service'];if(typeof g==='string'&&g)try{f=(await resolveObjectTokenType(g,b))?.['tokenType'];}catch{}a['_money_display']={'amount':f?await formatChainValue(e,f,b):{'raw':String(e),'display':String(e),'token_type':'','precision_known':![],'text':String(e)+'\x20raw\x20smallest\x20units\x20(order\x27s\x20Service\x20token\x20type\x20could\x20not\x20be\x20'+'resolved\x20—\x20showing\x20the\x20true\x20raw\x20value;\x20re-run\x20the\x20query\x20to\x20retry.)'}};}export async function annotateEventsMonetaryFields(a,b){if(!Array['isArray'](a))return;for(const c of a){try{await annotateEventMonetaryFields(c,b);}catch{}}}export async function annotateBalanceChanges(a,b){if(!Array['isArray'](a))return;for(const c of a){try{const d=c?.['coin_type'],e=c?.['amount'];if(typeof d!=='string'||!d)continue;if(typeof e!=='string'&&typeof e!=='number'&&typeof e!=='bigint')continue;c['_money_display']={'amount':await formatChainValue(e,d,b)};}catch{}}}export async function prepareFundOperation(a,b,c){const d=await resolveOperationObjectTokenType(a,b,c),e=await validateOperationTokenMatch(a,b,d,c),f=await processFundOperation(a,b,c,{'objectTokenType':d});return{...f,'warnings':[...e['warnings'],...f['warnings']],'matchErrors':e['errors'],'blockingErrors':[...e['errors'],...f['errors']],'objectTokenType':d};}