@zkp2p/sdk 0.8.1 → 0.10.0-rc.0

package/dist/{vaultUtils-BGDsoxAv.d.mts → vaultUtils-DtkWNsxi.d.mts}

@@ -54,6 +54,8 @@ type V2ContractAddresses = {
     chainlinkOracleAdapter?: `0x${string}`;
     /** PythOracleAdapter contract */
     pythOracleAdapter?: `0x${string}`;
+    /** StakeVault contract for taker stake and delegation */
+    stakeVault?: `0x${string}`;
 };
 /**
  * Contract ABIs for a specific deployment.
@@ -70,6 +72,7 @@ type V2ContractAbis = {
     orchestratorRegistry?: Abi;
     rateManagerRegistry?: Abi;
     rateManagerController?: Abi;
+    stakeVault?: Abi;
 };
 /**
  * Runtime environment: 'production' for mainnet, 'preproduction' for preprod
@@ -145,6 +148,17 @@ declare function getRateManagerContracts(chainId: number, env?: RuntimeEnv): {
         controller?: Abi;
     };
 };
+/**
+ * Resolve the user-facing StakeVault contract for a deployment.
+ *
+ * Throws when the environment has no StakeVault deployment so callers fail
+ * closed instead of accidentally targeting another environment.
+ */
+declare function getStakeVaultContract(chainId: number, env?: RuntimeEnv): {
+    address: `0x${string}`;
+    abi: Abi;
+    stakeToken: `0x${string}`;
+};
 
 /**
  * Minimal fetch-based GraphQL client for the ZKP2P indexer.
@@ -1555,111 +1569,198 @@ type OrderStats = {
 };
 /** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type DepositIntentStatistics = OrderStats;
-type TakerTierStats = {
-    lifetimeSignaledCount: number;
-    lifetimeFulfilledCount: number;
-    lifetimeManualReleaseCount: number;
-    lifetimePruneCount: number;
-    totalCancelledVolume: string;
-    totalFulfilledVolume: string;
-    lockScore: string;
-    lockScoreDiluted: string;
-    firstSeenAt: string;
-    lastIntentAt: string;
-    updatedAt: string;
-};
-type TakerTierLevel = 'PEASANT' | 'PEER' | 'PLUS' | 'PRO' | 'PLATINUM';
-type PlatformRiskLevel = 'LOW' | 'MEDIUM_HIGH' | 'HIGH' | 'HIGHEST';
-type PlatformLimit = {
+type UsdcAmount = {
+    /** USDC base units (6 decimals), stringified integer. */
+    raw: string;
+    /** Display decimal (e.g. "1250" or "0.059792"). */
+    formatted: string;
+};
+type TakerStakeAsset = {
+    symbol: 'USDC';
+    decimals: 6;
+};
+type TakerDelegation = {
+    /** True when the taker's intents are backed by another owner's stake. */
+    isDelegated: boolean;
+    taker: string;
+    stakeOwner: string;
+};
+type TakerStakeBalances = {
+    /** Total USDC held for the stake owner. */
+    stakedUsdc: UsdcAmount;
+    /** Requested for withdrawal; already excluded from reservation eligibility. */
+    pendingWithdrawalUsdc: UsdcAmount;
+    /** Stake remaining after the pending partial removal. */
+    eligibleUsdc: UsdcAmount;
+    /** Authoritative StakeVault reservation total (locked, not spent). */
+    reservedUsdc: UsdcAmount;
+    /** Stake available to support new bonded activity. */
+    freeUsdc: UsdcAmount;
+};
+type TakerStakeExit = {
+    exiting: boolean;
+    requestedAt: string | null;
+    availableAt: string | null;
+};
+type StakeReservationKind = 'pending_intent' | 'chargeback_coverage';
+type StakeReservation = {
+    id: string;
+    intentId: string;
     paymentMethodHash: string;
     platformName: string;
-    /** Legacy risk category. Current curator cap-grid responses omit this. */
-    riskLevel?: PlatformRiskLevel;
-    /** Legacy multiplier. Current curator cap-grid responses omit this. */
-    capMultiplier?: number;
-    effectiveCap: string;
-    effectiveCapDisplay: string;
-    hasCooldown: boolean;
-    cooldownHours: number;
-    isLocked: boolean;
-    minTierRequired: TakerTierLevel | null;
-    /**
-     * Whether the rail is chargeback-reversible. Reversible rails backed by a
-     * seller-automated-release (SAR) credential are takeable only through Peer
-     * Pay, so the intent-sign path rejects them with "peer pay only". Optional:
-     * older curator deployments (current prod) omit this field.
-     */
-    reversible?: boolean;
-};
-type TakerTierVolumeBreakdown = {
-    platformName: string;
+    kind: StakeReservationKind;
+    reservedUsdc: UsdcAmount;
+    coverageExpiresAt: string | null;
+};
+type StakeReservations = {
+    activeCount: number;
+    /** Aggregate maximum griefing/initial reservations for pending positions. */
+    pendingIntentUsdc: UsdcAmount;
+    /** Active, non-matured post-settlement chargeback coverage. */
+    chargebackCoverageUsdc: UsdcAmount;
+    totalReservedUsdc: UsdcAmount;
+    /**
+     * Forward-compatible per-reservation detail; intentionally empty in the
+     * initial API. `balances.reservedUsdc` stays authoritative — never
+     * reconstruct it from the category aggregates above.
+     */
+    items: StakeReservation[];
+};
+type TakerStake = {
+    /** Requested taker address. */
+    owner: string;
+    chainId: number;
+    /** Resolved stake owner; differs from `owner` when stake is delegated. */
+    stakeOwner: string;
+    asset: TakerStakeAsset;
+    delegation: TakerDelegation;
+    balances: TakerStakeBalances;
+    reservations: StakeReservations;
+    exit: TakerStakeExit;
+    source: 'indexer';
+    updatedAt: string | null;
+};
+type GetTakerStakeRequest = {
+    owner: string;
+    chainId: number;
+};
+type GetTakerStakeResponse = {
+    success: boolean;
+    message: string;
+    responseObject: TakerStake;
+    statusCode?: number;
+};
+type CapacityWarningCode = 'ADMISSION_PAUSED' | 'STAKE_RESERVATIONS_PAUSED' | 'STAKE_DEPOSITS_PAUSED' | 'PLATFORM_DISABLED' | 'NO_BONDED_CAPACITY' | 'UNLIMITED_BONDED_CAPACITY' | 'FREE_TAKES_AVAILABLE' | 'FREE_TAKES_EXHAUSTED' | 'PARTIAL_CHARGEBACK_COVERAGE' | 'UNPROTECTED_AFTER_CHARGEBACK_WINDOW' | 'DEFERRED_PAYOUT_AVAILABLE' | 'GRIEFING_BOND_DISABLED' | 'STAKE_EXIT_PENDING' | 'SHARED_STAKE_PORTFOLIO';
+type CapacityWarningSeverity = 'info' | 'warning' | 'error';
+type CapacityWarning = {
+    /** Stable machine-readable code; key behavior and analytics off this. */
+    code: CapacityWarningCode;
+    severity: CapacityWarningSeverity;
+    message: string;
+};
+/** `amountUsdc: null` only with `unlimited: true` (curve does not constrain). */
+type CurveTakingCapacity = {
+    amountUsdc: UsdcAmount;
+    unlimited: false;
+} | {
+    amountUsdc: null;
+    unlimited: true;
+};
+type LimitingCurve = 'griefing' | 'chargeback' | 'both' | 'none';
+type BondedTakingCapacity = {
+    amountUsdc: UsdcAmount;
+    unlimited: false;
+    limitingCurve: LimitingCurve;
+} | {
+    amountUsdc: null;
+    unlimited: true;
+    limitingCurve: 'none';
+};
+type PlatformFreeTakes = {
+    eligible: boolean;
+    configuredCount: number;
+    usedCount: number;
+    remainingCount: number;
+    /** Per-intent maximum for each whole free take. */
+    amountPerTakeUsdc: UsdcAmount;
+    /**
+     * Display total only. Free allowances are separate whole intents; they can
+     * never be combined with each other or with bonded capacity in one intent.
+     */
+    remainingTotalUsdc: UsdcAmount;
+    intentSemantics: 'separate_intents_only';
+};
+type PlatformGriefingCapacity = {
+    enabled: boolean;
+    cliffSeconds: string;
+    penaltyBpsPerHour: string;
+    maximumIntentPeriodSeconds: string;
+    maximumBondForOneUsdc: UsdcAmount;
+    takingCapacity: CurveTakingCapacity;
+};
+type ChargebackCoverageStatus = 'full' | 'partial' | 'none' | 'not_applicable';
+type PlatformChargebackCapacity = {
+    chargebackable: boolean;
+    reserveBps: number;
+    riskWindowSeconds: string;
+    deferredPayoutAvailable: boolean;
+    coverage: {
+        status: ChargebackCoverageStatus;
+        protectedBps: number;
+        uncoveredBps: number;
+        afterWindow: 'uncovered';
+    };
+    takingCapacity: CurveTakingCapacity;
+};
+type PlatformCapacity = {
     paymentMethodHash: string;
-    volumeBaseUnits: string;
-    volumeDisplay: string;
-    multiplierBps: number;
-    weightedVolumeBaseUnits: string;
-    weightedVolumeDisplay: string;
-};
-/** How the curator resolved the taker tier (see curator tier engine). */
-type TakerTierSource = 'computed' | 'fallback' | 'override' | 'blocklist';
-type TakerTier = {
+    platformName: string;
+    enabled: boolean;
+    policyVersion: string | null;
+    /**
+     * Platform capacities are alternative views of one shared stake-owner
+     * portfolio. Never sum capacity across platforms.
+     */
+    stakeScope: 'shared_stake_owner_portfolio';
+    stake: TakerStakeBalances;
+    bondedTakingCapacity: BondedTakingCapacity;
+    freeTakes: PlatformFreeTakes;
+    griefing: PlatformGriefingCapacity;
+    chargeback: PlatformChargebackCapacity;
+    warnings: CapacityWarning[];
+};
+type TakerOperationalGates = {
+    /** Blocks all new admissions. */
+    admissionPaused: boolean;
+    /** Blocks bonded/deferred admissions; eligible zero-reservation free takes remain. */
+    reservationsPaused: boolean;
+    /** Blocks stake top-ups only; capacity from existing stake stays available. */
+    depositsPaused: boolean;
+    bondedAdmissionGateOpen: boolean;
+    zeroReservationFreeAdmissionGateOpen: boolean;
+    stakeTopUpGateOpen: boolean;
+};
+type TakerCapacity = {
     owner: string;
     chainId: number;
-    tier: TakerTierLevel;
-    /** Legacy base cap. Current curator responses expose enforced caps in platformLimits. */
-    perIntentCapBaseUnits?: string;
-    /** Legacy formatted base cap. */
-    perIntentCapDisplay?: string;
-    lastUpdated: string;
-    source: TakerTierSource;
-    stats: TakerTierStats | null;
-    cooldownHours: number;
-    cooldownSeconds: number;
-    cooldownActive: boolean;
-    cooldownRemainingSeconds: number;
-    nextIntentAvailableAt: string | null;
-    /**
-     * Server-authoritative platform cap grid. Use this for enforced caps; do not
-     * derive platform caps from top-level tier caps or risk multipliers.
-     */
-    platformLimits?: PlatformLimit[];
-    /**
-     * Server-authoritative tier fields (curator PR #461/#463/#478 contract). All
-     * optional because the current production deployment still serves the older
-     * payload that omits them — read them when present and fall back gracefully.
-     * Amounts are USDC base-unit strings (6 decimals).
-     */
-    /** Base per-intent cap before platform risk multipliers (alias of perIntentCapBaseUnits). */
-    maxOrderSize?: string;
-    maxOrderSizeDisplay?: string;
-    /** Peer Pay volume floor that qualifies the current tier. */
-    minVolumeForTier?: string;
-    minVolumeForTierDisplay?: string;
-    /** Next tier up the volume ladder, or null at the top / off-ladder tiers. */
-    nextTier?: TakerTierLevel | null;
-    /** Remaining Peer Pay volume to reach `nextTier`. */
-    volumeToNextTier?: string | null;
-    volumeToNextTierDisplay?: string | null;
-    nextTierMaxOrderSize?: string | null;
-    nextTierMaxOrderSizeDisplay?: string | null;
-    /**
-     * Compatibility name retained by curator. Current semantics preserve
-     * historical maker tiers through July 1, 2026 UTC, then add forward Peer Pay
-     * volume only. Present on deployments with the PR #461/#463 progression
-     * contract.
-     */
-    peerPayVolume?: string;
-    /** Auditable tier progression inputs. Current curator may return a synthetic Peer Pay row. */
-    volumeBreakdown?: TakerTierVolumeBreakdown[];
-};
-type GetTakerTierRequest = {
+    stakeOwner: string;
+    asset: TakerStakeAsset;
+    delegation: TakerDelegation;
+    stake: TakerStakeBalances;
+    operationalGates: TakerOperationalGates;
+    platforms: PlatformCapacity[];
+    warnings: CapacityWarning[];
+    source: 'indexer';
+    updatedAt: string | null;
+};
+type GetTakerCapacityRequest = {
     owner: string;
     chainId: number;
 };
