@gearbox-protocol/sdk 17.7.0 → 17.9.0

package/dist/esm/{rewards/RewardsService.js → sdk/rewards/RewardsNamespace.js}

@@ -1,24 +1,27 @@
-import { MultichainConstruct } from "../onchain/base/MultichainConstruct.js";
-import "../onchain/index.js";
+import { MultichainConstruct } from "../../onchain/base/MultichainConstruct.js";
+import "../../onchain/index.js";
 import { fetchMerklUserRewards } from "./merkl-api.js";
 import { toMerklRewards } from "./toMerklRewards.js";
 import { toTurtleRewards } from "./toTurtleRewards.js";
 import { fetchTurtleWalletRewards, readTurtleClaimed } from "./turtle-api.js";
 import { getAddress } from "viem";
-//#region src/rewards/RewardsService.ts
-var RewardsService = class extends MultichainConstruct {
+//#region src/sdk/rewards/RewardsNamespace.ts
+/**
+* {@inheritDoc IRewards}
+**/
+var RewardsNamespace = class extends MultichainConstruct {
 	#keys;
-	constructor(sdk, keys = {}) {
-		super(sdk);
-		this.#keys = keys;
+	#ensureFresh;
+	constructor(onchain, keys, options) {
+		super(onchain);
+		this.#keys = keys ?? {};
+		this.#ensureFresh = options.ensureFresh;
 	}
 	/**
-	* Every claimable reward a wallet holds — Merkl campaigns and the Gearbox
-	* organisation's Turtle streams — across the chains the handle carries.
-	* A chain is `status: "error"` only when every source failed on it; a chain
-	* with nothing to claim is a `"success"` with no rewards.
+	* {@inheritDoc IRewards.list}
 	**/
 	async list(wallet, chainIds) {
+		await this.#ensureFresh?.(chainIds);
 		const { merklApiKey, turtleApiKey } = this.#keys;
 		const user = getAddress(wallet);
 		const turtle = turtleApiKey ? fetchTurtleWalletRewards(user, turtleApiKey) : void 0;
@@ -44,4 +47,4 @@ var RewardsService = class extends MultichainConstruct {
 	}
 };
 //#endregion
-export { RewardsService };
+export { RewardsNamespace };

package/dist/esm/{rewards → sdk/rewards}/errors.js

@@ -1,5 +1,5 @@
 import { BaseError } from "viem";
-//#region src/rewards/errors.ts
+//#region src/sdk/rewards/errors.ts
 /**
 * Thrown when Merkl did not answer for a chain.
 *

package/dist/esm/{rewards → sdk/rewards}/helpers.js

@@ -1,8 +1,8 @@
-import { AddressMap } from "../onchain/utils/AddressMap.js";
-import { toBigInt } from "../onchain/utils/formatter.js";
-import "../onchain/index.js";
+import { AddressMap } from "../../onchain/utils/AddressMap.js";
+import { toBigInt } from "../../onchain/utils/formatter.js";
+import "../../onchain/index.js";
 import { formatUnits, isAddress } from "viem";
-//#region src/rewards/helpers.ts
+//#region src/sdk/rewards/helpers.ts
 /**
 * The pool a source names, and its share token. A v3.1 pool is its own
 * ERC-4626 share token, so its address is the only token a campaign can name;

package/dist/esm/sdk/rewards/index.js

@@ -0,0 +1,3 @@
+import { MerklRequestFailedError, TurtleRequestFailedError } from "./errors.js";
+import { RewardsNamespace } from "./RewardsNamespace.js";
+export { MerklRequestFailedError, RewardsNamespace, TurtleRequestFailedError };

package/dist/esm/{rewards → sdk/rewards}/merkl-api.js

@@ -1,5 +1,5 @@
 import { MerklRequestFailedError } from "./errors.js";
-//#region src/rewards/merkl-api.ts
+//#region src/sdk/rewards/merkl-api.ts
 const MERKL_API_URL = "https://api.merkl.xyz";
 const MERKL_API_KEY_HEADER = "X-API-Key";
 /**

package/dist/esm/{rewards → sdk/rewards}/toMerklRewards.js

@@ -1,6 +1,6 @@
 import { mergeRewards, parseAmount, remaining, resolvePool, toRewardToken } from "./helpers.js";
 import { getAddress, isAddress } from "viem";
-//#region src/rewards/toMerklRewards.ts
+//#region src/sdk/rewards/toMerklRewards.ts
 /**
 * Merkl's answer for one chain, one reward per pool and incentive token.
 * A breakdown Merkl cannot be read from is skipped rather than thrown on: it

package/dist/esm/{rewards → sdk/rewards}/toTurtleRewards.js

@@ -1,6 +1,6 @@
 import { mergeRewards, parseAmount, remaining, resolvePool, toRewardToken } from "./helpers.js";
 import { formatUnits, getAddress, isAddress } from "viem";
-//#region src/rewards/toTurtleRewards.ts
+//#region src/sdk/rewards/toTurtleRewards.ts
 /**
 * The streams targeting a pool on the SDK's chain, merged per pool and
 * incentive. A token reward is what is committed and not yet claimed.

package/dist/esm/{rewards → sdk/rewards}/turtle-api.js

@@ -1,5 +1,5 @@
 import { TurtleRequestFailedError } from "./errors.js";
-//#region src/rewards/turtle-api.ts
+//#region src/sdk/rewards/turtle-api.ts
 const TURTLE_API_URL = "https://earn.turtle.xyz";
 const GEARBOX_ORG_ID = "d171ba3d-ff89-4e6c-8f13-d94840b06edd";
 const TIMEOUT = 1e4;

package/dist/esm/sdk/rewards/types.js

@@ -0,0 +1 @@
+export {};

package/dist/types/model/index.d.ts

@@ -30,7 +30,8 @@ import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema
 import { ChainFailed, ChainMetadata, ChainScoped, ChainSucceeded, DataResponse, DataSource, ResponseMetadata } from "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
 import { SDKError, SDKResult, SDKReturn, SafeValue, safeValue, sdkErr, sdkOk } from "./result.js";
+import { MerklReward, PointsReward, Reward } from "./rewards.js";
 import { kycRequirementSchema, rwaProtocolSchema } from "./rwa.schema.js";
 import { PositionClaimableWithdrawal, PositionPendingWithdrawal, PositionWithdrawals, WithdrawalOutputAmount } from "./withdrawals.js";
 import { positionClaimableWithdrawalSchema, positionPendingWithdrawalSchema, positionWithdrawalsSchema, withdrawalOutputAmountSchema } from "./withdrawals.schema.js";
-export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, AccountHoldings, AccountMetrics, AccountNotMidasGreenlistedError, AccountProjection, AccountStateChange, AdjustStrategyPositionPreview, Amount, AnalyticsChartQuery, AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition, ApyBreakdown, Asset, AssetType, BorrowLimitCause, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditAccountFrozenError, CreditAccountNotEmptyError, CreditAccountNotFoundError, CreditManagerPausedError, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DebtOutOfRangeError, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, ForbiddenTokenError, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, InvalidDelayedIntentError, KYC_REGISTRATION_LINKS, KycProtocol, KycRequirement, Leverage, LeverageOutOfRangeError, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, LiquidatorNotEligibleError, MalformedTransactionError, MarketExpiredError, MidasOpenAccountRequirements, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, NotEmergencyLiquidatorError, Notice, NoticeKind, NoticeSubject, OpenStrategyPositionPreview, OperationPreview, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationPreviewError, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPausedError, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, PoolSunsetError, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, ProtocolChartMetric, QuotaAsset, QuotaCountExceededError, QuotaLimitReachedError, RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOpenRequirementsError, RWAOperationArgs, RWAProtocol, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_PROTOCOLS, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ReservePriceLimitedError, ResponseMetadata, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, SECURITIZE_REGISTER_VAULT_TYPES, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnexpectedFailureError, UnpriceableTokenError, UnsupportedCollateralTokenError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedTokenPairError, UnsupportedZapperFunctionError, WithdrawalInProgressError, WithdrawalOutputAmount, accountNotMidasGreenlisted, amountSchema, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, creditAccountFrozen, creditAccountNotEmpty, creditAccountNotFound, creditManagerPaused, curatorNameSchema, curatorSchema, dataSourceSchema, debtOutOfRange, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, forbiddenToken, instantReceivedAssetSchema, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, isFilterSet, kycRequirementSchema, leverageOutOfRange, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, liquidatorNotEligible, malformedTransaction, marketExpired, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, notEmergencyLiquidator, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPaused, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, poolSunset, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, protocolChartMetricSchema, quotaAssetSchema, quotaCountExceeded, quotaLimitReached, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, reservePriceLimited, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, rwaOpenRequirementsNotMet, rwaProtocolSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, unexpectedFailure, unpriceableTokenError, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress, withdrawalOutputAmountSchema };
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, AccountHoldings, AccountMetrics, AccountNotMidasGreenlistedError, AccountProjection, AccountStateChange, AdjustStrategyPositionPreview, Amount, AnalyticsChartQuery, AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition, ApyBreakdown, Asset, AssetType, BorrowLimitCause, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditAccountFrozenError, CreditAccountNotEmptyError, CreditAccountNotFoundError, CreditManagerPausedError, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DebtOutOfRangeError, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, ForbiddenTokenError, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, InvalidDelayedIntentError, KYC_REGISTRATION_LINKS, KycProtocol, KycRequirement, Leverage, LeverageOutOfRangeError, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, LiquidatorNotEligibleError, MalformedTransactionError, MarketExpiredError, MerklReward, MidasOpenAccountRequirements, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, NotEmergencyLiquidatorError, Notice, NoticeKind, NoticeSubject, OpenStrategyPositionPreview, OperationPreview, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsReward, PointsRewardsPnL, PoolOperationPreviewError, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPausedError, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, PoolSunsetError, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, ProtocolChartMetric, QuotaAsset, QuotaCountExceededError, QuotaLimitReachedError, RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOpenRequirementsError, RWAOperationArgs, RWAProtocol, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_PROTOCOLS, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ReservePriceLimitedError, ResponseMetadata, Reward, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, SECURITIZE_REGISTER_VAULT_TYPES, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnexpectedFailureError, UnpriceableTokenError, UnsupportedCollateralTokenError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedTokenPairError, UnsupportedZapperFunctionError, WithdrawalInProgressError, WithdrawalOutputAmount, accountNotMidasGreenlisted, amountSchema, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, creditAccountFrozen, creditAccountNotEmpty, creditAccountNotFound, creditManagerPaused, curatorNameSchema, curatorSchema, dataSourceSchema, debtOutOfRange, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, forbiddenToken, instantReceivedAssetSchema, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, isFilterSet, kycRequirementSchema, leverageOutOfRange, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, liquidatorNotEligible, malformedTransaction, marketExpired, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, notEmergencyLiquidator, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPaused, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, poolSunset, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, protocolChartMetricSchema, quotaAssetSchema, quotaCountExceeded, quotaLimitReached, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, reservePriceLimited, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, rwaOpenRequirementsNotMet, rwaProtocolSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, unexpectedFailure, unpriceableTokenError, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress, withdrawalOutputAmountSchema };

package/dist/types/{rewards/types.d.ts → model/rewards.d.ts}

@@ -1,10 +1,7 @@
-import { ChainId, Token, TokenAmount } from "../model/primitives.js";
-import { PointsProgramPnL } from "../model/positions.js";
-import "../model/index.js";
-import { OnchainSDK } from "../onchain/OnchainSDK.js";
-import "../onchain/index.js";
+import { ChainId, Token, TokenAmount } from "./primitives.js";
+import { PointsProgramPnL } from "./positions.js";
 import { Address } from "viem";
-//#region src/rewards/types.d.ts
+//#region src/model/rewards.d.ts
 /**
  * One claimable token reward, denominated and priced.
  *
@@ -35,7 +32,5 @@ interface PointsReward extends Omit<MerklReward, "amount"> {
   readonly points: PointsProgramPnL;
 }
 type Reward = MerklReward | PointsReward;
-/** What the mapping needs off a chain's SDK, and nothing asynchronous. */
-type RewardsSdk = Pick<OnchainSDK, "chainId" | "marketRegister" | "tokensMeta">;
 //#endregion
-export { MerklReward, PointsReward, Reward, RewardsSdk };
+export { MerklReward, PointsReward, Reward };

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

@@ -5,12 +5,14 @@ import { ILiquidationsByMode } from "./liquidations/types.js";
 import { IOpportunities } from "./opportunities/types.js";
 import { IPositions } from "./positions/types.js";
 import { IPreviewByMode } from "./preview/types.js";
+import { IRewardsByMode } from "./rewards/types.js";
 import { GearboxSDKOptions, IGearboxSDK, INoticesByMode, Mode, OffchainByMode, OnchainByMode } from "./types.js";
 import "./analytics/index.js";
 import "./liquidations/index.js";
 import "./opportunities/index.js";
 import "./positions/index.js";
 import "./preview/index.js";
+import "./rewards/index.js";
 //#region src/sdk/GearboxSDK.d.ts
 /**
  * Default {@link GearboxSDKOptions.maxStateAgeSeconds}: the fastest poll an
@@ -68,6 +70,10 @@ declare class GearboxSDK<const M extends Mode = Mode> implements IGearboxSDK<M>
    * mode.
    **/
   readonly preview: IPreviewByMode[M];
+  /**
+   * Namespace for claimable rewards. Absent in `offchain` mode.
+   **/
+  readonly rewards: IRewardsByMode[M];
   /**
    * The banners the backend attaches to a pool opportunity or a strategy
    * position, see {@link Notice}. Top-level because the subject is either

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

@@ -4,7 +4,7 @@ import { BorrowState } from "../onchain/accounts/intents/borrow.js";
 import { LeverageBand } from "../onchain/accounts/intents/leverage-band.js";
 import { PoolOperationError } from "../onchain/validation/bundles/checkPoolOperation.js";
 import { IAnalytics, IAnalyticsByMode } from "./analytics/types.js";
-import { ILiquidations, ILiquidationsByMode } from "./liquidations/types.js";
+import { ILiquidations, ILiquidationsByMode, IsEmergencyLiquidatorProps } from "./liquidations/types.js";
 import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowParams, BorrowResult, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/types.js";
 import { ChainOf, PrepareApi } from "./prepare/PrepareApi.js";
 import "./prepare/index.js";
@@ -18,6 +18,7 @@ import "./utils/index.js";
 import { IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunityMergers } from "./opportunities/types.js";
 import { IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly } from "./positions/types.js";
 import { CheckOperationProps, IPreview, IPreviewByMode } from "./preview/types.js";
+import { IRewards, IRewardsByMode, RewardsKeys } from "./rewards/types.js";
 import { EnsureFreshChains, GearboxSDKOptions, IGearboxSDK, INotices, INoticesByMode, Mode, NamespaceOptions, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, PlainMultichainSDKOptions } from "./types.js";
 import { AbstractNamespace, MergedQuery } from "./AbstractNamespace.js";
 import { AnalyticsNamespace } from "./analytics/AnalyticsNamespace.js";
@@ -30,6 +31,11 @@ import { PositionsNamespace } from "./positions/PositionsNamespace.js";
 import "./positions/index.js";
 import { PreviewNamespace } from "./preview/PreviewNamespace.js";
 import "./preview/index.js";
+import { MerklRequestFailedError, TurtleRequestFailedError } from "./rewards/errors.js";
+import { MerkleXYZUserRewardsV4Response } from "./rewards/merkl-api.js";
+import { RewardsNamespace } from "./rewards/RewardsNamespace.js";
+import { TurtleWalletRewards } from "./rewards/turtle-api.js";
+import "./rewards/index.js";
 import { DEFAULT_MAX_STATE_AGE, GearboxSDK } from "./GearboxSDK.js";
 import { AllSourcesFailedError } from "./errors/AllSourcesFailedError.js";
 import { MissingSourceError } from "./errors/MissingSourceError.js";
@@ -39,4 +45,4 @@ import { SourceUnavailableError } from "./errors/SourceUnavailableError.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
 import { everyChainFailed } from "./errors/everyChainFailed.js";
 import "./errors/index.js";
-export { AbstractNamespace, AccountFlowError, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, AnalyticsNamespace, BorrowParams, BorrowPrepareRequest, BorrowResult, type BorrowState, ChainOf, ChainRef, CheckOperationProps, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, EnsureFreshChains, type EntityMerger, ExecuteApi, type ExecutionCost, type FilterResult, FinalizeParams, FinalizeResult, GearboxSDK, GearboxSDKOptions, IAnalytics, IAnalyticsByMode, IGearboxSDK, ILiquidations, ILiquidationsByMode, INotices, INoticesByMode, IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesExecute, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunitiesPrepare, IOpportunityMergers, IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, IPreview, IPreviewByMode, type LeverageBand, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, type MergeListResult, MergedQuery, MissingSourceError, Mode, type MultipleDelayedWithdrawalsError, NamespaceOptions, type NoDelayedRouteError, type NoRecordedIntentError, NoSourceServedError, type NoStrategyTargetCollateralError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenEmptyPrepareRequest, OpenFlowError, OpenPrepareRequest, OpenStrategyParams, OpenStrategyResult, type OperationState, OpportunitiesNamespace, type PathLossRate, PlainMultichainSDKOptions, PoolInput, type PoolOperationError, PoolPrepareRequest, PositionInput, PositionsNamespace, PrepareApi, PrepareOptions, PrepareRequest, PreviewNamespace, RepayStrategyParams, type RouteErrors, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, unexpectedFailure };
+export { AbstractNamespace, AccountFlowError, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, AnalyticsNamespace, BorrowParams, BorrowPrepareRequest, BorrowResult, type BorrowState, ChainOf, ChainRef, CheckOperationProps, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, EnsureFreshChains, type EntityMerger, ExecuteApi, type ExecutionCost, type FilterResult, FinalizeParams, FinalizeResult, GearboxSDK, GearboxSDKOptions, IAnalytics, IAnalyticsByMode, IGearboxSDK, ILiquidations, ILiquidationsByMode, INotices, INoticesByMode, IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesExecute, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunitiesPrepare, IOpportunityMergers, IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, IPreview, IPreviewByMode, type IRewards, type IRewardsByMode, IsEmergencyLiquidatorProps, type LeverageBand, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, type MergeListResult, MergedQuery, MerklRequestFailedError, type MerkleXYZUserRewardsV4Response, MissingSourceError, Mode, type MultipleDelayedWithdrawalsError, NamespaceOptions, type NoDelayedRouteError, type NoRecordedIntentError, NoSourceServedError, type NoStrategyTargetCollateralError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenEmptyPrepareRequest, OpenFlowError, OpenPrepareRequest, OpenStrategyParams, OpenStrategyResult, type OperationState, OpportunitiesNamespace, type PathLossRate, PlainMultichainSDKOptions, PoolInput, type PoolOperationError, PoolPrepareRequest, PositionInput, PositionsNamespace, PrepareApi, PrepareOptions, PrepareRequest, PreviewNamespace, RepayStrategyParams, type RewardsKeys, RewardsNamespace, type RouteErrors, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyResult, StrategyRoutesResult, TurtleRequestFailedError, type TurtleWalletRewards, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, unexpectedFailure };

package/dist/types/sdk/liquidations/LiquidationsNamespace.d.ts

@@ -6,7 +6,7 @@ import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps } from "../../onchain/accounts/liquidations/types.js";
 import { CheckLiquidationInput, CheckLiquidationOptions, LiquidationValidationError } from "../../onchain/validation/checkLiquidation.js";
 import "../../onchain/index.js";
-import { ILiquidations } from "./types.js";
+import { ILiquidations, IsEmergencyLiquidatorProps } from "./types.js";
 import { NamespaceOptions } from "../types.js";
 //#region src/sdk/liquidations/LiquidationsNamespace.d.ts
 /**
@@ -35,6 +35,10 @@ declare class LiquidationsNamespace implements ILiquidations {
    * {@inheritDoc ILiquidations.checkLiquidation}
    **/
   checkLiquidation(props: CheckLiquidationInput, options?: CheckLiquidationOptions): Promise<LiquidationValidationError[]>;
+  /**
+   * {@inheritDoc ILiquidations.isEmergencyLiquidator}
+   **/
+  isEmergencyLiquidator(props: IsEmergencyLiquidatorProps): boolean;
 }
 //#endregion
 export { LiquidationsNamespace };

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

@@ -1,3 +1,3 @@
-import { ILiquidations, ILiquidationsByMode } from "./types.js";
+import { ILiquidations, ILiquidationsByMode, IsEmergencyLiquidatorProps } from "./types.js";
 import { LiquidationsNamespace } from "./LiquidationsNamespace.js";
-export { ILiquidations, ILiquidationsByMode, LiquidationsNamespace };
+export { ILiquidations, ILiquidationsByMode, IsEmergencyLiquidatorProps, LiquidationsNamespace };

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

@@ -1,10 +1,11 @@
-import { TxCall } from "../../model/primitives.js";
+import { ChainId, TxCall } from "../../model/primitives.js";
 import { LiquidatableAccount, LiquidationDetails, LiquidationPosition } from "../../model/liquidations.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps } from "../../onchain/accounts/liquidations/types.js";
 import { CheckLiquidationInput, CheckLiquidationOptions, LiquidationValidationError } from "../../onchain/validation/checkLiquidation.js";
 import "../../onchain/index.js";
+import { Address } from "viem";
 //#region src/sdk/liquidations/types.d.ts
 /**
  * On-chain discovery of liquidatable credit accounts and delayed-withdrawal
@@ -38,6 +39,15 @@ interface ILiquidations {
    * with the same `liquidator`.
    **/
   checkLiquidation(props: CheckLiquidationInput, options?: CheckLiquidationOptions): Promise<LiquidationValidationError[]>;
+  /**
+   * Whether `liquidator` may liquidate while the facade is paused; `false` when unknown.
+   **/
+  isEmergencyLiquidator(props: IsEmergencyLiquidatorProps): boolean;
+}
+interface IsEmergencyLiquidatorProps {
+  chainId: ChainId;
+  creditManager: Address;
+  liquidator: Address;
 }
 /**
  * `sdk.liquidations` per mode: an on-chain read, absent when the SDK reads no
@@ -49,4 +59,4 @@ interface ILiquidationsByMode {
   both: ILiquidations;
 }
 //#endregion
-export { ILiquidations, ILiquidationsByMode };
+export { ILiquidations, ILiquidationsByMode, IsEmergencyLiquidatorProps };

package/dist/types/sdk/rewards/RewardsNamespace.d.ts

@@ -0,0 +1,24 @@
+import { ChainId } from "../../model/primitives.js";
+import { DataResponse } from "../../model/response.js";
+import { Reward } from "../../model/rewards.js";
+import "../../model/index.js";
+import { MultichainSDK } from "../../onchain/MultichainSDK.js";
+import { MultichainConstruct } from "../../onchain/base/MultichainConstruct.js";
+import "../../onchain/index.js";
+import { IRewards, RewardsKeys } from "./types.js";
+import { NamespaceOptions } from "../types.js";
+import { Address } from "viem";
+//#region src/sdk/rewards/RewardsNamespace.d.ts
+/**
+ * {@inheritDoc IRewards}
+ **/
+declare class RewardsNamespace extends MultichainConstruct implements IRewards {
+  #private;
+  constructor(onchain: MultichainSDK, keys: RewardsKeys | undefined, options: NamespaceOptions);
+  /**
+   * {@inheritDoc IRewards.list}
+   **/
+  list(wallet: Address, chainIds?: ChainId[]): Promise<DataResponse<Reward[]>>;
+}
+//#endregion
+export { RewardsNamespace };

package/dist/types/{rewards → sdk/rewards}/errors.d.ts

@@ -1,7 +1,7 @@
-import { ChainId } from "../model/primitives.js";
-import "../model/index.js";
+import { ChainId } from "../../model/primitives.js";
+import "../../model/index.js";
 import { BaseError } from "viem";
-//#region src/rewards/errors.d.ts
+//#region src/sdk/rewards/errors.d.ts
 /**
  * Thrown when Merkl did not answer for a chain.
  *

package/dist/types/{rewards → sdk/rewards}/helpers.d.ts

@@ -1,8 +1,9 @@
-import { Token } from "../model/primitives.js";
-import "../model/index.js";
-import { MerklReward, RewardsSdk } from "./types.js";
+import { Token } from "../../model/primitives.js";
+import { MerklReward } from "../../model/rewards.js";
+import "../../model/index.js";
+import { RewardsSdk } from "./types.js";
 import { Address } from "viem";
-//#region src/rewards/helpers.d.ts
+//#region src/sdk/rewards/helpers.d.ts
 /** A claimable amount of one token in one pool, before it is merged. */
 interface RewardPart {
   pool: Address;

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

@@ -0,0 +1,6 @@
+import { IRewards, IRewardsByMode, RewardsKeys } from "./types.js";
+import { MerklRequestFailedError, TurtleRequestFailedError } from "./errors.js";
+import { MerkleXYZUserRewardsV4Response } from "./merkl-api.js";
+import { RewardsNamespace } from "./RewardsNamespace.js";
+import { TurtleWalletRewards } from "./turtle-api.js";
+export { type IRewards, type IRewardsByMode, MerklRequestFailedError, type MerkleXYZUserRewardsV4Response, type RewardsKeys, RewardsNamespace, TurtleRequestFailedError, type TurtleWalletRewards };

package/dist/types/{rewards → sdk/rewards}/merkl-api.d.ts

@@ -1,7 +1,7 @@
-import { ChainId } from "../model/primitives.js";
-import "../model/index.js";
+import { ChainId } from "../../model/primitives.js";
+import "../../model/index.js";
 import { Address } from "viem";
-//#region src/rewards/merkl-api.d.ts
+//#region src/sdk/rewards/merkl-api.d.ts
 interface MerkleXYZUserRewardsV4 {
   chain: MerkleXYZChain;
   rewards: Array<{

package/dist/types/{rewards → sdk/rewards}/toMerklRewards.d.ts

@@ -1,6 +1,8 @@
-import { MerklReward, RewardsSdk } from "./types.js";
+import { MerklReward } from "../../model/rewards.js";
+import "../../model/index.js";
+import { RewardsSdk } from "./types.js";
 import { MerkleXYZUserRewardsV4Response } from "./merkl-api.js";
-//#region src/rewards/toMerklRewards.d.ts
+//#region src/sdk/rewards/toMerklRewards.d.ts
 /**
  * Merkl's answer for one chain, one reward per pool and incentive token.
  * A breakdown Merkl cannot be read from is skipped rather than thrown on: it

package/dist/types/{rewards → sdk/rewards}/toTurtleRewards.d.ts

@@ -1,6 +1,8 @@
-import { Reward, RewardsSdk } from "./types.js";
+import { Reward } from "../../model/rewards.js";
+import "../../model/index.js";
+import { RewardsSdk } from "./types.js";
 import { TurtleWalletRewards } from "./turtle-api.js";
-//#region src/rewards/toTurtleRewards.d.ts
+//#region src/sdk/rewards/toTurtleRewards.d.ts
 /**
  * The streams targeting a pool on the SDK's chain, merged per pool and
  * incentive. A token reward is what is committed and not yet claimed.

package/dist/types/{rewards → sdk/rewards}/turtle-api.d.ts

@@ -1,7 +1,7 @@
-import { OnchainSDK } from "../onchain/OnchainSDK.js";
-import "../onchain/index.js";
+import { OnchainSDK } from "../../onchain/OnchainSDK.js";
+import "../../onchain/index.js";
 import { Address } from "viem";
-//#region src/rewards/turtle-api.d.ts
+//#region src/sdk/rewards/turtle-api.d.ts
 interface TurtleWalletStream {
   streamId: string;
   snapshots: Array<{

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

@@ -0,0 +1,35 @@
+import { ChainId } from "../../model/primitives.js";
+import { DataResponse } from "../../model/response.js";
+import { Reward } from "../../model/rewards.js";
+import "../../model/index.js";
+import { OnchainSDK } from "../../onchain/OnchainSDK.js";
+import "../../onchain/index.js";
+import { Address } from "viem";
+//#region src/sdk/rewards/types.d.ts
+/**
+ * Claimable Merkl and Turtle rewards.
+ **/
+interface IRewards {
+  /**
+   * Claimable rewards of `wallet`; a chain errors only when every source failed on it.
+   **/
+  list(wallet: Address, chainIds?: ChainId[]): Promise<DataResponse<Reward[]>>;
+}
+/**
+ * `sdk.rewards` per mode: absent when the SDK reads no chain.
+ **/
+interface IRewardsByMode {
+  onchain: IRewards;
+  offchain: undefined;
+  both: IRewards;
+}
+interface RewardsKeys {
+  /** Raises Merkl's rate limit; the keyless path answers too. */
+  merklApiKey?: string;
+  /** Turtle is skipped without one: its API answers no keyless request. */
+  turtleApiKey?: string;
+}
+/** What the mapping needs off a chain's SDK, and nothing asynchronous. */
+type RewardsSdk = Pick<OnchainSDK, "chainId" | "marketRegister" | "tokensMeta">;
+//#endregion
+export { IRewards, IRewardsByMode, RewardsKeys, RewardsSdk };

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

@@ -14,6 +14,7 @@ import { ILiquidationsByMode } from "./liquidations/types.js";
 import { IOpportunities } from "./opportunities/types.js";
 import { IPositions } from "./positions/types.js";
 import { IPreviewByMode } from "./preview/types.js";
+import { IRewardsByMode, RewardsKeys } from "./rewards/types.js";
 //#region src/sdk/types.d.ts
 /**
  * Which sources a {@link GearboxSDK} reads from, and therefore which of its
@@ -74,6 +75,10 @@ interface GearboxSDKOptions<M extends Mode = Mode> {
    * builds the on-chain source itself.
    **/
   attach?: MultichainAttachOptions;
+  /**
+   * API keys for {@link IGearboxSDK.rewards}.
+   **/
+  rewards?: RewardsKeys;
   logger?: ILogger;
 }
 /**
@@ -170,6 +175,10 @@ interface IGearboxSDK<M extends Mode = Mode> {
    * `offchain` mode.
    **/
   readonly preview: IPreviewByMode[M];
+  /**
+   * Namespace for claimable rewards. Absent in `offchain` mode.
+   **/
+  readonly rewards: IRewardsByMode[M];
   /**
    * The banners the backend attaches to a pool opportunity or a strategy
    * position, see {@link Notice}. Absent in `onchain` mode.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "17.7.0",
+  "version": "17.9.0",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {
@@ -58,11 +58,6 @@
       "types": "./dist/types/permissionless/index.d.ts",
       "import": "./dist/esm/permissionless/index.js",
       "default": "./dist/cjs/permissionless/index.js"
-    },
-    "./rewards": {
-      "types": "./dist/types/rewards/index.d.ts",
-      "import": "./dist/esm/rewards/index.js",
-      "default": "./dist/cjs/rewards/index.js"
     }
   },
   "files": [

package/dist/cjs/rewards/RewardsService.js

@@ -1,48 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_onchain_base_MultichainConstruct = require("../onchain/base/MultichainConstruct.js");
-require("../onchain/index.js");
-const require_rewards_merkl_api = require("./merkl-api.js");
-const require_rewards_toMerklRewards = require("./toMerklRewards.js");
-const require_rewards_toTurtleRewards = require("./toTurtleRewards.js");
-const require_rewards_turtle_api = require("./turtle-api.js");
-let viem = require("viem");
-//#region src/rewards/RewardsService.ts
-var RewardsService = class extends require_onchain_base_MultichainConstruct.MultichainConstruct {
-	#keys;
-	constructor(sdk, keys = {}) {
-		super(sdk);
-		this.#keys = keys;
-	}
-	/**
-	* Every claimable reward a wallet holds — Merkl campaigns and the Gearbox
-	* organisation's Turtle streams — across the chains the handle carries.
-	* A chain is `status: "error"` only when every source failed on it; a chain
-	* with nothing to claim is a `"success"` with no rewards.
-	**/
-	async list(wallet, chainIds) {
-		const { merklApiKey, turtleApiKey } = this.#keys;
-		const user = (0, viem.getAddress)(wallet);
-		const turtle = turtleApiKey ? require_rewards_turtle_api.fetchTurtleWalletRewards(user, turtleApiKey) : void 0;
-		turtle?.catch(() => {});
-		return this.queryChains({
-			chainIds,
-			label: "list rewards",
-			block: "state",
-			run: async (sdk) => {
-				const sources = [require_rewards_merkl_api.fetchMerklUserRewards({
-					chainId: sdk.chainId,
-					user,
-					apiKey: merklApiKey
-				}).then((response) => require_rewards_toMerklRewards.toMerklRewards(sdk, response))];
-				if (turtle) sources.push(turtle.then(async (rewards) => require_rewards_toTurtleRewards.toTurtleRewards(sdk, rewards, await require_rewards_turtle_api.readTurtleClaimed(sdk, user, rewards))));
-				const settled = await Promise.allSettled(sources);
-				const failed = settled.flatMap((r) => r.status === "rejected" ? [r.reason] : []);
-				if (failed.length === settled.length) throw failed.length === 1 ? failed[0] : new AggregateError(failed, "no rewards source answered");
-				for (const reason of failed) (sdk.logger ?? this.sdk.logger)?.warn(reason, `rewards source failed on chain ${sdk.chainId}`);
-				return settled.flatMap((r) => r.status === "fulfilled" ? r.value : []);
-			}
-		});
-	}
-};
-//#endregion
-exports.RewardsService = RewardsService;

package/dist/cjs/rewards/index.js

@@ -1,6 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rewards_errors = require("./errors.js");
-const require_rewards_RewardsService = require("./RewardsService.js");
-exports.MerklRequestFailedError = require_rewards_errors.MerklRequestFailedError;
-exports.RewardsService = require_rewards_RewardsService.RewardsService;
-exports.TurtleRequestFailedError = require_rewards_errors.TurtleRequestFailedError;

package/dist/cjs/rewards/package.json

@@ -1 +0,0 @@
-{"type": "commonjs"}

package/dist/esm/rewards/index.js

@@ -1,3 +0,0 @@
-import { MerklRequestFailedError, TurtleRequestFailedError } from "./errors.js";
-import { RewardsService } from "./RewardsService.js";
-export { MerklRequestFailedError, RewardsService, TurtleRequestFailedError };

package/dist/esm/rewards/package.json

@@ -1 +0,0 @@
-{"type": "module","sideEffects":false}

package/dist/types/rewards/RewardsService.d.ts

@@ -1,29 +0,0 @@
-import { ChainId } from "../model/primitives.js";
-import { DataResponse } from "../model/response.js";
-import "../model/index.js";
-import { PluginsMap } from "../onchain/plugins/types.js";
-import { MultichainSDK } from "../onchain/MultichainSDK.js";
-import { MultichainConstruct } from "../onchain/base/MultichainConstruct.js";
-import "../onchain/index.js";
-import { Reward } from "./types.js";
-import { Address } from "viem";
-//#region src/rewards/RewardsService.d.ts
-interface RewardsServiceKeys {
-  /** Raises Merkl's rate limit; the keyless path answers too. */
-  merklApiKey?: string;
-  /** Turtle is skipped without one: its API answers no keyless request. */
-  turtleApiKey?: string;
-}
-declare class RewardsService<const Plugins extends PluginsMap = {}> extends MultichainConstruct<Plugins> {
-  #private;
-  constructor(sdk: MultichainSDK<Plugins>, keys?: RewardsServiceKeys);
-  /**
-   * Every claimable reward a wallet holds — Merkl campaigns and the Gearbox
-   * organisation's Turtle streams — across the chains the handle carries.
-   * A chain is `status: "error"` only when every source failed on it; a chain
-   * with nothing to claim is a `"success"` with no rewards.
-   **/
-  list(wallet: Address, chainIds?: ChainId[]): Promise<DataResponse<Reward[]>>;
-}
-//#endregion
-export { RewardsService };

package/dist/types/rewards/index.d.ts

@@ -1,6 +0,0 @@
-import { MerklReward, PointsReward, Reward } from "./types.js";
-import { RewardsService } from "./RewardsService.js";
-import { MerklRequestFailedError, TurtleRequestFailedError } from "./errors.js";
-import { MerkleXYZUserRewardsV4Response } from "./merkl-api.js";
-import { TurtleWalletRewards } from "./turtle-api.js";
-export { MerklRequestFailedError, type MerklReward, type MerkleXYZUserRewardsV4Response, type PointsReward, type Reward, RewardsService, TurtleRequestFailedError, type TurtleWalletRewards };