@supanovaapp/sdk 0.2.35 → 0.2.37

package/dist/providers/CantonProvider.d.ts

@@ -1,73 +1,4 @@
-import { ReactNode } from 'react';
-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 {
-    /** Skip confirmation modal. Default: false */
-    skipModal?: boolean;
-}
-export interface CantonContextValue {
-    /** First Stellar wallet (primary) */
-    cantonWallet: CantonWallet | null;
-    /** All Stellar wallets */
-    cantonWallets: CantonWallet[];
-    /** Create new Stellar wallet */
-    createCantonWallet: () => Promise<CantonWallet | null>;
-    /** Register Canton wallet on backend */
-    registerCanton: (inviteCode?: string) => Promise<void>;
-    /** Whether Canton wallet is registered */
-    isRegistered: boolean;
-    /** Canton user info (partyId, email, transferPreapprovalSet) */
-    cantonUser: CantonMeResponseDto | null;
-    /** Get Canton user info */
-    getMe: () => Promise<CantonMeResponseDto>;
-    /** Get active contracts with optional filtering */
-    getActiveContracts: (templateIds?: string[]) => Promise<CantonActiveContractsResponseDto>;
-    /** Canton wallet balances */
-    cantonBalances: CantonWalletBalancesResponseDto | null;
-    /** Get Canton wallet balances */
-    getBalances: () => Promise<CantonWalletBalancesResponseDto>;
-    /** Tap devnet faucet */
-    tapDevnet: (amount: string, options?: CantonSubmitPreparedOptions) => Promise<CantonQueryCompletionResponseDto>;
-    /** Sign hash with Stellar wallet */
-    signHash: (hashBase64: string) => Promise<string>;
-    /** Sign text message */
-    signMessage: (message: string) => Promise<string>;
-    /** Prepare and submit transaction with polling for completion */
-    sendTransaction: (commands: unknown, disclosedContracts?: unknown, options?: CantonSubmitPreparedOptions) => Promise<CantonQueryCompletionResponseDto>;
-    /** Send Canton Coin (Amulet) to another party */
-    sendCantonCoin: (receiverPartyId: string, amount: string, memo?: string, options?: CantonSendCoinOptions) => Promise<CantonQueryCompletionResponseDto>;
-    /** Setup transfer preapproval (internal, called automatically) */
-    setupTransferPreapproval: () => Promise<void>;
-    /** Get pending incoming transfers */
-    getPendingIncomingTransfers: () => Promise<CantonIncomingTransferDto[]>;
-    /** Respond to incoming transfer (accept or reject) */
-    respondToIncomingTransfer: (contractId: string, accept: boolean, options?: CantonSubmitPreparedOptions) => Promise<CantonQueryCompletionResponseDto>;
-    /** Get Canton transactions history with pagination */
-    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 */
-    error: Error | null;
-    /** Clear error */
-    clearError: () => void;
-}
-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;
-}
+import { CantonContextValue, CantonProviderProps } from './canton/types';
+export type { CantonContextValue, CantonProviderProps, CantonSendCoinOptions, } from './canton/types';
 export declare function CantonProvider({ cantonService, children, withExport, autoOnboarding, autoTransferPreapproval, }: CantonProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useCantonContext(): CantonContextValue;

package/dist/providers/canton/signingWalletResolver.d.ts

@@ -0,0 +1,16 @@
+import { CantonWallet } from '../../utils/wallet';
+export type CantonChainType = 'stellar' | 'solana';
+export interface SigningWalletInfo {
+    wallet: CantonWallet;
+    chainType: CantonChainType;
+}
+export interface ResolveSigningWalletParams {
+    primaryWallet: CantonWallet | null;
+    stellarWallets: CantonWallet[];
+    solanaWallets: CantonWallet[];
+    cantonPublicKey?: string | null;
+    defaultChainType: CantonChainType;
+}
+export declare const normalizeBase64Key: (value?: string | null) => string | null;
+export declare const collectWalletsByChainType: (user: any, wallets: any[], targetChainType: CantonChainType) => CantonWallet[];
+export declare const resolveSigningWalletFromCandidates: ({ primaryWallet, stellarWallets, solanaWallets, cantonPublicKey, defaultChainType, }: ResolveSigningWalletParams) => SigningWalletInfo;

package/dist/providers/canton/types.d.ts

@@ -0,0 +1,83 @@
+import { ReactNode } from 'react';
+import { CantonService, CantonSubmitPreparedOptions } from '../../services/cantonService';
+import { CantonMeResponseDto, CantonActiveContractsResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonIncomingTransferDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, CantonPrepareTransferRequestDto, CantonCalculateTransferFeeResponseDto } from '../../core/types';
+import { CantonWallet } from '../../utils/wallet';
+export interface CantonSendCoinOptions extends CantonSubmitPreparedOptions {
+    /** Skip confirmation modal. Default: false */
+    skipModal?: boolean;
+    /**
+     * Instrument ID to transfer.
+     * Defaults to "Amulet" (CC).
+     */
+    instrumentId?: CantonPrepareTransferRequestDto['instrumentId'];
+    /**
+     * Optional instrument admin party ID.
+     * Useful for CIP-56 tokens.
+     */
+    instrumentAdmin?: CantonPrepareTransferRequestDto['instrumentAdmin'];
+}
+export interface CantonContextValue {
+    /** First Stellar wallet (primary) */
+    cantonWallet: CantonWallet | null;
+    /** All Stellar wallets */
+    cantonWallets: CantonWallet[];
+    /** Create new Stellar wallet */
+    createCantonWallet: () => Promise<CantonWallet | null>;
+    /** Register Canton wallet on backend */
+    registerCanton: (inviteCode?: string) => Promise<void>;
+    /** Whether Canton wallet is registered */
+    isRegistered: boolean;
+    /** Canton user info (partyId, email, transferPreapprovalSet) */
+    cantonUser: CantonMeResponseDto | null;
+    /** Get Canton user info */
+    getMe: () => Promise<CantonMeResponseDto>;
+    /** Get active contracts with optional filtering */
+    getActiveContracts: (templateIds?: string[]) => Promise<CantonActiveContractsResponseDto>;
+    /** Canton wallet balances */
+    cantonBalances: CantonWalletBalancesResponseDto | null;
+    /** Get Canton wallet balances */
+    getBalances: () => Promise<CantonWalletBalancesResponseDto>;
+    /** Tap devnet faucet */
+    tapDevnet: (amount: string, options?: CantonSubmitPreparedOptions) => Promise<CantonQueryCompletionResponseDto>;
+    /** Sign hash with Stellar wallet */
+    signHash: (hashBase64: string) => Promise<string>;
+    /** Sign text message */
+    signMessage: (message: string) => Promise<string>;
+    /** Prepare and submit transaction with polling for completion */
+    sendTransaction: (commands: unknown, disclosedContracts?: unknown, options?: CantonSubmitPreparedOptions) => Promise<CantonQueryCompletionResponseDto>;
+    /** Send transfer to another party (defaults to Canton Coin / Amulet) */
+    sendCantonCoin: (receiverPartyId: string, amount: string, memo?: string, options?: CantonSendCoinOptions) => Promise<CantonQueryCompletionResponseDto>;
+    /** Calculate transfer fee in CC for current user party */
+    calculateTransferFee: (instrumentId?: string, instrumentAdmin?: string) => Promise<CantonCalculateTransferFeeResponseDto>;
+    /** Setup transfer preapproval (internal, called automatically) */
+    setupTransferPreapproval: () => Promise<void>;
+    /** Get pending incoming transfers */
+    getPendingIncomingTransfers: () => Promise<CantonIncomingTransferDto[]>;
+    /** Respond to incoming transfer (accept or reject) */
+    respondToIncomingTransfer: (contractId: string, accept: boolean, options?: CantonSubmitPreparedOptions) => Promise<CantonQueryCompletionResponseDto>;
+    /** Get Canton transactions history with pagination */
+    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 */
+    error: Error | null;
+    /** Clear error */
+    clearError: () => void;
+}
+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;
+}