-type GetTakerTierResponse = {
+type GetTakerCapacityResponse = {
     success: boolean;
     message: string;
-    responseObject: TakerTier;
+    responseObject: TakerCapacity;
     statusCode?: number;
 };
 type GetDepositBundleParams = DepositBundleRequest;
@@ -1668,10 +1769,14 @@ type GetOrderbookParams = {
     currency: string;
     paymentPlatform?: string;
     publicOnly?: boolean;
-    sortBy?: 'price' | 'available' | 'limits';
+    sortBy?: 'price' | 'available' | 'limits' | 'apr';
     sortDirection?: 'asc' | 'desc';
     sellerAutomatedRelease?: 'include' | 'exclude' | 'only';
     limit?: number;
+    offset?: number;
+    amount?: string;
+    showSmallOrders?: boolean;
+    hideExtremeSpread?: boolean;
     chainId?: number;
     token?: string;
 };
@@ -1706,6 +1811,53 @@ type GetOrderbookResponse = {
     generatedAt: string;
     entries: OrderbookEntry[];
 };
+type OrderbookTableRow = {
+    depositId: string;
+    depositIdOnContract: string;
+    depositor: string;
+    escrowAddress: string;
+    chainId: number;
+    token: string;
+    paymentPlatform: string;
+    paymentMethodHash: string;
+    payeeDetailsHash: string;
+    currency: string;
+    currencyCode: string;
+    conversionRate: string;
+    takerConversionRate: string;
+    rateManagerId: string | null;
+    availableTokenAmount: string;
+    intentAmountMin: string;
+    intentAmountMax: string;
+    minFiatSupported: string;
+    maxFiatSupported: string;
+    successRateBps: number;
+    feeBps: number;
+    apr: number | null;
+    spread: number | null;
+    sellerAutomatedReleaseAvailable: boolean;
+    sellerAutomatedReleaseEnabled: boolean;
+    isPrivate: boolean;
+    updatedAt: string;
+};
+type GetOrderbookTableResponse = {
+    chainId: number;
+    token: string;
+    currency: string;
+    paymentPlatform: string | null;
+    publicOnly: boolean;
+    sortBy: string;
+    sortDirection: string;
+    sellerAutomatedRelease: 'include' | 'exclude' | 'only';
+    generatedAt: string;
+    pagination: {
+        limit: number;
+        offset: number;
+        total: number;
+        hasMore: boolean;
+    };
+    rows: OrderbookTableRow[];
+};
 
 declare const PAYMENT_PLATFORMS: readonly ["wise", "venmo", "revolut", "cashapp", "mercadopago", "zelle", "paypal", "monzo", "chime", "luxon", "n26"];
 type PaymentPlatformType = (typeof PAYMENT_PLATFORMS)[number];
@@ -1741,6 +1893,63 @@ type UpdateReferralCodeSignatureOptions$1 = ReferralSignatureOptions$1 & {
     oldCode: string;
 };
 
+type StakeVaultWriteFunction = 'depositStake' | 'depositStakeFor' | 'requestStakeWithdrawal' | 'cancelStakeWithdrawal' | 'withdrawRequestedStake' | 'requestExit' | 'cancelExit' | 'withdrawStake' | 'setStakeDelegationEnabled' | 'setAllowedStakeOwner' | 'clearStakeOwner';
+type StakeWriteBase = {
+    txOverrides?: TxOverrides;
+};
+type StakeVaultWriteParams = {
+    depositStake: StakeWriteBase & {
+        amount: bigint;
+    };
+    depositStakeFor: StakeWriteBase & {
+        taker: Address;
+        amount: bigint;
+    };
+    requestStakeWithdrawal: StakeWriteBase & {
+        amount: bigint;
+    };
+    cancelStakeWithdrawal: StakeWriteBase;
+    withdrawRequestedStake: StakeWriteBase & {
+        recipient: Address;
+    };
+    requestExit: StakeWriteBase;
+    cancelExit: StakeWriteBase;
+    withdrawStake: StakeWriteBase & {
+        recipient: Address;
+    };
+    setStakeDelegationEnabled: StakeWriteBase & {
+        enabled: boolean;
+    };
+    setAllowedStakeOwner: StakeWriteBase & {
+        stakeOwner: Address;
+    };
+    clearStakeOwner: StakeWriteBase;
+};
+type StakeWithdrawalRequest = {
+    amount: bigint;
+    requestedAt: bigint;
+    availableAt: bigint;
+};
+type StakeExitRequest = {
+    exiting: boolean;
+    requestedAt: bigint;
+    availableAt: bigint;
+};
+type StakeVaultState = {
+    staker: Address;
+    taker: Address;
+    stakeToken: Address;
+    stakeOwner: Address;
+    allowedStakeOwner: Address;
+    delegationEnabled: boolean;
+    staked: bigint;
+    eligible: bigint;
+    reserved: bigint;
+    free: bigint;
+    withdrawal: StakeWithdrawalRequest;
+    exit: StakeExitRequest;
+};
+
 type PV_ReferralFee = {
     recipient: `0x${string}`;
     fee: bigint;
@@ -2404,6 +2613,10 @@ declare class Zkp2pClient {
     readonly orchestratorRegistryAddress?: Address;
     /** OrchestratorRegistry ABI */
     readonly orchestratorRegistryAbi?: Abi;
+    /** StakeVault address (undefined when staking is not deployed) */
+    readonly stakeVaultAddress?: Address;
+    /** StakeVault ABI */
+    readonly stakeVaultAbi?: Abi;
     /** Base API URL for ZKP2P services */
     readonly baseApiUrl?: string;
     /** Optional internal curator API key (`x-api-key`) for internal seller verification */
@@ -2421,6 +2634,7 @@ declare class Zkp2pClient {
     private readonly _router;
     private readonly _pvReader;
     private readonly _vaultOps;
+    private readonly _stakeOps;
     private readonly _intentOps;
     private readonly _referralOps;
     private _rateManagerInitError?;
@@ -2488,6 +2702,7 @@ declare class Zkp2pClient {
     private prepareResolvedOrchestratorTransaction;
     private prepareContractTransaction;
     private buildContractMethod;
+    private buildStakeVaultMethod;
     private buildEscrowMethod;
     private buildOrchestratorMethod;
     /**
@@ -2790,6 +3005,109 @@ declare class Zkp2pClient {
         hadAllowance: boolean;
         hash?: Hash;
     }>;
+    /**
+     * Return the resolved StakeVault coordinates for advanced wallet, relayer,
+     * or reactive read integrations.
+     */
+    getStakeVaultContract(): {
+        address: Address;
+        abi: Abi;
+        stakeToken: Address;
+    };
+    /**
+     * Ensure the connected wallet has approved enough USDC for StakeVault.
+     * If an approval is submitted, wait for it to confirm before depositing.
+     */
+    ensureStakeAllowance(params: {
+        amount: bigint;
+        maxApprove?: boolean;
+        txOverrides?: TxOverrides;
+    }): Promise<{
+        hadAllowance: boolean;
+        hash?: Hash;
+    }>;
+    /** Deposit USDC stake for the connected taker. */
+    readonly depositStake: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    } & {
+        amount: bigint;
+    }, `0x${string}`>;
+    /** Deposit USDC stake for a different taker that has enabled delegation. */
+    readonly depositStakeFor: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    } & {
+        taker: Address;
+        amount: bigint;
+    }, `0x${string}`>;
+    /** Begin a partial stake-withdrawal delay. */
+    readonly requestStakeWithdrawal: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    } & {
+        amount: bigint;
+    }, `0x${string}`>;
+    /** Cancel the connected staker's pending partial withdrawal. */
+    readonly cancelStakeWithdrawal: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Withdraw a matured partial stake-withdrawal request. */
+    readonly withdrawRequestedStake: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    } & {
+        recipient: Address;
+    }, `0x${string}`>;
+    /** Begin a full exit, blocking new taking activity for the stake owner. */
+    readonly requestExit: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Cancel a pending full exit. */
+    readonly cancelExit: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Withdraw all stake after a matured, fully settled exit. */
+    readonly withdrawStake: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    } & {
+        recipient: Address;
+    }, `0x${string}`>;
+    /** Allow or block third-party stake owners for the connected taker. */
+    readonly setStakeDelegationEnabled: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    } & {
+        enabled: boolean;
+    }, `0x${string}`>;
+    /** Select the stake owner whose portfolio backs the connected taker. */
+    readonly setAllowedStakeOwner: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    } & {
+        stakeOwner: Address;
+    }, `0x${string}`>;
+    /** Remove the connected taker's selected third-party stake owner. */
+    readonly clearStakeOwner: PrepareableMethod<{
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Read total stake owned by an address directly from StakeVault. */
+    getStakeBalance(staker: Address): Promise<bigint>;
+    /** Read stake that currently backs taking capacity. */
+    getEligibleStake(staker: Address): Promise<bigint>;
+    /** Read stake reserved against active intents. */
+    getReservedStake(staker: Address): Promise<bigint>;
+    /** Read stake currently available for withdrawal or new reservations. */
+    getFreeStake(staker: Address): Promise<bigint>;
+    /** Resolve the effective stake owner backing a taker. */
+    getStakeOwner(taker: Address): Promise<Address>;
+    /** Read the stake owner explicitly selected by a taker. */
+    getAllowedStakeOwner(taker: Address): Promise<Address>;
+    /** Read whether a taker allows third-party stake delegation. */
+    getStakeDelegationEnabled(taker: Address): Promise<boolean>;
+    /** Read the connected staker's pending partial withdrawal. */
+    getStakeWithdrawalRequest(staker: Address): Promise<StakeWithdrawalRequest>;
+    /** Read the connected staker's pending full exit. */
+    getStakeExitRequest(staker: Address): Promise<StakeExitRequest>;
+    /** Read the complete authoritative StakeVault state needed by a staking UI. */
+    getStakeVaultState(params: {
+        staker: Address;
+        taker?: Address;
+    }): Promise<StakeVaultState>;
     /**
      * Registers payee details with the curator API and returns hashed on-chain IDs.
      *
@@ -3623,18 +3941,36 @@ declare class Zkp2pClient {
         timeoutMs?: number;
     }): Promise<GetBestByPlatformResponse>;
     /**
-     * **Supporting Method** - Fetches taker tier information for an address.
+     * **Supporting Method** - Fetches the stake portfolio backing a taker:
+     * staked/pending-withdrawal/eligible/reserved/free balances, reservation
+     * aggregates, delegation, and exit state.
+     *
+     * @param req - Stake request parameters
+     * @param req.owner - Taker address (the resolved stake owner may differ)
+     * @param req.chainId - Chain ID
+     * @param opts - Optional overrides for API URL and timeout
+     * @returns Taker stake response
+     */
+    getTakerStake(req: GetTakerStakeRequest, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+    }): Promise<GetTakerStakeResponse>;
+    /**
+     * **Supporting Method** - Fetches per-platform bonded taking capacity, free
+     * takes, curve terms, warnings, and operational gates for a taker's shared
+     * stake portfolio. Platform capacities are alternative views of one shared
+     * balance and must never be summed.
      *
-     * @param req - Taker tier request parameters
-     * @param req.owner - Taker address
+     * @param req - Capacity request parameters
+     * @param req.owner - Taker address (the resolved stake owner may differ)
      * @param req.chainId - Chain ID
      * @param opts - Optional overrides for API URL and timeout
-     * @returns Taker tier response
+     * @returns Taker capacity response
      */
