@thru/embedded-provider 0.0.4

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+import { PostMessageRequest, InferSuccessfulPostMessageResponse, ConnectMetadataInput } from '@thru/protocol';
+export { ConnectResult, EmbeddedProviderEvent, ErrorCode, PostMessageEvent, PostMessageRequest, PostMessageResponse, RequestType, SignMessagePayload, SignMessageResult, SignTransactionPayload, SignTransactionResult } from '@thru/protocol';
+import { AddressType, ConnectResult, WalletAddress, IThruChain } from '@thru/chain-interfaces';
+export { IThruChain, WalletAddress } from '@thru/chain-interfaces';
+
+/**
+ * Manages iframe lifecycle and postMessage communication
+ * Handles creating, showing/hiding iframe, and message passing
+ */
+declare class IframeManager {
+    private iframe;
+    private iframeUrl;
+    private iframeOrigin;
+    private messageHandlers;
+    private messageListener;
+    private readyPromise;
+    /**
+     * Callback for event broadcasts from iframe (no request id)
+     */
+    onEvent?: (eventType: string, payload: any) => void;
+    constructor(iframeUrl: string);
+    /**
+     * Create and inject iframe into DOM
+     * Returns a promise that resolves when iframe is ready
+     */
+    createIframe(): Promise<void>;
+    /**
+     * Wait for iframe to send 'ready' signal
+     */
+    private waitForReady;
+    /**
+     * Show iframe modal
+     */
+    show(): void;
+    /**
+     * Hide iframe modal
+     */
+    hide(): void;
+    /**
+     * Send message to iframe and wait for response
+     */
+    sendMessage<TRequest extends PostMessageRequest>(request: TRequest): Promise<InferSuccessfulPostMessageResponse<TRequest>>;
+    /**
+     * Handle incoming messages from iframe
+     */
+    private handleMessage;
+    /**
+     * Handle event broadcasts from iframe
+     */
+    private handleEvent;
+    /**
+     * Destroy iframe and cleanup
+     */
+    destroy(): void;
+}
+
+interface EmbeddedProviderConfig {
+    iframeUrl?: string;
+    addressTypes?: AddressType[];
+}
+interface ConnectOptions {
+    metadata?: ConnectMetadataInput;
+}
+/**
+ * Main embedded provider class
+ * Manages iframe lifecycle, connection state, and chain-specific interfaces
+ */
+declare class EmbeddedProvider {
+    private iframeManager;
+    private _thruChain?;
+    private connected;
+    private addresses;
+    private eventListeners;
+    constructor(config: EmbeddedProviderConfig);
+    /**
+     * Initialize the provider (must be called before use)
+     * Creates iframe and waits for it to be ready
+     */
+    initialize(): Promise<void>;
+    /**
+     * Connect to wallet
+     * Shows iframe modal and requests connection
+     */
+    connect(options?: ConnectOptions): Promise<ConnectResult>;
+    /**
+     * Disconnect from wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get addresses
+     */
+    getAddresses(): WalletAddress[];
+    /**
+     * Get Solana chain API
+     */
+    get thru(): IThruChain;
+    /**
+     * Event emitter: on
+     */
+    on(event: string, callback: Function): void;
+    /**
+     * Event emitter: off
+     */
+    off(event: string, callback: Function): void;
+    /**
+     * Emit event to all listeners
+     */
+    private emit;
+    /**
+     * Get iframe manager (for chain implementations)
+     * @internal
+     */
+    getIframeManager(): IframeManager;
+    /**
+     * Destroy provider and cleanup
+     */
+    destroy(): void;
+}
+
+/**
+ * EmbeddedThruChain - postMessage-backed Thru chain adapter.
+ */
+declare class EmbeddedThruChain implements IThruChain {
+    private readonly iframeManager;
+    private readonly provider;
+    constructor(iframeManager: IframeManager, provider: EmbeddedProvider);
+    get publicKey(): string | null;
+    get connected(): boolean;
+    connect(): Promise<{
+        publicKey: string;
+    }>;
+    disconnect(): Promise<void>;
+    signTransaction(serializedTransaction: string): Promise<string>;
+}
+
+export { type ConnectOptions, EmbeddedProvider, type EmbeddedProviderConfig, EmbeddedThruChain, IframeManager };

package/dist/index.js

