@zkp2p/sdk 0.0.5 → 0.0.6

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { D as DepositWithRelations, I as IntentEntity, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetTakerTierRequest, e as GetTakerTierResponse, f as PaymentMethodCatalog, T as TxOverrides } from './Zkp2pClient-CIMGTCFg.mjs';
-export { A as ActionCallback, t as ApiDeposit, H as ApiIntentStatus, k as CancelIntentParams, i as CreateDepositConversionRate, C as CreateDepositParams, aq as Currency, ay as CurrencyData, ax as CurrencyType, aI as Deposit, aK as DepositCurrency, a1 as DepositIntentStatistics, w as DepositStatus, u as DepositVerifier, v as DepositVerifierCurrency, $ as DepositVerifierData, aH as DepositView, q as FiatResponse, F as FulfillIntentParams, z as GetDepositByIdRequest, B as GetDepositByIdResponse, O as GetIntentByHashRequest, U as GetIntentByHashResponse, L as GetIntentsByDepositRequest, M as GetIntentsByDepositResponse, x as GetOwnerDepositsRequest, y as GetOwnerDepositsResponse, J as GetOwnerIntentsRequest, K as GetOwnerIntentsResponse, a7 as IndexerClient, ak as IndexerDeploymentEnv, ab as IndexerDeposit, ag as IndexerDepositFilter, aj as IndexerDepositOrderDirection, ai as IndexerDepositOrderField, ah as IndexerDepositPagination, ad as IndexerDepositPaymentMethod, a9 as IndexerDepositService, an as IndexerFulfillmentAndPaymentResponse, al as IndexerFulfillmentRecord, ac as IndexerIntentFulfilled, af as IndexerIntentStatus, ae as IndexerMethodCurrency, am as IndexerPaymentVerifiedRecord, E as Intent, aL as IntentView, N as NearbyQuote, s as NearbySuggestions, Z as OfframpClient, _ as OnchainCurrency, aM as OnchainIntent, a0 as OrderStats, ao as PAYMENT_PLATFORMS, aJ as PaymentMethodData, ap as PaymentPlatformType, a5 as PlatformLimit, a6 as PlatformRiskLevel, p as QuoteFeesResponse, o as QuoteIntentResponse, Q as QuoteRequest, l as QuoteResponse, m as QuoteResponseObject, n as QuoteSingleResponse, R as Range, X as RegisterPayeeDetailsRequest, Y as RegisterPayeeDetailsResponse, j as ReleaseFundsToPayerParams, aC as RuntimeEnv, S as SignalIntentParams, a2 as TakerTier, a4 as TakerTierLevel, a3 as TakerTierStats, h as TimeoutConfig, r as TokenResponse, W as WithdrawDepositParams, Z as Zkp2pClient, g as Zkp2pClientOptions, ar as currencyInfo, a8 as defaultIndexerEndpoint, aF as enrichPvDepositView, aG as enrichPvIntentView, aa as fetchIndexerFulfillmentAndPayment, az as getContracts, au as getCurrencyCodeFromHash, at as getCurrencyInfoFromCountryCode, as as getCurrencyInfoFromHash, aB as getGatingServiceAddress, aA as getPaymentMethodsCatalog, av as isSupportedCurrencyHash, aw as mapConversionRatesToOnchainMinRate, aD as parseDepositView, aE as parseIntentView } from './Zkp2pClient-CIMGTCFg.mjs';
+import { D as DepositWithRelations, I as IntentEntity, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetTakerTierRequest, e as GetTakerTierResponse, f as PaymentMethodCatalog, T as TxOverrides } from './Zkp2pClient-D-eU4dxy.mjs';
+export { A as ActionCallback, w as ApiDeposit, L as ApiIntentStatus, C as CancelIntentMethodParams, n as CancelIntentParams, j as CreateDepositConversionRate, i as CreateDepositParams, au as Currency, aC as CurrencyData, aB as CurrencyType, aM as Deposit, aO as DepositCurrency, a5 as DepositIntentStatistics, z as DepositStatus, x as DepositVerifier, y as DepositVerifierCurrency, a2 as DepositVerifierData, aL as DepositView, t as FiatResponse, F as FulfillIntentMethodParams, l as FulfillIntentParams, H as GetDepositByIdRequest, J as GetDepositByIdResponse, Y as GetIntentByHashRequest, _ as GetIntentByHashResponse, U as GetIntentsByDepositRequest, X as GetIntentsByDepositResponse, B as GetOwnerDepositsRequest, E as GetOwnerDepositsResponse, M as GetOwnerIntentsRequest, O as GetOwnerIntentsResponse, ab as IndexerClient, ao as IndexerDeploymentEnv, af as IndexerDeposit, ak as IndexerDepositFilter, an as IndexerDepositOrderDirection, am as IndexerDepositOrderField, al as IndexerDepositPagination, ah as IndexerDepositPaymentMethod, ad as IndexerDepositService, ar as IndexerFulfillmentAndPaymentResponse, ap as IndexerFulfillmentRecord, ag as IndexerIntentFulfilled, aj as IndexerIntentStatus, ai as IndexerMethodCurrency, aq as IndexerPaymentVerifiedRecord, K as Intent, aP as IntentView, N as NearbyQuote, v as NearbySuggestions, Z as OfframpClient, a1 as OnchainCurrency, aQ as OnchainIntent, a4 as OrderStats, as as PAYMENT_PLATFORMS, aN as PaymentMethodData, at as PaymentPlatformType, a9 as PlatformLimit, aa as PlatformRiskLevel, a3 as PreparedTransaction, s as QuoteFeesResponse, r as QuoteIntentResponse, Q as QuoteRequest, o as QuoteResponse, p as QuoteResponseObject, q as QuoteSingleResponse, R as Range, $ as RegisterPayeeDetailsRequest, a0 as RegisterPayeeDetailsResponse, m as ReleaseFundsToPayerParams, aG as RuntimeEnv, S as SignalIntentMethodParams, k as SignalIntentParams, a6 as TakerTier, a8 as TakerTierLevel, a7 as TakerTierStats, h as TimeoutConfig, u as TokenResponse, W as WithdrawDepositParams, Z as Zkp2pClient, g as Zkp2pClientOptions, av as currencyInfo, ac as defaultIndexerEndpoint, aJ as enrichPvDepositView, aK as enrichPvIntentView, ae as fetchIndexerFulfillmentAndPayment, aD as getContracts, ay as getCurrencyCodeFromHash, ax as getCurrencyInfoFromCountryCode, aw as getCurrencyInfoFromHash, aF as getGatingServiceAddress, aE as getPaymentMethodsCatalog, az as isSupportedCurrencyHash, aA as mapConversionRatesToOnchainMinRate, aH as parseDepositView, aI as parseIntentView } from './Zkp2pClient-D-eU4dxy.mjs';
 import { Abi } from 'abitype';
 import { Hex, WalletClient, Hash } from 'viem';
 
