@dignetwork/dig-sdk 0.2.1 → 0.4.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { W as WalletBackend, a as WalletSession, S as SignResult, I as InjectedChiaProvider } from './dig-client-entry-Bc95rd_t.cjs';
-export { C as CollectionItem, b as CollectionItemMetadata, c as CollectionItemsPage, d as CollectionMeta, D as DEFAULT_RPC, e as DIG_CLIENT_WASM_SHA256, f as DigClient, g as DigClientOptions, h as DigClientWasm, P as ParsedUrn, R as ReadOptions, i as ReadResult, U as UrnKeys, j as WasmConfig, k as configureWasm, l as isUrn, m as loadDigClientWasm, p as parseUrn, r as reconstructUrn, n as reconstructUrnWithRoot } from './dig-client-entry-Bc95rd_t.cjs';
+import { W as WalletBackend, a as WalletSession, S as SignResult, I as InjectedChiaProvider } from './dig-client-entry-Deb8ZwaO.cjs';
+export { C as CollectionItem, b as CollectionItemMetadata, c as CollectionItemsPage, d as CollectionMeta, D as DEFAULT_RPC, e as DIG_CLIENT_WASM_SHA256, f as DigClient, g as DigClientOptions, h as DigClientWasm, P as ParsedUrn, R as ReadOptions, i as ReadResult, U as UrnKeys, j as WasmConfig, k as configureWasm, l as isUrn, m as loadDigClientWasm, p as parseUrn, r as reconstructUrn, n as reconstructUrnWithRoot } from './dig-client-entry-Deb8ZwaO.cjs';
 
 /** A wallet transport: connect, then `request` CHIP-0002 methods through it. */
 interface WalletTransport {
@@ -70,15 +70,49 @@ declare class WalletConnectTransport implements WalletTransport {
     disconnect(): Promise<void>;
 }
 
+/**
+ * A connector id for the 'Browser Wallet vs WalletConnect' chooser (#63) — the discoverable,
+ * user-facing counterpart of the lower-level {@link WalletBackend}. `"browser-wallet"` is an alias
+ * for the `"injected"` backend, named to match the chooser UI label every DIG frontend uses.
+ */
+type ConnectorId = "browser-wallet" | "walletconnect";
+/**
+ * One entry in {@link ChiaProvider.listConnectors}: a connector a chooser UI can offer, and
+ * whether it's currently usable.
+ */
+interface ConnectorInfo {
+    /** The id to pass as `ConnectOptions.mode` once the user picks this connector. */
+    id: ConnectorId;
+    /** The underlying transport backend this connector selects. */
+    backend: WalletBackend;
+    /** Human-facing label ("Browser Wallet" / "WalletConnect") — the canonical chooser copy. */
+    label: string;
+    /**
+     * True iff this connector can be connected right now. Browser Wallet requires a detected
+     * injected `window.chia`; WalletConnect is always offered (its relay has no presence to detect).
+     */
+    available: boolean;
+}
 /** Options for `ChiaProvider.connect()`. */
 interface ConnectOptions {
     /**
      * Connection mode:
-     *   • "auto" (default) — prefer the injected DIG wallet; fall back to WalletConnect if absent.
-     *   • "injected"       — require the injected wallet (throws if absent).
-     *   • "walletconnect"  — force the WalletConnect→Sage pairing.
+     *   • "auto" (default)     — prefer the injected DIG wallet; fall back to WalletConnect if
+     *                            absent. A convenience for callers that don't want to present a
+     *                            chooser; it never asks the user, so if BOTH a Browser Wallet and
+     *                            WalletConnect are viable it silently picks Browser Wallet — kept
+     *                            for backward compatibility with existing single-shot integrations.
+     *   • "browser-wallet"      — require the injected Browser Wallet (throws if absent). The
+     *                            explicit-preference value for a Connect chooser (see
+     *                            {@link ChiaProvider.listConnectors}); an alias of "injected".
+     *   • "injected"           — same as "browser-wallet" (kept for backward compatibility).
+     *   • "walletconnect"      — force the WalletConnect→Sage pairing.
+     *
+     * To offer the user a real choice — never auto-binding to whichever wallet happens to be
+     * injected — call {@link ChiaProvider.listConnectors} to enumerate what's available, let the
+     * user pick, then pass their pick's `id` (`"browser-wallet"` or `"walletconnect"`) as `mode`.
      */
-    mode?: "auto" | WalletBackend;
+    mode?: "auto" | WalletBackend | ConnectorId;
     /**
      * WalletConnect options, required for the WalletConnect fallback/force path (projectId +
      * metadata + onUri). Omit if you only target the injected DIG Browser wallet.
@@ -117,6 +151,21 @@ declare class ChiaProvider {
      * injected DIG wallet and falls back to WalletConnect.
      */
     static connect(options?: ConnectOptions): Promise<ChiaProvider>;
+    /**
+     * Enumerate the connectors a 'Browser Wallet vs WalletConnect' Connect chooser can offer (#63).
+     * Pure and side-effect-free — it only DETECTS what's usable right now, it never connects to
+     * anything — so a chooser UI built around it always surfaces the choice instead of silently
+     * auto-binding to whichever wallet happens to be injected.
+     *
+     * @example
+     * const connectors = ChiaProvider.listConnectors();
+     * // render a button per connector, disabling any with `available: false`
+     * const chosen = connectors.find((c) => c.id === userPick)!;
+     * const provider = await ChiaProvider.connect({ mode: chosen.id, walletConnect });
+     */
+    static listConnectors(options?: {
+        acceptAnyInjected?: boolean;
+    }): ConnectorInfo[];
     /** Wrap an already-constructed transport (advanced / restored sessions). */
     static fromTransport(transport: WalletTransport): ChiaProvider;
     /** The wallet's receive address (cached after first read). */
@@ -478,7 +527,7 @@ interface SdkCapabilities {
     readonly chains: readonly string[];
     /** The default dig RPC endpoint `DigClient` reads from. */
     readonly defaultRpc: string;
-    /** The SRI digest of the read-crypto wasm from @dignetwork/dig-client (fail-closed on mismatch). */
+    /** The SRI digest of the read-crypto wasm from @dignetwork/dig-capsule-wasm (fail-closed on mismatch). */
     readonly readCryptoWasmSha256: string;
     /** The stable error-code catalogue (UPPER_SNAKE) consumers can branch on. */
     readonly errorCodes: readonly DigSdkErrorCode[];
@@ -499,4 +548,4 @@ declare function capabilities(): SdkCapabilities;
 /** Alias for {@link capabilities} — the conventional `describe()` introspection name. */
 declare const describe: typeof capabilities;
 
-export { ChiaProvider, type ConnectOptions, DEFAULT_CHAIN, DIG_SDK_ERROR_CODES, DigSdkError, type DigSdkErrorCode, type DigSdkErrorContext, INJECTED_TOPIC, InjectedChiaProvider, InjectedTransport, type ModuleDescriptor, type MonetizationSpends, type PaymentAssetSpec, type PaymentResult, Paywall, type PaywallOptions, type ProveAccessArgs, type RequestPaymentArgs, SDK_VERSION, SIGN_METHODS, type SdkCapabilities, SignResult, type VerifyReceiptArgs, WALLET_METHODS, WalletBackend, type WalletConnectMetadata, type WalletConnectOptions, WalletConnectTransport, type WalletMethod, WalletSession, type WalletTransport, capabilities, connectWallet, describe, getInjectedProvider, isDigSdkError, isInjectedAvailable, isTransientPublishError };
+export { ChiaProvider, type ConnectOptions, type ConnectorId, type ConnectorInfo, DEFAULT_CHAIN, DIG_SDK_ERROR_CODES, DigSdkError, type DigSdkErrorCode, type DigSdkErrorContext, INJECTED_TOPIC, InjectedChiaProvider, InjectedTransport, type ModuleDescriptor, type MonetizationSpends, type PaymentAssetSpec, type PaymentResult, Paywall, type PaywallOptions, type ProveAccessArgs, type RequestPaymentArgs, SDK_VERSION, SIGN_METHODS, type SdkCapabilities, SignResult, type VerifyReceiptArgs, WALLET_METHODS, WalletBackend, type WalletConnectMetadata, type WalletConnectOptions, WalletConnectTransport, type WalletMethod, WalletSession, type WalletTransport, capabilities, connectWallet, describe, getInjectedProvider, isDigSdkError, isInjectedAvailable, isTransientPublishError };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { W as WalletBackend, a as WalletSession, S as SignResult, I as InjectedChiaProvider } from './dig-client-entry-Bc95rd_t.js';
-export { C as CollectionItem, b as CollectionItemMetadata, c as CollectionItemsPage, d as CollectionMeta, D as DEFAULT_RPC, e as DIG_CLIENT_WASM_SHA256, f as DigClient, g as DigClientOptions, h as DigClientWasm, P as ParsedUrn, R as ReadOptions, i as ReadResult, U as UrnKeys, j as WasmConfig, k as configureWasm, l as isUrn, m as loadDigClientWasm, p as parseUrn, r as reconstructUrn, n as reconstructUrnWithRoot } from './dig-client-entry-Bc95rd_t.js';
+import { W as WalletBackend, a as WalletSession, S as SignResult, I as InjectedChiaProvider } from './dig-client-entry-Deb8ZwaO.js';
+export { C as CollectionItem, b as CollectionItemMetadata, c as CollectionItemsPage, d as CollectionMeta, D as DEFAULT_RPC, e as DIG_CLIENT_WASM_SHA256, f as DigClient, g as DigClientOptions, h as DigClientWasm, P as ParsedUrn, R as ReadOptions, i as ReadResult, U as UrnKeys, j as WasmConfig, k as configureWasm, l as isUrn, m as loadDigClientWasm, p as parseUrn, r as reconstructUrn, n as reconstructUrnWithRoot } from './dig-client-entry-Deb8ZwaO.js';
 
 /** A wallet transport: connect, then `request` CHIP-0002 methods through it. */
 interface WalletTransport {
@@ -70,15 +70,49 @@ declare class WalletConnectTransport implements WalletTransport {
     disconnect(): Promise<void>;
 }
 
+/**
+ * A connector id for the 'Browser Wallet vs WalletConnect' chooser (#63) — the discoverable,
+ * user-facing counterpart of the lower-level {@link WalletBackend}. `"browser-wallet"` is an alias
+ * for the `"injected"` backend, named to match the chooser UI label every DIG frontend uses.
+ */
+type ConnectorId = "browser-wallet" | "walletconnect";
+/**
+ * One entry in {@link ChiaProvider.listConnectors}: a connector a chooser UI can offer, and
+ * whether it's currently usable.
+ */
+interface ConnectorInfo {
+    /** The id to pass as `ConnectOptions.mode` once the user picks this connector. */
+    id: ConnectorId;
+    /** The underlying transport backend this connector selects. */
+    backend: WalletBackend;
+    /** Human-facing label ("Browser Wallet" / "WalletConnect") — the canonical chooser copy. */
+    label: string;
+    /**
+     * True iff this connector can be connected right now. Browser Wallet requires a detected
+     * injected `window.chia`; WalletConnect is always offered (its relay has no presence to detect).
+     */
+    available: boolean;
+}
 /** Options for `ChiaProvider.connect()`. */
 interface ConnectOptions {
     /**
      * Connection mode:
-     *   • "auto" (default) — prefer the injected DIG wallet; fall back to WalletConnect if absent.
-     *   • "injected"       — require the injected wallet (throws if absent).
-     *   • "walletconnect"  — force the WalletConnect→Sage pairing.
+     *   • "auto" (default)     — prefer the injected DIG wallet; fall back to WalletConnect if
+     *                            absent. A convenience for callers that don't want to present a
+     *                            chooser; it never asks the user, so if BOTH a Browser Wallet and
+     *                            WalletConnect are viable it silently picks Browser Wallet — kept
+     *                            for backward compatibility with existing single-shot integrations.
+     *   • "browser-wallet"      — require the injected Browser Wallet (throws if absent). The
+     *                            explicit-preference value for a Connect chooser (see
+     *                            {@link ChiaProvider.listConnectors}); an alias of "injected".
+     *   • "injected"           — same as "browser-wallet" (kept for backward compatibility).
+     *   • "walletconnect"      — force the WalletConnect→Sage pairing.
+     *
+     * To offer the user a real choice — never auto-binding to whichever wallet happens to be
+     * injected — call {@link ChiaProvider.listConnectors} to enumerate what's available, let the
+     * user pick, then pass their pick's `id` (`"browser-wallet"` or `"walletconnect"`) as `mode`.
      */
-    mode?: "auto" | WalletBackend;
+    mode?: "auto" | WalletBackend | ConnectorId;
     /**
      * WalletConnect options, required for the WalletConnect fallback/force path (projectId +
      * metadata + onUri). Omit if you only target the injected DIG Browser wallet.
@@ -117,6 +151,21 @@ declare class ChiaProvider {
      * injected DIG wallet and falls back to WalletConnect.
      */
     static connect(options?: ConnectOptions): Promise<ChiaProvider>;
+    /**
+     * Enumerate the connectors a 'Browser Wallet vs WalletConnect' Connect chooser can offer (#63).
+     * Pure and side-effect-free — it only DETECTS what's usable right now, it never connects to
+     * anything — so a chooser UI built around it always surfaces the choice instead of silently
+     * auto-binding to whichever wallet happens to be injected.
+     *
+     * @example
+     * const connectors = ChiaProvider.listConnectors();
+     * // render a button per connector, disabling any with `available: false`
+     * const chosen = connectors.find((c) => c.id === userPick)!;
+     * const provider = await ChiaProvider.connect({ mode: chosen.id, walletConnect });
+     */
+    static listConnectors(options?: {
+        acceptAnyInjected?: boolean;
+    }): ConnectorInfo[];
     /** Wrap an already-constructed transport (advanced / restored sessions). */
     static fromTransport(transport: WalletTransport): ChiaProvider;
     /** The wallet's receive address (cached after first read). */
@@ -478,7 +527,7 @@ interface SdkCapabilities {
     readonly chains: readonly string[];
     /** The default dig RPC endpoint `DigClient` reads from. */
     readonly defaultRpc: string;
-    /** The SRI digest of the read-crypto wasm from @dignetwork/dig-client (fail-closed on mismatch). */
+    /** The SRI digest of the read-crypto wasm from @dignetwork/dig-capsule-wasm (fail-closed on mismatch). */
     readonly readCryptoWasmSha256: string;
     /** The stable error-code catalogue (UPPER_SNAKE) consumers can branch on. */
     readonly errorCodes: readonly DigSdkErrorCode[];
@@ -499,4 +548,4 @@ declare function capabilities(): SdkCapabilities;
 /** Alias for {@link capabilities} — the conventional `describe()` introspection name. */
 declare const describe: typeof capabilities;
 
-export { ChiaProvider, type ConnectOptions, DEFAULT_CHAIN, DIG_SDK_ERROR_CODES, DigSdkError, type DigSdkErrorCode, type DigSdkErrorContext, INJECTED_TOPIC, InjectedChiaProvider, InjectedTransport, type ModuleDescriptor, type MonetizationSpends, type PaymentAssetSpec, type PaymentResult, Paywall, type PaywallOptions, type ProveAccessArgs, type RequestPaymentArgs, SDK_VERSION, SIGN_METHODS, type SdkCapabilities, SignResult, type VerifyReceiptArgs, WALLET_METHODS, WalletBackend, type WalletConnectMetadata, type WalletConnectOptions, WalletConnectTransport, type WalletMethod, WalletSession, type WalletTransport, capabilities, connectWallet, describe, getInjectedProvider, isDigSdkError, isInjectedAvailable, isTransientPublishError };
+export { ChiaProvider, type ConnectOptions, type ConnectorId, type ConnectorInfo, DEFAULT_CHAIN, DIG_SDK_ERROR_CODES, DigSdkError, type DigSdkErrorCode, type DigSdkErrorContext, INJECTED_TOPIC, InjectedChiaProvider, InjectedTransport, type ModuleDescriptor, type MonetizationSpends, type PaymentAssetSpec, type PaymentResult, Paywall, type PaywallOptions, type ProveAccessArgs, type RequestPaymentArgs, SDK_VERSION, SIGN_METHODS, type SdkCapabilities, SignResult, type VerifyReceiptArgs, WALLET_METHODS, WalletBackend, type WalletConnectMetadata, type WalletConnectOptions, WalletConnectTransport, type WalletMethod, WalletSession, type WalletTransport, capabilities, connectWallet, describe, getInjectedProvider, isDigSdkError, isInjectedAvailable, isTransientPublishError };

package/dist/index.js

@@ -400,7 +400,8 @@ var ChiaProvider = class _ChiaProvider {
    * injected DIG wallet and falls back to WalletConnect.
    */
   static async connect(options = {}) {
-    const mode = options.mode ?? "auto";
+    const rawMode = options.mode ?? "auto";
+    const mode = rawMode === "browser-wallet" ? "injected" : rawMode;
     const chain = options.chain ?? DEFAULT_CHAIN;
     const tryInjected = async () => {
       if (!isInjectedAvailable({ anyChia: options.acceptAnyInjected })) return null;
@@ -414,7 +415,7 @@ var ChiaProvider = class _ChiaProvider {
         throw new DigSdkError(
           "WC_OPTIONS_REQUIRED",
           "WalletConnect options are required to connect via WalletConnect (pass { walletConnect: { projectId, metadata, onUri } }).",
-          { mode }
+          { mode: rawMode }
         );
       }
       const transport = await WalletConnectTransport.connect({
@@ -429,7 +430,7 @@ var ChiaProvider = class _ChiaProvider {
         throw new DigSdkError(
           "NO_INJECTED_WALLET",
           "No injected DIG wallet found. Open this page in the DIG Browser, or use mode 'auto'.",
-          { mode, acceptAnyInjected: !!options.acceptAnyInjected }
+          { mode: rawMode, acceptAnyInjected: !!options.acceptAnyInjected }
         );
       }
       return injected;
@@ -437,6 +438,34 @@ var ChiaProvider = class _ChiaProvider {
     if (mode === "walletconnect") return tryWalletConnect();
     return await tryInjected() ?? await tryWalletConnect();
   }
+  /**
+   * Enumerate the connectors a 'Browser Wallet vs WalletConnect' Connect chooser can offer (#63).
+   * Pure and side-effect-free — it only DETECTS what's usable right now, it never connects to
+   * anything — so a chooser UI built around it always surfaces the choice instead of silently
+   * auto-binding to whichever wallet happens to be injected.
+   *
+   * @example
+   * const connectors = ChiaProvider.listConnectors();
+   * // render a button per connector, disabling any with `available: false`
+   * const chosen = connectors.find((c) => c.id === userPick)!;
+   * const provider = await ChiaProvider.connect({ mode: chosen.id, walletConnect });
+   */
+  static listConnectors(options = {}) {
+    return [
+      {
+        id: "browser-wallet",
+        backend: "injected",
+        label: "Browser Wallet",
+        available: isInjectedAvailable({ anyChia: options.acceptAnyInjected })
+      },
+      {
+        id: "walletconnect",
+        backend: "walletconnect",
+        label: "WalletConnect",
+        available: true
+      }
+    ];
+  }
   /** Wrap an already-constructed transport (advanced / restored sessions). */
   static fromTransport(transport) {
     return new _ChiaProvider(transport);
@@ -699,7 +728,7 @@ var Paywall = class {
 };
 
 // src/loader.ts
-var DIG_CLIENT_WASM_SHA256 = "8c983561eabca34778abf698ca7c2fba36117f87282ca649079599ef7d1b1156";
+var DIG_CLIENT_WASM_SHA256 = "a186fd2d6b348a7caa3112c51b666a6618fe7cf8bb56ad395a1fab4323f6ae7e";
 var _config = {};
 var _ready = null;
 function configureWasm(config) {
@@ -734,16 +763,16 @@ async function loadNode() {
   const { createRequire } = await import('module');
   const { readFile } = await import('fs/promises');
   const require2 = createRequire(import.meta.url);
-  const wasmPath = require2.resolve("@dignetwork/dig-client/dig_client_bg.wasm");
+  const wasmPath = require2.resolve("@dignetwork/dig-capsule-wasm/dig_client_bg.wasm");
   const buf = await readFile(wasmPath);
   const bytes = new Uint8Array(buf.byteLength);
   bytes.set(buf);
   assertIntegrity(await sha256Hex(bytes));
-  const mod = await import('@dignetwork/dig-client/node');
+  const mod = await import('@dignetwork/dig-capsule-wasm/node');
   return mod;
 }
 async function loadBrowser() {
-  const glueHref = _config.glueUrl ?? "@dignetwork/dig-client/web";
+  const glueHref = _config.glueUrl ?? "@dignetwork/dig-capsule-wasm/web";
   const mod = await import(
     /* @vite-ignore */
     glueHref
@@ -1115,7 +1144,7 @@ function undefinedFetch() {
 }
 
 // src/capabilities.ts
-var SDK_VERSION = "0.2.1" ;
+var SDK_VERSION = "0.4.0" ;
 var MODULES = Object.freeze([
   {
     name: "ChiaProvider",