@chipi-stack/backend 11.5.0 → 11.7.0

package/dist/index.d.mts

@@ -1,8 +1,9 @@
 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, CreateSkuTransactionParams, SkuTransaction, ChipiServerSDKConfig, ChipiBrowserSDKConfig } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 import { ChipiWallets } from './wallets.mjs';
 import { ChipiTransactions } from './transactions.mjs';
+import { ChipiSkuTransactions } from './skuTransactions.mjs';
 import { ChipiSkus } from './skus.mjs';
 export { C as ChipiClient } from './client-D4ZnPqgQ.mjs';
 
@@ -12,67 +13,156 @@ export { C as ChipiClient } from './client-D4ZnPqgQ.mjs';
 declare class ChipiSDK {
     private client;
     private nodeUrl;
+    private apiSecretKey?;
     readonly wallets: ChipiWallets;
     readonly transactions: ChipiTransactions;
+    readonly skuTransactions: ChipiSkuTransactions;
     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 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>;
+    /**
+     * Create a SKU transaction
+     */
+    createSkuTransaction({ params, bearerToken, }: {
+        params: CreateSkuTransactionParams;
+        bearerToken: string;
+    }): Promise<SkuTransaction>;
+}
+
+/**
+ * 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, ChipiSkuTransactions, ChipiSkus, ChipiTransactions, ChipiWallets, decryptPrivateKey, encryptPrivateKey };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 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, CreateSkuTransactionParams, SkuTransaction, ChipiServerSDKConfig, ChipiBrowserSDKConfig } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 import { ChipiWallets } from './wallets.js';
 import { ChipiTransactions } from './transactions.js';
+import { ChipiSkuTransactions } from './skuTransactions.js';
 import { ChipiSkus } from './skus.js';
 export { C as ChipiClient } from './client-D4ZnPqgQ.js';
 
@@ -12,67 +13,156 @@ export { C as ChipiClient } from './client-D4ZnPqgQ.js';
 declare class ChipiSDK {
     private client;
     private nodeUrl;
+    private apiSecretKey?;
     readonly wallets: ChipiWallets;
     readonly transactions: ChipiTransactions;
+    readonly skuTransactions: ChipiSkuTransactions;
     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 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>;
+    /**
+     * Create a SKU transaction
+     */
+    createSkuTransaction({ params, bearerToken, }: {
+        params: CreateSkuTransactionParams;
+        bearerToken: string;
+    }): Promise<SkuTransaction>;
+}
+
+/**
+ * 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, ChipiSkuTransactions, ChipiSkus, ChipiTransactions, ChipiWallets, decryptPrivateKey, encryptPrivateKey };