@hardkas/l2 0.3.0-alpha → 0.4.0-alpha

package/dist/index.d.ts

@@ -44,6 +44,26 @@ interface L2NetworkProfile {
 }
 declare const BUILTIN_L2_PROFILES: readonly L2NetworkProfile[];
 
+interface MetaMaskChainParams {
+    chainId: string;
+    chainName: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    rpcUrls: string[];
+    blockExplorerUrls?: string[] | undefined;
+}
+/**
+ * Generates the standard wallet_addEthereumChain payload for MetaMask.
+ */
+declare function generateAddEthereumChainPayload(profile: L2NetworkProfile): MetaMaskChainParams;
+/**
+ * Generates a JavaScript snippet for browser consoles to add the network to MetaMask.
+ */
+declare function generateMetaMaskSnippet(profile: L2NetworkProfile): string;
+
 declare function listL2Profiles(userProfiles?: Record<string, L2UserNetworkConfig>): L2NetworkProfile[];
 declare function getL2Profile(name: string, userProfiles?: Record<string, L2UserNetworkConfig>): L2NetworkProfile | null;
 declare function resolveL2Profile(args: {
@@ -200,4 +220,4 @@ declare function assertValidL2BridgeAssumptions(input: unknown): L2BridgeAssumpt
  */
 declare function encodeConstructorArgs(bytecode: string, constructorSignature: string, args: string[]): string;
 
-export { BUILTIN_L2_PROFILES, type EvmCallRequest, EvmJsonRpcClient, type EvmJsonRpcClientOptions, type EvmRpcHealthResult, type EvmTransactionReceiptSummary, type IgraTxSigner, type IgraTxSigningInput, type IgraTxSigningResult, type L2BridgeAssumptions, type L2BridgePhase, type L2NetworkProfile, type L2NetworkType, type L2ProfileSource, type L2RiskProfile, type L2SecurityAssumptions, type L2UserNetworkConfig, UnsupportedIgraTxSigner, ViemIgraTxSigner, type ViemIgraTxSignerOptions, assertValidL2BridgeAssumptions, assertValidL2Profile, checkEvmRpcHealth, encodeConstructorArgs, formatWeiAsEtherLike, getL2BridgeAssumptions, getL2Profile, listL2BridgeAssumptions, listL2Profiles, normalizeEvmTransactionReceipt, resolveL2Profile, toHexQuantity, validateL2BridgeAssumptions, validateL2Profile, waitForEvmRpcReady };
+export { BUILTIN_L2_PROFILES, type EvmCallRequest, EvmJsonRpcClient, type EvmJsonRpcClientOptions, type EvmRpcHealthResult, type EvmTransactionReceiptSummary, type IgraTxSigner, type IgraTxSigningInput, type IgraTxSigningResult, type L2BridgeAssumptions, type L2BridgePhase, type L2NetworkProfile, type L2NetworkType, type L2ProfileSource, type L2RiskProfile, type L2SecurityAssumptions, type L2UserNetworkConfig, type MetaMaskChainParams, UnsupportedIgraTxSigner, ViemIgraTxSigner, type ViemIgraTxSignerOptions, assertValidL2BridgeAssumptions, assertValidL2Profile, checkEvmRpcHealth, encodeConstructorArgs, formatWeiAsEtherLike, generateAddEthereumChainPayload, generateMetaMaskSnippet, getL2BridgeAssumptions, resolveL2Profile as getL2NetworkProfile, getL2Profile, listL2BridgeAssumptions, listL2Profiles, normalizeEvmTransactionReceipt, resolveL2Profile, toHexQuantity, validateL2BridgeAssumptions, validateL2Profile, waitForEvmRpcReady };

package/dist/index.js

@@ -12,6 +12,8 @@ var BUILTIN_L2_PROFILES = [
     executionLayer: "evm",
     gasToken: "iKAS",
     nativeTokenDecimals: 18,
+    chainId: 19416,
+    rpcUrl: "http://127.0.0.1:8545",
     security: {
       bridgePhase: "pre-zk",
       trustlessExit: false,
@@ -28,6 +30,36 @@ var BUILTIN_L2_PROFILES = [
   }
 ];
 
+// src/metamask.ts
+function generateAddEthereumChainPayload(profile) {
+  if (!profile.chainId) {
+    throw new Error(`Profile "${profile.name}" is missing chainId`);
+  }
+  if (!profile.rpcUrl) {
+    throw new Error(`Profile "${profile.name}" is missing rpcUrl`);
+  }
+  return {
+    chainId: `0x${profile.chainId.toString(16)}`,
+    chainName: profile.displayName || profile.name,
+    nativeCurrency: {
+      name: profile.gasToken || "iKAS",
+      symbol: profile.gasToken || "iKAS",
+      decimals: profile.nativeTokenDecimals || 18
+    },
+    rpcUrls: [profile.rpcUrl],
+    blockExplorerUrls: profile.explorerUrl ? [profile.explorerUrl] : void 0
+  };
+}
+function generateMetaMaskSnippet(profile) {
+  const payload = generateAddEthereumChainPayload(profile);
+  return `await window.ethereum.request({
+  method: "wallet_addEthereumChain",
+  params: [
+    ${JSON.stringify(payload, null, 4).replace(/\n/g, "\n    ")}
+  ]
+});`;
+}
+
 // src/registry.ts
 import { HARDKAS_VERSION as HARDKAS_VERSION2 } from "@hardkas/artifacts";
 function listL2Profiles(userProfiles) {
@@ -493,7 +525,10 @@ export {
   checkEvmRpcHealth,
   encodeConstructorArgs,
   formatWeiAsEtherLike,
+  generateAddEthereumChainPayload,
+  generateMetaMaskSnippet,
   getL2BridgeAssumptions,
+  resolveL2Profile as getL2NetworkProfile,
   getL2Profile,
   listL2BridgeAssumptions,
   listL2Profiles,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/l2",
-  "version": "0.3.0-alpha",
+  "version": "0.4.0-alpha",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"
@@ -8,7 +8,7 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "viem": "^2.48.8",
-    "@hardkas/artifacts": "0.3.0-alpha"
+    "@hardkas/artifacts": "0.4.0-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",