@@ -0,0 +1,346 @@
+import { POST_MESSAGE_EVENT_TYPE, POST_MESSAGE_REQUEST_TYPES, createRequestId, DEFAULT_IFRAME_URL, EMBEDDED_PROVIDER_EVENTS, IFRAME_READY_EVENT } from '@thru/protocol';
+export { ErrorCode } from '@thru/protocol';
+
+// src/types/messages.ts
+
+// src/IframeManager.ts
+var IframeManager = class {
+  constructor(iframeUrl) {
+    this.iframe = null;
+    this.messageHandlers = /* @__PURE__ */ new Map();
+    this.messageListener = null;
+    this.readyPromise = null;
+    this.iframeUrl = iframeUrl;
+    this.iframeOrigin = new URL(iframeUrl).origin;
+  }
+  /**
+   * Create and inject iframe into DOM
+   * Returns a promise that resolves when iframe is ready
+   */
+  async createIframe() {
+    if (this.readyPromise) {
+      return this.readyPromise;
+    }
+    this.readyPromise = (async () => {
+      if (!this.iframe) {
+        this.iframe = document.createElement("iframe");
+        this.iframe.src = this.iframeUrl;
+        this.iframe.style.cssText = `
+          position: fixed;
+          top: 0;
+          left: 0;
+          width: 100%;
+          height: 100%;
+          border: none;
+          z-index: 999999;
+          display: none;
+          background: rgba(0, 0, 0, 0.5);
+        `;
+        document.body.appendChild(this.iframe);
+        this.messageListener = this.handleMessage.bind(this);
+        window.addEventListener("message", this.messageListener);
+      }
+      await this.waitForReady();
+    })();
+    return this.readyPromise;
+  }
+  /**
+   * Wait for iframe to send 'ready' signal
+   */
+  waitForReady() {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error("Iframe ready timeout - wallet failed to load"));
+      }, 1e4);
+      const readyHandler = (event) => {
+        if (event.origin !== this.iframeOrigin) {
+          return;
+        }
+        if (event.data.type === IFRAME_READY_EVENT) {
+          clearTimeout(timeout);
+          window.removeEventListener("message", readyHandler);
+          resolve();
+        }
+      };
+      window.addEventListener("message", readyHandler);
+    });
+  }
+  /**
+   * Show iframe modal
+   */
+  show() {
+    if (this.iframe) {
+      this.iframe.style.display = "block";
+    }
+  }
+  /**
+   * Hide iframe modal
+   */
+  hide() {
+    if (this.iframe) {
+      this.iframe.style.display = "none";
+    }
+  }
+  /**
+   * Send message to iframe and wait for response
+   */
+  async sendMessage(request) {
+    if (!this.iframe?.contentWindow) {
+      throw new Error("Iframe not initialized - call createIframe() first");
+    }
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.messageHandlers.delete(request.id);
+        reject(new Error("Request timeout - wallet did not respond"));
+      }, 3e4);
+      this.messageHandlers.set(request.id, (response) => {
+        clearTimeout(timeout);
+        this.messageHandlers.delete(request.id);
+        if (response.success) {
+          resolve(response);
+        } else {
+          const error = new Error(response.error?.message || "Unknown error");
+          error.code = response.error?.code;
+          reject(error);
+        }
+      });
+      this.iframe.contentWindow.postMessage(request, this.iframeOrigin);
+    });
+  }
+  /**
+   * Handle incoming messages from iframe
+   */
+  handleMessage(event) {
+    const iframeOrigin = new URL(this.iframeUrl).origin;
+    if (event.origin !== iframeOrigin) {
+      return;
+    }
+    const data = event.data;
+    if (data.id && this.messageHandlers.has(data.id)) {
+      const handler = this.messageHandlers.get(data.id);
+      if (handler) {
+        handler(data);
+      }
+      return;
+    }
+    if (data.type === POST_MESSAGE_EVENT_TYPE) {
+      this.handleEvent(data);
+    }
+  }
+  /**
+   * Handle event broadcasts from iframe
+   */
+  handleEvent(data) {
+    if (this.onEvent) {
+      this.onEvent(data.event, data.data);
+    }
+  }
+  /**
+   * Destroy iframe and cleanup
+   */
+  destroy() {
+    if (this.iframe) {
+      this.iframe.remove();
+      this.iframe = null;
+    }
+    this.readyPromise = null;
+    if (this.messageListener) {
+      window.removeEventListener("message", this.messageListener);
+      this.messageListener = null;
+    }
+    this.messageHandlers.clear();
+  }
+};
+
+// ../chain-interfaces/dist/index.js
+var AddressType = {
+  THRU: "thru"
+};
+var EmbeddedThruChain = class {
+  constructor(iframeManager, provider) {
+    this.iframeManager = iframeManager;
+    this.provider = provider;
+  }
+  get publicKey() {
+    const addresses = this.provider.getAddresses();
+    const thruAddress = addresses.find((addr) => addr.addressType === AddressType.THRU);
+    return thruAddress?.address ?? null;
+  }
+  get connected() {
+    return this.provider.isConnected();
+  }
+  async connect() {
+    const result = await this.provider.connect();
+    const thruAddress = result.addresses.find((addr) => addr.addressType === AddressType.THRU);
+    if (!thruAddress) {
+      throw new Error("Thru address not found in connection result");
+    }
+    return { publicKey: thruAddress.address };
+  }
+  async disconnect() {
+    await this.provider.disconnect();
+  }
+  async signTransaction(serializedTransaction) {
+    if (!this.provider.isConnected()) {
+      throw new Error("Wallet not connected");
+    }
+    if (typeof serializedTransaction !== "string" || serializedTransaction.length === 0) {
+      throw new Error("Transaction payload must be a base64 encoded string");
+    }
+    this.iframeManager.show();
+    try {
+      const response = await this.iframeManager.sendMessage({
+        id: createRequestId(),
+        type: POST_MESSAGE_REQUEST_TYPES.SIGN_TRANSACTION,
+        payload: { transaction: serializedTransaction },
+        origin: window.location.origin
+      });
+      return response.result.signedTransaction;
+    } finally {
+      this.iframeManager.hide();
+    }
+  }
+};
+var EmbeddedProvider = class {
+  constructor(config) {
+    this.connected = false;
+    this.addresses = [];
+    this.eventListeners = /* @__PURE__ */ new Map();
+    const iframeUrl = config.iframeUrl || DEFAULT_IFRAME_URL;
+    this.iframeManager = new IframeManager(iframeUrl);
+    this.iframeManager.onEvent = (eventType, payload) => {
+      this.emit(eventType, payload);
+      if (eventType === EMBEDDED_PROVIDER_EVENTS.DISCONNECT || eventType === EMBEDDED_PROVIDER_EVENTS.LOCK) {
+        this.connected = false;
+        this.addresses = [];
+      }
+    };
+    const addressTypes = config.addressTypes || [AddressType.THRU];
+    if (addressTypes.includes(AddressType.THRU)) {
+      this._thruChain = new EmbeddedThruChain(this.iframeManager, this);
+    }
+  }
+  /**
+   * Initialize the provider (must be called before use)
+   * Creates iframe and waits for it to be ready
+   */
+  async initialize() {
+    await this.iframeManager.createIframe();
+  }
+  /**
+   * Connect to wallet
+   * Shows iframe modal and requests connection
+   */
+  async connect(options) {
+    this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT_START, {});
+    this.iframeManager.show();
+    try {
+      const payload = {};
+      if (options?.metadata) {
+        payload.metadata = options.metadata;
+      }
+      const response = await this.iframeManager.sendMessage({
+        id: createRequestId(),
+        type: POST_MESSAGE_REQUEST_TYPES.CONNECT,
+        payload,
+        origin: window.location.origin
+      });
+      this.connected = true;
+      this.addresses = response.result.addresses;
+      this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT, response.result);
+      this.iframeManager.hide();
+      return response.result;
+    } catch (error) {
+      this.iframeManager.hide();
+      this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT_ERROR, { error });
+      throw error;
+    }
+  }
+  /**
+   * Disconnect from wallet
+   */
+  async disconnect() {
+    try {
+      await this.iframeManager.sendMessage({
+        id: createRequestId(),
+        type: POST_MESSAGE_REQUEST_TYPES.DISCONNECT,
+        origin: window.location.origin
+      });
+      this.connected = false;
+      this.addresses = [];
+      this.iframeManager.hide();
+      this.emit(EMBEDDED_PROVIDER_EVENTS.DISCONNECT, {});
+    } catch (error) {
+      this.emit(EMBEDDED_PROVIDER_EVENTS.ERROR, { error });
+      throw error;
+    }
+  }
+  /**
+   * Check if connected
+   */
+  isConnected() {
+    return this.connected;
+  }
+  /**
+   * Get addresses
+   */
+  getAddresses() {
+    return this.addresses;
+  }
+  /**
+   * Get Solana chain API
+   */
+  get thru() {
+    if (!this._thruChain) {
+      throw new Error("Thru chain not enabled in provider config");
+    }
+    return this._thruChain;
+  }
+  /**
+   * Event emitter: on
+   */
+  on(event, callback) {
+    if (!this.eventListeners.has(event)) {
+      this.eventListeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this.eventListeners.get(event).add(callback);
+  }
+  /**
+   * Event emitter: off
+   */
+  off(event, callback) {
+    this.eventListeners.get(event)?.delete(callback);
+  }
+  /**
+   * Emit event to all listeners
+   */
+  emit(event, data) {
+    this.eventListeners.get(event)?.forEach((callback) => {
+      try {
+        callback(data);
+      } catch (error) {
+        console.error(`Error in event listener for ${event}:`, error);
+      }
+    });
+  }
+  /**
+   * Get iframe manager (for chain implementations)
+   * @internal
+   */
+  getIframeManager() {
+    return this.iframeManager;
+  }
+  /**
+   * Destroy provider and cleanup
+   */
+  destroy() {
+    this.iframeManager.destroy();
+    this.eventListeners.clear();
+    this.connected = false;
+    this.addresses = [];
+  }
+};
+
+export { EmbeddedProvider, EmbeddedThruChain, IframeManager };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/IframeManager.ts","../../chain-interfaces/src/types.ts","../src/chains/ThruChain.ts","../src/EmbeddedProvider.ts"],"names":["createRequestId","POST_MESSAGE_REQUEST_TYPES","DEFAULT_IFRAME_URL","EMBEDDED_PROVIDER_EVENTS"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  InferSuccessfulPostMessageResponse,\n  PostMessageEvent,\n  PostMessageRequest,\n  PostMessageResponse,\n} from './types/messages';\nimport { IFRAME_READY_EVENT, POST_MESSAGE_EVENT_TYPE } from './types/messages';\n\n/**\n * Manages iframe lifecycle and postMessage communication\n * Handles creating, showing/hiding iframe, and message passing\n */\nexport class IframeManager {\n  private iframe: HTMLIFrameElement | null = null;\n  private iframeUrl: string;\n  private iframeOrigin: string;\n  private messageHandlers = new Map<string, (response: PostMessageResponse) => void>();\n  private messageListener: ((event: MessageEvent) => void) | null = null;\n  private readyPromise: Promise<void> | null = null;\n\n  /**\n   * Callback for event broadcasts from iframe (no request id)\n   */\n  public onEvent?: (eventType: string, payload: any) => void;\n\n  constructor(iframeUrl: string) {\n    this.iframeUrl = iframeUrl;\n    this.iframeOrigin = new URL(iframeUrl).origin;\n  }\n\n  /**\n   * Create and inject iframe into DOM\n   * Returns a promise that resolves when iframe is ready\n   */\n  async createIframe(): Promise<void> {\n    if (this.readyPromise) {\n      return this.readyPromise;\n    }\n\n    this.readyPromise = (async () => {\n      if (!this.iframe) {\n        this.iframe = document.createElement('iframe');\n        this.iframe.src = this.iframeUrl;\n        this.iframe.style.cssText = `\n          position: fixed;\n          top: 0;\n          left: 0;\n          width: 100%;\n          height: 100%;\n          border: none;\n          z-index: 999999;\n          display: none;\n          background: rgba(0, 0, 0, 0.5);\n        `;\n\n        document.body.appendChild(this.iframe);\n\n        // Set up message listener\n        this.messageListener = this.handleMessage.bind(this);\n        window.addEventListener('message', this.messageListener);\n      }\n\n      // Wait for iframe ready signal\n      await this.waitForReady();\n    })();\n\n    return this.readyPromise;\n  }\n\n  /**\n   * Wait for iframe to send 'ready' signal\n   */\n  private waitForReady(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        reject(new Error('Iframe ready timeout - wallet failed to load'));\n      }, 10000); // 10 second timeout\n\n      const readyHandler = (event: MessageEvent) => {\n        if (event.origin !== this.iframeOrigin) {\n          return;\n        }\n\n        if (event.data.type === IFRAME_READY_EVENT) {\n          clearTimeout(timeout);\n          window.removeEventListener('message', readyHandler);\n          resolve();\n        }\n      };\n\n      window.addEventListener('message', readyHandler);\n    });\n  }\n\n  /**\n   * Show iframe modal\n   */\n  show(): void {\n    if (this.iframe) {\n      this.iframe.style.display = 'block';\n    }\n  }\n\n  /**\n   * Hide iframe modal\n   */\n  hide(): void {\n    if (this.iframe) {\n      this.iframe.style.display = 'none';\n    }\n  }\n\n  /**\n   * Send message to iframe and wait for response\n   */\n  async sendMessage<TRequest extends PostMessageRequest>(\n    request: TRequest\n  ): Promise<InferSuccessfulPostMessageResponse<TRequest>> {\n    if (!this.iframe?.contentWindow) {\n      throw new Error('Iframe not initialized - call createIframe() first');\n    }\n\n    return new Promise<InferSuccessfulPostMessageResponse<TRequest>>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.messageHandlers.delete(request.id);\n        reject(new Error('Request timeout - wallet did not respond'));\n      }, 30000); // 30 second timeout\n\n      // Store handler for this request\n      this.messageHandlers.set(request.id, (response: PostMessageResponse) => {\n        clearTimeout(timeout);\n        this.messageHandlers.delete(request.id);\n\n        if (response.success) {\n          resolve(response as InferSuccessfulPostMessageResponse<TRequest>);\n        } else {\n          const error = new Error(response.error?.message || 'Unknown error');\n          (error as any).code = response.error?.code;\n          reject(error);\n        }\n      });\n\n      // Send message to iframe\n      this.iframe!.contentWindow!.postMessage(request, this.iframeOrigin);\n    });\n  }\n\n  /**\n   * Handle incoming messages from iframe\n   */\n  private handleMessage(event: MessageEvent): void {\n    // Validate origin\n    const iframeOrigin = new URL(this.iframeUrl).origin;\n    if (event.origin !== iframeOrigin) {\n      return; // Ignore messages from other origins\n    }\n\n    const data = event.data;\n\n    // Handle response to a specific request (has id)\n    if (data.id && this.messageHandlers.has(data.id)) {\n      const handler = this.messageHandlers.get(data.id);\n      if (handler) {\n        handler(data as PostMessageResponse);\n      }\n      return;\n    }\n\n    // Handle event broadcasts (type === 'event')\n    if (data.type === POST_MESSAGE_EVENT_TYPE) {\n      this.handleEvent(data as PostMessageEvent);\n    }\n  }\n\n  /**\n   * Handle event broadcasts from iframe\n   */\n  private handleEvent(data: PostMessageEvent): void {\n    // Forward to EmbeddedProvider via callback\n    if (this.onEvent) {\n      this.onEvent(data.event, data.data);\n    }\n  }\n\n  /**\n   * Destroy iframe and cleanup\n   */\n  destroy(): void {\n    if (this.iframe) {\n      this.iframe.remove();\n      this.iframe = null;\n    }\n\n    this.readyPromise = null;\n\n    if (this.messageListener) {\n      window.removeEventListener('message', this.messageListener);\n      this.messageListener = null;\n    }\n\n    this.messageHandlers.clear();\n  }\n}\n","export const AddressType = {\n  THRU: 'thru',\n} as const;\n\nexport type AddressType = typeof AddressType[keyof typeof AddressType];\n\nexport interface WalletAddress {\n  addressType: AddressType;\n  address: string;\n}\n\nexport interface AppMetadata {\n  appId: string;\n  appName: string;\n  appUrl: string;\n  imageUrl?: string;\n}\n\nexport interface ConnectResult {\n  walletId?: string;\n  addresses: WalletAddress[];\n  status?: 'pending' | 'completed';\n  metadata?: AppMetadata;\n}\n\nexport interface ConnectedApp {\n  accountId: number;\n  appId: string;\n  origin: string;\n  metadata: AppMetadata;\n  connectedAt: number;\n  updatedAt: number;\n}\n\nexport interface SignMessageParams {\n  message: string | Uint8Array;\n  networkId: string;\n}\n\nexport interface SignMessageResult {\n  signature: Uint8Array;\n  publicKey: string;\n}\n","import { AddressType, type IThruChain } from '@thru/chain-interfaces';\nimport { POST_MESSAGE_REQUEST_TYPES, createRequestId } from '@thru/protocol';\nimport type { EmbeddedProvider } from '../EmbeddedProvider';\nimport type { IframeManager } from '../IframeManager';\n\n/**\n * EmbeddedThruChain - postMessage-backed Thru chain adapter.\n */\nexport class EmbeddedThruChain implements IThruChain {\n  private readonly iframeManager: IframeManager;\n  private readonly provider: EmbeddedProvider;\n\n  constructor(iframeManager: IframeManager, provider: EmbeddedProvider) {\n    this.iframeManager = iframeManager;\n    this.provider = provider;\n  }\n\n  get publicKey(): string | null {\n    const addresses = this.provider.getAddresses();\n    const thruAddress = addresses.find((addr) => addr.addressType === AddressType.THRU);\n    return thruAddress?.address ?? null;\n  }\n\n  get connected(): boolean {\n    return this.provider.isConnected();\n  }\n\n  async connect(): Promise<{ publicKey: string }> {\n    const result = await this.provider.connect();\n    const thruAddress = result.addresses.find((addr) => addr.addressType === AddressType.THRU);\n\n    if (!thruAddress) {\n      throw new Error('Thru address not found in connection result');\n    }\n\n    return { publicKey: thruAddress.address };\n  }\n\n  async disconnect(): Promise<void> {\n    await this.provider.disconnect();\n  }\n\n  async signTransaction(serializedTransaction: string): Promise<string> {\n    if (!this.provider.isConnected()) {\n      throw new Error('Wallet not connected');\n    }\n    if (typeof serializedTransaction !== 'string' || serializedTransaction.length === 0) {\n      throw new Error('Transaction payload must be a base64 encoded string');\n    }\n\n    this.iframeManager.show();\n\n    try {\n      const response = await this.iframeManager.sendMessage({\n        id: createRequestId(),\n        type: POST_MESSAGE_REQUEST_TYPES.SIGN_TRANSACTION,\n        payload: { transaction: serializedTransaction },\n        origin: window.location.origin,\n      });\n      return response.result.signedTransaction;\n    } finally {\n      this.iframeManager.hide();\n    }\n  }\n}\n","import { IframeManager } from './IframeManager';\nimport { EmbeddedThruChain } from './chains/ThruChain';\nimport {\n  DEFAULT_IFRAME_URL,\n  POST_MESSAGE_REQUEST_TYPES,\n  EMBEDDED_PROVIDER_EVENTS,\n  createRequestId,\n  type ConnectMetadataInput,\n  type ConnectRequestPayload,\n} from '@thru/protocol';\nimport { AddressType } from '@thru/chain-interfaces';\nimport type {\n  IThruChain,\n  WalletAddress,\n  ConnectResult,\n  AddressType as AddressTypeValue,\n} from '@thru/chain-interfaces';\n\nexport interface EmbeddedProviderConfig {\n  iframeUrl?: string;\n  addressTypes?: AddressTypeValue[];\n}\n\nexport interface ConnectOptions {\n  metadata?: ConnectMetadataInput;\n}\n\n/**\n * Main embedded provider class\n * Manages iframe lifecycle, connection state, and chain-specific interfaces\n */\nexport class EmbeddedProvider {\n  private iframeManager: IframeManager;\n  private _thruChain?: IThruChain;\n  private connected = false;\n  private addresses: WalletAddress[] = [];\n  private eventListeners = new Map<string, Set<Function>>();\n  constructor(config: EmbeddedProviderConfig) {\n    const iframeUrl = config.iframeUrl || DEFAULT_IFRAME_URL;\n    this.iframeManager = new IframeManager(iframeUrl);\n\n    // Set up event forwarding from iframe\n    this.iframeManager.onEvent = (eventType: string, payload: any) => {\n      this.emit(eventType, payload);\n\n      // Handle specific events\n      if (\n        eventType === EMBEDDED_PROVIDER_EVENTS.DISCONNECT ||\n        eventType === EMBEDDED_PROVIDER_EVENTS.LOCK\n      ) {\n        this.connected = false;\n        this.addresses = [];\n      }\n    };\n\n    // Create chain instances\n    const addressTypes = config.addressTypes || [AddressType.THRU];\n    if (addressTypes.includes(AddressType.THRU)) {\n      this._thruChain = new EmbeddedThruChain(this.iframeManager, this);\n    }\n  }\n\n  /**\n   * Initialize the provider (must be called before use)\n   * Creates iframe and waits for it to be ready\n   */\n  async initialize(): Promise<void> {\n    await this.iframeManager.createIframe();\n  }\n\n  /**\n   * Connect to wallet\n   * Shows iframe modal and requests connection\n   */\n  async connect(options?: ConnectOptions): Promise<ConnectResult> {\n    // Emit connecting event\n    this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT_START, {});\n\n    // Show iframe modal\n    this.iframeManager.show();\n\n    try {\n      const payload: ConnectRequestPayload = {};\n\n      if (options?.metadata) {\n        payload.metadata = options.metadata;\n      }\n\n      const response = await this.iframeManager.sendMessage({\n        id: createRequestId(),\n        type: POST_MESSAGE_REQUEST_TYPES.CONNECT,\n        payload,\n        origin: window.location.origin,\n      });\n\n      this.connected = true;\n      this.addresses = response.result.addresses;\n\n      // Emit success event\n      this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT, response.result);\n\n      // Hide iframe after successful connection\n      this.iframeManager.hide();\n\n      return response.result;\n    } catch (error) {\n      this.iframeManager.hide();\n      this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT_ERROR, { error });\n      throw error;\n    }\n  }\n\n  /**\n   * Disconnect from wallet\n   */\n  async disconnect(): Promise<void> {\n    try {\n      await this.iframeManager.sendMessage({\n        id: createRequestId(),\n        type: POST_MESSAGE_REQUEST_TYPES.DISCONNECT,\n        origin: window.location.origin,\n      });\n\n      this.connected = false;\n      this.addresses = [];\n      this.iframeManager.hide();\n\n      this.emit(EMBEDDED_PROVIDER_EVENTS.DISCONNECT, {});\n    } catch (error) {\n      this.emit(EMBEDDED_PROVIDER_EVENTS.ERROR, { error });\n      throw error;\n    }\n  }\n\n  /**\n   * Check if connected\n   */\n  isConnected(): boolean {\n    return this.connected;\n  }\n\n  /**\n   * Get addresses\n   */\n  getAddresses(): WalletAddress[] {\n    return this.addresses;\n  }\n\n  /**\n   * Get Solana chain API\n   */\n  get thru(): IThruChain {\n    if (!this._thruChain) {\n      throw new Error('Thru chain not enabled in provider config');\n    }\n    return this._thruChain;\n  }\n\n  /**\n   * Event emitter: on\n   */\n  on(event: string, callback: Function): void {\n    if (!this.eventListeners.has(event)) {\n      this.eventListeners.set(event, new Set());\n    }\n    this.eventListeners.get(event)!.add(callback);\n  }\n\n  /**\n   * Event emitter: off\n   */\n  off(event: string, callback: Function): void {\n    this.eventListeners.get(event)?.delete(callback);\n  }\n\n  /**\n   * Emit event to all listeners\n   */\n  private emit(event: string, data?: any): void {\n    this.eventListeners.get(event)?.forEach(callback => {\n      try {\n        callback(data);\n      } catch (error) {\n        console.error(`Error in event listener for ${event}:`, error);\n      }\n    });\n  }\n\n  /**\n   * Get iframe manager (for chain implementations)\n   * @internal\n   */\n  getIframeManager(): IframeManager {\n    return this.iframeManager;\n  }\n\n  /**\n   * Destroy provider and cleanup\n   */\n  destroy(): void {\n    this.iframeManager.destroy();\n    this.eventListeners.clear();\n    this.connected = false;\n    this.addresses = [];\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@thru/embedded-provider",
+  "version": "0.0.4",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@thru/chain-interfaces": "0.0.4",
+    "@thru/protocol": "0.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}

