@megaeth-labs/wallet-sdk 0.1.0-beta.1

package/README.md

@@ -0,0 +1,42 @@
+# MegaETH Wallet SDK
+
+Distributed to partners to work with the MegaETH wallet. Is responsible for loading the wallet inside an iFrame and
+communicating with it.
+
+## Setup
+
+Install dependencies: `pnpm i`
+
+Link package locally so other packages can use it: `pnpm dev:link`
+
+Auto build during dev: `pnpm dev`
+
+Build once: `pnpm build`
+
+## How It Works
+
+The bulk of the logic can be found in the `src/wallet.ts` file. It handles the initialization of the wallet,
+communication with the iframe, and event handling. It exposes a object `mega` which contains all the methods to initialise and communicate with the iFrame.
+
+Communication is handled using the `penpal` library which ensures that messages are sent and received securely and reliably between the parent window and the iframe.
+
+**Initialisation Flow**
+Calling `mega.initialise()` triggers the following steps:
+1. iFrame is created and loaded
+2. Penpal is initialised to handle communication with the iFrame
+3. A method `ready` is exposed to the iFrame
+4. The iFrame loads and checks wallet status and then calls `ready` in the parent window
+
+**Methods**
+Each of the available methods can be found in the `src/outbound-methods` folder and follow the same pattern:
+1. Validate the request
+2. Use `Remote.remote.methodName` to call the method in the iFrame
+3. The promise remains open until the iFrame responds
+4. Result is returned
+
+For example:
+```typescript
+const {signature, status} = await mega.signMessage('Hello World');
+```
+
+All request and return types are defined in the `src/types.ts` file.

package/dist/index.cjs

