@supanovaapp/sdk 0.2.35 → 0.2.37

package/README.md

@@ -456,9 +456,9 @@ if (cantonBalances) {
 }
 ```
 
-#### Send Canton Coin
+#### Send Canton Coin / Token
 
-Send Canton Coin with cost estimation support:
+Send Canton Coin (default) or CIP-56 token with cost estimation support:
 
 ```tsx
 const { sendCantonCoin } = useCanton();
@@ -470,6 +470,8 @@ try {
     '100.5',                           // Amount (max 10 decimal places)
     'Payment for services',            // Optional memo
     {
+      instrumentId: 'Amulet', // optional, default 'Amulet'
+      // instrumentAdmin: 'token-admin::1220abc...', // optional for Amulet, required for many CIP-56 tokens
       timeout: 30000,      // completion timeout (ms)
       pollInterval: 1000,  // polling interval (ms)
       onCostEstimation: (cost) => {
@@ -504,6 +506,19 @@ interface CantonCostEstimationDto {
 }
 ```
 
+#### Calculate Transfer Fee (in CC)
+
+```tsx
+const { calculateTransferFee } = useCanton();
+
+const feeCc = await calculateTransferFee(
+  'USDC', // instrumentId (optional, defaults to Amulet)
+  'token-admin::1220abc123...' // optional instrumentAdmin
+);
+
+console.log('Transfer fee (CC):', feeCc);
+```
+
 **Note**: The amount cannot have more than 10 decimal places. Transfers are only supported to wallets with preapproved transfers enabled.
 
 #### Submit a Transaction
@@ -744,7 +759,7 @@ await sendTransaction(command, contracts, {
 |------|---------|-------------|
 | `useSupa` | Main SDK hook | `auth`, `canton`, `api`, `onboard`, `logout` (recommended for complete cleanup) |
 | `useAuth` | Authentication | `login`, `logout`, `authenticated`, `user` |
-| `useCanton` | Canton Network | `registerCanton`, `getBalances`, `sendCantonCoin`, `signMessage`, `sendTransaction`, `getActiveContracts`, `tapDevnet`, `getPendingIncomingTransfers`, `respondToIncomingTransfer`, `resetState` |
+| `useCanton` | Canton Network | `registerCanton`, `getBalances`, `sendCantonCoin`, `calculateTransferFee`, `signMessage`, `sendTransaction`, `getActiveContracts`, `tapDevnet`, `getPendingIncomingTransfers`, `respondToIncomingTransfer`, `resetState` |
 | `useSignMessage` | Enhanced message signing | `signMessage` with custom modals |
 | `useSendTransaction` | Enhanced transactions | `sendTransaction` with custom modals |
 | `useConfirmModal` | Generic modals | `confirm`, `signMessageConfirm`, `signTransactionConfirm` |
@@ -771,6 +786,10 @@ import type {
   CantonInstrumentIdDto,
   CantonLockedUtxoDto,
   CantonUnlockedUtxoDto,
+  CantonPrepareTransferRequestDto,
+  CantonPrepareTransferResponseDto,
+  CantonCalculateTransferFeeRequestDto,
+  CantonCalculateTransferFeeResponseDto,
   CantonPrepareAmuletTransferRequestDto,
   CantonCostEstimationDto,
   CantonIncomingTransferDto,

package/dist/core/types.d.ts

@@ -68,6 +68,8 @@ export interface CantonMeResponseDto {
     partyId: string;
     /** User email (can be null if not set) */
     email: string | null;
+    /** Public key used in Canton (base64, 32 bytes Ed25519) */
+    publicKey?: string | null;
     /** Indicates whether the transfer preapproval is set and NOT EXPIRED for the party */
     transferPreapprovalSet: boolean;
     /** Transfer preapproval expiration date (ISO 8601, can be null) */
@@ -239,7 +241,52 @@ export interface CantonWalletBalancesResponseDto {
     /** Timestamp when balances were fetched (ISO 8601) */
     fetchedAt: string;
 }
-/** Request for preparing Amulet (Canton Coin) transfer */
+/** Request for preparing a Canton transfer (Amulet or CIP-56 token) */
+export interface CantonPrepareTransferRequestDto {
+    /** Canton party ID of the receiver wallet */
+    receiverPartyId: string;
+    /** Amount to transfer (decimal string with max 10 decimal places) */
+    amount: string;
+    /** Instrument ID (e.g., "Amulet" for CC, "USDC" for CIP-56 tokens) */
+    instrumentId: string;
+    /**
+     * Instrument admin party ID.
+     * Optional for Amulet (resolved by backend), required for CIP-56 tokens.
+     */
+    instrumentAdmin?: string;
+    /** Optional memo for the transfer */
+    memo?: string;
+}
+/** Response for preparing a Canton transfer (Amulet or CIP-56 token) */
+export interface CantonPrepareTransferResponseDto extends CantonPrepareTransactionResponseDto {
+    /** Canton party ID of the receiver wallet */
+    receiverPartyId: string;
+    /** Amount to transfer (decimal string with max 10 decimal places) */
+    amount: string;
+    /** Instrument ID (e.g., "Amulet" for CC, "USDC" for CIP-56 tokens) */
+    instrumentId: string;
+    /** Optional instrument admin party ID */
+    instrumentAdmin?: string;
+    /** Optional memo for the transfer */
+    memo?: string;
+}
+/** Request params for transfer fee calculation */
+export interface CantonCalculateTransferFeeRequestDto {
+    /** Sender party ID */
+    partyId: string;
+    /** Instrument ID of the transferred token */
+    instrumentId: string;
+    /** Optional instrument admin party ID */
+    instrumentAdmin?: string;
+}
+/**
+ * Transfer fee in CC.
+ * Backend returns a numeric amount in Canton Coin units.
+ */
+export type CantonCalculateTransferFeeResponseDto = number;
+/**
+ * @deprecated Use `CantonPrepareTransferRequestDto` with `instrumentId: "Amulet"`.
+ */
 export interface CantonPrepareAmuletTransferRequestDto {
     /** Canton party ID of the receiver wallet */
     receiverPartyId: string;
@@ -248,7 +295,9 @@ export interface CantonPrepareAmuletTransferRequestDto {
     /** Optional memo for the transfer */
     memo?: string;
 }
-/** Response for preparing Amulet (Canton Coin) transfer */
+/**
+ * @deprecated Use `CantonPrepareTransferResponseDto` with `instrumentId: "Amulet"`.
+ */
 export interface CantonPrepareAmuletTransferResponseDto extends CantonPrepareTransactionResponseDto {
     /** Canton party ID of the receiver wallet */
     receiverPartyId: string;

package/dist/hooks/signing/signingHelpers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared helpers for hash-signing flows.
+ */
+export type SigningChainType = 'stellar' | 'solana';
+export declare const resolveRequestedChainType: (chainType: string, withExportFallback: boolean) => SigningChainType;
+export declare const hexToBytes: (hex: string) => Uint8Array;
+export declare const bytesToHex: (bytes: Uint8Array) => string;

package/dist/hooks/useSignRawHashWithModal.d.ts

@@ -2,7 +2,7 @@
  * Wrapper over Privy's signing with automatic confirmation modals
  *
  * Shows a confirmation modal before every signing operation
- * Supports both Stellar (rawSign) and Solana (signMessage) based on withExport config
+ * Supports both Stellar (rawSign) and Solana (signMessage) based on requested chainType
  */
 export interface SignRawHashModalOptions {
     skipModal?: boolean;