@@ -312,6 +312,30 @@ declare function getAttributionDataSuffix(referrer?: string | string[]): Hex;
  * @returns Calldata with attribution suffix appended
  */
 declare function appendAttributionToCalldata(calldata: Hex, referrer?: string | string[]): Hex;
+/**
+ * Encode a contract call with ERC-8021 attribution suffix.
+ *
+ * This function encodes function data and appends the attribution suffix
+ * without sending the transaction. Use this when you need the calldata
+ * for relayer submission or inspection.
+ *
+ * @param request - The request with abi, functionName, args
+ * @param referrer - Optional referrer code(s) to prepend before the base builder code
+ * @returns Encoded calldata with attribution suffix
+ *
+ * @example
+ * ```typescript
+ * const calldata = encodeWithAttribution({
+ *   abi: escrowAbi,
+ *   functionName: 'signalIntent',
+ *   args: [intentParams],
+ * }, 'zkp2p-ios');
+ *
+ * // Submit via relayer
+ * await relayer.submit({ to: escrowAddress, data: calldata });
+ * ```
+ */
+declare function encodeWithAttribution(request: Pick<AttributionRequest, 'abi' | 'functionName' | 'args'>, referrer?: string | string[]): Hex;
 /**
  * Request parameters for sendTransactionWithAttribution
  */
@@ -432,4 +456,4 @@ declare class ContractError extends ZKP2PError {
     constructor(message: string, details?: unknown);
 }
 