@@ -0,0 +1,319 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  mega: () => mega
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/wallet.ts
+var Penpal = __toESM(require("penpal"), 1);
+
+// src/callbacks.ts
+var onStatusChange;
+var callbacks_default = {
+  onStatusChange
+};
+
+// src/events.ts
+var onStatusChange2 = (callback) => {
+  callbacks_default.onStatusChange = callback;
+};
+var events = {
+  onStatusChange: onStatusChange2
+};
+
+// src/consts.ts
+var WALLET_URL = "https://account.megaeth.com";
+var LOCAL_WALLET_URL = "http://localhost:4000";
+
+// src/helpers.ts
+var getWalletUrl = (config) => {
+  const origin = config.devMode ? LOCAL_WALLET_URL : WALLET_URL;
+  const params = [
+    `network=${config.network}`,
+    ...config.sponsorUrl ? [`sponsorUrl=${config.sponsorUrl}`] : [],
+    ...config.debug ? [`debug=${config.debug}`] : [],
+    ...config.logging ? [`logging=${config.logging}`] : []
+  ];
+  return {
+    origin,
+    uiUrl: `${origin}?${params.join("&")}`
+  };
+};
+
+// src/state.ts
+var State = class {
+  constructor() {
+    this.initialised = false;
+  }
+};
+var state_default = new State();
+
+// src/inbound-methods/hide.ts
+var hide = () => {
+  state_default.iframe.style.display = "none";
+};
+
+// src/inbound-methods/setStatus.ts
+var setStatus = (status2) => {
+  callbacks_default.onStatusChange?.(status2);
+};
+
+// src/inbound-methods/show.ts
+var show = () => {
+  state_default.iframe.style.display = "block";
+};
+
+// src/inbound-methods/index.ts
+var inboundMethods = {
+  show,
+  hide,
+  setStatus
+};
+
+// src/logger.ts
+var _Logger = class _Logger {
+  static setLogLevel(level) {
+    _Logger.logLevel = level;
+  }
+  static debug(module2, message, data) {
+    _Logger.log("debug", module2, message, data);
+  }
+  static info(module2, message, data) {
+    _Logger.log("info", module2, message, data);
+  }
+  static warn(module2, message, data) {
+    _Logger.log("warn", module2, message, data);
+  }
+  static error(module2, message, data) {
+    _Logger.log("error", module2, message, data);
+  }
+  static shouldLog(level) {
+    switch (_Logger.logLevel) {
+      case "debug":
+        return true;
+      case "info":
+        return ["info", "warn", "error"].includes(level);
+      case "warn":
+        return ["warn", "error"].includes(level);
+      case "error":
+        return level === "error";
+    }
+  }
+  static getMessage(module2, message) {
+    return `[${module2}] ${message}`;
+  }
+  static log(level, module2, message, data) {
+    if (!_Logger.shouldLog(level)) return;
+    const formattedMessage = _Logger.getMessage(module2, message);
+    const params = [formattedMessage];
+    if (data) {
+      params.push(data);
+    }
+    switch (level) {
+      case "debug":
+        console.debug(...params);
+        break;
+      case "info":
+        console.info(...params);
+        break;
+      case "warn":
+        console.warn(...params);
+        break;
+      case "error":
+        console.error(...params);
+        break;
+    }
+  }
+};
+_Logger.logLevel = "error";
+var Logger = _Logger;
+
+// src/outbound-methods/balances.ts
+var balances = async (request) => {
+  return state_default.remote.balances(request);
+};
+
+// src/outbound-methods/callContract.ts
+var callContract = (request) => {
+  return state_default.remote.callContract(request);
+};
+
+// src/outbound-methods/connect.ts
+var connect = async () => {
+  Logger.debug("connect", "Connect wallet triggered...");
+  const result = await state_default.remote.connect();
+  Logger.debug("connect", "Connect resolved", result);
+  return result;
+};
+
+// src/outbound-methods/deposit.ts
+var deposit = () => {
+  return state_default.remote.deposit();
+};
+
+// src/outbound-methods/disconnect.ts
+var disconnect = async () => {
+  Logger.debug("disconnect", "Disconnect wallet triggered...");
+  const result = await state_default.remote.disconnect();
+  Logger.debug("disconnect", "Disconnect resolved");
+  return result;
+};
+
+// src/outbound-methods/getFromContract.ts
+var getFromContract = async (request) => {
+  const result = await state_default.remote.getFromContract(request);
+  return result;
+};
+
+// src/outbound-methods/getPermissions.ts
+var getPermissions = (address) => {
+  return state_default.remote.getPermissions(address);
+};
+
+// src/outbound-methods/grantPermissions.ts
+var grantPermissions = (request) => {
+  return state_default.remote.grantPermissions(request);
+};
+
+// src/outbound-methods/open.ts
+var open = async () => {
+  return state_default.remote.open();
+};
+
+// src/outbound-methods/revokePermissions.ts
+var revokePermissions = () => {
+  return state_default.remote.revokePermissions();
+};
+
+// src/outbound-methods/signData.ts
+var signData = (request) => {
+  return state_default.remote.signData(request);
+};
+
+// src/outbound-methods/signMessage.ts
+var signMessage = (message) => {
+  return state_default.remote.signMessage(message);
+};
+
+// src/outbound-methods/status.ts
+var status = () => {
+  return state_default.remote.status();
+};
+
+// src/outbound-methods/transfer.ts
+var transfer = (request) => {
+  return state_default.remote.transfer(request);
+};
+
+// src/outbound-methods/index.ts
+var outboundMethods = {
+  status,
+  callContract,
+  connect,
+  disconnect,
+  transfer,
+  signMessage,
+  grantPermissions,
+  revokePermissions,
+  getPermissions,
+  deposit,
+  balances,
+  open,
+  signData,
+  getFromContract
+};
+
+// src/wallet.ts
+var createIFrame = (url) => {
+  const iframe = document.createElement("iframe");
+  iframe.style.position = "fixed";
+  iframe.style.top = "0";
+  iframe.style.left = "0";
+  iframe.style.height = "100vh";
+  iframe.style.width = "100vw";
+  iframe.style.border = "none";
+  iframe.style.zIndex = "9999";
+  iframe.style.display = "none";
+  iframe.setAttribute(
+    "allow",
+    "clipboard-write; publickey-credentials-get *; publickey-credentials-create *"
+  );
+  iframe.src = url;
+  document.body.appendChild(iframe);
+  return iframe;
+};
+var initialise = async (config) => {
+  if (state_default.initialised) return;
+  state_default.initialised = true;
+  state_default.network = config?.network || "mainnet";
+  Logger.setLogLevel(config?.logging || "error");
+  Logger.debug("SDK", "Initialising...");
+  const { origin, uiUrl } = getWalletUrl(config);
+  state_default.iframe = createIFrame(uiUrl);
+  const messenger = new Penpal.WindowMessenger({
+    remoteWindow: state_default.iframe.contentWindow,
+    allowedOrigins: [origin]
+  });
+  return new Promise((resolve, reject) => {
+    try {
+      const connection = Penpal.connect({
+        messenger,
+        log: config?.debug ? Penpal.debug("SDK") : void 0,
+        methods: {
+          ready: async () => {
+            Logger.debug("SDK", "Initialised");
+            const status2 = await state_default.remote.status();
+            Logger.debug("SDK", `Status: ${status2.status}, Address: ${status2.address}`);
+            callbacks_default.onStatusChange?.(status2);
+            resolve(status2);
+          },
+          ...inboundMethods
+        }
+      });
+      connection.promise.then((_remote) => {
+        state_default.remote = _remote;
+      });
+    } catch (e) {
+      reject(e);
+    }
+  });
+};
+var mega = {
+  initialise,
+  events,
+  ...outboundMethods
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mega
+});

