@1sat/connect 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { RpcMethods } from './types';
 export { ErrorCodes, type ErrorCode, OneSatError, UserRejectedError, WalletLockedError, WalletNotConnectedError, InsufficientFundsError, PopupBlockedError, PopupClosedError, TimeoutError, fromErrorResponse, } from './errors';
 export { PROTOCOL_VERSION, MessageTypes, type MessageType, type BaseMessage, type RequestMessage, type ResponseMessage, type ProtocolMessage, createRequest, createResponse, createErrorResponse, isValidMessage, isResponse, } from './messages';
 export { saveConnection, loadConnection, clearConnection, hasStoredConnection, type StoredConnection, } from './storage';
+export { parsePopupParams, sendResponse, sendErrorResponse, rejectRequest, walletLockedError, walletNotConnectedError, closePopup, isPopupContext, getPopupContext, type PopupParams, } from './wallet';
 export { OneSatBrowserProvider } from './provider';
 export { PopupManager, type PopupConfig, type PendingRequest } from './popup';
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAG3D,YAAY,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,IAAI,EACJ,WAAW,GACX,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGpC,OAAO,EACN,UAAU,EACV,KAAK,SAAS,EACd,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GACjB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACN,gBAAgB,EAChB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,UAAU,GACV,MAAM,YAAY,CAAA;AAGnB,OAAO,EACN,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,KAAK,gBAAgB,GACrB,MAAM,WAAW,CAAA;AAGlB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7E;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAM1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAK9D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAgBlE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAE/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAuBrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAG3D,YAAY,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,IAAI,EACJ,WAAW,GACX,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGpC,OAAO,EACN,UAAU,EACV,KAAK,SAAS,EACd,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GACjB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACN,gBAAgB,EAChB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,UAAU,GACV,MAAM,YAAY,CAAA;AAGnB,OAAO,EACN,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,KAAK,gBAAgB,GACrB,MAAM,WAAW,CAAA;AAGlB,OAAO,EACN,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,cAAc,EACd,eAAe,EACf,KAAK,WAAW,GAChB,MAAM,UAAU,CAAA;AAGjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7E;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAM1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAK9D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAgBlE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAE/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAuBrE"}

package/dist/index.js

@@ -650,6 +650,72 @@ class OneSatBrowserProvider {
     this.events.removeAllListeners();
   }
 }
