@gala-chain/launchpad-sdk 4.0.22-beta.0 → 4.0.22-beta.2

package/dist/src/services/GalaChainService.d.ts

@@ -52,7 +52,8 @@ import { BaseService } from './BaseService';
 import { FetchPoolDetailsData, InternalFetchPoolDetailsResponse } from '../types/trade.dto';
 import { TokenBalanceResult } from '../types/user.dto';
 import { TransferGalaData, TransferTokenData } from '../types/transfer.dto';
-import { LockTokenData, UnlockTokenData } from '../types/lock.dto';
+import { LockTokensData, LockTokensResult, UnlockTokensData, UnlockTokensResult } from '../types/lock.dto';
+import { BurnTokensData, BurnTokensResult } from '../types/burn.dto';
 import { TokenClassWithSupply } from '../types/launchpad.dto';
 /**
  * GalaChain Service for blockchain operations
@@ -317,65 +318,127 @@ export declare class GalaChainService extends BaseService {
      */
     resolveTokenClassKey(tokenName: string): Promise<TokenClassKey>;
     /**
-     * Lock tokens on GalaChain
+     * Lock tokens on GalaChain (batch operation)
      *
-     * Locks a specified amount of tokens, preventing them from being transferred
+     * Supports locking multiple token types in a single transaction.
+     * Places holds on tokens, making them non-transferable
      * until unlocked by the lock authority. Useful for staking, escrow, vesting,
      * or other hold scenarios.
      *
-     * @param data - Lock parameters including token identification and amount
-     * @returns Promise<string> Transaction ID or success identifier
+     * @param data - Lock parameters containing array of tokens to lock
+     * @returns LockTokensResult with transaction ID and locked token details
      *
      * @example
      * ```typescript
-     * // Lock tokens with default settings (caller is lock authority)
-     * const txId = await galaChainService.lockToken({
-     *   tokenName: 'unicorn',
-     *   amount: '100'
+     * // Lock a single token
+     * const result = await galaChainService.lockTokens({
+     *   tokens: [{ tokenName: 'anime', amount: '100' }]
      * });
      *
-     * // Lock tokens with expiration and custom lock authority
-     * const txId = await galaChainService.lockToken({
-     *   tokenId: 'Token$Unit$UNI$eth:0x...',
-     *   amount: '100',
-     *   lockAuthority: 'eth|0x1234...', // Another wallet can unlock
-     *   expires: Date.now() + 86400000, // Expires in 24 hours
-     *   name: 'staking-lock-v1'
+     * // Lock multiple tokens with different settings
+     * const result = await galaChainService.lockTokens({
+     *   tokens: [
+     *     { tokenName: 'anime', amount: '100', lockAuthority: 'eth|0x1234...' },
+     *     { tokenName: 'dragon', amount: '50', expires: Date.now() + 86400000 }
+     *   ]
      * });
      * ```
      *
-     * @throws {TransferError} When validation fails or lock operation is rejected
+     * @throws {LockError} When validation fails or lock operation is rejected
      */
-    lockToken(data: LockTokenData): Promise<string>;
+    lockTokens(data: LockTokensData): Promise<LockTokensResult>;
     /**
-     * Unlock previously locked tokens on GalaChain
+     * Unlock previously locked tokens on GalaChain (batch operation)
      *
+     * Supports unlocking multiple token types in a single transaction.
      * Releases locked tokens, making them available for transfer again.
      * Must be signed by the lock authority (the address that created the lock
      * or was designated as lock authority).
      *
-     * @param data - Unlock parameters including token identification and amount
-     * @returns Promise<string> Transaction ID or success identifier
+     * @param data - Unlock parameters containing array of tokens to unlock
+     * @returns UnlockTokensResult with transaction ID and unlocked token details
      *
      * @example
      * ```typescript
-     * // Unlock tokens
-     * const txId = await galaChainService.unlockToken({
-     *   tokenName: 'unicorn',
-     *   amount: '50'
+     * // Unlock a single token
+     * const result = await galaChainService.unlockTokens({
+     *   tokens: [{ tokenName: 'anime', amount: '50' }]
      * });
      *
-     * // Unlock tokens matching a specific lock name
-     * const txId = await galaChainService.unlockToken({
-     *   tokenId: 'Token$Unit$UNI$eth:0x...',
-     *   amount: '100',
-     *   name: 'staking-lock-v1' // Must match the name used during lock
+     * // Unlock multiple tokens
+     * const result = await galaChainService.unlockTokens({
+     *   tokens: [
+     *     { tokenName: 'anime', amount: '50' },
+     *     { tokenName: 'dragon', amount: '25', name: 'staking-lock-v1' }
+     *   ]
      * });
      * ```
      *
-     * @throws {TransferError} When validation fails or unlock operation is rejected
+     * @throws {LockError} When validation fails or unlock operation is rejected
      */
