@proofchain/sdk 2.10.0 → 2.11.0

package/dist/index.d.mts

@@ -1630,6 +1630,25 @@ interface WalletCreationResult {
     network?: string;
     source: string;
 }
+interface EnsureWalletResult {
+    user_id: string;
+    asset_wallet: {
+        wallet_id: string;
+        address: string;
+        wallet_type: string;
+        network: string;
+        [key: string]: any;
+    };
+    smart_wallet: {
+        wallet_id: string;
+        address: string;
+        wallet_type: string;
+        network: string;
+        [key: string]: any;
+    };
+    network: string;
+    created: boolean;
+}
 interface SetProfileRequest {
     email?: string;
     first_name?: string;
@@ -1720,33 +1739,33 @@ declare class EndUsersClient {
      */
     registerWallet(externalId: string, request: RegisterWalletRequest): Promise<WalletCreationResult>;
     /**
-     * Ensure a user has a wallet, creating one if they don't.
+     * Ensure a user has dual wallets (EOA + Smart Account), creating them if they don't exist.
      *
-     * This is the recommended way for frontend devs to guarantee a wallet
-     * exists before performing any wallet-dependent operation (e.g. attestation,
+     * This is the recommended way for frontend devs to guarantee wallets exist
+     * before performing any wallet-dependent operation (e.g. attestation,
      * on-chain claims, token transfers).
      *
-     * If the user already has a wallet, returns immediately with the existing
-     * address. If not, creates a CDP wallet with the specified options.
+     * If the user already has both wallet types, returns them immediately.
+     * If not, creates a dual wallet pair (EOA asset wallet + Smart Account
+     * for gasless transactions) via the CDP SDK.
      *
      * @param externalId - The user's external ID
-     * @param options - Wallet creation options (only used if a new wallet is created)
-     * @returns Wallet result with address and creation status
+     * @param network - Network to create wallets on (default: 'base-sepolia')
+     * @returns EnsureWalletResult with both wallets and whether they were newly created
      *
      * @example
      * ```typescript
      * // One-liner before any wallet-dependent operation
-     * const wallet = await client.users.ensureWallet('user-123');
-     * console.log(wallet.wallet_address); // '0xabc...'
+     * const result = await client.users.ensureWallet('user-123');
+     * console.log(result.asset_wallet.address); // '0xabc...'
+     * console.log(result.smart_wallet.address); // '0xdef...'
+     * console.log(result.created); // false if they already existed
      *
-     * // With options
-     * const wallet = await client.users.ensureWallet('user-123', {
-     *   wallet_type: 'eoa',
-     *   network: 'base-mainnet',
-     * });
+     * // With specific network
+     * const result = await client.users.ensureWallet('user-123', 'base-mainnet');
      * ```
      */
-    ensureWallet(externalId: string, options?: CreateWalletRequest): Promise<WalletCreationResult>;
+    ensureWallet(externalId: string, network?: string): Promise<EnsureWalletResult>;
     /**
      * Update user attributes (convenience method) by external ID.
      * Merges the provided attributes into the existing attributes object.

package/dist/index.d.ts

@@ -1630,6 +1630,25 @@ interface WalletCreationResult {
     network?: string;
     source: string;
 }
+interface EnsureWalletResult {
+    user_id: string;
+    asset_wallet: {
+        wallet_id: string;
+        address: string;
+        wallet_type: string;
+        network: string;
+        [key: string]: any;
+    };
+    smart_wallet: {
+        wallet_id: string;
+        address: string;
+        wallet_type: string;
+        network: string;
+        [key: string]: any;
+    };
+    network: string;
+    created: boolean;
+}
 interface SetProfileRequest {
     email?: string;
     first_name?: string;
@@ -1720,33 +1739,33 @@ declare class EndUsersClient {
      */
     registerWallet(externalId: string, request: RegisterWalletRequest): Promise<WalletCreationResult>;
     /**
-     * Ensure a user has a wallet, creating one if they don't.
+     * Ensure a user has dual wallets (EOA + Smart Account), creating them if they don't exist.
      *
-     * This is the recommended way for frontend devs to guarantee a wallet
-     * exists before performing any wallet-dependent operation (e.g. attestation,
+     * This is the recommended way for frontend devs to guarantee wallets exist
+     * before performing any wallet-dependent operation (e.g. attestation,
      * on-chain claims, token transfers).
      *
-     * If the user already has a wallet, returns immediately with the existing
-     * address. If not, creates a CDP wallet with the specified options.
+     * If the user already has both wallet types, returns them immediately.
+     * If not, creates a dual wallet pair (EOA asset wallet + Smart Account
+     * for gasless transactions) via the CDP SDK.
      *
      * @param externalId - The user's external ID
-     * @param options - Wallet creation options (only used if a new wallet is created)
-     * @returns Wallet result with address and creation status
+     * @param network - Network to create wallets on (default: 'base-sepolia')
+     * @returns EnsureWalletResult with both wallets and whether they were newly created
      *
      * @example
      * ```typescript
      * // One-liner before any wallet-dependent operation
-     * const wallet = await client.users.ensureWallet('user-123');
-     * console.log(wallet.wallet_address); // '0xabc...'
+     * const result = await client.users.ensureWallet('user-123');
+     * console.log(result.asset_wallet.address); // '0xabc...'
+     * console.log(result.smart_wallet.address); // '0xdef...'
+     * console.log(result.created); // false if they already existed
      *
-     * // With options
-     * const wallet = await client.users.ensureWallet('user-123', {
-     *   wallet_type: 'eoa',
-     *   network: 'base-mainnet',
-     * });
+     * // With specific network
+     * const result = await client.users.ensureWallet('user-123', 'base-mainnet');
      * ```
      */
-    ensureWallet(externalId: string, options?: CreateWalletRequest): Promise<WalletCreationResult>;
+    ensureWallet(externalId: string, network?: string): Promise<EnsureWalletResult>;
     /**
      * Update user attributes (convenience method) by external ID.
      * Merges the provided attributes into the existing attributes object.

package/dist/index.js

@@ -1248,44 +1248,57 @@ var EndUsersClient = class {
     return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/register-wallet`, request);
   }
   /**
-   * Ensure a user has a wallet, creating one if they don't.
+   * Ensure a user has dual wallets (EOA + Smart Account), creating them if they don't exist.
    *
-   * This is the recommended way for frontend devs to guarantee a wallet
-   * exists before performing any wallet-dependent operation (e.g. attestation,
+   * This is the recommended way for frontend devs to guarantee wallets exist
+   * before performing any wallet-dependent operation (e.g. attestation,
    * on-chain claims, token transfers).
    *
-   * If the user already has a wallet, returns immediately with the existing
-   * address. If not, creates a CDP wallet with the specified options.
+   * If the user already has both wallet types, returns them immediately.
+   * If not, creates a dual wallet pair (EOA asset wallet + Smart Account
+   * for gasless transactions) via the CDP SDK.
    *
    * @param externalId - The user's external ID
-   * @param options - Wallet creation options (only used if a new wallet is created)
-   * @returns Wallet result with address and creation status
+   * @param network - Network to create wallets on (default: 'base-sepolia')
+   * @returns EnsureWalletResult with both wallets and whether they were newly created
    *
    * @example
    * ```typescript
    * // One-liner before any wallet-dependent operation
-   * const wallet = await client.users.ensureWallet('user-123');
-   * console.log(wallet.wallet_address); // '0xabc...'
+   * const result = await client.users.ensureWallet('user-123');
+   * console.log(result.asset_wallet.address); // '0xabc...'
+   * console.log(result.smart_wallet.address); // '0xdef...'
+   * console.log(result.created); // false if they already existed
    *
-   * // With options
-   * const wallet = await client.users.ensureWallet('user-123', {
-   *   wallet_type: 'eoa',
-   *   network: 'base-mainnet',
-   * });
+   * // With specific network
+   * const result = await client.users.ensureWallet('user-123', 'base-mainnet');
    * ```
    */
-  async ensureWallet(externalId, options = {}) {
-    const user = await this.get(externalId);
-    if (user.wallet_address) {
-      return {
-        success: true,
-        user_id: externalId,
-        wallet_address: user.wallet_address,
-        wallet_type: user.wallet_source ?? void 0,
-        source: "existing"
-      };
+  async ensureWallet(externalId, network = "base-sepolia") {
+    const existingWallets = await this.http.get(
+      `/wallets/user/${encodeURIComponent(externalId)}`
+    );
+    if (existingWallets && existingWallets.length > 0) {
+      const eoa = existingWallets.find((w) => w.wallet_type === "eoa");
+      const smart = existingWallets.find((w) => w.wallet_type === "smart");
+      if (eoa && smart) {
+        return {
+          user_id: externalId,
+          asset_wallet: eoa,
+          smart_wallet: smart,
+          network: eoa.network,
+          created: false
+        };
+      }
     }
-    return this.createWallet(externalId, options);
+    const dual = await this.http.post("/wallets/dual", {
+      user_id: externalId,
+      network
+    });
+    return {
+      ...dual,
+      created: true
+    };
   }
   /**
    * Update user attributes (convenience method) by external ID.

package/dist/index.mjs

@@ -1194,44 +1194,57 @@ var EndUsersClient = class {
     return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/register-wallet`, request);
   }
   /**
-   * Ensure a user has a wallet, creating one if they don't.
+   * Ensure a user has dual wallets (EOA + Smart Account), creating them if they don't exist.
    *
-   * This is the recommended way for frontend devs to guarantee a wallet
-   * exists before performing any wallet-dependent operation (e.g. attestation,
+   * This is the recommended way for frontend devs to guarantee wallets exist
+   * before performing any wallet-dependent operation (e.g. attestation,
    * on-chain claims, token transfers).
    *
-   * If the user already has a wallet, returns immediately with the existing
-   * address. If not, creates a CDP wallet with the specified options.
+   * If the user already has both wallet types, returns them immediately.
+   * If not, creates a dual wallet pair (EOA asset wallet + Smart Account
+   * for gasless transactions) via the CDP SDK.
    *
    * @param externalId - The user's external ID
-   * @param options - Wallet creation options (only used if a new wallet is created)
-   * @returns Wallet result with address and creation status
+   * @param network - Network to create wallets on (default: 'base-sepolia')
+   * @returns EnsureWalletResult with both wallets and whether they were newly created
    *
    * @example
    * ```typescript
    * // One-liner before any wallet-dependent operation
-   * const wallet = await client.users.ensureWallet('user-123');
-   * console.log(wallet.wallet_address); // '0xabc...'
+   * const result = await client.users.ensureWallet('user-123');
+   * console.log(result.asset_wallet.address); // '0xabc...'
+   * console.log(result.smart_wallet.address); // '0xdef...'
+   * console.log(result.created); // false if they already existed
    *
-   * // With options
-   * const wallet = await client.users.ensureWallet('user-123', {
-   *   wallet_type: 'eoa',
-   *   network: 'base-mainnet',
-   * });
+   * // With specific network
+   * const result = await client.users.ensureWallet('user-123', 'base-mainnet');
    * ```
    */
-  async ensureWallet(externalId, options = {}) {
-    const user = await this.get(externalId);
-    if (user.wallet_address) {
-      return {
-        success: true,
-        user_id: externalId,
-        wallet_address: user.wallet_address,
-        wallet_type: user.wallet_source ?? void 0,
-        source: "existing"
-      };
+  async ensureWallet(externalId, network = "base-sepolia") {
+    const existingWallets = await this.http.get(
+      `/wallets/user/${encodeURIComponent(externalId)}`
+    );
+    if (existingWallets && existingWallets.length > 0) {
+      const eoa = existingWallets.find((w) => w.wallet_type === "eoa");
+      const smart = existingWallets.find((w) => w.wallet_type === "smart");
+      if (eoa && smart) {
+        return {
+          user_id: externalId,
+          asset_wallet: eoa,
+          smart_wallet: smart,
+          network: eoa.network,
+          created: false
+        };
+      }
     }
-    return this.createWallet(externalId, options);
+    const dual = await this.http.post("/wallets/dual", {
+      user_id: externalId,
+      network
+    });
+    return {
+      ...dual,
+      created: true
+    };
   }
   /**
    * Update user attributes (convenience method) by external ID.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proofchain/sdk",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Official JavaScript/TypeScript SDK for ProofChain - blockchain-anchored document attestation",
   "main": "dist/index.js",
   "module": "dist/index.mjs",