@zkp2p/sdk 0.9.0 → 0.10.0-rc.1

package/README.md

@@ -80,7 +80,7 @@ const client = new Zkp2pClient({
 - `indexerUrl` and `baseApiUrl`: override defaults when you are targeting custom deployments
 - `timeouts`: `{ api?: number }` — API timeout in milliseconds (default 15000)
 
-**No external API key is required.** `createDeposit`, `registerPayeeDetails`, `getQuote`, `getTakerTier`, `signalIntent`, and the rest of the public SDK flows work without `apiKey` or `authorizationToken`. When `baseApiUrl` is configured, `signalIntent()` can auto-fetch a gating service signature from curator `/v3/intent/sign` without auth. Quote responses include resolved maker payee details (`offchainId`, `telegramUsername`, `metadata`) when curator has them.
+**No external API key is required.** `createDeposit`, `registerPayeeDetails`, `getQuote`, `signalIntent`, and the rest of the public SDK flows work without `apiKey` or `authorizationToken`. When `baseApiUrl` is configured, `signalIntent()` can auto-fetch a gating service signature from curator `/v3/intent/sign` without auth. Quote responses include resolved maker payee details (`offchainId`, `telegramUsername`, `metadata`) when curator has them.
 
 Indexer defaults by environment:
 
@@ -94,16 +94,18 @@ Indexer defaults by environment:
 | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Deposits                       | `createDeposit`, `addFunds`, `removeFunds`, `withdrawDeposit`, `ensureAllowance`, `setAcceptingIntents`, `setIntentRange`, `setCurrencyMinRate`, `setRetainOnEmpty`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Payment methods and currencies | `addPaymentMethods`, `removePaymentMethod`, `setPaymentMethodActive`, `addCurrencies`, `removeCurrency`, `deactivateCurrency`, `pruneExpiredIntents`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| Intents                        | `signalIntent`, `fulfillIntent`, `cancelIntent`, `releaseFundsToPayer`, `getFulfillIntentInputs`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| Intents                        | `signalIntent`, `fulfillIntent`, `cancelIntent`, `releaseFundsToPayer`, `getFulfillIntentInputs`, including explicit staging OrchestratorV3 routing                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Prepared transactions          | `client.prepareCreateDeposit(...)`, `client.signalIntent.prepare(...)`, `client.fulfillIntent.prepare(...)`, `client.setVaultFee.prepare(...)`, and equivalent prepare flows across the rest of the prepareable write surface                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| Payee and quote APIs           | `registerPayeeDetails`, `resolvePayeeHash`, `getQuote`, `getQuotesBestByPlatform`, `getTakerTier`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| Payee and quote APIs           | `registerPayeeDetails`, `resolvePayeeHash`, `getQuote`, `getQuotesBestByPlatform`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | Seller automated release       | `uploadSellerCredential`, `getSellerCredentialStatus`, `verifySellerPayment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | Delegation and hooks           | `setDelegate`, `removeDelegate`, `setRateManager`, `clearRateManager`, `setDepositRateManager`, `clearDepositRateManager`, `setDepositPreIntentHook`, `setDepositWhitelistHook`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | Vault / DRM                    | `createRateManager`, `setVaultMinRate`, `setVaultMinRatesBatch`, `setVaultFee`, `setVaultConfig`, `getDepositRateManager`, `getManagerFee`, `getEffectiveRate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| Taker staking                  | `ensureStakeAllowance`, `depositStake`, `depositStakeFor`, partial withdrawal and full-exit methods, stake-owner permission methods, direct StakeVault reads, and exact risk-capacity math                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| V3 settlement operations       | `releaseMaturedPositions`, `reconcileSettlement(s)`, `reconcileCancellation(s)`, OrchestratorV3 intent prepares, and exported settlement event ABIs                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Oracle config                  | `setOracleRateConfig`, `setOracleRateConfigBatch`, `removeOracleRateConfig`, `updateCurrencyConfigBatch`, `deactivateCurrenciesBatch`, `supportsInlineOracleRateConfig`, `validateOracleFeedsOnChain`                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | RPC reads                      | `getDeposits`, `getDeposit`, `getDepositsById`, `getIntents`, `getIntent`, `getPvDepositById`, `getPvDepositsFromIds`, `getPvAccountDeposits`, `getPvAccountIntents`, `getPvIntent`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Indexer                        | `client.indexer.getDeposits`, `getDepositsWithRelations`, `getDepositById`, `getDepositsByIds`, `getDepositsByIdsWithRelations`, `getDepositsByPayeeHash`, `getIntentsForDeposits`, `getOwnerIntents`, `getIntentsByRateManager`, `getIntentByHash`, `getExpiredIntents`, `getFulfilledIntentEvents`, `getIntentFulfillmentAmounts`, `getFulfillmentAndPayment`, `getDepositFundActivities`, `getMakerFundActivities`, `getDepositDailySnapshots`, `getProfitSnapshotsByDeposits`, `getRateManagers`, `getRateManagerDetail`, `getRateManagerDelegations`, `getDelegationForDeposit`, `getManagerDailySnapshots`, `getManualRateUpdates`, `getOracleConfigUpdates`, `query` |
-| React hooks                    | `@zkp2p/sdk/react` exports hooks for deposits, intents, delegation, vaults, payment methods, and taker tier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| React hooks                    | `@zkp2p/sdk/react` exports hooks for deposits, intents, delegation, vaults, and payment methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | Attribution                    | ERC-8021 helpers like `sendTransactionWithAttribution`, `encodeWithAttribution`, and `txOverrides.referrer` support                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 
 ## Extension Metadata Bridge
@@ -180,7 +182,7 @@ console.log(result.depositDetails);
 
 If you do not pass `payeeDetailsHashes`, `createDeposit()` can register the payee details for you. If you want to pre-register or reuse hashes across deposits, use `registerPayeeDetails()` first.
 
-## Payee Registration, Quotes, and Taker Tier
+## Payee Registration and Quotes
 
 ```ts
 import { resolvePaymentMethodHash } from '@zkp2p/sdk';
@@ -212,18 +214,81 @@ const quote = await client.getQuote({
   isExactFiat: true,
 });
 
-const takerTier = await client.getTakerTier({
-  owner: '0xBuyer',
-  chainId: 8453,
-});
-
 const payeeHash = await client.resolvePayeeHash(
   42n,
   resolvePaymentMethodHash('wise', { env: 'production' }),
 );
 ```
 
-`getQuote()` returns available liquidity plus payee details when authenticated. Use `getQuotesBestByPlatform()` to fetch the best quote per supported payment platform in a single call (handy for cross-platform comparison UIs). `getTakerTier()` returns limits, cooldown data, Peer Pay volume progression, and `volumeBreakdown` rows for taker UX.
+`getQuote()` returns available liquidity plus payee details when authenticated. Use `getQuotesBestByPlatform()` to fetch the best quote per supported payment platform in a single call (handy for cross-platform comparison UIs). Quotes do not reserve or filter by OrchestratorV3 stake capacity; fetch the configured Curator environment's capacity view separately and treat on-chain admission as final.
+
+## Taker Stake & Capacity
+
+```ts
+const amount = 250_000000n;
+const approval = await client.ensureStakeAllowance({ amount });
+// Wait for approval.hash to confirm when hadAllowance is false.
+
+await client.depositStake({ amount });
+// Or prepare for a smart account/relayer:
+const prepared = await client.depositStakeFor.prepare({
+  taker: delegatedTakerAddress,
+  amount,
+});
+
+const stake = await client.getTakerStake({ owner: takerAddress, chainId: 8453 });
+// stake.responseObject.balances: stakedUsdc, pendingWithdrawalUsdc, eligibleUsdc,
+// reservedUsdc (locked), freeUsdc — each { raw, formatted } in 6-decimal base units.
+
+const capacity = await client.getTakerCapacity({ owner: takerAddress, chainId: 8453 });
+// capacity.responseObject.platforms[]: bondedTakingCapacity, freeTakes, griefing and
+// chargeback curve terms, warnings; operationalGates carries pause state.
+
+const onchain = await client.getStakeVaultState({
+  staker: stakeOwnerAddress,
+  taker: takerAddress,
+});
+```
+
+Stake writes expose direct and `.prepare()` variants: `depositStake`,
+`depositStakeFor`, `requestStakeWithdrawal`, `cancelStakeWithdrawal`,
+`withdrawRequestedStake`, `requestExit`, `cancelExit`, `withdrawStake`,
+`setStakeDelegationEnabled`, `setAllowedStakeOwner`, and `clearStakeOwner`.
+StakeVault is currently staging-only; SDK contract resolution fails closed in
+production/preproduction until a deployment exists.
+
+The same staging deployment exposes OrchestratorV3 and RiskManager through
+`getDeployedAddresses()`, `getOrchestratorV3Contract()`, and
+`getRiskManagerContract()`. Route an intent explicitly by passing
+`orchestratorAddress: client.getDeployedAddresses().orchestratorV3`.
+OrchestratorV3 signals are ungated: the SDK encodes an empty gating signature
+and zero expiration without calling the curator signing endpoint. Existing
+OrchestratorV2 signaling remains gated.
+
+Keeper writes are direct and prepareable:
+
+```ts
+const sweep = await client.releaseMaturedPositions.prepare({
+  intentHashes: [intentHash],
+});
+const settlement = await client.reconcileSettlement.prepare({ intentHash });
+const cancellations = await client.reconcileCancellations.prepare({
+  intentHashes: [intentHash],
+});
+```
+
+For receipt classification, import `RISK_POSITION_SETTLED_EVENT_ABI` and
+`DEFERRED_PAYOUT_RECORDED_EVENT_ABI` and pass them to viem's
+`decodeEventLog()`.
+
+`getTakerStake()` and `getTakerCapacity()` wrap curator
+`GET /v2/taker/stake` and `GET /v2/taker/capacity`, the hard replacement for
+the removed `/v2/taker/tier` endpoint. Platform capacities are alternative
+views of one shared stake-owner portfolio — never sum them, and never filter
+quotes by capacity. Free takes are separate whole intents (at most
+`amountPerTakeUsdc` each) and cannot be combined with bonded capacity.
+Capacity can change whenever any authorized relayer uses the shared stake, so
+refetch immediately before signaling; the contract stays authoritative.
 
 For table-style liquidity UIs, the low-level `apiGetOrderbookTable()` adapter exposes curator's paginated public/private orderbook rows and row-level privacy metadata.
 
@@ -626,14 +691,12 @@ import {
   useSignalIntent,
   useCreateVault,
   useVaultDelegation,
-  useGetTakerTier,
 } from '@zkp2p/sdk/react';
 
 const createDeposit = useCreateDeposit({ client });
 const signalIntent = useSignalIntent({ client });
 const createVault = useCreateVault({ client, sendTransaction });
 const vaultDelegation = useVaultDelegation({ client, sendTransaction, sendBatch });
-const takerTier = useGetTakerTier({ client, owner, chainId, autoFetch: true });
 ```
 
 Hook groups:
@@ -643,7 +706,7 @@ Hook groups:
 - Intent lifecycle: `useSignalIntent`, `useFulfillIntent`, `useReleaseFundsToPayer`, `usePruneExpiredIntents`
 - Delegation: `useSetDelegate`, `useRemoveDelegate`
 - Vault / DRM: `useCreateVault`, `useVaultDelegation`, `useSetVaultFee`, `useSetVaultMinRate`, `useSetVaultConfig`
-- Taker tier: `useGetTakerTier`, plus `getTierDisplayInfo()` and `getNextTierCap()` helpers
+- Taker stake and capacity: `useGetTakerStake`, `useGetTakerCapacity`
 
 `useVaultDelegation()` is the batching-oriented hook. It returns `delegateDeposit`, `delegateDeposits`, `clearDelegation`, and `clearDelegations`.
 
@@ -651,15 +714,23 @@ Hook groups:
 
 ```ts
 import {
+  DEFERRED_PAYOUT_RECORDED_EVENT_ABI,
   getContracts,
+  getOrchestratorV3Contract,
   getPaymentMethodsCatalog,
   getRateManagerContracts,
+  getRiskManagerContract,
+  getStakeVaultContract,
+  RISK_POSITION_SETTLED_EVENT_ABI,
   resolveFiatCurrencyBytes32,
   resolvePaymentMethodHash,
 } from '@zkp2p/sdk';
 
 const contracts = getContracts(8453, 'production');
 const rateManagerContracts = getRateManagerContracts(8453, 'production');
+const stakeVault = getStakeVaultContract(8453, 'staging');
+const orchestratorV3 = getOrchestratorV3Contract(8453, 'staging');
+const riskManager = getRiskManagerContract(8453, 'staging');
 const paymentMethods = getPaymentMethodsCatalog(8453, 'production');
 const usdHash = resolveFiatCurrencyBytes32('USD');
 const wiseHash = resolvePaymentMethodHash('wise', { env: 'production' });

package/dist/{chunk-EIOXBVXP.mjs → chunk-LPJE2MN7.mjs}

@@ -1,39 +1,3 @@
-// src/takerTiers.ts
-var TAKER_TIER_SCHEDULE = [
-  { tier: "PLATINUM", perIntentCapUsd: 5e3, minVolumeUsd: 1e5, maxVolumeUsd: Infinity },
-  { tier: "PRO", perIntentCapUsd: 2500, minVolumeUsd: 5e4, maxVolumeUsd: 99999 },
-  { tier: "PLUS", perIntentCapUsd: 1e3, minVolumeUsd: 1e4, maxVolumeUsd: 49999 },
-  { tier: "PEER", perIntentCapUsd: 250, minVolumeUsd: 1e3, maxVolumeUsd: 9999 },
-  { tier: "PEASANT", perIntentCapUsd: 100, minVolumeUsd: 0, maxVolumeUsd: 999 }
-];
-var TAKER_TIER_ORDER = [
-  "PEASANT",
-  "PEER",
-  "PLUS",
-  "PRO",
-  "PLATINUM"
-];
-var TAKER_TIER_CAPS = Object.fromEntries(
-  TAKER_TIER_SCHEDULE.map((entry) => [entry.tier, entry.perIntentCapUsd])
-);
-var TAKER_TIER_FEE_DISCOUNT_BPS = {
-  PEASANT: 0,
-  PEER: 5,
-  PLUS: 10,
-  PRO: 20,
-  PLATINUM: 30
-};
-function getTakerTierFeeDiscountBps(tier) {
-  if (!tier) return 0;
-  return TAKER_TIER_FEE_DISCOUNT_BPS[tier] ?? 0;
-}
-function getNextTakerTier(currentTier) {
-  if (!currentTier) return null;
-  const index = TAKER_TIER_ORDER.indexOf(currentTier);
-  if (index === -1 || index >= TAKER_TIER_ORDER.length - 1) return null;
-  return TAKER_TIER_ORDER[index + 1];
-}
-
 // src/react/hooks/vaultUtils.ts
 var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 var ZERO_RATE_MANAGER_ID = "0x0000000000000000000000000000000000000000000000000000000000000000";
@@ -106,6 +70,6 @@ var prepareSetDelegationTx = async (client, params, referrer) => {
   });
 };
 
