@zkp2p/sdk 0.0.4 → 0.0.6

package/dist/{Zkp2pClient-CIMGTCFg.d.mts → Zkp2pClient-D-eU4dxy.d.mts}

@@ -1,4 +1,4 @@
-import { AccessList, AuthorizationList, WalletClient, Hash, Address, PublicClient } from 'viem';
+import { Address, Hex, AccessList, AuthorizationList, WalletClient, Hash, PublicClient } from 'viem';
 import { Abi } from 'abitype';
 
 /**
@@ -523,6 +523,38 @@ type FulfillmentAndPaymentResponse = {
 };
 declare function fetchFulfillmentAndPayment(client: IndexerClient, intentHash: string): Promise<FulfillmentAndPaymentResponse>;
 
+/**
+ * A prepared transaction ready for submission.
+ * Contains all data needed to submit via wallet or relayer.
+ */
+type PreparedTransaction = {
+    /** Target contract address */
+    to: Address;
+    /** Encoded calldata (includes ERC-8021 attribution) */
+    data: Hex;
+    /** ETH value to send (usually 0n for ZKP2P) */
+    value: bigint;
+    /** Chain ID for the transaction */
+    chainId: number;
+};
+/**
+ * A method that can be called directly or via .prepare()
+ *
+ * @example
+ * ```typescript
+ * // Execute directly (current behavior)
+ * const hash = await client.signalIntent(params);
+ *
+ * // Prepare for relayer submission
+ * const prepared = await client.signalIntent.prepare(params);
+ * await relayer.submit({ to: prepared.to, data: prepared.data });
+ * ```
+ */
+type PrepareableMethod<TParams, TResult> = {
+    (params: TParams): Promise<TResult>;
+    prepare(params: TParams): Promise<PreparedTransaction>;
+};
+
 /**
  * Timeout configuration for different operation types
  */
@@ -1077,6 +1109,76 @@ type Zkp2pNextOptions = {
         api?: number;
     };
 };
+/**
+ * Parameters for signalIntent method.
+ * Used by both the direct call and .prepare() variants.
+ */
+type SignalIntentMethodParams = {
+    /** The deposit ID to use */
+    depositId: bigint | string;
+    /** Amount of tokens to claim (in token units) */
+    amount: bigint | string;
+    /** Address to receive the tokens when fulfilled */
+    toAddress: Address;
+    /** Payment platform name (e.g., 'wise', 'revolut') */
+    processorName: string;
+    /** Hashed payee details (from deposit) */
+    payeeDetails: string;
+    /** Fiat currency code (e.g., 'USD', 'EUR') */
+    fiatCurrencyCode: string;
+    /** Agreed conversion rate (18 decimals) */
+    conversionRate: bigint | string;
+    /** Optional referrer address for fee sharing */
+    referrer?: Address;
+    /** Optional referrer fee amount */
+    referrerFee?: bigint | string;
+    /** Optional hook contract to call after signaling */
+    postIntentHook?: Address;
+    /** Optional data to pass to the hook */
+    data?: `0x${string}`;
+    /** Pre-obtained signature (if not auto-fetching) */
+    gatingServiceSignature?: `0x${string}`;
+    /** Signature expiration timestamp */
+    signatureExpiration?: bigint | string;
+    /** Optional viem transaction overrides */
+    txOverrides?: TxOverrides;
+};
+/**
+ * Parameters for cancelIntent method.
+ * Used by both the direct call and .prepare() variants.
+ */
+type CancelIntentMethodParams = {
+    /** The intent hash to cancel (0x-prefixed, 32 bytes) */
+    intentHash: `0x${string}`;
+    /** Optional viem transaction overrides */
+    txOverrides?: TxOverrides;
+};
+/**
+ * Parameters for fulfillIntent method.
+ * Used by both the direct call and .prepare() variants.
+ */
+type FulfillIntentMethodParams = {
+    /** The intent hash to fulfill (0x-prefixed, 32 bytes) */
+    intentHash: `0x${string}`;
+    /** Payment proof from Reclaim (object or JSON string) */
+    proof: Record<string, unknown> | string;
+    /** Allowed timestamp variance in ms (default: 300000ms) */
+    timestampBufferMs?: string;
+    /** Override attestation service URL */
+    attestationServiceUrl?: string;
+    /** Override verifier contract address */
+    verifyingContract?: Address;
+    /** Data to pass to post-intent hook */
+    postIntentHookData?: `0x${string}`;
+    /** Optional viem transaction overrides */
+    txOverrides?: TxOverrides;
+    /** Lifecycle callbacks for UI updates */
+    callbacks?: {
+        onAttestationStart?: () => void;
+        onTxSent?: (hash: Hash) => void;
+        onTxMined?: (hash: Hash) => void;
+    };
+};
 /**
  * SDK client for ZKP2P liquidity providers (offramp peers).
  *
@@ -1192,6 +1294,11 @@ declare class Zkp2pClient {
      * Referrer codes are stripped from overrides for simulation and appended to calldata.
      */
     private simulateAndSendWithAttribution;
