@swype-org/deposit 0.3.6 → 0.3.14

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DepositStatus, a as DepositResult, b as DepositError, c as DepositConfig, d as DepositRequest } from './types-DJikyy3z.js';
-export { C as CheckoutConfig, e as CheckoutError, f as CheckoutErrorCode, g as CheckoutStatus, h as DepositErrorCode, S as SignerFunction, i as SignerRequest, j as SignerResponse, T as TransferSummary, k as getDisplayMessage } from './types-DJikyy3z.js';
+import { D as DepositStatus, a as DepositResult, b as DepositError, c as DepositConfig, d as DepositRequest } from './types-DYsZwNXq.js';
+export { C as CheckoutConfig, e as CheckoutError, f as CheckoutErrorCode, g as CheckoutStatus, h as DepositErrorCode, S as SignerFunction, i as SignerRequest, j as SignerResponse, T as TransferSummary, k as getDisplayMessage } from './types-DYsZwNXq.js';
 
 declare const DEFAULT_WEBVIEW_BASE_URL = "https://pay.blink.cash";
 type EventMap = {
@@ -73,6 +73,162 @@ declare class Deposit {
 /** @deprecated Use {@link Deposit} instead. */
 declare const Checkout: typeof Deposit;
 
+/** Current wire-protocol version. Bump on breaking changes. */
+declare const BRIDGE_PROTOCOL_VERSION = 1;
+interface EIP6963ProviderInfo {
+    uuid: string;
+    name: string;
+    icon: string;
+    rdns: string;
+}
+interface EIP1193RequestArgs {
+    method: string;
+    params?: unknown[] | Record<string, unknown>;
+}
+interface EIP1193Provider {
+    request(args: EIP1193RequestArgs): Promise<unknown>;
+    on?: (event: string, listener: (...args: unknown[]) => void) => unknown;
+    removeListener?: (event: string, listener: (...args: unknown[]) => void) => unknown;
+}
+interface EIP6963ProviderDetail {
+    info: EIP6963ProviderInfo;
+    provider: EIP1193Provider;
+}
+/** Iframe → Parent: handshake, sent once on mount. */
+interface BridgeHelloMessage {
+    type: 'blink:bridge-hello';
+    protocolVersion: number;
+}
+/** Parent → Iframe: list of installed wallets the iframe can borrow. */
+interface WalletsAdvertisedMessage {
+    type: 'blink:wallets-advertised';
+    protocolVersion: number;
+    wallets: AdvertisedWallet[];
+}
+interface AdvertisedWallet {
+    uuid: string;
+    rdns: string;
+    name: string;
+    icon: string;
+}
+/** Iframe → Parent: invoke a JSON-RPC method on a top-frame wallet. */
+interface RpcRequestMessage {
+    type: 'blink:rpc-request';
+    protocolVersion: number;
+    uuid: string;
+    id: string;
+    method: string;
+    params?: unknown[] | Record<string, unknown>;
+}
+/** Parent → Iframe: result of a previous `RpcRequestMessage`. */
+interface RpcResponseMessage {
+    type: 'blink:rpc-response';
+    protocolVersion: number;
+    id: string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** Parent → Iframe: forwarded EIP-1193 event from a top-frame wallet. */
+interface RpcEventMessage {
+    type: 'blink:rpc-event';
+    protocolVersion: number;
+    uuid: string;
+    event: string;
+    args: unknown[];
+}
+/**
+ * Iframe → Parent: ask "which advertised wallet has any of these flags
+ * (e.g. `isUniswapWallet`) set as a truthy property on its provider?".
+ * Used to disambiguate Reown registry entries that lack `rdns` (e.g.
+ * Uniswap, where Reown only ships `injected[].injectedId:
+ * 'isUniswapWallet'`). The parent reads `provider[flag]` defensively
+ * for each advertised provider and returns the first hit, or null.
+ *
+ * The parent answers each request once; the response is matched by
+ * `id`. Cost is local property reads on already-discovered providers —
+ * no network and no cross-frame I/O beyond the postMessage round-trip.
+ */
+interface ResolveByFlagRequestMessage {
+    type: 'blink:resolve-by-flag';
+    protocolVersion: number;
+    /** Request id, mirrored on the response so the iframe can route it. */
+    id: string;
+    /** Flag names to test in order; first truthy property wins. */
+    flags: string[];
+}
+/** Parent → Iframe: result of a previous `ResolveByFlagRequestMessage`. */
+interface ResolveByFlagResponseMessage {
+    type: 'blink:resolve-by-flag-response';
+    protocolVersion: number;
+    id: string;
+    /** `null` when no advertised provider had any flag set. */
+    match: ResolveByFlagMatch | null;
+}
+interface ResolveByFlagMatch {
+    /** EIP-6963 `rdns` of the matched provider. */
+    rdns: string;
+    /** EIP-6963 `uuid` of the matched provider. */
+    uuid: string;
+    /** Which flag matched first (lets the caller log/telemeter). */
+    flag: string;
+}
+type BridgeMessage = BridgeHelloMessage | WalletsAdvertisedMessage | RpcRequestMessage | RpcResponseMessage | RpcEventMessage | ResolveByFlagRequestMessage | ResolveByFlagResponseMessage;
+declare const ALLOWED_RPC_METHODS: Set<string>;
+declare function parseBridgeMessage(data: unknown): BridgeMessage | null;
+
+interface RegisteredProvider {
+    info: EIP6963ProviderInfo;
+    provider: EIP1193Provider;
+}
+interface WalletDiscovererHandle {
+    /** Snapshot of currently-registered providers. */
+    list(): RegisteredProvider[];
+    /** Look up a single provider by EIP-6963 uuid. */
+    get(uuid: string): EIP1193Provider | undefined;
+    /** Subscribe to registry changes. Returns an unsubscribe callback. */
+    subscribe(listener: (snapshot: RegisteredProvider[]) => void): () => void;
+    /**
+     * Re-dispatch `eip6963:requestProvider`. Wallets that wired up after
+     * page load (or after the initial sweep) will re-announce in response.
+     */
+    requestProviders(): void;
+    /** Tear down listeners. After this, `list()` returns `[]`. */
+    destroy(): void;
+}
+/**
+ * Start discovering EIP-6963 providers in the current (top-level) frame.
+ *
+ * Safe to call multiple times — each handle owns its own listeners and
+ * registry; calling `destroy()` releases both. In practice, `createIframe`
+ * spins one handle per modal open.
+ */
+declare function createWalletDiscoverer(): WalletDiscovererHandle;
+
+interface RpcHostHandle {
+    /** Tear down listeners and unsubscribe from all bridged providers. */
+    detach(): void;
+}
+interface RpcHostOptions {
+    /** Cross-origin iframe window we're talking to. */
+    iframeWindow: Window;
+    /** Origin of the iframe — origin-pin all postMessage send/receive. */
+    iframeOrigin: string;
+    /** Discoverer providing the EIP-6963 provider registry. */
+    discoverer: WalletDiscovererHandle;
+    /** Optional debug logger; defaults to a no-op. */
+    log?: (message: string, data?: Record<string, unknown>) => void;
+}
+/**
+ * Attach an RPC host to the given iframe. Listens on `window` for
+ * messages from the iframe and routes allowlisted JSON-RPC calls to the
+ * matching top-frame EIP-1193 provider.
+ */
+declare function attachRpcHost(options: RpcHostOptions): RpcHostHandle;
+
 declare const VERSION = "0.3.0";
 
-export { Checkout, DEFAULT_WEBVIEW_BASE_URL, Deposit, DepositConfig, DepositError, DepositRequest, DepositResult, DepositStatus, VERSION };
+export { ALLOWED_RPC_METHODS, type AdvertisedWallet, BRIDGE_PROTOCOL_VERSION, type EIP1193Provider as BridgeEIP1193Provider, type BridgeHelloMessage, type BridgeMessage, Checkout, DEFAULT_WEBVIEW_BASE_URL, Deposit, DepositConfig, DepositError, DepositRequest, DepositResult, DepositStatus, type EIP6963ProviderDetail, type EIP6963ProviderInfo, type RegisteredProvider, type RpcEventMessage, type RpcHostHandle, type RpcHostOptions, type RpcRequestMessage, type RpcResponseMessage, VERSION, type WalletDiscovererHandle, type WalletsAdvertisedMessage, attachRpcHost, createWalletDiscoverer, parseBridgeMessage };

package/dist/index.js

@@ -1,4 +1,4 @@
-export { Checkout, CheckoutError, DEFAULT_WEBVIEW_BASE_URL, Deposit, DepositError, getDisplayMessage } from './chunk-KDRGSQ2W.js';
+export { ALLOWED_RPC_METHODS, BRIDGE_PROTOCOL_VERSION, Checkout, CheckoutError, DEFAULT_WEBVIEW_BASE_URL, Deposit, DepositError, attachRpcHost, createWalletDiscoverer, getDisplayMessage, parseBridgeMessage } from './chunk-XYI3ZPQD.js';
 
 // src/index.ts
 var VERSION = "0.3.0";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAgBO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["export { Deposit, Checkout, DEFAULT_WEBVIEW_BASE_URL } from './checkout.ts';\nexport { DepositError, CheckoutError, getDisplayMessage } from './errors.ts';\nexport type { DepositErrorCode, CheckoutErrorCode } from './errors.ts';\nexport type {\n  DepositConfig,\n  CheckoutConfig,\n  DepositStatus,\n  CheckoutStatus,\n  DepositRequest,\n  DepositResult,\n  SignerFunction,\n  SignerRequest,\n  SignerResponse,\n  TransferSummary,\n} from './types.ts';\n\nexport const VERSION = '0.3.0';\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AA2CO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["export { Deposit, Checkout, DEFAULT_WEBVIEW_BASE_URL } from './checkout.ts';\nexport { DepositError, CheckoutError, getDisplayMessage } from './errors.ts';\nexport type { DepositErrorCode, CheckoutErrorCode } from './errors.ts';\nexport type {\n  DepositConfig,\n  CheckoutConfig,\n  DepositStatus,\n  CheckoutStatus,\n  DepositRequest,\n  DepositResult,\n  SignerFunction,\n  SignerRequest,\n  SignerResponse,\n  TransferSummary,\n} from './types.ts';\n\n// ── Wallet bridge (advanced) ──────────────────────────────────────────\n// Internal building blocks for the top-frame → iframe wallet bridge.\n// Default merchant integrations don't need these — `createIframe()` wires\n// them automatically. Re-exported so monorepo tests and any merchant\n// custom-iframe wrapper can poke at the protocol shapes.\nexport { createWalletDiscoverer } from './walletBridge/discover.ts';\nexport type { WalletDiscovererHandle, RegisteredProvider } from './walletBridge/discover.ts';\nexport { attachRpcHost } from './walletBridge/rpcHost.ts';\nexport type { RpcHostHandle, RpcHostOptions } from './walletBridge/rpcHost.ts';\nexport {\n  ALLOWED_RPC_METHODS,\n  BRIDGE_PROTOCOL_VERSION,\n  parseBridgeMessage,\n} from './walletBridge/protocol.ts';\nexport type {\n  AdvertisedWallet,\n  BridgeMessage,\n  BridgeHelloMessage,\n  WalletsAdvertisedMessage,\n  RpcRequestMessage,\n  RpcResponseMessage,\n  RpcEventMessage,\n  EIP1193Provider as BridgeEIP1193Provider,\n  EIP6963ProviderInfo,\n  EIP6963ProviderDetail,\n} from './walletBridge/protocol.ts';\n\nexport const VERSION = '0.3.0';\n"]}