package/dist/services/cantonService.d.ts

@@ -1,6 +1,6 @@
 import { ApiClient } from '../core/client';
-import { CantonPrepareTransactionResponseDto, CantonSubmitRegisterRequestDto, CantonSubmitTransactionResponseDto, CantonMeResponseDto, CantonActiveContractsResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareAmuletTransferRequestDto, CantonPrepareAmuletTransferResponseDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, CantonSubmitMultipleResultDto } from '../core/types';
-export type { CantonMeResponseDto, CantonActiveContractsResponseDto, CantonPrepareTransactionResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareAmuletTransferRequestDto, CantonPrepareAmuletTransferResponseDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, CantonSubmitMultipleResultDto, };
+import { CantonPrepareTransactionResponseDto, CantonSubmitRegisterRequestDto, CantonSubmitTransactionResponseDto, CantonMeResponseDto, CantonActiveContractsResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareTransferRequestDto, CantonPrepareTransferResponseDto, CantonCalculateTransferFeeRequestDto, CantonCalculateTransferFeeResponseDto, CantonPrepareAmuletTransferRequestDto, CantonPrepareAmuletTransferResponseDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, CantonSubmitMultipleResultDto } from '../core/types';
+export type { CantonMeResponseDto, CantonActiveContractsResponseDto, CantonPrepareTransactionResponseDto, CantonQueryCompletionResponseDto, CantonWalletBalancesResponseDto, CantonPrepareTransferRequestDto, CantonPrepareTransferResponseDto, CantonCalculateTransferFeeRequestDto, CantonCalculateTransferFeeResponseDto, CantonPrepareAmuletTransferRequestDto, CantonPrepareAmuletTransferResponseDto, CantonIncomingTransferDto, CantonPrepareResponseIncomingTransferRequestDto, CantonCostEstimationDto, CantonTransactionDto, CantonTransactionsParams, CantonPriceInterval, CantonPriceCandleDto, CantonSubmitMultipleResultDto, };
 export interface CantonRegisterParams {
     /** Base64 public key from Stellar wallet */
     publicKey: string;
@@ -35,12 +35,17 @@ export declare class CantonService {
     private meCacheTimestamp;
     private mePendingPromise;
     private readonly CACHE_TTL;
+    private static readonly AMULET_INSTRUMENT_ID;
     constructor(client: ApiClient);
     /**
      * Invalidate /me cache
      * Called after registration/user modification operations
      */
     private invalidateMeCache;
+    /**
+     * Validate decimal places for transfer amount (max 10)
+     */
+    private validateTransferAmount;
     /**
      * Register Canton wallet
      * Flow:
@@ -137,11 +142,23 @@ export declare class CantonService {
      */
     getBalances(): Promise<CantonWalletBalancesResponseDto>;
     /**
-     * Prepare Amulet (Canton Coin) transfer
-     * @param params Transfer parameters (receiverPartyId, amount, memo)
+     * Prepare Canton transfer (Amulet or CIP-56 token)
+     * @param params Transfer parameters
      * @throws Error if amount has more than 10 decimal places
      */
+    prepareTransfer(params: CantonPrepareTransferRequestDto): Promise<CantonPrepareTransferResponseDto>;
+    /**
+     * Calculate transfer fee (always returned in CC)
+     */
+    calculateTransferFee(params: CantonCalculateTransferFeeRequestDto): Promise<CantonCalculateTransferFeeResponseDto>;
+    /**
+     * @deprecated Use `prepareTransfer` with `instrumentId: "Amulet"`.
+     */
     prepareAmuletTransfer(params: CantonPrepareAmuletTransferRequestDto): Promise<CantonPrepareAmuletTransferResponseDto>;
+    /**
+     * @deprecated Typo alias. Use `prepareAmuletTransfer`.
+     */
+    prepareAmuletTranafer(params: CantonPrepareAmuletTransferRequestDto): Promise<CantonPrepareAmuletTransferResponseDto>;
     /**
      * Get pending incoming transfers for the current user
      * Returns a list of transfer offers that can be accepted or rejected

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supanovaapp/sdk",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "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",