+    /**
+     * Execute a prepared transaction (simulation + send).
+     * Used internally by prepareable methods after preparation.
+     */
+    private executePreparedTransaction;
     /**
      * Fetches all deposits owned by the connected wallet from on-chain.
      *
@@ -1729,6 +1836,13 @@ declare class Zkp2pClient {
      * If `gatingServiceSignature` is not provided, the SDK will automatically
      * fetch one from the API (requires `apiKey` or `authorizationToken`).
      *
+     * **Prepare Mode**: Use `.prepare()` to get the transaction calldata without sending:
+     * ```typescript
+     * const prepared = await client.signalIntent.prepare(params);
+     * // Submit via relayer or inspect calldata
+     * await relayer.submit({ to: prepared.to, data: prepared.data });
+     * ```
+     *
      * @param params.depositId - The deposit to use
      * @param params.amount - Amount of tokens to claim (in token units)
      * @param params.toAddress - Address to receive the tokens when fulfilled
@@ -1747,6 +1861,7 @@ declare class Zkp2pClient {
      *
      * @example
      * ```typescript
+     * // Execute directly
      * const hash = await client.signalIntent({
      *   depositId: 42n,
      *   amount: 100_000000n, // 100 USDC
@@ -1756,37 +1871,55 @@ declare class Zkp2pClient {
      *   fiatCurrencyCode: 'USD',
      *   conversionRate: 1_020000000000000000n, // 1.02
      * });
+     *
+     * // Or prepare for relayer submission
+     * const prepared = await client.signalIntent.prepare({
+     *   depositId: 42n,
+     *   amount: 100_000000n,
+     *   toAddress: '0x...',
+     *   processorName: 'wise',
+     *   payeeDetails: '0x...',
+     *   fiatCurrencyCode: 'USD',
+     *   conversionRate: 1_020000000000000000n,
+     * });
+     * // prepared.to, prepared.data, prepared.value, prepared.chainId
      * ```
      */
-    signalIntent(params: {
-        depositId: bigint | string;
-        amount: bigint | string;
-        toAddress: Address;
-        processorName: string;
-        payeeDetails: string;
-        fiatCurrencyCode: string;
-        conversionRate: bigint | string;
-        referrer?: Address;
-        referrerFee?: bigint | string;
-        postIntentHook?: Address;
-        data?: `0x${string}`;
-        gatingServiceSignature?: `0x${string}`;
-        signatureExpiration?: bigint | string;
-        txOverrides?: TxOverrides;
-    }): Promise<Hash>;
+    readonly signalIntent: PrepareableMethod<SignalIntentMethodParams, Hash>;
+    /**
+     * Prepare signalIntent transaction (all logic except simulation/send).
+     * Returns the prepared transaction with encoded calldata.
+     */
+    private prepareSignalIntent;
     /**
      * **Supporting Method** - Cancels a signaled intent before fulfillment.
      *
      * Only the intent owner can cancel. Releases reserved funds back to the deposit.
      *
+     * **Prepare Mode**: Use `.prepare()` to get the transaction calldata without sending:
+     * ```typescript
+     * const prepared = await client.cancelIntent.prepare({ intentHash });
+     * await relayer.submit({ to: prepared.to, data: prepared.data });
+     * ```
+     *
      * @param params.intentHash - The intent hash to cancel (0x-prefixed, 32 bytes)
      * @param params.txOverrides - Optional viem transaction overrides
      * @returns Transaction hash
+     *
+     * @example
+     * ```typescript
+     * // Execute directly
+     * const hash = await client.cancelIntent({ intentHash: '0x...' });
+     *
+     * // Or prepare for relayer submission
+     * const prepared = await client.cancelIntent.prepare({ intentHash: '0x...' });
+     * ```
      */