package/src/EmbeddedProvider.ts

@@ -0,0 +1,206 @@
+import { IframeManager } from './IframeManager';
+import { EmbeddedThruChain } from './chains/ThruChain';
+import {
+  DEFAULT_IFRAME_URL,
+  POST_MESSAGE_REQUEST_TYPES,
+  EMBEDDED_PROVIDER_EVENTS,
+  createRequestId,
+  type ConnectMetadataInput,
+  type ConnectRequestPayload,
+} from '@thru/protocol';
+import { AddressType } from '@thru/chain-interfaces';
+import type {
+  IThruChain,
+  WalletAddress,
+  ConnectResult,
+  AddressType as AddressTypeValue,
+} from '@thru/chain-interfaces';
+
+export interface EmbeddedProviderConfig {
+  iframeUrl?: string;
+  addressTypes?: AddressTypeValue[];
+}
+
+export interface ConnectOptions {
+  metadata?: ConnectMetadataInput;
+}
+
+/**
+ * Main embedded provider class
+ * Manages iframe lifecycle, connection state, and chain-specific interfaces
+ */
+export class EmbeddedProvider {
+  private iframeManager: IframeManager;
+  private _thruChain?: IThruChain;
+  private connected = false;
+  private addresses: WalletAddress[] = [];
+  private eventListeners = new Map<string, Set<Function>>();
+  constructor(config: EmbeddedProviderConfig) {
+    const iframeUrl = config.iframeUrl || DEFAULT_IFRAME_URL;
+    this.iframeManager = new IframeManager(iframeUrl);
+
+    // Set up event forwarding from iframe
+    this.iframeManager.onEvent = (eventType: string, payload: any) => {
+      this.emit(eventType, payload);
+
+      // Handle specific events
+      if (
+        eventType === EMBEDDED_PROVIDER_EVENTS.DISCONNECT ||
+        eventType === EMBEDDED_PROVIDER_EVENTS.LOCK
+      ) {
+        this.connected = false;
+        this.addresses = [];
+      }
+    };
+
+    // Create chain instances
+    const addressTypes = config.addressTypes || [AddressType.THRU];
+    if (addressTypes.includes(AddressType.THRU)) {
+      this._thruChain = new EmbeddedThruChain(this.iframeManager, this);
+    }
+  }
+
+  /**
+   * Initialize the provider (must be called before use)
+   * Creates iframe and waits for it to be ready
+   */
+  async initialize(): Promise<void> {
+    await this.iframeManager.createIframe();
+  }
+
+  /**
+   * Connect to wallet
+   * Shows iframe modal and requests connection
+   */
+  async connect(options?: ConnectOptions): Promise<ConnectResult> {
+    // Emit connecting event
+    this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT_START, {});
+
+    // Show iframe modal
+    this.iframeManager.show();
+
+    try {
+      const payload: ConnectRequestPayload = {};
+
+      if (options?.metadata) {
+        payload.metadata = options.metadata;
+      }
+
+      const response = await this.iframeManager.sendMessage({
+        id: createRequestId(),
+        type: POST_MESSAGE_REQUEST_TYPES.CONNECT,
+        payload,
+        origin: window.location.origin,
+      });
+
+      this.connected = true;
+      this.addresses = response.result.addresses;
+
+      // Emit success event
+      this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT, response.result);
+
+      // Hide iframe after successful connection
+      this.iframeManager.hide();
+
+      return response.result;
+    } catch (error) {
+      this.iframeManager.hide();
+      this.emit(EMBEDDED_PROVIDER_EVENTS.CONNECT_ERROR, { error });
+      throw error;
+    }
+  }
+
+  /**
+   * Disconnect from wallet
+   */
+  async disconnect(): Promise<void> {
+    try {
+      await this.iframeManager.sendMessage({
+        id: createRequestId(),
+        type: POST_MESSAGE_REQUEST_TYPES.DISCONNECT,
+        origin: window.location.origin,
+      });
+
+      this.connected = false;
+      this.addresses = [];
+      this.iframeManager.hide();
+
+      this.emit(EMBEDDED_PROVIDER_EVENTS.DISCONNECT, {});
+    } catch (error) {
+      this.emit(EMBEDDED_PROVIDER_EVENTS.ERROR, { error });
+      throw error;
+    }
+  }
+
+  /**
+   * Check if connected
+   */
+  isConnected(): boolean {
+    return this.connected;
+  }
+
+  /**
+   * Get addresses
+   */
+  getAddresses(): WalletAddress[] {
+    return this.addresses;
+  }
+
+  /**
+   * Get Solana chain API
+   */
+  get thru(): IThruChain {
+    if (!this._thruChain) {
+      throw new Error('Thru chain not enabled in provider config');
+    }
+    return this._thruChain;
+  }
+
+  /**
+   * Event emitter: on
+   */
+  on(event: string, callback: Function): void {
+    if (!this.eventListeners.has(event)) {
+      this.eventListeners.set(event, new Set());
+    }
+    this.eventListeners.get(event)!.add(callback);
+  }
+
+  /**
+   * Event emitter: off
+   */
+  off(event: string, callback: Function): void {
+    this.eventListeners.get(event)?.delete(callback);
+  }
+
+  /**
+   * Emit event to all listeners
+   */
+  private emit(event: string, data?: any): void {
+    this.eventListeners.get(event)?.forEach(callback => {
+      try {
+        callback(data);
+      } catch (error) {
+        console.error(`Error in event listener for ${event}:`, error);
+      }
+    });
+  }
+
+  /**
+   * Get iframe manager (for chain implementations)
+   * @internal
+   */
+  getIframeManager(): IframeManager {
+    return this.iframeManager;
+  }
+
+  /**
+   * Destroy provider and cleanup
+   */
+  destroy(): void {
+    this.iframeManager.destroy();
+    this.eventListeners.clear();
+    this.connected = false;
+    this.addresses = [];
+  }
+}

