@dev.sail.money/sailor 1.4.0-244 → 1.4.0-246

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.sail.money/sailor",
-  "version": "1.4.0-244",
+  "version": "1.4.0-246",
   "description": "Operator toolkit for Sail Protocol",
   "repository": {
     "type": "git",

package/packages/cli/dist/index.cjs

@@ -35214,6 +35214,9 @@ var {
 var CREATE2_KERNEL = "0x38b508756c976e876EFF05a29E731A4d348BA6ED";
 var CREATE2_MANDATE_FACTORY = "0x6d2C802ffa0d9A8Ed69A5Bf22c1b63ccB566B8Fc";
 var CREATE2_GOVERNANCE = "0x4315B37cA4A315A7042af1Fcb37F8436f4D24356";
+var ETH = { name: "Ether", symbol: "ETH", decimals: 18 };
+var BNB = { name: "BNB", symbol: "BNB", decimals: 18 };
+var HYPE = { name: "HYPE", symbol: "HYPE", decimals: 18 };
 var chains = {
   // Ethereum mainnet
   1: {
@@ -35225,7 +35228,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Base mainnet
   8453: {
@@ -35237,7 +35241,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Arbitrum mainnet
   42161: {
@@ -35249,7 +35254,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Optimism mainnet
   10: {
@@ -35261,7 +35267,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Unichain mainnet
   130: {
@@ -35273,9 +35280,10 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
-  // BSC mainnet
+  // BSC mainnet — native gas token is BNB, not ETH.
   56: {
     chainId: 56,
     name: "BSC",
@@ -35285,7 +35293,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: BNB
   },
   // World Chain mainnet
   480: {
@@ -35297,9 +35306,10 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
-  // HyperEVM mainnet
+  // HyperEVM mainnet — native gas token is HYPE, not ETH.
   999: {
     chainId: 999,
     name: "HyperEVM",
@@ -35309,7 +35319,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: HYPE
   },
   // MegaETH mainnet
   4326: {
@@ -35321,7 +35332,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Base Sepolia (testnet)
   84532: {
@@ -35333,7 +35345,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Eth Sepolia (testnet)
   11155111: {
@@ -35345,7 +35358,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   }
 };
 function getChain(chainId) {
@@ -35356,6 +35370,9 @@ function getChain(chainId) {
   return config;
 }
 var defaultRpcUrls = Object.fromEntries(Object.values(chains).map((c) => [c.chainId, c.defaultRpcUrl]));
+function getNativeCurrencySymbol(chainId) {
+  return chains[chainId]?.nativeCurrency.symbol ?? "ETH";
+}
 
 // ../sdk/dist/client.js
 init_esm2();
@@ -38155,13 +38172,13 @@ async function estimateMandateRegistrationFee(publicClient, governance, permissi
   const totalWei = flatFeeWei * BigInt(permissions.length);
   return { totalWei, perPermission };
 }
-function describeMandateFee(estimate) {
+function describeMandateFee(estimate, symbol = "ETH") {
   const count = estimate.perPermission.length;
   if (count === 0)
-    return "Registration fee: 0 ETH (no new permissions to register)";
+    return `Registration fee: 0 ${symbol} (no new permissions to register)`;
   const noun = count === 1 ? "permission" : "permissions";
   const perFeeWei = estimate.perPermission[0].feeWei;
-  return `Registration fee: ${formatEther(estimate.totalWei)} ETH (${count} ${noun} \xD7 ${formatEther(perFeeWei)} ETH)`;
+  return `Registration fee: ${formatEther(estimate.totalWei)} ${symbol} (${count} ${noun} \xD7 ${formatEther(perFeeWei)} ${symbol})`;
 }
 var RegistrationFeeError = class extends Error {
   /** Total fee required (wei). */
@@ -38175,9 +38192,9 @@ var RegistrationFeeError = class extends Error {
     this.balanceWei = balanceWei;
   }
 };
-function assertFeeAffordable(balanceWei, totalFeeWei) {
+function assertFeeAffordable(balanceWei, totalFeeWei, symbol = "ETH") {
   if (balanceWei < totalFeeWei) {
-    throw new RegistrationFeeError(`Insufficient ETH for the ${formatEther(totalFeeWei)} ETH registration fee; signer balance is ${formatEther(balanceWei)} ETH.`, totalFeeWei, balanceWei);
+    throw new RegistrationFeeError(`Insufficient ${symbol} for the ${formatEther(totalFeeWei)} ${symbol} registration fee; signer balance is ${formatEther(balanceWei)} ${symbol}.`, totalFeeWei, balanceWei);
   }
 }
 
@@ -41973,14 +41990,15 @@ init_esm2();
 
 // src/lib/registration-fee.ts
 function registrationGate(args) {
-  const { estimate, agentBalanceWei } = args;
+  const { estimate, agentBalanceWei, chainId } = args;
+  const symbol = chainId !== void 0 ? getNativeCurrencySymbol(chainId) : "ETH";
   if (agentBalanceWei !== void 0) {
-    assertFeeAffordable(agentBalanceWei, estimate.totalWei);
+    assertFeeAffordable(agentBalanceWei, estimate.totalWei, symbol);
   }
   return {
     totalFeeWei: estimate.totalWei,
     permissionCount: estimate.perPermission.length,
-    disclosure: describeMandateFee(estimate)
+    disclosure: describeMandateFee(estimate, symbol)
   };
 }
 
@@ -42372,7 +42390,7 @@ async function attachMandate(project, channel, publicClient, agentSigner, smaAdd
   const agentBalanceWei = await publicClient.getBalance({
     address: agentSigner.viemAccount.address
   });
-  const gate = registrationGate({ estimate: feeEstimate, agentBalanceWei });
+  const gate = registrationGate({ estimate: feeEstimate, agentBalanceWei, chainId: project.chainId });
   say(() => console.log(gate.disclosure));
   say(() => console.log(`
 Pushing signing request for "${template.label}" permission\u2026`));
@@ -42401,7 +42419,8 @@ Pushing signing request for "${template.label}" permission\u2026`));
     // fee to disclose (zero-fee chains pass 0 ETH, still informative).
     registrationFee: {
       totalEth: formatEther(fee),
-      permissionCount: 1
+      permissionCount: 1,
+      symbol: getNativeCurrencySymbol(project.chainId)
     },
     typedData
   });
@@ -42481,7 +42500,8 @@ Connect the owner wallet (mandate signer) in the browser \u2014 the agent wallet
     chainId: project.chainId,
     // Registration fee actually paid by the agent for this permission.
     fee: fee.toString(),
-    feeEth: formatEther(fee)
+    feeEth: formatEther(fee),
+    feeSymbol: getNativeCurrencySymbol(project.chainId)
   });
   return txHash;
 }
@@ -42928,7 +42948,8 @@ ${spec.label} clone (${options.template})`);
     ],
     registrationFee: {
       totalEth: formatEther(fee),
-      permissionCount: 1
+      permissionCount: 1,
+      symbol: getNativeCurrencySymbol(project.chainId)
     },
     typedData
   });
@@ -43011,7 +43032,8 @@ Connect the owner wallet (mandate signer) in the browser \u2014 the agent wallet
     chainId: project.chainId,
     // Registration fee actually paid by the agent for this permission.
     fee: fee.toString(),
-    feeEth: formatEther(fee)
+    feeEth: formatEther(fee),
+    feeSymbol: getNativeCurrencySymbol(project.chainId)
   });
   emit(json, () => {
   }, {
@@ -43361,7 +43383,8 @@ Attaching ${permissions.length} permissions in one signature \u2014 the mandate
     registrationFee: {
       totalEth: formatEther(fee),
       permissionCount: permissions.length,
-      ...permissions.length > 1 ? { perPermissionEth: formatEther(flatFee) } : {}
+      ...permissions.length > 1 ? { perPermissionEth: formatEther(flatFee) } : {},
+      symbol: getNativeCurrencySymbol(project.chainId)
     },
     typedData
   });
@@ -43406,7 +43429,8 @@ Attaching ${permissions.length} permissions in one signature \u2014 the mandate
       chainId: project.chainId,
       // Each permission in the batch is charged the same flat fee.
       fee: flatFee.toString(),
-      feeEth: formatEther(flatFee)
+      feeEth: formatEther(flatFee),
+      feeSymbol: getNativeCurrencySymbol(project.chainId)
     });
     say(() => {
       if (!present) {
@@ -43636,7 +43660,8 @@ async function liveMandateFee(chainId, permissionAddresses) {
     return null;
   }
 }
-function draftFeeFromEstimate(estimate) {
+function draftFeeFromEstimate(estimate, chainId) {
+  const symbol = getNativeCurrencySymbol(chainId);
   const perFeeWei = estimate.perPermission[0]?.feeWei ?? 0n;
   return {
     perPermissionWei: perFeeWei.toString(),
@@ -43644,7 +43669,8 @@ function draftFeeFromEstimate(estimate) {
     totalWei: estimate.totalWei.toString(),
     totalEth: formatEther(estimate.totalWei),
     permissionCount: estimate.perPermission.length,
-    disclosure: describeMandateFee(estimate)
+    disclosure: describeMandateFee(estimate, symbol),
+    symbol
   };
 }
 function resolveActiveChain(account2) {
@@ -43752,7 +43778,7 @@ ${permissions.length} permission(s) tracked for SMA ${account2.safe}:
   const unregisteredAddresses = chargeable.map((p) => p.address);
   if (unregisteredAddresses.length > 0) {
     const estimate = await liveMandateFee(chainId, unregisteredAddresses);
-    if (estimate !== null) registrationFee = draftFeeFromEstimate(estimate);
+    if (estimate !== null) registrationFee = draftFeeFromEstimate(estimate, chainId);
   }
   const draft = {
     account: account2.safe,
@@ -43795,7 +43821,7 @@ Permissions tracked for SMA ${account2.safe}:
     const estimate = await liveMandateFee(chainId, unregistered.map((p) => p.address));
     if (estimate !== null) {
       console.log(`
-${describeMandateFee(estimate)}`);
+${describeMandateFee(estimate, getNativeCurrencySymbol(chainId))}`);
       console.log("  Paid by the agent wallet on registration, per permission.");
     }
   }

package/packages/cli/dist/server.cjs

@@ -46402,6 +46402,9 @@ var import_websocket_server = __toESM(require_websocket_server(), 1);
 var CREATE2_KERNEL = "0x38b508756c976e876EFF05a29E731A4d348BA6ED";
 var CREATE2_MANDATE_FACTORY = "0x6d2C802ffa0d9A8Ed69A5Bf22c1b63ccB566B8Fc";
 var CREATE2_GOVERNANCE = "0x4315B37cA4A315A7042af1Fcb37F8436f4D24356";
+var ETH = { name: "Ether", symbol: "ETH", decimals: 18 };
+var BNB = { name: "BNB", symbol: "BNB", decimals: 18 };
+var HYPE = { name: "HYPE", symbol: "HYPE", decimals: 18 };
 var chains = {
   // Ethereum mainnet
   1: {
@@ -46413,7 +46416,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Base mainnet
   8453: {
@@ -46425,7 +46429,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Arbitrum mainnet
   42161: {
@@ -46437,7 +46442,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Optimism mainnet
   10: {
@@ -46449,7 +46455,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Unichain mainnet
   130: {
@@ -46461,9 +46468,10 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
-  // BSC mainnet
+  // BSC mainnet — native gas token is BNB, not ETH.
   56: {
     chainId: 56,
     name: "BSC",
@@ -46473,7 +46481,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: BNB
   },
   // World Chain mainnet
   480: {
@@ -46485,9 +46494,10 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
-  // HyperEVM mainnet
+  // HyperEVM mainnet — native gas token is HYPE, not ETH.
   999: {
     chainId: 999,
     name: "HyperEVM",
@@ -46497,7 +46507,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: HYPE
   },
   // MegaETH mainnet
   4326: {
@@ -46509,7 +46520,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Base Sepolia (testnet)
   84532: {
@@ -46521,7 +46533,8 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   },
   // Eth Sepolia (testnet)
   11155111: {
@@ -46533,10 +46546,14 @@ var chains = {
     mandateFactory: CREATE2_MANDATE_FACTORY,
     governance: CREATE2_GOVERNANCE,
     dispatchModel: "selective",
-    protocols: {}
+    protocols: {},
+    nativeCurrency: ETH
   }
 };
 var defaultRpcUrls = Object.fromEntries(Object.values(chains).map((c) => [c.chainId, c.defaultRpcUrl]));
+function getNativeCurrencySymbol(chainId) {
+  return chains[chainId]?.nativeCurrency.symbol ?? "ETH";
+}
 
 // ../sdk/dist/abis/SailKernel.js
 var SailKernelAbi = [
@@ -48085,6 +48102,8 @@ var CHAIN_RPC_ENV_KEYS = {
 };
 var SUPPORTED_CHAIN_IDS = [1, 8453, 42161, 10, 130, 56, 480, 999, 4326, 84532];
 var DEFAULT_RPC_URLS = { ...defaultRpcUrls };
+var REGISTRATION_FEE_TTL_MS = 5 * 60 * 1e3;
+var registrationFeeCache = /* @__PURE__ */ new Map();
 function resolveRpcUrl(env, chainId) {
   const keys = CHAIN_RPC_ENV_KEYS[chainId] ?? [`RPC_URL_${chainId}`];
   for (const k of keys) {
@@ -48744,6 +48763,7 @@ function startServer(sailDir, { port = PORT } = {}) {
       const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
       if (receipt.status !== "success") throw new Error(`registerPermissions reverted (tx ${txHash})`);
       const feeEth = formatEther(flatFee);
+      const feeSymbol = getNativeCurrencySymbol(Number(chainId));
       for (const addr of addrs) {
         const meta = permissionMeta.find((p) => p.address && getAddress(p.address) === addr);
         const ev = {
@@ -48756,7 +48776,8 @@ function startServer(sailDir, { port = PORT } = {}) {
           txHash,
           chainId,
           fee: flatFee.toString(),
-          feeEth
+          feeEth,
+          feeSymbol
         };
         try {
           import_node_fs2.default.appendFileSync(at("activity.jsonl"), `${JSON.stringify(ev)}
@@ -49367,14 +49388,43 @@ function startServer(sailDir, { port = PORT } = {}) {
     const env = parseEnvFile(at(".env.local"));
     const chainId = Number(account.chainId ?? env.CHAIN_ID ?? 0);
     let kernel = env.KERNEL_ADDRESS;
+    let governance;
     if (!kernel) {
       try {
-        kernel = getSailDeployment(chainId)?.kernel;
+        const deployment = getSailDeployment(chainId);
+        kernel = deployment?.kernel;
+        governance = deployment?.governance;
       } catch {
         kernel = void 0;
       }
+    } else {
+      try {
+        governance = getSailDeployment(chainId)?.governance;
+      } catch {
+        governance = void 0;
+      }
     }
     const rpcUrl = resolveRpcUrl(env, chainId);
+    let registrationFee = null;
+    if (!localOnly && governance && rpcUrl) {
+      const cached = registrationFeeCache.get(chainId);
+      if (cached && cached.expiresAt > Date.now()) {
+        registrationFee = cached.fee;
+      } else {
+        try {
+          const feeClient = createPublicClient({ transport: http(rpcUrl, { timeout: 4e3 }) });
+          const feeWei = await readPermissionRegistrationFee(feeClient, governance);
+          registrationFee = {
+            feeWei: feeWei.toString(),
+            feeEth: formatEther(feeWei),
+            symbol: getNativeCurrencySymbol(chainId)
+          };
+          registrationFeeCache.set(chainId, { fee: registrationFee, expiresAt: Date.now() + REGISTRATION_FEE_TTL_MS });
+        } catch {
+          registrationFee = null;
+        }
+      }
+    }
     const nameByAddr = /* @__PURE__ */ new Map();
     const templateByAddr = /* @__PURE__ */ new Map();
     try {
@@ -49402,6 +49452,7 @@ function startServer(sailDir, { port = PORT } = {}) {
       kernel: kernel ?? null,
       rpcConfigured: Boolean(rpcUrl),
       onchain: false,
+      registrationFee,
       sma: {
         address: account.safe,
         owner: account.owner,

package/packages/sdk/dist/chains.d.ts

@@ -11,4 +11,11 @@ export declare function getChain(chainId: number): ChainConfig;
 export declare const defaultRpcUrls: Record<number, string>;
 /** The public default RPC URL for a chainId, or undefined if unsupported. */
 export declare function getDefaultRpcUrl(chainId: number): string | undefined;
+/**
+ * The native gas token symbol for a chain (e.g. "ETH", "BNB", "HYPE") — what
+ * `permissionRegistrationFee` is denominated in on that chain. Falls back to
+ * "ETH" for an unrecognized chainId so display code degrades gracefully
+ * instead of throwing.
+ */
+export declare function getNativeCurrencySymbol(chainId: number): string;
 //# sourceMappingURL=chains.d.ts.map

package/packages/sdk/dist/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAc9C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAqI9C,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAQrD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkB9C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAgJ9C,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAQrD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/packages/sdk/dist/chains.js

@@ -9,6 +9,9 @@
 const CREATE2_KERNEL = "0x38b508756c976e876EFF05a29E731A4d348BA6ED";
 const CREATE2_MANDATE_FACTORY = "0x6d2C802ffa0d9A8Ed69A5Bf22c1b63ccB566B8Fc";
 const CREATE2_GOVERNANCE = "0x4315B37cA4A315A7042af1Fcb37F8436f4D24356";
+const ETH = { name: "Ether", symbol: "ETH", decimals: 18 };
+const BNB = { name: "BNB", symbol: "BNB", decimals: 18 };
+const HYPE = { name: "HYPE", symbol: "HYPE", decimals: 18 };
 export const chains = {
     // Ethereum mainnet
     1: {
@@ -21,6 +24,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
     // Base mainnet
     8453: {
@@ -33,6 +37,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
     // Arbitrum mainnet
     42161: {
@@ -45,6 +50,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
     // Optimism mainnet
     10: {
@@ -57,6 +63,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
     // Unichain mainnet
     130: {
@@ -69,8 +76,9 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
-    // BSC mainnet
+    // BSC mainnet — native gas token is BNB, not ETH.
     56: {
         chainId: 56,
         name: "BSC",
@@ -81,6 +89,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: BNB,
     },
     // World Chain mainnet
     480: {
@@ -93,8 +102,9 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
-    // HyperEVM mainnet
+    // HyperEVM mainnet — native gas token is HYPE, not ETH.
     999: {
         chainId: 999,
         name: "HyperEVM",
@@ -105,6 +115,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: HYPE,
     },
     // MegaETH mainnet
     4326: {
@@ -117,6 +128,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
     // Base Sepolia (testnet)
     84532: {
@@ -129,6 +141,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
     // Eth Sepolia (testnet)
     11155111: {
@@ -141,6 +154,7 @@ export const chains = {
         governance: CREATE2_GOVERNANCE,
         dispatchModel: "selective",
         protocols: {},
+        nativeCurrency: ETH,
     },
 };
 /** Returns the ChainConfig for a given chainId, or throws if unsupported. */
@@ -162,4 +176,13 @@ export const defaultRpcUrls = Object.fromEntries(Object.values(chains).map((c) =
 export function getDefaultRpcUrl(chainId) {
     return chains[chainId]?.defaultRpcUrl;
 }
+/**
+ * The native gas token symbol for a chain (e.g. "ETH", "BNB", "HYPE") — what
+ * `permissionRegistrationFee` is denominated in on that chain. Falls back to
+ * "ETH" for an unrecognized chainId so display code degrades gracefully
+ * instead of throwing.
+ */
+export function getNativeCurrencySymbol(chainId) {
+    return chains[chainId]?.nativeCurrency.symbol ?? "ETH";
+}
 //# sourceMappingURL=chains.js.map

package/packages/sdk/dist/chains.js.map

@@ -1 +1 @@
-{"version":3,"file":"chains.js","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,cAAc,GAAG,4CAA4C,CAAC;AACpE,MAAM,uBAAuB,GAAG,4CAA4C,CAAC;AAC7E,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AAExE,MAAM,CAAC,MAAM,MAAM,GAAgC;IACjD,mBAAmB;IACnB,CAAC,EAAE;QACD,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,qBAAqB;QAChC,aAAa,EAAE,0BAA0B;QACzC,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,eAAe;IACf,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,cAAc;QACzB,aAAa,EAAE,0BAA0B;QACzC,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,mBAAmB;IACnB,KAAK,EAAE;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,kBAAkB;QAC7B,aAAa,EAAE,8BAA8B;QAC7C,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,mBAAmB;IACnB,EAAE,EAAE;QACF,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,kBAAkB;QAC7B,aAAa,EAAE,6BAA6B;QAC5C,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,mBAAmB;IACnB,GAAG,EAAE;QACH,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,kBAAkB;QAC7B,aAAa,EAAE,8BAA8B;QAC7C,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,cAAc;IACd,EAAE,EAAE;QACF,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,aAAa;QACxB,aAAa,EAAE,kCAAkC;QACjD,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,sBAAsB;IACtB,GAAG,EAAE;QACH,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,eAAe;QAC1B,aAAa,EAAE,iDAAiD;QAChE,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,mBAAmB;IACnB,GAAG,EAAE;QACH,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,kBAAkB;QAC7B,aAAa,EAAE,iCAAiC;QAChD,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,kBAAkB;IAClB,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,iBAAiB;QAC5B,aAAa,EAAE,iCAAiC;QAChD,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,yBAAyB;IACzB,KAAK,EAAE;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,sBAAsB;QACjC,aAAa,EAAE,0BAA0B;QACzC,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;IACD,wBAAwB;IACxB,QAAQ,EAAE;QACR,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,iBAAiB;QAC5B,aAAa,EAAE,6CAA6C;QAC5D,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,EAAE;KACd;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,SAAS,OAAO,6NAA6N,CAC9O,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2B,MAAM,CAAC,WAAW,CACtE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAC/D,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;AACxC,CAAC"}
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"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"}

package/packages/sdk/dist/fees.d.ts

@@ -41,9 +41,12 @@ export declare function estimateMandateRegistrationFee(publicClient: PublicClien
  * Plain-language disclosure of a mandate's flat registration fee, e.g.
  * `"Registration fee: 0.00003 ETH (3 permissions × 0.00001 ETH)"`.
  *
- * Factual cost statement only — no price/value framing.
+ * Factual cost statement only — no price/value framing. `symbol` is the
+ * chain's native gas token (defaults to "ETH") — callers on a chain with its
+ * own gas token (BSC → BNB, HyperEVM → HYPE) MUST pass the correct symbol;
+ * the fee is always denominated in the chain's native token, never literally ETH.
  */
-export declare function describeMandateFee(estimate: MandateFeeEstimate): string;
+export declare function describeMandateFee(estimate: MandateFeeEstimate, symbol?: string): string;
 /** Thrown when a signer cannot cover the registration fee. A typed error so the
  *  preflight block can't be silently disabled by re-wording a message string. */
 export declare class RegistrationFeeError extends Error {
@@ -60,6 +63,7 @@ export declare function feeShortfall(balanceWei: bigint, totalFeeWei: bigint): b
  * registration fee. Call this BEFORE prompting the owner to sign so an
  * underfunded signer fails early rather than after a wasted signature or an
  * on-chain revert. Scoped to the fee itself — gas is a separate concern.
+ * `symbol` is the chain's native gas token (defaults to "ETH").
  */
-export declare function assertFeeAffordable(balanceWei: bigint, totalFeeWei: bigint): void;
+export declare function assertFeeAffordable(balanceWei: bigint, totalFeeWei: bigint, symbol?: string): void;
 //# sourceMappingURL=fees.d.ts.map