-    cancelIntent(params: {
-        intentHash: `0x${string}`;
-        txOverrides?: TxOverrides;
-    }): Promise<Hash>;
+    readonly cancelIntent: PrepareableMethod<CancelIntentMethodParams, Hash>;
+    /**
+     * Prepare cancelIntent transaction (all logic except simulation/send).
+     */
+    private prepareCancelIntent;
     /**
      * **Supporting Method** - Releases funds back to the deposit owner.
      *
@@ -1817,6 +1950,13 @@ declare class Zkp2pClient {
      * 3. Attestation response is encoded and submitted on-chain
      * 4. Funds are released to the intent's `toAddress`
      *
+     * **Prepare Mode**: Use `.prepare()` to get the transaction calldata without sending:
+     * ```typescript
+     * const prepared = await client.fulfillIntent.prepare(params);
+     * // Submit via relayer or inspect calldata
+     * await relayer.submit({ to: prepared.to, data: prepared.data });
+     * ```
+     *
      * @param params.intentHash - The intent hash to fulfill (0x-prefixed, 32 bytes)
      * @param params.proof - Payment proof from Reclaim (object or JSON string)
      * @param params.timestampBufferMs - Allowed timestamp variance (default: 300000ms)
@@ -1826,21 +1966,29 @@ declare class Zkp2pClient {
      * @param params.txOverrides - Optional viem transaction overrides
      * @param params.callbacks - Lifecycle callbacks for UI updates
      * @returns Transaction hash
+     *
+     * @example
+     * ```typescript
+     * // Execute directly
+     * const hash = await client.fulfillIntent({
+     *   intentHash: '0x...',
+     *   proof: proofFromExtension,
+     * });
+     *
+     * // Or prepare for relayer submission
+     * const prepared = await client.fulfillIntent.prepare({
+     *   intentHash: '0x...',
+     *   proof: proofFromExtension,
+     * });
+     * // prepared.to, prepared.data, prepared.value, prepared.chainId
+     * ```
      */