package/src/IframeManager.ts

@@ -0,0 +1,203 @@
+import type {
+  InferSuccessfulPostMessageResponse,
+  PostMessageEvent,
+  PostMessageRequest,
+  PostMessageResponse,
+} from './types/messages';
+import { IFRAME_READY_EVENT, POST_MESSAGE_EVENT_TYPE } from './types/messages';
+
+/**
+ * Manages iframe lifecycle and postMessage communication
+ * Handles creating, showing/hiding iframe, and message passing
+ */
+export class IframeManager {
+  private iframe: HTMLIFrameElement | null = null;
+  private iframeUrl: string;
+  private iframeOrigin: string;
+  private messageHandlers = new Map<string, (response: PostMessageResponse) => void>();
+  private messageListener: ((event: MessageEvent) => void) | null = null;
+  private readyPromise: Promise<void> | null = null;
+
+  /**
+   * Callback for event broadcasts from iframe (no request id)
+   */
+  public onEvent?: (eventType: string, payload: any) => void;
+
+  constructor(iframeUrl: string) {
+    this.iframeUrl = iframeUrl;
+    this.iframeOrigin = new URL(iframeUrl).origin;
+  }
+
+  /**
+   * Create and inject iframe into DOM
+   * Returns a promise that resolves when iframe is ready
+   */
+  async createIframe(): Promise<void> {
+    if (this.readyPromise) {
+      return this.readyPromise;
+    }
+
+    this.readyPromise = (async () => {
+      if (!this.iframe) {
+        this.iframe = document.createElement('iframe');
+        this.iframe.src = this.iframeUrl;
+        this.iframe.style.cssText = `
+          position: fixed;
+          top: 0;
+          left: 0;
+          width: 100%;
+          height: 100%;
+          border: none;
+          z-index: 999999;
+          display: none;
+          background: rgba(0, 0, 0, 0.5);
+        `;
+
+        document.body.appendChild(this.iframe);
+
+        // Set up message listener
+        this.messageListener = this.handleMessage.bind(this);
+        window.addEventListener('message', this.messageListener);
+      }
+
+      // Wait for iframe ready signal
+      await this.waitForReady();
+    })();
+
+    return this.readyPromise;
+  }
+
+  /**
+   * Wait for iframe to send 'ready' signal
+   */
+  private waitForReady(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error('Iframe ready timeout - wallet failed to load'));
+      }, 10000); // 10 second timeout
+
+      const readyHandler = (event: MessageEvent) => {
+        if (event.origin !== this.iframeOrigin) {
+          return;
+        }
+
+        if (event.data.type === IFRAME_READY_EVENT) {
+          clearTimeout(timeout);
+          window.removeEventListener('message', readyHandler);
+          resolve();
+        }
+      };
+
+      window.addEventListener('message', readyHandler);
+    });
+  }
+
+  /**
+   * Show iframe modal
+   */
+  show(): void {
+    if (this.iframe) {
+      this.iframe.style.display = 'block';
+    }
+  }
+
+  /**
+   * Hide iframe modal
+   */
+  hide(): void {
+    if (this.iframe) {
+      this.iframe.style.display = 'none';
+    }
+  }
+
+  /**
+   * Send message to iframe and wait for response
+   */
+  async sendMessage<TRequest extends PostMessageRequest>(
+    request: TRequest
+  ): Promise<InferSuccessfulPostMessageResponse<TRequest>> {
+    if (!this.iframe?.contentWindow) {
+      throw new Error('Iframe not initialized - call createIframe() first');
+    }
+
+    return new Promise<InferSuccessfulPostMessageResponse<TRequest>>((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.messageHandlers.delete(request.id);
+        reject(new Error('Request timeout - wallet did not respond'));
+      }, 30000); // 30 second timeout
+
+      // Store handler for this request
+      this.messageHandlers.set(request.id, (response: PostMessageResponse) => {
+        clearTimeout(timeout);
+        this.messageHandlers.delete(request.id);
+
+        if (response.success) {
+          resolve(response as InferSuccessfulPostMessageResponse<TRequest>);
+        } else {
+          const error = new Error(response.error?.message || 'Unknown error');
+          (error as any).code = response.error?.code;
+          reject(error);
+        }
+      });
+
+      // Send message to iframe
+      this.iframe!.contentWindow!.postMessage(request, this.iframeOrigin);
+    });
+  }
+
+  /**
+   * Handle incoming messages from iframe
+   */
+  private handleMessage(event: MessageEvent): void {
+    // Validate origin
+    const iframeOrigin = new URL(this.iframeUrl).origin;
+    if (event.origin !== iframeOrigin) {
+      return; // Ignore messages from other origins
+    }
+
+    const data = event.data;
+
+    // Handle response to a specific request (has id)
+    if (data.id && this.messageHandlers.has(data.id)) {
+      const handler = this.messageHandlers.get(data.id);
+      if (handler) {
+        handler(data as PostMessageResponse);
+      }
+      return;
+    }
+
+    // Handle event broadcasts (type === 'event')
+    if (data.type === POST_MESSAGE_EVENT_TYPE) {
+      this.handleEvent(data as PostMessageEvent);
+    }
+  }
+
+  /**
+   * Handle event broadcasts from iframe
+   */
+  private handleEvent(data: PostMessageEvent): void {
+    // Forward to EmbeddedProvider via callback
+    if (this.onEvent) {
+      this.onEvent(data.event, data.data);
+    }
+  }
+
+  /**
+   * Destroy iframe and cleanup
+   */
+  destroy(): void {
+    if (this.iframe) {
+      this.iframe.remove();
+      this.iframe = null;
+    }
+
+    this.readyPromise = null;
+
+    if (this.messageListener) {
+      window.removeEventListener('message', this.messageListener);
+      this.messageListener = null;
+    }
+
+    this.messageHandlers.clear();
+  }
+}

