@zkp2p/sdk 0.9.0 → 0.10.0-rc.1

package/dist/{vaultUtils-aJdIIILM.d.ts → vaultUtils-CxUP_m-J.d.ts}

@@ -13,6 +13,16 @@ import { IdentityPlatform, IdentityAttestationOutputFor as IdentityAttestationOu
  * @module contracts
  */
 
+/** Reviewed OrchestratorV3 intent-lifecycle ABI. */
+declare const ORCHESTRATOR_V3_ABI: Abi;
+/** Reviewed RiskManager keeper and settlement-event ABI. */
+declare const RISK_MANAGER_ABI: Abi;
+/** Reviewed StakeVault ABI, including deferred-payout events. */
+declare const STAKE_VAULT_ABI: Abi;
+/** Focused ABI for decoding RiskPositionSettled receipts. */
+declare const RISK_POSITION_SETTLED_EVENT_ABI: Abi;
+/** Focused ABI for decoding DeferredPayoutRecorded receipts. */
+declare const DEFERRED_PAYOUT_RECORDED_EVENT_ABI: Abi;
 /**
  * Contract addresses for a specific deployment.
  */
@@ -27,6 +37,8 @@ type V2ContractAddresses = {
     orchestrator?: `0x${string}`;
     /** OrchestratorV2 contract (queries EscrowV2 effective rates) */
     orchestratorV2?: `0x${string}`;
+    /** OrchestratorV3 contract (stake-risk intent lifecycle) */
+    orchestratorV3?: `0x${string}`;
     /** All supported orchestrator addresses for the current deployment */
     orchestratorAddresses?: `0x${string}`[];
     /** UnifiedPaymentVerifier contract (verifies payment proofs) */
@@ -54,6 +66,10 @@ type V2ContractAddresses = {
     chainlinkOracleAdapter?: `0x${string}`;
     /** PythOracleAdapter contract */
     pythOracleAdapter?: `0x${string}`;
+    /** StakeVault contract for taker stake and delegation */
+    stakeVault?: `0x${string}`;
+    /** RiskManager contract for stake reservation and settlement recovery */
+    riskManager?: `0x${string}`;
 };
 /**
  * Contract ABIs for a specific deployment.
@@ -63,6 +79,7 @@ type V2ContractAbis = {
     escrowV2?: Abi;
     orchestrator?: Abi;
     orchestratorV2?: Abi;
+    orchestratorV3?: Abi;
     unifiedPaymentVerifier?: Abi;
     unifiedPaymentVerifierV2?: Abi;
     protocolViewer?: Abi;
@@ -70,6 +87,8 @@ type V2ContractAbis = {
     orchestratorRegistry?: Abi;
     rateManagerRegistry?: Abi;
     rateManagerController?: Abi;
+    stakeVault?: Abi;
+    riskManager?: Abi;
 };
 /**
  * Runtime environment: 'production' for mainnet, 'preproduction' for preprod
@@ -145,6 +164,27 @@ 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}`;
+};
+/** Resolve OrchestratorV3 for a deployment, failing closed when unavailable. */
+declare function getOrchestratorV3Contract(chainId: number, env?: RuntimeEnv): {
+    address: `0x${string}`;
+    abi: Abi;
+};
+/** Resolve RiskManager for a deployment, failing closed when unavailable. */
+declare function getRiskManagerContract(chainId: number, env?: RuntimeEnv): {
+    address: `0x${string}`;
+    abi: Abi;
+};
 
 /**
  * Minimal fetch-based GraphQL client for the ZKP2P indexer.
@@ -1555,111 +1595,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;
@@ -1792,6 +1919,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;
@@ -2429,6 +2613,10 @@ declare class Zkp2pClient {
     readonly orchestratorV2Address?: Address;
     /** OrchestratorV2 ABI */
     readonly orchestratorV2Abi?: Abi;
+    /** OrchestratorV3 address (undefined when stake-risk intents are not deployed) */
+    readonly orchestratorV3Address?: Address;
+    /** OrchestratorV3 ABI */
+    readonly orchestratorV3Abi?: Abi;
     /** All supported upgraded orchestrator addresses (current first, then historical) */
     readonly orchestratorAddresses: Address[];
     /** UnifiedPaymentVerifier contract address */
@@ -2455,6 +2643,14 @@ 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;
+    /** RiskManager address (undefined when stake-risk settlement is not deployed) */
+    readonly riskManagerAddress?: Address;
+    /** RiskManager ABI */
+    readonly riskManagerAbi?: Abi;
     /** Base API URL for ZKP2P services */
     readonly baseApiUrl?: string;
     /** Optional internal curator API key (`x-api-key`) for internal seller verification */
@@ -2472,6 +2668,7 @@ declare class Zkp2pClient {
     private readonly _router;
     private readonly _pvReader;
     private readonly _vaultOps;
+    private readonly _stakeOps;
     private readonly _intentOps;
     private readonly _referralOps;
     private _rateManagerInitError?;
@@ -2539,6 +2736,8 @@ declare class Zkp2pClient {
     private prepareResolvedOrchestratorTransaction;
     private prepareContractTransaction;
     private buildContractMethod;
+    private buildStakeVaultMethod;
+    private buildRiskManagerMethod;
     private buildEscrowMethod;
     private buildOrchestratorMethod;
     /**
@@ -2841,6 +3040,144 @@ 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;
+    };
+    /** Return the resolved OrchestratorV3 coordinates for advanced integrations. */
+    getOrchestratorV3Contract(): {
+        address: Address;
+        abi: Abi;
+    };
+    /** Return the resolved RiskManager coordinates for keeper integrations. */
+    getRiskManagerContract(): {
+        address: Address;
+        abi: Abi;
+    };
+    /**
+     * 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>;
+    /** Release one or more RiskManager positions whose chargeback window matured. */
+    readonly releaseMaturedPositions: PrepareableMethod<{
+        intentHashes: readonly `0x${string}`[];
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Reconcile one failed OrchestratorV3 settlement callback. */
+    readonly reconcileSettlement: PrepareableMethod<{
+        intentHash: `0x${string}`;
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Reconcile multiple failed OrchestratorV3 settlement callbacks. */
+    readonly reconcileSettlements: PrepareableMethod<{
+        intentHashes: readonly `0x${string}`[];
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Reconcile one failed OrchestratorV3 cancellation callback. */
+    readonly reconcileCancellation: PrepareableMethod<{
+        intentHash: `0x${string}`;
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /** Reconcile multiple failed OrchestratorV3 cancellation callbacks. */
+    readonly reconcileCancellations: PrepareableMethod<{
+        intentHashes: readonly `0x${string}`[];
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
     /**
      * Registers payee details with the curator API and returns hashed on-chain IDs.
      *
@@ -3674,18 +4011,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.
@@ -3848,12 +4203,15 @@ declare class Zkp2pClient {
         escrowAddresses: Address[];
         orchestrator?: Address;
         orchestratorV2?: Address;
+        orchestratorV3?: Address;
         orchestratorAddresses: Address[];
         protocolViewer?: Address;
         protocolViewerEntries: Address[];
         unifiedPaymentVerifier?: Address;
         rateManagerV1?: Address;
         orchestratorRegistry?: Address;
+        stakeVault?: Address;
+        riskManager?: Address;
         usdc?: Address;
     };
     /**
@@ -3938,4 +4296,4 @@ type SendBatchFn = (txs: Array<{
     value?: bigint;
 }>) => Promise<string>;
 
-export { type RedeemReferralCodeSignatureOptions 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 GetOrderbookTableResponse as M, type CurrencyType as N, type PaymentMethodCatalog 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 TxOverrides as W, type ReferralBearerWriteOptions as X, type ReferralReadOptions as Y, Zkp2pClient as Z, type ReferralSignatureOptions as _, type IdentityAttestationRequestBody as a, type VenmoGoogleOAuthSellerCredentialUploadBody as a$, type SignalIntentReferralFee as a0, type SignalIntentMethodParams as a1, type FulfillIntentMethodParams as a2, type CancelIntentMethodParams as a3, type UpdateReferralCodeSignatureOptions as a4, type Zkp2pNextOptions as a5, type AuthorizationTokenProvider as a6, type TimeoutConfig as a7, type ActionCallback as a8, type ReferralRedemption as a9, type TokenResponse as aA, type NearbyQuote as aB, type NearbySuggestions as aC, type ApiDeposit as aD, type DepositVerifier as aE, type DepositVerifierCurrency as aF, type DepositStatus$1 as aG, type GetDepositByIdRequest as aH, type GetDepositByIdResponse as aI, type Intent as aJ, type ApiIntentStatus as aK, type GetOwnerIntentsRequest as aL, type GetOwnerIntentsResponse as aM, type GetIntentsByDepositRequest as aN, type GetIntentsByDepositResponse as aO, type GetIntentByHashRequest as aP, type GetIntentByHashResponse as aQ, type RegisterPayeeDetailsRequest as aR, type RegisterPayeeDetailsResponse as aS, type SellerPlatform as aT, type VenmoSessionMaterial as aU, type CashAppSessionMaterial as aV, type WiseSessionMaterial as aW, type WiseProfileInfo as aX, type WiseProfileSelectionRequired as aY, type WiseProfileNotFound as aZ, type PayPalGoogleOAuthSellerCredentialUploadBody as a_, type ReferralSignatureBody as aa, type CreateDepositParams as ab, type CreateDepositConversionRate as ac, type Range as ad, type WithdrawDepositParams as ae, type SignalIntentParams as af, type FulfillIntentParams as ag, type ReleaseFundsToPayerParams as ah, type CancelIntentParams as ai, type BestByPlatformResponseObject as aj, type GetBestByPlatformResponse as ak, type GetBestByPlatformResponseObject as al, type GetPlatformQuote as am, type PlatformQuote as an, type QuoteRequest as ao, type GetNearbyQuote as ap, type GetNearbySuggestions as aq, type GetQuoteResponse as ar, type GetQuoteResponseObject as as, type GetQuoteSingleResponse as at, type QuoteResponse as au, type QuoteResponseObject as av, type QuoteSingleResponse as aw, type QuoteIntentResponse as ax, type QuoteFeesResponse as ay, type FiatResponse as az, type AttestationServiceSellerVerifyResponse as b, type MethodCurrencyEntity as b$, type VenmoCredentialUploadInput as b0, type CashAppCredentialUploadInput as b1, type WiseCredentialUploadInput as b2, type SellerCredentialUploadInputByPlatform as b3, type SellerCiphertextBundle as b4, type SellerSignedCiphertextBundle as b5, type SellerVerifyIntentDetails as b6, type SellerVerifyInput as b7, type SellerProbeInput as b8, type SellerCredentialBundleUpload as b9, type IdentityAttestationOutputFor as bA, type IdentityAttestationParams as bB, type MakerIdentityAttestationRequestBody as bC, type MakerIdentityPlatform as bD, type OnchainCurrency as bE, type DepositVerifierData as bF, type PreparedTransaction as bG, type OrderStats as bH, type DepositIntentStatistics as bI, type TakerTier as bJ, type TakerTierVolumeBreakdown as bK, type TakerTierStats as bL, type TakerTierSource as bM, type PlatformLimit as bN, type PlatformRiskLevel as bO, type OrderbookEntry as bP, type OrderbookTableRow as bQ, IndexerClient as bR, defaultIndexerEndpoint as bS, IndexerDepositService as bT, IndexerRateManagerService as bU, compareEventCursorIdsByRecency as bV, fetchFulfillmentAndPayment as bW, type DepositEntity as bX, type IntentFulfilledEntity as bY, type IntentFulfillmentAmountsEntity as bZ, type DepositPaymentMethodEntity as b_, type SellerCredentialStatusValue as ba, type SellerCredentialStatus as bb, type SellerVerifyProxyBody as bc, type SellerTypedDataField as bd, type SellerTypedDataSpec as be, type SellerPaymentTypedDataValue as bf, type SellerAttestationOutput as bg, type SellerCredentialProbeResponse as bh, type FulfillIntentAttestationResponse as bi, type AttestationServiceSellerCredentialProbeResponse as bj, type BuyerTeePaymentParams as bk, type BuyerTeePaymentProofInput as bl, type BuyerTeeSessionMaterial as bm, type CuratorSellerCredentialStatusResponse as bn, type CuratorSellerVerifyResponse as bo, type RegisteredSellerCredentialPlatform as bp, type UploadSellerCredentialParams as bq, type RegisteredUploadSellerCredentialParams as br, type UploadSellerCredentialOptions as bs, type GetSellerCredentialStatusParams as bt, type UploadPayPalGoogleOAuthSellerCredentialParams as bu, type UploadVenmoGoogleOAuthSellerCredentialParams as bv, type UploadGoogleOAuthSellerCredentialParams as bw, type VerifySellerPaymentParams as bx, type IdentityAttestationActionType as by, type IdentityAttestationOutput as bz, type SellerCredentialUploadInput as c, type SendTransactionFn as c$, type IntentStatus as c0, type RateManagerEntity as c1, type RateManagerRateEntity as c2, type RateManagerDelegationEntity as c3, type ManagerAggregateStatsEntity as c4, type ManagerStatsEntity as c5, type ManagerDailySnapshotEntity as c6, type RateManagerListItem as c7, type RateManagerDetail as c8, type ManualRateUpdateEntity as c9, type CurrencyData as cA, getContracts as cB, getRateManagerContracts as cC, getPaymentMethodsCatalog as cD, getGatingServiceAddress as cE, type RuntimeEnv as cF, parseDepositView as cG, parseIntentView as cH, enrichPvDepositView as cI, enrichPvIntentView as cJ, type PV_DepositView as cK, type PV_Deposit as cL, type PV_PaymentMethodData as cM, type PV_Currency as cN, type PV_ReferralFee as cO, type PV_IntentView as cP, type PV_Intent as cQ, ZERO_RATE_MANAGER_ID as cR, isZeroRateManagerId as cS, normalizeRateManagerId as cT, normalizeRegistry as cU, getDelegationRoute as cV, classifyDelegationState as cW, type DelegationRoute as cX, type DelegationState as cY, type DelegationDepositTarget as cZ, type BatchResult as c_, type OracleConfigUpdateEntity as ca, type DepositFundActivityEntity as cb, type DepositDailySnapshotEntity as cc, type DepositFundActivityType as cd, type DepositFilter as ce, type PaginationOptions as cf, type DepositOrderField as cg, type OrderDirection$1 as ch, type RateManagerFilter as ci, type RateManagerPaginationOptions as cj, type RateManagerDelegationPaginationOptions as ck, type RateManagerOrderField as cl, type OrderDirection as cm, type DeploymentEnv as cn, type FulfillmentRecord as co, type PaymentVerifiedRecord as cp, type FulfillmentAndPaymentResponse as cq, PAYMENT_PLATFORMS as cr, type PaymentPlatformType as cs, Currency as ct, currencyInfo as cu, getCurrencyInfoFromHash as cv, getCurrencyInfoFromCountryCode as cw, getCurrencyCodeFromHash as cx, isSupportedCurrencyHash as cy, mapConversionRatesToOnchainMinRate as cz, type SellerCredentialUploadPlatform as d, type SendBatchFn as d0, ZERO_ADDRESS as d1, asErrorMessage as d2, assertDelegationMethodSupport as d3, 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, getRiskManagerContract 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, getOrchestratorV3Contract 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, getPaymentMethodsCatalog as d0, getGatingServiceAddress as d1, ORCHESTRATOR_V3_ABI as d2, RISK_MANAGER_ABI as d3, STAKE_VAULT_ABI as d4, RISK_POSITION_SETTLED_EVENT_ABI as d5, DEFERRED_PAYOUT_RECORDED_EVENT_ABI as d6, type RuntimeEnv as d7, type V2ContractAddresses as d8, type V2ContractAbis as d9, assertDelegationMethodSupport as dA, parseDepositView as da, parseIntentView as db, enrichPvDepositView as dc, enrichPvIntentView as dd, type PV_DepositView as de, type PV_Deposit as df, type PV_PaymentMethodData as dg, type PV_Currency as dh, type PV_ReferralFee as di, type PV_IntentView as dj, type PV_Intent as dk, ZERO_RATE_MANAGER_ID as dl, isZeroRateManagerId as dm, normalizeRateManagerId as dn, normalizeRegistry as dp, getDelegationRoute as dq, classifyDelegationState as dr, type DelegationRoute as ds, type DelegationState as dt, type DelegationDepositTarget as du, type BatchResult as dv, type SendTransactionFn as dw, type SendBatchFn as dx, ZERO_ADDRESS as dy, asErrorMessage as dz, 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 };