-    fulfillIntent(params: {
-        intentHash: `0x${string}`;
-        proof: Record<string, unknown> | string;
-        timestampBufferMs?: string;
-        attestationServiceUrl?: string;
-        verifyingContract?: Address;
-        postIntentHookData?: `0x${string}`;
-        txOverrides?: TxOverrides;
-        callbacks?: {
-            onAttestationStart?: () => void;
-            onTxSent?: (hash: Hash) => void;
-            onTxMined?: (hash: Hash) => void;
-        };
-    }): Promise<Hash>;
+    readonly fulfillIntent: PrepareableMethod<FulfillIntentMethodParams, Hash>;
+    /**
+     * Prepare fulfillIntent transaction (all logic except simulation/send).
+     * Includes fetching intent inputs and calling attestation service.
+     */
+    private prepareFulfillIntent;
     private defaultAttestationService;
     /**
      * **Supporting Method** - Fetches quotes for available liquidity.
@@ -1979,4 +2127,4 @@ declare class Zkp2pClient {
     }>;
 }
 
-export { type DepositVerifierData as $, type ActionCallback as A, type GetDepositByIdResponse as B, type CreateDepositParams as C, type DepositWithRelations as D, type Intent as E, type FulfillIntentParams as F, type GetPayeeDetailsRequest as G, type ApiIntentStatus as H, type IntentEntity as I, type GetOwnerIntentsRequest as J, type GetOwnerIntentsResponse as K, type GetIntentsByDepositRequest as L, type GetIntentsByDepositResponse as M, type NearbyQuote as N, type GetIntentByHashRequest as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type Range as R, type SignalIntentParams as S, type TxOverrides as T, type GetIntentByHashResponse as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type RegisterPayeeDetailsRequest as X, type RegisterPayeeDetailsResponse as Y, Zkp2pClient as Z, type OnchainCurrency as _, type ValidatePayeeDetailsResponse as a, type OrderStats as a0, type DepositIntentStatistics as a1, type TakerTier as a2, type TakerTierStats as a3, type TakerTierLevel as a4, type PlatformLimit as a5, type PlatformRiskLevel as a6, IndexerClient as a7, defaultIndexerEndpoint as a8, IndexerDepositService as a9, getPaymentMethodsCatalog as aA, getGatingServiceAddress as aB, type RuntimeEnv as aC, parseDepositView as aD, parseIntentView as aE, enrichPvDepositView as aF, enrichPvIntentView as aG, type PV_DepositView as aH, type PV_Deposit as aI, type PV_PaymentMethodData as aJ, type PV_Currency as aK, type PV_IntentView as aL, type PV_Intent as aM, fetchFulfillmentAndPayment as aa, type DepositEntity as ab, type IntentFulfilledEntity as ac, type DepositPaymentMethodEntity as ad, type MethodCurrencyEntity as ae, type IntentStatus as af, type DepositFilter as ag, type PaginationOptions as ah, type DepositOrderField as ai, type OrderDirection as aj, type DeploymentEnv as ak, type FulfillmentRecord as al, type PaymentVerifiedRecord as am, type FulfillmentAndPaymentResponse as an, PAYMENT_PLATFORMS as ao, type PaymentPlatformType as ap, Currency as aq, currencyInfo as ar, getCurrencyInfoFromHash as as, getCurrencyInfoFromCountryCode as at, getCurrencyCodeFromHash as au, isSupportedCurrencyHash as av, mapConversionRatesToOnchainMinRate as aw, type CurrencyType as ax, type CurrencyData as ay, getContracts as az, type PostDepositDetailsResponse as b, type GetPayeeDetailsResponse as c, type GetTakerTierRequest as d, type GetTakerTierResponse as e, type PaymentMethodCatalog as f, type Zkp2pClientOptions as g, type TimeoutConfig as h, type CreateDepositConversionRate as i, type ReleaseFundsToPayerParams as j, type CancelIntentParams as k, type QuoteResponse as l, type QuoteResponseObject as m, type QuoteSingleResponse as n, type QuoteIntentResponse as o, type QuoteFeesResponse as p, type FiatResponse as q, type TokenResponse as r, type NearbySuggestions as s, type ApiDeposit as t, type DepositVerifier as u, type DepositVerifierCurrency as v, type DepositStatus as w, type GetOwnerDepositsRequest as x, type GetOwnerDepositsResponse as y, type GetDepositByIdRequest as z };
+export { type RegisterPayeeDetailsRequest as $, type ActionCallback as A, type GetOwnerDepositsRequest as B, type CancelIntentMethodParams as C, type DepositWithRelations as D, type GetOwnerDepositsResponse as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type GetDepositByIdRequest as H, type IntentEntity as I, type GetDepositByIdResponse as J, type Intent as K, type ApiIntentStatus as L, type GetOwnerIntentsRequest as M, type NearbyQuote as N, type GetOwnerIntentsResponse as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type Range as R, type SignalIntentMethodParams as S, type TxOverrides as T, type GetIntentsByDepositRequest as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type GetIntentsByDepositResponse as X, type GetIntentByHashRequest as Y, Zkp2pClient as Z, type GetIntentByHashResponse as _, type ValidatePayeeDetailsResponse as a, type RegisterPayeeDetailsResponse as a0, type OnchainCurrency as a1, type DepositVerifierData as a2, type PreparedTransaction as a3, type OrderStats as a4, type DepositIntentStatistics as a5, type TakerTier as a6, type TakerTierStats as a7, type TakerTierLevel as a8, type PlatformLimit as a9, mapConversionRatesToOnchainMinRate as aA, type CurrencyType as aB, type CurrencyData as aC, getContracts as aD, getPaymentMethodsCatalog as aE, getGatingServiceAddress as aF, type RuntimeEnv as aG, parseDepositView as aH, parseIntentView as aI, enrichPvDepositView as aJ, enrichPvIntentView as aK, type PV_DepositView as aL, type PV_Deposit as aM, type PV_PaymentMethodData as aN, type PV_Currency as aO, type PV_IntentView as aP, type PV_Intent as aQ, type PlatformRiskLevel as aa, IndexerClient as ab, defaultIndexerEndpoint as ac, IndexerDepositService as ad, fetchFulfillmentAndPayment as ae, type DepositEntity as af, type IntentFulfilledEntity as ag, type DepositPaymentMethodEntity as ah, type MethodCurrencyEntity as ai, type IntentStatus as aj, type DepositFilter as ak, type PaginationOptions as al, type DepositOrderField as am, type OrderDirection as an, type DeploymentEnv as ao, type FulfillmentRecord as ap, type PaymentVerifiedRecord as aq, type FulfillmentAndPaymentResponse as ar, PAYMENT_PLATFORMS as as, type PaymentPlatformType as at, Currency as au, currencyInfo as av, getCurrencyInfoFromHash as aw, getCurrencyInfoFromCountryCode as ax, getCurrencyCodeFromHash as ay, isSupportedCurrencyHash as az, type PostDepositDetailsResponse as b, type GetPayeeDetailsResponse as c, type GetTakerTierRequest as d, type GetTakerTierResponse as e, type PaymentMethodCatalog as f, type Zkp2pClientOptions as g, type TimeoutConfig as h, type CreateDepositParams as i, type CreateDepositConversionRate as j, type SignalIntentParams as k, type FulfillIntentParams as l, type ReleaseFundsToPayerParams as m, type CancelIntentParams as n, type QuoteResponse as o, type QuoteResponseObject as p, type QuoteSingleResponse as q, type QuoteIntentResponse as r, type QuoteFeesResponse as s, type FiatResponse as t, type TokenResponse as u, type NearbySuggestions as v, type ApiDeposit as w, type DepositVerifier as x, type DepositVerifierCurrency as y, type DepositStatus as z };

package/dist/{Zkp2pClient-CIMGTCFg.d.ts → Zkp2pClient-D-eU4dxy.d.ts}

@@ -1,4 +1,4 @@
-import { AccessList, AuthorizationList, WalletClient, Hash, Address, PublicClient } from 'viem';
+import { Address, Hex, AccessList, AuthorizationList, WalletClient, Hash, PublicClient } from 'viem';
 import { Abi } from 'abitype';
 
 /**
@@ -523,6 +523,38 @@ type FulfillmentAndPaymentResponse = {
 };
 declare function fetchFulfillmentAndPayment(client: IndexerClient, intentHash: string): Promise<FulfillmentAndPaymentResponse>;
 
+/**
+ * A prepared transaction ready for submission.
+ * Contains all data needed to submit via wallet or relayer.
+ */
+type PreparedTransaction = {
+    /** Target contract address */
+    to: Address;
+    /** Encoded calldata (includes ERC-8021 attribution) */
+    data: Hex;
+    /** ETH value to send (usually 0n for ZKP2P) */
+    value: bigint;
+    /** Chain ID for the transaction */
+    chainId: number;
+};
+/**
+ * A method that can be called directly or via .prepare()
+ *
+ * @example
+ * ```typescript
+ * // Execute directly (current behavior)
+ * const hash = await client.signalIntent(params);
+ *
+ * // Prepare for relayer submission
+ * const prepared = await client.signalIntent.prepare(params);
+ * await relayer.submit({ to: prepared.to, data: prepared.data });
+ * ```
+ */
+type PrepareableMethod<TParams, TResult> = {
+    (params: TParams): Promise<TResult>;
+    prepare(params: TParams): Promise<PreparedTransaction>;
+};
+
 /**
  * Timeout configuration for different operation types
  */