package/dist/index.d.cts

@@ -0,0 +1,157 @@
+type Network = 'mainnet' | 'testnet';
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface Config {
+    network: Network;
+    logging?: LogLevel;
+    devMode?: boolean;
+    debug?: boolean;
+    sponsorUrl?: string;
+}
+type ConnectionStatus = {
+    status: 'connected' | 'disconnected' | 'cancelled';
+    address?: `0x${string}`;
+};
+interface TransferRequest {
+    amount: string;
+    to: `0x${string}`;
+    type: 'native' | 'erc20' | 'erc721' | 'erc1155';
+    contractAddress?: string;
+    tokenId?: number;
+    silent?: boolean;
+}
+interface CallContractRequest {
+    address: `0x${string}`;
+    abi: any;
+    functionName: string;
+    args: any[];
+    silent?: boolean;
+}
+interface GetFromContractRequest {
+    address: `0x${string}`;
+    abi: any;
+    functionName: string;
+    args: any[];
+}
+interface TransactionResult {
+    status: 'approved' | 'cancelled' | 'error';
+    receipt?: {
+        hash: string;
+    };
+    error?: string;
+}
+interface SignMessageResponse {
+    status: 'success' | 'cancelled' | 'error';
+    error?: string;
+    signature?: `0x${string}`;
+}
+interface GetPermissionsResponse {
+    permissions?: {
+        expiry: number;
+        permissions: {
+            calls: {
+                signature: string;
+                to?: `0x${string}`;
+            }[];
+            spend: {
+                limit: bigint;
+                period: 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+                token?: `0x${string}`;
+            }[];
+        };
+    } | null;
+}
+interface RemoteAPI {
+    status: () => ConnectionStatus;
+    connect: () => Promise<ConnectionStatus>;
+    disconnect: () => Promise<ConnectionStatus>;
+    transfer: (request: TransferRequest) => Promise<TransactionResult>;
+    callContract: (request: CallContractRequest) => Promise<TransactionResult>;
+    getFromContract: <T>(request: GetFromContractRequest) => Promise<T>;
+    signMessage: (message: string) => Promise<SignMessageResponse>;
+    grantPermissions: (request: GrantPermissionsRequest) => Promise<GrantPermissionsResponse>;
+    revokePermissions: () => Promise<void>;
+    getPermissions: (address?: string) => Promise<GetPermissionsResponse | undefined>;
+    deposit: () => Promise<void>;
+    balances: (request: BalancesRequest) => Promise<OwnedTokenResponse[]>;
+    signData: (request: SignDataRequest) => Promise<SignDataResponse>;
+    open: () => Promise<void>;
+    [key: string]: any;
+}
+interface Permission {
+    id?: string;
+    expiry: number;
+    feeToken: {
+        limit: string;
+        symbol?: string;
+    };
+    permissions: {
+        calls: {
+            signature?: string;
+            to?: string;
+        }[];
+        spend: {
+            limit: bigint;
+            period: 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+            token?: `0x${string}`;
+        }[];
+    };
+}
+interface GrantPermissionsRequest {
+    permissions: Permission;
+    externalAddress?: `0x${string}`;
+}
+type GrantPermissionsResponse = {
+    status: 'approved' | 'cancelled';
+};
+interface BalancesRequest {
+    tokens?: string[];
+}
+interface BaseTokenResponse {
+    name: string;
+    symbol: string;
+    decimals: number;
+    address: string;
+    image?: string;
+    usdPrice?: string;
+}
+interface OwnedTokenResponse extends BaseTokenResponse {
+    balance: string;
+    displayBalance: string;
+    usdPrice?: string;
+    usdBalance?: string;
+    marketCap?: string;
+    volume?: string;
+    holders?: number;
+    percentChange?: number;
+}
+interface SignDataRequest {
+    data: any;
+}
+interface SignDataResponse {
+    status: 'success' | 'cancelled' | 'error';
+    error?: string;
+    signature?: string;
+}
+
+declare const mega: {
+    status: () => Promise<ConnectionStatus>;
+    callContract: (request: CallContractRequest) => Promise<TransactionResult>;
+    connect: () => Promise<ConnectionStatus>;
+    disconnect: () => Promise<ConnectionStatus>;
+    transfer: (request: TransferRequest) => Promise<TransactionResult>;
+    signMessage: (message: string) => Promise<SignMessageResponse>;
+    grantPermissions: (request: GrantPermissionsRequest) => Promise<GrantPermissionsResponse>;
+    revokePermissions: () => Promise<void>;
+    getPermissions: (address?: string) => Promise<GetPermissionsResponse | undefined>;
+    deposit: () => Promise<void>;
+    balances: (request: BalancesRequest) => Promise<OwnedTokenResponse[]>;
+    open: () => Promise<void>;
+    signData: (request: SignDataRequest) => Promise<SignDataResponse>;
+    getFromContract: <T>(request: GetFromContractRequest) => Promise<T>;
+    initialise: (config: Config) => Promise<ConnectionStatus | undefined>;
+    events: {
+        onStatusChange: (callback: (status: ConnectionStatus) => void) => void;
+    };
+};
+
+export { type BalancesRequest, type BaseTokenResponse, type CallContractRequest, type Config, type ConnectionStatus, type GetFromContractRequest, type GetPermissionsResponse, type GrantPermissionsRequest, type GrantPermissionsResponse, type LogLevel, type Network, type OwnedTokenResponse, type Permission, type RemoteAPI, type SignDataRequest, type SignDataResponse, type SignMessageResponse, type TransactionResult, type TransferRequest, mega };