-    unlockToken(data: UnlockTokenData): Promise<string>;
+    unlockTokens(data: UnlockTokensData): Promise<UnlockTokensResult>;
+    /**
+     * Permanently burn tokens on GalaChain
+     *
+     * ⚠️ WARNING: THIS OPERATION IS IRREVERSIBLE ⚠️
+     * Burned tokens cannot be recovered or recreated.
+     * This reduces the total supply of the token.
+     *
+     * Supports batch burning of multiple token types in a single transaction.
+     *
+     * @param data - Burn data containing tokens array with amounts
+     * @returns Result with transaction ID and burned token details
+     * @throws {BurnError} When validation fails or burn operation is rejected
+     *
+     * @example
+     * ```typescript
+     * // Burn a single token type
+     * const result = await galaChainService.burnTokens({
+     *   tokens: [{ tokenName: 'anime', amount: '100' }]
+     * });
+     *
+     * // Burn multiple token types in one transaction
+     * const result = await galaChainService.burnTokens({
+     *   tokens: [
+     *     { tokenName: 'anime', amount: '50' },
+     *     { tokenName: 'doge', amount: '25' }
+     *   ]
+     * });
+     * ```
+     */
+    burnTokens(data: BurnTokensData): Promise<BurnTokensResult>;
+    /**
+     * Extract burn result from GalaChain response
+     */
+    private extractBurnResult;
+    /**
+     * Validate burn tokens data
+     */
+    private validateBurnTokensData;
+    /**
+     * Handle burn operation errors
+     */
+    private handleBurnError;
+    /**
+     * Validate lock tokens data (batch operation)
+     */
+    private validateLockTokensData;
+    /**
+     * Validate unlock tokens data (batch operation)
+     */
+    private validateUnlockTokensData;
+    /**
+     * Extract lock result from GalaChain response
+     */
+    private extractLockResult;
+    /**
+     * Extract unlock result from GalaChain response
+     */
+    private extractUnlockResult;
+    /**
+     * Handle lock/unlock operation errors
+     */
+    private handleLockError;
     /**
      * Validate GALA transfer data
      */

package/dist/src/services/GalaChainService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GalaChainService.d.ts","sourceRoot":"","sources":["../../../src/services/GalaChainService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GalaChainService.d.ts","sourceRoot":"","sources":["../../../src/services/GalaChainService.ts"],"names":[],"mappings":"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"}