@@ -1077,6 +1109,76 @@ type Zkp2pNextOptions = {
         api?: number;
     };
 };
+/**
+ * Parameters for signalIntent method.
+ * Used by both the direct call and .prepare() variants.
+ */
+type SignalIntentMethodParams = {
+    /** The deposit ID to use */
+    depositId: bigint | string;
+    /** Amount of tokens to claim (in token units) */
+    amount: bigint | string;
+    /** Address to receive the tokens when fulfilled */
+    toAddress: Address;
+    /** Payment platform name (e.g., 'wise', 'revolut') */
+    processorName: string;
+    /** Hashed payee details (from deposit) */
+    payeeDetails: string;
+    /** Fiat currency code (e.g., 'USD', 'EUR') */
+    fiatCurrencyCode: string;
+    /** Agreed conversion rate (18 decimals) */
+    conversionRate: bigint | string;
+    /** Optional referrer address for fee sharing */
+    referrer?: Address;
+    /** Optional referrer fee amount */
+    referrerFee?: bigint | string;
+    /** Optional hook contract to call after signaling */
+    postIntentHook?: Address;
+    /** Optional data to pass to the hook */
+    data?: `0x${string}`;
+    /** Pre-obtained signature (if not auto-fetching) */
+    gatingServiceSignature?: `0x${string}`;
+    /** Signature expiration timestamp */
+    signatureExpiration?: bigint | string;
+    /** Optional viem transaction overrides */
+    txOverrides?: TxOverrides;
+};
+/**
+ * Parameters for cancelIntent method.
+ * Used by both the direct call and .prepare() variants.
+ */
+type CancelIntentMethodParams = {
+    /** The intent hash to cancel (0x-prefixed, 32 bytes) */
+    intentHash: `0x${string}`;
+    /** Optional viem transaction overrides */
+    txOverrides?: TxOverrides;
+};
+/**
+ * Parameters for fulfillIntent method.
+ * Used by both the direct call and .prepare() variants.
+ */
+type FulfillIntentMethodParams = {
+    /** The intent hash to fulfill (0x-prefixed, 32 bytes) */
+    intentHash: `0x${string}`;
+    /** Payment proof from Reclaim (object or JSON string) */
+    proof: Record<string, unknown> | string;
+    /** Allowed timestamp variance in ms (default: 300000ms) */
+    timestampBufferMs?: string;
+    /** Override attestation service URL */
+    attestationServiceUrl?: string;
+    /** Override verifier contract address */
+    verifyingContract?: Address;
+    /** Data to pass to post-intent hook */
+    postIntentHookData?: `0x${string}`;
+    /** Optional viem transaction overrides */
+    txOverrides?: TxOverrides;
+    /** Lifecycle callbacks for UI updates */
+    callbacks?: {
+        onAttestationStart?: () => void;
+        onTxSent?: (hash: Hash) => void;
+        onTxMined?: (hash: Hash) => void;
+    };
+};
 /**
  * SDK client for ZKP2P liquidity providers (offramp peers).
  *
@@ -1192,6 +1294,11 @@ declare class Zkp2pClient {
      * Referrer codes are stripped from overrides for simulation and appended to calldata.
      */
     private simulateAndSendWithAttribution;
