squarefi-bff-api-module 1.24.34 → 1.25.0

package/README.md

@@ -49,9 +49,19 @@ const cards = await api.issuing.cards.byWalletUuid.getAll({
 
 // 3) Exchange rates helper
 await api.exchange.byOrderType[OrderType.DEPOSIT_FIAT_SEPA].getByFromCurrency(firstWalletUuid);
-```
 
-See the [Examples](#examples) section below for more real-life snippets.
+// 4) Real-time subscriptions (React only)
+import { useSupabaseSubscription } from 'squarefi-bff-api-module';
+
+const { isConnected } = useSupabaseSubscription({
+  config: {
+    channelName: 'my-channel',
+    table: 'transactions',
+    event: '*',
+  },
+  callback: (payload) => console.log('Real-time update:', payload),
+});
+```
 
 ---
 
@@ -59,19 +69,59 @@ See the [Examples](#examples) section below for more real-life snippets.
 
 The SDK reads connection details from process-level variables. When bundling for the browser, tools like **Vite**, **Webpack DefinePlugin**, or **Next.js** can safely inline those values at build time.
 
-| Name                       | Description                                                          | Required                      | Example                       |
-| -------------------------- | -------------------------------------------------------------------- | ----------------------------- | ----------------------------- |
-| `API_URL`                  | Base URL of the BFF **v1** service                                   | ✅                            | `https://api-v1.squarefi.com` |
-| `API_V2_URL`               | Base URL of the BFF **v2** service                                   | ✅                            | `https://api-v2.squarefi.com` |
-| `API_TOTP_URL`             | Base URL of the **TOTP / OTP** micro-service                         | ⚠️ _If you use TOTP features_ | `https://totp.squarefi.com`   |
-| `TENANT_ID`                | Your tenant / organisation identifier                                | ✅                            | `tenant_12345`                |
-| `LOGOUT_URL`               | Frontend route where the user is redirected when refresh token fails | ❌                            | `/auth/logout`                |
-| `SERVER_PUBLIC_KEY_BASE64` | PEM encoded key (base64) used for request signing                    | ✅                            | `MIIBIjANBgkqh…`              |
+| Name                       | Description                                                          | Required                       | Example                       |
+| -------------------------- | -------------------------------------------------------------------- | ------------------------------ | ----------------------------- |
+| `API_URL`                  | Base URL of the BFF **v1** service                                   | ✅                             | `https://api-v1.squarefi.com` |
+| `API_V2_URL`               | Base URL of the BFF **v2** service                                   | ✅                             | `https://api-v2.squarefi.com` |
+| `API_TOTP_URL`             | Base URL of the **TOTP / OTP** micro-service                         | ⚠️ _If you use TOTP features_  | `https://totp.squarefi.com`   |
+| `TENANT_ID`                | Your tenant / organisation identifier                                | ✅                             | `tenant_12345`                |
+| `LOGOUT_URL`               | Frontend route where the user is redirected when refresh token fails | ❌                             | `/auth/logout`                |
+| `SERVER_PUBLIC_KEY_BASE64` | PEM encoded key (base64) used for request signing                    | ✅                             | `MIIBIjANBgkqh…`              |
+| `SUPABASE_URL`             | Supabase project URL for real-time subscriptions                     | ⚠️ _If you use Supabase hooks_ | `https://xyz.supabase.co`     |
+| `SUPABASE_PUBLIC_KEY`      | Supabase public anon key for client authentication                   | ⚠️ _If you use Supabase hooks_ | `eyJhbGciOiJIUzI1NiIs…`       |
 
 > ℹ️ When running in Node.js you can place these variables in a `.env` file and load them with [dotenv](https://npmjs.com/package/dotenv).
 
 ---
 
+## 🔄 React Hooks
+
+The SDK includes React hooks for real-time functionality powered by Supabase:
+
+### useSupabaseSubscription
+
+A hook for subscribing to real-time database changes via Supabase.
+
+```tsx
+import { useSupabaseSubscription } from 'squarefi-bff-api-module';
+
+function MyComponent() {
+  const { isConnected, isClientAvailable } = useSupabaseSubscription({
+    config: {
+      channelName: 'wallet-transactions',
+      table: 'transactions',
+      schema: 'public',
+      event: 'INSERT', // 'INSERT' | 'UPDATE' | 'DELETE' | '*'
+      filter: 'wallet_id=eq.123',
+    },
+    callback: (payload) => {
+      console.log('New transaction:', payload);
+    },
+    enabled: true,
+  });
+
+  if (!isClientAvailable) {
+    return <div>Supabase not configured</div>;
+  }
+
+  return <div>Status: {isConnected ? 'Connected' : 'Disconnected'}</div>;
+}
+```
+
+> ⚠️ **Important**: The hook will throw an error if Supabase environment variables are missing and you attempt to use it. Make sure to set `SUPABASE_URL` and `SUPABASE_PUBLIC_KEY` environment variables.
+
+---
+
 ## 🗺️ API surface
 
 `squarefi_bff_api_client` is a plain object where every property is a namespaced group of operations. The list below reflects the current SDK version (v1.18.13).

package/dist/api/types/autogen/apiV2.types.d.ts

@@ -1237,8 +1237,6 @@ export interface components {
         TransactionsFilter: {
             created_at?: string;
             /** @enum {string} */
-            status?: "complete" | "pending" | "canceled" | "failed" | "processing" | "new";
-            /** @enum {string} */
             type?: "deposit_crypto" | "withdrawal_crypto" | "deposit_fiat" | "withdrawal_fiat" | "deposit_vcard" | "withdrawal_vcard" | "deposit" | "withdrawal";
             /** @enum {string|null} */
             method?: "p2p" | "crypto" | "bank_transfer" | "exchange" | "sbp" | "internal_fiat" | null;
@@ -1255,6 +1253,7 @@ export interface components {
             to_created_at?: string;
             /** @default false */
             show_low_balance: boolean;
+            status?: ("complete" | "pending" | "canceled" | "failed" | "processing" | "new")[];
         };
         ChainDto: {
             id: number;
@@ -2984,7 +2983,9 @@ export interface operations {
     };
     WalletsTransactionsController_export: {
         parameters: {
-            query?: never;
+            query?: {
+                status?: ("complete" | "pending" | "canceled" | "failed" | "processing" | "new")[];
+            };
             header?: never;
             path: {
                 wallet_id: string;

package/dist/api/types/types.d.ts

@@ -668,136 +668,6 @@ export declare namespace API {
             }
         }
     }
-    namespace SubAccountsV2 {
-        type SubAccountDetails = {
-            iban: string;
-            bank_name: string;
-            swift_code: string;
-            bank_address: string;
-            receiver_name: string;
-            payment_details: string;
-            reference_number: string;
-            registration_number: string;
-        };
-        interface SubAccount {
-            balance: number;
-            cards_count: number;
-            created_at: string;
-            currency: API.Currencies.FiatCurrency;
-            fiat_balance: number;
-            id: string;
-            issuing_program: API.Cards.Config.Program;
-            nick_name: string;
-            program_id: string;
-            realtimeauth_balance: number;
-            status: string;
-            total_balance: number;
-            wallet_id: string;
-        }
-        namespace ExtendedSubAccount {
-            interface ExtendedSubAccount extends SubAccount {
-                account_details?: SubAccountDetails;
-                payment_types: Array<{
-                    order_type: OrderType;
-                }>;
-                realtime_auth: [
-                    {
-                        crypto_token: string;
-                        fiat_account: string;
-                        id: string;
-                        priority: number;
-                    }
-                ];
-            }
-            interface Request {
-                wallet_uuid: string;
-                fiat_account_id: string;
-            }
-            type Response = ExtendedSubAccount;
-        }
-        interface SubAccountWithCards extends SubAccount {
-            cards: API.Cards.IssuingCardListItem[];
-        }
-        interface SubAccountsList<T extends SubAccount | SubAccountWithCards> {
-            count: number;
-            data: T[];
-        }
-        type SubAccountsListWithCards = SubAccountsList<SubAccountWithCards>;
-        type SubAccountsListWithoutCards = SubAccountsList<SubAccount>;
-        namespace CreateSubAccount {
-            interface Request {
-                wallet_id: string;
-                program_id: string;
-            }
-            type Response = {
-                id: string;
-                balance: number;
-                nick_name: string;
-                wallet_id: string;
-                created_at: string;
-                account_currency: string;
-                type: SubAccountType | string;
-                program_id: string;
-                status: 'ACTIVE';
-                fiat: {
-                    code: string;
-                    uuid: string;
-                    symbol: string;
-                    enabled: boolean;
-                    coingecko: string;
-                };
-                issuing_program: {
-                    id: string;
-                    form_factor: CardFormFactor | string;
-                    brand: string;
-                    tokenizable: boolean;
-                    type: CardType | string;
-                };
-            };
-        }
-        namespace Transactions {
-            type Transaction = {
-                vendor_transaction_id: string;
-                created_at: string;
-                cleared_at: string;
-                merchant: {
-                    name: string;
-                    category_code: string;
-                    city: string;
-                    country: string;
-                };
-                last4: string;
-                title: string;
-                billing_amount: number;
-                billing_currency: string;
-                transaction_amount: number;
-                transaction_currency: string;
-                vendor_sub_account_id: string;
-                failure_reason: string;
-                status: string;
-                transaction_type: string;
-                is_credit: boolean;
-                has_receipt: boolean;
-                adjustment_type: string;
-                review_status: string;
-                group: string;
-                total_amount: number;
-            };
-            namespace TransactionList {
-                interface Request {
-                    fiat_account_id: string;
-                    wallet_uuid: string;
-                    limit?: number;
-                    offset?: number;
-                }
-                interface Response {
-                    count: number;
-                    data: Transaction[];
-                    has_more: boolean;
-                }
-            }
-        }
-    }
     namespace Issuing {
         namespace Programs {
             type Request = {
@@ -2419,7 +2289,7 @@ export declare namespace API {
                     offset: number;
                     filter?: {
                         created_at?: string;
-                        status?: WalletTransactionStatus;
+                        status?: WalletTransactionStatus[];
                         type?: WalletTransactionType;
                         method?: WalletTransactionMethod;
                         record_type?: WalletTransactionRecordType;
@@ -2435,6 +2305,15 @@ export declare namespace API {
                     total: number;
                     data: Transaction[];
                 };
+                namespace ExportCsv {
+                    type Request = {
+                        wallet_uuid: string;
+                        status?: WalletTransactionStatus[];
+                        from_created_at?: string;
+                        to_created_at?: string;
+                    };
+                    type Response = string;
+                }
             }
         }
     }

package/dist/api/wallets.d.ts

@@ -18,7 +18,7 @@ export declare const wallets: {
             getByUuid: ({ wallet_uuid, uuid, }: API.Wallets.WalletTransactions.GetByUuid.Request) => Promise<API.Wallets.WalletTransactions.DetailedTransaction>;
         };
         csv: {
-            getByWalletUuid: (wallet_uuid: string) => Promise<string>;
+            getByWalletUuid: ({ wallet_uuid, ...params }: API.Wallets.WalletTransactions.TransactionList.ExportCsv.Request) => Promise<API.Wallets.WalletTransactions.TransactionList.ExportCsv.Response>;
         };
     };
 };

package/dist/api/wallets.js

@@ -47,7 +47,10 @@ exports.wallets = {
             getByUuid: ({ wallet_uuid, uuid, }) => apiClientFactory_1.apiClientV2.getRequest(`/wallets/${wallet_uuid}/transactions/${uuid}`),
         },
         csv: {
-            getByWalletUuid: (wallet_uuid) => apiClientFactory_1.apiClientV1.getRequest(`/wallets/transactions/${wallet_uuid}/csv`),
+            getByWalletUuid: (_a) => {
+                var { wallet_uuid } = _a, params = __rest(_a, ["wallet_uuid"]);
+                return apiClientFactory_1.apiClientV2.getRequest(`/wallets/${wallet_uuid}/transactions/export/csv`, { params });
+            },
         },
     },
 };

package/dist/hooks/index.d.ts

@@ -1 +1,2 @@
 export * from './useCalc';
+export * from './useSupabaseSubscription';

package/dist/hooks/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./useCalc"), exports);
+__exportStar(require("./useSupabaseSubscription"), exports);

package/dist/hooks/useSupabaseSubscription/config.d.ts

@@ -0,0 +1,2 @@
+import { SubscriptionConfig } from './types';
+export declare const createWalletTransactionsConfig: (walletId: string) => SubscriptionConfig;

package/dist/hooks/useSupabaseSubscription/config.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWalletTransactionsConfig = void 0;
+const createWalletTransactionsConfig = (walletId) => ({
+    channelName: `wallet-transactions-${walletId}`,
+    table: 'transactions',
+    filter: `wallet_id=eq.${walletId}`,
+});
+exports.createWalletTransactionsConfig = createWalletTransactionsConfig;

package/dist/hooks/useSupabaseSubscription/index.d.ts

@@ -0,0 +1,3 @@
+export { useSupabaseSubscription } from './useSupabaseSubscription';
+export { useWalletTransactionsSubscription } from './specialized';
+export type { SubscriptionConfig, UseSupabaseSubscriptionProps, UseWalletTransactionsSubscriptionProps } from './types';

package/dist/hooks/useSupabaseSubscription/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWalletTransactionsSubscription = exports.useSupabaseSubscription = void 0;
+var useSupabaseSubscription_1 = require("./useSupabaseSubscription");
+Object.defineProperty(exports, "useSupabaseSubscription", { enumerable: true, get: function () { return useSupabaseSubscription_1.useSupabaseSubscription; } });
+var specialized_1 = require("./specialized");
+Object.defineProperty(exports, "useWalletTransactionsSubscription", { enumerable: true, get: function () { return specialized_1.useWalletTransactionsSubscription; } });

package/dist/hooks/useSupabaseSubscription/specialized.d.ts

@@ -0,0 +1,5 @@
+import { UseWalletTransactionsSubscriptionProps } from './types';
+export declare const useWalletTransactionsSubscription: ({ walletId, callback, enabled, }: UseWalletTransactionsSubscriptionProps) => {
+    isConnected: boolean;
+    isClientAvailable: boolean;
+};

package/dist/hooks/useSupabaseSubscription/specialized.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWalletTransactionsSubscription = void 0;
+const config_1 = require("./config");
+const useSupabaseSubscription_1 = require("./useSupabaseSubscription");
+const useWalletTransactionsSubscription = ({ walletId, callback, enabled = true, }) => (0, useSupabaseSubscription_1.useSupabaseSubscription)({
+    config: (0, config_1.createWalletTransactionsConfig)(walletId || ''),
+    callback,
+    enabled: enabled && !!walletId,
+});
+exports.useWalletTransactionsSubscription = useWalletTransactionsSubscription;

package/dist/hooks/useSupabaseSubscription/types.d.ts

@@ -0,0 +1,17 @@
+export interface SubscriptionConfig {
+    channelName: string;
+    table: string;
+    schema?: string;
+    event?: 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+    filter?: string;
+}
+export interface UseSupabaseSubscriptionProps {
+    config: SubscriptionConfig;
+    callback: (payload?: unknown) => void;
+    enabled?: boolean;
+}
+export interface UseWalletTransactionsSubscriptionProps {
+    walletId: string | undefined;
+    callback: () => void;
+    enabled?: boolean;
+}

package/dist/hooks/useSupabaseSubscription/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/hooks/useSupabaseSubscription/useSupabaseSubscription.d.ts

@@ -0,0 +1,5 @@
+import { UseSupabaseSubscriptionProps } from './types';
+export declare const useSupabaseSubscription: ({ config, callback, enabled }: UseSupabaseSubscriptionProps) => {
+    isConnected: boolean;
+    isClientAvailable: boolean;
+};

package/dist/hooks/useSupabaseSubscription/useSupabaseSubscription.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSupabaseSubscription = void 0;
+const react_1 = require("react");
+const supabase_1 = require("../../utils/supabase");
+const useSupabaseSubscription = ({ config, callback, enabled = true }) => {
+    const subscriptionRef = (0, react_1.useRef)(null);
+    const callbackRef = (0, react_1.useRef)(callback);
+    callbackRef.current = callback;
+    (0, react_1.useEffect)(() => {
+        if (!enabled) {
+            return;
+        }
+        if (!supabase_1.supabaseClient) {
+            throw new Error('Supabase client is not available');
+        }
+        if (subscriptionRef.current) {
+            supabase_1.supabaseClient.removeChannel(subscriptionRef.current);
+            subscriptionRef.current = null;
+        }
+        const subscription = supabase_1.supabaseClient
+            .channel(config.channelName)
+            .on('postgres_changes', Object.assign({ event: config.event || '*', schema: config.schema || 'public', table: config.table }, (config.filter && { filter: config.filter })), (payload) => callbackRef.current(payload))
+            .subscribe();
+        subscriptionRef.current = subscription;
+        return () => {
+            if (subscriptionRef.current && supabase_1.supabaseClient) {
+                supabase_1.supabaseClient.removeChannel(subscriptionRef.current);
+                subscriptionRef.current = null;
+            }
+        };
+    }, [enabled, config.channelName, config.table, config.schema, config.event, config.filter]);
+    return {
+        isConnected: !!subscriptionRef.current,
+        isClientAvailable: !!supabase_1.supabaseClient,
+    };
+};
+exports.useSupabaseSubscription = useSupabaseSubscription;

package/dist/utils/encrypt.js

@@ -27,10 +27,56 @@ const decryptAESData = (encryptedData, iv, secretKey) => __awaiter(void 0, void
     return JSON.parse(decrypted);
 });
 exports.decryptAESData = decryptAESData;
+/**
+ * Очищает и валидирует публичный RSA ключ
+ * Исправляет ошибку InvalidAsn1Error: encoding too long
+ * путем удаления лишних символов и нормализации переносов строк
+ */
+const cleanAndValidatePublicKey = (publicKey) => {
+    try {
+        // Декодируем base64 ключ
+        const publicKeyBase64 = Buffer.from(publicKey, 'base64').toString('utf8');
+        // Удаляем лишние символы (переносы строк, пробелы в начале и конце)
+        // Нормализуем переносы строк для корректной обработки ASN.1
+        const cleanedKey = publicKeyBase64.trim().replace(/\r?\n|\r/g, '\n');
+        // Проверяем, что ключ содержит необходимые маркеры
+        if (!cleanedKey.includes('BEGIN') || !cleanedKey.includes('END')) {
+            throw new Error('Invalid public key format: missing BEGIN/END markers');
+        }
+        return cleanedKey;
+    }
+    catch (error) {
+        throw new Error(`Invalid public key format: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+};
+/**
+ * Автоматически определяет формат RSA ключа по заголовку
+ * Помогает избежать ошибок импорта при неправильном указании формата
+ */
+const detectKeyFormat = (key) => {
+    if (key.includes('BEGIN RSA PUBLIC KEY')) {
+        return 'pkcs1';
+    }
+    else if (key.includes('BEGIN PUBLIC KEY')) {
+        return 'pkcs8';
+    }
+    // По умолчанию возвращаем pkcs8, как было ранее
+    return 'pkcs8';
+};
 const makeSecureRequest = (_a) => __awaiter(void 0, [_a], void 0, function* ({ callback, publicKey }) {
     const clientRsa = new node_rsa_1.default();
-    const publicKeyBase64 = Buffer.from(publicKey, 'base64').toString('utf8');
-    clientRsa.importKey(publicKeyBase64, 'pkcs8-public-pem');
+    try {
+        // Очищаем и валидируем публичный ключ
+        const cleanedPublicKey = cleanAndValidatePublicKey(publicKey);
+        // Определяем формат ключа автоматически
+        const keyFormat = detectKeyFormat(cleanedPublicKey);
+        // Импортируем ключ с правильным форматом
+        clientRsa.importKey(cleanedPublicKey, `${keyFormat}-public-pem`);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to import RSA public key: ${errorMessage}`);
+    }
     const clientSecretKey = (0, exports.generateSecretKey)();
     const clientPayload = {
         key: clientSecretKey.toString('base64'),

package/dist/utils/supabase.d.ts

@@ -0,0 +1 @@
+export declare const supabaseClient: import("@supabase/supabase-js").SupabaseClient<any, "public", any> | null;

package/dist/utils/supabase.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supabaseClient = void 0;
+const supabase_js_1 = require("@supabase/supabase-js");
+const createSupabaseClient = () => {
+    const supabaseUrl = process.env.SUPABASE_URL;
+    const supabasePublicKey = process.env.SUPABASE_PUBLIC_KEY;
+    if (!supabaseUrl || !supabasePublicKey) {
+        console.warn('Supabase environment variables are missing. Client will not be created.');
+        return null;
+    }
+    return (0, supabase_js_1.createClient)(supabaseUrl, supabasePublicKey);
+};
+exports.supabaseClient = createSupabaseClient();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squarefi-bff-api-module",
-  "version": "1.24.34",
+  "version": "1.25.0",
   "description": "Squarefi BFF API client module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,6 +23,7 @@
   "author": "Your Name",
   "license": "MIT",
   "dependencies": {
+    "@supabase/supabase-js": "^2.55.0",
     "@telegram-apps/sdk-react": "^3.1.2",
     "axios": "^1.6.7",
     "lodash.debounce": "^4.0.8",

package/src/api/types/autogen/apiV2.types.ts

@@ -1238,8 +1238,6 @@ export interface components {
         TransactionsFilter: {
             created_at?: string;
             /** @enum {string} */
-            status?: "complete" | "pending" | "canceled" | "failed" | "processing" | "new";
-            /** @enum {string} */
             type?: "deposit_crypto" | "withdrawal_crypto" | "deposit_fiat" | "withdrawal_fiat" | "deposit_vcard" | "withdrawal_vcard" | "deposit" | "withdrawal";
             /** @enum {string|null} */
             method?: "p2p" | "crypto" | "bank_transfer" | "exchange" | "sbp" | "internal_fiat" | null;
@@ -1256,6 +1254,7 @@ export interface components {
             to_created_at?: string;
             /** @default false */
             show_low_balance: boolean;
+            status?: ("complete" | "pending" | "canceled" | "failed" | "processing" | "new")[];
         };
         ChainDto: {
             id: number;
@@ -2985,7 +2984,9 @@ export interface operations {
     };
     WalletsTransactionsController_export: {
         parameters: {
-            query?: never;
+            query?: {
+                status?: ("complete" | "pending" | "canceled" | "failed" | "processing" | "new")[];
+            };
             header?: never;
             path: {
                 wallet_id: string;

package/src/api/types/types.ts

@@ -819,144 +819,144 @@ export namespace API {
     }
   }
 
-  export namespace SubAccountsV2 {
-    export type SubAccountDetails = {
-      iban: string;
-      bank_name: string;
-      swift_code: string;
-      bank_address: string;
-      receiver_name: string;
-      payment_details: string;
-      reference_number: string;
-      registration_number: string;
-    };
-
-    export interface SubAccount {
-      balance: number;
-      cards_count: number;
-      created_at: string;
-      currency: API.Currencies.FiatCurrency;
-      fiat_balance: number;
-      id: string;
-      issuing_program: API.Cards.Config.Program;
-      nick_name: string;
-      program_id: string;
-      realtimeauth_balance: number;
-      status: string;
-      total_balance: number;
-      wallet_id: string;
-    }
-
-    export namespace ExtendedSubAccount {
-      export interface ExtendedSubAccount extends SubAccount {
-        account_details?: SubAccountDetails;
-        payment_types: Array<{ order_type: OrderType }>;
-        realtime_auth: [
-          {
-            crypto_token: string;
-            fiat_account: string;
-            id: string;
-            priority: number;
-          }
-        ];
-      }
-      export interface Request {
-        wallet_uuid: string;
-        fiat_account_id: string;
-      }
-
-      export type Response = ExtendedSubAccount;
-    }
-
-    export interface SubAccountWithCards extends SubAccount {
-      cards: API.Cards.IssuingCardListItem[];
-    }
-
-    export interface SubAccountsList<T extends SubAccount | SubAccountWithCards> {
-      count: number;
-      data: T[];
-    }
-
-    export type SubAccountsListWithCards = SubAccountsList<SubAccountWithCards>;
-    export type SubAccountsListWithoutCards = SubAccountsList<SubAccount>;
-
-    export namespace CreateSubAccount {
-      export interface Request {
-        wallet_id: string;
-        program_id: string;
-      }
-      export type Response = {
-        id: string;
-        balance: number;
-        nick_name: string;
-        wallet_id: string;
-        created_at: string;
-        account_currency: string;
-        type: SubAccountType | string;
-        program_id: string;
-        status: 'ACTIVE';
-        fiat: {
-          code: string;
-          uuid: string;
-          symbol: string;
-          enabled: boolean;
-          coingecko: string;
-        };
-        issuing_program: {
-          id: string;
-          form_factor: CardFormFactor | string;
-          brand: string;
-          tokenizable: boolean;
-          type: CardType | string;
-        };
-      };
-    }
-
-    export namespace Transactions {
-      // export type Transaction = API.Cards.TransactionItem;
-      export type Transaction = {
-        vendor_transaction_id: string;
-        created_at: string;
-        cleared_at: string;
-        merchant: {
-          name: string;
-          category_code: string;
-          city: string;
-          country: string;
-        };
-        last4: string;
-        title: string;
-        billing_amount: number;
-        billing_currency: string;
-        transaction_amount: number;
-        transaction_currency: string;
-        vendor_sub_account_id: string;
-        failure_reason: string;
-        status: string;
-        transaction_type: string;
-        is_credit: boolean;
-        has_receipt: boolean;
-        adjustment_type: string;
-        review_status: string;
-        group: string;
-        total_amount: number;
-      };
-
-      export namespace TransactionList {
-        export interface Request {
-          fiat_account_id: string;
-          wallet_uuid: string;
-          limit?: number;
-          offset?: number;
-        }
-        export interface Response {
-          count: number;
-          data: Transaction[];
-          has_more: boolean;
-        }
-      }
-    }
-  }
+  // export namespace SubAccountsV2 {
+  //   export type SubAccountDetails = {
+  //     iban: string;
+  //     bank_name: string;
+  //     swift_code: string;
+  //     bank_address: string;
+  //     receiver_name: string;
+  //     payment_details: string;
+  //     reference_number: string;
+  //     registration_number: string;
+  //   };
+
+  //   export interface SubAccount {
+  //     balance: number;
+  //     cards_count: number;
+  //     created_at: string;
+  //     currency: API.Currencies.FiatCurrency;
+  //     fiat_balance: number;
+  //     id: string;
+  //     issuing_program: API.Cards.Config.Program;
+  //     nick_name: string;
+  //     program_id: string;
+  //     realtimeauth_balance: number;
+  //     status: string;
+  //     total_balance: number;
+  //     wallet_id: string;
+  //   }
+
+  //   export namespace ExtendedSubAccount {
+  //     export interface ExtendedSubAccount extends SubAccount {
+  //       account_details?: SubAccountDetails;
+  //       payment_types: Array<{ order_type: OrderType }>;
+  //       realtime_auth: [
+  //         {
+  //           crypto_token: string;
+  //           fiat_account: string;
+  //           id: string;
+  //           priority: number;
+  //         }
+  //       ];
+  //     }
+  //     export interface Request {
+  //       wallet_uuid: string;
+  //       fiat_account_id: string;
+  //     }
+
+  //     export type Response = ExtendedSubAccount;
+  //   }
+
+  //   export interface SubAccountWithCards extends SubAccount {
+  //     cards: API.Cards.IssuingCardListItem[];
+  //   }
+
+  //   export interface SubAccountsList<T extends SubAccount | SubAccountWithCards> {
+  //     count: number;
+  //     data: T[];
+  //   }
+
+  //   export type SubAccountsListWithCards = SubAccountsList<SubAccountWithCards>;
+  //   export type SubAccountsListWithoutCards = SubAccountsList<SubAccount>;
+
+  //   export namespace CreateSubAccount {
+  //     export interface Request {
+  //       wallet_id: string;
+  //       program_id: string;
+  //     }
+  //     export type Response = {
+  //       id: string;
+  //       balance: number;
+  //       nick_name: string;
+  //       wallet_id: string;
+  //       created_at: string;
+  //       account_currency: string;
+  //       type: SubAccountType | string;
+  //       program_id: string;
+  //       status: 'ACTIVE';
+  //       fiat: {
+  //         code: string;
+  //         uuid: string;
+  //         symbol: string;
+  //         enabled: boolean;
+  //         coingecko: string;
+  //       };
+  //       issuing_program: {
+  //         id: string;
+  //         form_factor: CardFormFactor | string;
+  //         brand: string;
+  //         tokenizable: boolean;
+  //         type: CardType | string;
+  //       };
+  //     };
+  //   }
+
+  //   export namespace Transactions {
+  //     // export type Transaction = API.Cards.TransactionItem;
+  //     export type Transaction = {
+  //       vendor_transaction_id: string;
+  //       created_at: string;
+  //       cleared_at: string;
+  //       merchant: {
+  //         name: string;
+  //         category_code: string;
+  //         city: string;
+  //         country: string;
+  //       };
+  //       last4: string;
+  //       title: string;
+  //       billing_amount: number;
+  //       billing_currency: string;
+  //       transaction_amount: number;
+  //       transaction_currency: string;
+  //       vendor_sub_account_id: string;
+  //       failure_reason: string;
+  //       status: string;
+  //       transaction_type: string;
+  //       is_credit: boolean;
+  //       has_receipt: boolean;
+  //       adjustment_type: string;
+  //       review_status: string;
+  //       group: string;
+  //       total_amount: number;
+  //     };
+
+  //     export namespace TransactionList {
+  //       export interface Request {
+  //         fiat_account_id: string;
+  //         wallet_uuid: string;
+  //         limit?: number;
+  //         offset?: number;
+  //       }
+  //       export interface Response {
+  //         count: number;
+  //         data: Transaction[];
+  //         has_more: boolean;
+  //       }
+  //     }
+  //   }
+  // }
 
   export namespace Issuing {
     export namespace Programs {
@@ -2824,7 +2824,7 @@ export namespace API {
           offset: number;
           filter?: {
             created_at?: string;
-            status?: WalletTransactionStatus;
+            status?: WalletTransactionStatus[];
             type?: WalletTransactionType;
             method?: WalletTransactionMethod;
             record_type?: WalletTransactionRecordType;
@@ -2840,6 +2840,16 @@ export namespace API {
           total: number;
           data: Transaction[];
         };
+
+        export namespace ExportCsv {
+          export type Request = {
+            wallet_uuid: string;
+            status?: WalletTransactionStatus[];
+            from_created_at?: string;
+            to_created_at?: string;
+          };
+          export type Response = string;
+        }
       }
     }
   }

package/src/api/wallets.ts

@@ -1,6 +1,6 @@
 import { API } from './types/types';
 
-import { apiClientV1, apiClientV2 } from '../utils/apiClientFactory';
+import { apiClientV2 } from '../utils/apiClientFactory';
 
 import { defaultPaginationParams, WalletTypeValues } from '../constants';
 
@@ -52,8 +52,14 @@ export const wallets = {
         ),
     },
     csv: {
-      getByWalletUuid: (wallet_uuid: string): Promise<string> =>
-        apiClientV1.getRequest<string>(`/wallets/transactions/${wallet_uuid}/csv`),
+      getByWalletUuid: ({
+        wallet_uuid,
+        ...params
+      }: API.Wallets.WalletTransactions.TransactionList.ExportCsv.Request): Promise<API.Wallets.WalletTransactions.TransactionList.ExportCsv.Response> =>
+        apiClientV2.getRequest<API.Wallets.WalletTransactions.TransactionList.ExportCsv.Response>(
+          `/wallets/${wallet_uuid}/transactions/export/csv`,
+          { params }
+        ),
     },
   },
 };

package/src/hooks/index.ts

@@ -1 +1,2 @@
 export * from './useCalc';
+export * from './useSupabaseSubscription';

package/src/hooks/useSupabaseSubscription/config.ts

@@ -0,0 +1,7 @@
+import { SubscriptionConfig } from './types';
+
+export const createWalletTransactionsConfig = (walletId: string): SubscriptionConfig => ({
+  channelName: `wallet-transactions-${walletId}`,
+  table: 'transactions',
+  filter: `wallet_id=eq.${walletId}`,
+});

package/src/hooks/useSupabaseSubscription/index.ts

@@ -0,0 +1,3 @@
+export { useSupabaseSubscription } from './useSupabaseSubscription';
+export { useWalletTransactionsSubscription } from './specialized';
+export type { SubscriptionConfig, UseSupabaseSubscriptionProps, UseWalletTransactionsSubscriptionProps } from './types';

package/src/hooks/useSupabaseSubscription/specialized.ts

@@ -0,0 +1,14 @@
+import { createWalletTransactionsConfig } from './config';
+import { UseWalletTransactionsSubscriptionProps } from './types';
+import { useSupabaseSubscription } from './useSupabaseSubscription';
+
+export const useWalletTransactionsSubscription = ({
+  walletId,
+  callback,
+  enabled = true,
+}: UseWalletTransactionsSubscriptionProps) =>
+  useSupabaseSubscription({
+    config: createWalletTransactionsConfig(walletId || ''),
+    callback,
+    enabled: enabled && !!walletId,
+  });

package/src/hooks/useSupabaseSubscription/types.ts

@@ -0,0 +1,19 @@
+export interface SubscriptionConfig {
+  channelName: string;
+  table: string;
+  schema?: string;
+  event?: 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+  filter?: string;
+}
+
+export interface UseSupabaseSubscriptionProps {
+  config: SubscriptionConfig;
+  callback: (payload?: unknown) => void;
+  enabled?: boolean;
+}
+
+export interface UseWalletTransactionsSubscriptionProps {
+  walletId: string | undefined;
+  callback: () => void;
+  enabled?: boolean;
+}

package/src/hooks/useSupabaseSubscription/useSupabaseSubscription.ts

@@ -0,0 +1,55 @@
+import { useEffect, useRef } from 'react';
+
+import { UseSupabaseSubscriptionProps } from './types';
+
+import { supabaseClient } from '../../utils/supabase';
+
+export const useSupabaseSubscription = ({ config, callback, enabled = true }: UseSupabaseSubscriptionProps) => {
+  const subscriptionRef = useRef<any>(null);
+  const callbackRef = useRef(callback);
+
+  callbackRef.current = callback;
+
+  useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+
+    if (!supabaseClient) {
+      throw new Error('Supabase client is not available');
+    }
+
+    if (subscriptionRef.current) {
+      supabaseClient.removeChannel(subscriptionRef.current);
+      subscriptionRef.current = null;
+    }
+
+    const subscription = supabaseClient
+      .channel(config.channelName)
+      .on(
+        'postgres_changes' as any,
+        {
+          event: config.event || '*',
+          schema: config.schema || 'public',
+          table: config.table,
+          ...(config.filter && { filter: config.filter }),
+        },
+        (payload) => callbackRef.current(payload)
+      )
+      .subscribe();
+
+    subscriptionRef.current = subscription;
+
+    return () => {
+      if (subscriptionRef.current && supabaseClient) {
+        supabaseClient.removeChannel(subscriptionRef.current);
+        subscriptionRef.current = null;
+      }
+    };
+  }, [enabled, config.channelName, config.table, config.schema, config.event, config.filter]);
+
+  return {
+    isConnected: !!subscriptionRef.current,
+    isClientAvailable: !!supabaseClient,
+  };
+};

package/src/utils/encrypt.ts

@@ -20,11 +20,61 @@ export const decryptAESData = async (encryptedData: string, iv: string, secretKe
   return JSON.parse(decrypted);
 };
 
+/**
+ * Очищает и валидирует публичный RSA ключ
+ * Исправляет ошибку InvalidAsn1Error: encoding too long
+ * путем удаления лишних символов и нормализации переносов строк
+ */
+const cleanAndValidatePublicKey = (publicKey: string): string => {
+  try {
+    // Декодируем base64 ключ
+    const publicKeyBase64 = Buffer.from(publicKey, 'base64').toString('utf8');
+
+    // Удаляем лишние символы (переносы строк, пробелы в начале и конце)
+    // Нормализуем переносы строк для корректной обработки ASN.1
+    const cleanedKey = publicKeyBase64.trim().replace(/\r?\n|\r/g, '\n');
+
+    // Проверяем, что ключ содержит необходимые маркеры
+    if (!cleanedKey.includes('BEGIN') || !cleanedKey.includes('END')) {
+      throw new Error('Invalid public key format: missing BEGIN/END markers');
+    }
+
+    return cleanedKey;
+  } catch (error) {
+    throw new Error(`Invalid public key format: ${error instanceof Error ? error.message : 'Unknown error'}`);
+  }
+};
+
+/**
+ * Автоматически определяет формат RSA ключа по заголовку
+ * Помогает избежать ошибок импорта при неправильном указании формата
+ */
+const detectKeyFormat = (key: string): 'pkcs1' | 'pkcs8' => {
+  if (key.includes('BEGIN RSA PUBLIC KEY')) {
+    return 'pkcs1';
+  } else if (key.includes('BEGIN PUBLIC KEY')) {
+    return 'pkcs8';
+  }
+  // По умолчанию возвращаем pkcs8, как было ранее
+  return 'pkcs8';
+};
+
 export const makeSecureRequest = async <T>({ callback, publicKey }: MakeSecureRequestParams): Promise<T> => {
   const clientRsa = new NodeRSA();
 
-  const publicKeyBase64 = Buffer.from(publicKey, 'base64').toString('utf8');
-  clientRsa.importKey(publicKeyBase64, 'pkcs8-public-pem');
+  try {
+    // Очищаем и валидируем публичный ключ
+    const cleanedPublicKey = cleanAndValidatePublicKey(publicKey);
+
+    // Определяем формат ключа автоматически
+    const keyFormat = detectKeyFormat(cleanedPublicKey);
+
+    // Импортируем ключ с правильным форматом
+    clientRsa.importKey(cleanedPublicKey, `${keyFormat}-public-pem`);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+    throw new Error(`Failed to import RSA public key: ${errorMessage}`);
+  }
 
   const clientSecretKey = generateSecretKey();
   const clientPayload = {

package/src/utils/supabase.ts

@@ -0,0 +1,15 @@
+import { createClient } from '@supabase/supabase-js';
+
+const createSupabaseClient = () => {
+  const supabaseUrl = process.env.SUPABASE_URL;
+  const supabasePublicKey = process.env.SUPABASE_PUBLIC_KEY;
+
+  if (!supabaseUrl || !supabasePublicKey) {
+    console.warn('Supabase environment variables are missing. Client will not be created.');
+    return null;
+  }
+
+  return createClient(supabaseUrl, supabasePublicKey);
+};
+
+export const supabaseClient = createSupabaseClient();