@gearbox-protocol/sdk 16.0.0-next.2 → 16.0.0-next.21

package/dist/esm/history/populateContractsRegister.js

@@ -1,11 +1,11 @@
-import { bytes32ToString } from "../sdk/utils/bytes32ToString.js";
-import { getNetworkType } from "../sdk/chain/chains.js";
-import { isV310 } from "../sdk/constants/versions.js";
-import { TokensMeta } from "../sdk/base/TokensMeta.js";
-import { createAdapter } from "../sdk/market/adapters/createAdapter.js";
-import { CreditFacadeV310BaseContract } from "../sdk/market/credit/CreditFacadeV310BaseContract.js";
-import { OnchainSDK } from "../sdk/OnchainSDK.js";
-import "../sdk/index.js";
+import { bytes32ToString } from "../onchain/utils/bytes32ToString.js";
+import { getNetworkType } from "../onchain/chain/chains.js";
+import { isV310 } from "../onchain/constants/versions.js";
+import { TokensMeta } from "../onchain/base/TokensMeta.js";
+import { createAdapter } from "../onchain/market/adapters/createAdapter.js";
+import { CreditFacadeV310BaseContract } from "../onchain/market/credit/CreditFacadeV310BaseContract.js";
+import { OnchainSDK } from "../onchain/OnchainSDK.js";
+import "../onchain/index.js";
 import { custom, isHex } from "viem";
 //#region src/history/populateContractsRegister.ts
 function populateContractsRegister(options) {

package/dist/esm/model/charts.js

@@ -31,7 +31,8 @@ const POOL_OPPORTUNITY_CHART_METRICS = [
 	"depositApyAvg7d",
 	"dieselRate",
 	"supplied",
-	"borrowed"
+	"borrowed",
+	"utilization"
 ];
 /**
 * Every metric a strategy opportunity can chart.
@@ -61,6 +62,7 @@ const STRATEGY_OPPORTUNITY_CHART_METRICS = [
 **/
 const POOL_POSITION_CHART_METRICS = [
 	"apy",
+	"apyAvg7d",
 	"pnl",
 	"mwr"
 ];
@@ -99,11 +101,13 @@ const CHART_METRIC_UNITS = {
 	supplied: "token",
 	borrowed: "token",
 	tvl: "token",
+	utilization: "bps",
 	dieselRate: "ratio",
 	collateralPrice: "ratio",
 	collateralUsdPrice: "usd",
 	underlyingUsdPrice: "usd",
 	apy: "bps",
+	apyAvg7d: "bps",
 	pnl: "token",
 	mwr: "bps",
 	totalValueUnderlying: "token",

package/dist/esm/model/compare.schema.js

@@ -12,6 +12,13 @@ function onchainOnly(schema) {
 	return schema.meta({ compare: "onchainOnly" });
 }
 /**
+* Marks a field whose backend value both-mode merge overlays onto the chain
+* row, so a source disagreement is expected.
+**/
+function backendPreferred(schema) {
+	return schema.meta({ compare: "backendPreferred" });
+}
+/**
 * Marks a numeric field whose two sources may drift within {@link kind}.
 **/
 function tolerance(schema, kind) {
@@ -26,4 +33,4 @@ function compareTagOf(schema) {
 	return meta.compare;
 }
 //#endregion
-export { compareTagOf, offchainOnly, onchainOnly, tolerance };
+export { backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance };

package/dist/esm/model/curators.schema.js

@@ -1,4 +1,4 @@
-import { ZodAddress } from "../sdk/utils/zod.js";
+import { ZodAddress } from "../onchain/utils/zod.js";
 import { offchainOnly } from "./compare.schema.js";
 import { z } from "zod/v4";
 //#region src/model/curators.schema.ts

package/dist/esm/model/index.js

@@ -1,6 +1,6 @@
 import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
-import { compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
-import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
+import { backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
 import "./curators.js";
 import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
@@ -12,11 +12,11 @@ import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAcc
 import "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
 import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
-import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
-import { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
+import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
+import { STRATEGY_POSITION_COLLATERAL_ERROR, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
 import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
-import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN } from "./previews.js";
+import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPRICEABLE_TOKEN, ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL } from "./previews.js";
 import "./primitives.js";
 import "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema };
+export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPRICEABLE_TOKEN, ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, amountSchema, apyBreakdownSchema, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema };

package/dist/esm/model/liquidations.schema.js

@@ -1,4 +1,4 @@
-import { ZodAddress } from "../sdk/utils/zod.js";
+import { ZodAddress } from "../onchain/utils/zod.js";
 import { assetTypeSchema, chainIdSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
 import { filterable } from "./filters.schema.js";
 import { z } from "zod/v4";

package/dist/esm/model/opportunities.schema.js

@@ -1,6 +1,6 @@
-import { ZodAddress } from "../sdk/utils/zod.js";
+import { ZodAddress } from "../onchain/utils/zod.js";
 import { offchainOnly, tolerance } from "./compare.schema.js";
-import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema } from "./primitives.schema.js";
+import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { curatorSchema } from "./curators.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
@@ -57,9 +57,8 @@ const opportunityBaseSchema = z.object({
 	chainId: chainIdSchema,
 	name: z.string(),
 	curator: curatorSchema,
-	underlyingToken: tokenSchema,
-	totalBorrow: amountSchema,
-	collateralTokens: z.array(tokenSchema),
+	underlyingToken: underlyingTokenSchema,
+	allowedDepositTokens: z.array(tokenSchema),
 	paused: z.boolean(),
 	rwa: z.boolean(),
 	sunset: z.boolean()
@@ -72,8 +71,8 @@ const quotaAssetSchema = z.object({
 	quotaRate: tolerance(bpsSchema, "bps"),
 	limit: amountSchema,
 	used: tolerance(amountSchema, "amount"),
-	allocationShare: tolerance(bpsSchema, "bps"),
-	allocatedDebt: tolerance(amountSchema, "amount")
+	allocationShare: offchainOnly(bpsSchema).optional(),
+	allocatedDebt: offchainOnly(amountSchema).optional()
 });
 /**
 * {@link PoolOpportunity}
@@ -84,7 +83,7 @@ const poolOpportunitySchema = z.object({
 	pool: ZodAddress(),
 	totalSupply: tolerance(amountSchema, "amount"),
 	availableLiquidity: tolerance(amountSchema, "amount"),
-	utilization: tolerance(bpsSchema, "bps"),
+	totalBorrowedWithInterest: tolerance(amountSchema, "amount"),
 	supplyApy: apyBreakdownSchema,
 	supplyApyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
 	quotaAssets: z.array(quotaAssetSchema)
@@ -97,6 +96,7 @@ const strategyOpportunitySchema = z.object({
 	kind: z.literal("strategy"),
 	creditManager: ZodAddress(),
 	targetCollateral: tokenSchema,
+	totalBorrowed: amountSchema,
 	liquidationThreshold: bpsSchema,
 	liquidationPremium: bpsSchema,
 	liquidationFee: bpsSchema,
@@ -244,5 +244,13 @@ const opportunityKeySchema = z.discriminatedUnion("kind", [z.object({
 	kind: z.literal("strategy"),
 	...strategyOpportunityKeySchema.shape
 })]);
+/**
+* {@link OpportunityTotals}
+**/
+const opportunityTotalsSchema = z.object({
+	tvl: z.number(),
+	totalBorrowed: z.number(),
+	totalSupply: z.number()
+});
 //#endregion
-export { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema };
+export { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema };

package/dist/esm/model/positions.js

@@ -1,6 +1,11 @@
 import { isFilterSet } from "./filters.js";
 //#region src/model/positions.ts
 /**
+* Set on {@link StrategyPosition.error} when the account could not be fully
+* valued (e.g. a dead price feed).
+**/
+const STRATEGY_POSITION_COLLATERAL_ERROR = "collateral computation failed";
+/**
 * Builds the canonical id of a pool position.
 *
 * @example
@@ -78,10 +83,10 @@ function matchesPositionFilter(position, filter) {
 **/
 function positionUnderlying(position) {
 	switch (position.kind) {
-		case "pool": return position.netValue.token;
-		case "strategy": return position.totalValue.token;
+		case "pool":
+		case "strategy": return position.underlyingToken;
 		case "liquidation": return;
 	}
 }
 //#endregion
-export { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };
+export { STRATEGY_POSITION_COLLATERAL_ERROR, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };

package/dist/esm/model/positions.schema.js

@@ -1,6 +1,6 @@
-import { ZodAddress, ZodBigInt, ZodHex } from "../sdk/utils/zod.js";
-import { offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
-import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema } from "./primitives.schema.js";
+import { ZodAddress, ZodBigInt, ZodHex } from "../onchain/utils/zod.js";
+import { backendPreferred, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
 import { delayedReceivedAssetSchema, liquidationPositionSchema } from "./liquidations.schema.js";
@@ -68,6 +68,7 @@ const poolPositionSchema = z.object({
 	name: z.string(),
 	chainId: chainIdSchema,
 	pool: ZodAddress(),
+	underlyingToken: underlyingTokenSchema,
 	netValue: tolerance(tokenAmountSchema, "amount"),
 	apy: apyBreakdownSchema,
 	apyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
@@ -94,11 +95,12 @@ const borrowRateBreakdownSchema = z.object({
 **/
 const strategyPositionSchema = z.object({
 	kind: z.literal("strategy"),
-	name: z.string(),
+	name: backendPreferred(z.string()),
 	chainId: chainIdSchema,
 	creditManager: ZodAddress(),
 	creditAccount: ZodAddress(),
-	targetCollateral: tokenSchema.nullable(),
+	underlyingToken: underlyingTokenSchema,
+	targetCollateral: backendPreferred(tokenSchema.nullable()),
 	leverage: tolerance(leverageSchema, "float"),
 	borrowApy: tolerance(bpsSchema, "bps"),
 	borrowApyAvg7D: offchainOnly(bpsSchema).optional(),
@@ -112,7 +114,8 @@ const strategyPositionSchema = z.object({
 	timeToLiquidation: onchainOnly(ZodBigInt().nullable()).optional(),
 	liquidationPrice: onchainOnly(ZodBigInt().nullable()).optional(),
 	pnl: offchainOnly(pnlBreakdownSchema).optional(),
-	collaterals: z.array(positionCollateralSchema)
+	collaterals: z.array(positionCollateralSchema),
+	error: z.string().optional()
 });
 /**
 * {@link Position}
@@ -190,7 +193,7 @@ const positionKeySchema = z.discriminatedUnion("kind", [z.object({
 **/
 const positionsTotalsSchema = z.object({
 	currentYield: apyBreakdownSchema.nullable(),
-	pnl: pnlBreakdownSchema.nullable(),
+	pnlUsd: z.number().nullable(),
 	netValueUsd: z.number().nullable(),
 	claimableUsd: z.number().nullable()
 });

package/dist/esm/model/previews.js

@@ -20,9 +20,10 @@ const ERROR_NON_ADAPTER_CALL_IN_BRACKET = 1003;
 **/
 const ERROR_UNPREVIEWABLE_ADAPTER_CALL = 1004;
 /**
-* Out-of-bracket RWA wrap/unwrap calldata cannot be decoded
+* An out-of-bracket adapter call that is allowed there (e.g. RWA wrap/unwrap)
+* could not be decoded or replayed
 **/
-const ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = 1005;
+const ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL = 1005;
 /**
 * `msg.value` does not fit into the declared WETH collateral
 * Transactions can have arbitrary value, but the ones that we create
@@ -32,4 +33,4 @@ const ERROR_INVALID_TRANSACTION_VALUE = 1006;
 /** A token in the preview could not be priced by the oracle */
 const ERROR_UNPRICEABLE_TOKEN = 2001;
 //#endregion
-export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN };
+export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPRICEABLE_TOKEN, ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL };

package/dist/esm/model/primitives.schema.js

@@ -1,4 +1,4 @@
-import { ZodAddress, ZodBigInt, ZodHex } from "../sdk/utils/zod.js";
+import { ZodAddress, ZodBigInt, ZodHex } from "../onchain/utils/zod.js";
 import { tolerance } from "./compare.schema.js";
 import { z } from "zod/v4";
 //#region src/model/primitives.schema.ts
@@ -54,6 +54,13 @@ const tokenSchema = z.object({
 	assetType: assetTypeSchema.optional()
 });
 /**
+* {@link UnderlyingToken}
+**/
+const underlyingTokenSchema = z.object({
+	...tokenSchema.shape,
+	wrappedAddress: ZodAddress().nullable()
+});
+/**
 * {@link TokenAmount}
 **/
 const tokenAmountSchema = amountSchema.extend({ token: tokenSchema });
@@ -66,4 +73,4 @@ const txCallSchema = z.object({
 	value: ZodBigInt().optional()
 });
 //#endregion
-export { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema };
+export { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema };

package/dist/esm/offchain/opportunities/OffchainOpportunities.js

@@ -1,4 +1,4 @@
-import { opportunityFilterQuerySchema, opportunitySchema, poolOpportunityDetailSchema, strategyOpportunityDetailSchema } from "../../model/opportunities.schema.js";
+import { opportunityFilterQuerySchema, opportunitySchema, opportunityTotalsSchema, poolOpportunityDetailSchema, strategyOpportunityDetailSchema } from "../../model/opportunities.schema.js";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
 import { z } from "zod/v4";
 //#region src/offchain/opportunities/OffchainOpportunities.ts
@@ -11,8 +11,7 @@ var OffchainOpportunities = class extends AbstractOffchainNamespace {
 		super("OffchainOpportunities", options);
 	}
 	/**
-	* Opportunities of the chains this client covers, optionally narrowed further
-	* by {@link OpportunityFilter}.
+	* {@inheritDoc IOffchainOpportunities.list}
 	**/
 	async list(filter) {
 		return this.get({
@@ -25,7 +24,7 @@ var OffchainOpportunities = class extends AbstractOffchainNamespace {
 		});
 	}
 	/**
-	* Detailed view of one pool opportunity.
+	* {@inheritDoc IOffchainOpportunities.getPool}
 	**/
 	async getPool(key) {
 		return this.get({
@@ -34,7 +33,7 @@ var OffchainOpportunities = class extends AbstractOffchainNamespace {
 		});
 	}
 	/**
-	* Detailed view of one strategy opportunity.
+	* {@inheritDoc IOffchainOpportunities.getStrategy}
 	**/
 	async getStrategy(key) {
 		return this.get({
@@ -43,7 +42,16 @@ var OffchainOpportunities = class extends AbstractOffchainNamespace {
 		});
 	}
 	/**
-	* Charts of one opportunity: one series per metric, on a shared grid.
+	* {@inheritDoc IOffchainOpportunities.getTotals}
+	**/
+	async getTotals() {
+		return this.get({
+			path: `${this.#root}/totals`,
+			schema: opportunityTotalsSchema
+		});
+	}
+	/**
+	* {@inheritDoc IOffchainOpportunities.getCharts}
 	**/
 	async getCharts(key, metrics, range) {
 		return this.readCharts(`${this.#chartRoot(key)}/charts`, metrics, range);

package/dist/esm/offchain/opportunities/index.js

@@ -1,2 +1,3 @@
 import { OffchainOpportunities } from "./OffchainOpportunities.js";
+import "./types.js";
 export { OffchainOpportunities };

package/dist/esm/offchain/positions/OffchainPositions.js

@@ -1,4 +1,4 @@
-import { positionFilterQuerySchema, positionSchema } from "../../model/positions.schema.js";
+import { positionFilterQuerySchema, positionSchema, positionsTotalsSchema } from "../../model/positions.schema.js";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
 import { z } from "zod/v4";
 //#region src/offchain/positions/OffchainPositions.ts
@@ -11,7 +11,7 @@ var OffchainPositions = class extends AbstractOffchainNamespace {
 		super("OffchainPositions", options);
 	}
 	/**
-	* Everything a wallet holds, optionally narrowed by {@link PositionFilter}.
+	* {@inheritDoc IOffchainPositions.list}
 	**/
 	async list(props) {
 		return this.get({
@@ -24,7 +24,16 @@ var OffchainPositions = class extends AbstractOffchainNamespace {
 		});
 	}
 	/**
-	* Charts of one position: one series per metric, on a shared grid.
+	* {@inheritDoc IOffchainPositions.getTotals}
+	**/
+	async getTotals(wallet) {
+		return this.get({
+			path: `${this.#root}/${wallet}/totals`,
+			schema: positionsTotalsSchema
+		});
+	}
+	/**
+	* {@inheritDoc IOffchainPositions.getCharts}
 	**/
 	async getCharts(key, metrics, range) {
 		return this.readCharts(`${this.#chartRoot(key)}/charts`, metrics, range);

package/dist/esm/offchain/positions/index.js

@@ -1,2 +1,3 @@
 import { OffchainPositions } from "./OffchainPositions.js";
+import "./types.js";
 export { OffchainPositions };

package/dist/esm/onchain/MultichainSDK.js

@@ -0,0 +1,186 @@
+import { getNetworkType } from "./chain/chains.js";
+import { ChainNotConfiguredError, SdkMissingChainStateError, SdkStateVersionMismatchError, SdkSyncFailedError } from "./core/errors.js";
+import { PriceUpdatesCache } from "./market/pricefeeds/updates/PriceUpdatesCache.js";
+import "./market/pricefeeds/updates/index.js";
+import { MultichainLiquidationsService } from "./accounts/liquidations/MultichainLiquidationsService.js";
+import "./accounts/index.js";
+import "./core/index.js";
+import { MultichainOpportunitiesService } from "./opportunities/MultichainOpportunitiesService.js";
+import "./opportunities/index.js";
+import { MultichainPositionsService } from "./positions/MultichainPositionsService.js";
+import "./positions/index.js";
+import { OnchainSDK } from "./OnchainSDK.js";
+//#region src/onchain/MultichainSDK.ts
+/**
+* Thin wrapper around multiple {@link OnchainSDK} instances, one per chain.
+*
+* @typeParam Plugins - Map of plugin names to plugin instances.
+**/
+var MultichainSDK = class {
+	#chains;
+	#redstoneCache;
+	#logger;
+	/**
+	* Namespace for liquidatable credit accounts discovery across all
+	* configured chains.
+	*/
+	liquidations;
+	/**
+	* Namespace for the pool and strategy opportunities of all configured
+	* chains.
+	*/
+	opportunities;
+	/**
+	* Namespace for the positions a wallet holds on all configured chains.
+	*/
+	positions;
+	constructor(options) {
+		this.#chains = /* @__PURE__ */ new Map();
+		this.#logger = options.logger;
+		for (const [network, chainConfig] of Object.entries(options.chains)) {
+			const { gasLimit, ...clientOptions } = chainConfig;
+			let plugins;
+			if (options.plugins) plugins = Object.fromEntries(Object.entries(options.plugins).map(([name, factory]) => [name, factory()]));
+			const sdkOptions = {
+				logger: options.logger?.child?.({ network }),
+				strictContractTypes: options.strictContractTypes,
+				gasLimit: gasLimit ?? options.gasLimit,
+				plugins
+			};
+			const sdk = new OnchainSDK(network, clientOptions, sdkOptions);
+			this.#chains.set(network, sdk);
+		}
+		this.liquidations = new MultichainLiquidationsService(this);
+		this.opportunities = new MultichainOpportunitiesService(this);
+		this.positions = new MultichainPositionsService(this);
+	}
+	/**
+	* Attach all configured chains in parallel.
+	*
+	* @param options - Shared and per-chain attach options.
+	*/
+	async attach(options) {
+		if (options?.redstone) this.#redstoneCache = new PriceUpdatesCache({
+			ttl: options.redstone.cacheTTL ?? 225e3,
+			historical: !!options.redstone.historicTimestamp
+		});
+		await Promise.all([...this.#chains.entries()].map(([network, sdk]) => {
+			const perChainOpts = options?.perChain?.[network] ?? {};
+			return sdk.attach({
+				...perChainOpts,
+				redstone: {
+					...options?.redstone,
+					cache: this.#redstoneCache,
+					...perChainOpts.redstone
+				}
+			});
+		}));
+		this.#logger?.info("Attached all chains");
+	}
+	/**
+	* Hydrate all configured chains from serialised state.
+	*
+	* @param state - Multichain serialised state.
+	* @param options - Shared and per-chain hydrate options.
+	* @throws {@link SdkStateVersionMismatchError} if version doesn't match.
+	* @throws {@link SdkMissingChainStateError} if a configured chain has no
+	*   state and `allowMissingChains` is not set.
+	*/
+	hydrate(state, options) {
+		if (state.version !== 2) throw new SdkStateVersionMismatchError(2, state.version);
+		if (options?.redstone) this.#redstoneCache = new PriceUpdatesCache({
+			ttl: options.redstone.cacheTTL ?? 225e3,
+			historical: !!options.redstone.historicTimestamp
+		});
+		const stateByNetwork = new Map(state.chains.map((cs) => [cs.network, cs]));
+		for (const [network, sdk] of this.#chains) {
+			const chainState = stateByNetwork.get(network);
+			if (!chainState) {
+				if (options?.allowMissingChains) continue;
+				throw new SdkMissingChainStateError(network);
+			}
+			const perChainOpts = options?.perChain?.[network] ?? {};
+			sdk.hydrate(chainState, {
+				...perChainOpts,
+				redstone: {
+					...options?.redstone,
+					cache: this.#redstoneCache,
+					...perChainOpts.redstone
+				}
+			});
+		}
+		this.#logger?.info("Hydrated all chains");
+	}
+	/**
+	* Returns the {@link OnchainSDK} for a given network or chain ID.
+	*
+	* @param networkOrChainId - Network type string or numeric chain ID.
+	* @throws If the network/chain is not configured.
+	*/
+	chain(networkOrChainId) {
+		let network;
+		if (typeof networkOrChainId === "number") network = getNetworkType(networkOrChainId);
+		else network = networkOrChainId;
+		const sdk = this.#chains.get(network);
+		if (!sdk) throw new ChainNotConfiguredError(networkOrChainId);
+		return sdk;
+	}
+	/**
+	* Read-only map of all configured chains.
+	**/
+	get chains() {
+		return this.#chains;
+	}
+	/**
+	* Shared logger, used for messages that are not attributable to a single
+	* chain. Per-chain messages should use the logger of the corresponding
+	* {@link OnchainSDK}.
+	**/
+	get logger() {
+		return this.#logger;
+	}
+	/**
+	* Sync state for all chains in parallel.
+	*
+	* @param opts - Sync options.
+	* @throws {@link SdkSyncFailedError} if any chain fails.
+	*/
+	async syncState(opts) {
+		const errors = {};
+		const results = await Promise.allSettled([...this.#chains.entries()].map(async ([_network, sdk]) => {
+			const block = await sdk.client.getBlock({ blockTag: "latest" });
+			if (!await sdk.syncState({
+				blockNumber: block.number,
+				timestamp: block.timestamp,
+				ignoreUpdateablePrices: opts?.ignoreUpdateablePrices
+			})) return;
+		}));
+		for (const [i, result] of results.entries()) if (result.status === "rejected") {
+			const network = [...this.#chains.keys()][i];
+			errors[network] = result.reason;
+		}
+		if (Object.keys(errors).length > 0) throw new SdkSyncFailedError(errors);
+		this.#logger?.info("Synced state for all chains");
+	}
+	/**
+	* Serialisable snapshot of all chains' state.
+	**/
+	get state() {
+		return {
+			version: 2,
+			chains: [...this.#chains.values()].map((sdk) => sdk.state)
+		};
+	}
+	/**
+	* Human-readable snapshot of all chains' state.
+	* @param raw - When `true`, include raw numeric values.
+	*/
+	stateHuman(raw) {
+		return {
+			version: 2,
+			chains: [...this.#chains.values()].map((sdk) => sdk.stateHuman(raw))
+		};
+	}
+};
+//#endregion
+export { MultichainSDK };