@zkp2p/sdk 0.0.11 → 0.0.12-rc.0

package/dist/{Zkp2pClient-BwGN8dWD.d.mts → Zkp2pClient-BRQLdrgN.d.mts}

@@ -20,6 +20,7 @@ declare const Currency: {
     readonly AED: "AED";
     readonly ARS: "ARS";
     readonly AUD: "AUD";
+    readonly BRL: "BRL";
     readonly CAD: "CAD";
     readonly CHF: "CHF";
     readonly CNY: "CNY";
@@ -172,6 +173,10 @@ type V2ContractAddresses = {
     protocolViewer?: `0x${string}`;
     /** USDC token address */
     usdc?: `0x${string}`;
+    /** DepositRateManagerRegistryV1 contract */
+    rateManagerRegistry?: `0x${string}`;
+    /** DepositRateManagerController contract */
+    rateManagerController?: `0x${string}`;
 };
 /**
  * Contract ABIs for a specific deployment.
@@ -181,6 +186,8 @@ type V2ContractAbis = {
     orchestrator?: Abi;
     unifiedPaymentVerifier?: Abi;
     protocolViewer?: Abi;
+    rateManagerRegistry?: Abi;
+    rateManagerController?: Abi;
 };
 /**
  * Runtime environment: 'production' for mainnet, 'staging' for testnet/dev.
@@ -245,6 +252,16 @@ declare function getPaymentMethodsCatalog(chainId: number, env?: RuntimeEnv): Pa
  * @returns Gating service signer address
  */
 declare function getGatingServiceAddress(chainId: number, env?: RuntimeEnv): `0x${string}`;
+declare function getRateManagerContracts(chainId: number, env?: RuntimeEnv): {
+    addresses: {
+        registry: `0x${string}`;
+        controller: `0x${string}`;
+    };
+    abis: {
+        registry: Abi;
+        controller: Abi;
+    };
+};
 
 type PV_Deposit = {
     depositor: string;
@@ -361,6 +378,8 @@ interface DepositEntity {
     depositId: string;
     depositor: string;
     delegate?: string | null;
+    rateManagerId?: string | null;
+    rateManagerRegistry?: string | null;
     token: string;
     remainingDeposits: string;
     intentAmountMin: string;
@@ -399,6 +418,9 @@ interface MethodCurrencyEntity {
     paymentMethodHash: string;
     currencyCode: string;
     minConversionRate: string;
+    conversionRate?: string | null;
+    managerRate?: string | null;
+    rateManagerId?: string | null;
 }
 type IntentStatus = 'SIGNALED' | 'FULFILLED' | 'PRUNED' | 'MANUALLY_RELEASED';
 interface IntentEntity {
@@ -423,6 +445,11 @@ interface IntentEntity {
     fulfillTxHash?: string | null;
     pruneTxHash?: string | null;
     paymentMethodHash?: string | null;
+    rateManagerId?: string | null;
+    manager?: string | null;
+    managerFee?: string | null;
+    managerFeeRecipient?: string | null;
+    managerFeeAmount?: string | null;
     paymentAmount?: string | null;
     paymentCurrency?: string | null;
     paymentTimestamp?: string | null;
@@ -440,9 +467,133 @@ interface IntentFulfilledEntity {
     isManualRelease: boolean;
     fundsTransferredTo?: string | null;
 }
+interface RateManagerEntity {
+    id: string;
+    chainId: number;
+    registry: string;
+    rateManagerId: string;
+    manager: string;
+    feeRecipient: string;
+    maxFee: string;
+    fee: string;
+    depositHook: string;
+    name: string;
+    uri: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface RateManagerRateEntity {
+    id: string;
+    chainId: number;
+    rateManagerId: string;
+    registry: string;
+    paymentMethodHash: string;
+    currencyCode: string;
+    managerRate: string;
+    updatedAt: string;
+}
+interface RateManagerDelegationEntity {
+    id: string;
+    chainId: number;
+    rateManagerId: string;
+    registry: string;
+    depositId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ManagerAggregateStatsEntity {
+    id: string;
+    chainId: number;
+    rateManagerId: string;
+    manager: string;
+    totalFilledVolume: string;
+    totalFeeAmount: string;
+    totalPnlUsdCents: string;
+    fulfilledIntents: number;
+    currentDelegatedBalance: string;
+    currentDelegatedDeposits: number;
+    firstSeenAt: string;
+    updatedAt: string;
+}
+interface ManagerStatsEntity {
+    id: string;
+    chainId: number;
+    rateManagerId: string;
+    manager: string;
+    intentId: string;
+    depositId: string;
+    paymentMethodHash: string;
+    currencyCode: string;
+    amount: string;
+    quoteConversionRate: string;
+    marketRate: string;
+    spreadBps: number;
+    pnlUsdCents: string;
+    managerFee: string;
+    managerFeeAmount: string;
+    createdAt: string;
+}
+interface ManagerDailySnapshotEntity {
+    id: string;
+    chainId: number;
+    rateManagerId: string;
+    dayTimestamp: string;
+    tvl: string;
+    delegatedDeposits: number;
+    dailyVolume: string;
+    dailyFees: string;
+    dailyPnlUsdCents: string;
+    dailyFulfilledIntents: number;
+    cumulativeVolume: string;
+    cumulativeFees: string;
+    cumulativePnlUsdCents: string;
+    cumulativeFulfilledIntents: number;
+    updatedAt: string;
+}
+interface RateManagerOracleConfigEntity {
+    id: string;
+    chainId: number;
+    rateManagerId: string;
+    registry: string;
+    paymentMethodHash: string;
+    currencyCode: string;
+    adapter: string;
+    adapterConfig: string;
+    feed: string;
+    feedDecimals: number;
+    spreadBps: number;
+    maxStaleness: string;
+    invert: boolean;
+    lastOracleUpdatedAt?: string | null;
+    kind: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface RateManagerHookMinLiquidityEntity {
+    id: string;
+    chainId: number;
+    registry: string;
+    rateManagerId: string;
+    minLiquidity: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface RateManagerListItem {
+    manager: RateManagerEntity;
+    aggregate?: ManagerAggregateStatsEntity | null;
+}
+interface RateManagerDetail {
+    manager: RateManagerEntity;
+    rates: RateManagerRateEntity[];
+    aggregate?: ManagerAggregateStatsEntity | null;
+    recentStats: ManagerStatsEntity[];
+    delegations: RateManagerDelegationEntity[];
+    oracleConfigs: RateManagerOracleConfigEntity[];
+    hookMinLiquidity: RateManagerHookMinLiquidityEntity | null;
+}
 
 type DepositOrderField = 'remainingDeposits' | 'outstandingIntentAmount' | 'totalAmountTaken' | 'totalWithdrawn' | 'updatedAt' | 'timestamp';
-type OrderDirection = 'asc' | 'desc';
+type OrderDirection$1 = 'asc' | 'desc';
 type DepositFilter = Partial<{
     status: 'ACTIVE' | 'CLOSED';
     depositor: string;
@@ -459,7 +610,7 @@ type PaginationOptions = Partial<{
     limit: number;
     offset: number;
     orderBy: DepositOrderField;
-    orderDirection: OrderDirection;
+    orderDirection: OrderDirection$1;
 }>;
 declare class IndexerDepositService {
     private client;
@@ -504,6 +655,48 @@ declare class IndexerDepositService {
     }): Promise<DepositWithRelations[]>;
 }
 
+type OrderDirection = 'asc' | 'desc';
+type RateManagerOrderField = 'createdAt' | 'updatedAt' | 'fee' | 'maxFee' | 'rateManagerId' | 'currentDelegatedBalance' | 'totalFilledVolume';
+type RateManagerFilter = Partial<{
+    manager: string;
+    name: string;
+    hasHook: boolean;
+    maxFee: string;
+    rateManagerIds: string[];
+}>;
+type RateManagerPaginationOptions = Partial<{
+    limit: number;
+    offset: number;
+    orderBy: RateManagerOrderField;
+    orderDirection: OrderDirection;
+}>;
+type RateManagerDelegationPaginationOptions = Partial<{
+    limit: number;
+    offset: number;
+    orderBy: 'createdAt' | 'updatedAt' | 'depositId';
+    orderDirection: OrderDirection;
+    registry: string;
+}>;
+declare class IndexerRateManagerService {
+    private client;
+    constructor(client: IndexerClient);
+    private buildWhere;
+    private buildOrderBy;
+    private toRateManagerListItems;
+    private buildDelegationOrderBy;
+    fetchRateManagers(pagination?: RateManagerPaginationOptions, filter?: RateManagerFilter): Promise<RateManagerListItem[]>;
+    fetchRateManagerDetail(rateManagerId: string, options?: {
+        statsLimit?: number;
+        registry?: string | null;
+    }): Promise<RateManagerDetail | null>;
+    fetchRateManagerDelegations(rateManagerId: string, pagination?: RateManagerDelegationPaginationOptions): Promise<RateManagerDelegationEntity[]>;
+    fetchManagerDailySnapshots(rateManagerId: string, options?: {
+        limit?: number;
+        registry?: string | null;
+    }): Promise<ManagerDailySnapshotEntity[]>;
+    fetchDelegationForDeposit(depositId: string): Promise<RateManagerDelegationEntity | null>;
+}
+
 type FulfillmentRecord = {
     id: string;
     intentHash: string;
@@ -934,6 +1127,7 @@ type Intent = {
 };
 type GetOwnerIntentsRequest = {
     ownerAddress: string;
+    escrowAddress?: string;
     status?: ApiIntentStatus | ApiIntentStatus[];
 };
 type GetOwnerIntentsResponse = {
@@ -944,6 +1138,7 @@ type GetOwnerIntentsResponse = {
 };
 type GetIntentsByDepositRequest = {
     depositId: string;
+    escrowAddress?: string;
     status?: ApiIntentStatus | ApiIntentStatus[];
 };
 type GetIntentsByDepositResponse = {
@@ -954,6 +1149,7 @@ type GetIntentsByDepositResponse = {
 };
 type GetIntentByHashRequest = {
     intentHash: string;
+    escrowAddress?: string;
 };
 type GetIntentByHashResponse = {
     success: boolean;
@@ -1002,6 +1198,7 @@ type ApiDeposit = {
 };
 type GetOwnerDepositsRequest = {
     ownerAddress: string;
+    escrowAddress?: string;
     /** Optional status filter: 'ACTIVE' | 'WITHDRAWN' | 'CLOSED' */
     status?: DepositStatus;
 };
@@ -1013,6 +1210,7 @@ type GetOwnerDepositsResponse = {
 };
 type GetDepositByIdRequest = {
     depositId: string;
+    escrowAddress?: string;
 };
 type GetDepositByIdResponse = {
     success: boolean;
@@ -1282,6 +1480,14 @@ declare class Zkp2pClient {
     readonly protocolViewerAddress?: Address;
     /** ProtocolViewer contract ABI */
     readonly protocolViewerAbi?: Abi;
+    /** DepositRateManagerRegistryV1 contract address */
+    readonly rateManagerRegistryAddress?: Address;
+    /** DepositRateManagerRegistryV1 ABI */
+    readonly rateManagerRegistryAbi?: Abi;
+    /** DepositRateManagerController contract address */
+    readonly rateManagerControllerAddress?: Address;
+    /** DepositRateManagerController ABI */
+    readonly rateManagerControllerAbi?: Abi;
     /** Base API URL for ZKP2P services */
     readonly baseApiUrl?: string;
     /** API key for authenticated endpoints */
@@ -1293,6 +1499,7 @@ declare class Zkp2pClient {
     private _usdcAddress?;
     private readonly _indexerClient;
     private readonly _indexerService;
+    private readonly _indexerRateManagerService;
     /**
      * Creates a new Zkp2pClient instance.
      *
@@ -1313,6 +1520,8 @@ declare class Zkp2pClient {
     private executePreparedTransaction;
     private prepareEscrowTransaction;
     private prepareOrchestratorTransaction;
+    private prepareContractTransaction;
+    private buildContractMethod;
     private buildEscrowMethod;
     private buildOrchestratorMethod;
     /**
@@ -1497,6 +1706,32 @@ declare class Zkp2pClient {
             includeIntents?: boolean;
             intentStatuses?: IntentStatus[];
         }) => Promise<DepositWithRelations[]>;
+        /**
+         * Fetches rate managers (vaults) with aggregate stats.
+         */
+        getRateManagers: (pagination?: RateManagerPaginationOptions, filter?: RateManagerFilter) => Promise<RateManagerListItem[]>;
+        /**
+         * Fetches detail for a single rate manager.
+         */
+        getRateManagerDetail: (rateManagerId: string, options?: {
+            statsLimit?: number;
+            registry?: string | null;
+        }) => Promise<RateManagerDetail | null>;
+        /**
+         * Fetches delegated deposits for a rate manager.
+         */
+        getRateManagerDelegations: (rateManagerId: string, pagination?: RateManagerDelegationPaginationOptions) => Promise<RateManagerDelegationEntity[]>;
+        /**
+         * Fetches delegation record for a specific composite deposit ID.
+         */
+        getDelegationForDeposit: (depositId: string) => Promise<RateManagerDelegationEntity | null>;
+        /**
+         * Fetches daily snapshots for a rate manager (vault).
+         */
+        getManagerDailySnapshots: (rateManagerId: string, options?: {
+            limit?: number;
+            registry?: string | null;
+        }) => Promise<ManagerDailySnapshotEntity[]>;
         /**
          * Performs a raw GraphQL query against the indexer.
          */
@@ -1780,6 +2015,90 @@ declare class Zkp2pClient {
         depositId: bigint;
         txOverrides?: TxOverrides;
     }, `0x${string}`>;
+    /**
+     * Assign a deposit to a rate manager (vault) through the controller.
+     */
+    readonly setDepositRateManager: PrepareableMethod<{
+        escrow: Address;
+        depositId: bigint;
+        registry: Address;
+        rateManagerId: Hex;
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /**
+     * Clear an existing rate manager delegation for a deposit.
+     */
+    readonly clearDepositRateManager: PrepareableMethod<{
+        escrow: Address;
+        depositId: bigint;
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /**
+     * Create a new rate manager (vault).
+     */
+    readonly createRateManager: PrepareableMethod<{
+        config: {
+            manager: Address;
+            feeRecipient: Address;
+            maxFee: bigint;
+            fee: bigint;
+            depositHook: Address;
+            name: string;
+            uri: string;
+        };
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /**
+     * Set a manager floor for a single payment method/currency pair.
+     */
+    readonly setVaultMinRate: PrepareableMethod<{
+        rateManagerId: Hex;
+        paymentMethodHash: `0x${string}`;
+        currencyHash: `0x${string}`;
+        rate: bigint;
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /**
+     * Set manager floors in batch.
+     */
+    readonly setVaultMinRatesBatch: PrepareableMethod<{
+        rateManagerId: Hex;
+        paymentMethods: `0x${string}`[];
+        currencies: `0x${string}`[][];
+        rates: bigint[][];
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /**
+     * Update vault manager fee.
+     */
+    readonly setVaultFee: PrepareableMethod<{
+        rateManagerId: Hex;
+        newFee: bigint;
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /**
+     * Update vault manager/config metadata.
+     */
+    readonly setVaultConfig: PrepareableMethod<{
+        rateManagerId: Hex;
+        newManager: Address;
+        newFeeRecipient: Address;
+        newHook: Address;
+        newName: string;
+        newUri: string;
+        txOverrides?: TxOverrides;
+    }, `0x${string}`>;
+    /**
+     * Read controller delegation state for a deposit.
+     */
+    getDepositRateManager(escrow: Address, depositId: bigint | number | string): Promise<{
+        registry: Address;
+        rateManagerId: Hex;
+    }>;
+    /**
+     * Read effective manager fee for a deposit.
+     */
+    getManagerFee(escrow: Address, depositId: bigint | number | string): Promise<bigint>;
     /**
      * Adds new payment methods to an existing deposit.
      *
@@ -2197,4 +2516,4 @@ declare class Zkp2pClient {
     }>;
 }
 
-export { type RegisterPayeeDetailsRequest as $, type ActionCallback as A, type DepositVerifierCurrency as B, type CancelIntentMethodParams as C, type DepositWithRelations as D, type DepositStatus as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type GetDepositByIdRequest as H, type IntentEntity as I, type GetDepositByIdResponse as J, type Intent as K, type ApiIntentStatus as L, type GetOwnerIntentsRequest as M, type NearbyQuote as N, type GetOwnerIntentsResponse as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type Range as R, type SignalIntentMethodParams as S, type TxOverrides as T, type GetIntentsByDepositRequest as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type GetIntentsByDepositResponse as X, type GetIntentByHashRequest as Y, Zkp2pClient as Z, type GetIntentByHashResponse as _, type ValidatePayeeDetailsResponse as a, type RegisterPayeeDetailsResponse as a0, type OnchainCurrency as a1, type DepositVerifierData as a2, type PreparedTransaction as a3, type OrderStats as a4, type DepositIntentStatistics as a5, type TakerTier as a6, type TakerTierStats as a7, type TakerTierLevel as a8, type PlatformLimit as a9, mapConversionRatesToOnchainMinRate as aA, type CurrencyType as aB, type CurrencyData as aC, getContracts as aD, getPaymentMethodsCatalog as aE, getGatingServiceAddress as aF, type RuntimeEnv as aG, parseDepositView as aH, parseIntentView as aI, enrichPvDepositView as aJ, enrichPvIntentView as aK, type PV_DepositView as aL, type PV_Deposit as aM, type PV_PaymentMethodData as aN, type PV_Currency as aO, type PV_IntentView as aP, type PV_Intent as aQ, type PlatformRiskLevel as aa, IndexerClient as ab, defaultIndexerEndpoint as ac, IndexerDepositService as ad, fetchFulfillmentAndPayment as ae, type DepositEntity as af, type IntentFulfilledEntity as ag, type DepositPaymentMethodEntity as ah, type MethodCurrencyEntity as ai, type IntentStatus as aj, type DepositFilter as ak, type PaginationOptions as al, type DepositOrderField as am, type OrderDirection as an, type DeploymentEnv as ao, type FulfillmentRecord as ap, type PaymentVerifiedRecord as aq, type FulfillmentAndPaymentResponse as ar, PAYMENT_PLATFORMS as as, type PaymentPlatformType as at, Currency as au, currencyInfo as av, getCurrencyInfoFromHash as aw, getCurrencyInfoFromCountryCode as ax, getCurrencyCodeFromHash as ay, isSupportedCurrencyHash as az, type PostDepositDetailsResponse as b, type GetPayeeDetailsResponse as c, type GetOwnerDepositsRequest as d, type GetOwnerDepositsResponse as e, type GetTakerTierRequest as f, type GetTakerTierResponse as g, type PaymentMethodCatalog as h, type Zkp2pClientOptions as i, type TimeoutConfig as j, type CreateDepositParams as k, type CreateDepositConversionRate as l, type SignalIntentParams as m, type FulfillIntentParams as n, type ReleaseFundsToPayerParams as o, type CancelIntentParams as p, type QuoteResponse as q, type QuoteResponseObject as r, type QuoteSingleResponse as s, type QuoteIntentResponse as t, type QuoteFeesResponse as u, type FiatResponse as v, type TokenResponse as w, type NearbySuggestions as x, type ApiDeposit as y, type DepositVerifier as z };
+export { type RegisterPayeeDetailsRequest as $, type ActionCallback as A, type DepositVerifierCurrency as B, type CancelIntentMethodParams as C, type DepositWithRelations as D, type DepositStatus as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type GetDepositByIdRequest as H, type IntentEntity as I, type GetDepositByIdResponse as J, type Intent as K, type ApiIntentStatus as L, type GetOwnerIntentsRequest as M, type NearbyQuote as N, type GetOwnerIntentsResponse as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type Range as R, type SignalIntentMethodParams as S, type TxOverrides as T, type GetIntentsByDepositRequest as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type GetIntentsByDepositResponse as X, type GetIntentByHashRequest as Y, Zkp2pClient as Z, type GetIntentByHashResponse as _, type ValidatePayeeDetailsResponse as a, enrichPvIntentView as a$, type RegisterPayeeDetailsResponse as a0, type OnchainCurrency as a1, type DepositVerifierData as a2, type PreparedTransaction as a3, type OrderStats as a4, type DepositIntentStatistics as a5, type TakerTier as a6, type TakerTierStats as a7, type TakerTierLevel as a8, type PlatformLimit as a9, type RateManagerPaginationOptions as aA, type RateManagerDelegationPaginationOptions as aB, type RateManagerOrderField as aC, type OrderDirection as aD, type DeploymentEnv as aE, type FulfillmentRecord as aF, type PaymentVerifiedRecord as aG, type FulfillmentAndPaymentResponse as aH, PAYMENT_PLATFORMS as aI, type PaymentPlatformType as aJ, Currency as aK, currencyInfo as aL, getCurrencyInfoFromHash as aM, getCurrencyInfoFromCountryCode as aN, getCurrencyCodeFromHash as aO, isSupportedCurrencyHash as aP, mapConversionRatesToOnchainMinRate as aQ, type CurrencyType as aR, type CurrencyData as aS, getContracts as aT, getRateManagerContracts as aU, getPaymentMethodsCatalog as aV, getGatingServiceAddress as aW, type RuntimeEnv as aX, parseDepositView as aY, parseIntentView as aZ, enrichPvDepositView as a_, type PlatformRiskLevel as aa, IndexerClient as ab, defaultIndexerEndpoint as ac, IndexerDepositService as ad, IndexerRateManagerService as ae, fetchFulfillmentAndPayment as af, type DepositEntity as ag, type IntentFulfilledEntity as ah, type DepositPaymentMethodEntity as ai, type MethodCurrencyEntity as aj, type IntentStatus as ak, type RateManagerEntity as al, type RateManagerRateEntity as am, type RateManagerDelegationEntity as an, type ManagerAggregateStatsEntity as ao, type ManagerStatsEntity as ap, type ManagerDailySnapshotEntity as aq, type RateManagerOracleConfigEntity as ar, type RateManagerHookMinLiquidityEntity as as, type RateManagerListItem as at, type RateManagerDetail as au, type DepositFilter as av, type PaginationOptions as aw, type DepositOrderField as ax, type OrderDirection$1 as ay, type RateManagerFilter as az, type PostDepositDetailsResponse as b, type PV_DepositView as b0, type PV_Deposit as b1, type PV_PaymentMethodData as b2, type PV_Currency as b3, type PV_IntentView as b4, type PV_Intent as b5, type GetPayeeDetailsResponse as c, type GetOwnerDepositsRequest as d, type GetOwnerDepositsResponse as e, type GetTakerTierRequest as f, type GetTakerTierResponse as g, type PaymentMethodCatalog as h, type Zkp2pClientOptions as i, type TimeoutConfig as j, type CreateDepositParams as k, type CreateDepositConversionRate as l, type SignalIntentParams as m, type FulfillIntentParams as n, type ReleaseFundsToPayerParams as o, type CancelIntentParams as p, type QuoteResponse as q, type QuoteResponseObject as r, type QuoteSingleResponse as s, type QuoteIntentResponse as t, type QuoteFeesResponse as u, type FiatResponse as v, type TokenResponse as w, type NearbySuggestions as x, type ApiDeposit as y, type DepositVerifier as z };