@chipi-stack/backend 11.5.0 → 11.6.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _chipi_stack_types from '@chipi-stack/types';
-import { ChipiSDKConfig, ExecuteTransactionParams, TransferParams, ApproveParams, StakeVesuUsdcParams, WithdrawVesuUsdcParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse } from '@chipi-stack/types';
+import { ChipiSDKConfig, ExecuteTransactionParams, TransferParams, ApproveParams, StakeVesuUsdcParams, WithdrawVesuUsdcParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse, ChipiServerSDKConfig, ChipiBrowserSDKConfig } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 import { ChipiWallets } from './wallets.mjs';
 import { ChipiTransactions } from './transactions.mjs';
@@ -12,67 +12,148 @@ export { C as ChipiClient } from './client-D4ZnPqgQ.mjs';
 declare class ChipiSDK {
     private client;
     private nodeUrl;
+    private apiSecretKey?;
     readonly wallets: ChipiWallets;
     readonly transactions: ChipiTransactions;
     readonly skus: ChipiSkus;
     constructor(config: ChipiSDKConfig);
+    /**
+     * Resolve bearer token - uses provided token or falls back to apiSecretKey
+     */
+    private resolveBearerToken;
     /**
      * Execute a gasless transaction
      */
-    executeTransaction(params: Omit<ExecuteTransactionParams, "apiPublicKey" | "backendUrl">): Promise<string>;
+    executeTransaction({ params, bearerToken, }: {
+        params: ExecuteTransactionParams;
+        bearerToken?: string;
+    }): Promise<string>;
     /**
      * Transfer tokens
      */
     transfer({ params, bearerToken, }: {
         params: TransferParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Approve token spending
      */
     approve({ params, bearerToken, }: {
         params: ApproveParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Stake USDC in Vesu protocol
      */
     stakeVesuUsdc({ params, bearerToken, }: {
         params: StakeVesuUsdcParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Withdraw USDC from Vesu protocol
      */
     withdrawVesuUsdc({ params, bearerToken, }: {
         params: WithdrawVesuUsdcParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Call any contract method
      */
     callAnyContract({ params, bearerToken, }: {
         params: CallAnyContractParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Create a new wallet
      */
     createWallet({ params, bearerToken, }: {
         params: CreateWalletParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<CreateWalletResponse>;
     recordSendTransaction({ params, bearerToken, }: {
         params: RecordSendTransactionParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<Transaction>;
-    getWallet(params: GetWalletParams, bearerToken: string): Promise<(_chipi_stack_types.GetWalletResponse & {
+    getWallet(params: GetWalletParams, bearerToken?: string): Promise<(_chipi_stack_types.GetWalletResponse & {
         normalizedPublicKey: string;
     }) | null>;
-    getTokenBalance(params: GetTokenBalanceParams, bearerToken: string): Promise<GetTokenBalanceResponse>;
+    getTokenBalance(params: GetTokenBalanceParams, bearerToken?: string): Promise<GetTokenBalanceResponse>;
+}
+
+/**
+ * Server-side Chipi SDK with built-in API Secret Key authentication
+ *
+ * This class is designed for server-side environments where you can safely store
+ * the API Secret Key. All methods automatically use the secret key for authentication,
+ * so you don't need to pass a bearer token with each call.
+ *
+ * The apiSecretKey is stored internally and used automatically for all authenticated requests.
+ * All methods from ChipiSDK are inherited and work without requiring a bearerToken parameter.
+ *
+ * @example
+ * ```typescript
+ * const chipiServer = new ChipiServerSDK({
+ *   apiPublicKey: "pk_...",
+ *   apiSecretKey: "sk_...",
+ *   environment: "production"
+ * });
+ *
+ * // No bearer token needed - automatically uses apiSecretKey!
+ * const wallet = await chipiServer.createWallet({
+ *   params: {
+ *     encryptKey: "user-encryption-key",
+ *     externalUserId: "user-123"
+ *   }
+ * });
+ *
+ * const userWallet = await chipiServer.getWallet({ externalUserId: "user-123" });
+ * const txHash = await chipiServer.transfer({ params: { ... } });
+ * ```
+ */
+declare class ChipiServerSDK extends ChipiSDK {
+    constructor(config: ChipiServerSDKConfig);
+}
+
+/**
+ * Browser-side Chipi SDK for client-side applications
+ *
+ * This class is designed for browser environments (Vue, Svelte, Angular, vanilla JS, etc.)
+ * where you need to pass a bearer token (JWT) with each authenticated request.
+ *
+ * All methods require a bearerToken parameter since browser environments should not
+ * store API Secret Keys.
+ *
+ * ⚠️  SECURITY WARNING: DO NOT use your API Secret Key in browser environments!
+ * The secret key should only be used server-side with ChipiServerSDK.
+ *
+ * @example
+ * ```typescript
+ * const chipiBrowser = new ChipiBrowserSDK({
+ *   apiPublicKey: "pk_...",
+ *   environment: "production"
+ * });
+ *
+ * // Get user's JWT token from your auth system
+ * const userToken = await getUserJWT();
+ *
+ * // Pass bearer token with each call
+ * const wallet = await chipiBrowser.createWallet({
+ *   params: {
+ *     encryptKey: "user-encryption-key",
+ *     externalUserId: "user-123"
+ *   },
+ *   bearerToken: userToken
+ * });
+ *
+ * const userWallet = await chipiBrowser.getWallet({ externalUserId: "user-123" }, userToken);
+ * const txHash = await chipiBrowser.transfer({ params: {...}, bearerToken: userToken });
+ * ```
+ */
+declare class ChipiBrowserSDK extends ChipiSDK {
+    constructor(config: ChipiBrowserSDKConfig);
 }
 
 declare const encryptPrivateKey: (privateKey: string, password: string) => string;
 declare const decryptPrivateKey: (encryptedPrivateKey: string, password: string) => string;
 
-export { ChipiSDK, ChipiSkus, ChipiTransactions, ChipiWallets, decryptPrivateKey, encryptPrivateKey };
+export { ChipiBrowserSDK, ChipiSDK, ChipiServerSDK, ChipiSkus, ChipiTransactions, ChipiWallets, decryptPrivateKey, encryptPrivateKey };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _chipi_stack_types from '@chipi-stack/types';
-import { ChipiSDKConfig, ExecuteTransactionParams, TransferParams, ApproveParams, StakeVesuUsdcParams, WithdrawVesuUsdcParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse } from '@chipi-stack/types';
+import { ChipiSDKConfig, ExecuteTransactionParams, TransferParams, ApproveParams, StakeVesuUsdcParams, WithdrawVesuUsdcParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse, ChipiServerSDKConfig, ChipiBrowserSDKConfig } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 import { ChipiWallets } from './wallets.js';
 import { ChipiTransactions } from './transactions.js';
@@ -12,67 +12,148 @@ export { C as ChipiClient } from './client-D4ZnPqgQ.js';
 declare class ChipiSDK {
     private client;
     private nodeUrl;
+    private apiSecretKey?;
     readonly wallets: ChipiWallets;
     readonly transactions: ChipiTransactions;
     readonly skus: ChipiSkus;
     constructor(config: ChipiSDKConfig);
+    /**
+     * Resolve bearer token - uses provided token or falls back to apiSecretKey
+     */
+    private resolveBearerToken;
     /**
      * Execute a gasless transaction
      */
-    executeTransaction(params: Omit<ExecuteTransactionParams, "apiPublicKey" | "backendUrl">): Promise<string>;
+    executeTransaction({ params, bearerToken, }: {
+        params: ExecuteTransactionParams;
+        bearerToken?: string;
+    }): Promise<string>;
     /**
      * Transfer tokens
      */
     transfer({ params, bearerToken, }: {
         params: TransferParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Approve token spending
      */
     approve({ params, bearerToken, }: {
         params: ApproveParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Stake USDC in Vesu protocol
      */
     stakeVesuUsdc({ params, bearerToken, }: {
         params: StakeVesuUsdcParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Withdraw USDC from Vesu protocol
      */
     withdrawVesuUsdc({ params, bearerToken, }: {
         params: WithdrawVesuUsdcParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Call any contract method
      */
     callAnyContract({ params, bearerToken, }: {
         params: CallAnyContractParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<string>;
     /**
      * Create a new wallet
      */
     createWallet({ params, bearerToken, }: {
         params: CreateWalletParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<CreateWalletResponse>;
     recordSendTransaction({ params, bearerToken, }: {
         params: RecordSendTransactionParams;
-        bearerToken: string;
+        bearerToken?: string;
     }): Promise<Transaction>;
-    getWallet(params: GetWalletParams, bearerToken: string): Promise<(_chipi_stack_types.GetWalletResponse & {
+    getWallet(params: GetWalletParams, bearerToken?: string): Promise<(_chipi_stack_types.GetWalletResponse & {
         normalizedPublicKey: string;
     }) | null>;
-    getTokenBalance(params: GetTokenBalanceParams, bearerToken: string): Promise<GetTokenBalanceResponse>;
+    getTokenBalance(params: GetTokenBalanceParams, bearerToken?: string): Promise<GetTokenBalanceResponse>;
+}
+
+/**
+ * Server-side Chipi SDK with built-in API Secret Key authentication
+ *
+ * This class is designed for server-side environments where you can safely store
+ * the API Secret Key. All methods automatically use the secret key for authentication,
+ * so you don't need to pass a bearer token with each call.
+ *
+ * The apiSecretKey is stored internally and used automatically for all authenticated requests.
+ * All methods from ChipiSDK are inherited and work without requiring a bearerToken parameter.
+ *
+ * @example
+ * ```typescript
+ * const chipiServer = new ChipiServerSDK({
+ *   apiPublicKey: "pk_...",
+ *   apiSecretKey: "sk_...",
+ *   environment: "production"
+ * });
+ *
+ * // No bearer token needed - automatically uses apiSecretKey!
+ * const wallet = await chipiServer.createWallet({
+ *   params: {
+ *     encryptKey: "user-encryption-key",
+ *     externalUserId: "user-123"
+ *   }
+ * });
+ *
+ * const userWallet = await chipiServer.getWallet({ externalUserId: "user-123" });
+ * const txHash = await chipiServer.transfer({ params: { ... } });
+ * ```
+ */
+declare class ChipiServerSDK extends ChipiSDK {
+    constructor(config: ChipiServerSDKConfig);
+}
+
+/**
+ * Browser-side Chipi SDK for client-side applications
+ *
+ * This class is designed for browser environments (Vue, Svelte, Angular, vanilla JS, etc.)
+ * where you need to pass a bearer token (JWT) with each authenticated request.
+ *
+ * All methods require a bearerToken parameter since browser environments should not
+ * store API Secret Keys.
+ *
+ * ⚠️  SECURITY WARNING: DO NOT use your API Secret Key in browser environments!
+ * The secret key should only be used server-side with ChipiServerSDK.
+ *
+ * @example
+ * ```typescript
+ * const chipiBrowser = new ChipiBrowserSDK({
+ *   apiPublicKey: "pk_...",
+ *   environment: "production"
+ * });
+ *
+ * // Get user's JWT token from your auth system
+ * const userToken = await getUserJWT();
+ *
+ * // Pass bearer token with each call
+ * const wallet = await chipiBrowser.createWallet({
+ *   params: {
+ *     encryptKey: "user-encryption-key",
+ *     externalUserId: "user-123"
+ *   },
+ *   bearerToken: userToken
+ * });
+ *
+ * const userWallet = await chipiBrowser.getWallet({ externalUserId: "user-123" }, userToken);
+ * const txHash = await chipiBrowser.transfer({ params: {...}, bearerToken: userToken });
+ * ```
+ */
+declare class ChipiBrowserSDK extends ChipiSDK {
+    constructor(config: ChipiBrowserSDKConfig);
 }
 
 declare const encryptPrivateKey: (privateKey: string, password: string) => string;
 declare const decryptPrivateKey: (encryptedPrivateKey: string, password: string) => string;
 
-export { ChipiSDK, ChipiSkus, ChipiTransactions, ChipiWallets, decryptPrivateKey, encryptPrivateKey };
+export { ChipiBrowserSDK, ChipiSDK, ChipiServerSDK, ChipiSkus, ChipiTransactions, ChipiWallets, decryptPrivateKey, encryptPrivateKey };

package/dist/index.js

@@ -297,9 +297,14 @@ var ChipiWallets = class {
     return getBalanceResponse;
   }
 };
-var executePaymasterTransaction = async (params) => {
+var executePaymasterTransaction = async ({
+  params,
+  bearerToken,
+  apiPublicKey,
+  backendUrl
+}) => {
   try {
-    const { encryptKey, wallet, calls, apiPublicKey, bearerToken, backendUrl } = params;
+    const { encryptKey, wallet, calls } = params;
     const privateKeyDecrypted = decryptPrivateKey(
       wallet.encryptedPrivateKey,
       encryptKey
@@ -380,9 +385,13 @@ var ChipiTransactions = class {
   /**
    * Execute a gasless transaction using paymaster
    */
-  async executeTransaction(params) {
+  async executeTransaction({
+    params,
+    bearerToken
+  }) {
     return executePaymasterTransaction({
-      ...params,
+      params,
+      bearerToken,
       backendUrl: this.client.baseUrl,
       apiPublicKey: this.client.getApiPublicKey()
     });
@@ -407,16 +416,18 @@ var ChipiTransactions = class {
     }
     const formattedAmount = shared.formatAmount(amount, decimals);
     return this.executeTransaction({
-      encryptKey,
-      wallet,
-      bearerToken,
-      calls: [
-        {
-          contractAddress,
-          entrypoint: "transfer",
-          calldata: [recipient, formattedAmount, "0x0"]
-        }
-      ]
+      params: {
+        encryptKey,
+        wallet,
+        calls: [
+          {
+            contractAddress,
+            entrypoint: "transfer",
+            calldata: [recipient, formattedAmount, "0x0"]
+          }
+        ]
+      },
+      bearerToken
     });
   }
   /**
@@ -425,27 +436,36 @@ var ChipiTransactions = class {
   async approve(params) {
     const formattedAmount = shared.formatAmount(params.amount, params.decimals);
     return this.executeTransaction({
-      encryptKey: params.encryptKey,
-      wallet: params.wallet,
-      bearerToken: params.bearerToken,
-      calls: [
-        {
-          contractAddress: params.contractAddress,
-          entrypoint: "approve",
-          calldata: [params.spender, formattedAmount, "0x0"]
-        }
-      ]
+      params: {
+        encryptKey: params.encryptKey,
+        wallet: params.wallet,
+        calls: [
+          {
+            contractAddress: params.contractAddress,
+            entrypoint: "approve",
+            calldata: [params.spender, formattedAmount, "0x0"]
+          }
+        ]
+      },
+      bearerToken: params.bearerToken
     });
   }
   /**
    * Call any contract method
    */
-  async callAnyContract(params) {
+  // {
+  //   encryptKey: string;
+  //   wallet: any;
+  //   calls: any[];
+  //   bearerToken: string;
+  // }
+  async callAnyContract({
+    params,
+    bearerToken
+  }) {
     return this.executeTransaction({
-      encryptKey: params.encryptKey,
-      wallet: params.wallet,
-      bearerToken: params.bearerToken,
-      calls: params.calls
+      params,
+      bearerToken
     });
   }
   /**
@@ -476,6 +496,7 @@ var ChipiSDK = class {
   constructor(config) {
     this.client = new ChipiClient(config);
     this.nodeUrl = config.nodeUrl || shared.STARKNET_NETWORKS.MAINNET;
+    this.apiSecretKey = config.apiSecretKey;
     this.wallets = new ChipiWallets(this.client);
     this.transactions = new ChipiTransactions(this.client);
     this.skus = new ChipiSkus(this.client);
@@ -488,11 +509,29 @@ var ChipiSDK = class {
     this.createWallet = this.createWallet.bind(this);
     this.recordSendTransaction = this.recordSendTransaction.bind(this);
   }
+  /**
+   * Resolve bearer token - uses provided token or falls back to apiSecretKey
+   */
+  resolveBearerToken(bearerToken) {
+    const token = bearerToken ?? this.apiSecretKey;
+    if (!token) {
+      throw new Error(
+        "Authentication required: either pass a bearerToken or configure the SDK with an apiSecretKey"
+      );
+    }
+    return token;
+  }
   /**
    * Execute a gasless transaction
    */
-  async executeTransaction(params) {
-    return this.transactions.executeTransaction(params);
+  async executeTransaction({
+    params,
+    bearerToken
+  }) {
+    return this.transactions.executeTransaction({
+      params,
+      bearerToken: this.resolveBearerToken(bearerToken)
+    });
   }
   /**
    * Transfer tokens
@@ -503,7 +542,7 @@ var ChipiSDK = class {
   }) {
     return this.transactions.transfer({
       params,
-      bearerToken
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
   /**
@@ -515,16 +554,18 @@ var ChipiSDK = class {
   }) {
     const { encryptKey, wallet, contractAddress, spender, amount, decimals } = params;
     return this.executeTransaction({
-      encryptKey,
-      wallet,
-      bearerToken,
-      calls: [
-        {
-          contractAddress,
-          entrypoint: "approve",
-          calldata: [spender, shared.formatAmount(amount, decimals), "0x0"]
-        }
-      ]
+      params: {
+        encryptKey,
+        wallet,
+        calls: [
+          {
+            contractAddress,
+            entrypoint: "approve",
+            calldata: [spender, shared.formatAmount(amount, decimals), "0x0"]
+          }
+        ]
+      },
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
   /**
@@ -537,25 +578,27 @@ var ChipiSDK = class {
     const { encryptKey, wallet, amount, receiverWallet } = params;
     const formattedAmount = shared.formatAmount(amount, 6);
     return this.executeTransaction({
-      encryptKey,
-      wallet,
-      bearerToken,
-      calls: [
-        {
-          contractAddress: shared.CONTRACT_ADDRESSES.USDC_MAINNET,
-          entrypoint: "approve",
-          calldata: [
-            shared.CONTRACT_ADDRESSES.VESU_USDC_MAINNET,
-            formattedAmount,
-            "0x0"
-          ]
-        },
-        {
-          contractAddress: shared.CONTRACT_ADDRESSES.VESU_USDC_MAINNET,
-          entrypoint: "deposit",
-          calldata: [formattedAmount, "0x0", receiverWallet]
-        }
-      ]
+      params: {
+        encryptKey,
+        wallet,
+        calls: [
+          {
+            contractAddress: shared.CONTRACT_ADDRESSES.USDC_MAINNET,
+            entrypoint: "approve",
+            calldata: [
+              shared.CONTRACT_ADDRESSES.VESU_USDC_MAINNET,
+              formattedAmount,
+              "0x0"
+            ]
+          },
+          {
+            contractAddress: shared.CONTRACT_ADDRESSES.VESU_USDC_MAINNET,
+            entrypoint: "deposit",
+            calldata: [formattedAmount, "0x0", receiverWallet]
+          }
+        ]
+      },
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
   /**
@@ -568,16 +611,18 @@ var ChipiSDK = class {
     const { encryptKey, wallet, amount, recipient } = params;
     const formattedAmount = shared.formatAmount(amount, 6);
     return this.executeTransaction({
-      encryptKey,
-      wallet,
-      bearerToken,
-      calls: [
-        {
-          contractAddress: shared.CONTRACT_ADDRESSES.VESU_USDC_MAINNET,
-          entrypoint: "withdraw",
-          calldata: [formattedAmount, recipient, "0x0"]
-        }
-      ]
+      params: {
+        encryptKey,
+        wallet,
+        calls: [
+          {
+            contractAddress: shared.CONTRACT_ADDRESSES.VESU_USDC_MAINNET,
+            entrypoint: "withdraw",
+            calldata: [formattedAmount, recipient, "0x0"]
+          }
+        ]
+      },
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
   /**
@@ -589,10 +634,12 @@ var ChipiSDK = class {
   }) {
     const { encryptKey, wallet, calls } = params;
     return this.executeTransaction({
-      encryptKey,
-      wallet,
-      bearerToken,
-      calls
+      params: {
+        encryptKey,
+        wallet,
+        calls
+      },
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
   /**
@@ -604,7 +651,7 @@ var ChipiSDK = class {
   }) {
     return this.wallets.createWallet({
       ...params,
-      bearerToken
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
   async recordSendTransaction({
@@ -613,22 +660,47 @@ var ChipiSDK = class {
   }) {
     return this.transactions.recordSendTransaction({
       params,
-      bearerToken
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
   async getWallet(params, bearerToken) {
-    return this.wallets.getWallet(params, bearerToken);
+    return this.wallets.getWallet(params, this.resolveBearerToken(bearerToken));
   }
   async getTokenBalance(params, bearerToken) {
     return this.wallets.getTokenBalance({
       params,
-      bearerToken
+      bearerToken: this.resolveBearerToken(bearerToken)
     });
   }
 };
 
+// src/chipi-server-sdk.ts
+var ChipiServerSDK = class extends ChipiSDK {
+  constructor(config) {
+    if (!config.apiSecretKey) {
+      throw new Error(
+        "apiSecretKey is required for ChipiServerSDK. Use ChipiBrowserSDK for client-side applications."
+      );
+    }
+    super(config);
+  }
+  // All methods are inherited from ChipiSDK
+  // The apiSecretKey from config is automatically used via resolveBearerToken()
+};
+
+// src/chipi-browser-sdk.ts
+var ChipiBrowserSDK = class extends ChipiSDK {
+  constructor(config) {
+    super(config);
+  }
+  // All methods are inherited from ChipiSDK
+  // bearerToken parameter is required for each authenticated request
+};
+
+exports.ChipiBrowserSDK = ChipiBrowserSDK;
 exports.ChipiClient = ChipiClient;
 exports.ChipiSDK = ChipiSDK;
+exports.ChipiServerSDK = ChipiServerSDK;
 exports.ChipiSkus = ChipiSkus;
 exports.ChipiTransactions = ChipiTransactions;
 exports.ChipiWallets = ChipiWallets;