package/dist/index.d.ts

@@ -0,0 +1,157 @@
+type Network = 'mainnet' | 'testnet';
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface Config {
+    network: Network;
+    logging?: LogLevel;
+    devMode?: boolean;
+    debug?: boolean;
+    sponsorUrl?: string;
+}
+type ConnectionStatus = {
+    status: 'connected' | 'disconnected' | 'cancelled';
+    address?: `0x${string}`;
+};
+interface TransferRequest {
+    amount: string;
+    to: `0x${string}`;
+    type: 'native' | 'erc20' | 'erc721' | 'erc1155';
+    contractAddress?: string;
+    tokenId?: number;
+    silent?: boolean;
+}
+interface CallContractRequest {
+    address: `0x${string}`;
+    abi: any;
+    functionName: string;
+    args: any[];
+    silent?: boolean;
+}
+interface GetFromContractRequest {
+    address: `0x${string}`;
+    abi: any;
+    functionName: string;
+    args: any[];
+}
+interface TransactionResult {
+    status: 'approved' | 'cancelled' | 'error';
+    receipt?: {
+        hash: string;
+    };
+    error?: string;
+}
+interface SignMessageResponse {
+    status: 'success' | 'cancelled' | 'error';
+    error?: string;
+    signature?: `0x${string}`;
+}
+interface GetPermissionsResponse {
+    permissions?: {
+        expiry: number;
+        permissions: {
+            calls: {
+                signature: string;
+                to?: `0x${string}`;
+            }[];
+            spend: {
+                limit: bigint;
+                period: 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+                token?: `0x${string}`;
+            }[];
+        };
+    } | null;
+}
+interface RemoteAPI {
+    status: () => ConnectionStatus;
+    connect: () => Promise<ConnectionStatus>;
+    disconnect: () => Promise<ConnectionStatus>;
+    transfer: (request: TransferRequest) => Promise<TransactionResult>;
+    callContract: (request: CallContractRequest) => Promise<TransactionResult>;
+    getFromContract: <T>(request: GetFromContractRequest) => Promise<T>;
+    signMessage: (message: string) => Promise<SignMessageResponse>;
+    grantPermissions: (request: GrantPermissionsRequest) => Promise<GrantPermissionsResponse>;
+    revokePermissions: () => Promise<void>;
+    getPermissions: (address?: string) => Promise<GetPermissionsResponse | undefined>;
+    deposit: () => Promise<void>;
+    balances: (request: BalancesRequest) => Promise<OwnedTokenResponse[]>;
+    signData: (request: SignDataRequest) => Promise<SignDataResponse>;
+    open: () => Promise<void>;
+    [key: string]: any;
+}
+interface Permission {
+    id?: string;
+    expiry: number;
+    feeToken: {
+        limit: string;
+        symbol?: string;
+    };
+    permissions: {
+        calls: {
+            signature?: string;
+            to?: string;
+        }[];
+        spend: {
+            limit: bigint;
+            period: 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+            token?: `0x${string}`;
+        }[];
+    };
+}
+interface GrantPermissionsRequest {
+    permissions: Permission;
+    externalAddress?: `0x${string}`;
+}
+type GrantPermissionsResponse = {
+    status: 'approved' | 'cancelled';
+};
+interface BalancesRequest {
+    tokens?: string[];
+}
+interface BaseTokenResponse {
+    name: string;
+    symbol: string;
+    decimals: number;
+    address: string;
+    image?: string;
+    usdPrice?: string;
+}
+interface OwnedTokenResponse extends BaseTokenResponse {
+    balance: string;
+    displayBalance: string;
+    usdPrice?: string;
+    usdBalance?: string;
+    marketCap?: string;
+    volume?: string;
+    holders?: number;
+    percentChange?: number;
+}
+interface SignDataRequest {
+    data: any;
+}
+interface SignDataResponse {
+    status: 'success' | 'cancelled' | 'error';
+    error?: string;
+    signature?: string;
+}
+
+declare const mega: {
+    status: () => Promise<ConnectionStatus>;
+    callContract: (request: CallContractRequest) => Promise<TransactionResult>;
+    connect: () => Promise<ConnectionStatus>;
+    disconnect: () => Promise<ConnectionStatus>;
+    transfer: (request: TransferRequest) => Promise<TransactionResult>;
+    signMessage: (message: string) => Promise<SignMessageResponse>;
+    grantPermissions: (request: GrantPermissionsRequest) => Promise<GrantPermissionsResponse>;
+    revokePermissions: () => Promise<void>;
+    getPermissions: (address?: string) => Promise<GetPermissionsResponse | undefined>;
+    deposit: () => Promise<void>;
+    balances: (request: BalancesRequest) => Promise<OwnedTokenResponse[]>;
+    open: () => Promise<void>;
+    signData: (request: SignDataRequest) => Promise<SignDataResponse>;
+    getFromContract: <T>(request: GetFromContractRequest) => Promise<T>;
+    initialise: (config: Config) => Promise<ConnectionStatus | undefined>;
+    events: {
+        onStatusChange: (callback: (status: ConnectionStatus) => void) => void;
+    };
+};
+
+export { type BalancesRequest, type BaseTokenResponse, type CallContractRequest, type Config, type ConnectionStatus, type GetFromContractRequest, type GetPermissionsResponse, type GrantPermissionsRequest, type GrantPermissionsResponse, type LogLevel, type Network, type OwnedTokenResponse, type Permission, type RemoteAPI, type SignDataRequest, type SignDataResponse, type SignMessageResponse, type TransactionResult, type TransferRequest, mega };

