@supanovaapp/sdk 0.2.37 → 0.2.39

package/README.md

@@ -418,6 +418,27 @@ const filteredContracts = await getActiveContracts([
   'template-id-1',
   'template-id-2'
 ]);
+
+// With pagination (limit required, offset optional)
+const page = await getActiveContracts(undefined, { limit: 10 });
+const nextPage = await getActiveContracts(undefined, { limit: 10, offset: 10 });
+
+// Combined: filter + pagination
+const filtered = await getActiveContracts(['template-id-1'], { limit: 5, offset: 0 });
+```
+
+**Parameters:**
+- `templateIds` (optional) - Array of template IDs to filter by
+- `pagination` (optional) - `{ limit: number; offset?: number }`. `offset` requires `limit`.
+
+**Note:** The API may return contracts in two formats (legacy wrapped or flat). Use `normalizeContractItem()` to get a consistent shape:
+
+```tsx
+import { normalizeContractItem } from '@supanovaapp/sdk';
+
+const contracts = await getActiveContracts();
+const normalized = contracts.map(normalizeContractItem);
+// normalized[0].contractId, .templateId, .createArgument, .createdAt
 ```
 
 #### Get Canton Balances
@@ -513,13 +534,14 @@ const { calculateTransferFee } = useCanton();
 
 const feeCc = await calculateTransferFee(
   'USDC', // instrumentId (optional, defaults to Amulet)
-  'token-admin::1220abc123...' // optional instrumentAdmin
+  'token-admin::1220abc123...', // optional instrumentAdmin
+  'receiver-party::1220abc123...' // optional partyId (recommended: recipient)
 );
 
 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.
+**Note**: The amount cannot have more than 10 decimal places. Transfers are only supported to wallets with preapproved transfers enabled. If `partyId` is omitted, SDK falls back to the current user party ID.
 
 #### Submit a Transaction
 

package/dist/core/client.d.ts

@@ -4,6 +4,8 @@ export interface ClientConfig {
     nodeIdentifier: string;
     /** Optional app identifier for app-specific backend rules */
     supaAppId?: string;
+    /** Optional SDK version (sent as X-Supa-SDK header) */
+    sdkVersion?: string;
     getAccessToken?: () => Promise<string | null>;
 }
 export declare class ApiClient {
@@ -11,6 +13,7 @@ export declare class ApiClient {
     private getAccessToken?;
     private nodeIdentifier;
     private supaAppId?;
+    private sdkVersion?;
     constructor(config?: ClientConfig);
     get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
     post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;

package/dist/core/types.d.ts

@@ -143,15 +143,47 @@ export interface CantonJsActiveContract {
 export interface CantonContractEntry {
     JsActiveContract: CantonJsActiveContract;
 }
-/** Active contract response item from API */
-export interface CantonActiveContractItem {
+/** Active contract item — legacy wrapped format (Canton Ledger API) */
+export interface CantonActiveContractItemLegacy {
     /** Workflow ID (can be empty) */
     workflowId: string;
     /** Contract entry containing the active contract */
     contractEntry: CantonContractEntry;
 }
+/** Active contract item — new flat format */
+export interface CantonActiveContractItemFlat {
+    /** Contract ID */
+    contractId: string;
+    /** Template ID in format packageId:module:entity */
+    templateId: string;
+    /** Create argument data — varies per template */
+    createArgument: CantonAmuletCreateArgument | Record<string, unknown>;
+    /** Created event blob (base64) */
+    createdEventBlob: string;
+}
+/** Active contract response item — supports both legacy and flat formats */
+export type CantonActiveContractItem = CantonActiveContractItemLegacy | CantonActiveContractItemFlat;
+/** Normalized contract data extracted from either format */
+export interface CantonNormalizedContract {
+    contractId: string;
+    templateId: string;
+    createArgument: CantonAmuletCreateArgument | Record<string, unknown>;
+    createdEventBlob: string;
+    /** Only available in legacy format */
+    createdAt: string | null;
+}
 /** Response from /canton/api/active_contracts */
 export type CantonActiveContractsResponseDto = CantonActiveContractItem[];
+/** Parameters for getActiveContracts (offset requires limit) */
+export type GetActiveContractsParams = {
+    templateIds?: string[];
+    limit?: number;
+    offset?: never;
+} | {
+    templateIds?: string[];
+    limit: number;
+    offset?: number;
+};
 export interface CantonActiveContract {
     /** Contract ID */
     contractId: string;
@@ -272,8 +304,8 @@ export interface CantonPrepareTransferResponseDto extends CantonPrepareTransacti
 }
 /** Request params for transfer fee calculation */
 export interface CantonCalculateTransferFeeRequestDto {
-    /** Sender party ID */
-    partyId: string;
+    /** Party ID used for fee calculation (receiver recommended for transfer flows) */
+    partyId?: string;
     /** Instrument ID of the transferred token */
     instrumentId: string;
     /** Optional instrument admin party ID */