-export { TAKER_TIER_CAPS, TAKER_TIER_FEE_DISCOUNT_BPS, TAKER_TIER_ORDER, TAKER_TIER_SCHEDULE, ZERO_ADDRESS, ZERO_RATE_MANAGER_ID, asErrorMessage, assertAtomicDelegationSwitchSupport, assertDelegationMethodSupport, classifyDelegationState, getDelegationRoute, getNextTakerTier, getTakerTierFeeDiscountBps, isZeroRateManagerId, normalizeRateManagerId, normalizeRegistry, prepareClearDelegationTx, prepareSetDelegationTx };
-//# sourceMappingURL=chunk-EIOXBVXP.mjs.map
-//# sourceMappingURL=chunk-EIOXBVXP.mjs.map
+export { ZERO_ADDRESS, ZERO_RATE_MANAGER_ID, asErrorMessage, assertAtomicDelegationSwitchSupport, assertDelegationMethodSupport, classifyDelegationState, getDelegationRoute, isZeroRateManagerId, normalizeRateManagerId, normalizeRegistry, prepareClearDelegationTx, prepareSetDelegationTx };
+//# sourceMappingURL=chunk-LPJE2MN7.mjs.map
+//# sourceMappingURL=chunk-LPJE2MN7.mjs.map

package/dist/chunk-LPJE2MN7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/hooks/vaultUtils.ts"],"names":[],"mappings":"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","file":"chunk-LPJE2MN7.mjs","sourcesContent":["import type { Address, Hex } from 'viem';\nimport type { PreparedTransaction } from '../../types/prepared';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000' as const;\nexport const ZERO_RATE_MANAGER_ID =\n  '0x0000000000000000000000000000000000000000000000000000000000000000' as const;\n\n// ---------------------------------------------------------------------------\n// Normalizers\n// ---------------------------------------------------------------------------\n\nexport const normalizeRateManagerId = (value?: string | null): string =>\n  (value ?? ZERO_RATE_MANAGER_ID).toLowerCase();\n\nexport const normalizeRegistry = (value?: string | null): string =>\n  (value ?? ZERO_ADDRESS).toLowerCase();\n\nexport const isZeroRateManagerId = (value?: string | null): boolean => {\n  if (!value) return true;\n  const normalized = value.toLowerCase();\n  return normalized === ZERO_ADDRESS || normalized === ZERO_RATE_MANAGER_ID;\n};\n\n// ---------------------------------------------------------------------------\n// Error helper\n// ---------------------------------------------------------------------------\n\nexport const asErrorMessage = (error: unknown): string => {\n  if (!error) return 'Unknown error';\n  if (error instanceof Error) return error.message;\n  if (typeof error === 'string') return error;\n\n  const anyErr = error as Record<string, unknown>;\n  if (typeof anyErr.shortMessage === 'string') return anyErr.shortMessage;\n  if (typeof anyErr.details === 'string') return anyErr.details;\n  if (typeof anyErr.message === 'string') return anyErr.message;\n\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Delegation state classification\n// ---------------------------------------------------------------------------\n\nexport type DelegationState = 'delegated_here' | 'delegated_elsewhere' | 'not_delegated';\n\n/**\n * Classify whether a deposit is delegated to the target vault, delegated\n * elsewhere, or not delegated at all.\n *\n * @param currentRateManagerId    The deposit's current rateManagerId (from indexer)\n * @param currentRegistry         The deposit's current rateManagerAddress / registry (from indexer)\n * @param targetRateManagerId     The vault's rateManagerId we're comparing against\n * @param targetRegistry          The vault's registry address we're comparing against\n */\nexport const classifyDelegationState = (\n  currentRateManagerId: string | null | undefined,\n  currentRegistry: string | null | undefined,\n  targetRateManagerId: string,\n  targetRegistry: string | null | undefined,\n): DelegationState => {\n  if (isZeroRateManagerId(currentRateManagerId)) {\n    return 'not_delegated';\n  }\n\n  const normalizedCurrent = normalizeRateManagerId(currentRateManagerId);\n  const normalizedTarget = targetRateManagerId.toLowerCase();\n  const normalizedCurrentRegistry = normalizeRegistry(currentRegistry);\n  const normalizedTargetRegistry = targetRegistry ? targetRegistry.toLowerCase() : '';\n\n  const idsMatch = normalizedCurrent === normalizedTarget;\n  const registryMatches = normalizedTargetRegistry\n    ? normalizedCurrentRegistry === normalizedTargetRegistry\n    : true;\n\n  if (idsMatch && registryMatches) {\n    return 'delegated_here';\n  }\n\n  return 'delegated_elsewhere';\n};\n\nexport const assertAtomicDelegationSwitchSupport = (\n  requiresSwitch: boolean,\n  canBatch: boolean,\n): void => {\n  if (!requiresSwitch || canBatch) return;\n  throw new Error(\n    'Switching delegation targets requires smart-account batching. Clear the existing delegation first.',\n  );\n};\n\n// ---------------------------------------------------------------------------\n// Contract routing\n// ---------------------------------------------------------------------------\n\nexport type DelegationRoute = 'v2';\n\nexport const getDelegationRoute = (_client: unknown, _escrow: Address): DelegationRoute => 'v2';\n\ntype DelegationMethodSupportClient = Partial<\n  Record<'setRateManager' | 'clearRateManager', { prepare?: unknown }>\n>;\n\nexport const assertDelegationMethodSupport = (\n  client: DelegationMethodSupportClient,\n  _route: DelegationRoute,\n  action: 'set' | 'clear',\n): void => {\n  const method = action === 'set' ? 'setRateManager' : 'clearRateManager';\n  if (client?.[method]?.prepare) return;\n  throw new Error(`Delegation requires SDK ${method} support`);\n};\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface DelegationDepositTarget {\n  compositeDepositId: string;\n  escrow: Address;\n  depositId: bigint;\n  currentRateManagerId?: string | null;\n  currentRateManagerRegistry?: string | null;\n}\n\nexport interface BatchResult {\n  hashes: string[];\n  failed: Array<{ compositeDepositId: string; error: string }>;\n}\n\n/**\n * Callback the consumer provides for sending a single prepared transaction.\n * Returns the transaction hash.\n */\nexport type SendTransactionFn = (tx: { to: Address; data: Hex; value?: bigint }) => Promise<string>;\n\n/**\n * Optional callback for batching multiple calls in a single user operation\n * (e.g. via a smart account). If not provided, transactions are sent\n * sequentially via sendTransaction.\n */\nexport type SendBatchFn = (\n  txs: Array<{ to: Address; data: Hex; value?: bigint }>,\n) => Promise<string>;\n\n// ---------------------------------------------------------------------------\n// Prepare helpers (used internally by hooks)\n// ---------------------------------------------------------------------------\n\nexport const prepareClearDelegationTx = async (\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client: any,\n  params: { escrow: Address; depositId: bigint },\n  referrer?: string | string[],\n): Promise<PreparedTransaction> => {\n  const route = getDelegationRoute(client, params.escrow);\n  assertDelegationMethodSupport(client, route, 'clear');\n  return client.clearRateManager.prepare({\n    escrowAddress: params.escrow,\n    depositId: params.depositId,\n    ...(referrer ? { txOverrides: { referrer } } : {}),\n  });\n};\n\nexport const prepareSetDelegationTx = async (\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client: any,\n  params: {\n    escrow: Address;\n    depositId: bigint;\n    registry: Address;\n    rateManagerId: Hex;\n  },\n  referrer?: string | string[],\n): Promise<PreparedTransaction> => {\n  const route = getDelegationRoute(client, params.escrow);\n  assertDelegationMethodSupport(client, route, 'set');\n  return client.setRateManager.prepare({\n    escrowAddress: params.escrow,\n    depositId: params.depositId,\n    rateManagerAddress: params.registry,\n    rateManagerId: params.rateManagerId,\n    ...(referrer ? { txOverrides: { referrer } } : {}),\n  });\n};\n"]}