-    getTakerTier(req: GetTakerTierRequest, opts?: {
+    getTakerCapacity(req: GetTakerCapacityRequest, opts?: {
         baseApiUrl?: string;
         timeoutMs?: number;
-    }): Promise<GetTakerTierResponse>;
+    }): Promise<GetTakerCapacityResponse>;
     /**
      * Fetch a referral dashboard. Pass `address` for a public wallet-keyed read;
      * omit it to use the authenticated caller mode.
@@ -3803,6 +4139,7 @@ declare class Zkp2pClient {
         unifiedPaymentVerifier?: Address;
         rateManagerV1?: Address;
         orchestratorRegistry?: Address;
+        stakeVault?: Address;
         usdc?: Address;
     };
     /**
@@ -3887,4 +4224,4 @@ type SendBatchFn = (txs: Array<{
     value?: bigint;
 }>) => Promise<string>;
 
-export { type SignalIntentReferralFee as $, type AttestationServiceIdentityResponse as A, type BuyerTeeVerifyPaymentBody as B, type CuratorSellerCredentialUploadResponse as C, type DepositWithRelations as D, type GetTakerTierRequest as E, type GetTakerTierResponse as F, type GoogleOAuthSellerCredentialPlatform as G, type GetDepositBundleParams as H, type IntentEntity as I, type GetDepositBundleResponse as J, type GetOrderbookParams as K, type GetOrderbookResponse as L, type CurrencyType as M, type PaymentMethodCatalog as N, type TxOverrides as O, type PostDepositDetailsRequest as P, type QuotesBestByPlatformRequest as Q, type ReferrerFeeConfig as R, type SellerCredentialBundle as S, type TakerTierLevel as T, type UploadSellerCredentialBundleParams as U, type ValidatePayeeDetailsRequest as V, type ReferralBearerWriteOptions as W, type ReferralReadOptions as X, type ReferralSignatureOptions as Y, Zkp2pClient as Z, type RedeemReferralCodeSignatureOptions as _, type IdentityAttestationRequestBody as a, type VenmoCredentialUploadInput as a$, type SignalIntentMethodParams as a0, type FulfillIntentMethodParams as a1, type CancelIntentMethodParams as a2, type UpdateReferralCodeSignatureOptions as a3, type Zkp2pNextOptions as a4, type AuthorizationTokenProvider as a5, type TimeoutConfig as a6, type ActionCallback as a7, type ReferralRedemption as a8, type ReferralSignatureBody as a9, type NearbyQuote as aA, type NearbySuggestions as aB, type ApiDeposit as aC, type DepositVerifier as aD, type DepositVerifierCurrency as aE, type DepositStatus$1 as aF, type GetDepositByIdRequest as aG, type GetDepositByIdResponse as aH, type Intent as aI, type ApiIntentStatus as aJ, type GetOwnerIntentsRequest as aK, type GetOwnerIntentsResponse as aL, type GetIntentsByDepositRequest as aM, type GetIntentsByDepositResponse as aN, type GetIntentByHashRequest as aO, type GetIntentByHashResponse as aP, type RegisterPayeeDetailsRequest as aQ, type RegisterPayeeDetailsResponse as aR, type SellerPlatform as aS, type VenmoSessionMaterial as aT, type CashAppSessionMaterial as aU, type WiseSessionMaterial as aV, type WiseProfileInfo as aW, type WiseProfileSelectionRequired as aX, type WiseProfileNotFound as aY, type PayPalGoogleOAuthSellerCredentialUploadBody as aZ, type VenmoGoogleOAuthSellerCredentialUploadBody as a_, type CreateDepositParams as aa, type CreateDepositConversionRate as ab, type Range as ac, type WithdrawDepositParams as ad, type SignalIntentParams as ae, type FulfillIntentParams as af, type ReleaseFundsToPayerParams as ag, type CancelIntentParams as ah, type BestByPlatformResponseObject as ai, type GetBestByPlatformResponse as aj, type GetBestByPlatformResponseObject as ak, type GetPlatformQuote as al, type PlatformQuote as am, type QuoteRequest as an, type GetNearbyQuote as ao, type GetNearbySuggestions as ap, type GetQuoteResponse as aq, type GetQuoteResponseObject as ar, type GetQuoteSingleResponse as as, type QuoteResponse as at, type QuoteResponseObject as au, type QuoteSingleResponse as av, type QuoteIntentResponse as aw, type QuoteFeesResponse as ax, type FiatResponse as ay, type TokenResponse as az, type AttestationServiceSellerVerifyResponse as b, type RateManagerEntity as b$, type CashAppCredentialUploadInput as b0, type WiseCredentialUploadInput as b1, type SellerCredentialUploadInputByPlatform as b2, type SellerCiphertextBundle as b3, type SellerSignedCiphertextBundle as b4, type SellerVerifyIntentDetails as b5, type SellerVerifyInput as b6, type SellerProbeInput as b7, type SellerCredentialBundleUpload as b8, type SellerCredentialStatusValue as b9, type IdentityAttestationParams as bA, type MakerIdentityAttestationRequestBody as bB, type MakerIdentityPlatform as bC, type OnchainCurrency as bD, type DepositVerifierData as bE, type PreparedTransaction as bF, type OrderStats as bG, type DepositIntentStatistics as bH, type TakerTier as bI, type TakerTierVolumeBreakdown as bJ, type TakerTierStats as bK, type TakerTierSource as bL, type PlatformLimit as bM, type PlatformRiskLevel as bN, type OrderbookEntry as bO, IndexerClient as bP, defaultIndexerEndpoint as bQ, IndexerDepositService as bR, IndexerRateManagerService as bS, compareEventCursorIdsByRecency as bT, fetchFulfillmentAndPayment as bU, type DepositEntity as bV, type IntentFulfilledEntity as bW, type IntentFulfillmentAmountsEntity as bX, type DepositPaymentMethodEntity as bY, type MethodCurrencyEntity as bZ, type IntentStatus as b_, type SellerCredentialStatus as ba, type SellerVerifyProxyBody as bb, type SellerTypedDataField as bc, type SellerTypedDataSpec as bd, type SellerPaymentTypedDataValue as be, type SellerAttestationOutput as bf, type SellerCredentialProbeResponse as bg, type FulfillIntentAttestationResponse as bh, type AttestationServiceSellerCredentialProbeResponse as bi, type BuyerTeePaymentParams as bj, type BuyerTeePaymentProofInput as bk, type BuyerTeeSessionMaterial as bl, type CuratorSellerCredentialStatusResponse as bm, type CuratorSellerVerifyResponse as bn, type RegisteredSellerCredentialPlatform as bo, type UploadSellerCredentialParams as bp, type RegisteredUploadSellerCredentialParams as bq, type UploadSellerCredentialOptions as br, type GetSellerCredentialStatusParams as bs, type UploadPayPalGoogleOAuthSellerCredentialParams as bt, type UploadVenmoGoogleOAuthSellerCredentialParams as bu, type UploadGoogleOAuthSellerCredentialParams as bv, type VerifySellerPaymentParams as bw, type IdentityAttestationActionType as bx, type IdentityAttestationOutput as by, type IdentityAttestationOutputFor as bz, type SellerCredentialUploadInput as c, ZERO_ADDRESS as c$, type RateManagerRateEntity as c0, type RateManagerDelegationEntity as c1, type ManagerAggregateStatsEntity as c2, type ManagerStatsEntity as c3, type ManagerDailySnapshotEntity as c4, type RateManagerListItem as c5, type RateManagerDetail as c6, type ManualRateUpdateEntity as c7, type OracleConfigUpdateEntity as c8, type DepositFundActivityEntity as c9, getRateManagerContracts as cA, getPaymentMethodsCatalog as cB, getGatingServiceAddress as cC, type RuntimeEnv as cD, parseDepositView as cE, parseIntentView as cF, enrichPvDepositView as cG, enrichPvIntentView as cH, type PV_DepositView as cI, type PV_Deposit as cJ, type PV_PaymentMethodData as cK, type PV_Currency as cL, type PV_ReferralFee as cM, type PV_IntentView as cN, type PV_Intent as cO, ZERO_RATE_MANAGER_ID as cP, isZeroRateManagerId as cQ, normalizeRateManagerId as cR, normalizeRegistry as cS, getDelegationRoute as cT, classifyDelegationState as cU, type DelegationRoute as cV, type DelegationState as cW, type DelegationDepositTarget as cX, type BatchResult as cY, type SendTransactionFn as cZ, type SendBatchFn as c_, type DepositDailySnapshotEntity as ca, type DepositFundActivityType as cb, type DepositFilter as cc, type PaginationOptions as cd, type DepositOrderField as ce, type OrderDirection$1 as cf, type RateManagerFilter as cg, type RateManagerPaginationOptions as ch, type RateManagerDelegationPaginationOptions as ci, type RateManagerOrderField as cj, type OrderDirection as ck, type DeploymentEnv as cl, type FulfillmentRecord as cm, type PaymentVerifiedRecord as cn, type FulfillmentAndPaymentResponse as co, PAYMENT_PLATFORMS as cp, type PaymentPlatformType as cq, Currency as cr, currencyInfo as cs, getCurrencyInfoFromHash as ct, getCurrencyInfoFromCountryCode as cu, getCurrencyCodeFromHash as cv, isSupportedCurrencyHash as cw, mapConversionRatesToOnchainMinRate as cx, type CurrencyData as cy, getContracts as cz, type SellerCredentialUploadPlatform as d, asErrorMessage as d0, assertDelegationMethodSupport as d1, type SellerCredentialAttestationRuntime as e, type AttestationServiceSellerCredentialUploadResponse as f, type BuyerTeeSessionMaterialEncryptionInput as g, type CreateReferralCodeRequest as h, type ApiAdapterOptions as i, type CreateReferralCodeResponse as j, type ReferralReadRequest as k, type ReferralDashboardResponse as l, type ReferralEarningsResponse as m, type ReferralCodeLookupResponse as n, type RedeemReferralCodeRequest as o, type RedeemReferralCodeResponse as p, type UpdateReferralCodeRequest as q, type UpdateReferralCodeResponse as r, type GoogleOAuthSellerCredentialUploadBodyByPlatform as s, type BestByPlatformResponse as t, type ValidatePayeeDetailsResponse as u, type PostDepositDetailsResponse as v, type GetPayeeDetailsRequest as w, type GetPayeeDetailsResponse as x, type GetOwnerDepositsRequest as y, type GetOwnerDepositsResponse as z };
+export { type ReferralSignatureOptions as $, type AttestationServiceIdentityResponse as A, type BuyerTeeVerifyPaymentBody as B, type CuratorSellerCredentialUploadResponse as C, type DepositWithRelations as D, type GetTakerStakeRequest as E, type GetTakerStakeResponse as F, type GoogleOAuthSellerCredentialPlatform as G, type GetTakerCapacityRequest as H, type IntentEntity as I, type GetTakerCapacityResponse as J, type GetDepositBundleParams as K, type GetDepositBundleResponse as L, type GetOrderbookParams as M, type GetOrderbookResponse as N, type GetOrderbookTableResponse as O, type PostDepositDetailsRequest as P, type QuotesBestByPlatformRequest as Q, type ReferrerFeeConfig as R, type SellerCredentialBundle as S, type CurrencyType as T, type UploadSellerCredentialBundleParams as U, type ValidatePayeeDetailsRequest as V, type PaymentMethodCatalog as W, type TxOverrides as X, type ReferralBearerWriteOptions as Y, Zkp2pClient as Z, type ReferralReadOptions as _, type IdentityAttestationRequestBody as a, type CashAppSessionMaterial as a$, type RedeemReferralCodeSignatureOptions as a0, type SignalIntentReferralFee as a1, type SignalIntentMethodParams as a2, type FulfillIntentMethodParams as a3, type CancelIntentMethodParams as a4, type UpdateReferralCodeSignatureOptions as a5, type Zkp2pNextOptions as a6, type StakeExitRequest as a7, type StakeVaultState as a8, type StakeVaultWriteFunction as a9, type QuoteResponse as aA, type QuoteResponseObject as aB, type QuoteSingleResponse as aC, type QuoteIntentResponse as aD, type QuoteFeesResponse as aE, type FiatResponse as aF, type TokenResponse as aG, type NearbyQuote as aH, type NearbySuggestions as aI, type ApiDeposit as aJ, type DepositVerifier as aK, type DepositVerifierCurrency as aL, type DepositStatus$1 as aM, type GetDepositByIdRequest as aN, type GetDepositByIdResponse as aO, type Intent as aP, type ApiIntentStatus as aQ, type GetOwnerIntentsRequest as aR, type GetOwnerIntentsResponse as aS, type GetIntentsByDepositRequest as aT, type GetIntentsByDepositResponse as aU, type GetIntentByHashRequest as aV, type GetIntentByHashResponse as aW, type RegisterPayeeDetailsRequest as aX, type RegisterPayeeDetailsResponse as aY, type SellerPlatform as aZ, type VenmoSessionMaterial as a_, type StakeVaultWriteParams as aa, type StakeWithdrawalRequest as ab, type AuthorizationTokenProvider as ac, type TimeoutConfig as ad, type ActionCallback as ae, type ReferralRedemption as af, type ReferralSignatureBody as ag, type CreateDepositParams as ah, type CreateDepositConversionRate as ai, type Range as aj, type WithdrawDepositParams as ak, type SignalIntentParams as al, type FulfillIntentParams as am, type ReleaseFundsToPayerParams as an, type CancelIntentParams as ao, type BestByPlatformResponseObject as ap, type GetBestByPlatformResponse as aq, type GetBestByPlatformResponseObject as ar, type GetPlatformQuote as as, type PlatformQuote as at, type QuoteRequest as au, type GetNearbyQuote as av, type GetNearbySuggestions as aw, type GetQuoteResponse as ax, type GetQuoteResponseObject as ay, type GetQuoteSingleResponse as az, type AttestationServiceSellerVerifyResponse as b, type CurveTakingCapacity as b$, type WiseSessionMaterial as b0, type WiseProfileInfo as b1, type WiseProfileSelectionRequired as b2, type WiseProfileNotFound as b3, type PayPalGoogleOAuthSellerCredentialUploadBody as b4, type VenmoGoogleOAuthSellerCredentialUploadBody as b5, type VenmoCredentialUploadInput as b6, type CashAppCredentialUploadInput as b7, type WiseCredentialUploadInput as b8, type SellerCredentialUploadInputByPlatform as b9, type UploadPayPalGoogleOAuthSellerCredentialParams as bA, type UploadVenmoGoogleOAuthSellerCredentialParams as bB, type UploadGoogleOAuthSellerCredentialParams as bC, type VerifySellerPaymentParams as bD, type IdentityAttestationActionType as bE, type IdentityAttestationOutput as bF, type IdentityAttestationOutputFor as bG, type IdentityAttestationParams as bH, type MakerIdentityAttestationRequestBody as bI, type MakerIdentityPlatform as bJ, type OnchainCurrency as bK, type DepositVerifierData as bL, type PreparedTransaction as bM, type OrderStats as bN, type DepositIntentStatistics as bO, type UsdcAmount as bP, type TakerStakeAsset as bQ, type TakerDelegation as bR, type TakerStakeBalances as bS, type TakerStakeExit as bT, type StakeReservationKind as bU, type StakeReservation as bV, type StakeReservations as bW, type TakerStake as bX, type CapacityWarningCode as bY, type CapacityWarningSeverity as bZ, type CapacityWarning as b_, type SellerCiphertextBundle as ba, type SellerSignedCiphertextBundle as bb, type SellerVerifyIntentDetails as bc, type SellerVerifyInput as bd, type SellerProbeInput as be, type SellerCredentialBundleUpload as bf, type SellerCredentialStatusValue as bg, type SellerCredentialStatus as bh, type SellerVerifyProxyBody as bi, type SellerTypedDataField as bj, type SellerTypedDataSpec as bk, type SellerPaymentTypedDataValue as bl, type SellerAttestationOutput as bm, type SellerCredentialProbeResponse as bn, type FulfillIntentAttestationResponse as bo, type AttestationServiceSellerCredentialProbeResponse as bp, type BuyerTeePaymentParams as bq, type BuyerTeePaymentProofInput as br, type BuyerTeeSessionMaterial as bs, type CuratorSellerCredentialStatusResponse as bt, type CuratorSellerVerifyResponse as bu, type RegisteredSellerCredentialPlatform as bv, type UploadSellerCredentialParams as bw, type RegisteredUploadSellerCredentialParams as bx, type UploadSellerCredentialOptions as by, type GetSellerCredentialStatusParams as bz, type SellerCredentialUploadInput as c, getGatingServiceAddress as c$, type LimitingCurve as c0, type BondedTakingCapacity as c1, type PlatformFreeTakes as c2, type PlatformGriefingCapacity as c3, type ChargebackCoverageStatus as c4, type PlatformChargebackCapacity as c5, type PlatformCapacity as c6, type TakerOperationalGates as c7, type TakerCapacity as c8, type OrderbookEntry as c9, type DepositFilter as cA, type PaginationOptions as cB, type DepositOrderField as cC, type OrderDirection$1 as cD, type RateManagerFilter as cE, type RateManagerPaginationOptions as cF, type RateManagerDelegationPaginationOptions as cG, type RateManagerOrderField as cH, type OrderDirection as cI, type DeploymentEnv as cJ, type FulfillmentRecord as cK, type PaymentVerifiedRecord as cL, type FulfillmentAndPaymentResponse as cM, PAYMENT_PLATFORMS as cN, type PaymentPlatformType as cO, Currency as cP, currencyInfo as cQ, getCurrencyInfoFromHash as cR, getCurrencyInfoFromCountryCode as cS, getCurrencyCodeFromHash as cT, isSupportedCurrencyHash as cU, mapConversionRatesToOnchainMinRate as cV, type CurrencyData as cW, getContracts as cX, getRateManagerContracts as cY, getStakeVaultContract as cZ, getPaymentMethodsCatalog as c_, type OrderbookTableRow as ca, IndexerClient as cb, defaultIndexerEndpoint as cc, IndexerDepositService as cd, IndexerRateManagerService as ce, compareEventCursorIdsByRecency as cf, fetchFulfillmentAndPayment as cg, type DepositEntity as ch, type IntentFulfilledEntity as ci, type IntentFulfillmentAmountsEntity as cj, type DepositPaymentMethodEntity as ck, type MethodCurrencyEntity as cl, type IntentStatus as cm, type RateManagerEntity as cn, type RateManagerRateEntity as co, type RateManagerDelegationEntity as cp, type ManagerAggregateStatsEntity as cq, type ManagerStatsEntity as cr, type ManagerDailySnapshotEntity as cs, type RateManagerListItem as ct, type RateManagerDetail as cu, type ManualRateUpdateEntity as cv, type OracleConfigUpdateEntity as cw, type DepositFundActivityEntity as cx, type DepositDailySnapshotEntity as cy, type DepositFundActivityType as cz, type SellerCredentialUploadPlatform as d, type RuntimeEnv as d0, type V2ContractAddresses as d1, type V2ContractAbis as d2, parseDepositView as d3, parseIntentView as d4, enrichPvDepositView as d5, enrichPvIntentView as d6, type PV_DepositView as d7, type PV_Deposit as d8, type PV_PaymentMethodData as d9, type PV_Currency as da, type PV_ReferralFee as db, type PV_IntentView as dc, type PV_Intent as dd, ZERO_RATE_MANAGER_ID as de, isZeroRateManagerId as df, normalizeRateManagerId as dg, normalizeRegistry as dh, getDelegationRoute as di, classifyDelegationState as dj, type DelegationRoute as dk, type DelegationState as dl, type DelegationDepositTarget as dm, type BatchResult as dn, type SendTransactionFn as dp, type SendBatchFn as dq, ZERO_ADDRESS as dr, asErrorMessage as ds, assertDelegationMethodSupport as dt, type SellerCredentialAttestationRuntime as e, type AttestationServiceSellerCredentialUploadResponse as f, type BuyerTeeSessionMaterialEncryptionInput as g, type CreateReferralCodeRequest as h, type ApiAdapterOptions as i, type CreateReferralCodeResponse as j, type ReferralReadRequest as k, type ReferralDashboardResponse as l, type ReferralEarningsResponse as m, type ReferralCodeLookupResponse as n, type RedeemReferralCodeRequest as o, type RedeemReferralCodeResponse as p, type UpdateReferralCodeRequest as q, type UpdateReferralCodeResponse as r, type GoogleOAuthSellerCredentialUploadBodyByPlatform as s, type BestByPlatformResponse as t, type ValidatePayeeDetailsResponse as u, type PostDepositDetailsResponse as v, type GetPayeeDetailsRequest as w, type GetPayeeDetailsResponse as x, type GetOwnerDepositsRequest as y, type GetOwnerDepositsResponse as z };