@wowok/agent-mcp 2.3.7 → 2.3.8

package/dist/schema/call/bridge.js

@@ -0,0 +1,408 @@
+import { z } from "zod";
+import { CallEnvSchema } from "./base.js";
+import { WowAddressSchema } from "../common/index.js";
+export const BridgeTokenSchema = z.enum(["ETH", "WETH", "WBTC", "USDC", "USDT"])
+    .describe("Cross-chain token identifier. ETH=native ETH; WETH/WBTC/USDC/USDT=ERC20. Decimals are handled by SDK config.");
+export const EvmChainSchema = z.enum(["mainnet"])
+    .default("mainnet")
+    .describe("EVM chain identifier. Currently only 'mainnet' (Ethereum mainnet, chainId=1) is supported. Extensible to BSC/Polygon/Arbitrum in the future.");
+export const EvmAddressSchema = z.string()
+    .regex(/^0x[0-9a-fA-F]{40}$/, "Invalid EVM address (must be 0x + 40 hex)")
+    .describe("EVM address (0x + 40 hex)");
+export const BridgeAmountSchema = z.string()
+    .describe("Cross-chain amount as a string in the smallest unit (e.g. wei / token minimal unit). Example: 1 ETH = '1000000000000000000'");
+export const BridgeOperationTypeSchema = z.enum([
+    "cross_chain_wow_to_evm",
+    "cross_chain_evm_to_wow",
+    "claim_wow_to_evm",
+    "withdraw",
+    "query_active_evm_account",
+    "query_supported_evm_chains",
+    "query_supported_tokens",
+    "query_transfer_list",
+    "query_transfer_status",
+    "manage_evm_rpc",
+]).describe("Bridge operation type");
+export const BridgeWowToEvmDataSchema = z.object({
+    token: BridgeTokenSchema.describe("Cross-chain token type"),
+    amount: BridgeAmountSchema.describe("Cross-chain amount (WOW-side smallest unit, wowDecimals)"),
+    withdrawTo: EvmAddressSchema.optional()
+        .describe("Final withdrawal EVM address; if omitted, assets remain in activeEvmAccount. When provided, the SDK uses the activeEvmAccount key to transfer to this address."),
+}).strict().describe("WOW→EVM cross-chain (step 1: deposit only). " +
+    "Returns immediately with depositTxDigest + bridgeSeq + transferId. " +
+    "This operation only locks assets on WOW; it does NOT complete the cross-chain. " +
+    "After deposit, bridge nodes need ~1-5 minutes to sign. " +
+    "Use query_transfer_status to monitor progress; when latestState.step shows 'signatures_ready', " +
+    "call claim_wow_to_evm (step 2) to claim assets on EVM. " +
+    "[Gas requirements] Step 1 needs WOW gas; Step 2 (claim_wow_to_evm) needs activeEvmAccount to have target-chain gas.");
+export const BridgeEvmToWowDataSchema = z.object({
+    token: BridgeTokenSchema.describe("Cross-chain token type (ETH=native ETH, others are ERC20)"),
+    amount: BridgeAmountSchema.describe("Cross-chain amount (EVM-side smallest unit, evmDecimals)"),
+    recipientWowAddress: WowAddressSchema.optional()
+        .describe("WOW recipient address or account name; defaults to env.account if omitted"),
+}).strict().describe("EVM→WOW cross-chain (single step: deposit). " +
+    "Returns immediately with depositTxHash + transferId. " +
+    "Bridge will automatically claim on WOW (no WOW gas needed, no user action required). " +
+    "[Time estimate] ~10-20 minutes total: " +
+    "(1) 64-block confirmation ~12.8 min on ETH; " +
+    "(2) bridge node auto-claim ~1-5 min on WOW. " +
+    "[Status flow] Use query_transfer_status(refresh=true) to monitor: " +
+    "latestState.step: source_tx_pending → source_tx_confirmed → signatures_ready → completed. " +
+    "When latestState.confirmations >= 64, deposit is finalized and bridge nodes will sign. " +
+    "[Gas requirements] Only needs activeEvmAccount to have target-chain gas (for deposit). No WOW gas needed.");
+export const BridgeClaimWowToEvmDataSchema = z.object({
+    transferId: z.string().describe("Transfer ID from cross_chain_wow_to_evm (br_<timestamp>_<counter>)"),
+}).strict().describe("WOW→EVM claim (step 2): claim assets on EVM after bridge nodes have signed. " +
+    "Prerequisite: cross_chain_wow_to_evm (step 1) must be completed, and query_transfer_status " +
+    "must show latestState.step = 'signatures_ready' or 'source_tx_confirmed' (nodes have approved). " +
+    "Returns claimTxHash on success. " +
+    "After claim_wow_to_evm returns, the claim tx has been submitted and confirmed (1 block) on EVM. " +
+    "Use query_transfer_status(refresh=true) to verify latestState.step = 'completed'. " +
+    "[Gas requirements] Requires activeEvmAccount to have target-chain gas (for the claim transaction).");
+export const BridgeWithdrawDataSchema = z.object({
+    to: EvmAddressSchema.describe("Withdrawal target EVM address"),
+    amount: BridgeAmountSchema.describe("Withdrawal amount (smallest unit)"),
+    token: BridgeTokenSchema.optional()
+        .describe("ERC20 token identifier; if omitted or ETH, withdraws native ETH"),
+    tokenAddress: EvmAddressSchema.optional()
+        .describe("ERC20 contract address (alternative to token; allows withdrawing by contract address)"),
+    network: EvmChainSchema.optional()
+        .describe("Target chain (defaults to Ethereum mainnet)"),
+}).strict().describe("Withdraw from activeEvmAccount to another EVM address");
+export const BridgeQueryActiveEvmAccountDataSchema = z.object({
+    network: EvmChainSchema.optional()
+        .describe("Specific chain; if omitted, queries all supported chains"),
+    tokens: z.array(EvmAddressSchema).optional()
+        .describe("Additional ERC20 token contract addresses to query; if omitted, only native ETH balance is queried"),
+}).strict().describe("Query activeEvmAccount parameters");
+export const BridgeQuerySupportedTokensDataSchema = z.object({
+    network: EvmChainSchema.optional()
+        .describe("Specific chain; if omitted, returns token lists for all supported chains"),
+}).strict().describe("Query supported Bridge tokens per chain (WOW/EVM addresses, decimals, description)");
+export const BridgeQueryTransferListDataSchema = z.object({
+    onlyActive: z.boolean().optional()
+        .describe("true returns only in-progress transfers; false/omitted returns all"),
+    status: z.enum(["pending", "in_progress", "success", "failed"]).optional()
+        .describe("Filter by transfer status"),
+    direction: z.enum(["wow_to_evm", "evm_to_wow", "withdraw"]).optional()
+        .describe("Filter by transfer direction"),
+    token: BridgeTokenSchema.optional()
+        .describe("Filter by token type (ETH/WETH/WBTC/USDC/USDT)"),
+    limit: z.number().int().positive().max(100).optional()
+        .describe("Maximum number of results (default: all, max: 100)"),
+}).strict().describe("Query transfer list with optional filters (status / direction / token / limit)");
+export const BridgeQueryTransferStatusDataSchema = z.object({
+    transferId: z.string().describe("Transfer ID (br_<timestamp>_<counter>)"),
+    refresh: z.boolean().optional().default(true)
+        .describe("Whether to refresh from on-chain state (default true). " +
+        "true=queries latest on-chain status (takes 5-15s, timeout at 15s on slow RPC). " +
+        "false=instant response from local cache (no on-chain query). " +
+        "Recommended: use refresh=true every 1-2 minutes for ongoing transfers; " +
+        "use refresh=false for quick checks between refreshes."),
+}).strict().describe("Query single transfer parameters. " +
+    "[Wait hint] With refresh=true (default), this call may take 5-15 seconds to query on-chain state. " +
+    "If on-chain RPC is slow, it will timeout at 15s and return cached state. " +
+    "Set refresh=false for instant response from local cache. " +
+    "[Returned fields] The result includes: " +
+    "(1) record.step/status - high-level lifecycle (deposit/claimed/success); " +
+    "(2) record.latestState.step/status - fine-grained on-chain progress " +
+    "(source_tx_pending → source_tx_confirmed → signatures_ready → completed). " +
+    "Use latestState.confirmations to estimate remaining time (needs 64 for ETH→WOW finalization).");
+export const BridgeManageEvmRpcDataSchema = z.discriminatedUnion("op", [
+    z.object({
+        op: z.literal("list").describe("List all configured RPC endpoints with health status"),
+        network: EvmChainSchema.optional()
+            .describe("Target chain (defaults to Ethereum mainnet)"),
+    }).describe("List RPC endpoints (no rpcUrl/rpcUrls needed)"),
+    z.object({
+        op: z.literal("add").describe("Append one or more RPC endpoints"),
+        network: EvmChainSchema.optional()
+            .describe("Target chain (defaults to Ethereum mainnet)"),
+        rpcUrls: z.array(z.string().url()).min(1)
+            .describe("RPC URL(s) to add"),
+    }).describe("Add RPC endpoint(s)"),
+    z.object({
+        op: z.literal("remove").describe("Remove one or more RPC endpoints"),
+        network: EvmChainSchema.optional()
+            .describe("Target chain (defaults to Ethereum mainnet)"),
+        rpcUrls: z.array(z.string().url()).min(1)
+            .describe("RPC URL(s) to remove"),
+    }).describe("Remove RPC endpoint(s)"),
+    z.object({
+        op: z.literal("set").describe("Full replace all RPC endpoints"),
+        network: EvmChainSchema.optional()
+            .describe("Target chain (defaults to Ethereum mainnet)"),
+        rpcUrls: z.array(z.string().url()).min(1)
+            .describe("Full RPC list (replaces all existing endpoints)"),
+    }).describe("Full replace RPC endpoints"),
+    z.object({
+        op: z.literal("ping").describe("Health check one or more RPC endpoints"),
+        network: EvmChainSchema.optional()
+            .describe("Target chain (defaults to Ethereum mainnet)"),
+        rpcUrls: z.array(z.string().url()).optional()
+            .describe("Specific RPC URLs to ping; if omitted, pings all configured RPCs"),
+    }).describe("Health check RPC endpoints"),
+]).describe("EVM RPC endpoint management (discriminated by op)");
+export const BridgeOperationsSchema = z.preprocess((input) => {
+    if (typeof input === "object" && input !== null) {
+        const obj = { ...input };
+        if (typeof obj.description === "string" && !obj.operation_type) {
+            try {
+                const parsed = JSON.parse(obj.description);
+                if (parsed && typeof parsed === "object" && parsed.operation_type) {
+                    return parsed;
+                }
+            }
+            catch { }
+        }
+        if (typeof obj.data === "string") {
+            try {
+                obj.data = JSON.parse(obj.data);
+            }
+            catch { }
+        }
+        if (typeof obj.env === "string") {
+            try {
+                obj.env = JSON.parse(obj.env);
+            }
+            catch { }
+        }
+        return obj;
+    }
+    return input;
+}, z.discriminatedUnion("operation_type", [
+    z.object({
+        operation_type: z.literal("cross_chain_wow_to_evm"),
+        data: BridgeWowToEvmDataSchema,
+        env: CallEnvSchema.optional(),
+    }).describe("WOW→EVM cross-chain (simplified): assets auto-claim to activeEvmAccount; if withdrawTo is provided, an additional transfer is made to that address. [Requires WOW mainnet env]"),
+    z.object({
+        operation_type: z.literal("cross_chain_evm_to_wow"),
+        data: BridgeEvmToWowDataSchema,
+        env: CallEnvSchema.optional(),
+    }).describe("EVM→WOW cross-chain (single step): deposit from activeEvmAccount, bridge auto-claims on WOW. No WOW gas needed. [Requires WOW mainnet env]"),
+    z.object({
+        operation_type: z.literal("claim_wow_to_evm"),
+        data: BridgeClaimWowToEvmDataSchema,
+        env: CallEnvSchema.optional(),
+    }).describe("WOW→EVM claim (step 2): claim assets on EVM after bridge signed. Requires activeEvmAccount to have EVM gas. [Requires WOW mainnet env]"),
+    z.object({
+        operation_type: z.literal("withdraw"),
+        data: BridgeWithdrawDataSchema,
+    }).describe("Withdraw from activeEvmAccount to another EVM address (non-cross-chain). [No env needed]"),
+    z.object({
+        operation_type: z.literal("query_active_evm_account"),
+        data: BridgeQueryActiveEvmAccountDataSchema.optional(),
+    }).describe("Query activeEvmAccount address + balances (per chain or all chains). [No env needed]"),
+    z.object({
+        operation_type: z.literal("query_supported_evm_chains"),
+    }).describe("List currently supported EVM chains (enum value / description / chainId / RPC health). [No env needed, no data required]"),
+    z.object({
+        operation_type: z.literal("query_supported_tokens"),
+        data: BridgeQuerySupportedTokensDataSchema.optional(),
+    }).describe("List supported Bridge tokens per chain (WOW/EVM contract addresses, decimals, description). [No env needed]"),
+    z.object({
+        operation_type: z.literal("query_transfer_list"),
+        data: BridgeQueryTransferListDataSchema.optional(),
+    }).describe("Query cross-chain / withdrawal transfer history list (optionally only in-progress). [No env needed]"),
+    z.object({
+        operation_type: z.literal("query_transfer_status"),
+        data: BridgeQueryTransferStatusDataSchema,
+    }).describe("Query a single transfer's detail by transferId"),
+    z.object({
+        operation_type: z.literal("manage_evm_rpc"),
+        data: BridgeManageEvmRpcDataSchema,
+    }).describe("Manage EVM RPC endpoints (list/add/remove/set/ping) to mitigate public RPC 429 rate limits. [No env needed]"),
+]));
+export const BridgeLatestStateSchema = z.object({
+    status: z.enum([
+        "not_started", "pending", "confirmed", "signatures_ready",
+        "claiming", "completed", "failed",
+    ]).describe("On-chain status (finer-grained than record.status): " +
+        "pending=source tx submitted but not confirmed; " +
+        "confirmed=source tx confirmed, waiting for bridge node signatures; " +
+        "signatures_ready=nodes signed, ready to claim; " +
+        "claiming=claim tx submitted, waiting for confirmation; " +
+        "completed=fully completed, assets arrived on target chain; " +
+        "failed=on-chain failure"),
+    step: z.enum([
+        "not_started", "source_tx_pending", "source_tx_confirmed",
+        "node_signing", "signatures_ready", "claim_tx_pending",
+        "completed", "failed",
+    ]).describe("Detailed step (more granular than status). " +
+        "source_tx_pending=source chain tx waiting for block confirmation; " +
+        "source_tx_confirmed=source confirmed, waiting for bridge nodes to approve; " +
+        "node_signing=nodes collecting signatures; " +
+        "signatures_ready=sufficient signatures collected, ready to claim on target chain; " +
+        "claim_tx_pending=claim tx submitted on target chain, waiting for confirmation; " +
+        "completed=assets arrived on target chain; " +
+        "failed=error occurred"),
+    stepDescription: z.string().optional().describe("Human-readable step description (Chinese)"),
+    direction: z.enum(["wow_to_evm", "evm_to_wow"]).optional(),
+    sourceTxHash: z.string().optional().describe("Source chain tx hash/digest"),
+    bridgeSeq: z.string().optional().describe("Bridge sequence number"),
+    confirmations: z.number().optional().describe("Source chain confirmation count (EVM→WOW only; needs 64 for finalization)"),
+    claimTxDigest: z.string().optional().describe("WOW claim tx digest (evm_to_wow, when completed)"),
+    claimReceipt: z.any().optional().describe("EVM claim tx receipt (wow_to_evm, when available)"),
+    ethReceipt: z.any().optional().describe("EVM source tx receipt (evm_to_wow)"),
+    wowReceipt: z.any().optional().describe("WOW source tx receipt (wow_to_evm)"),
+    error: z.string().optional().describe("Error message if step=failed"),
+    hint: z.string().optional().describe("Hint message for next action (e.g., when claim_wow_to_evm not yet called)"),
+    updatedAt: z.number().optional().describe("Last on-chain update timestamp (ms)"),
+}).describe("Latest on-chain state (from refresh=true query)");
+export const BridgeTransferRecordSchema = z.object({
+    transferId: z.string().describe("Unique ID (br_<timestamp>_<counter>)"),
+    direction: z.enum(["wow_to_evm", "evm_to_wow", "withdraw"]).describe("Transfer direction"),
+    token: BridgeTokenSchema.describe("Token identifier"),
+    amount: z.string().describe("Amount in smallest unit (string to avoid bigint issues)"),
+    recipientEth: z.string().optional().describe("ETH-side recipient address"),
+    recipientWow: z.string().optional().describe("WOW-side recipient address"),
+    intermediateEthAccount: z.string().describe("Intermediate EVM account (activeEvmAccount)"),
+    step: z.enum(["init", "deposit", "claimed", "withdraw", "withdrawn"]).describe("Current step in the transfer lifecycle: " +
+        "init=just created; " +
+        "deposit=source chain deposit in progress; " +
+        "claimed=claim completed on target chain (success); " +
+        "withdraw=intermediate→final withdraw in progress; " +
+        "withdrawn=withdraw completed"),
+    status: z.enum(["pending", "in_progress", "success", "failed"]).describe("Transfer status: pending/in_progress=ongoing; success=fully completed; failed=error"),
+    depositTxHash: z.string().optional().describe("EVM deposit tx hash (evm_to_wow)"),
+    depositTxDigest: z.string().optional().describe("WOW deposit tx digest (wow_to_evm)"),
+    bridgeSeq: z.string().optional().describe("Bridge sequence number"),
+    claimTxHash: z.string().optional().describe("EVM claim tx hash (wow_to_evm)"),
+    claimTxDigest: z.string().optional().describe("WOW claim tx digest (evm_to_wow)"),
+    withdrawTxHash: z.string().optional().describe("EVM withdraw tx hash (withdraw step)"),
+    error: z.string().optional().describe("Error message if status=failed"),
+    createdAt: z.number().describe("Creation timestamp (ms)"),
+    updatedAt: z.number().describe("Last update timestamp (ms)"),
+    latestState: BridgeLatestStateSchema.optional().describe("Latest on-chain state (only present after refresh=true query). " +
+        "Provides real-time progress: confirmations count, node signing status, claim tx hash, etc. " +
+        "Use this to estimate remaining time and next action."),
+}).strict().describe("Bridge transfer record");
+export const BridgeWowToEvmResultSchema = z.object({
+    depositTxDigest: z.string().describe("WOW deposit tx digest"),
+    bridgeSeq: z.string().describe("Bridge sequence number"),
+    activeEvmAccount: z.string().describe("activeEvmAccount address that will receive the assets"),
+    transferId: z.string().describe("Transfer ID (br_<timestamp>_<counter>). Save this for claim_wow_to_evm (step 2) and query_transfer_status"),
+}).strict().describe("WOW→EVM cross-chain step 1 result (deposit only, claim pending)");
+export const BridgeEvmToWowResultSchema = z.object({
+    depositTxHash: z.string().describe("EVM deposit tx hash"),
+    activeEvmAccount: z.string().describe("activeEvmAccount address that initiated the deposit"),
+    transferId: z.string().describe("Transfer ID (br_<timestamp>_<counter>). Save this for query_transfer_status"),
+}).strict().describe("EVM→WOW cross-chain result (deposit submitted, auto-claim in progress)");
+export const BridgeClaimWowToEvmResultSchema = z.object({
+    claimTxHash: z.string().describe("EVM claim tx hash"),
+    transferId: z.string().describe("Transfer ID"),
+}).strict().describe("WOW→EVM claim (step 2) result");
+export const BridgeWithdrawResultSchema = z.object({
+    txHash: z.string().describe("EVM withdraw tx hash"),
+    transferId: z.string().describe("Transfer ID (br_<timestamp>_<counter>)"),
+}).strict().describe("Withdraw from activeEvmAccount result");
+export const BridgeQueryActiveEvmAccountResultSchema = z.object({
+    address: z.string().describe("activeEvmAccount address (0x + 40 hex)"),
+    chains: z.array(z.object({
+        chainId: z.number().describe("EVM chain ID"),
+        name: z.string().describe("Chain name"),
+        nativeBalance: z.string().describe("Native ETH balance (wei, string)"),
+        tokens: z.array(z.object({
+            tokenAddress: z.string().describe("ERC20 token contract address"),
+            balance: z.string().describe("Token balance (smallest unit, string)"),
+        })).optional().describe("Additional ERC20 token balances (if requested)"),
+    })).describe("Per-chain balance information"),
+}).strict().describe("activeEvmAccount query result");
+export const BridgeQuerySupportedEvmChainsResultSchema = z.array(z.object({
+    chainId: z.number().describe("EVM chain ID"),
+    name: z.string().describe("Chain name (enum value)"),
+    description: z.string().describe("Human-readable chain description"),
+    bridgeChainId: z.number().describe("Bridge protocol chain ID"),
+    explorerUrl: z.string().describe("Block explorer URL"),
+    rpcCount: z.number().describe("Total configured RPC endpoints"),
+    healthyRpcCount: z.number().describe("Currently healthy RPC endpoints"),
+})).describe("List of supported EVM chains");
+export const BridgeQuerySupportedTokensResultSchema = z.array(z.object({
+    chainId: z.number().describe("EVM chain ID"),
+    chainName: z.string().describe("Chain name"),
+    bridgeChainId: z.number().describe("Bridge protocol chain ID"),
+    tokens: z.array(z.object({
+        tokenId: z.number().describe("On-chain token ID"),
+        symbol: z.string().describe("Token symbol (ETH/WETH/WBTC/USDC/USDT)"),
+        evmAddress: z.string().describe("EVM-side contract address (0x000...000 for native ETH)"),
+        evmDecimals: z.number().describe("EVM-side decimals"),
+        wowTypeTag: z.string().describe("WOW-side type tag"),
+        wowDecimals: z.number().describe("WOW-side decimals"),
+        description: z.string().describe("Token description"),
+    })).describe("Tokens available on this chain"),
+})).describe("Supported Bridge tokens per chain");
+export const BridgeQueryTransferListResultSchema = z.array(BridgeTransferRecordSchema)
+    .describe("Transfer history list");
+export const BridgeQueryTransferStatusResultSchema = BridgeTransferRecordSchema.nullable()
+    .describe("Single transfer detail (null if not found)");
+export const BridgeManageEvmRpcResultSchema = z.object({
+    op: z.string().describe("Operation performed (list/add/remove/set/ping)"),
+    success: z.boolean().describe("Whether the operation succeeded"),
+    result: z.any().optional().describe("Operation-specific result (list=array of RPC status, ping=health results, add/remove/set=void)"),
+}).strict().describe("EVM RPC management result");
+export const BridgeOutputSchema = z.discriminatedUnion("operation_type", [
+    z.object({
+        operation_type: z.literal("cross_chain_wow_to_evm"),
+        result: BridgeWowToEvmResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("WOW→EVM cross-chain result"),
+    z.object({
+        operation_type: z.literal("cross_chain_evm_to_wow"),
+        result: BridgeEvmToWowResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("EVM→WOW cross-chain result"),
+    z.object({
+        operation_type: z.literal("claim_wow_to_evm"),
+        result: BridgeClaimWowToEvmResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("WOW→EVM claim (step 2) result"),
+    z.object({
+        operation_type: z.literal("withdraw"),
+        result: BridgeWithdrawResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("Withdraw from activeEvmAccount result"),
+    z.object({
+        operation_type: z.literal("query_active_evm_account"),
+        result: BridgeQueryActiveEvmAccountResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("activeEvmAccount query result"),
+    z.object({
+        operation_type: z.literal("query_supported_evm_chains"),
+        result: BridgeQuerySupportedEvmChainsResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("Supported EVM chains result"),
+    z.object({
+        operation_type: z.literal("query_supported_tokens"),
+        result: BridgeQuerySupportedTokensResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("Supported Bridge tokens per chain result"),
+    z.object({
+        operation_type: z.literal("query_transfer_list"),
+        result: BridgeQueryTransferListResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("Transfer history list result"),
+    z.object({
+        operation_type: z.literal("query_transfer_status"),
+        result: BridgeQueryTransferStatusResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("Single transfer detail result"),
+    z.object({
+        operation_type: z.literal("manage_evm_rpc"),
+        result: BridgeManageEvmRpcResultSchema,
+        message: z.string().optional().describe("Result summary or hint message"),
+    }).describe("EVM RPC management result"),
+]).describe("Bridge operation result (discriminated by operation_type with per-operation typed result)");
+export const BridgeCallOutputSchema = z.object({
+    message: z.string().optional().describe("Result summary or hint message"),
+    result: z.discriminatedUnion("type", [
+        z.object({
+            type: z.literal("data"),
+            data: z.any().describe("Operation result data (structure varies by operation_type)"),
+        }).describe("Successful result"),
+        z.object({
+            type: z.literal("error"),
+            error: z.string().describe("Error message"),
+        }).describe("Error result"),
+    ]).describe("Bridge operation result (data or error)"),
+}).describe("Bridge operation output (matches CallOutput structure returned by the handler)");

package/dist/schema/call/handler.js

@@ -1,7 +1,21 @@
 import { ResponseData, LocalMark, enrichMoveError } from "@wowok/wowok";
+function convertBigInts(obj) {
+    if (typeof obj === "bigint")
+        return obj.toString();
+    if (Array.isArray(obj))
+        return obj.map(convertBigInts);
+    if (obj && typeof obj === "object") {
+        const out = {};
+        for (const k of Object.keys(obj))
+            out[k] = convertBigInts(obj[k]);
+        return out;
+    }
+    return obj;
+}
 export function handleCallResult(result) {
-    if (result && "error" in result) {
-        const enrichedError = enrichMoveError(result.error);
+    const safeResult = convertBigInts(result);
+    if (safeResult && "error" in safeResult) {
+        const enrichedError = enrichMoveError(safeResult.error);
         const output = {
             message: `Error: ${enrichedError}`,
             result: { type: "error", error: enrichedError },
@@ -11,10 +25,10 @@ export function handleCallResult(result) {
             structuredContent: output,
         };
     }
-    if (result && "digest" in result) {
-        const r = ResponseData(result);
-        const txStatus = result?.effects?.status?.status;
-        const txError = result?.effects?.status?.error;
+    if (safeResult && "digest" in safeResult) {
+        const r = ResponseData(safeResult);
+        const txStatus = safeResult?.effects?.status?.status;
+        const txError = safeResult?.effects?.status?.error;
         const isSuccess = txStatus === "success";
         if (!isSuccess) {
             const enrichedError = enrichMoveError(txError || txStatus || "unknown error");
@@ -32,7 +46,7 @@ export function handleCallResult(result) {
         }
         const output = {
             message: "Transaction completed successfully",
-            result: { type: "transaction", ...result },
+            result: { type: "transaction", ...safeResult },
         };
         return {
             content: [
@@ -42,33 +56,33 @@ export function handleCallResult(result) {
             structuredContent: output,
         };
     }
-    if (result && "guard" in result && "submission" in result) {
+    if (safeResult && "guard" in safeResult && "submission" in safeResult) {
         const output = {
             message: "Submission required for Guard verification",
-            result: { type: "submission", ...result },
+            result: { type: "submission", ...safeResult },
         };
         return {
             content: [
                 { type: "text", text: output.message },
-                { type: "text", text: JSON.stringify(result) },
+                { type: "text", text: JSON.stringify(safeResult) },
             ],
             structuredContent: output,
         };
     }
-    if (Array.isArray(result)) {
+    if (Array.isArray(safeResult)) {
         const output = {
             message: "Operation completed",
-            result: { type: "data", data: result },
+            result: { type: "data", data: safeResult },
         };
         return {
             content: [
                 { type: "text", text: output.message },
-                { type: "text", text: JSON.stringify(result) },
+                { type: "text", text: JSON.stringify(safeResult) },
             ],
             structuredContent: output,
         };
     }
-    if (result === undefined || result === null) {
+    if (safeResult === undefined || safeResult === null) {
         const output = {
             message: "Operation completed",
             result: { type: "null" },
@@ -80,7 +94,7 @@ export function handleCallResult(result) {
     }
     const output = {
         message: "Operation completed",
-        result: { type: "transaction", ...result },
+        result: { type: "transaction", ...safeResult },
     };
     return {
         content: [{ type: "text", text: output.message }],

package/dist/schema/call/index.d.ts

@@ -16,3 +16,4 @@ export * from './repository.js';
 export * from './reward.js';
 export * from './service.js';
 export * from './treasury.js';
+export * from './bridge.js';

package/dist/schema/call/index.js

@@ -16,3 +16,4 @@ export * from './repository.js';
 export * from './reward.js';
 export * from './service.js';
 export * from './treasury.js';
+export * from './bridge.js';

package/dist/schema/index.d.ts

@@ -3,5 +3,6 @@ export * from './query/index.js';
 export * from './local/index.js';
 export * from './messenger/index.js';
 export * from './common/index.js';
+export * from './operations.js';
 export * from './utils/guard-parser.js';
 export * from './utils/node-parser.js';

package/dist/schema/index.js

@@ -3,5 +3,6 @@ export * from './query/index.js';
 export * from './local/index.js';
 export * from './messenger/index.js';
 export * from './common/index.js';
+export * from './operations.js';
 export * from './utils/guard-parser.js';
 export * from './utils/node-parser.js';