-export { APIError, BASE_BUILDER_CODE, ContractError, ErrorCode, type EscrowDepositView, type EscrowIntentView, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, NetworkError, PLATFORM_METADATA, PaymentMethodCatalog, PostDepositDetailsRequest, PostDepositDetailsResponse, SUPPORTED_CHAIN_IDS, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, ensureBytes32, getAttributionDataSuffix, logger, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel };
+export { APIError, BASE_BUILDER_CODE, ContractError, ErrorCode, type EscrowDepositView, type EscrowIntentView, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, NetworkError, PLATFORM_METADATA, PaymentMethodCatalog, PostDepositDetailsRequest, PostDepositDetailsResponse, SUPPORTED_CHAIN_IDS, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, logger, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DepositWithRelations, I as IntentEntity, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetTakerTierRequest, e as GetTakerTierResponse, f as PaymentMethodCatalog, T as TxOverrides } from './Zkp2pClient-CIMGTCFg.js';
-export { A as ActionCallback, t as ApiDeposit, H as ApiIntentStatus, k as CancelIntentParams, i as CreateDepositConversionRate, C as CreateDepositParams, aq as Currency, ay as CurrencyData, ax as CurrencyType, aI as Deposit, aK as DepositCurrency, a1 as DepositIntentStatistics, w as DepositStatus, u as DepositVerifier, v as DepositVerifierCurrency, $ as DepositVerifierData, aH as DepositView, q as FiatResponse, F as FulfillIntentParams, z as GetDepositByIdRequest, B as GetDepositByIdResponse, O as GetIntentByHashRequest, U as GetIntentByHashResponse, L as GetIntentsByDepositRequest, M as GetIntentsByDepositResponse, x as GetOwnerDepositsRequest, y as GetOwnerDepositsResponse, J as GetOwnerIntentsRequest, K as GetOwnerIntentsResponse, a7 as IndexerClient, ak as IndexerDeploymentEnv, ab as IndexerDeposit, ag as IndexerDepositFilter, aj as IndexerDepositOrderDirection, ai as IndexerDepositOrderField, ah as IndexerDepositPagination, ad as IndexerDepositPaymentMethod, a9 as IndexerDepositService, an as IndexerFulfillmentAndPaymentResponse, al as IndexerFulfillmentRecord, ac as IndexerIntentFulfilled, af as IndexerIntentStatus, ae as IndexerMethodCurrency, am as IndexerPaymentVerifiedRecord, E as Intent, aL as IntentView, N as NearbyQuote, s as NearbySuggestions, Z as OfframpClient, _ as OnchainCurrency, aM as OnchainIntent, a0 as OrderStats, ao as PAYMENT_PLATFORMS, aJ as PaymentMethodData, ap as PaymentPlatformType, a5 as PlatformLimit, a6 as PlatformRiskLevel, p as QuoteFeesResponse, o as QuoteIntentResponse, Q as QuoteRequest, l as QuoteResponse, m as QuoteResponseObject, n as QuoteSingleResponse, R as Range, X as RegisterPayeeDetailsRequest, Y as RegisterPayeeDetailsResponse, j as ReleaseFundsToPayerParams, aC as RuntimeEnv, S as SignalIntentParams, a2 as TakerTier, a4 as TakerTierLevel, a3 as TakerTierStats, h as TimeoutConfig, r as TokenResponse, W as WithdrawDepositParams, Z as Zkp2pClient, g as Zkp2pClientOptions, ar as currencyInfo, a8 as defaultIndexerEndpoint, aF as enrichPvDepositView, aG as enrichPvIntentView, aa as fetchIndexerFulfillmentAndPayment, az as getContracts, au as getCurrencyCodeFromHash, at as getCurrencyInfoFromCountryCode, as as getCurrencyInfoFromHash, aB as getGatingServiceAddress, aA as getPaymentMethodsCatalog, av as isSupportedCurrencyHash, aw as mapConversionRatesToOnchainMinRate, aD as parseDepositView, aE as parseIntentView } from './Zkp2pClient-CIMGTCFg.js';
+import { D as DepositWithRelations, I as IntentEntity, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetTakerTierRequest, e as GetTakerTierResponse, f as PaymentMethodCatalog, T as TxOverrides } from './Zkp2pClient-D-eU4dxy.js';
+export { A as ActionCallback, w as ApiDeposit, L as ApiIntentStatus, C as CancelIntentMethodParams, n as CancelIntentParams, j as CreateDepositConversionRate, i as CreateDepositParams, au as Currency, aC as CurrencyData, aB as CurrencyType, aM as Deposit, aO as DepositCurrency, a5 as DepositIntentStatistics, z as DepositStatus, x as DepositVerifier, y as DepositVerifierCurrency, a2 as DepositVerifierData, aL as DepositView, t as FiatResponse, F as FulfillIntentMethodParams, l as FulfillIntentParams, H as GetDepositByIdRequest, J as GetDepositByIdResponse, Y as GetIntentByHashRequest, _ as GetIntentByHashResponse, U as GetIntentsByDepositRequest, X as GetIntentsByDepositResponse, B as GetOwnerDepositsRequest, E as GetOwnerDepositsResponse, M as GetOwnerIntentsRequest, O as GetOwnerIntentsResponse, ab as IndexerClient, ao as IndexerDeploymentEnv, af as IndexerDeposit, ak as IndexerDepositFilter, an as IndexerDepositOrderDirection, am as IndexerDepositOrderField, al as IndexerDepositPagination, ah as IndexerDepositPaymentMethod, ad as IndexerDepositService, ar as IndexerFulfillmentAndPaymentResponse, ap as IndexerFulfillmentRecord, ag as IndexerIntentFulfilled, aj as IndexerIntentStatus, ai as IndexerMethodCurrency, aq as IndexerPaymentVerifiedRecord, K as Intent, aP as IntentView, N as NearbyQuote, v as NearbySuggestions, Z as OfframpClient, a1 as OnchainCurrency, aQ as OnchainIntent, a4 as OrderStats, as as PAYMENT_PLATFORMS, aN as PaymentMethodData, at as PaymentPlatformType, a9 as PlatformLimit, aa as PlatformRiskLevel, a3 as PreparedTransaction, s as QuoteFeesResponse, r as QuoteIntentResponse, Q as QuoteRequest, o as QuoteResponse, p as QuoteResponseObject, q as QuoteSingleResponse, R as Range, $ as RegisterPayeeDetailsRequest, a0 as RegisterPayeeDetailsResponse, m as ReleaseFundsToPayerParams, aG as RuntimeEnv, S as SignalIntentMethodParams, k as SignalIntentParams, a6 as TakerTier, a8 as TakerTierLevel, a7 as TakerTierStats, h as TimeoutConfig, u as TokenResponse, W as WithdrawDepositParams, Z as Zkp2pClient, g as Zkp2pClientOptions, av as currencyInfo, ac as defaultIndexerEndpoint, aJ as enrichPvDepositView, aK as enrichPvIntentView, ae as fetchIndexerFulfillmentAndPayment, aD as getContracts, ay as getCurrencyCodeFromHash, ax as getCurrencyInfoFromCountryCode, aw as getCurrencyInfoFromHash, aF as getGatingServiceAddress, aE as getPaymentMethodsCatalog, az as isSupportedCurrencyHash, aA as mapConversionRatesToOnchainMinRate, aH as parseDepositView, aI as parseIntentView } from './Zkp2pClient-D-eU4dxy.js';
 import { Abi } from 'abitype';
 import { Hex, WalletClient, Hash } from 'viem';
 
