@trustwallet/cli 0.18.0 → 0.19.0

package/dist/index.js

@@ -3237,10 +3237,10 @@ function getChainDomainId(chainKey) {
   if (!entry) throw new Error(`Unsupported chain: ${chainKey}`);
   return entry[1].id;
 }
-function getExplorerTxUrl(chainKey, txHash) {
+function getExplorerTxUrl(chainKey, hash) {
   const chain2 = getChainById(chainKey);
   if (!chain2) return "";
-  return `${chain2.explorerUrl}/tx/${txHash}`;
+  return `${chain2.explorerUrl}/tx/${hash}`;
 }
 function getSampleAccount(chainKey) {
   return getChainById(chainKey)?.sampleAccount || "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
@@ -3344,6 +3344,9 @@ function classifyApiError(err) {
     return { code: "NETWORK_ERROR", message: err.message };
   }
   if (err instanceof TwakNetworkError) {
+    if (EXECUTION_REVERTED_RE.test(err.message)) {
+      return { code: "TX_FAILED", message: err.message };
+    }
     return { code: "NETWORK_ERROR", message: err.message };
   }
   if (err instanceof TwakValidationError) {
@@ -3355,6 +3358,9 @@ function classifyApiError(err) {
     }
     return { code: "NETWORK_ERROR", message: err.message };
   }
+  if (err instanceof Error && EXECUTION_REVERTED_RE.test(err.message)) {
+    return { code: "TX_FAILED", message: err.message };
+  }
   return null;
 }
 function classifyStorageError(err) {
@@ -3729,7 +3735,7 @@ async function fetchBalance(httpClient, assetId, address, currency = "USD") {
     throw new BalanceError("NETWORK_ERROR", "Could not fetch balance. Please try again later.");
   }
 }
-var import_crypto, NATIVE_TOKEN_ADDRESS, SOLANA_NATIVE_ADDRESS, CHAINS, TESTNET_CHAINS, COMMON_TOKENS, NATIVE_SYMBOLS, CELO_NATIVE_ADDRESS, TwakError, TwakApiError, TwakNetworkError, TwakValidationError, CommandError, COMMON_ERROR_CODES, FS_ERRNO_CODES, SWAP_ERROR_CODES, SwapError, TRANSFER_ERROR_CODES, TransferError, WALLET_ERROR_CODES, WalletError, QUERY_ERROR_CODES, QueryError, BALANCE_ERROR_CODES, BalanceError, ALERT_ERROR_CODES, AlertError, ERC20_ERROR_CODES, Erc20Error, WATCH_ERROR_CODES, WatchError, AUTOMATION_ERROR_CODES, AutomationError, X402_ERROR_CODES, X402Error, RESOLVABLE_CHAINS, ALIASES, DECIMAL_AMOUNT_RE, UNSAFE_KEYS, NAMING_API, EVM_ADDRESS_RE, ERC20_TRANSFER_SIG, ZERO_ADDRESS, DEFAULT_GATEWAY_URL, DEFAULT_MARKET_URL, DEFAULT_TIMEOUT, DEFAULT_USER_AGENT, DEFAULT_X_ORIGIN, TwakHttpClient, ALLOWED_OFFRAMP_PROVIDERS, McpResponse;
+var import_crypto, NATIVE_TOKEN_ADDRESS, SOLANA_NATIVE_ADDRESS, CHAINS, TESTNET_CHAINS, COMMON_TOKENS, NATIVE_SYMBOLS, CELO_NATIVE_ADDRESS, TwakError, TwakApiError, TwakNetworkError, TwakValidationError, CommandError, COMMON_ERROR_CODES, EXECUTION_REVERTED_RE, FS_ERRNO_CODES, SWAP_ERROR_CODES, SwapError, TRANSFER_ERROR_CODES, TransferError, WALLET_ERROR_CODES, WalletError, QUERY_ERROR_CODES, QueryError, BALANCE_ERROR_CODES, BalanceError, ALERT_ERROR_CODES, AlertError, ERC20_ERROR_CODES, Erc20Error, WATCH_ERROR_CODES, WatchError, AUTOMATION_ERROR_CODES, AutomationError, X402_ERROR_CODES, X402Error, RESOLVABLE_CHAINS, ALIASES, DECIMAL_AMOUNT_RE, UNSAFE_KEYS, NAMING_API, EVM_ADDRESS_RE, ERC20_TRANSFER_SIG, ZERO_ADDRESS, DEFAULT_GATEWAY_URL, DEFAULT_MARKET_URL, DEFAULT_TIMEOUT, DEFAULT_USER_AGENT, DEFAULT_X_ORIGIN, TwakHttpClient, ALLOWED_OFFRAMP_PROVIDERS, McpResponse;
 var init_dist = __esm({
   "../core/dist/index.mjs"() {
     "use strict";
@@ -4230,6 +4236,7 @@ var init_dist = __esm({
       WALLET_AUTH_FAILED: "WALLET_AUTH_FAILED",
       STORAGE_ERROR: "STORAGE_ERROR"
     };
+    EXECUTION_REVERTED_RE = /\bexecution reverted\b/i;
     FS_ERRNO_CODES = /* @__PURE__ */ new Set([
       "EACCES",
       "EEXIST",
@@ -6772,13 +6779,47 @@ function patchNodeStubs() {
     if (resolvedUrl.includes("gateway.us.trustwallet.com")) {
       resolvedUrl = resolvedUrl.replace("gateway.us.trustwallet.com", "tws.trustwallet.com");
     }
+    let finalInput = input2;
     if (resolvedUrl !== url) {
-      const finalInput = typeof input2 === "string" ? resolvedUrl : input2 instanceof URL ? new URL(resolvedUrl) : new Request(resolvedUrl, input2);
-      return originalFetch(finalInput, init3);
+      finalInput = typeof input2 === "string" ? resolvedUrl : input2 instanceof URL ? new URL(resolvedUrl) : new Request(resolvedUrl, input2);
     }
-    return originalFetch(input2, init3);
+    const bodyText = typeof init3?.body === "string" ? init3.body : init3?.body instanceof Uint8Array ? new TextDecoder().decode(init3.body) : void 0;
+    if (bodyText && /"method":"eth_(call|estimateGas|sendRawTransaction)"/.test(bodyText)) {
+      return originalFetch(finalInput, init3).then(appendRpcRevertData);
+    }
+    return originalFetch(finalInput, init3);
   };
 }
+function revertDataSuffix(message, data) {
+  return typeof data === "string" && /^0x[0-9a-fA-F]+$/.test(data) && !message.includes(data) ? `: ${data}` : "";
+}
+async function appendRpcRevertData(response) {
+  const text = await response.text();
+  let body = text;
+  if (text.includes('"error"') && text.includes('"data":"0x')) {
+    try {
+      const json = JSON.parse(text);
+      const error2 = json.error;
+      if (error2 && typeof error2.message === "string") {
+        const suffix = revertDataSuffix(error2.message, error2.data);
+        if (suffix) {
+          error2.message = `${error2.message}${suffix}`;
+          body = JSON.stringify(json);
+        }
+      }
+    } catch {
+    }
+  }
+  const headers = new Headers(response.headers);
+  if (body !== text) {
+    headers.delete("content-length");
+  }
+  return new Response(body === "" ? null : body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
 function patchNaasSession(sessionId) {
   if (naasSessionPatched) return;
   naasSessionPatched = true;
@@ -7008,11 +7049,11 @@ function humanAmountToWei(amount, decimals = 18) {
   const frac = parts[1].padEnd(decimals, "0").slice(0, decimals);
   return whole * 10n ** BigInt(decimals) + BigInt(frac);
 }
-function createPendingTransaction(client, chainKey, txHash) {
+function createPendingTransaction(client, chainKey, hash) {
   return {
-    txHash,
+    hash,
     chainKey,
-    wait: (opts) => client.waitForReceipt(chainKey, txHash, opts)
+    wait: (opts) => client.waitForReceipt(chainKey, hash, opts)
   };
 }
 function bscSponsoredBaseUrl() {
@@ -7433,7 +7474,7 @@ var init_dist3 = __esm({
        * `receiptTimeoutMs` config when set, otherwise the global constants
        * (1.5s poll, 60s timeout). Caller-supplied opts override both.
        */
-      async waitForReceipt(chainKey, txHash, opts) {
+      async waitForReceipt(chainKey, hash, opts) {
         const { chain: chain2, chainConfig } = chainKeyToDefinedChain(chainKey);
         if (chainConfig?.namespace && chainConfig.namespace !== "eip155") {
           throw new TwakValidationError(
@@ -7459,15 +7500,15 @@ var init_dist3 = __esm({
         const deadline = Date.now() + timeoutMs;
         while (Date.now() < deadline) {
           const remainingMs = Math.max(1, deadline - Date.now());
-          const result = await this.postJsonRpc(rpcUrl, "eth_getTransactionReceipt", [txHash], {
+          const result = await this.postJsonRpc(rpcUrl, "eth_getTransactionReceipt", [hash], {
             timeoutMs: Math.min(RPC_TIMEOUT_MS, remainingMs)
           });
           const receipt = result ?? null;
           if (receipt) return receipt;
           await new Promise((resolve2) => setTimeout(resolve2, pollMs));
         }
-        throw new TwakNetworkError(`Timed out waiting for receipt ${txHash} on ${chainKey}`, {
-          txHash,
+        throw new TwakNetworkError(`Timed out waiting for receipt ${hash} on ${chainKey}`, {
+          hash,
           chainKey
         });
       }
@@ -7558,13 +7599,13 @@ var init_dist3 = __esm({
           currency: chainKey
         };
       }
-      async findTransactionStatus(chainKey, address, txHash) {
+      async findTransactionStatus(chainKey, address, hash) {
         const coinId = chainKeyToCoinType(chainKey);
         if (coinId === void 0) throw new Error(`Unsupported chain: ${chainKey}`);
         const account = this.createAccountForAddress(coinId, address);
         let result;
         try {
-          result = await import_trust_sdk2.BlockchainService.findTransaction(account, txHash);
+          result = await import_trust_sdk2.BlockchainService.findTransaction(account, hash);
         } catch {
           return { confirmed: false, pending: false, failed: false, error: "Transaction not found" };
         }
@@ -7986,7 +8027,9 @@ var init_dist3 = __esm({
           );
         }
         if (json.error) {
-          throw new TwakNetworkError(`RPC error on ${method}: ${json.error.message}`, {
+          const { message, data } = json.error;
+          const suffix = revertDataSuffix(message, data);
+          throw new TwakNetworkError(`RPC error on ${method}: ${message}${suffix}`, {
             method,
             rpcUrl,
             rpcError: json.error
@@ -8294,7 +8337,7 @@ var init_dist3 = __esm({
             serializedMessage: params.data,
             hdWallet
           });
-          return result2.txHash;
+          return result2.hash;
         }
         if (hasCalldata || hasValue) {
           const result2 = await this.blockchainClient.executeContract({
@@ -8305,7 +8348,7 @@ var init_dist3 = __esm({
             hdWallet,
             chainKey
           });
-          return result2.txHash;
+          return result2.hash;
         }
         const result = await this.blockchainClient.transfer({
           assetId,
@@ -8314,7 +8357,7 @@ var init_dist3 = __esm({
           hdWallet,
           chainKey
         });
-        return result.txHash;
+        return result.hash;
       }
       supportsChain(chainId) {
         return isChainSupported(chainId);
@@ -40603,762 +40646,139 @@ init_dist2();
 var import_chalk6 = __toESM(require_source());
 init_dist();
 
-// src/branding.ts
-var import_chalk5 = __toESM(require_source());
-var boxen = require_boxen();
-var SHIELD = [
-  "                @@=+                ",
-  "           @@@@@@@=======           ",
-  "     @@@@@@@@@@@@@============+     ",
-  "  @@@@@@@@@@@@@@@@================  ",
-  "  @@@@@@@@@@@@@@@@+===============  ",
-  "  @@@@@@@@@@@@@@@@++++============  ",
-  "  @@@@@@@@@@@@@@@@++++++++++=====+  ",
-  "  @@@@@@@@@@@@@@@@**++++++++++++++  ",
-  "  @@@@@@@@@@@@@@@@********++++++++  ",
-  "  @@@@@@@@@@@@@@@@**************++  ",
-  "  @@@@@@@@@@@@@@@@#####***********  ",
-  "   @@@@@@@@@@@@@@@###########****   ",
-  "    @@@@@@@@@@@@@@%##############   ",
-  "    @@@@@@@@@@@@@@%%%%%%%#######    ",
-  "     @@@@@@@@@@@@@%%%%%%%%%%%%%     ",
-  "       @@@@@@@@@@@%%%%%%%%%%%       ",
-  "         @@@@@@@@@@@@@%%%%%         ",
-  "           @@@@@@@@@@@@@@           ",
-  "             @@@@@@@@@@             ",
-  "                 @@                 "
-];
-function printBanner(version3) {
-  const logo = SHIELD.map((l4) => import_chalk5.default.green(l4)).join("\n");
-  const title = import_chalk5.default.green.bold("  Trust Wallet Agent Kit");
-  const ver = import_chalk5.default.dim(`  v${version3}`);
-  console.log(
-    boxen(`${logo}
-
-${title}
-${ver}`, {
-      borderColor: "green",
-      borderStyle: "round",
-      padding: { top: 1, bottom: 1, left: 2, right: 2 }
-    })
-  );
+// ../contracts/dist/index.mjs
+init_dist();
+init_dist();
+init_dist();
+init_dist();
+init_dist3();
+init_dist();
+init_dist();
+init_dist();
+var HEX_PATTERN = /^0x[0-9a-fA-F]*$/;
+function isHex(value) {
+  return HEX_PATTERN.test(value);
 }
-function box(content) {
-  return boxen(content, {
-    borderColor: "green",
-    borderStyle: "round",
-    padding: { top: 0, bottom: 0, left: 1, right: 1 }
-  });
+function hexToBytes3(hex2) {
+  if (!isHex(hex2)) {
+    throw new TwakValidationError(`Invalid hex string: ${hex2}`, { kind: "invalidHex" });
+  }
+  const clean2 = hex2.slice(2);
+  if (clean2.length % 2 !== 0) {
+    throw new TwakValidationError(`Hex string has odd length: ${hex2}`, { kind: "invalidHex" });
+  }
+  const out = new Uint8Array(clean2.length / 2);
+  for (let i2 = 0; i2 < out.length; i2++) {
+    out[i2] = parseInt(clean2.slice(i2 * 2, i2 * 2 + 2), 16);
+  }
+  return out;
 }
-
-// src/commands/wallet.ts
-function getQRString(address) {
-  try {
-    const qrcode = require("qrcode-terminal");
-    let result = "";
-    qrcode.generate(address, { small: true }, (code2) => {
-      result = code2;
-    });
-    return result;
-  } catch {
-    return "";
+function bytesToHex3(bytes) {
+  let out = "0x";
+  for (let i2 = 0; i2 < bytes.length; i2++) {
+    out += bytes[i2].toString(16).padStart(2, "0");
   }
+  return out;
 }
-function registerWalletCommand(program3) {
-  const wallet = program3.command("wallet").description("Manage agent wallet");
-  wallet.command("create").description("Create a new agent wallet").requiredOption("--password <password>", "Password to encrypt the wallet").option("--no-keychain", "Do not save password to OS keychain").option("--skip-password-check", "Skip password strength validation").option("--json", "JSON output").action(async (opts) => {
-    try {
-      if (!opts.skipPasswordCheck) {
-        const weakness = getPasswordWeaknesses(opts.password);
-        if (weakness) {
-          throw new WalletError("VALIDATION_ERROR", `Password too weak: must ${weakness}.`);
-        }
-      }
-      await ensureTrustSDK();
-      const store = new WalletConfigStore();
-      if (await store.exists()) {
-        throw new WalletError(
-          "WALLET_EXISTS",
-          "Wallet already exists. Back up ~/.twak/wallet.json, then delete it to create a new one."
-        );
-      }
-      const provider = await AgentWalletProvider.create(opts.password);
-      const addresses = await provider.getAddresses();
-      if (opts.keychain !== false) {
-        const kc2 = new KeychainManager();
-        if (kc2.isAvailable()) {
-          await kc2.saveWalletPassword(opts.password);
-          if (!opts.json) info("Password saved to OS keychain (use --no-keychain to skip)");
-        }
-      }
-      if (!opts.json) success("Agent wallet created successfully");
-      try {
-        const creds = await getCredentials();
-        await registerWalletWithBackend(creds, provider);
-        if (!opts.json) info("Wallet registered with backend");
-      } catch {
-        if (!opts.json) warn("Backend registration failed (holdings may be limited)");
-      }
-      if (opts.json) {
-        output({ addresses }, true);
-      } else {
-        info(`Generated addresses for ${addresses.length} chains`);
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "Wallet creation failed");
-    }
-    safeExit();
-  });
-  wallet.command("address").description("Get wallet address for a chain").requiredOption("--chain <key>", "Chain key (e.g., ethereum, solana)").option(
-    "--password <password>",
-    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
-  ).option("--json", "JSON output").action(async (opts) => {
-    try {
-      if (!getChainById(opts.chain)) {
-        throw new WalletError("CHAIN_UNSUPPORTED", `Unknown chain: ${opts.chain}`);
-      }
-      await ensureTrustSDK();
-      const password3 = await resolvePassword(opts);
-      const provider = await AgentWalletProvider.fromStorage(password3);
-      const address = await provider.getAddress(opts.chain);
-      if (opts.json) {
-        output({ chain: opts.chain, address }, true);
-      } else {
-        const qr3 = getQRString(address);
-        const content = `${import_chalk6.default.dim("Chain")}    ${import_chalk6.default.bold(opts.chain)}
-${import_chalk6.default.dim("Address")}  ${import_chalk6.default.green(address)}
-
-${qr3}`;
-        console.log(box(content));
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "Wallet address failed");
-    }
-    safeExit();
-  });
-  wallet.command("addresses").description("List all wallet addresses").option(
-    "--password <password>",
-    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
-  ).option("--json", "JSON output").action(async (opts) => {
-    try {
-      await ensureTrustSDK();
-      const password3 = await resolvePassword(opts);
-      const provider = await AgentWalletProvider.fromStorage(password3);
-      const addresses = await provider.getAddresses();
-      if (opts.json) {
-        output({ addresses }, true);
-      } else {
-        const grouped = /* @__PURE__ */ new Map();
-        for (const addr of addresses) {
-          const chains = grouped.get(addr.address) ?? [];
-          chains.push(addr.chainId);
-          grouped.set(addr.address, chains);
-        }
-        for (const [address, chains] of grouped) {
-          const qr3 = getQRString(address);
-          const maxWidth = Math.max(address.length + 9, 50);
-          const chainLabel = `${import_chalk6.default.dim("Chains")}   `;
-          const chainLabelLen = 9;
-          const chainLines = [];
-          let line = "";
-          for (const c3 of chains) {
-            const sep2 = line ? ", " : "";
-            if (line && line.length + sep2.length + c3.length + chainLabelLen > maxWidth) {
-              chainLines.push(line);
-              line = c3;
-            } else {
-              line += sep2 + c3;
-            }
-          }
-          if (line) chainLines.push(line);
-          const chainsStr = chainLines.map((l4, i2) => (i2 === 0 ? chainLabel : " ".repeat(chainLabelLen)) + import_chalk6.default.bold(l4)).join("\n");
-          const content = `${chainsStr}
-${import_chalk6.default.dim("Address")}  ${import_chalk6.default.green(address)}
-
-${qr3}`;
-          console.log(box(content));
-        }
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "Wallet addresses failed");
+function hexOrUtf8ToBytesHex(value) {
+  const looksHex = value.length >= 2 && value[0] === "0" && (value[1] === "x" || value[1] === "X");
+  if (looksHex) {
+    const canonical = "0x" + value.slice(2);
+    if (!isHex(canonical)) {
+      throw new TwakValidationError(
+        `Value starts with "0x" but is not valid hex: ${value}. Use only [0-9a-fA-F] characters, or drop the "0x" prefix to send a UTF-8 string.`,
+        { kind: "invalidHex" }
+      );
     }
-    safeExit();
-  });
-  wallet.command("balance").description("Get wallet balance on a chain (native + token holdings)").option("--chain <key>", "Chain key").option("--all", "Show balances across all chains with funds").option(
-    "--password <password>",
-    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
-  ).option("--no-tokens", "Skip token balance lookup").option("--json", "JSON output").action(async (opts) => {
-    try {
-      if (opts.all && opts.chain) {
-        throw new WalletError("VALIDATION_ERROR", "--all and --chain are mutually exclusive");
-      }
-      if (!opts.all && !opts.chain) {
-        throw new WalletError("VALIDATION_ERROR", "Provide --chain <key> or --all");
-      }
-      await ensureTrustSDK();
-      const password3 = await resolvePassword(opts);
-      const provider = await AgentWalletProvider.fromStorage(password3);
-      const httpClient = await getClient();
-      if (!opts.all) {
-        const chain2 = getChainById(opts.chain);
-        if (!chain2) {
-          throw new WalletError("CHAIN_UNSUPPORTED", `Unknown chain: ${opts.chain}`);
-        }
-      }
-      const allAddresses = await provider.getAddresses();
-      const addressMap = /* @__PURE__ */ new Map();
-      for (const a3 of allAddresses) addressMap.set(a3.chainId, a3.address);
-      const requestedChains = opts.all ? Object.keys(CHAINS) : [opts.chain];
-      const skipTokens = opts.tokens === false;
-      const chainEntries = requestedChains.flatMap((chainKey) => {
-        const chain2 = getChainById(chainKey);
-        const address = addressMap.get(chainKey);
-        if (!chain2 || !address) return [];
-        return [{ chainKey, chain: chain2, address }];
-      });
-      if (!opts.all && chainEntries.length === 0) {
-        throw new WalletError(
-          "CHAIN_UNSUPPORTED",
-          `Wallet does not have an address for chain: ${opts.chain}`
-        );
-      }
-      const nativeAssets = chainEntries.map(({ chainKey, chain: chain2, address }) => ({
-        chainKey,
-        chain: chain2,
-        token: void 0,
-        assetId: `c${chain2.coinId}`,
-        userAddress: address
-      }));
-      const tokenAssets = skipTokens ? [] : chainEntries.flatMap(({ chainKey, chain: chain2, address }) => {
-        const knownTokens = COMMON_TOKENS[chainKey];
-        if (!knownTokens) return [];
-        return Object.keys(knownTokens).flatMap((sym) => {
-          const resolved = resolveToken(sym, chainKey);
-          if (!resolved) return [];
-          return [
-            {
-              chainKey,
-              chain: chain2,
-              token: { ...resolved, symbol: sym },
-              assetId: `c${chain2.coinId}_t${resolved.address}`,
-              userAddress: address
-            }
-          ];
-        });
-      });
-      const allAssets = [...nativeAssets, ...tokenAssets];
-      const balances = await fetchBalances(
-        httpClient,
-        allAssets.map(({ assetId, userAddress }) => ({ assetId, address: userAddress }))
+    if ((canonical.length - 2) % 2 !== 0) {
+      throw new TwakValidationError(
+        `Hex value has odd length: ${value}. Solidity bytes must be byte-aligned.`,
+        { kind: "invalidHex" }
       );
-      const assetsById = new Map(allAssets.map((a3) => [a3.assetId, a3]));
-      const resultsByChain = /* @__PURE__ */ new Map();
-      for (const { chainKey, chain: chain2, address } of chainEntries) {
-        resultsByChain.set(chainKey, {
-          chain: chainKey,
-          address,
-          symbol: chain2.symbol,
-          available: "0",
-          total: "0",
-          totalUsd: null,
-          tokens: []
-        });
-      }
-      for (const balance of balances) {
-        const assetInfo = assetsById.get(balance.assetId);
-        if (!assetInfo) {
-          throw new WalletError(
-            "NETWORK_ERROR",
-            "Could not fetch balances. Please try again later."
-          );
-        }
-        const result = resultsByChain.get(assetInfo.chainKey);
-        if (!result) continue;
-        const { token, chain: chain2 } = assetInfo;
-        const amts = balance.amounts;
-        if (token) {
-          const human = formatAmount(amts.total ?? "0", token.decimals);
-          if (human !== "0") {
-            result.tokens.push({
-              symbol: token.symbol,
-              contract: token.address,
-              balance: human
-            });
-          }
-        } else {
-          result.available = formatAmount(amts.available ?? "0", chain2.decimals);
-          result.total = formatAmount(amts.total ?? "0", chain2.decimals);
-          const lockedHuman = formatAmount(amts.locked ?? "0", chain2.decimals);
-          if (lockedHuman !== "0") result.staked = lockedHuman;
-          const fiat = amts.totalInFiat;
-          result.totalUsd = fiat && fiat !== "" ? parseFloat(fiat) : null;
-        }
-      }
-      const orderedResults = chainEntries.map((e2) => resultsByChain.get(e2.chainKey)).filter((r3) => r3 !== void 0);
-      const visible = opts.all ? orderedResults.filter((r3) => r3.total !== "0" || r3.tokens.length > 0) : orderedResults;
-      const renderBlock = (r3, withSeparator) => {
-        if (withSeparator) console.log("");
-        console.log(import_chalk6.default.bold.underline(`${r3.chain} (${r3.symbol})`));
-        console.log(`  ${import_chalk6.default.dim("Address")}    ${r3.address}`);
-        console.log(`  ${import_chalk6.default.dim("Available")}  ${r3.available}`);
-        if (r3.staked) console.log(`  ${import_chalk6.default.dim("Staked")}     ${r3.staked}`);
-        const usdSuffix = r3.totalUsd !== null ? ` (\u2248 $${r3.totalUsd.toFixed(2)})` : "";
-        console.log(`  ${import_chalk6.default.dim("Total")}      ${r3.total}${usdSuffix}`);
-        if (r3.tokens.length > 0) {
-          console.log(`  ${import_chalk6.default.dim("Tokens:")}`);
-          for (const t of r3.tokens) {
-            console.log(`    ${import_chalk6.default.bold(t.symbol.padEnd(10))} ${t.balance}`);
-          }
-        }
-      };
-      if (opts.all) {
-        if (opts.json) {
-          output(visible, true);
-        } else if (visible.length === 0) {
-          info("No chains with non-zero native balance found.");
-        } else {
-          visible.forEach((r3, i2) => renderBlock(r3, i2 > 0));
-        }
-      } else {
-        const single = visible[0];
-        if (opts.json) {
-          output(single, true);
-        } else {
-          renderBlock(single, false);
-        }
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "Balance check failed");
     }
-    safeExit();
-  });
-  const keychain = wallet.command("keychain").description("Manage wallet password in OS keychain");
-  keychain.command("save").description("Save wallet password to OS keychain").requiredOption("--password <password>", "Wallet password to store").option("--json", "JSON output").action(async (opts) => {
-    try {
-      const kc2 = new KeychainManager();
-      if (!kc2.isAvailable()) {
-        throw new WalletError("KEYCHAIN_UNAVAILABLE", "OS keychain not available on this system");
-      }
-      await kc2.saveWalletPassword(opts.password);
-      success("Wallet password saved to OS keychain");
-    } catch (err) {
-      handleCommandError(err, opts.json, "Keychain save failed");
+    return canonical;
+  }
+  return bytesToHex3(new TextEncoder().encode(value));
+}
+function wc2() {
+  return getWalletCore();
+}
+var BRIDGE = {
+  createAbiFunction(name2) {
+    const ctor = wc2().EthereumAbiFunction;
+    if (typeof ctor?.createWithString === "function") {
+      return ctor.createWithString(name2);
     }
-    safeExit();
+    return new ctor(name2);
+  },
+  encode(fn2) {
+    return wc2().EthereumAbi.encode(fn2);
+  },
+  decodeOutput(fn2, data) {
+    return wc2().EthereumAbi.decodeOutput(fn2, data);
+  },
+  keccak256(data) {
+    return wc2().Hash.keccak256(data);
+  }
+};
+function getAbiBridge() {
+  return BRIDGE;
+}
+function findAbiFunction(abi, methodName, argCount) {
+  const matches = abi.filter(
+    (e2) => e2.type === "function" && e2.name === methodName
+  );
+  if (matches.length === 0) {
+    throw new TwakValidationError(`Unknown ABI method: ${methodName}`, {
+      kind: "unknownMethod",
+      methodName
+    });
+  }
+  if (matches.length === 1 || argCount === void 0) {
+    return matches[0];
+  }
+  const byArity = matches.filter((m2) => m2.inputs.length === argCount);
+  if (byArity.length === 1) {
+    return byArity[0];
+  }
+  throw new TwakValidationError(`No unique ${methodName} overload taking ${argCount} argument(s)`, {
+    kind: "unknownMethod",
+    methodName
   });
-  keychain.command("delete").description("Remove wallet password from OS keychain").option("--json", "JSON output").action(async (opts) => {
-    try {
-      const kc2 = new KeychainManager();
-      if (!kc2.isAvailable()) {
-        throw new WalletError("KEYCHAIN_UNAVAILABLE", "OS keychain not available on this system");
+}
+function encodeFunctionCall(abi, methodName, args) {
+  const fnDef = findAbiFunction(abi, methodName, args.length);
+  if (args.length !== fnDef.inputs.length) {
+    throw new TwakValidationError(
+      `Wrong arg count for ${methodName}: expected ${fnDef.inputs.length}, got ${args.length}`,
+      {
+        kind: "wrongArgCount",
+        methodName,
+        expected: fnDef.inputs.length,
+        actual: args.length
       }
-      await kc2.deleteWalletPassword();
-      success("Wallet password removed from OS keychain");
-    } catch (err) {
-      handleCommandError(err, opts.json, "Keychain delete failed");
-    }
-    safeExit();
+    );
+  }
+  if (encoderRequiresHandRoll(fnDef.inputs)) {
+    return encodeFunctionCallHandRoll(methodName, fnDef.inputs, args);
+  }
+  const bridge = getAbiBridge();
+  const fn2 = bridge.createAbiFunction(methodName);
+  fnDef.inputs.forEach((param, i2) => {
+    pushParam(fn2, param, args[i2], methodName);
   });
-  keychain.command("check").description("Check if wallet password is stored in OS keychain").option("--json", "JSON output").action(async (opts) => {
-    try {
-      const kc2 = new KeychainManager();
-      if (!kc2.isAvailable()) {
-        if (opts.json) {
-          output({ available: false, stored: false }, true);
-        } else {
-          warn("keytar not available on this system");
-        }
-        safeExit();
-        return;
-      }
-      const pw = await kc2.getWalletPassword();
-      if (opts.json) {
-        output({ available: true, stored: !!pw }, true);
-      } else if (pw) {
-        success("Wallet password is stored in OS keychain");
-      } else {
-        info("No wallet password found in OS keychain");
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "Keychain check failed");
-    }
-    safeExit();
-  });
-  wallet.command("connect").description("Connect external wallet via WalletConnect").option("--project-id <id>", "WalletConnect project ID (or set WALLETCONNECT_PROJECT_ID)").option(
-    "--chains <list>",
-    "Comma-separated CAIP-2 chain IDs",
-    "eip155:1,eip155:56,eip155:137,eip155:8453,eip155:42161"
-  ).option("--timeout <seconds>", "Connection timeout in seconds", "300").option("--json", "JSON output").action(async (opts) => {
-    try {
-      const projectId = opts.projectId || process.env.WALLETCONNECT_PROJECT_ID;
-      if (!projectId) {
-        throw new WalletError(
-          "VALIDATION_ERROR",
-          "WalletConnect project ID required. Use --project-id or set WALLETCONNECT_PROJECT_ID"
-        );
-      }
-      const provider = new WalletConnectProvider({ projectId });
-      const chains = opts.chains.split(",").map((s2) => s2.trim()).filter(Boolean);
-      info("Connecting via WalletConnect...");
-      const result = await provider.connect(chains);
-      const qr3 = getQRString(result.uri);
-      if (qr3) {
-        console.log(qr3);
-      }
-      info(`Trust Wallet: ${result.deepLinks.native}`);
-      info(`Universal:    ${result.deepLinks.universal}`);
-      info("\nWaiting for wallet approval...");
-      const timeoutMs = parseInt(opts.timeout, 10) * 1e3;
-      const session = await provider.waitForSession(timeoutMs);
-      if (opts.json) {
-        output(
-          {
-            connected: true,
-            address: session.address,
-            chainId: session.chainId,
-            peer: session.peerName
-          },
-          true
-        );
-      } else {
-        success(`Connected to ${session.peerName || "wallet"}`);
-        info(`  Address: ${session.address}`);
-        info(`  Chain:   ${session.chainId}`);
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "WalletConnect failed");
-    }
-    safeExit();
-  });
-  wallet.command("status").description("Check wallet configuration status").option("--json", "JSON output").action(async (opts) => {
-    try {
-      const store = new WalletConfigStore();
-      const exists = await store.exists();
-      const kc2 = new KeychainManager();
-      const keychainHasPassword = kc2.isAvailable() ? !!await kc2.getWalletPassword() : false;
-      const totalChains = Object.keys(CHAINS).length;
-      let createdAt;
-      let addressCount;
-      if (exists) {
-        const config = await store.getConfig();
-        createdAt = config?.createdAt;
-        addressCount = config?.chains?.length ?? totalChains;
-      }
-      const result = {
-        agentWallet: exists ? "configured" : "not configured",
-        keychainPassword: keychainHasPassword ? "stored" : "not stored",
-        chains: totalChains,
-        supportedChains: totalChains,
-        ...createdAt ? { createdAt } : {},
-        ...addressCount !== void 0 ? { addressCount } : {}
-      };
-      if (opts.json) {
-        output(result, true);
-      } else {
-        console.log(
-          `  ${import_chalk6.default.dim("Wallet")}     ${exists ? import_chalk6.default.green("configured") : import_chalk6.default.yellow("not configured")}`
-        );
-        if (createdAt) console.log(`  ${import_chalk6.default.dim("Created")}    ${createdAt}`);
-        console.log(
-          `  ${import_chalk6.default.dim("Keychain")}   ${keychainHasPassword ? import_chalk6.default.green("password stored") : import_chalk6.default.yellow("no password")}`
-        );
-        console.log(`  ${import_chalk6.default.dim("Chains")}     ${totalChains} supported`);
-        if (addressCount !== void 0)
-          console.log(`  ${import_chalk6.default.dim("Addresses")}  ${addressCount}`);
-        if (!exists) info("\nRun `twak wallet create --password <pw>` to create a wallet.");
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "Status failed");
-    }
-    safeExit();
-  });
-  wallet.command("portfolio").description("Show portfolio balances and USD values across chains, including token holdings").option("--chains <list>", "Comma-separated chain keys (default: all supported chains)").option(
-    "--password <password>",
-    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
-  ).option("--json", "JSON output").action(async (opts) => {
-    try {
-      await ensureTrustSDK();
-      const password3 = await resolvePassword(opts);
-      const provider = await AgentWalletProvider.fromStorage(password3);
-      const httpClient = await getClient();
-      const allAddresses = await provider.getAddresses();
-      const chainsArg = opts.chains ?? Object.keys(CHAINS).join(",");
-      const requestedChains = chainsArg.split(",").map((s2) => s2.trim()).filter(Boolean);
-      if (requestedChains.length === 0) {
-        throw new WalletError("VALIDATION_ERROR", "--chains must include at least one chain key");
-      }
-      const chainEntries = requestedChains.flatMap((chainKey) => {
-        const chain2 = getChainById(chainKey);
-        const addrEntry = allAddresses.find((a3) => a3.chainId === chainKey);
-        if (!chain2 || !addrEntry) return [];
-        return [{ chainKey, chain: chain2, address: addrEntry.address }];
-      });
-      if (chainEntries.length === 0) {
-        throw new WalletError(
-          "CHAIN_UNSUPPORTED",
-          `No supported chains found in --chains "${opts.chains}"`
-        );
-      }
-      const chainAssets = chainEntries.map(({ chainKey, chain: chain2, address }) => ({
-        chainKey,
-        chain: chain2,
-        token: void 0,
-        assetId: `c${chain2.coinId}`,
-        userAddress: address
-      }));
-      const tokenAssets = chainEntries.flatMap(({ chainKey, chain: chain2, address }) => {
-        const knownTokens = COMMON_TOKENS[chainKey];
-        if (!knownTokens) return [];
-        return Object.keys(knownTokens).flatMap((sym) => {
-          const resolved = resolveToken(sym, chainKey);
-          if (!resolved) return [];
-          return [
-            {
-              chainKey,
-              chain: chain2,
-              token: { ...resolved, symbol: sym },
-              assetId: `c${chain2.coinId}_t${resolved.address}`,
-              userAddress: address
-            }
-          ];
-        });
-      });
-      const allAssets = [...chainAssets, ...tokenAssets];
-      const balances = await fetchBalances(
-        httpClient,
-        allAssets.map(({ assetId, userAddress }) => ({ assetId, address: userAddress }))
-      );
-      const assetsById = new Map(allAssets.map((a3) => [a3.assetId, a3]));
-      const allRows = [];
-      for (const balance of balances) {
-        const assetInfo = assetsById.get(balance.assetId);
-        if (!assetInfo) {
-          throw new WalletError(
-            "NETWORK_ERROR",
-            "Could not fetch balances. Please try again later."
-          );
-        }
-        const { token, chain: chain2, chainKey, userAddress } = assetInfo;
-        const decimals = token ? token.decimals : chain2.decimals;
-        const symbol = token ? token.symbol ?? token.address : chain2.symbol;
-        const isToken = token !== void 0;
-        const humanAmount = formatAmount(balance.amounts.total, decimals);
-        const fiatRaw = balance.amounts.totalInFiat;
-        const usdValue = fiatRaw && fiatRaw !== "" ? parseFloat(fiatRaw) : null;
-        allRows.push({
-          chain: chainKey,
-          type: isToken ? "token" : "native",
-          symbol,
-          address: userAddress,
-          ...token ? { contract: token.address } : {},
-          balance: humanAmount,
-          usdValue
-        });
-      }
-      const rows = allRows.filter((r3) => r3.type === "native" || r3.balance !== "0");
-      rows.sort((a3, b3) => {
-        const chainCmp = String(a3.chain).localeCompare(String(b3.chain));
-        if (chainCmp !== 0) return chainCmp;
-        return String(a3.type).localeCompare(String(b3.type));
-      });
-      if (opts.json) {
-        output(rows, true);
-      } else {
-        const totalUsd = rows.reduce(
-          (sum, r3) => sum + (typeof r3.usdValue === "number" ? r3.usdValue : 0),
-          0
-        );
-        console.log("Chain        Type    Symbol            Balance               USD");
-        console.log("\u2500".repeat(72));
-        for (const r3 of rows) {
-          const usd = r3.usdValue !== null ? `$${r3.usdValue.toFixed(2)}` : "";
-          console.log(
-            `${String(r3.chain).padEnd(12)} ${String(r3.type).padEnd(7)} ${String(r3.symbol).padEnd(17)} ${String(r3.balance).padEnd(20)} ${usd}`
-          );
-        }
-        console.log("\u2500".repeat(72));
-        console.log(`Total USD: $${totalUsd.toFixed(2)}`);
-      }
-    } catch (err) {
-      handleCommandError(err, opts.json, "Portfolio failed");
-    }
-    safeExit();
-  });
-  wallet.command("sign-message").description("Sign a message with the agent wallet").requiredOption("--chain <key>", "Chain key (e.g., ethereum, solana)").requiredOption("--message <text>", "Message to sign").option(
-    "--password <password>",
-    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
-  ).option("--json", "JSON output").action(async (opts) => {
-    try {
-      if (!getChainById(opts.chain)) {
-        throw new WalletError("CHAIN_UNSUPPORTED", `Unknown chain: ${opts.chain}`);
-      }
-      await ensureTrustSDK();
-      const password3 = await resolvePassword(opts);
-      const provider = await AgentWalletProvider.fromStorage(password3);
-      const address = await provider.getAddress(opts.chain);
-      const signature = await provider.signMessage(opts.chain, opts.message);
-      output({ chain: opts.chain, address, message: opts.message, signature }, opts.json);
-    } catch (err) {
-      handleCommandError(err, opts.json, "Sign failed");
-    }
-    safeExit();
-  });
-  wallet.command("register").description("Register wallet addresses with Trust Wallet backend (enables token holdings)").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (opts) => {
-    try {
-      const creds = await ensureTrustSDK();
-      const password3 = await resolvePassword(opts);
-      const provider = await AgentWalletProvider.fromStorage(password3);
-      await registerWalletWithBackend(creds, provider);
-      if (!opts.json) success("Wallet registered with backend");
-      const addresses = await provider.getAddresses();
-      output({ registered: true, chains: addresses.length }, opts.json);
-    } catch (err) {
-      handleCommandError(err, opts.json, "Registration failed");
-    }
-    safeExit();
-  });
-}
-
-// src/commands/transfer.ts
-init_dist();
-
-// ../swap/dist/index.mjs
-init_dist();
-init_dist();
-
-// ../contracts/dist/index.mjs
-init_dist();
-init_dist();
-init_dist();
-init_dist();
-init_dist3();
-init_dist();
-init_dist();
-init_dist();
-var HEX_PATTERN = /^0x[0-9a-fA-F]*$/;
-function isHex(value) {
-  return HEX_PATTERN.test(value);
-}
-function hexToBytes3(hex2) {
-  if (!isHex(hex2)) {
-    throw new TwakValidationError(`Invalid hex string: ${hex2}`, { kind: "invalidHex" });
-  }
-  const clean2 = hex2.slice(2);
-  if (clean2.length % 2 !== 0) {
-    throw new TwakValidationError(`Hex string has odd length: ${hex2}`, { kind: "invalidHex" });
-  }
-  const out = new Uint8Array(clean2.length / 2);
-  for (let i2 = 0; i2 < out.length; i2++) {
-    out[i2] = parseInt(clean2.slice(i2 * 2, i2 * 2 + 2), 16);
-  }
-  return out;
-}
-function bytesToHex3(bytes) {
-  let out = "0x";
-  for (let i2 = 0; i2 < bytes.length; i2++) {
-    out += bytes[i2].toString(16).padStart(2, "0");
-  }
-  return out;
-}
-function hexOrUtf8ToBytesHex(value) {
-  const looksHex = value.length >= 2 && value[0] === "0" && (value[1] === "x" || value[1] === "X");
-  if (looksHex) {
-    const canonical = "0x" + value.slice(2);
-    if (!isHex(canonical)) {
-      throw new TwakValidationError(
-        `Value starts with "0x" but is not valid hex: ${value}. Use only [0-9a-fA-F] characters, or drop the "0x" prefix to send a UTF-8 string.`,
-        { kind: "invalidHex" }
-      );
-    }
-    if ((canonical.length - 2) % 2 !== 0) {
-      throw new TwakValidationError(
-        `Hex value has odd length: ${value}. Solidity bytes must be byte-aligned.`,
-        { kind: "invalidHex" }
-      );
-    }
-    return canonical;
-  }
-  return bytesToHex3(new TextEncoder().encode(value));
-}
-function wc2() {
-  return getWalletCore();
-}
-var BRIDGE = {
-  createAbiFunction(name2) {
-    const ctor = wc2().EthereumAbiFunction;
-    if (typeof ctor?.createWithString === "function") {
-      return ctor.createWithString(name2);
-    }
-    return new ctor(name2);
-  },
-  encode(fn2) {
-    return wc2().EthereumAbi.encode(fn2);
-  },
-  decodeOutput(fn2, data) {
-    return wc2().EthereumAbi.decodeOutput(fn2, data);
-  },
-  keccak256(data) {
-    return wc2().Hash.keccak256(data);
-  }
-};
-function getAbiBridge() {
-  return BRIDGE;
-}
-function findAbiFunction(abi, methodName, argCount) {
-  const matches = abi.filter(
-    (e2) => e2.type === "function" && e2.name === methodName
-  );
-  if (matches.length === 0) {
-    throw new TwakValidationError(`Unknown ABI method: ${methodName}`, {
-      kind: "unknownMethod",
-      methodName
-    });
-  }
-  if (matches.length === 1 || argCount === void 0) {
-    return matches[0];
-  }
-  const byArity = matches.filter((m2) => m2.inputs.length === argCount);
-  if (byArity.length === 1) {
-    return byArity[0];
-  }
-  throw new TwakValidationError(`No unique ${methodName} overload taking ${argCount} argument(s)`, {
-    kind: "unknownMethod",
-    methodName
-  });
-}
-function encodeFunctionCall(abi, methodName, args) {
-  const fnDef = findAbiFunction(abi, methodName, args.length);
-  if (args.length !== fnDef.inputs.length) {
-    throw new TwakValidationError(
-      `Wrong arg count for ${methodName}: expected ${fnDef.inputs.length}, got ${args.length}`,
-      {
-        kind: "wrongArgCount",
-        methodName,
-        expected: fnDef.inputs.length,
-        actual: args.length
-      }
-    );
-  }
-  if (encoderRequiresHandRoll(fnDef.inputs)) {
-    return encodeFunctionCallHandRoll(methodName, fnDef.inputs, args);
-  }
-  const bridge = getAbiBridge();
-  const fn2 = bridge.createAbiFunction(methodName);
-  fnDef.inputs.forEach((param, i2) => {
-    pushParam(fn2, param, args[i2], methodName);
-  });
-  return bytesToHex3(bridge.encode(fn2));
-}
-function pushParam(fn2, param, value, methodName) {
-  const type = param.type;
-  const isOutput = false;
-  if (type === "address") {
-    fn2.addParamAddress(toAddressBytes(value, param, methodName), isOutput);
-    return;
-  }
-  if (type === "bool") {
-    if (typeof value !== "boolean") {
-      throw argTypeMismatch(methodName, param, value, "boolean");
+  return bytesToHex3(bridge.encode(fn2));
+}
+function pushParam(fn2, param, value, methodName) {
+  const type = param.type;
+  const isOutput = false;
+  if (type === "address") {
+    fn2.addParamAddress(toAddressBytes(value, param, methodName), isOutput);
+    return;
+  }
+  if (type === "bool") {
+    if (typeof value !== "boolean") {
+      throw argTypeMismatch(methodName, param, value, "boolean");
     }
     fn2.addParamBool(value, isOutput);
     return;
@@ -42012,14 +41432,14 @@ function buildWriteProxy(abi, address, chainKey, client) {
           });
         }
         const data = encodeFunctionCall(abi, prop, args);
-        const txHash = await signer.sendTransaction({
+        const hash = await signer.sendTransaction({
           chainId: chainKeyToCaip2(chainKey),
           to: address,
           data,
           value: "0x0"
         });
         return makeContractPendingTransaction({
-          txHash,
+          hash,
           abi,
           address,
           chainKey,
@@ -42031,22 +41451,22 @@ function buildWriteProxy(abi, address, chainKey, client) {
   });
 }
 function makeContractPendingTransaction(opts) {
-  const { txHash, abi, address, chainKey, client, methodName } = opts;
+  const { hash, abi, address, chainKey, client, methodName } = opts;
   return {
-    txHash,
+    hash,
     async wait(waitOpts) {
-      const receipt = await client.waitForReceipt(chainKey, txHash, {
+      const receipt = await client.waitForReceipt(chainKey, hash, {
         timeoutMs: waitOpts?.timeoutMs
       });
       if (receipt.status === "0x0") {
         throw new TwakError(
           `Transaction reverted on-chain: ${receipt.transactionHash}`,
           "TX_FAILED",
-          { txHash: receipt.transactionHash, methodName, receipt }
+          { hash: receipt.transactionHash, methodName, receipt }
         );
       }
       return {
-        txHash: receipt.transactionHash,
+        hash: receipt.transactionHash,
         blockNumber: hexToSafeNumber(receipt.blockNumber, "blockNumber"),
         events: extractEvents(abi, receipt.logs, address)
       };
@@ -42143,6 +41563,17 @@ function lookupAddress(id, addresses, chainKey) {
   }
   return address;
 }
+function eip191Digest(message) {
+  const messageBytes = new TextEncoder().encode(message);
+  const prefixBytes = new TextEncoder().encode(
+    `Ethereum Signed Message:
+${messageBytes.length}`
+  );
+  const data = new Uint8Array(prefixBytes.length + messageBytes.length);
+  data.set(prefixBytes);
+  data.set(messageBytes, prefixBytes.length);
+  return bytesToHex3(getAbiBridge().keccak256(data));
+}
 var ERC20_ABI = [
   {
     type: "function",
@@ -42722,6 +42153,29 @@ var ERC8183_POLICY_ABI = [
     outputs: [],
     stateMutability: "nonpayable"
   },
+  {
+    type: "function",
+    name: "disputeWindow",
+    inputs: [],
+    outputs: [{ name: "", type: "uint64" }],
+    stateMutability: "view"
+  },
+  {
+    // When the policy recorded the job's submission (0 if not submitted).
+    type: "function",
+    name: "submittedAt",
+    inputs: [{ name: "jobId", type: "uint256" }],
+    outputs: [{ name: "", type: "uint64" }],
+    stateMutability: "view"
+  },
+  {
+    // Vote quorum snapshotted for the job when its dispute was raised.
+    type: "function",
+    name: "disputeQuorumSnapshot",
+    inputs: [{ name: "jobId", type: "uint256" }],
+    outputs: [{ name: "", type: "uint16" }],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "disputed",
@@ -42833,8 +42287,640 @@ function resolveErc8183Contracts(client, chainInput) {
   };
 }
 
+// src/branding.ts
+var import_chalk5 = __toESM(require_source());
+var boxen = require_boxen();
+var SHIELD = [
+  "                @@=+                ",
+  "           @@@@@@@=======           ",
+  "     @@@@@@@@@@@@@============+     ",
+  "  @@@@@@@@@@@@@@@@================  ",
+  "  @@@@@@@@@@@@@@@@+===============  ",
+  "  @@@@@@@@@@@@@@@@++++============  ",
+  "  @@@@@@@@@@@@@@@@++++++++++=====+  ",
+  "  @@@@@@@@@@@@@@@@**++++++++++++++  ",
+  "  @@@@@@@@@@@@@@@@********++++++++  ",
+  "  @@@@@@@@@@@@@@@@**************++  ",
+  "  @@@@@@@@@@@@@@@@#####***********  ",
+  "   @@@@@@@@@@@@@@@###########****   ",
+  "    @@@@@@@@@@@@@@%##############   ",
+  "    @@@@@@@@@@@@@@%%%%%%%#######    ",
+  "     @@@@@@@@@@@@@%%%%%%%%%%%%%     ",
+  "       @@@@@@@@@@@%%%%%%%%%%%       ",
+  "         @@@@@@@@@@@@@%%%%%         ",
+  "           @@@@@@@@@@@@@@           ",
+  "             @@@@@@@@@@             ",
+  "                 @@                 "
+];
+function printBanner(version3) {
+  const logo = SHIELD.map((l4) => import_chalk5.default.green(l4)).join("\n");
+  const title = import_chalk5.default.green.bold("  Trust Wallet Agent Kit");
+  const ver = import_chalk5.default.dim(`  v${version3}`);
+  console.log(
+    boxen(`${logo}
+
+${title}
+${ver}`, {
+      borderColor: "green",
+      borderStyle: "round",
+      padding: { top: 1, bottom: 1, left: 2, right: 2 }
+    })
+  );
+}
+function box(content) {
+  return boxen(content, {
+    borderColor: "green",
+    borderStyle: "round",
+    padding: { top: 0, bottom: 0, left: 1, right: 1 }
+  });
+}
+
+// src/commands/wallet.ts
+function getQRString(address) {
+  try {
+    const qrcode = require("qrcode-terminal");
+    let result = "";
+    qrcode.generate(address, { small: true }, (code2) => {
+      result = code2;
+    });
+    return result;
+  } catch {
+    return "";
+  }
+}
+function registerWalletCommand(program3) {
+  const wallet = program3.command("wallet").description("Manage agent wallet");
+  wallet.command("create").description("Create a new agent wallet").requiredOption("--password <password>", "Password to encrypt the wallet").option("--no-keychain", "Do not save password to OS keychain").option("--skip-password-check", "Skip password strength validation").option("--json", "JSON output").action(async (opts) => {
+    try {
+      if (!opts.skipPasswordCheck) {
+        const weakness = getPasswordWeaknesses(opts.password);
+        if (weakness) {
+          throw new WalletError("VALIDATION_ERROR", `Password too weak: must ${weakness}.`);
+        }
+      }
+      await ensureTrustSDK();
+      const store = new WalletConfigStore();
+      if (await store.exists()) {
+        throw new WalletError(
+          "WALLET_EXISTS",
+          "Wallet already exists. Back up ~/.twak/wallet.json, then delete it to create a new one."
+        );
+      }
+      const provider = await AgentWalletProvider.create(opts.password);
+      const addresses = await provider.getAddresses();
+      if (opts.keychain !== false) {
+        const kc2 = new KeychainManager();
+        if (kc2.isAvailable()) {
+          await kc2.saveWalletPassword(opts.password);
+          if (!opts.json) info("Password saved to OS keychain (use --no-keychain to skip)");
+        }
+      }
+      if (!opts.json) success("Agent wallet created successfully");
+      try {
+        const creds = await getCredentials();
+        await registerWalletWithBackend(creds, provider);
+        if (!opts.json) info("Wallet registered with backend");
+      } catch {
+        if (!opts.json) warn("Backend registration failed (holdings may be limited)");
+      }
+      if (opts.json) {
+        output({ addresses }, true);
+      } else {
+        info(`Generated addresses for ${addresses.length} chains`);
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "Wallet creation failed");
+    }
+    safeExit();
+  });
+  wallet.command("address").description("Get wallet address for a chain").requiredOption("--chain <key>", "Chain key (e.g., ethereum, solana)").option(
+    "--password <password>",
+    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
+  ).option("--json", "JSON output").action(async (opts) => {
+    try {
+      if (!getChainById(opts.chain)) {
+        throw new WalletError("CHAIN_UNSUPPORTED", `Unknown chain: ${opts.chain}`);
+      }
+      await ensureTrustSDK();
+      const password3 = await resolvePassword(opts);
+      const provider = await AgentWalletProvider.fromStorage(password3);
+      const address = await provider.getAddress(opts.chain);
+      if (opts.json) {
+        output({ chain: opts.chain, address }, true);
+      } else {
+        const qr3 = getQRString(address);
+        const content = `${import_chalk6.default.dim("Chain")}    ${import_chalk6.default.bold(opts.chain)}
+${import_chalk6.default.dim("Address")}  ${import_chalk6.default.green(address)}
+
+${qr3}`;
+        console.log(box(content));
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "Wallet address failed");
+    }
+    safeExit();
+  });
+  wallet.command("addresses").description("List all wallet addresses").option(
+    "--password <password>",
+    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
+  ).option("--json", "JSON output").action(async (opts) => {
+    try {
+      await ensureTrustSDK();
+      const password3 = await resolvePassword(opts);
+      const provider = await AgentWalletProvider.fromStorage(password3);
+      const addresses = await provider.getAddresses();
+      if (opts.json) {
+        output({ addresses }, true);
+      } else {
+        const grouped = /* @__PURE__ */ new Map();
+        for (const addr of addresses) {
+          const chains = grouped.get(addr.address) ?? [];
+          chains.push(addr.chainId);
+          grouped.set(addr.address, chains);
+        }
+        for (const [address, chains] of grouped) {
+          const qr3 = getQRString(address);
+          const maxWidth = Math.max(address.length + 9, 50);
+          const chainLabel = `${import_chalk6.default.dim("Chains")}   `;
+          const chainLabelLen = 9;
+          const chainLines = [];
+          let line = "";
+          for (const c3 of chains) {
+            const sep2 = line ? ", " : "";
+            if (line && line.length + sep2.length + c3.length + chainLabelLen > maxWidth) {
+              chainLines.push(line);
+              line = c3;
+            } else {
+              line += sep2 + c3;
+            }
+          }
+          if (line) chainLines.push(line);
+          const chainsStr = chainLines.map((l4, i2) => (i2 === 0 ? chainLabel : " ".repeat(chainLabelLen)) + import_chalk6.default.bold(l4)).join("\n");
+          const content = `${chainsStr}
+${import_chalk6.default.dim("Address")}  ${import_chalk6.default.green(address)}
+
+${qr3}`;
+          console.log(box(content));
+        }
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "Wallet addresses failed");
+    }
+    safeExit();
+  });
+  wallet.command("balance").description("Get wallet balance on a chain (native + token holdings)").option("--chain <key>", "Chain key").option("--all", "Show balances across all chains with funds").option(
+    "--password <password>",
+    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
+  ).option("--no-tokens", "Skip token balance lookup").option("--json", "JSON output").action(async (opts) => {
+    try {
+      if (opts.all && opts.chain) {
+        throw new WalletError("VALIDATION_ERROR", "--all and --chain are mutually exclusive");
+      }
+      if (!opts.all && !opts.chain) {
+        throw new WalletError("VALIDATION_ERROR", "Provide --chain <key> or --all");
+      }
+      await ensureTrustSDK();
+      const password3 = await resolvePassword(opts);
+      const provider = await AgentWalletProvider.fromStorage(password3);
+      const httpClient = await getClient();
+      if (!opts.all) {
+        const chain2 = getChainById(opts.chain);
+        if (!chain2) {
+          throw new WalletError("CHAIN_UNSUPPORTED", `Unknown chain: ${opts.chain}`);
+        }
+      }
+      const allAddresses = await provider.getAddresses();
+      const addressMap = /* @__PURE__ */ new Map();
+      for (const a3 of allAddresses) addressMap.set(a3.chainId, a3.address);
+      const requestedChains = opts.all ? Object.keys(CHAINS) : [opts.chain];
+      const skipTokens = opts.tokens === false;
+      const chainEntries = requestedChains.flatMap((chainKey) => {
+        const chain2 = getChainById(chainKey);
+        const address = addressMap.get(chainKey);
+        if (!chain2 || !address) return [];
+        return [{ chainKey, chain: chain2, address }];
+      });
+      if (!opts.all && chainEntries.length === 0) {
+        throw new WalletError(
+          "CHAIN_UNSUPPORTED",
+          `Wallet does not have an address for chain: ${opts.chain}`
+        );
+      }
+      const nativeAssets = chainEntries.map(({ chainKey, chain: chain2, address }) => ({
+        chainKey,
+        chain: chain2,
+        token: void 0,
+        assetId: `c${chain2.coinId}`,
+        userAddress: address
+      }));
+      const tokenAssets = skipTokens ? [] : chainEntries.flatMap(({ chainKey, chain: chain2, address }) => {
+        const knownTokens = COMMON_TOKENS[chainKey];
+        if (!knownTokens) return [];
+        return Object.keys(knownTokens).flatMap((sym) => {
+          const resolved = resolveToken(sym, chainKey);
+          if (!resolved) return [];
+          return [
+            {
+              chainKey,
+              chain: chain2,
+              token: { ...resolved, symbol: sym },
+              assetId: `c${chain2.coinId}_t${resolved.address}`,
+              userAddress: address
+            }
+          ];
+        });
+      });
+      const allAssets = [...nativeAssets, ...tokenAssets];
+      const balances = await fetchBalances(
+        httpClient,
+        allAssets.map(({ assetId, userAddress }) => ({ assetId, address: userAddress }))
+      );
+      const assetsById = new Map(allAssets.map((a3) => [a3.assetId, a3]));
+      const resultsByChain = /* @__PURE__ */ new Map();
+      for (const { chainKey, chain: chain2, address } of chainEntries) {
+        resultsByChain.set(chainKey, {
+          chain: chainKey,
+          address,
+          symbol: chain2.symbol,
+          available: "0",
+          total: "0",
+          totalUsd: null,
+          tokens: []
+        });
+      }
+      for (const balance of balances) {
+        const assetInfo = assetsById.get(balance.assetId);
+        if (!assetInfo) {
+          throw new WalletError(
+            "NETWORK_ERROR",
+            "Could not fetch balances. Please try again later."
+          );
+        }
+        const result = resultsByChain.get(assetInfo.chainKey);
+        if (!result) continue;
+        const { token, chain: chain2 } = assetInfo;
+        const amts = balance.amounts;
+        if (token) {
+          const human = formatAmount(amts.total ?? "0", token.decimals);
+          if (human !== "0") {
+            result.tokens.push({
+              symbol: token.symbol,
+              contract: token.address,
+              balance: human
+            });
+          }
+        } else {
+          result.available = formatAmount(amts.available ?? "0", chain2.decimals);
+          result.total = formatAmount(amts.total ?? "0", chain2.decimals);
+          const lockedHuman = formatAmount(amts.locked ?? "0", chain2.decimals);
+          if (lockedHuman !== "0") result.staked = lockedHuman;
+          const fiat = amts.totalInFiat;
+          result.totalUsd = fiat && fiat !== "" ? parseFloat(fiat) : null;
+        }
+      }
+      const orderedResults = chainEntries.map((e2) => resultsByChain.get(e2.chainKey)).filter((r3) => r3 !== void 0);
+      const visible = opts.all ? orderedResults.filter((r3) => r3.total !== "0" || r3.tokens.length > 0) : orderedResults;
+      const renderBlock = (r3, withSeparator) => {
+        if (withSeparator) console.log("");
+        console.log(import_chalk6.default.bold.underline(`${r3.chain} (${r3.symbol})`));
+        console.log(`  ${import_chalk6.default.dim("Address")}    ${r3.address}`);
+        console.log(`  ${import_chalk6.default.dim("Available")}  ${r3.available}`);
+        if (r3.staked) console.log(`  ${import_chalk6.default.dim("Staked")}     ${r3.staked}`);
+        const usdSuffix = r3.totalUsd !== null ? ` (\u2248 $${r3.totalUsd.toFixed(2)})` : "";
+        console.log(`  ${import_chalk6.default.dim("Total")}      ${r3.total}${usdSuffix}`);
+        if (r3.tokens.length > 0) {
+          console.log(`  ${import_chalk6.default.dim("Tokens:")}`);
+          for (const t of r3.tokens) {
+            console.log(`    ${import_chalk6.default.bold(t.symbol.padEnd(10))} ${t.balance}`);
+          }
+        }
+      };
+      if (opts.all) {
+        if (opts.json) {
+          output(visible, true);
+        } else if (visible.length === 0) {
+          info("No chains with non-zero native balance found.");
+        } else {
+          visible.forEach((r3, i2) => renderBlock(r3, i2 > 0));
+        }
+      } else {
+        const single = visible[0];
+        if (opts.json) {
+          output(single, true);
+        } else {
+          renderBlock(single, false);
+        }
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "Balance check failed");
+    }
+    safeExit();
+  });
+  const keychain = wallet.command("keychain").description("Manage wallet password in OS keychain");
+  keychain.command("save").description("Save wallet password to OS keychain").requiredOption("--password <password>", "Wallet password to store").option("--json", "JSON output").action(async (opts) => {
+    try {
+      const kc2 = new KeychainManager();
+      if (!kc2.isAvailable()) {
+        throw new WalletError("KEYCHAIN_UNAVAILABLE", "OS keychain not available on this system");
+      }
+      await kc2.saveWalletPassword(opts.password);
+      success("Wallet password saved to OS keychain");
+    } catch (err) {
+      handleCommandError(err, opts.json, "Keychain save failed");
+    }
+    safeExit();
+  });
+  keychain.command("delete").description("Remove wallet password from OS keychain").option("--json", "JSON output").action(async (opts) => {
+    try {
+      const kc2 = new KeychainManager();
+      if (!kc2.isAvailable()) {
+        throw new WalletError("KEYCHAIN_UNAVAILABLE", "OS keychain not available on this system");
+      }
+      await kc2.deleteWalletPassword();
+      success("Wallet password removed from OS keychain");
+    } catch (err) {
+      handleCommandError(err, opts.json, "Keychain delete failed");
+    }
+    safeExit();
+  });
+  keychain.command("check").description("Check if wallet password is stored in OS keychain").option("--json", "JSON output").action(async (opts) => {
+    try {
+      const kc2 = new KeychainManager();
+      if (!kc2.isAvailable()) {
+        if (opts.json) {
+          output({ available: false, stored: false }, true);
+        } else {
+          warn("keytar not available on this system");
+        }
+        safeExit();
+        return;
+      }
+      const pw = await kc2.getWalletPassword();
+      if (opts.json) {
+        output({ available: true, stored: !!pw }, true);
+      } else if (pw) {
+        success("Wallet password is stored in OS keychain");
+      } else {
+        info("No wallet password found in OS keychain");
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "Keychain check failed");
+    }
+    safeExit();
+  });
+  wallet.command("connect").description("Connect external wallet via WalletConnect").option("--project-id <id>", "WalletConnect project ID (or set WALLETCONNECT_PROJECT_ID)").option(
+    "--chains <list>",
+    "Comma-separated CAIP-2 chain IDs",
+    "eip155:1,eip155:56,eip155:137,eip155:8453,eip155:42161"
+  ).option("--timeout <seconds>", "Connection timeout in seconds", "300").option("--json", "JSON output").action(async (opts) => {
+    try {
+      const projectId = opts.projectId || process.env.WALLETCONNECT_PROJECT_ID;
+      if (!projectId) {
+        throw new WalletError(
+          "VALIDATION_ERROR",
+          "WalletConnect project ID required. Use --project-id or set WALLETCONNECT_PROJECT_ID"
+        );
+      }
+      const provider = new WalletConnectProvider({ projectId });
+      const chains = opts.chains.split(",").map((s2) => s2.trim()).filter(Boolean);
+      info("Connecting via WalletConnect...");
+      const result = await provider.connect(chains);
+      const qr3 = getQRString(result.uri);
+      if (qr3) {
+        console.log(qr3);
+      }
+      info(`Trust Wallet: ${result.deepLinks.native}`);
+      info(`Universal:    ${result.deepLinks.universal}`);
+      info("\nWaiting for wallet approval...");
+      const timeoutMs = parseInt(opts.timeout, 10) * 1e3;
+      const session = await provider.waitForSession(timeoutMs);
+      if (opts.json) {
+        output(
+          {
+            connected: true,
+            address: session.address,
+            chainId: session.chainId,
+            peer: session.peerName
+          },
+          true
+        );
+      } else {
+        success(`Connected to ${session.peerName || "wallet"}`);
+        info(`  Address: ${session.address}`);
+        info(`  Chain:   ${session.chainId}`);
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "WalletConnect failed");
+    }
+    safeExit();
+  });
+  wallet.command("status").description("Check wallet configuration status").option("--json", "JSON output").action(async (opts) => {
+    try {
+      const store = new WalletConfigStore();
+      const exists = await store.exists();
+      const kc2 = new KeychainManager();
+      const keychainHasPassword = kc2.isAvailable() ? !!await kc2.getWalletPassword() : false;
+      const totalChains = Object.keys(CHAINS).length;
+      let createdAt;
+      let addressCount;
+      if (exists) {
+        const config = await store.getConfig();
+        createdAt = config?.createdAt;
+        addressCount = config?.chains?.length ?? totalChains;
+      }
+      const result = {
+        agentWallet: exists ? "configured" : "not configured",
+        keychainPassword: keychainHasPassword ? "stored" : "not stored",
+        chains: totalChains,
+        supportedChains: totalChains,
+        ...createdAt ? { createdAt } : {},
+        ...addressCount !== void 0 ? { addressCount } : {}
+      };
+      if (opts.json) {
+        output(result, true);
+      } else {
+        console.log(
+          `  ${import_chalk6.default.dim("Wallet")}     ${exists ? import_chalk6.default.green("configured") : import_chalk6.default.yellow("not configured")}`
+        );
+        if (createdAt) console.log(`  ${import_chalk6.default.dim("Created")}    ${createdAt}`);
+        console.log(
+          `  ${import_chalk6.default.dim("Keychain")}   ${keychainHasPassword ? import_chalk6.default.green("password stored") : import_chalk6.default.yellow("no password")}`
+        );
+        console.log(`  ${import_chalk6.default.dim("Chains")}     ${totalChains} supported`);
+        if (addressCount !== void 0)
+          console.log(`  ${import_chalk6.default.dim("Addresses")}  ${addressCount}`);
+        if (!exists) info("\nRun `twak wallet create --password <pw>` to create a wallet.");
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "Status failed");
+    }
+    safeExit();
+  });
+  wallet.command("portfolio").description("Show portfolio balances and USD values across chains, including token holdings").option("--chains <list>", "Comma-separated chain keys (default: all supported chains)").option(
+    "--password <password>",
+    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
+  ).option("--json", "JSON output").action(async (opts) => {
+    try {
+      await ensureTrustSDK();
+      const password3 = await resolvePassword(opts);
+      const provider = await AgentWalletProvider.fromStorage(password3);
+      const httpClient = await getClient();
+      const allAddresses = await provider.getAddresses();
+      const chainsArg = opts.chains ?? Object.keys(CHAINS).join(",");
+      const requestedChains = chainsArg.split(",").map((s2) => s2.trim()).filter(Boolean);
+      if (requestedChains.length === 0) {
+        throw new WalletError("VALIDATION_ERROR", "--chains must include at least one chain key");
+      }
+      const chainEntries = requestedChains.flatMap((chainKey) => {
+        const chain2 = getChainById(chainKey);
+        const addrEntry = allAddresses.find((a3) => a3.chainId === chainKey);
+        if (!chain2 || !addrEntry) return [];
+        return [{ chainKey, chain: chain2, address: addrEntry.address }];
+      });
+      if (chainEntries.length === 0) {
+        throw new WalletError(
+          "CHAIN_UNSUPPORTED",
+          `No supported chains found in --chains "${opts.chains}"`
+        );
+      }
+      const chainAssets = chainEntries.map(({ chainKey, chain: chain2, address }) => ({
+        chainKey,
+        chain: chain2,
+        token: void 0,
+        assetId: `c${chain2.coinId}`,
+        userAddress: address
+      }));
+      const tokenAssets = chainEntries.flatMap(({ chainKey, chain: chain2, address }) => {
+        const knownTokens = COMMON_TOKENS[chainKey];
+        if (!knownTokens) return [];
+        return Object.keys(knownTokens).flatMap((sym) => {
+          const resolved = resolveToken(sym, chainKey);
+          if (!resolved) return [];
+          return [
+            {
+              chainKey,
+              chain: chain2,
+              token: { ...resolved, symbol: sym },
+              assetId: `c${chain2.coinId}_t${resolved.address}`,
+              userAddress: address
+            }
+          ];
+        });
+      });
+      const allAssets = [...chainAssets, ...tokenAssets];
+      const balances = await fetchBalances(
+        httpClient,
+        allAssets.map(({ assetId, userAddress }) => ({ assetId, address: userAddress }))
+      );
+      const assetsById = new Map(allAssets.map((a3) => [a3.assetId, a3]));
+      const allRows = [];
+      for (const balance of balances) {
+        const assetInfo = assetsById.get(balance.assetId);
+        if (!assetInfo) {
+          throw new WalletError(
+            "NETWORK_ERROR",
+            "Could not fetch balances. Please try again later."
+          );
+        }
+        const { token, chain: chain2, chainKey, userAddress } = assetInfo;
+        const decimals = token ? token.decimals : chain2.decimals;
+        const symbol = token ? token.symbol ?? token.address : chain2.symbol;
+        const isToken = token !== void 0;
+        const humanAmount = formatAmount(balance.amounts.total, decimals);
+        const fiatRaw = balance.amounts.totalInFiat;
+        const usdValue = fiatRaw && fiatRaw !== "" ? parseFloat(fiatRaw) : null;
+        allRows.push({
+          chain: chainKey,
+          type: isToken ? "token" : "native",
+          symbol,
+          address: userAddress,
+          ...token ? { contract: token.address } : {},
+          balance: humanAmount,
+          usdValue
+        });
+      }
+      const rows = allRows.filter((r3) => r3.type === "native" || r3.balance !== "0");
+      rows.sort((a3, b3) => {
+        const chainCmp = String(a3.chain).localeCompare(String(b3.chain));
+        if (chainCmp !== 0) return chainCmp;
+        return String(a3.type).localeCompare(String(b3.type));
+      });
+      if (opts.json) {
+        output(rows, true);
+      } else {
+        const totalUsd = rows.reduce(
+          (sum, r3) => sum + (typeof r3.usdValue === "number" ? r3.usdValue : 0),
+          0
+        );
+        console.log("Chain        Type    Symbol            Balance               USD");
+        console.log("\u2500".repeat(72));
+        for (const r3 of rows) {
+          const usd = r3.usdValue !== null ? `$${r3.usdValue.toFixed(2)}` : "";
+          console.log(
+            `${String(r3.chain).padEnd(12)} ${String(r3.type).padEnd(7)} ${String(r3.symbol).padEnd(17)} ${String(r3.balance).padEnd(20)} ${usd}`
+          );
+        }
+        console.log("\u2500".repeat(72));
+        console.log(`Total USD: $${totalUsd.toFixed(2)}`);
+      }
+    } catch (err) {
+      handleCommandError(err, opts.json, "Portfolio failed");
+    }
+    safeExit();
+  });
+  wallet.command("sign-message").description("Sign a message with the agent wallet").requiredOption("--chain <key>", "Chain key (e.g., ethereum, solana)").requiredOption("--message <text>", "Message to sign").option(
+    "--password <password>",
+    "Wallet password (falls back to keychain / TWAK_WALLET_PASSWORD)"
+  ).option("--json", "JSON output").action(async (opts) => {
+    try {
+      const chain2 = getChainById(opts.chain);
+      if (!chain2) {
+        throw new WalletError("CHAIN_UNSUPPORTED", `Unknown chain: ${opts.chain}`);
+      }
+      await ensureTrustSDK();
+      const password3 = await resolvePassword(opts);
+      const provider = await AgentWalletProvider.fromStorage(password3);
+      const address = await provider.getAddress(opts.chain);
+      const rawSignature = await provider.signMessage(opts.chain, opts.message);
+      const signature = chain2.isEVM && !rawSignature.startsWith("0x") ? `0x${rawSignature}` : rawSignature;
+      output(
+        {
+          chain: opts.chain,
+          address,
+          message: opts.message,
+          signature,
+          ...chain2.isEVM ? { digest: eip191Digest(opts.message) } : {}
+        },
+        opts.json
+      );
+    } catch (err) {
+      handleCommandError(err, opts.json, "Sign failed");
+    }
+    safeExit();
+  });
+  wallet.command("register").description("Register wallet addresses with Trust Wallet backend (enables token holdings)").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (opts) => {
+    try {
+      const creds = await ensureTrustSDK();
+      const password3 = await resolvePassword(opts);
+      const provider = await AgentWalletProvider.fromStorage(password3);
+      await registerWalletWithBackend(creds, provider);
+      if (!opts.json) success("Wallet registered with backend");
+      const addresses = await provider.getAddresses();
+      output({ registered: true, chains: addresses.length }, opts.json);
+    } catch (err) {
+      handleCommandError(err, opts.json, "Registration failed");
+    }
+    safeExit();
+  });
+}
+
+// src/commands/transfer.ts
+init_dist();
+
 // ../swap/dist/index.mjs
 init_dist();
+init_dist();
+init_dist();
 var SwapClient = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
@@ -43116,9 +43202,9 @@ var SwapExecutor = class {
     );
     const chainConfig = getChainById(params.fromChain);
     const transactions = await withRetry(() => this.swapClient.getSwapTransactions(route));
-    let approvalTxHash;
+    let approvalHash;
     try {
-      approvalTxHash = await this.ensureStepApproval(
+      approvalHash = await this.ensureStepApproval(
         route,
         transactions,
         chainConfig,
@@ -43126,10 +43212,10 @@ var SwapExecutor = class {
         address,
         parsedAmount
       );
-      if (approvalTxHash) {
-        await this.pollForConfirmation(params.fromChain, address, approvalTxHash, 6e4);
+      if (approvalHash) {
+        await this.pollForConfirmation(params.fromChain, address, approvalHash, 6e4);
       }
-      let txHash = "";
+      let hash = "";
       for (const txData of transactions) {
         const txType = txData.transaction.type;
         const isApproval = txType === "approval" || txType === "revokeApproval";
@@ -43138,30 +43224,30 @@ var SwapExecutor = class {
             txType === "revokeApproval" ? "Revoking prior approval..." : "Sending token approval..."
           );
         }
-        txHash = await this.sendTransaction(txData, chainConfig, params.fromChain);
-        if (isApproval) approvalTxHash = txHash;
+        hash = await this.sendTransaction(txData, chainConfig, params.fromChain);
+        if (isApproval) approvalHash = hash;
         this.log(
-          `${isApproval ? "Approval" : "Swap"} tx: ${getExplorerTxUrl(params.fromChain, txHash)}`
+          `${isApproval ? "Approval" : "Swap"} tx: ${getExplorerTxUrl(params.fromChain, hash)}`
         );
         await this.pollForConfirmation(
           params.fromChain,
           address,
-          txHash,
+          hash,
           isApproval ? 6e4 : 12e4
         );
       }
       return {
         success: true,
-        txHash,
+        hash,
         route,
-        explorerUrl: getExplorerTxUrl(params.fromChain, txHash)
+        explorerUrl: getExplorerTxUrl(params.fromChain, hash)
       };
     } catch (err) {
       let msg = err instanceof Error ? err.message : "Unknown error";
       let code2 = classifySwapError(msg);
-      if (approvalTxHash) {
+      if (approvalHash) {
         code2 = "APPROVAL_SENT_SWAP_FAILED";
-        msg += `. Approval was sent (tx: ${approvalTxHash}). Check allowance before retrying.`;
+        msg += `. Approval was sent (tx: ${approvalHash}). Check allowance before retrying.`;
       }
       return { success: false, route, error: msg, code: code2 };
     }
@@ -43193,8 +43279,8 @@ var SwapExecutor = class {
     if (allowance >= required) return void 0;
     this.log("Sending token approval...");
     const approveResult = await blockchainClient.contract(erc20).withAddress(fromAssetAddr, fromChain).write.approve([stepApproval.operatorAddress, required], this.walletProvider);
-    this.log(`Approval tx: ${getExplorerTxUrl(fromChain, approveResult.txHash)}`);
-    return approveResult.txHash;
+    this.log(`Approval tx: ${getExplorerTxUrl(fromChain, approveResult.hash)}`);
+    return approveResult.hash;
   }
   getBlockchainClient() {
     const blockchainClient = this.walletProvider.getBlockchainClient?.() ?? this.options.blockchainClient;
@@ -43419,11 +43505,11 @@ function registerTransferCommand(program3) {
       } catch (err) {
         mapBroadcastError(err);
       }
-      const explorerUrl = getExplorerTxUrl(result.chainKey, result.txHash);
+      const explorerUrl = getExplorerTxUrl(result.chainKey, result.hash);
       success("Transfer sent!");
       output(
         {
-          hash: result.txHash,
+          hash: result.hash,
           chain: result.chainKey,
           from: address,
           to: resolvedTo,
@@ -43640,7 +43726,7 @@ function registerSwapCommand(program3) {
         output(
           {
             ...quoteData,
-            hash: result.txHash,
+            hash: result.hash,
             fromChain,
             toChain,
             explorer: result.explorerUrl
@@ -43723,11 +43809,11 @@ function registerErc20Command(program3) {
       info(`Approving ${opts.spender} to spend from ${address} on ${chainKey}...`);
       const client = provider.getBlockchainClient();
       const pending = await client.contract(erc20).withAddress(contractAddress, chainKey).write.approve([opts.spender, BigInt(amount)], provider);
-      const explorerUrl = getExplorerTxUrl(chainKey, pending.txHash);
+      const explorerUrl = getExplorerTxUrl(chainKey, pending.hash);
       success("Approval sent!");
       output(
         {
-          hash: pending.txHash,
+          hash: pending.hash,
           chain: chainKey,
           owner: address,
           spender: opts.spender,
@@ -43764,11 +43850,11 @@ function registerErc20Command(program3) {
       info(`Revoking approval for ${opts.spender} on ${chainKey}...`);
       const client = provider.getBlockchainClient();
       const pending = await client.contract(erc20).withAddress(contractAddress, chainKey).write.approve([opts.spender, 0n], provider);
-      const explorerUrl = getExplorerTxUrl(chainKey, pending.txHash);
+      const explorerUrl = getExplorerTxUrl(chainKey, pending.hash);
       success("Approval revoked!");
       output(
         {
-          hash: pending.txHash,
+          hash: pending.hash,
           chain: chainKey,
           owner: address,
           spender: opts.spender,
@@ -43918,7 +44004,7 @@ function registerErc8004Command(program3) {
       if (!registered) {
         throw new WalletError(
           "TX_FAILED",
-          `No Registered event emitted (txHash=${confirmed.txHash})`
+          `No Registered event emitted (hash=${confirmed.hash})`
         );
       }
       success("Agent registered!");
@@ -43928,9 +44014,9 @@ function registerErc8004Command(program3) {
           owner: registered.owner,
           agentURI: registered.agentURI,
           ...metadata.length > 0 ? { metadata: Object.fromEntries(metadata) } : {},
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -43964,9 +44050,9 @@ function registerErc8004Command(program3) {
         {
           agentId,
           agentURI: opts.uri,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -43999,9 +44085,9 @@ function registerErc8004Command(program3) {
           agentId,
           key: opts.key,
           value: valueBytes,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44061,6 +44147,8 @@ function registerErc8004Command(program3) {
 init_dist();
 init_dist3();
 var CHAIN_OPT = "EVM chain key (`bsc` and `bsctestnet` have known deployments)";
+var OPT_PARAMS_OPT = "Optional opaque optParams bytes passed through raw, as 0x-prefixed hex (defaults to empty)";
+var SUBMIT_OPT_PARAMS_OPT = `${OPT_PARAMS_OPT}. Evaluators may expect deliverable metadata here, e.g. hex-encoded UTF-8 JSON like {"deliverable_url": "..."}`;
 var ZERO_BYTES32 = `0x${"0".repeat(64)}`;
 function parseUint(value, label) {
   if (!/^\d+$/.test(value)) {
@@ -44071,6 +44159,16 @@ function parseUint(value, label) {
   }
   return BigInt(value);
 }
+function parseOptParams(value) {
+  if (value === void 0) return "0x";
+  if (!/^0x([0-9a-fA-F]{2})*$/.test(value)) {
+    throw new WalletError(
+      "VALIDATION_ERROR",
+      `--opt-params must be 0x-prefixed bytes (even-length hex): ${value}`
+    );
+  }
+  return value;
+}
 function registerErc8183Command(program3) {
   const cmd = program3.command("erc8183").description("ERC-8183 Agentic Commerce \u2014 on-chain job escrows between AI agents");
   cmd.command("create-job").description("Create a new job (caller becomes the client)").requiredOption("--provider <address>", "Provider (worker) address").requiredOption("--evaluator <address>", "Evaluator address").requiredOption("--expires-at <unix>", "Expiry as a unix timestamp (seconds)").requiredOption("--description <text>", "Human-readable job description").option("--hook <address>", "Optional hook contract (defaults to none)").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (opts) => {
@@ -44093,7 +44191,7 @@ function registerErc8183Command(program3) {
       if (!created) {
         throw new WalletError(
           "TX_FAILED",
-          `No JobCreated event emitted (txHash=${confirmed.txHash})`
+          `No JobCreated event emitted (hash=${confirmed.hash})`
         );
       }
       success("Job created!");
@@ -44101,9 +44199,9 @@ function registerErc8183Command(program3) {
         {
           jobId: created.jobId.toString(),
           status: "Open",
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44112,9 +44210,10 @@ function registerErc8183Command(program3) {
     }
     safeExit();
   });
-  cmd.command("set-provider <jobId>").description("Set or change the provider (client, while the job is Open)").requiredOption("--provider <address>", "New provider (worker) address").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
+  cmd.command("set-provider <jobId>").description("Set or change the provider (client, while the job is Open)").requiredOption("--provider <address>", "New provider (worker) address").option("--opt-params <hex>", OPT_PARAMS_OPT).option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
     try {
       const id = parseUint(jobId, "jobId");
+      const optParams = parseOptParams(opts.optParams);
       await ensureTrustSDK();
       const password3 = await resolvePassword(opts);
       const provider = await AgentWalletProvider.fromStorage(password3);
@@ -44123,16 +44222,16 @@ function registerErc8183Command(program3) {
         opts.chain
       );
       info(`Setting provider for job ${jobId} on ${chainKey}...`);
-      const pending = await commerce.write.setProvider([id, opts.provider, "0x"], provider);
+      const pending = await commerce.write.setProvider([id, opts.provider, optParams], provider);
       const confirmed = await pending.wait();
       success("Provider set!");
       output(
         {
           jobId,
           provider: opts.provider,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44141,10 +44240,11 @@ function registerErc8183Command(program3) {
     }
     safeExit();
   });
-  cmd.command("set-budget <jobId>").description("Set the escrow budget (atomic units of the payment token)").requiredOption("--amount <atomic>", "Budget in atomic units").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
+  cmd.command("set-budget <jobId>").description("Set the escrow budget (atomic units of the payment token)").requiredOption("--amount <atomic>", "Budget in atomic units").option("--opt-params <hex>", OPT_PARAMS_OPT).option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
     try {
       const id = parseUint(jobId, "jobId");
       const amount = parseUint(opts.amount, "amount");
+      const optParams = parseOptParams(opts.optParams);
       await ensureTrustSDK();
       const password3 = await resolvePassword(opts);
       const provider = await AgentWalletProvider.fromStorage(password3);
@@ -44153,16 +44253,16 @@ function registerErc8183Command(program3) {
         opts.chain
       );
       info(`Setting budget for job ${jobId} on ${chainKey}...`);
-      const pending = await commerce.write.setBudget([id, amount, "0x"], provider);
+      const pending = await commerce.write.setBudget([id, amount, optParams], provider);
       const confirmed = await pending.wait();
       success("Budget set!");
       output(
         {
           jobId,
           amount: opts.amount,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44171,37 +44271,53 @@ function registerErc8183Command(program3) {
     }
     safeExit();
   });
-  cmd.command("fund <jobId>").description("Fund a job: approve the budget then deposit it into escrow (two txs)").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
+  cmd.command("fund <jobId>").description("Fund a job: approve the budget then deposit it into escrow (two txs)").option(
+    "--expected-budget <atomic>",
+    "Pin the budget (atomic units): approve and fund exactly this amount instead of reading it on-chain; the contract reverts with BudgetMismatch if the on-chain budget differs"
+  ).option("--opt-params <hex>", OPT_PARAMS_OPT).option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
     try {
       const id = parseUint(jobId, "jobId");
+      const optParams = parseOptParams(opts.optParams);
       await ensureTrustSDK();
       const password3 = await resolvePassword(opts);
       const provider = await AgentWalletProvider.fromStorage(password3);
       const client = provider.getBlockchainClient();
       const { commerce, chainKey } = resolveErc8183Contracts(client, opts.chain);
-      const job = await commerce.read.getJob([id]);
-      if (job.budget === 0n) {
-        throw new WalletError(
-          "VALIDATION_ERROR",
-          `Job ${jobId} has no budget set \u2014 run \`twak erc8183 set-budget\` before funding.`
-        );
+      let budget;
+      if (opts.expectedBudget !== void 0) {
+        budget = parseUint(opts.expectedBudget, "expected-budget");
+        if (budget === 0n) {
+          throw new WalletError(
+            "VALIDATION_ERROR",
+            "--expected-budget must be greater than zero."
+          );
+        }
+      } else {
+        const job = await commerce.read.getJob([id]);
+        if (job.budget === 0n) {
+          throw new WalletError(
+            "VALIDATION_ERROR",
+            `Job ${jobId} has no budget set \u2014 run \`twak erc8183 set-budget\` before funding.`
+          );
+        }
+        budget = job.budget;
       }
       const token = await commerce.read.paymentToken([]);
-      info(`Approving ${job.budget.toString()} for the escrow on ${chainKey}...`);
-      const approvePending = await erc20.using(client).withAddress(token, chainKey).write.approve([commerce.address, job.budget], provider);
+      info(`Approving ${budget.toString()} for the escrow on ${chainKey}...`);
+      const approvePending = await erc20.using(client).withAddress(token, chainKey).write.approve([commerce.address, budget], provider);
       const approveConfirmed = await approvePending.wait();
       info(`Funding job ${jobId}...`);
-      const fundPending = await commerce.write.fund([id, job.budget, "0x"], provider);
+      const fundPending = await commerce.write.fund([id, budget, optParams], provider);
       const fundConfirmed = await fundPending.wait();
       success("Job funded!");
       output(
         {
           jobId,
           status: "Funded",
-          approveHash: approveConfirmed.txHash,
-          hash: fundConfirmed.txHash,
+          approveHash: approveConfirmed.hash,
+          hash: fundConfirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, fundConfirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, fundConfirmed.hash)
         },
         opts.json
       );
@@ -44210,9 +44326,10 @@ function registerErc8183Command(program3) {
     }
     safeExit();
   });
-  cmd.command("submit <jobId>").description("Submit a deliverable (bytes32 commitment) for a funded job").requiredOption("--deliverable <bytes32>", "0x-prefixed 32-byte deliverable commitment").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
+  cmd.command("submit <jobId>").description("Submit a deliverable (bytes32 commitment) for a funded job").requiredOption("--deliverable <bytes32>", "0x-prefixed 32-byte deliverable commitment").option("--opt-params <hex>", SUBMIT_OPT_PARAMS_OPT).option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
     try {
       const id = parseUint(jobId, "jobId");
+      const optParams = parseOptParams(opts.optParams);
       await ensureTrustSDK();
       const password3 = await resolvePassword(opts);
       const provider = await AgentWalletProvider.fromStorage(password3);
@@ -44221,16 +44338,16 @@ function registerErc8183Command(program3) {
         opts.chain
       );
       info(`Submitting deliverable for job ${jobId} on ${chainKey}...`);
-      const pending = await commerce.write.submit([id, opts.deliverable, "0x"], provider);
+      const pending = await commerce.write.submit([id, opts.deliverable, optParams], provider);
       const confirmed = await pending.wait();
       success("Deliverable submitted!");
       output(
         {
           jobId,
           status: "Submitted",
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44239,9 +44356,10 @@ function registerErc8183Command(program3) {
     }
     safeExit();
   });
-  cmd.command("complete <jobId>").description("Mark a submitted job complete (evaluator) \u2014 releases escrow").option("--reason <bytes32>", "Optional bytes32 attestation (defaults to zero)").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
+  cmd.command("complete <jobId>").description("Mark a submitted job complete (evaluator) \u2014 releases escrow").option("--reason <bytes32>", "Optional bytes32 attestation (defaults to zero)").option("--opt-params <hex>", OPT_PARAMS_OPT).option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
     try {
       const id = parseUint(jobId, "jobId");
+      const optParams = parseOptParams(opts.optParams);
       await ensureTrustSDK();
       const password3 = await resolvePassword(opts);
       const provider = await AgentWalletProvider.fromStorage(password3);
@@ -44251,7 +44369,7 @@ function registerErc8183Command(program3) {
       );
       info(`Completing job ${jobId} on ${chainKey}...`);
       const pending = await commerce.write.complete(
-        [id, opts.reason ?? ZERO_BYTES32, "0x"],
+        [id, opts.reason ?? ZERO_BYTES32, optParams],
         provider
       );
       const confirmed = await pending.wait();
@@ -44262,9 +44380,9 @@ function registerErc8183Command(program3) {
           jobId,
           status: "Completed",
           released: released ? released.amount.toString() : null,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44273,9 +44391,10 @@ function registerErc8183Command(program3) {
     }
     safeExit();
   });
-  cmd.command("reject <jobId>").description("Reject a job \u2014 refunds the client if funded").option("--reason <bytes32>", "Optional bytes32 reason (defaults to zero)").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
+  cmd.command("reject <jobId>").description("Reject a job \u2014 refunds the client if funded").option("--reason <bytes32>", "Optional bytes32 reason (defaults to zero)").option("--opt-params <hex>", OPT_PARAMS_OPT).option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
     try {
       const id = parseUint(jobId, "jobId");
+      const optParams = parseOptParams(opts.optParams);
       await ensureTrustSDK();
       const password3 = await resolvePassword(opts);
       const provider = await AgentWalletProvider.fromStorage(password3);
@@ -44285,7 +44404,7 @@ function registerErc8183Command(program3) {
       );
       info(`Rejecting job ${jobId} on ${chainKey}...`);
       const pending = await commerce.write.reject(
-        [id, opts.reason ?? ZERO_BYTES32, "0x"],
+        [id, opts.reason ?? ZERO_BYTES32, optParams],
         provider
       );
       const confirmed = await pending.wait();
@@ -44296,9 +44415,9 @@ function registerErc8183Command(program3) {
           jobId,
           status: "Rejected",
           refunded: refunded ? refunded.amount.toString() : null,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44327,9 +44446,9 @@ function registerErc8183Command(program3) {
           jobId,
           status: "Expired",
           refunded: refunded ? refunded.amount.toString() : null,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44389,9 +44508,9 @@ function registerErc8183Command(program3) {
         {
           jobId,
           policy: policyAddr,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44417,9 +44536,9 @@ function registerErc8183Command(program3) {
       output(
         {
           jobId,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44446,9 +44565,9 @@ function registerErc8183Command(program3) {
         {
           jobId,
           status: "Expired",
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44457,6 +44576,45 @@ function registerErc8183Command(program3) {
     }
     safeExit();
   });
+  cmd.command("policy-info <jobId>").description("Show dispute-policy state for a job (read-only)").option("--chain <key>", CHAIN_OPT, "bsc").option("--json", "JSON output").action(async (jobId, opts) => {
+    try {
+      const id = parseUint(jobId, "jobId");
+      await ensureTrustSDK();
+      const client = new BlockchainClient();
+      const { router, policy, chainKey } = resolveErc8183Contracts(client, opts.chain);
+      const registeredPolicy = await router.read.jobPolicy([id]);
+      const registered = !isZeroAddress(registeredPolicy);
+      const policyContract = registered && registeredPolicy.toLowerCase() !== policy.address.toLowerCase() ? erc8183Policy.using(client).withAddress(registeredPolicy, chainKey) : policy;
+      const [disputeWindow, submittedAt, disputed, rejectVotes, voteQuorum, quorumSnapshot] = await Promise.all([
+        policyContract.read.disputeWindow([]),
+        policyContract.read.submittedAt([id]),
+        policyContract.read.disputed([id]),
+        policyContract.read.rejectVotes([id]),
+        policyContract.read.voteQuorum([]),
+        policyContract.read.disputeQuorumSnapshot([id])
+      ]);
+      const settleableAt = submittedAt > 0n ? submittedAt + disputeWindow : null;
+      output(
+        {
+          jobId,
+          policy: policyContract.address,
+          registered,
+          disputeWindow: disputeWindow.toString(),
+          submittedAt: submittedAt.toString(),
+          disputed,
+          rejectVotes: rejectVotes.toString(),
+          voteQuorum: voteQuorum.toString(),
+          quorumSnapshot: quorumSnapshot.toString(),
+          settleableAt: settleableAt?.toString() ?? null,
+          chain: chainKey
+        },
+        opts.json
+      );
+    } catch (err) {
+      handleCommandError(err, opts.json, "policy-info failed");
+    }
+    safeExit();
+  });
   cmd.command("dispute <jobId>").description("Raise a dispute on a job via the OptimisticPolicy (client)").option("--chain <key>", CHAIN_OPT, "bsc").option("--password <password>", "Wallet password").option("--json", "JSON output").action(async (jobId, opts) => {
     try {
       const id = parseUint(jobId, "jobId");
@@ -44474,9 +44632,9 @@ function registerErc8183Command(program3) {
       output(
         {
           jobId,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44502,9 +44660,9 @@ function registerErc8183Command(program3) {
       output(
         {
           jobId,
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -44570,7 +44728,7 @@ function registerCompeteCommand(program3) {
       if (!confirmed.events.Registered?.[0]) {
         throw new WalletError(
           "TX_FAILED",
-          `no Registered event emitted (txHash=${confirmed.txHash})`
+          `no Registered event emitted (hash=${confirmed.hash})`
         );
       }
       success("Registered for BNB HACK: AI TRADING AGENT EDITION!");
@@ -44579,9 +44737,9 @@ function registerCompeteCommand(program3) {
           registered: true,
           participant,
           deadline: toIso(deadline),
-          hash: confirmed.txHash,
+          hash: confirmed.hash,
           chain: chainKey,
-          explorer: getExplorerTxUrl(chainKey, confirmed.txHash)
+          explorer: getExplorerTxUrl(chainKey, confirmed.hash)
         },
         opts.json
       );
@@ -46259,15 +46417,15 @@ async function ensurePermit2Allowance(args) {
     [PERMIT2_ADDRESS, BigInt(MAX_UINT256_DECIMAL)],
     args.walletProvider
   );
-  await waitForTxConfirmation(args.blockchainClient, args.chainKey, args.owner, pending.txHash);
-  return { token: args.tokenAddress, chain: args.chainKey, txHash: pending.txHash };
+  await waitForTxConfirmation(args.blockchainClient, args.chainKey, args.owner, pending.hash);
+  return { token: args.tokenAddress, chain: args.chainKey, hash: pending.hash };
 }
 var APPROVE_TIMEOUT_MS = 6e4;
 var APPROVE_POLL_MS = 2e3;
-async function waitForTxConfirmation(bc2, chainKey, address, txHash) {
+async function waitForTxConfirmation(bc2, chainKey, address, hash) {
   const start = Date.now();
   while (Date.now() - start < APPROVE_TIMEOUT_MS) {
-    const status = await bc2.findTransactionStatus(chainKey, address, txHash);
+    const status = await bc2.findTransactionStatus(chainKey, address, hash);
     if (status.confirmed) return;
     if (status.failed) {
       throw new X402Error(
@@ -46279,7 +46437,7 @@ async function waitForTxConfirmation(bc2, chainKey, address, txHash) {
   }
   throw new X402Error(
     "TX_FAILED",
-    `Permit2 approval ${txHash} not confirmed within ${APPROVE_TIMEOUT_MS / 1e3}s`
+    `Permit2 approval ${hash} not confirmed within ${APPROVE_TIMEOUT_MS / 1e3}s`
   );
 }
 function ipv4MappedToDotted(ip) {
@@ -46796,7 +46954,7 @@ var TransferActionProvider = class extends ActionProvider {
         const resolvedTo = await resolveAddressOrName(input2.to);
         const atomicAmount = parseAmount(input2.amount, decimals);
         const isErc20 = Boolean(tokenAddress);
-        let txHash;
+        let hash;
         if (isErc20) {
           if (!this.blockchainClient) {
             throw new TransferError(
@@ -46805,19 +46963,19 @@ var TransferActionProvider = class extends ActionProvider {
             );
           }
           const pending = await this.blockchainClient.contract(erc20).withAddress(tokenAddress, chainKey).write.transfer([resolvedTo, BigInt(atomicAmount)], signer);
-          txHash = pending.txHash;
+          hash = pending.hash;
         } else {
-          txHash = await signer.sendTransaction({
+          hash = await signer.sendTransaction({
             chainId: caip2,
             to: resolvedTo,
             data: "0x",
             value: "0x" + BigInt(atomicAmount).toString(16)
           });
         }
-        const explorerUrl = getExplorerTxUrl(chainKey, txHash);
+        const explorerUrl = getExplorerTxUrl(chainKey, hash);
         return {
           success: true,
-          txHash,
+          hash,
           to: resolvedTo,
           resolvedFrom: input2.to !== resolvedTo ? input2.to : void 0,
           explorer: explorerUrl || void 0
@@ -46902,7 +47060,7 @@ var SwapActionProvider = class extends ActionProvider {
         const outputAmt = formatAmount(lastStep.to.amount, lastStep.to.asset.metadata.decimals);
         return {
           success: true,
-          txHash: result.txHash,
+          hash: result.hash,
           summary: `${inputAmt} ${firstStep.from.asset.metadata.symbol} -> ${outputAmt} ${lastStep.to.asset.metadata.symbol}`,
           provider: result.route.steps.map((s2) => s2.provider.name).join(" -> "),
           explorer: result.explorerUrl || void 0
@@ -47364,7 +47522,7 @@ var TokenActionProvider = class extends ActionProvider {
             hdWallet,
             chainKey
           });
-          return { hash: result.txHash, chain: result.chainKey };
+          return { hash: result.hash, chain: result.chainKey };
         }
         const chain2 = requireChain(chainKey);
         if (chain2.namespace !== "eip155") {
@@ -47376,24 +47534,24 @@ var TokenActionProvider = class extends ActionProvider {
         if (input2.tokenAddress) assertEvmAddress(input2.tokenAddress, "tokenAddress");
         const caipChainId = `${chain2.namespace}:${chain2.chainId}`;
         const atomicAmount = parseAmount(input2.amount, decimals);
-        let txHash;
+        let hash;
         if (input2.tokenAddress) {
           if (!this.blockchainClient) {
             throw new WalletError("WALLET_NOT_FOUND", "BlockchainClient not available");
           }
           const pending = await this.blockchainClient.contract(erc20).withAddress(input2.tokenAddress, chainKey).write.transfer([input2.to, BigInt(atomicAmount)], wallet);
-          txHash = pending.txHash;
+          hash = pending.hash;
         } else {
           assertEvmAddress(input2.to, "to");
           const valueHex = "0x" + BigInt(atomicAmount).toString(16);
-          txHash = await wallet.sendTransaction({
+          hash = await wallet.sendTransaction({
             chainId: caipChainId,
             to: input2.to,
             data: "0x",
             value: valueHex
           });
         }
-        return { hash: txHash, chain: chainKey };
+        return { hash, chain: chainKey };
       }
     };
   }
@@ -47424,7 +47582,7 @@ var TokenActionProvider = class extends ActionProvider {
         }
         const amount = input2.amount === "unlimited" ? "115792089237316195423570985008687907853269984665640564039457584007913129639935" : input2.amount;
         const pending = await this.blockchainClient.contract(erc20).withAddress(input2.tokenAddress, chainKey).write.approve([input2.spender, BigInt(amount)], wallet);
-        return { hash: pending.txHash, chain: chainKey };
+        return { hash: pending.hash, chain: chainKey };
       }
     };
   }
@@ -47453,7 +47611,7 @@ var TokenActionProvider = class extends ActionProvider {
           throw new WalletError("WALLET_NOT_FOUND", "BlockchainClient not available");
         }
         const pending = await this.blockchainClient.contract(erc20).withAddress(input2.tokenAddress, chainKey).write.approve([input2.spender, 0n], wallet);
-        return { hash: pending.txHash, chain: chainKey };
+        return { hash: pending.hash, chain: chainKey };
       }
     };
   }
@@ -47923,7 +48081,7 @@ var OnrampActionProvider = class extends ActionProvider {
           if (cap) return { success: false, ...cap };
         }
         const atomic = parseAmount(input2.cryptoAmount, decimals);
-        let txHash;
+        let hash;
         if (input2.tokenAddress) {
           if (!this.blockchainClient) {
             throw new TransferError(
@@ -47932,19 +48090,19 @@ var OnrampActionProvider = class extends ActionProvider {
             );
           }
           const pending = await this.blockchainClient.contract(erc20).withAddress(input2.tokenAddress, chainKey).write.transfer([input2.depositAddress, BigInt(atomic)], signer);
-          txHash = pending.txHash;
+          hash = pending.hash;
         } else {
-          txHash = await signer.sendTransaction({
+          hash = await signer.sendTransaction({
             chainId: caip2,
             to: input2.depositAddress,
             data: "0x",
             value: "0x" + BigInt(atomic).toString(16)
           });
         }
-        const explorerUrl = getExplorerTxUrl(chainKey, txHash) || void 0;
+        const explorerUrl = getExplorerTxUrl(chainKey, hash) || void 0;
         return {
           success: true,
-          txHash,
+          hash,
           chain: chainKey,
           tokenAddress: input2.tokenAddress,
           to: input2.depositAddress,
@@ -48114,7 +48272,7 @@ var AutomateActionProvider = class extends ActionProvider {
         await this.automationStore.update(record2.id, { lastRunAt: (/* @__PURE__ */ new Date()).toISOString() });
         return {
           success: true,
-          txHash: result.txHash,
+          hash: result.hash,
           automationId: record2.id,
           swapped: `${record2.amount} ${record2.fromToken} \u2192 ${record2.toToken}`,
           explorer: result.explorerUrl || void 0
@@ -48330,13 +48488,13 @@ var Erc8004ActionProvider = class extends ActionProvider {
         if (!registered) {
           throw new WalletError(
             "TX_FAILED",
-            `erc8004_register: no Registered event emitted (txHash=${confirmed.txHash})`
+            `erc8004_register: no Registered event emitted (hash=${confirmed.hash})`
           );
         }
         return {
           success: true,
           agentId: registered.agentId.toString(),
-          txHash: confirmed.txHash,
+          hash: confirmed.hash,
           owner: registered.owner,
           agentURI: registered.agentURI,
           ...entries.length > 0 ? { metadata: Object.fromEntries(entries) } : {},
@@ -48363,7 +48521,7 @@ var Erc8004ActionProvider = class extends ActionProvider {
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
@@ -48387,7 +48545,7 @@ var Erc8004ActionProvider = class extends ActionProvider {
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
@@ -48453,6 +48611,7 @@ var jobIdSchema = import_zod17.z.string().regex(/^\d+$/, "jobId must be a decima
 var amountSchema = import_zod17.z.string().regex(/^\d+$/, "amount must be an atomic (base-unit) integer string.");
 var evmAddressSchema = import_zod17.z.string().refine(isEvmAddress, "must be a 0x-prefixed 40-hex EVM address.");
 var bytes32Schema = import_zod17.z.string().regex(/^0x[0-9a-fA-F]{64}$/, "must be 0x-prefixed 32-byte hex.");
+var optParamsSchema = import_zod17.z.string().regex(/^0x([0-9a-fA-F]{2})*$/, "optParams must be 0x-prefixed bytes.").optional().describe("Optional opaque optParams bytes forwarded raw to the contract (defaults to empty).");
 var ZERO_BYTES322 = `0x${"0".repeat(64)}`;
 var Erc8183ActionProvider = class extends ActionProvider {
   constructor(blockchainClient, walletContext) {
@@ -48473,6 +48632,7 @@ var Erc8183ActionProvider = class extends ActionProvider {
       this.reject(),
       this.claimRefund(),
       this.status(),
+      this.policyInfo(),
       this.registerJob(),
       this.settle(),
       this.markExpired(),
@@ -48514,13 +48674,13 @@ var Erc8183ActionProvider = class extends ActionProvider {
         if (!created) {
           throw new WalletError(
             "TX_FAILED",
-            `erc8183_create_job: no JobCreated event emitted (txHash=${confirmed.txHash})`
+            `erc8183_create_job: no JobCreated event emitted (hash=${confirmed.hash})`
           );
         }
         return {
           success: true,
           jobId: created.jobId.toString(),
-          txHash: confirmed.txHash,
+          hash: confirmed.hash,
           status: "Open",
           chain: chainKey
         };
@@ -48534,16 +48694,17 @@ var Erc8183ActionProvider = class extends ActionProvider {
       schema: import_zod17.z.object({
         jobId: jobIdSchema,
         provider: evmAddressSchema.describe("New provider (worker) address."),
+        optParams: optParamsSchema,
         chain: import_zod17.z.string().default("bsc").describe(CHAIN_DESC)
       }),
       invoke: async (_ctx, input2) => {
         const { commerce, chainKey } = this.bind(input2.chain);
         const pending = await commerce.write.setProvider(
-          [BigInt(input2.jobId), input2.provider, "0x"],
+          [BigInt(input2.jobId), input2.provider, input2.optParams ?? "0x"],
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
@@ -48554,47 +48715,64 @@ var Erc8183ActionProvider = class extends ActionProvider {
       schema: import_zod17.z.object({
         jobId: jobIdSchema,
         amount: amountSchema.describe("Budget in atomic units of the payment token."),
+        optParams: optParamsSchema,
         chain: import_zod17.z.string().default("bsc").describe(CHAIN_DESC)
       }),
       invoke: async (_ctx, input2) => {
         const { commerce, chainKey } = this.bind(input2.chain);
         const pending = await commerce.write.setBudget(
-          [BigInt(input2.jobId), BigInt(input2.amount), "0x"],
+          [BigInt(input2.jobId), BigInt(input2.amount), input2.optParams ?? "0x"],
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
   fund() {
     return {
       name: "erc8183_fund",
-      description: "Fund a job: deposits the on-chain budget into escrow. The escrow pulls the payment token via transferFrom, so this first sends an ERC-20 approval for the exact budget, then calls fund \u2014 two transactions. Moves the job to `Funded`.",
+      description: "Fund a job: deposits the on-chain budget into escrow. The escrow pulls the payment token via transferFrom, so this first sends an ERC-20 approval for the exact budget, then calls fund \u2014 two transactions. Moves the job to `Funded`. Pass `expectedBudget` to pin the amount instead of reading it on-chain.",
       schema: import_zod17.z.object({
         jobId: jobIdSchema,
+        expectedBudget: amountSchema.optional().describe(
+          "Pin the budget (atomic units): approve and fund exactly this amount instead of reading it on-chain. The contract reverts (BudgetMismatch) if the on-chain budget differs."
+        ),
+        optParams: optParamsSchema,
         chain: import_zod17.z.string().default("bsc").describe(CHAIN_DESC)
       }),
       invoke: async (_ctx, input2) => {
         const { client, commerce, chainKey } = this.bind(input2.chain);
         const jobId = BigInt(input2.jobId);
-        const job = await commerce.read.getJob([jobId]);
-        if (job.budget === 0n) {
-          throw new WalletError(
-            "VALIDATION_ERROR",
-            `Job ${input2.jobId} has no budget set \u2014 call erc8183_set_budget before funding.`
-          );
+        let budget;
+        if (input2.expectedBudget !== void 0) {
+          budget = BigInt(input2.expectedBudget);
+          if (budget === 0n) {
+            throw new WalletError("VALIDATION_ERROR", "expectedBudget must be greater than zero.");
+          }
+        } else {
+          const job = await commerce.read.getJob([jobId]);
+          if (job.budget === 0n) {
+            throw new WalletError(
+              "VALIDATION_ERROR",
+              `Job ${input2.jobId} has no budget set \u2014 call erc8183_set_budget before funding.`
+            );
+          }
+          budget = job.budget;
         }
         const token = await commerce.read.paymentToken([]);
         const wallet = this.walletContext.activeWallet();
-        const approvePending = await erc20.using(client).withAddress(token, chainKey).write.approve([commerce.address, job.budget], wallet);
+        const approvePending = await erc20.using(client).withAddress(token, chainKey).write.approve([commerce.address, budget], wallet);
         const approveConfirmed = await approvePending.wait();
-        const fundPending = await commerce.write.fund([jobId, job.budget, "0x"], wallet);
+        const fundPending = await commerce.write.fund(
+          [jobId, budget, input2.optParams ?? "0x"],
+          wallet
+        );
         const fundConfirmed = await fundPending.wait();
         return {
           success: true,
-          approveHash: approveConfirmed.txHash,
-          txHash: fundConfirmed.txHash,
+          approveHash: approveConfirmed.hash,
+          hash: fundConfirmed.hash,
           status: "Funded",
           chain: chainKey
         };
@@ -48610,16 +48788,19 @@ var Erc8183ActionProvider = class extends ActionProvider {
         deliverable: bytes32Schema.describe(
           "bytes32 deliverable commitment (e.g. a content hash)."
         ),
+        optParams: optParamsSchema.describe(
+          'Optional opaque optParams bytes forwarded raw to the contract (defaults to empty). Evaluators may expect deliverable metadata here, e.g. hex-encoded UTF-8 JSON like {"deliverable_url": "..."}.'
+        ),
         chain: import_zod17.z.string().default("bsc").describe(CHAIN_DESC)
       }),
       invoke: async (_ctx, input2) => {
         const { commerce, chainKey } = this.bind(input2.chain);
         const pending = await commerce.write.submit(
-          [BigInt(input2.jobId), input2.deliverable, "0x"],
+          [BigInt(input2.jobId), input2.deliverable, input2.optParams ?? "0x"],
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, status: "Submitted", chain: chainKey };
+        return { success: true, hash: confirmed.hash, status: "Submitted", chain: chainKey };
       }
     };
   }
@@ -48630,19 +48811,20 @@ var Erc8183ActionProvider = class extends ActionProvider {
       schema: import_zod17.z.object({
         jobId: jobIdSchema,
         reason: bytes32Schema.optional().describe("Optional bytes32 reason/attestation (defaults to zero)."),
+        optParams: optParamsSchema,
         chain: import_zod17.z.string().default("bsc").describe(CHAIN_DESC)
       }),
       invoke: async (_ctx, input2) => {
         const { commerce, chainKey } = this.bind(input2.chain);
         const pending = await commerce.write.complete(
-          [BigInt(input2.jobId), input2.reason ?? ZERO_BYTES322, "0x"],
+          [BigInt(input2.jobId), input2.reason ?? ZERO_BYTES322, input2.optParams ?? "0x"],
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
         const released = confirmed.events.PaymentReleased?.[0];
         return {
           success: true,
-          txHash: confirmed.txHash,
+          hash: confirmed.hash,
           status: "Completed",
           released: released ? released.amount.toString() : null,
           chain: chainKey
@@ -48657,19 +48839,20 @@ var Erc8183ActionProvider = class extends ActionProvider {
       schema: import_zod17.z.object({
         jobId: jobIdSchema,
         reason: bytes32Schema.optional().describe("Optional bytes32 reason (defaults to zero)."),
+        optParams: optParamsSchema,
         chain: import_zod17.z.string().default("bsc").describe(CHAIN_DESC)
       }),
       invoke: async (_ctx, input2) => {
         const { commerce, chainKey } = this.bind(input2.chain);
         const pending = await commerce.write.reject(
-          [BigInt(input2.jobId), input2.reason ?? ZERO_BYTES322, "0x"],
+          [BigInt(input2.jobId), input2.reason ?? ZERO_BYTES322, input2.optParams ?? "0x"],
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
         const refunded = confirmed.events.Refunded?.[0];
         return {
           success: true,
-          txHash: confirmed.txHash,
+          hash: confirmed.hash,
           status: "Rejected",
           refunded: refunded ? refunded.amount.toString() : null,
           chain: chainKey
@@ -48695,7 +48878,7 @@ var Erc8183ActionProvider = class extends ActionProvider {
         const refunded = confirmed.events.Refunded?.[0];
         return {
           success: true,
-          txHash: confirmed.txHash,
+          hash: confirmed.hash,
           status: "Expired",
           refunded: refunded ? refunded.amount.toString() : null,
           chain: chainKey
@@ -48737,6 +48920,46 @@ var Erc8183ActionProvider = class extends ActionProvider {
       }
     };
   }
+  policyInfo() {
+    return {
+      name: "erc8183_policy_info",
+      description: "Read the dispute-policy state of a job: the registered policy address, dispute window, submission time, dispute/vote tallies, and when the job becomes settleable (submittedAt + disputeWindow). Use before `erc8183_settle` to check timing, and before `erc8183_dispute`/`erc8183_vote_reject` to avoid opaque reverts.",
+      schema: import_zod17.z.object({
+        jobId: jobIdSchema,
+        chain: import_zod17.z.string().default("bsc").describe(CHAIN_DESC)
+      }),
+      invoke: async (_ctx, input2) => {
+        const { client, router, policy, chainKey } = this.bind(input2.chain);
+        const jobId = BigInt(input2.jobId);
+        const registeredPolicy = await router.read.jobPolicy([jobId]);
+        const registered = !isZeroAddress(registeredPolicy);
+        const policyContract = registered && registeredPolicy.toLowerCase() !== policy.address.toLowerCase() ? erc8183Policy.using(client).withAddress(registeredPolicy, chainKey) : policy;
+        const [disputeWindow, submittedAt, disputed, rejectVotes, voteQuorum, quorumSnapshot] = await Promise.all([
+          policyContract.read.disputeWindow([]),
+          policyContract.read.submittedAt([jobId]),
+          policyContract.read.disputed([jobId]),
+          policyContract.read.rejectVotes([jobId]),
+          policyContract.read.voteQuorum([]),
+          policyContract.read.disputeQuorumSnapshot([jobId])
+        ]);
+        const settleableAt = submittedAt > 0n ? submittedAt + disputeWindow : null;
+        return {
+          success: true,
+          jobId: input2.jobId,
+          policy: policyContract.address,
+          registered,
+          disputeWindow: disputeWindow.toString(),
+          submittedAt: submittedAt.toString(),
+          disputed,
+          rejectVotes: rejectVotes.toString(),
+          voteQuorum: voteQuorum.toString(),
+          quorumSnapshot: quorumSnapshot.toString(),
+          settleableAt: settleableAt?.toString() ?? null,
+          chain: chainKey
+        };
+      }
+    };
+  }
   // ----- Router -------------------------------------------------------------
   registerJob() {
     return {
@@ -48754,7 +48977,7 @@ var Erc8183ActionProvider = class extends ActionProvider {
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
@@ -48774,7 +48997,7 @@ var Erc8183ActionProvider = class extends ActionProvider {
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
@@ -48793,7 +49016,7 @@ var Erc8183ActionProvider = class extends ActionProvider {
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, status: "Expired", chain: chainKey };
+        return { success: true, hash: confirmed.hash, status: "Expired", chain: chainKey };
       }
     };
   }
@@ -48813,7 +49036,7 @@ var Erc8183ActionProvider = class extends ActionProvider {
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
@@ -48832,7 +49055,7 @@ var Erc8183ActionProvider = class extends ActionProvider {
           this.walletContext.activeWallet()
         );
         const confirmed = await pending.wait();
-        return { success: true, txHash: confirmed.txHash, chain: chainKey };
+        return { success: true, hash: confirmed.hash, chain: chainKey };
       }
     };
   }
@@ -48903,14 +49126,14 @@ var CompetitionActionProvider = class extends ActionProvider {
         if (!confirmed.events.Registered?.[0]) {
           throw new WalletError(
             "TX_FAILED",
-            `competition_register: no Registered event emitted (txHash=${confirmed.txHash})`
+            `competition_register: no Registered event emitted (hash=${confirmed.hash})`
           );
         }
         return {
           success: true,
           registered: true,
           participant,
-          txHash: confirmed.txHash,
+          hash: confirmed.hash,
           deadline: toIso2(deadline),
           chain: CHAIN
         };
@@ -53915,7 +54138,7 @@ async function runAutomationsTick(deps) {
             runCount: (auto.runCount ?? 0) + 1
           });
           log("info", `DCA executed: ${res.explorerUrl}`);
-          result.executed.push({ id: auto.id, type: "dca", txHash: res.txHash });
+          result.executed.push({ id: auto.id, type: "dca", hash: res.hash });
         } else {
           log("warn", `DCA ${auto.id} failed: ${res.error}`);
           result.errors++;
@@ -53963,7 +54186,7 @@ async function runAutomationsTick(deps) {
             lastRunAt: (/* @__PURE__ */ new Date()).toISOString()
           });
           log("info", `Limit order executed: ${res.explorerUrl}`);
-          result.executed.push({ id: auto.id, type: "limit", txHash: res.txHash });
+          result.executed.push({ id: auto.id, type: "limit", hash: res.hash });
         } else {
           log("warn", `Limit order ${auto.id} failed: ${res.error}`);
           result.errors++;
@@ -54519,7 +54742,7 @@ ${url}`);
       } catch (err) {
         mapBroadcastError(err);
       }
-      const explorerUrl = getExplorerTxUrl(result.chainKey, result.txHash);
+      const explorerUrl = getExplorerTxUrl(result.chainKey, result.hash);
       success("Off-ramp payout broadcast!");
       if (!opts.json) {
         info(
@@ -54528,7 +54751,7 @@ ${url}`);
       }
       output(
         {
-          hash: result.txHash,
+          hash: result.hash,
           chain: result.chainKey,
           from: address,
           to: opts.to,
@@ -54913,7 +55136,7 @@ function registerX402Command(program3) {
         confirmApproval: opts.autoApprove ? autoApproveConfirm : makeReadlineApprovalConfirm()
       });
       if (approval) {
-        info(`x402: Permit2 approved (one-time): tx ${approval.txHash}`);
+        info(`x402: Permit2 approved (one-time): tx ${approval.hash}`);
       }
       if (payment) {
         info(
@@ -55028,7 +55251,7 @@ var crypto7 = __toESM(require("crypto"));
 // package.json
 var package_default = {
   name: "@trustwallet/cli",
-  version: "0.18.0",
+  version: "0.19.0",
   description: "TWAK CLI \u2014 command-line interface for Trust Wallet Agent Kit",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -55404,7 +55627,7 @@ function registerWatchCommand(program3) {
                 tickResults.automations.executed.push({
                   id: auto.id,
                   type: "dca",
-                  txHash: result.txHash,
+                  hash: result.hash,
                   explorer: result.explorerUrl
                 });
               } else {
@@ -55472,7 +55695,7 @@ function registerWatchCommand(program3) {
                 tickResults.automations.executed.push({
                   id: auto.id,
                   type: "limit",
-                  txHash: result.txHash,
+                  hash: result.hash,
                   explorer: result.explorerUrl
                 });
               } else {