@supanovaapp/sdk 0.2.34 → 0.2.36

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

@@ -34,9 +34,7 @@ export interface CantonSubmitRegisterRequestDto {
     /** Base64 signature for provided hash */
     signature: string;
     /** Optional deduplication period */
-    deduplicationPeriod?: {
-        value: string;
-    };
+    deduplicationPeriod?: any;
 }
 export interface CantonSubmitTransactionResponseDto {
     /** Submission ID for tracking completion */
@@ -241,7 +239,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;
@@ -250,7 +293,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/useSendMultipleTransactions.d.ts

@@ -19,9 +19,7 @@ export interface SendMultipleTransactionsOptions {
     /** Show technical transaction details (commands, disclosedContracts, hash) as JSON. Default: false */
     showTechnicalDetails?: boolean;
     /** Optional deduplication period (shared across all transactions in the batch) */
-    deduplicationPeriod?: {
-        value: string;
-    };
+    deduplicationPeriod?: any;
     submitOptions?: CantonSubmitPreparedOptions;
 }
 export interface UseSendMultipleTransactionsReturn {