+    /**
+     * Execute a prepared transaction (simulation + send).
+     * Used internally by prepareable methods after preparation.
+     */
+    private executePreparedTransaction;
     /**
      * Fetches all deposits owned by the connected wallet from on-chain.
      *
@@ -1729,6 +1836,13 @@ declare class Zkp2pClient {
      * If `gatingServiceSignature` is not provided, the SDK will automatically
      * fetch one from the API (requires `apiKey` or `authorizationToken`).
      *
+     * **Prepare Mode**: Use `.prepare()` to get the transaction calldata without sending:
+     * ```typescript
+     * const prepared = await client.signalIntent.prepare(params);
+     * // Submit via relayer or inspect calldata
+     * await relayer.submit({ to: prepared.to, data: prepared.data });
+     * ```
+     *
      * @param params.depositId - The deposit to use
      * @param params.amount - Amount of tokens to claim (in token units)
      * @param params.toAddress - Address to receive the tokens when fulfilled
@@ -1747,6 +1861,7 @@ declare class Zkp2pClient {
      *
      * @example
      * ```typescript
+     * // Execute directly
      * const hash = await client.signalIntent({
      *   depositId: 42n,
      *   amount: 100_000000n, // 100 USDC
@@ -1756,37 +1871,55 @@ declare class Zkp2pClient {
      *   fiatCurrencyCode: 'USD',
      *   conversionRate: 1_020000000000000000n, // 1.02
      * });
+     *
+     * // Or prepare for relayer submission
+     * const prepared = await client.signalIntent.prepare({
+     *   depositId: 42n,
+     *   amount: 100_000000n,
+     *   toAddress: '0x...',
+     *   processorName: 'wise',
+     *   payeeDetails: '0x...',
+     *   fiatCurrencyCode: 'USD',
+     *   conversionRate: 1_020000000000000000n,
+     * });
+     * // prepared.to, prepared.data, prepared.value, prepared.chainId
      * ```
      */
-    signalIntent(params: {
-        depositId: bigint | string;
-        amount: bigint | string;
-        toAddress: Address;
-        processorName: string;
-        payeeDetails: string;
-        fiatCurrencyCode: string;
-        conversionRate: bigint | string;
-        referrer?: Address;
-        referrerFee?: bigint | string;
-        postIntentHook?: Address;
-        data?: `0x${string}`;
-        gatingServiceSignature?: `0x${string}`;
-        signatureExpiration?: bigint | string;
-        txOverrides?: TxOverrides;
-    }): Promise<Hash>;
+    readonly signalIntent: PrepareableMethod<SignalIntentMethodParams, Hash>;
+    /**
+     * Prepare signalIntent transaction (all logic except simulation/send).
+     * Returns the prepared transaction with encoded calldata.
+     */
+    private prepareSignalIntent;
     /**
      * **Supporting Method** - Cancels a signaled intent before fulfillment.
      *
      * Only the intent owner can cancel. Releases reserved funds back to the deposit.
      *
+     * **Prepare Mode**: Use `.prepare()` to get the transaction calldata without sending:
+     * ```typescript
+     * const prepared = await client.cancelIntent.prepare({ intentHash });
+     * await relayer.submit({ to: prepared.to, data: prepared.data });
+     * ```
+     *
      * @param params.intentHash - The intent hash to cancel (0x-prefixed, 32 bytes)
      * @param params.txOverrides - Optional viem transaction overrides
      * @returns Transaction hash
+     *
+     * @example
+     * ```typescript
+     * // Execute directly
+     * const hash = await client.cancelIntent({ intentHash: '0x...' });
+     *
+     * // Or prepare for relayer submission
+     * const prepared = await client.cancelIntent.prepare({ intentHash: '0x...' });
+     * ```
      */
-    cancelIntent(params: {
-        intentHash: `0x${string}`;
-        txOverrides?: TxOverrides;
-    }): Promise<Hash>;
+    readonly cancelIntent: PrepareableMethod<CancelIntentMethodParams, Hash>;
+    /**
+     * Prepare cancelIntent transaction (all logic except simulation/send).
+     */
+    private prepareCancelIntent;
     /**
      * **Supporting Method** - Releases funds back to the deposit owner.
      *
@@ -1817,6 +1950,13 @@ declare class Zkp2pClient {
      * 3. Attestation response is encoded and submitted on-chain
      * 4. Funds are released to the intent's `toAddress`
      *
+     * **Prepare Mode**: Use `.prepare()` to get the transaction calldata without sending:
+     * ```typescript
+     * const prepared = await client.fulfillIntent.prepare(params);
+     * // Submit via relayer or inspect calldata
+     * await relayer.submit({ to: prepared.to, data: prepared.data });
+     * ```
+     *
      * @param params.intentHash - The intent hash to fulfill (0x-prefixed, 32 bytes)
      * @param params.proof - Payment proof from Reclaim (object or JSON string)
      * @param params.timestampBufferMs - Allowed timestamp variance (default: 300000ms)
@@ -1826,21 +1966,29 @@ declare class Zkp2pClient {
      * @param params.txOverrides - Optional viem transaction overrides
      * @param params.callbacks - Lifecycle callbacks for UI updates
      * @returns Transaction hash
+     *
+     * @example
+     * ```typescript
+     * // Execute directly
+     * const hash = await client.fulfillIntent({
+     *   intentHash: '0x...',
+     *   proof: proofFromExtension,
+     * });
+     *
+     * // Or prepare for relayer submission
+     * const prepared = await client.fulfillIntent.prepare({
+     *   intentHash: '0x...',
+     *   proof: proofFromExtension,
+     * });
+     * // prepared.to, prepared.data, prepared.value, prepared.chainId
+     * ```
      */