package/dist/src/types/burn.dto.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Burn API Data Transfer Objects and Types
+ *
+ * This module contains all types and interfaces related to token burning
+ * operations on GalaChain.
+ *
+ * Burn operations permanently destroy tokens. THIS IS IRREVERSIBLE.
+ * Once burned, tokens cannot be recovered or recreated.
+ */
+import type { TokenId } from '../types/common';
+/**
+ * Token entry for batch burn operations
+ */
+export interface BurnTokenEntry {
+    /** Flexible token identifier - accepts string, TokenClassKey, or TokenInstanceKey */
+    tokenId?: TokenId;
+    /** Token name for lookup (e.g., 'tinyevil', 'dragnrkti') - used if tokenId not provided */
+    tokenName?: string;
+    /** Amount of tokens to burn in decimal format */
+    amount: string;
+}
+/**
+ * Data required for burning tokens on GalaChain
+ *
+ * IRREVERSIBLE: Burned tokens are permanently destroyed and cannot be recovered.
+ * Use with caution. This operation reduces total supply.
+ *
+ * **Batch Behavior:** Each token in the batch is processed as part of a single GalaChain
+ * transaction. The transaction either succeeds completely (all tokens burned) or fails
+ * completely (no tokens burned). However, network errors after submission may require
+ * checking transaction status to confirm the outcome.
+ *
+ * **Batch Limits:** Maximum {@link MAX_BURN_BATCH_SIZE} tokens per operation (default: 50).
+ * This conservative limit exists due to the irreversible nature of burn operations.
+ */
+export interface BurnTokensData {
+    /** Array of tokens to burn - supports multiple token types in single transaction */
+    tokens: BurnTokenEntry[];
+    /** Optional unique key for idempotency - auto-generated if not provided */
+    uniqueKey?: string;
+    /** Optional private key override for this operation (format: '0x' + 64 hex characters) */
+    privateKey?: string;
+}
+/**
+ * Entry in the burn result showing details of each burned token
+ */
+export interface TokenBurnEntry {
+    /** Token collection (usually 'Token') */
+    collection: string;
+    /** Token category (usually 'Unit') */
+    category: string;
+    /** Token type/symbol */
+    type: string;
+    /** Additional key for the token class */
+    additionalKey: string;
+    /** Instance identifier */
+    instance: string;
+    /** Quantity burned (in base units) */
+    quantity: string;
+    /** Address that burned the tokens */
+    burnedBy: string;
+}
+/**
+ * Result of a burn operation
+ */
+export interface BurnTokensResult {
+    /** Transaction ID if available */
+    transactionId?: string;
+    /** Array of burned token entries */
+    burned: TokenBurnEntry[];
+}
+/**
+ * GalaChain response data item structure for burn operations
+ */
+export interface GalaChainBurnDataItem {
+    additionalKey?: string;
+    category?: string;
+    collection?: string;
+    type?: string;
+    instance?: string;
+    quantity?: string;
+    burnedBy?: string;
+    txnId?: string;
+    transactionId?: string;
+    id?: string;
+    TxnId?: string;
+    [key: string]: unknown;
+}
+/**
+ * GalaChain response format structure for burn operations
+ */
+export interface GalaChainBurnResponse {
+    Status: number;
+    Data: GalaChainBurnDataItem[];
+    Message?: string;
+}
+/**
+ * Internal response from burn endpoint
+ */
+export type InternalBurnResponse = GalaChainBurnResponse;
+/**
+ * Type guard to check if an object is a valid BurnTokenEntry
+ */
+export declare function isBurnTokenEntry(obj: unknown): obj is BurnTokenEntry;
+/**
+ * Type guard to check if an object is valid BurnTokensData
+ */
+export declare function isBurnTokensData(obj: unknown): obj is BurnTokensData;
+/**
+ * Maximum batch size for burn operations
+ *
+ * Burn operations are limited to this many tokens per transaction
+ * to prevent DoS and ensure reasonable transaction sizes.
+ * The limit is conservative due to the irreversible nature of burns.
+ */
+export declare const MAX_BURN_BATCH_SIZE = 50;
+/**
+ * Burn-specific error types
+ */
+export declare enum BurnErrorType {
+    TOKEN_NOT_FOUND = "TOKEN_NOT_FOUND",
+    INVALID_AMOUNT = "INVALID_AMOUNT",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    SIGNATURE_FAILED = "SIGNATURE_FAILED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    WALLET_REQUIRED = "WALLET_REQUIRED",
+    VALIDATION_ERROR = "VALIDATION_ERROR"
+}
+/**
+ * Burn error with detailed information
+ */
+export declare class BurnError extends Error {
+    readonly type: BurnErrorType;
+    readonly details?: {
+        tokenName?: string;
+        tokenId?: TokenId;
+        amount?: string;
+        balance?: string;
+        uniqueKey?: string;
+    } | undefined;
+    constructor(message: string, type: BurnErrorType, details?: {
+        tokenName?: string;
+        tokenId?: TokenId;
+        amount?: string;
+        balance?: string;
+        uniqueKey?: string;
+    } | undefined);
+}
+//# sourceMappingURL=burn.dto.d.ts.map