package/src/chains/ThruChain.ts

@@ -0,0 +1,65 @@
+import { AddressType, type IThruChain } from '@thru/chain-interfaces';
+import { POST_MESSAGE_REQUEST_TYPES, createRequestId } from '@thru/protocol';
+import type { EmbeddedProvider } from '../EmbeddedProvider';
+import type { IframeManager } from '../IframeManager';
+
+/**
+ * EmbeddedThruChain - postMessage-backed Thru chain adapter.
+ */
+export class EmbeddedThruChain implements IThruChain {
+  private readonly iframeManager: IframeManager;
+  private readonly provider: EmbeddedProvider;
+
+  constructor(iframeManager: IframeManager, provider: EmbeddedProvider) {
+    this.iframeManager = iframeManager;
+    this.provider = provider;
+  }
+
+  get publicKey(): string | null {
+    const addresses = this.provider.getAddresses();
+    const thruAddress = addresses.find((addr) => addr.addressType === AddressType.THRU);
+    return thruAddress?.address ?? null;
+  }
+
+  get connected(): boolean {
+    return this.provider.isConnected();
+  }
+
+  async connect(): Promise<{ publicKey: string }> {
+    const result = await this.provider.connect();
+    const thruAddress = result.addresses.find((addr) => addr.addressType === AddressType.THRU);
+
+    if (!thruAddress) {
+      throw new Error('Thru address not found in connection result');
+    }
+
+    return { publicKey: thruAddress.address };
+  }
+
+  async disconnect(): Promise<void> {
+    await this.provider.disconnect();
+  }
+
+  async signTransaction(serializedTransaction: string): Promise<string> {
+    if (!this.provider.isConnected()) {
+      throw new Error('Wallet not connected');
+    }
+    if (typeof serializedTransaction !== 'string' || serializedTransaction.length === 0) {
+      throw new Error('Transaction payload must be a base64 encoded string');
+    }
+
+    this.iframeManager.show();
+
+    try {
+      const response = await this.iframeManager.sendMessage({
+        id: createRequestId(),
+        type: POST_MESSAGE_REQUEST_TYPES.SIGN_TRANSACTION,
+        payload: { transaction: serializedTransaction },
+        origin: window.location.origin,
+      });
+      return response.result.signedTransaction;
+    } finally {
+      this.iframeManager.hide();
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,23 @@
+// Main exports
+export { EmbeddedProvider, type EmbeddedProviderConfig, type ConnectOptions } from './EmbeddedProvider';
+export { IframeManager } from './IframeManager';
+export { EmbeddedThruChain } from './chains/ThruChain';
+
+// Type exports
+export type {
+  PostMessageRequest,
+  PostMessageResponse,
+  PostMessageEvent,
+  RequestType,
+  EmbeddedProviderEvent,
+  ConnectResult,
+  SignMessagePayload,
+  SignMessageResult,
+  SignTransactionPayload,
+  SignTransactionResult,
+} from './types/messages';
+
+export { ErrorCode } from './types/messages';
+
+// Re-export types from chain-interfaces for convenience
+export type { IThruChain, WalletAddress } from '@thru/chain-interfaces';

package/src/types/messages.ts

@@ -0,0 +1,30 @@
+export {
+  POST_MESSAGE_REQUEST_TYPES,
+  EMBEDDED_PROVIDER_EVENTS,
+  POST_MESSAGE_EVENT_TYPE,
+  IFRAME_READY_EVENT,
+  DEFAULT_IFRAME_URL,
+  createRequestId,
+  ErrorCode,
+  type RequestType,
+  type EmbeddedProviderEvent,
+  type PostMessageRequest,
+  type ConnectRequestMessage,
+  type DisconnectRequestMessage,
+  type SignMessageRequestMessage,
+  type SignTransactionRequestMessage,
+  type GetAccountsRequestMessage,
+  type DisconnectResult,
+  type GetAccountsResult,
+  type PostMessageResponse,
+  type SuccessfulPostMessageResponse,
+  type InferPostMessageResponse,
+  type InferSuccessfulPostMessageResponse,
+  type PostMessageEvent,
+  type ConnectRequestPayload,
+  type ConnectResult,
+  type SignMessagePayload,
+  type SignMessageResult,
+  type SignTransactionPayload,
+  type SignTransactionResult,
+} from '@thru/protocol';

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  treeshake: true,
+  platform: 'browser',
+  noExternal: ['@thru/chain-interfaces'],
+  external: [],
+});