@@ -312,6 +312,30 @@ declare function getAttributionDataSuffix(referrer?: string | string[]): Hex;
  * @returns Calldata with attribution suffix appended
  */
 declare function appendAttributionToCalldata(calldata: Hex, referrer?: string | string[]): Hex;
+/**
+ * Encode a contract call with ERC-8021 attribution suffix.
+ *
+ * This function encodes function data and appends the attribution suffix
+ * without sending the transaction. Use this when you need the calldata
+ * for relayer submission or inspection.
+ *
+ * @param request - The request with abi, functionName, args
+ * @param referrer - Optional referrer code(s) to prepend before the base builder code
+ * @returns Encoded calldata with attribution suffix
+ *
+ * @example
+ * ```typescript
+ * const calldata = encodeWithAttribution({
+ *   abi: escrowAbi,
+ *   functionName: 'signalIntent',
+ *   args: [intentParams],
+ * }, 'zkp2p-ios');
+ *
+ * // Submit via relayer
+ * await relayer.submit({ to: escrowAddress, data: calldata });
+ * ```
+ */
+declare function encodeWithAttribution(request: Pick<AttributionRequest, 'abi' | 'functionName' | 'args'>, referrer?: string | string[]): Hex;
 /**
  * Request parameters for sendTransactionWithAttribution
  */
@@ -432,4 +456,4 @@ declare class ContractError extends ZKP2PError {
     constructor(message: string, details?: unknown);
 }
 