package/dist/src/types/burn.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burn.dto.d.ts","sourceRoot":"","sources":["../../../src/types/burn.dto.ts"],"names":[],"mappings":"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"}

package/dist/src/types/lock.dto.d.ts

@@ -6,17 +6,18 @@
  *
  * Lock operations place holds on tokens, preventing transfers until unlocked.
  * Useful for staking, escrow, vesting, or other hold scenarios.
+ *
+ * BATCH OPERATIONS: Both lockTokens() and unlockTokens() support multiple tokens
+ * in a single transaction for efficiency.
  */
+import type { TokenId, TokenClassKey } from '../types/common';
 /**
- * Data required for locking tokens on GalaChain
- *
- * Locked tokens cannot be transferred until unlocked by the lock authority.
- * Useful for staking, escrow, vesting, or other hold scenarios.
+ * Token entry for batch lock operations
  */
-export interface LockTokenData {
+export interface LockTokenEntry {
     /** Flexible token identifier - accepts string, TokenClassKey, or TokenInstanceKey */
-    tokenId?: import('../types/common').TokenId;
-    /** Token name for lookup (e.g., 'tinyevil', 'dragnrkti') - used if tokenId not provided */
+    tokenId?: TokenId;
+    /** Token name for lookup (e.g., 'anime', 'dragon') - used if tokenId not provided */
     tokenName?: string;
     /** Amount of tokens to lock in decimal format */
     amount: string;
@@ -26,35 +27,109 @@ export interface LockTokenData {
     expires?: number;
     /** Optional name/identifier for the lock - can be used to match during unlock */
     name?: string;
+}
+/**
+ * Token entry for batch unlock operations
+ */
+export interface UnlockTokenEntry {
+    /** Flexible token identifier - accepts string, TokenClassKey, or TokenInstanceKey */
+    tokenId?: TokenId;
+    /** Token name for lookup (e.g., 'anime', 'dragon') - used if tokenId not provided */
+    tokenName?: string;
+    /** Amount of tokens to unlock in decimal format */
+    amount: string;
+    /** Optional lock name to match (if a name was used during the lock operation) */
+    name?: string;
+}
+/**
+ * Data required for locking tokens on GalaChain (batch operation)
+ *
+ * Supports locking multiple token types in a single transaction.
+ * Locked tokens cannot be transferred until unlocked by the lock authority.
+ * Useful for staking, escrow, vesting, or other hold scenarios.
+ *
+ * **Batch Behavior:** Each token in the batch is processed as part of a single GalaChain
+ * transaction. The transaction either succeeds completely (all tokens locked) or fails
+ * completely (no tokens locked). However, network errors after submission may require
+ * checking transaction status to confirm the outcome.
+ *
+ * **Batch Limits:** Maximum {@link MAX_LOCK_BATCH_SIZE} tokens per operation (default: 100).
+ *
+ * **Note:** Lock parameters (lockAuthority, expires, name) from the first token with those
+ * fields set apply to the entire batch - GalaChain locks support only one set of parameters per transaction.
+ */
+export interface LockTokensData {
+    /** Array of tokens to lock (each with tokenId or tokenName, amount, and optional lock parameters) */
+    tokens: LockTokenEntry[];
     /** Optional unique key for idempotency - auto-generated if not provided */
     uniqueKey?: string;
     /** Optional private key override for this operation (format: '0x' + 64 hex characters) */
     privateKey?: string;
 }
 /**
- * Data required for unlocking previously locked tokens on GalaChain
+ * Data required for unlocking previously locked tokens on GalaChain (batch operation)
  *
+ * Supports unlocking multiple token types in a single transaction.
  * Must be signed by the lock authority (the address that locked the tokens
  * or was designated as lock authority during the lock operation).
+ *
+ * **Batch Behavior:** Each token in the batch is processed as part of a single GalaChain
+ * transaction. The transaction either succeeds completely (all tokens unlocked) or fails
+ * completely (no tokens unlocked). However, network errors after submission may require
+ * checking transaction status to confirm the outcome.
+ *
+ * **Batch Limits:** Maximum {@link MAX_UNLOCK_BATCH_SIZE} tokens per operation (default: 100).
  */
-export interface UnlockTokenData {
-    /** Flexible token identifier - accepts string, TokenClassKey, or TokenInstanceKey */
-    tokenId?: import('../types/common').TokenId;
-    /** Token name for lookup (e.g., 'tinyevil', 'dragnrkti') - used if tokenId not provided */
-    tokenName?: string;
-    /** Amount of tokens to unlock in decimal format */
-    amount: string;
-    /** Optional lock name to match (if a name was used during the lock operation) */
-    name?: string;
+export interface UnlockTokensData {
+    /** Array of tokens to unlock (each with tokenId or tokenName, amount, and optional name) */
+    tokens: UnlockTokenEntry[];
     /** Optional unique key for idempotency - auto-generated if not provided */
     uniqueKey?: string;
     /** Optional private key override for this operation (format: '0x' + 64 hex characters) */
     privateKey?: string;
 }
+/**
+ * Entry in the lock result showing details of each locked token
+ */
+export interface TokenLockEntry {
+    /** Token class key identifying the locked token */
+    tokenClassKey: TokenClassKey;
+    /** Quantity locked (in base units) */
+    quantity: string;
+    /** Address that can unlock these tokens */
+    lockAuthority: string;
+}
+/**
+ * Entry in the unlock result showing details of each unlocked token
+ */
+export interface TokenUnlockEntry {
+    /** Token class key identifying the unlocked token */
+    tokenClassKey: TokenClassKey;
+    /** Quantity unlocked (in base units) */
+    quantity: string;
+}
+/**
+ * Result of a lock operation
+ */
+export interface LockTokensResult {
+    /** Transaction ID if available */
+    transactionId?: string;
+    /** Array of locked token entries */
+    locked: TokenLockEntry[];
+}
+/**
+ * Result of an unlock operation
+ */
+export interface UnlockTokensResult {
+    /** Transaction ID if available */
+    transactionId?: string;
+    /** Array of unlocked token entries */
+    unlocked: TokenUnlockEntry[];
+}
 /**
  * GalaChain response data item structure for lock/unlock operations
  */
-interface GalaChainLockDataItem {
+export interface GalaChainLockDataItem {
     additionalKey?: string;
     category?: string;
     collection?: string;
@@ -73,22 +148,45 @@ interface GalaChainLockDataItem {
 /**
  * GalaChain response format structure for lock/unlock operations
  */
-interface GalaChainLockResponse {
+export interface GalaChainLockResponse {
     Status: number;
     Data: GalaChainLockDataItem[];
+    Message?: string;
 }
 /**
  * Internal response from lock/unlock endpoints
  */
 export type InternalLockResponse = GalaChainLockResponse;
 /**
- * Type guard to check if an object is valid LockTokenData
+ * Type guard to check if an object is a valid LockTokenEntry
  */
-export declare function isLockTokenData(obj: unknown): obj is LockTokenData;
+export declare function isLockTokenEntry(obj: unknown): obj is LockTokenEntry;
 /**
- * Type guard to check if an object is valid UnlockTokenData
+ * Type guard to check if an object is a valid UnlockTokenEntry
  */
-export declare function isUnlockTokenData(obj: unknown): obj is UnlockTokenData;
+export declare function isUnlockTokenEntry(obj: unknown): obj is UnlockTokenEntry;
+/**
+ * Type guard to check if an object is valid LockTokensData
+ */
+export declare function isLockTokensData(obj: unknown): obj is LockTokensData;
+/**
+ * Type guard to check if an object is valid UnlockTokensData
+ */
+export declare function isUnlockTokensData(obj: unknown): obj is UnlockTokensData;
+/**
+ * Maximum batch size for lock operations
+ *
+ * Lock operations are limited to this many tokens per transaction
+ * to prevent DoS and ensure reasonable transaction sizes.
+ */
+export declare const MAX_LOCK_BATCH_SIZE = 100;
+/**
+ * Maximum batch size for unlock operations
+ *
+ * Unlock operations are limited to this many tokens per transaction
+ * to prevent DoS and ensure reasonable transaction sizes.
+ */
+export declare const MAX_UNLOCK_BATCH_SIZE = 100;
 /**
  * Validation constraints for lock/unlock operations
  */
@@ -103,6 +201,10 @@ export declare const LOCK_CONSTRAINTS: {
     readonly ETH_ADDRESS_PATTERN: RegExp;
     /** Pattern for valid backend addresses (eth| format) - imported from centralized ADDRESS_PATTERNS */
     readonly BACKEND_ADDRESS_PATTERN: RegExp;
+    /** Maximum tokens per lock batch */
+    readonly MAX_LOCK_BATCH_SIZE: 100;
+    /** Maximum tokens per unlock batch */
+    readonly MAX_UNLOCK_BATCH_SIZE: 100;
 };
 /**
  * Lock/Unlock specific error types
@@ -114,6 +216,7 @@ export declare enum LockErrorType {
     SIGNATURE_FAILED = "SIGNATURE_FAILED",
     NETWORK_ERROR = "NETWORK_ERROR",
     WALLET_REQUIRED = "WALLET_REQUIRED",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
     LOCK_NOT_FOUND = "LOCK_NOT_FOUND",
     LOCK_EXPIRED = "LOCK_EXPIRED",
     INSUFFICIENT_LOCKED_BALANCE = "INSUFFICIENT_LOCKED_BALANCE",
@@ -127,6 +230,7 @@ export declare class LockError extends Error {
     readonly type: LockErrorType;
     readonly details?: {
         tokenName?: string;
+        tokenId?: TokenId;
         amount?: string;
         balance?: string;
         lockAuthority?: string;
@@ -135,6 +239,7 @@ export declare class LockError extends Error {
     } | undefined;
     constructor(message: string, type: LockErrorType, details?: {
         tokenName?: string;
+        tokenId?: TokenId;
         amount?: string;
         balance?: string;
         lockAuthority?: string;
@@ -142,5 +247,30 @@ export declare class LockError extends Error {
         uniqueKey?: string;
     } | undefined);
 }
-export {};
+/**
+ * @deprecated Use LockTokensData instead. Will be removed in v5.0.0.
+ *
+ * Migration: `sdk.lockToken(data)` → `sdk.lockTokens({ tokens: [data] })`
+ */
+export type LockTokenData = LockTokenEntry & {
+    uniqueKey?: string;
+    privateKey?: string;
+};
+/**
+ * @deprecated Use UnlockTokensData instead. Will be removed in v5.0.0.
+ *
+ * Migration: `sdk.unlockToken(data)` → `sdk.unlockTokens({ tokens: [data] })`
+ */
+export type UnlockTokenData = UnlockTokenEntry & {
+    uniqueKey?: string;
+    privateKey?: string;
+};
+/**
+ * @deprecated Use isLockTokensData instead. Will be removed in v5.0.0.
+ */
+export declare function isLockTokenData(obj: unknown): obj is LockTokenData;
+/**
+ * @deprecated Use isUnlockTokensData instead. Will be removed in v5.0.0.
+ */
+export declare function isUnlockTokenData(obj: unknown): obj is UnlockTokenData;
 //# sourceMappingURL=lock.dto.d.ts.map

package/dist/src/types/lock.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.dto.d.ts","sourceRoot":"","sources":["../../../src/types/lock.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lock.dto.d.ts","sourceRoot":"","sources":["../../../src/types/lock.dto.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/SignatureHelper.d.ts

@@ -65,6 +65,22 @@ export declare class SignatureHelper {
         name?: string;
         uniqueKey: string;
     }): Promise<SignedPayload>;
+    /**
+     * Sign a BurnTokens payload using EIP-712
+     */
+    signBurnTokens(payload: {
+        tokenInstances: Array<{
+            quantity: string;
+            tokenInstanceKey: {
+                collection: string;
+                category: string;
+                type: string;
+                additionalKey: string;
+                instance: string;
+            };
+        }>;
+        uniqueKey: string;
+    }): Promise<SignedPayload>;
     /**
      * Sign an UnlockToken payload using EIP-712
      */

package/dist/src/utils/SignatureHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SignatureHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/SignatureHelper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SignatureHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/SignatureHelper.ts"],"names":[],"mappings":"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"}