+// src/wallet.ts
+function parsePopupParams(searchParams) {
+  const requestId = searchParams.get("requestId");
+  const origin = searchParams.get("origin");
+  const method = searchParams.get("method");
+  const appName = searchParams.get("appName");
+  const paramsStr = searchParams.get("params");
+  let params = undefined;
+  if (paramsStr) {
+    try {
+      params = JSON.parse(decodeURIComponent(paramsStr));
+    } catch {}
+  }
+  return { requestId, origin, method, appName, params };
+}
+function sendResponse(requestId, result, origin) {
+  if (typeof window === "undefined")
+    return;
+  if (!window.opener) {
+    console.error("[onesat] No opener window found");
+    return;
+  }
+  const response = createResponse(requestId, result, origin);
+  window.opener.postMessage(response, origin);
+  window.close();
+}
+function sendErrorResponse(requestId, code, message, origin, data) {
+  if (typeof window === "undefined")
+    return;
+  if (!window.opener) {
+    console.error("[onesat] No opener window found");
+    return;
+  }
+  const response = createErrorResponse(requestId, code, message, origin, data);
+  window.opener.postMessage(response, origin);
+  window.close();
+}
+function rejectRequest(requestId, origin, reason = "User rejected the request") {
+  sendErrorResponse(requestId, ErrorCodes.USER_REJECTED, reason, origin);
+}
+function walletLockedError(requestId, origin) {
+  sendErrorResponse(requestId, ErrorCodes.WALLET_LOCKED, "Wallet is locked. Please unlock your wallet.", origin);
+}
+function walletNotConnectedError(requestId, origin) {
+  sendErrorResponse(requestId, ErrorCodes.WALLET_NOT_CONNECTED, "Wallet is not connected", origin);
+}
+function closePopup() {
+  if (typeof window !== "undefined") {
+    window.close();
+  }
+}
+function isPopupContext() {
+  if (typeof window === "undefined")
+    return false;
+  return window.opener !== null;
+}
+function getPopupContext(searchParams) {
+  const { requestId, origin, method, appName, params } = parsePopupParams(searchParams);
+  if (!requestId) {
+    throw new Error("Missing requestId in popup parameters");
+  }
+  if (!origin) {
+    throw new Error("Missing origin in popup parameters");
+  }
+  return { requestId, origin, method, appName, params };
+}
 
 // src/index.ts
 function isOneSatInjected() {
@@ -699,14 +765,22 @@ function waitForOneSat(timeout = 3000) {
   });
 }
 export {
+  walletNotConnectedError,
+  walletLockedError,
   waitForOneSat,
+  sendResponse,
+  sendErrorResponse,
   saveConnection,
+  rejectRequest,
+  parsePopupParams,
   loadConnection,
   isValidMessage,
   isResponse,
+  isPopupContext,
   isOneSatInjected,
   isOneSatAvailable,
   hasStoredConnection,
+  getPopupContext,
   getOneSat,
   getInjectedOneSat,
   fromErrorResponse,
@@ -714,6 +788,7 @@ export {
   createRequest,
   createOneSat,
   createErrorResponse,
+  closePopup,
   clearConnection,
   WalletNotConnectedError,
   WalletLockedError,

package/dist/wallet.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Wallet-side utilities for popup protocol
+ *
+ * Use these in your wallet's popup pages to handle requests from dApps.
+ *
+ * @example
+ * ```typescript
+ * import { parsePopupParams, sendResponse, sendErrorResponse, ErrorCodes } from '@1sat/connect'
+ *
+ * // In your popup page (e.g., /connect)
+ * const { requestId, origin, method, params } = parsePopupParams(
+ *   new URLSearchParams(window.location.search)
+ * )
+ *
+ * // After user approves
+ * sendResponse(requestId, { paymentAddress, ordinalAddress }, origin)
+ *
+ * // Or on error
+ * sendErrorResponse(requestId, ErrorCodes.USER_REJECTED, 'User rejected', origin)
+ * ```
+ */
+export interface PopupParams {
+    /** Unique request identifier for matching response */
+    requestId: string | null;
+    /** Origin of the requesting dApp */
+    origin: string | null;
+    /** RPC method being called (connect, signTransaction, etc.) */
+    method: string | null;
+    /** App name for display purposes */
+    appName: string | null;
+    /** Parsed request parameters */
+    params: unknown;
+}
+/**
+ * Parse popup URL query parameters
+ *
+ * Call this in your popup page to extract the request data from the URL.
+ */
+export declare function parsePopupParams(searchParams: URLSearchParams): PopupParams;
+/**
+ * Send a success response to the opener window and close the popup
+ */
+export declare function sendResponse(requestId: string, result: unknown, origin: string): void;
+/**
+ * Send an error response to the opener window and close the popup
+ */
+export declare function sendErrorResponse(requestId: string, code: number, message: string, origin: string, data?: unknown): void;
+/**
+ * Reject a request with USER_REJECTED error code
+ */
+export declare function rejectRequest(requestId: string, origin: string, reason?: string): void;
+/**
+ * Send a wallet locked error response
+ */
+export declare function walletLockedError(requestId: string, origin: string): void;
+/**
+ * Send a wallet not connected error response
+ */
+export declare function walletNotConnectedError(requestId: string, origin: string): void;
+/**
+ * Close the popup without sending a response
+ * The dApp will receive a POPUP_CLOSED error via the PopupManager
+ */
+export declare function closePopup(): void;
+/**
+ * Check if this page was opened as a popup by a dApp
+ */
+export declare function isPopupContext(): boolean;
+/**
+ * Get popup context with validated parameters
+ * Throws if required parameters are missing
+ */
+export declare function getPopupContext(searchParams: URLSearchParams): {
+    requestId: string;
+    origin: string;
+    method: string | null;
+    appName: string | null;
+    params: unknown;
+};
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,MAAM,WAAW,WAAW;IAC3B,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,oCAAoC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,eAAe,GAAG,WAAW,CAiB3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACZ,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,GACZ,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,SAA8B,GAClC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,eAAe,GAAG;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,OAAO,CAAA;CACf,CAYA"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@1sat/connect",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"description": "Connection layer for 1Sat wallet - popup flow, events, session management",
 	"type": "module",
 	"main": "./dist/index.js",