@gearbox-protocol/sdk 14.0.0 → 14.1.0

package/dist/types/sdk/accounts/types.d.ts

@@ -2,7 +2,8 @@ import type { Address, ContractFunctionArgs, GetContractReturnType, Hex, PublicC
 import type { creditAccountCompressorAbi } from "../../abi/compressors/creditAccountCompressor.js";
 import type { iWithdrawalCompressorV310Abi } from "../../abi/IWithdrawalCompressorV310.js";
 import type { ConnectedBotData, Construct, CreditAccountData } from "../base/index.js";
-import type { CreditSuite, PriceUpdate } from "../market/index.js";
+import type { CreditSuite, KYCOperationParams, PriceUpdate } from "../market/index.js";
+import type { KYCOpenAccountRequirements } from "../market/kyc/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
 import type { Asset, RouterCASlice, RouterCloseResult } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
@@ -182,6 +183,10 @@ export interface CloseCreditAccountProps {
     closePath?: RouterCloseResult;
 }
 export interface RepayCreditAccountProps extends RepayAndLiquidateCreditAccountProps {
+    /**
+     * Swap calls for repay
+     */
+    calls?: Array<MultiCall>;
     /**
      * close or zeroDebt
      */
@@ -422,6 +427,15 @@ export interface OpenCAProps extends PrepareUpdateQuotasProps {
      * Referral code to open credit account with
      */
     referralCode: bigint;
+    /**
+     * KYC options to open credit account with, required for KYC factories
+     * First we ask for getOpenAccountRequirements,
+     * then perform necessary actions (e.g. for Securitize, convert requiredSignatures to signaturesToCache)
+     * to produce KYCOperationParams
+     * If getOpenAccountRequirements returned undefined, we need to pass undefined here too;
+     * It means that no KYC actions are required (e.g. when we open second credit account)
+     */
+    kycOptions?: KYCOperationParams;
 }
 export interface ChangeDeptProps {
     /**
@@ -439,6 +453,10 @@ export interface ChangeDeptProps {
      * Assets to add as collateral
      */
     collateral?: [Asset];
+    /**
+     * Assets to wrap
+     */
+    wrapAsset?: [Asset];
 }
 export interface FullyLiquidateProps {
     /**
@@ -532,6 +550,16 @@ export interface Rewards {
      **/
     rewards: Array<Asset>;
 }
+/**
+ * Options to get open account requirements
+ * Compatible with StrategyConfigPayload
+ */
+export interface GetOpenAccountRequirementsProps {
+    /**
+     * Token address of the strategy
+     */
+    tokenOutAddress: Address;
+}
 interface CMSlice {
     creditManager: Address;
     creditFacade: Address;
@@ -582,25 +610,46 @@ export type GetConnectedMigrationBotsResult = {
     })[];
     botAddress: Address;
 } | undefined;
+/**
+ * Options to get approval address for collateral token
+ */
+export type GetApprovalAddressProps = {
+    creditManager: Address;
+    borrower: Address;
+} | {
+    creditManager: Address;
+    creditAccount: Address;
+};
 export interface ICreditAccountsService extends Construct {
     sdk: OnchainSDK;
     /**
-     * Returns single credit account data, or undefined if it's not found
-     * Performs all necessary price feed updates under the hood
-     * @param account
-     * @param blockNumber
-     * @returns
+     * Returns single credit account data with investor resolved, or undefined
+     * if the account is not found.
+     * Performs all necessary price feed updates under the hood.
+     * @param account - Credit account address
+     * @param blockNumber - Optional block number for the read
+     * @returns Credit account data with investor, or undefined
      */
-    getCreditAccountData(account: Address, blockNumber?: bigint): Promise<CreditAccountData | undefined>;
+    getCreditAccountData(account: Address, blockNumber?: bigint): Promise<CreditAccountData<true> | undefined>;
     /**
-     * Methods to get all credit accounts with some optional filtering
-     * Performs all necessary price feed updates under the hood
+     * Returns all credit accounts with optional filtering.
+     * Performs all necessary price feed updates under the hood.
      *
-     * @param options
-     * @param blockNumber
-     * @returns returned credit accounts are sorted by health factor in ascending order
+     * @param options - Filter options
+     * @param blockNumber - Optional block number for the read
+     * @returns Credit accounts sorted by health factor ascending
      */
     getCreditAccounts(options?: GetCreditAccountsOptions, blockNumber?: bigint): Promise<Array<CreditAccountData>>;
+    /**
+     * Returns all credit accounts for a borrower,
+     * both normal and KYC accounts with investor resolved on each.
+     *
+     * @param borrower - Actual owner of credit account
+     * @param options - Filter options (creditManager, health factor, etc.)
+     * @param blockNumber - Optional block number for the read
+     * @returns Credit accounts (with investor) sorted by health factor ascending
+     */
+    getBorrowerCreditAccounts(borrower: Address, options?: GetCreditAccountsOptions, blockNumber?: bigint): Promise<Array<CreditAccountData<true>>>;
     /**
      * Method to get all claimable rewards for credit account (ex. stkUSDS SKY rewards).
      * Associates rewards by adapter + stakedPhantomToken.
@@ -629,9 +678,9 @@ export interface ICreditAccountsService extends Construct {
     /**
      * Generates transaction to liquidate credit account
      * @param props - {@link FullyLiquidateProps}
-     * @returns
+     * @returns Transaction data and optional loss policy data
      */
-    fullyLiquidate(props: FullyLiquidateProps): Promise<CloseCreditAccountResult>;
+    fullyLiquidate(props: FullyLiquidateProps): Promise<FullyLiquidateResult>;
     /**
      * Closes credit account or closes credit account and keeps it open with zero debt.
      * - Ca is closed in the following order: price update -> close path to swap all tokens into underlying ->
@@ -694,6 +743,21 @@ export interface ICreditAccountsService extends Construct {
      * @returns
     */
     claimDelayed(props: ClaimDelayedProps): Promise<CreditAccountOperationResult>;
+    /**
+     * Returns address to which approval should be given on collateral token
+     * It's credit manager for classical markets and special wallet for KYC markets
+     * @param props - {@link GetApprovalAddressProps}
+     * @returns
+     */
+    getApprovalAddress(props: GetApprovalAddressProps): Promise<Address>;
+    /**
+     * Returns open account requirements for a borrower
+     * @param borrower - Borrower address
+     * @param creditManager - Credit manager address
+     * @param props - {@link GetOpenAccountRequirementsProps} you can pass StrategyConfigPayload here
+     * @returns Open account requirements or undefined if the user can open a credit account without any further actions
+     */
+    getOpenAccountRequirements(borrower: Address, creditManager: Address, props: GetOpenAccountRequirementsProps): Promise<KYCOpenAccountRequirements | undefined>;
     /**
      * Executes swap specified by given calls, update quotas of affected tokens
      * - Open credit account is executed in the following order: price update -> increase debt -> add collateral ->
@@ -749,6 +813,42 @@ export interface ICreditAccountsService extends Construct {
     botMulticall(creditAccount: RouterCASlice, calls: Array<MultiCall>, options?: {
         ignoreReservePrices?: boolean;
     }): Promise<RawTx>;
+    /**
+     * Returns multicall entries to redeem (unwrap) KYC ERC-4626 vault shares into underlying for the given credit manager.
+     * Used when withdrawing debt from a KYC market: redeems adapter vault shares so the underlying can be withdrawn.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Number of vault shares (adapter tokens) to redeem
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getKYCUnwrapCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
+    /**
+     * Returns multicall entries to deposit (wrap) underlying into KYC ERC-4626 vault shares for the given credit manager.
+     * Used when adding debt on a KYC market: deposits underlying into the adapter vault so shares are minted on the account.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Amount of underlying assets to deposit into the vault (in underlying decimals)
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getKYCWrapCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
+    /**
+     * Returns multicall entries to call redeemDiff on the KYC ERC-4626 adapter for the given credit manager.
+     * Redeems the leftover vault shares (e.g. after repaying debt) so the account does not hold excess KYC vault tokens.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Leftover vault share amount to redeem (in adapter/vault decimals)
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getRedeemDiffCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
+    /**
+     * Returns multicall entries to call depositDiff on the KYC ERC-4626 adapter for the given credit manager.
+     * Deposits the leftover underlying (e.g. after decreasing debt) into the vault so the account does not hold excess underlying.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Leftover underlying amount to deposit into the vault (in underlying decimals)
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getDepositDiffCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
     /**
      * Withdraws a single collateral from credit account to wallet to and updates quotas;
      * technically can withdraw several tokens at once

package/dist/types/sdk/base/TokensMeta.d.ts

@@ -1,8 +1,8 @@
-import { type Address, type Chain, type PublicClient, type Transport } from "viem";
+import type { Address, Chain, PublicClient, Transport } from "viem";
 import type { Asset } from "../router/index.js";
 import type { ILogger } from "../types/logger.js";
 import { AddressMap } from "../utils/index.js";
-import type { PhantomTokenMeta, TokenMetaData } from "./token-types.js";
+import type { KYCTokenMeta, PhantomTokenMeta, TokenMetaData } from "./token-types.js";
 /**
  * Options for {@link TokensMeta.formatBN}.
  **/
@@ -50,11 +50,22 @@ export declare class TokensMeta extends AddressMap<TokenMetaData> {
      * @returns
      */
     isPhantomToken(t: TokenMetaData): t is PhantomTokenMeta;
+    /**
+     * Returns true if the token is a KYC underlying token, throws if the token data is not loaded
+     * @param t
+     * @returns
+     */
+    isKYCUnderlying(t: TokenMetaData): t is KYCTokenMeta;
     /**
      * Returns a map of all phantom tokens
      * Throws if token data is not loaded
      */
     get phantomTokens(): AddressMap<PhantomTokenMeta>;
+    /**
+     * Returns a map of all KYC underlying tokens
+     * Throws if token data is not loaded
+     */
+    get kycUnderlyings(): AddressMap<KYCTokenMeta>;
     /**
      * Formats a raw token amount into a human-readable decimal string,
      * dividing by `10^decimals` for the token.
@@ -85,7 +96,7 @@ export declare class TokensMeta extends AddressMap<TokenMetaData> {
     mustFindBySymbol(symbol: string): TokenMetaData;
     /**
      * Loads token information about phantom tokens
-     * Other special tokens may be loaded here in the future
+     * In future other custom tokens types that do not have compressors might be handled here
      *
      * @param tokens - tokens to load data for, defaults to all tokens
      */

package/dist/types/sdk/base/token-types.d.ts

@@ -1,13 +1,53 @@
+import type { Address } from "viem";
 import type { MarketData, Unarray } from "./types.js";
 type TokenData = Unarray<MarketData["tokens"]>;
 export declare const PHANTOM_TOKEN_CONTRACT_TYPES: readonly ["PHANTOM_TOKEN::CONVEX", "PHANTOM_TOKEN::INFINIFI_UNWIND", "PHANTOM_TOKEN::INFRARED", "PHANTOM_TOKEN::MELLOW_WITHDRAWAL", "PHANTOM_TOKEN::MIDAS_REDEMPTION", "PHANTOM_TOKEN::STAKING_REWARDS", "PHANTOM_TOKEN::UPSHIFT_WITHDRAW"];
+export declare const KYC_UNDERLYING_DEFAULT = "KYC_UNDERLYING::DEFAULT";
+export declare const KYC_UNDERLYING_ON_DEMAND = "KYC_UNDERLYING::ON_DEMAND";
+export type KYCUnderlyingContractType = typeof KYC_UNDERLYING_DEFAULT | typeof KYC_UNDERLYING_ON_DEMAND;
+export declare const KYC_ON_DEMAND_LP_MONOPOLIZED = "ON_DEMAND_LP::MONOPOLIZED";
+export type KYCOnDemandLpContractType = typeof KYC_ON_DEMAND_LP_MONOPOLIZED;
 export type PhantomTokenContractType = (typeof PHANTOM_TOKEN_CONTRACT_TYPES)[number];
-export type SimpleTokenMeta = TokenData & {
-    isDSToken?: boolean;
+export interface SimpleTokenMeta extends TokenData {
     contractType?: string;
-};
+}
 export type PhantomTokenMeta = SimpleTokenMeta & {
     contractType: PhantomTokenContractType;
 };
-export type TokenMetaData = SimpleTokenMeta | PhantomTokenMeta;
+export interface KYCDefaultTokenMeta extends SimpleTokenMeta {
+    contractType: typeof KYC_UNDERLYING_DEFAULT;
+    kycFactory: Address;
+    asset: Address;
+}
+export interface LPMonopolizedPoolMeta {
+    pool: Address;
+    wrappedUnderlying: Address;
+    unwrappedUnderlying: Address;
+    depositAllowance: bigint;
+    claimableAmount: bigint;
+}
+export interface KYCOnDemandLPMonopolizedMeta {
+    addr: Address;
+    version: bigint;
+    contractType: typeof KYC_ON_DEMAND_LP_MONOPOLIZED;
+    marketConfigurator: Address;
+    /**
+     * Only this user can deposit into the pool and withdraw
+     * Other users should not see it at all
+     */
+    depositor: Address;
+    pools: LPMonopolizedPoolMeta[];
+}
+export type KYCOnDemandLPMeta = KYCOnDemandLPMonopolizedMeta;
+export interface KYCOnDemandTokenMeta extends SimpleTokenMeta {
+    contractType: typeof KYC_UNDERLYING_ON_DEMAND;
+    kycFactory: Address;
+    asset: Address;
+    pool: Address;
+    marketConfigurator: Address;
+    allowedDepositors: Address[];
+    liquidityProvider: KYCOnDemandLPMeta;
+}
+export type KYCTokenMeta = KYCDefaultTokenMeta | KYCOnDemandTokenMeta;
+export type TokenMetaData = SimpleTokenMeta | PhantomTokenMeta | KYCTokenMeta;
 export {};

package/dist/types/sdk/base/types.d.ts

@@ -1,6 +1,5 @@
 import type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from "abitype";
 import type { Address, Hex } from "viem";
-import type { creditAccountCompressorAbi } from "../../abi/compressors/creditAccountCompressor.js";
 import type { gaugeCompressorAbi } from "../../abi/compressors/gaugeCompressor.js";
 import type { marketCompressorAbi } from "../../abi/compressors/marketCompressor.js";
 import type { peripheryCompressorAbi } from "../../abi/compressors/peripheryCompressor.js";
@@ -63,10 +62,125 @@ export interface BaseState {
  * Filter criteria for querying markets.
  **/
 export type MarketFilter = AbiParametersToPrimitiveTypes<ExtractAbiFunction<typeof marketCompressorAbi, "getMarkets">["inputs"]>[0];
+/**
+ * Info on credit account's assets
+ **/
+export interface TokenInfo {
+    /**
+     * Token address.
+     **/
+    token: Address;
+    /**
+     * Token mask in the credit manager.
+     **/
+    mask: bigint;
+    /**
+     * Account's balance of token.
+     **/
+    balance: bigint;
+    /**
+     * Account's quota of token.
+     **/
+    quota: bigint;
+    /**
+     * Whether balance call was successful.
+     **/
+    success: boolean;
+}
+/**
+ * On-chain state of a credit account.
+ *
+ * @remarks
+ * Fields from `totalDebtUSD` through `healthFactor` are not filled when
+ * `success` is `false`.
+ *
+ **/
+export interface CreditAccountDataPayload {
+    /**
+     * Credit account address.
+     **/
+    creditAccount: Address;
+    /**
+     * Credit manager account is opened in.
+     **/
+    creditManager: Address;
+    /**
+     * Facade connected to account's credit manager.
+     **/
+    creditFacade: Address;
+    /**
+     * Credit manager's underlying token.
+     **/
+    underlying: Address;
+    /**
+     * Credit account's owner (contract address for KYC accounts, EOA for
+     * normal accounts).
+     **/
+    owner: Address;
+    /**
+     * Expiration timestamp, in case facade is expirable.
+     **/
+    expirationDate: number;
+    /**
+     * Bitmask of tokens enabled on credit account as collateral.
+     **/
+    enabledTokensMask: bigint;
+    /**
+     * Credit account's debt principal in underlying.
+     **/
+    debt: bigint;
+    /**
+     * Base and quota interest accrued on the credit account.
+     **/
+    accruedInterest: bigint;
+    /**
+     * Fees accrued on the credit account.
+     **/
+    accruedFees: bigint;
+    /**
+     * Account's total debt in USD.
+     **/
+    totalDebtUSD: bigint;
+    /**
+     * Account's total value in USD.
+     **/
+    totalValueUSD: bigint;
+    /**
+     * Account's threshold-weighted value in USD.
+     **/
+    twvUSD: bigint;
+    /**
+     * Account's total value in underlying.
+     **/
+    totalValue: bigint;
+    /**
+     * Account's health factor, i.e. ratio of `twvUSD` to `totalDebtUSD`,
+     * with 18 decimals precision.
+     **/
+    healthFactor: bigint;
+    /**
+     * Whether collateral calculation was successful.
+     **/
+    success: boolean;
+    /**
+     * Info on credit account's enabled tokens and tokens with non-zero balance.
+     **/
+    tokens: readonly TokenInfo[];
+}
 /**
  * Full on-chain snapshot of a single credit account.
+ *
+ * @typeParam WithInvestor - When `true`, the result includes an `investor`
+ *   field (`Address | undefined`).  Defaults to `false` (no investor field).
  **/
-export type CreditAccountData = Unarray<AbiParametersToPrimitiveTypes<ExtractAbiFunction<typeof creditAccountCompressorAbi, "getCreditAccountData">["outputs"]>>;
+export type CreditAccountData<WithInvestor extends boolean = false> = WithInvestor extends true ? CreditAccountDataPayload & {
+    /**
+     * Investor EOA address (the real person behind the account).
+     * - KYC accounts: resolved from KYC factory, always defined.
+     * - Normal accounts: `undefined` (owner IS the investor).
+     **/
+    investor: Address | undefined;
+} : CreditAccountDataPayload;
 /**
  * Reward distribution details for a single reward token.
  **/

package/dist/types/sdk/chain/chains.d.ts

@@ -4,7 +4,7 @@ import { z } from "zod/v4";
  * Known curator names that manage Gearbox markets.
  *
  **/
-export type Curator = "Chaos Labs" | "K3" | "cp0x" | "Re7" | "Invariant Group" | "Tulipa" | "M11 Credit" | "kpk" | "Hyperithm" | "UltraYield" | "TelosC" | "Gami Labs";
+export type Curator = "Chaos Labs" | "K3" | "cp0x" | "Re7" | "Invariant Group" | "Tulipa" | "M11 Credit" | "kpk" | "Hyperithm" | "UltraYield" | "TelosC" | "Gami Labs" | "Securitize";
 /**
  * Extended viem {@link Chain} with Gearbox-specific metadata.
  *
@@ -20,6 +20,10 @@ export interface GearboxChain extends Chain {
      * Market configurator addresses operated by known curators on this chain.
      **/
     defaultMarketConfigurators: Record<Address, Curator>;
+    /**
+     * Known KYC factory addresses on this chain
+     */
+    kycFactories: Address[];
     /**
      * Market configurators used in test/staging environments.
      **/

package/dist/types/sdk/constants/address-provider.d.ts

@@ -31,6 +31,7 @@ export declare const AP_WETH_GATEWAY = "WETH_GATEWAY";
 export declare const AP_WETH_TOKEN = "WETH_TOKEN";
 export declare const AP_ZAPPER_REGISTER = "ZAPPER_REGISTER";
 export declare const AP_ZERO_PRICE_FEED = "ZERO_PRICE_FEED";
+export declare const AP_KYC_COMPRESSOR = "GLOBAL::KYC_COMPRESSOR";
 /**
  * Default address provider address for v3.1.0
  * Is determenistic and does not depend on the network type

package/dist/types/sdk/market/MarketRegister.d.ts

@@ -3,6 +3,7 @@ import type { MarketData, MarketFilter } from "../base/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
 import type { MarketStateHuman } from "../types/index.js";
 import { AddressMap } from "../utils/index.js";
+import { type DelegatedMulticall } from "../utils/viem/index.js";
 import type { CreditSuite } from "./credit/index.js";
 import { MarketConfiguratorContract } from "./MarketConfiguratorContract.js";
 import { MarketSuite } from "./MarketSuite.js";
@@ -30,13 +31,13 @@ export declare class MarketRegister extends ZapperRegister {
      **/
     hydrate(state: MarketData[]): void;
     /**
-     * Fetches all markets from the on-chain for the given market configurators.
+     * @internal
+     * Returns delegated multicalls for loading all markets from the on-chain
+     * market compressor. Used by the SDK to compose batched RPC calls.
      *
-     * @param marketConfigurators - Addresses of market configurator contracts to query.
-     * @param ignoreUpdateablePrices - When `true`, skips generating off-chain
-     *   price updates before loading
+     * @param configurators - Addresses of market configurator contracts to query.
      **/
-    loadMarkets(marketConfigurators: Address[], ignoreUpdateablePrices?: boolean): Promise<void>;
+    getLoadMulticalls(configurators: Address[]): DelegatedMulticall[];
     /**
      * The active filter used to scope market compressor queries.
      * @throws If the register has not been hydrated or attached yet.
@@ -52,10 +53,6 @@ export declare class MarketRegister extends ZapperRegister {
      * @param ignoreUpdateablePrices - When `true`, skips off-chain price updates.
      **/
     syncState(ignoreUpdateablePrices?: boolean): Promise<void>;
-    /**
-     * Loads new prices and price feeds for given oracles from PriceFeedCompressor, defaults to all oracles
-     */
-    updatePrices(oracles?: Address[]): Promise<void>;
     get watchAddresses(): Set<Address>;
     /**
      * Serializable snapshot of all loaded markets, suitable for hydration.

package/dist/types/sdk/market/MarketSuite.d.ts

@@ -4,6 +4,7 @@ import { SDKConstruct } from "../base/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
 import type { MarketStateHuman } from "../types/index.js";
 import { CreditSuite } from "./credit/index.js";
+import type { IKYCFactory } from "./kyc/types.js";
 import { type ILossPolicyContract } from "./loss-policy/index.js";
 import { MarketConfiguratorContract } from "./MarketConfiguratorContract.js";
 import type { IPriceOracleContract } from "./oracle/index.js";
@@ -22,6 +23,7 @@ export declare class MarketSuite extends SDKConstruct {
     readonly state: MarketData;
     constructor(sdk: OnchainSDK, marketData: MarketData);
     get underlying(): Address;
+    get kycFactory(): IKYCFactory | undefined;
     get dirty(): boolean;
     get watchAddresses(): Set<Address>;
     stateHuman(raw?: boolean): MarketStateHuman;

package/dist/types/sdk/market/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./adapters/index.js";
 export * from "./credit/index.js";
+export * from "./kyc/index.js";
 export * from "./MarketRegister.js";
 export * from "./MarketSuite.js";
 export * from "./oracle/index.js";

package/dist/types/sdk/market/kyc/KYCRegistry.d.ts

@@ -0,0 +1,52 @@
+import type { Address } from "abitype";
+import { SDKConstruct } from "../../base/index.js";
+import type { DelegatedMulticall } from "../../utils/viem/index.js";
+import { SecuritizeKYCFactory } from "./securitize/index.js";
+import type { KYCCompressorResponse, KYCInvestorData, KYCState, KYCStateHuman } from "./types.js";
+/**
+ * Registry of KYC underlying tokens and KYC factory contracts.
+ *
+ * Populated from the on-chain {@link https://github.com/Gearbox-protocol/periphery-v3 KYCCompressor}
+ * during SDK attach/hydrate. Provides methods to query investor-level data and
+ * to resolve KYC factory instances by address.
+ **/
+export declare class KYCRegistry extends SDKConstruct {
+    #private;
+    /**
+     * @internal
+     *
+     * Returns delegated multicalls for loading all KYC underlying tokens from the on-chain KYC compressor.
+     * Used by the SDK to compose batched RPC calls.
+     *
+     * @param configurators - Market configurators to query.
+     * @param kycFactories - KYC factory contracts to query.
+     */
+    getLoadMulticalls(configurators: Address[], kycFactories?: Address[]): DelegatedMulticall[];
+    /**
+     * Fetches decoded investor data from the on-chain KYC compressor.
+     *
+     * Each factory produces its own investor data (e.g. registered tokens,
+     * cached signatures, EIP-712 messages to sign).
+     *
+     * @param investor - Investor EOA address.
+     * @param factories_ - Optional subset of factory addresses to query.
+     *   When omitted, all loaded factories are used.
+     */
+    getInvestorData(investor: Address, factories_?: Address[]): Promise<KYCInvestorData[]>;
+    /** All loaded KYC factory instances. */
+    get factories(): SecuritizeKYCFactory[];
+    /** Raw KYC compressor response, or `undefined` before attach/hydrate. */
+    get state(): KYCState | undefined;
+    /**
+     * Returns a human-readable snapshot of the KYC state.
+     */
+    stateHuman(raw?: boolean): KYCStateHuman;
+    /**
+     * @internal
+     *
+     * Replaces the internal state with a new KYC compressor response.
+     * Rebuilds token metadata for KYC underlyings and re-instantiates factory
+     * wrappers.
+     */
+    setState(resp?: KYCCompressorResponse): void;
+}

package/dist/types/sdk/market/kyc/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./KYCRegistry.js";
+export * from "./securitize/index.js";
+export * from "./types.js";