-    fulfillIntent(params: {
-        intentHash: `0x${string}`;
-        proof: Record<string, unknown> | string;
-        timestampBufferMs?: string;
-        attestationServiceUrl?: string;
-        verifyingContract?: Address;
-        postIntentHookData?: `0x${string}`;
-        txOverrides?: TxOverrides;
-        callbacks?: {
-            onAttestationStart?: () => void;
-            onTxSent?: (hash: Hash) => void;
-            onTxMined?: (hash: Hash) => void;
-        };
-    }): Promise<Hash>;
+    readonly fulfillIntent: PrepareableMethod<FulfillIntentMethodParams, Hash>;
+    /**
+     * Prepare fulfillIntent transaction (all logic except simulation/send).
+     * Includes fetching intent inputs and calling attestation service.
+     */
+    private prepareFulfillIntent;
     private defaultAttestationService;
     /**
      * **Supporting Method** - Fetches quotes for available liquidity.
@@ -1979,4 +2127,4 @@ declare class Zkp2pClient {
     }>;
 }
 
-export { type DepositVerifierData as $, type ActionCallback as A, type GetDepositByIdResponse as B, type CreateDepositParams as C, type DepositWithRelations as D, type Intent as E, type FulfillIntentParams as F, type GetPayeeDetailsRequest as G, type ApiIntentStatus as H, type IntentEntity as I, type GetOwnerIntentsRequest as J, type GetOwnerIntentsResponse as K, type GetIntentsByDepositRequest as L, type GetIntentsByDepositResponse as M, type NearbyQuote as N, type GetIntentByHashRequest as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type Range as R, type SignalIntentParams as S, type TxOverrides as T, type GetIntentByHashResponse as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type RegisterPayeeDetailsRequest as X, type RegisterPayeeDetailsResponse as Y, Zkp2pClient as Z, type OnchainCurrency as _, type ValidatePayeeDetailsResponse as a, type OrderStats as a0, type DepositIntentStatistics as a1, type TakerTier as a2, type TakerTierStats as a3, type TakerTierLevel as a4, type PlatformLimit as a5, type PlatformRiskLevel as a6, IndexerClient as a7, defaultIndexerEndpoint as a8, IndexerDepositService as a9, getPaymentMethodsCatalog as aA, getGatingServiceAddress as aB, type RuntimeEnv as aC, parseDepositView as aD, parseIntentView as aE, enrichPvDepositView as aF, enrichPvIntentView as aG, type PV_DepositView as aH, type PV_Deposit as aI, type PV_PaymentMethodData as aJ, type PV_Currency as aK, type PV_IntentView as aL, type PV_Intent as aM, fetchFulfillmentAndPayment as aa, type DepositEntity as ab, type IntentFulfilledEntity as ac, type DepositPaymentMethodEntity as ad, type MethodCurrencyEntity as ae, type IntentStatus as af, type DepositFilter as ag, type PaginationOptions as ah, type DepositOrderField as ai, type OrderDirection as aj, type DeploymentEnv as ak, type FulfillmentRecord as al, type PaymentVerifiedRecord as am, type FulfillmentAndPaymentResponse as an, PAYMENT_PLATFORMS as ao, type PaymentPlatformType as ap, Currency as aq, currencyInfo as ar, getCurrencyInfoFromHash as as, getCurrencyInfoFromCountryCode as at, getCurrencyCodeFromHash as au, isSupportedCurrencyHash as av, mapConversionRatesToOnchainMinRate as aw, type CurrencyType as ax, type CurrencyData as ay, getContracts as az, type PostDepositDetailsResponse as b, type GetPayeeDetailsResponse as c, type GetTakerTierRequest as d, type GetTakerTierResponse as e, type PaymentMethodCatalog as f, type Zkp2pClientOptions as g, type TimeoutConfig as h, type CreateDepositConversionRate as i, type ReleaseFundsToPayerParams as j, type CancelIntentParams as k, type QuoteResponse as l, type QuoteResponseObject as m, type QuoteSingleResponse as n, type QuoteIntentResponse as o, type QuoteFeesResponse as p, type FiatResponse as q, type TokenResponse as r, type NearbySuggestions as s, type ApiDeposit as t, type DepositVerifier as u, type DepositVerifierCurrency as v, type DepositStatus as w, type GetOwnerDepositsRequest as x, type GetOwnerDepositsResponse as y, type GetDepositByIdRequest as z };
+export { type RegisterPayeeDetailsRequest as $, type ActionCallback as A, type GetOwnerDepositsRequest as B, type CancelIntentMethodParams as C, type DepositWithRelations as D, type GetOwnerDepositsResponse as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type GetDepositByIdRequest as H, type IntentEntity as I, type GetDepositByIdResponse as J, type Intent as K, type ApiIntentStatus as L, type GetOwnerIntentsRequest as M, type NearbyQuote as N, type GetOwnerIntentsResponse as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type Range as R, type SignalIntentMethodParams as S, type TxOverrides as T, type GetIntentsByDepositRequest as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type GetIntentsByDepositResponse as X, type GetIntentByHashRequest as Y, Zkp2pClient as Z, type GetIntentByHashResponse as _, type ValidatePayeeDetailsResponse as a, type RegisterPayeeDetailsResponse as a0, type OnchainCurrency as a1, type DepositVerifierData as a2, type PreparedTransaction as a3, type OrderStats as a4, type DepositIntentStatistics as a5, type TakerTier as a6, type TakerTierStats as a7, type TakerTierLevel as a8, type PlatformLimit as a9, mapConversionRatesToOnchainMinRate as aA, type CurrencyType as aB, type CurrencyData as aC, getContracts as aD, getPaymentMethodsCatalog as aE, getGatingServiceAddress as aF, type RuntimeEnv as aG, parseDepositView as aH, parseIntentView as aI, enrichPvDepositView as aJ, enrichPvIntentView as aK, type PV_DepositView as aL, type PV_Deposit as aM, type PV_PaymentMethodData as aN, type PV_Currency as aO, type PV_IntentView as aP, type PV_Intent as aQ, type PlatformRiskLevel as aa, IndexerClient as ab, defaultIndexerEndpoint as ac, IndexerDepositService as ad, fetchFulfillmentAndPayment as ae, type DepositEntity as af, type IntentFulfilledEntity as ag, type DepositPaymentMethodEntity as ah, type MethodCurrencyEntity as ai, type IntentStatus as aj, type DepositFilter as ak, type PaginationOptions as al, type DepositOrderField as am, type OrderDirection as an, type DeploymentEnv as ao, type FulfillmentRecord as ap, type PaymentVerifiedRecord as aq, type FulfillmentAndPaymentResponse as ar, PAYMENT_PLATFORMS as as, type PaymentPlatformType as at, Currency as au, currencyInfo as av, getCurrencyInfoFromHash as aw, getCurrencyInfoFromCountryCode as ax, getCurrencyCodeFromHash as ay, isSupportedCurrencyHash as az, type PostDepositDetailsResponse as b, type GetPayeeDetailsResponse as c, type GetTakerTierRequest as d, type GetTakerTierResponse as e, type PaymentMethodCatalog as f, type Zkp2pClientOptions as g, type TimeoutConfig as h, type CreateDepositParams as i, type CreateDepositConversionRate as j, type SignalIntentParams as k, type FulfillIntentParams as l, type ReleaseFundsToPayerParams as m, type CancelIntentParams as n, type QuoteResponse as o, type QuoteResponseObject as p, type QuoteSingleResponse as q, type QuoteIntentResponse as r, type QuoteFeesResponse as s, type FiatResponse as t, type TokenResponse as u, type NearbySuggestions as v, type ApiDeposit as w, type DepositVerifier as x, type DepositVerifierCurrency as y, type DepositStatus as z };

package/dist/{chunk-P3NOBRQB.mjs → chunk-ARFGMPYS.mjs}

@@ -174,5 +174,5 @@ function resolvePlatformAttestationConfig(platformName) {
 }
 
 export { DEFAULT_BASE_API_URL, DEFAULT_WITNESS_URL, DEPLOYED_ADDRESSES, PAYMENT_PLATFORMS, PLATFORM_ATTESTATION_CONFIG, PLATFORM_METADATA, SUPPORTED_CHAIN_IDS, TOKEN_METADATA, resolvePlatformAttestationConfig };
-//# sourceMappingURL=chunk-P3NOBRQB.mjs.map
-//# sourceMappingURL=chunk-P3NOBRQB.mjs.map
+//# sourceMappingURL=chunk-ARFGMPYS.mjs.map
+//# sourceMappingURL=chunk-ARFGMPYS.mjs.map