package/dist/index.js

@@ -0,0 +1,282 @@
+// src/wallet.ts
+import * as Penpal from "penpal";
+
+// src/callbacks.ts
+var onStatusChange;
+var callbacks_default = {
+  onStatusChange
+};
+
+// src/events.ts
+var onStatusChange2 = (callback) => {
+  callbacks_default.onStatusChange = callback;
+};
+var events = {
+  onStatusChange: onStatusChange2
+};
+
+// src/consts.ts
+var WALLET_URL = "https://account.megaeth.com";
+var LOCAL_WALLET_URL = "http://localhost:4000";
+
+// src/helpers.ts
+var getWalletUrl = (config) => {
+  const origin = config.devMode ? LOCAL_WALLET_URL : WALLET_URL;
+  const params = [
+    `network=${config.network}`,
+    ...config.sponsorUrl ? [`sponsorUrl=${config.sponsorUrl}`] : [],
+    ...config.debug ? [`debug=${config.debug}`] : [],
+    ...config.logging ? [`logging=${config.logging}`] : []
+  ];
+  return {
+    origin,
+    uiUrl: `${origin}?${params.join("&")}`
+  };
+};
+
+// src/state.ts
+var State = class {
+  constructor() {
+    this.initialised = false;
+  }
+};
+var state_default = new State();
+
+// src/inbound-methods/hide.ts
+var hide = () => {
+  state_default.iframe.style.display = "none";
+};
+
+// src/inbound-methods/setStatus.ts
+var setStatus = (status2) => {
+  callbacks_default.onStatusChange?.(status2);
+};
+
+// src/inbound-methods/show.ts
+var show = () => {
+  state_default.iframe.style.display = "block";
+};
+
+// src/inbound-methods/index.ts
+var inboundMethods = {
+  show,
+  hide,
+  setStatus
+};
+
+// src/logger.ts
+var _Logger = class _Logger {
+  static setLogLevel(level) {
+    _Logger.logLevel = level;
+  }
+  static debug(module, message, data) {
+    _Logger.log("debug", module, message, data);
+  }
+  static info(module, message, data) {
+    _Logger.log("info", module, message, data);
+  }
+  static warn(module, message, data) {
+    _Logger.log("warn", module, message, data);
+  }
+  static error(module, message, data) {
+    _Logger.log("error", module, message, data);
+  }
+  static shouldLog(level) {
+    switch (_Logger.logLevel) {
+      case "debug":
+        return true;
+      case "info":
+        return ["info", "warn", "error"].includes(level);
+      case "warn":
+        return ["warn", "error"].includes(level);
+      case "error":
+        return level === "error";
+    }
+  }
+  static getMessage(module, message) {
+    return `[${module}] ${message}`;
+  }
+  static log(level, module, message, data) {
+    if (!_Logger.shouldLog(level)) return;
+    const formattedMessage = _Logger.getMessage(module, message);
+    const params = [formattedMessage];
+    if (data) {
+      params.push(data);
+    }
+    switch (level) {
+      case "debug":
+        console.debug(...params);
+        break;
+      case "info":
+        console.info(...params);
+        break;
+      case "warn":
+        console.warn(...params);
+        break;
+      case "error":
+        console.error(...params);
+        break;
+    }
+  }
+};
+_Logger.logLevel = "error";
+var Logger = _Logger;
+
+// src/outbound-methods/balances.ts
+var balances = async (request) => {
+  return state_default.remote.balances(request);
+};
+
+// src/outbound-methods/callContract.ts
+var callContract = (request) => {
+  return state_default.remote.callContract(request);
+};
+
+// src/outbound-methods/connect.ts
+var connect = async () => {
+  Logger.debug("connect", "Connect wallet triggered...");
+  const result = await state_default.remote.connect();
+  Logger.debug("connect", "Connect resolved", result);
+  return result;
+};
+
+// src/outbound-methods/deposit.ts
+var deposit = () => {
+  return state_default.remote.deposit();
+};
+
+// src/outbound-methods/disconnect.ts
+var disconnect = async () => {
+  Logger.debug("disconnect", "Disconnect wallet triggered...");
+  const result = await state_default.remote.disconnect();
+  Logger.debug("disconnect", "Disconnect resolved");
+  return result;
+};
+
+// src/outbound-methods/getFromContract.ts
+var getFromContract = async (request) => {
+  const result = await state_default.remote.getFromContract(request);
+  return result;
+};
+
+// src/outbound-methods/getPermissions.ts
+var getPermissions = (address) => {
+  return state_default.remote.getPermissions(address);
+};
+
+// src/outbound-methods/grantPermissions.ts
+var grantPermissions = (request) => {
+  return state_default.remote.grantPermissions(request);
+};
+
+// src/outbound-methods/open.ts
+var open = async () => {
+  return state_default.remote.open();
+};
+
+// src/outbound-methods/revokePermissions.ts
+var revokePermissions = () => {
+  return state_default.remote.revokePermissions();
+};
+
+// src/outbound-methods/signData.ts
+var signData = (request) => {
+  return state_default.remote.signData(request);
+};
+
+// src/outbound-methods/signMessage.ts
+var signMessage = (message) => {
+  return state_default.remote.signMessage(message);
+};
+
+// src/outbound-methods/status.ts
+var status = () => {
+  return state_default.remote.status();
+};
+
+// src/outbound-methods/transfer.ts
+var transfer = (request) => {
+  return state_default.remote.transfer(request);
+};
+
+// src/outbound-methods/index.ts
+var outboundMethods = {
+  status,
+  callContract,
+  connect,
+  disconnect,
+  transfer,
+  signMessage,
+  grantPermissions,
+  revokePermissions,
+  getPermissions,
+  deposit,
+  balances,
+  open,
+  signData,
+  getFromContract
+};
+
+// src/wallet.ts
+var createIFrame = (url) => {
+  const iframe = document.createElement("iframe");
+  iframe.style.position = "fixed";
+  iframe.style.top = "0";
+  iframe.style.left = "0";
+  iframe.style.height = "100vh";
+  iframe.style.width = "100vw";
+  iframe.style.border = "none";
+  iframe.style.zIndex = "9999";
+  iframe.style.display = "none";
+  iframe.setAttribute(
+    "allow",
+    "clipboard-write; publickey-credentials-get *; publickey-credentials-create *"
+  );
+  iframe.src = url;
+  document.body.appendChild(iframe);
+  return iframe;
+};
+var initialise = async (config) => {
+  if (state_default.initialised) return;
+  state_default.initialised = true;
+  state_default.network = config?.network || "mainnet";
+  Logger.setLogLevel(config?.logging || "error");
+  Logger.debug("SDK", "Initialising...");
+  const { origin, uiUrl } = getWalletUrl(config);
+  state_default.iframe = createIFrame(uiUrl);
+  const messenger = new Penpal.WindowMessenger({
+    remoteWindow: state_default.iframe.contentWindow,
+    allowedOrigins: [origin]
+  });
+  return new Promise((resolve, reject) => {
+    try {
+      const connection = Penpal.connect({
+        messenger,
+        log: config?.debug ? Penpal.debug("SDK") : void 0,
+        methods: {
+          ready: async () => {
+            Logger.debug("SDK", "Initialised");
+            const status2 = await state_default.remote.status();
+            Logger.debug("SDK", `Status: ${status2.status}, Address: ${status2.address}`);
+            callbacks_default.onStatusChange?.(status2);
+            resolve(status2);
+          },
+          ...inboundMethods
+        }
+      });
+      connection.promise.then((_remote) => {
+        state_default.remote = _remote;
+      });
+    } catch (e) {
+      reject(e);
+    }
+  });
+};
+var mega = {
+  initialise,
+  events,
+  ...outboundMethods
+};
+export {
+  mega
+};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@megaeth-labs/wallet-sdk",
+  "version": "0.1.0-beta.1",
+  "description": "MegaETH Wallet SDK for web applications",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "megaeth",
+    "wallet",
+    "sdk",
+    "web3"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/megaeth-labs/wallet-sdk.git"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "restricted"
+  },
+  "dependencies": {
+    "penpal": "7.0.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.6",
+    "@types/node": "25.3.5",
+    "@vitest/coverage-v8": "4.0.18",
+    "@vitest/ui": "4.0.18",
+    "husky": "^9.1.7",
+    "jsdom": "28.1.0",
+    "lint-staged": "^16.4.0",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18"
+  },
+  "lint-staged": {
+    "src/**/*.{ts,js,json}": [
+      "pnpm format"
+    ]
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "dev:link": "pnpm build && pnpm link --global",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "lint": "biome lint ./src",
+    "format": "biome format --write ./src",
+    "check": "biome check ./src",
+    "typecheck": "tsc --noEmit"
+  }
+}