-export { APIError, BASE_BUILDER_CODE, ContractError, ErrorCode, type EscrowDepositView, type EscrowIntentView, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, NetworkError, PLATFORM_METADATA, PaymentMethodCatalog, PostDepositDetailsRequest, PostDepositDetailsResponse, SUPPORTED_CHAIN_IDS, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, ensureBytes32, getAttributionDataSuffix, logger, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel };
+export { APIError, BASE_BUILDER_CODE, ContractError, ErrorCode, type EscrowDepositView, type EscrowIntentView, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, NetworkError, PLATFORM_METADATA, PaymentMethodCatalog, PostDepositDetailsRequest, PostDepositDetailsResponse, SUPPORTED_CHAIN_IDS, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, logger, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel };

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { ValidationError, APIError, NetworkError } from './chunk-GHQK65J2.mjs';
 export { APIError, ContractError, ErrorCode, NetworkError, ValidationError, ZKP2PError } from './chunk-GHQK65J2.mjs';
-export { PAYMENT_PLATFORMS, PLATFORM_METADATA, SUPPORTED_CHAIN_IDS, TOKEN_METADATA } from './chunk-P3NOBRQB.mjs';
+export { PAYMENT_PLATFORMS, PLATFORM_METADATA, SUPPORTED_CHAIN_IDS, TOKEN_METADATA } from './chunk-ARFGMPYS.mjs';
 import { getContracts, getPaymentMethodsCatalog, getGatingServiceAddress } from './chunk-PYEJ4L76.mjs';
 export { enrichPvDepositView, enrichPvIntentView, getContracts, getGatingServiceAddress, getPaymentMethodsCatalog, parseDepositView, parseIntentView } from './chunk-PYEJ4L76.mjs';
 import { resolvePaymentMethodHashFromCatalog, resolveFiatCurrencyBytes32 } from './chunk-GDKCACWH.mjs';
@@ -884,6 +884,14 @@ function appendAttributionToCalldata(calldata, referrer) {
   const suffix = getAttributionDataSuffix(referrer);
   return concatHex([calldata, suffix]);
 }
