@supanovaapp/sdk 0.2.15 → 0.2.17

package/dist/providers/CantonProvider.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { StellarWallet } from '../utils/stellar';
+import { CantonWallet } from '../utils/wallet';
 import { CantonService, CantonSubmitPreparedOptions } from '../services/cantonService';
 import { CantonMeResponseDto, CantonActiveContractsResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonIncomingTransferDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto } from '../core/types';
 export interface CantonSendCoinOptions extends CantonSubmitPreparedOptions {
@@ -8,11 +8,11 @@ export interface CantonSendCoinOptions extends CantonSubmitPreparedOptions {
 }
 export interface CantonContextValue {
     /** First Stellar wallet (primary) */
-    stellarWallet: StellarWallet | null;
+    cantonWallet: CantonWallet | null;
     /** All Stellar wallets */
-    stellarWallets: StellarWallet[];
+    cantonWallets: CantonWallet[];
     /** Create new Stellar wallet */
-    createStellarWallet: () => Promise<StellarWallet | null>;
+    createCantonWallet: () => Promise<CantonWallet | null>;
     /** Register Canton wallet on backend */
     registerCanton: (inviteCode?: string) => Promise<void>;
     /** Whether Canton wallet is registered */
@@ -47,6 +47,8 @@ export interface CantonContextValue {
     getTransactions: (params?: CantonTransactionsParams) => Promise<CantonTransactionDto[]>;
     /** Get Canton price history (candles from Bybit) */
     getPriceHistory: (interval: CantonPriceInterval) => Promise<CantonPriceCandleDto[]>;
+    /** Reset all Canton state (for logout) */
+    resetState: () => void;
     /** Loading state */
     loading: boolean;
     /** Error state */
@@ -57,8 +59,15 @@ export interface CantonContextValue {
 export interface CantonProviderProps {
     cantonService: CantonService;
     children: ReactNode;
+    /** Enable wallet export (uses Solana instead of Stellar). Default: false */
+    withExport?: boolean;
     /** Enable automatic onboarding (create wallet + register Canton on login). Default: true */
     autoOnboarding?: boolean;
+    /**
+     * Legacy onboarding stage: automatically setup transfer preapproval after registration.
+     * Default: false (new onboarding uses prepare_initialization_transactions).
+     */
+    autoTransferPreapproval?: boolean;
 }
-export declare function CantonProvider({ cantonService, children, autoOnboarding }: CantonProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function CantonProvider({ cantonService, children, withExport, autoOnboarding, autoTransferPreapproval, }: CantonProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useCantonContext(): CantonContextValue;

package/dist/providers/SupaProvider.d.ts

@@ -7,6 +7,8 @@ export interface SupaConfig {
     privyClientId?: string;
     apiBaseUrl?: string;
     nodeIdentifier: string;
+    /** Optional app identifier for special app-specific rules (sent as X-Supa-App-Id header) */
+    supaAppId?: string;
     appearance?: {
         theme?: 'light' | 'dark';
         accentColor?: string;
@@ -32,8 +34,23 @@ export interface SupaConfig {
     defaultChain?: any;
     /** Supported chains for the app */
     supportedChains?: any[];
+    /**
+     * Enable wallet export functionality (uses Solana wallets instead of Stellar)
+     * When false (default): Uses Stellar wallets, export will throw an error
+     * When true: Uses Solana wallets, export is available
+     * @default false
+     */
+    withExport?: boolean;
     /** Enable automatic onboarding (create wallet + register Canton on login). Default: true */
     autoOnboarding?: boolean;
+    /**
+     * Optional onboarding stages flags.
+     * By default transfer preapproval is NOT auto-executed.
+     */
+    onboardingStages?: {
+        /** Auto-run transfer preapproval stage (legacy). Default: false */
+        transferPreapproval?: boolean;
+    };
 }
 export interface ConfirmModalOptions {
     title?: string;

package/dist/services/apiService.d.ts

@@ -14,22 +14,13 @@ export declare class ApiService {
     private readonly USER_CACHE_TTL;
     constructor(client: ApiClient);
     /**
-     * Инвалидация кеша /user/me
-     * Вызывается после операций, изменяющих данные пользователя
-     */
-    private invalidateUserCache;
-    /**
-     * Инвалидация кеша /supa_points/balance
+     * Invalidate /supa_points/balance cache
      */
     private invalidateSupaPointsCache;
-    /**
-     * Инвалидация кеша /privy/balance
-     */
-    private invalidatePrivyBalanceCache;
     /**
      * Get current user information
      * GET /user/me
-     * С мемоизацией на 5 минут и дедупликацией одновременных запросов
+     * With 5 minute caching and request deduplication
      */
     getCurrentUser(force?: boolean): Promise<UserResponseDto>;
     /**
@@ -134,7 +125,7 @@ export declare class ApiService {
     /**
      * Get SupaPoints balance
      * GET /supa_points/balance
-     * С мемоизацией на 5 минут и дедупликацией одновременных запросов
+     * With 5 minute caching and request deduplication
      */
     getSupaPointsBalance(force?: boolean): Promise<SupaPointsBalanceResponseDto>;
     /**
@@ -155,7 +146,7 @@ export declare class ApiService {
     /**
      * Get Privy balance
      * GET /privy/balance
-     * С мемоизацией на 5 минут и дедупликацией одновременных запросов
+     * With 5 minute caching and request deduplication
      */
     getPrivyBalance(force?: boolean): Promise<any>;
 }

package/dist/services/cantonService.d.ts

@@ -1,6 +1,6 @@
 import { ApiClient } from '../core/client';
-import { CantonPrepareTransactionResponseDto, CantonSubmitTransactionResponseDto, CantonMeResponseDto, CantonActiveContractsResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareAmuletTransferRequestDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto } from '../core/types';
-export type { CantonMeResponseDto, CantonActiveContractsResponseDto, CantonPrepareTransactionResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareAmuletTransferRequestDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, };
+import { CantonPrepareTransactionResponseDto, CantonSubmitRegisterRequestDto, CantonSubmitTransactionResponseDto, CantonMeResponseDto, CantonActiveContractsResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareAmuletTransferRequestDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, CantonSubmitMultipleResultDto } from '../core/types';
+export type { CantonMeResponseDto, CantonActiveContractsResponseDto, CantonPrepareTransactionResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareAmuletTransferRequestDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, CantonSubmitMultipleResultDto, };
 export interface CantonRegisterParams {
     /** Base64 public key from Stellar wallet */
     publicKey: string;
@@ -31,8 +31,8 @@ export declare class CantonService {
     private readonly CACHE_TTL;
     constructor(client: ApiClient);
     /**
-     * Инвалидация кеша /me
-     * Вызывается после операций регистрации/изменения пользователя
+     * Invalidate /me cache
+     * Called after registration/user modification operations
      */
     private invalidateMeCache;
     /**
@@ -63,6 +63,11 @@ export declare class CantonService {
      * @param signature Base64 signature
      */
     submitPrepared(hash: string, signature: string): Promise<CantonSubmitTransactionResponseDto>;
+    /**
+     * Submit multiple signed Canton transactions in a single request
+     * @param txs Array of { hash, signature } (base64)
+     */
+    submitMultiplePrepared(txs: CantonSubmitRegisterRequestDto[]): Promise<CantonSubmitMultipleResultDto[]>;
     /**
      * Query completion status for a submission
      * @param submissionId Submission ID from submitPrepared
@@ -81,7 +86,7 @@ export declare class CantonService {
     /**
      * Get current Canton user info (partyId and email)
      * Only works after registration
-     * С мемоизацией на 5 минут и дедупликацией одновременных запросов
+     * With 5 minute caching and request deduplication
      */
     getMe(force?: boolean): Promise<CantonMeResponseDto>;
     /**
@@ -114,6 +119,11 @@ export declare class CantonService {
      * No request body required
      */
     prepareTransferPreapproval(): Promise<CantonPrepareTransactionResponseDto>;
+    /**
+     * Prepare initialization transactions for onboarding
+     * Backend may return 0..4 transactions depending on app rules.
+     */
+    prepareInitializationTransactions(): Promise<CantonPrepareTransactionResponseDto[]>;
     /**
      * Get Canton wallet balances
      * Returns balances for all tokens grouped by instrument ID

package/dist/utils/converters.d.ts

@@ -65,3 +65,16 @@ export declare const stripLeadingZero: (hex: string) => string;
  * ```
  */
 export declare const privyPublicKeyToCantonBase64: (publicKeyHex: string) => string;
+/**
+ * Decodes a base58 string to bytes using BigInt for precision
+ * @param str - Base58 encoded string
+ * @returns Byte array
+ */
+export declare const base58ToBytes: (str: string) => Uint8Array;
+/**
+ * Converts a Solana address (base58) to base64 for Canton Network
+ * @param address - Solana address in base58 format
+ * @returns Public key in base64 format (32 bytes Ed25519 key)
+ * @throws {Error} If decoded key is not 32 bytes
+ */
+export declare const solanaAddressToBase64: (address: string) => string;

package/dist/utils/wallet.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Stellar wallet utilities for Privy integration
+ * Stellar chain type is used for Ed25519 signing required by Canton Network
+ */
+/**
+ * Stellar/Solana wallet interface representing a Privy Ed25519 wallet
+ */
+export interface CantonWallet {
+    /** Wallet address (public key in Stellar/Solana format) */
+    address: string;
+    /** Raw public key in hex format (camelCase) - only for Stellar */
+    publicKey?: string;
+    /** Raw public key in hex format (snake_case from Privy API) - only for Stellar */
+    public_key?: string;
+    /** Chain type: 'stellar' (default) or 'solana' (with export) */
+    chainType: 'stellar' | 'solana';
+    /** Wallet client type (e.g., 'privy') */
+    walletClientType?: string;
+    /** Whether the wallet was imported or created */
+    imported?: boolean;
+}
+/**
+ * Extracts all Ed25519 wallets (Stellar or Solana) from Privy user and wallets array
+ * Combines wallets from both user.linkedAccounts and useWallets hook,
+ * removing duplicates by address.
+ *
+ * @param user - Privy user object
+ * @param wallets - Privy wallets array from useWallets hook
+ * @param chainType - Chain type to filter by: 'stellar' (default) or 'solana' (with export)
+ * @returns Array of unique wallets
+ *
+ * @example
+ * ```ts
+ * const { user } = usePrivy();
+ * const { wallets } = useWallets();
+ * const cantonWallets = getCantonWallets(user, wallets, 'stellar');
+ * console.log(`Found ${cantonWallets.length} wallets`);
+ * ```
+ */
+export declare const getCantonWallets: (user: any, wallets: any[], chainType?: "stellar" | "solana") => CantonWallet[];
+/**
+ * Converts Stellar wallet public key to Canton Network base64 format
+ * Handles removal of leading 00 byte and conversion from hex to base64
+ *
+ * @param wallet - Stellar wallet object containing publicKey
+ * @returns Public key in base64 format ready for Canton Network API
+ * @throws {Error} If wallet is invalid or publicKey is missing/malformed
+ *
+ * @example
+ * ```ts
+ * const publicKeyBase64 = getPublicKeyBase64(stellarWallet);
+ * // Use with Canton Network API
+ * await fetch('/canton/register/prepare', {
+ *   body: JSON.stringify({ publicKey: publicKeyBase64 })
+ * });
+ * ```
+ */
+export declare const getPublicKeyBase64: (wallet: CantonWallet | any) => string;
+/**
+ * Type guard to check if a wallet is a Stellar/Solana Ed25519 wallet
+ * @param wallet - Wallet object to check
+ * @returns True if wallet is a valid Ed25519 wallet (Stellar or Solana)
+ *
+ * @example
+ * ```ts
+ * if (isCantonWallet(wallet)) {
+ *   console.log('Ed25519 wallet address:', wallet.address);
+ * }
+ * ```
+ */
+export declare const isCantonWallet: (wallet: any) => wallet is CantonWallet;
+/**
+ * Gets the first Ed25519 wallet from user and wallets array
+ * Convenience function that throws if no wallet is found
+ *
+ * @param user - Privy user object
+ * @param wallets - Privy wallets array from useWallets hook
+ * @param chainType - Chain type to filter by: 'stellar' (default) or 'solana' (with export)
+ * @returns First wallet found
+ * @throws {Error} If no wallet found
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const wallet = getFirstCantonWallet(user, wallets, 'stellar');
+ *   console.log('Using wallet:', wallet.address);
+ * } catch (err) {
+ *   console.error('No wallet available');
+ * }
+ * ```
+ */
+export declare const getFirstCantonWallet: (user: any, wallets: any[], chainType?: "stellar" | "solana") => CantonWallet;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supanovaapp/sdk",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "React SDK for Supa Backend + Privy.io integration with Canton Network and EVM Smart Wallets support",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",

package/dist/hooks/useStellarWallet.d.ts

@@ -1,6 +0,0 @@
-import { StellarWallet } from '../utils/stellar';
-export interface UseStellarWalletReturn {
-    stellarWallets: StellarWallet[];
-    stellarWallet: StellarWallet | null;
-}
-export declare function useStellarWallet(): UseStellarWalletReturn;

package/dist/utils/stellar.d.ts

@@ -1,90 +0,0 @@
-/**
- * Stellar wallet utilities for Privy integration
- * Stellar chain type is used for Ed25519 signing required by Canton Network
- */
-/**
- * Stellar wallet interface representing a Privy Stellar wallet
- */
-export interface StellarWallet {
-    /** Stellar address (public key in Stellar format) */
-    address: string;
-    /** Raw public key in hex format (camelCase) */
-    publicKey?: string;
-    /** Raw public key in hex format (snake_case from Privy API) */
-    public_key?: string;
-    /** Chain type, always 'stellar' for Stellar wallets */
-    chainType: 'stellar';
-    /** Wallet client type (e.g., 'privy') */
-    walletClientType?: string;
-    /** Whether the wallet was imported or created */
-    imported?: boolean;
-}
-/**
- * Extracts all Stellar wallets from Privy user and wallets array
- * Combines wallets from both user.linkedAccounts and useWallets hook,
- * removing duplicates by address.
- *
- * @param user - Privy user object
- * @param wallets - Privy wallets array from useWallets hook
- * @returns Array of unique Stellar wallets
- *
- * @example
- * ```ts
- * const { user } = usePrivy();
- * const { wallets } = useWallets();
- * const stellarWallets = getStellarWallets(user, wallets);
- * console.log(`Found ${stellarWallets.length} Stellar wallets`);
- * ```
- */
-export declare const getStellarWallets: (user: any, wallets: any[]) => StellarWallet[];
-/**
- * Converts Stellar wallet public key to Canton Network base64 format
- * Handles removal of leading 00 byte and conversion from hex to base64
- *
- * @param wallet - Stellar wallet object containing publicKey
- * @returns Public key in base64 format ready for Canton Network API
- * @throws {Error} If wallet is invalid or publicKey is missing/malformed
- *
- * @example
- * ```ts
- * const publicKeyBase64 = getPublicKeyBase64(stellarWallet);
- * // Use with Canton Network API
- * await fetch('/canton/register/prepare', {
- *   body: JSON.stringify({ publicKey: publicKeyBase64 })
- * });
- * ```
- */
-export declare const getPublicKeyBase64: (wallet: StellarWallet | any) => string;
-/**
- * Type guard to check if a wallet is a Stellar wallet
- * @param wallet - Wallet object to check
- * @returns True if wallet is a valid Stellar wallet
- *
- * @example
- * ```ts
- * if (isStellarWallet(wallet)) {
- *   console.log('Stellar wallet address:', wallet.address);
- * }
- * ```
- */
-export declare const isStellarWallet: (wallet: any) => wallet is StellarWallet;
-/**
- * Gets the first Stellar wallet from user and wallets array
- * Convenience function that throws if no Stellar wallet is found
- *
- * @param user - Privy user object
- * @param wallets - Privy wallets array from useWallets hook
- * @returns First Stellar wallet found
- * @throws {Error} If no Stellar wallet found
- *
- * @example
- * ```ts
- * try {
- *   const wallet = getFirstStellarWallet(user, wallets);
- *   console.log('Using wallet:', wallet.address);
- * } catch (err) {
- *   console.error('No Stellar wallet available');
- * }
- * ```
- */
-export declare const getFirstStellarWallet: (user: any, wallets: any[]) => StellarWallet;