+function encodeWithAttribution(request, referrer) {
+  const functionData = encodeFunctionData({
+    abi: request.abi,
+    functionName: request.functionName,
+    args: request.args || []
+  });
+  return appendAttributionToCalldata(functionData, referrer);
+}
 async function sendTransactionWithAttribution(walletClient, request, referrer, overrides) {
   const functionData = encodeFunctionData({
     abi: request.abi,
@@ -929,6 +937,201 @@ var Zkp2pClient = class {
    * @throws Error if walletClient is missing an account
    */
   constructor(opts) {
+    // ───────────────────────────────────────────────────────────────────────────
+    // SUPPORTING: INTENT OPERATIONS
+    // (Used by takers/buyers - not primary SDK functionality)
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * **Supporting Method** - Signals intent to use a deposit.
+     *
+     * > **Note**: This method is typically used by takers/buyers who want to
+     * > purchase crypto by paying fiat. Liquidity providers generally don't
+     * > need to call this method directly.
+     *
+     * This reserves funds from a deposit and creates an intent that must be
+     * fulfilled (via `fulfillIntent`) or will expire. The taker commits to
+     * sending fiat payment to the deposit's payee.
+     *
+     * 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
+     * @param params.processorName - Payment platform (e.g., 'wise', 'revolut')
+     * @param params.payeeDetails - Hashed payee details (from deposit)
+     * @param params.fiatCurrencyCode - Fiat currency code (e.g., 'USD', 'EUR')
+     * @param params.conversionRate - Agreed conversion rate (18 decimals)
+     * @param params.referrer - Optional referrer address for fee sharing
+     * @param params.referrerFee - Optional referrer fee amount
+     * @param params.postIntentHook - Optional hook contract to call after signaling
+     * @param params.data - Optional data to pass to the hook
+     * @param params.gatingServiceSignature - Pre-obtained signature (if not auto-fetching)
+     * @param params.signatureExpiration - Signature expiration timestamp
+     * @param params.txOverrides - Optional viem transaction overrides
+     * @returns Transaction hash
+     *
+     * @example
+     * ```typescript
+     * // Execute directly
+     * const hash = await client.signalIntent({
+     *   depositId: 42n,
+     *   amount: 100_000000n, // 100 USDC
+     *   toAddress: '0x...',
+     *   processorName: 'wise',
+     *   payeeDetails: '0x...',
+     *   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
+     * ```
+     */
+    this.signalIntent = Object.assign(
+      async (params) => {
+        const prepared = await this.prepareSignalIntent(params);
+        return this.executePreparedTransaction(prepared, params.txOverrides);
+      },
+      {
+        prepare: async (params) => {
+          const prepared = await this.prepareSignalIntent(params);
+          return {
+            to: prepared.to,
+            data: prepared.data,
+            value: prepared.value,
+            chainId: prepared.chainId
+          };
+        }
+      }
+    );
+    /**
+     * **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...' });
+     * ```
+     */
+    this.cancelIntent = Object.assign(
+      async (params) => {
+        const prepared = await this.prepareCancelIntent(params);
+        return this.executePreparedTransaction(prepared, params.txOverrides);
+      },
+      {
+        prepare: async (params) => {
+          const prepared = await this.prepareCancelIntent(params);
+          return {
+            to: prepared.to,
+            data: prepared.data,
+            value: prepared.value,
+            chainId: prepared.chainId
+          };
+        }
+      }
+    );
+    /**
+     * **Supporting Method** - Fulfills an intent by submitting a payment proof.
+     *
+     * > **Note**: This method is typically used by takers/buyers after they've
+     * > sent fiat payment. Liquidity providers generally don't call this directly.
+     *
+     * This is the final step in the off-ramp flow. After the taker has sent
+     * fiat payment, they generate a proof (via the browser extension) and
+     * submit it here. The SDK handles attestation service calls automatically.
+     *
+     * **Flow:**
+     * 1. Intent parameters are derived from the indexer/ProtocolViewer
+     * 2. Proof is sent to the attestation service for verification
+     * 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)
+     * @param params.attestationServiceUrl - Override attestation service URL
+     * @param params.verifyingContract - Override verifier contract address
+     * @param params.postIntentHookData - Data to pass to post-intent hook
+     * @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
+     * ```
+     */
+    this.fulfillIntent = Object.assign(
+      async (params) => {
+        params?.callbacks?.onAttestationStart?.();
+        const prepared = await this.prepareFulfillIntent(params);
+        const txHash = await this.executePreparedTransaction(prepared, params.txOverrides);
+        params?.callbacks?.onTxSent?.(txHash);
+        return txHash;
+      },
+      {
+        prepare: async (params) => {
+          params?.callbacks?.onAttestationStart?.();
+          const prepared = await this.prepareFulfillIntent(params);
+          return {
+            to: prepared.to,
+            data: prepared.data,
+            value: prepared.value,
+            chainId: prepared.chainId
+          };
+        }
+      }
+    );
     this.walletClient = opts.walletClient;
     this.chainId = opts.chainId;
     this.runtimeEnv = opts.runtimeEnv ?? "production";
@@ -991,6 +1194,29 @@ var Zkp2pClient = class {
       txOverrides
     );
   }
+  /**
+   * Execute a prepared transaction (simulation + send).
+   * Used internally by prepareable methods after preparation.
+   */
+  async executePreparedTransaction(prepared, txOverrides) {
+    const { referrer, ...overrides } = txOverrides ?? {};
+    await this.publicClient.simulateContract({
+      address: prepared.to,
+      abi: prepared.abi,
+      functionName: prepared.functionName,
+      args: prepared.args,
+      account: this.walletClient.account,
+      ...overrides
+    });
+    return this.walletClient.sendTransaction({
+      to: prepared.to,
+      data: prepared.data,
+      value: prepared.value,
+      account: this.walletClient.account,
+      chain: this.walletClient.chain,
+      ...overrides
+    });
+  }
   // ╔═══════════════════════════════════════════════════════════════════════════╗
   // ║ CORE: DEPOSIT QUERIES (RPC-first via ProtocolViewer)                     ║
   // ╚═══════════════════════════════════════════════════════════════════════════╝
@@ -1654,54 +1880,11 @@ var Zkp2pClient = class {
       txOverrides: params.txOverrides
     });
   }
-  // ───────────────────────────────────────────────────────────────────────────
-  // SUPPORTING: INTENT OPERATIONS
-  // (Used by takers/buyers - not primary SDK functionality)
-  // ───────────────────────────────────────────────────────────────────────────
   /**
-   * **Supporting Method** - Signals intent to use a deposit.
-   *
-   * > **Note**: This method is typically used by takers/buyers who want to
-   * > purchase crypto by paying fiat. Liquidity providers generally don't
-   * > need to call this method directly.
-   *
-   * This reserves funds from a deposit and creates an intent that must be
-   * fulfilled (via `fulfillIntent`) or will expire. The taker commits to
-   * sending fiat payment to the deposit's payee.
-   *
-   * If `gatingServiceSignature` is not provided, the SDK will automatically
-   * fetch one from the API (requires `apiKey` or `authorizationToken`).
-   *
-   * @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
-   * @param params.processorName - Payment platform (e.g., 'wise', 'revolut')
-   * @param params.payeeDetails - Hashed payee details (from deposit)
-   * @param params.fiatCurrencyCode - Fiat currency code (e.g., 'USD', 'EUR')
-   * @param params.conversionRate - Agreed conversion rate (18 decimals)
-   * @param params.referrer - Optional referrer address for fee sharing
-   * @param params.referrerFee - Optional referrer fee amount
-   * @param params.postIntentHook - Optional hook contract to call after signaling
-   * @param params.data - Optional data to pass to the hook
-   * @param params.gatingServiceSignature - Pre-obtained signature (if not auto-fetching)
-   * @param params.signatureExpiration - Signature expiration timestamp
-   * @param params.txOverrides - Optional viem transaction overrides
-   * @returns Transaction hash
-   *
-   * @example
-   * ```typescript
-   * const hash = await client.signalIntent({
-   *   depositId: 42n,
-   *   amount: 100_000000n, // 100 USDC
-   *   toAddress: '0x...',
-   *   processorName: 'wise',
-   *   payeeDetails: '0x...',
-   *   fiatCurrencyCode: 'USD',
-   *   conversionRate: 1_020000000000000000n, // 1.02
-   * });
-   * ```
+   * Prepare signalIntent transaction (all logic except simulation/send).
+   * Returns the prepared transaction with encoded calldata.
    */
-  async signalIntent(params) {
+  async prepareSignalIntent(params) {
     if (!this.orchestratorAddress || !this.orchestratorAbi) throw new Error("Orchestrator not available");
     const catalog = getPaymentMethodsCatalog(this.chainId, this.runtimeEnv);
     const paymentMethod = resolvePaymentMethodHashFromCatalog(params.processorName, catalog);
@@ -1747,32 +1930,49 @@ var Zkp2pClient = class {
       postIntentHook: params.postIntentHook ?? "0x0000000000000000000000000000000000000000",
       data: params.data ?? "0x"
     }];
-    return this.simulateAndSendWithAttribution({
-      address: this.orchestratorAddress,
+    const { referrer } = params.txOverrides ?? {};
+    const data = encodeWithAttribution(
+      {
+        abi: this.orchestratorAbi,
+        functionName: "signalIntent",
+        args
+      },
+      referrer
+    );
+    return {
+      to: this.orchestratorAddress,
+      data,
+      value: 0n,
+      chainId: this.chainId,
       abi: this.orchestratorAbi,
       functionName: "signalIntent",
-      args,
-      txOverrides: params.txOverrides
-    });
+      args
+    };
   }
   /**
-   * **Supporting Method** - Cancels a signaled intent before fulfillment.
-   *
-   * Only the intent owner can cancel. Releases reserved funds back to the deposit.
-   *
-   * @param params.intentHash - The intent hash to cancel (0x-prefixed, 32 bytes)
-   * @param params.txOverrides - Optional viem transaction overrides
-   * @returns Transaction hash
+   * Prepare cancelIntent transaction (all logic except simulation/send).
    */
-  async cancelIntent(params) {
+  async prepareCancelIntent(params) {
     if (!this.orchestratorAddress || !this.orchestratorAbi) throw new Error("Orchestrator not available");
-    return this.simulateAndSendWithAttribution({
-      address: this.orchestratorAddress,
+    const args = [params.intentHash];
+    const { referrer } = params.txOverrides ?? {};
+    const data = encodeWithAttribution(
+      {
+        abi: this.orchestratorAbi,
+        functionName: "cancelIntent",
+        args
+      },
+      referrer
+    );
+    return {
+      to: this.orchestratorAddress,
+      data,
+      value: 0n,
+      chainId: this.chainId,
       abi: this.orchestratorAbi,
       functionName: "cancelIntent",
-      args: [params.intentHash],
-      txOverrides: params.txOverrides
-    });
+      args
+    };
   }
   /**
    * **Supporting Method** - Releases funds back to the deposit owner.
@@ -1795,32 +1995,10 @@ var Zkp2pClient = class {
     });
   }
   /**
-   * **Supporting Method** - Fulfills an intent by submitting a payment proof.
-   *
-   * > **Note**: This method is typically used by takers/buyers after they've
-   * > sent fiat payment. Liquidity providers generally don't call this directly.
-   *
-   * This is the final step in the off-ramp flow. After the taker has sent
-   * fiat payment, they generate a proof (via the browser extension) and
-   * submit it here. The SDK handles attestation service calls automatically.
-   *
-   * **Flow:**
-   * 1. Intent parameters are derived from the indexer/ProtocolViewer
-   * 2. Proof is sent to the attestation service for verification
-   * 3. Attestation response is encoded and submitted on-chain
-   * 4. Funds are released to the intent's `toAddress`
-   *
-   * @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)
-   * @param params.attestationServiceUrl - Override attestation service URL
-   * @param params.verifyingContract - Override verifier contract address
-   * @param params.postIntentHookData - Data to pass to post-intent hook
-   * @param params.txOverrides - Optional viem transaction overrides
-   * @param params.callbacks - Lifecycle callbacks for UI updates
-   * @returns Transaction hash
+   * Prepare fulfillIntent transaction (all logic except simulation/send).
+   * Includes fetching intent inputs and calling attestation service.
    */
-  async fulfillIntent(params) {
+  async prepareFulfillIntent(params) {
     if (!this.orchestratorAddress || !this.orchestratorAbi) throw new Error("Orchestrator not available");
     const intentHash = params.intentHash;
     const attUrl = params.attestationServiceUrl ?? this.defaultAttestationService();
@@ -1837,7 +2015,7 @@ var Zkp2pClient = class {
     const { resolvePaymentMethodNameFromHash: resolvePaymentMethodNameFromHash2 } = await import('./paymentResolution-4AAJVIIC.mjs');
     const platformName = resolvePaymentMethodNameFromHash2(paymentMethodHash, catalog);
     if (!platformName) throw new Error("Unknown paymentMethodHash for this network/env; update SDK catalogs.");
-    const { resolvePlatformAttestationConfig } = await import('./constants-Y2IWTA6H.mjs');
+    const { resolvePlatformAttestationConfig } = await import('./constants-MQB4AQDD.mjs');
     const cfg = resolvePlatformAttestationConfig(platformName);
     const platform = cfg.actionPlatform;
     const actionType = cfg.actionType;
@@ -1858,7 +2036,6 @@ var Zkp2pClient = class {
         timestampBufferMs
       }
     };
-    params?.callbacks?.onAttestationStart?.();
     const att = await apiCreatePaymentAttestation(payload, attUrl, platform, actionType);
     const paymentProof = encodePaymentAttestation(att);
     const verificationData = encodeVerifyPaymentData({
@@ -1872,15 +2049,24 @@ var Zkp2pClient = class {
       verificationData,
       postIntentHookData: params.postIntentHookData ?? "0x"
     }];
-    const txHash = await this.simulateAndSendWithAttribution({
-      address: this.orchestratorAddress,
+    const { referrer } = params.txOverrides ?? {};
+    const data = encodeWithAttribution(
+      {
+        abi: this.orchestratorAbi,
+        functionName: "fulfillIntent",
+        args
+      },
+      referrer
+    );
+    return {
+      to: this.orchestratorAddress,
+      data,
+      value: 0n,
+      chainId: this.chainId,
       abi: this.orchestratorAbi,
       functionName: "fulfillIntent",
-      args,
-      txOverrides: params.txOverrides
-    });
-    params?.callbacks?.onTxSent?.(txHash);
-    return txHash;
+      args
+    };
   }
   defaultAttestationService() {
     return this.runtimeEnv === "staging" ? "https://attestation-service-staging.zkp2p.xyz" : "https://attestation-service.zkp2p.xyz";
@@ -2220,6 +2406,6 @@ var logger = {
   }
 };
 
-export { BASE_BUILDER_CODE, IndexerClient, IndexerDepositService, Zkp2pClient as OfframpClient, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, Zkp2pClient, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, defaultIndexerEndpoint, fetchFulfillmentAndPayment as fetchIndexerFulfillmentAndPayment, getAttributionDataSuffix, logger, sendTransactionWithAttribution, setLogLevel };
+export { BASE_BUILDER_CODE, IndexerClient, IndexerDepositService, Zkp2pClient as OfframpClient, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, Zkp2pClient, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, defaultIndexerEndpoint, encodeWithAttribution, fetchFulfillmentAndPayment as fetchIndexerFulfillmentAndPayment, getAttributionDataSuffix, logger, sendTransactionWithAttribution, setLogLevel };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map