@leather.io/models 0.47.0 → 0.49.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @leather.io/models@0.47.0 build /home/runner/work/mono/mono/packages/models
+> @leather.io/models@0.49.0 build /home/runner/work/mono/mono/packages/models
 > tsup
 
 CLI Building entry: src/index.ts
@@ -8,9 +8,9 @@
 CLI Using tsup config: /home/runner/work/mono/mono/packages/models/tsup.config.ts
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js     20.49 KB
-ESM dist/index.js.map 46.81 KB
-ESM ⚡️ Build success in 41ms
+ESM dist/index.js     23.49 KB
+ESM dist/index.js.map 53.96 KB
+ESM ⚡️ Build success in 58ms
 DTS Build start
-DTS ⚡️ Build success in 2975ms
-DTS dist/index.d.ts 42.28 KB
+DTS ⚡️ Build success in 3295ms
+DTS dist/index.d.ts 48.67 KB

package/CHANGELOG.md

@@ -36,6 +36,54 @@
   * devDependencies
     * @leather.io/prettier-config bumped to 0.9.0
 
+## [0.49.0](https://github.com/leather-io/mono/compare/@leather.io/models-v0.48.0...@leather.io/models-v0.49.0) (2025-11-19)
+
+
+### Features
+
+* add alex swap provider ([152fd3a](https://github.com/leather-io/mono/commit/152fd3a6d015aace7bd682819a7d3d6112a64730))
+* add descriptors to get addresses rpc ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* add portfolio table ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* portfolio activity ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* portfolio ui hover, borders, token count ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add empty state ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add hover events ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add portfolio modal ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add stacked bar chart ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add stacks to portfolio list ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add tooltip ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** adjust hover events ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** bitcoin balance for portfolio ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** breakdown by allocation ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** scaffold portfolio page ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** sip10 avatar icons web ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** sip10 balances and assets ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** stacks portfolio balance ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+
+
+### Bug Fixes
+
+* **mobile:** ensure translations updated ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **mobile:** name is now defined for all models used ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* resolve type issues by using activity model util ([2a9cf6a](https://github.com/leather-io/mono/commit/2a9cf6a2f6909b0bf01729e0c7124f53025df305))
+* responsive portfolio ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** a few style fixes ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add loading spinner to asset list ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** add loading state to bar ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** ensure stacks renders in list ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** improve hover events and styles ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** invisible hover overlay ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** layout as per designs ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** remove unused ui ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+* **web:** remove unused var ([0e664a7](https://github.com/leather-io/mono/commit/0e664a7066a31776ac7e5ec60fa5a0ad893b96ff))
+
+## [0.48.0](https://github.com/leather-io/mono/compare/@leather.io/models-v0.47.0...@leather.io/models-v0.48.0) (2025-11-17)
+
+
+### Features
+
+* enhances yield model ([4833500](https://github.com/leather-io/mono/commit/48335001f0eae0eb79e1563d91ed568fff877d3a))
+
 ## [0.47.0](https://github.com/leather-io/mono/compare/@leather.io/models-v0.46.0...@leather.io/models-v0.47.0) (2025-11-14)
 
 

package/dist/index.d.ts

@@ -120,6 +120,8 @@ interface Sip9Collection {
     name: string;
     collectionExplorerUrl: string;
     totalItems?: number;
+    floorPrice?: Money;
+    latestSale?: Money;
 }
 interface Sip9AssetContent {
     contentUrl: string;
@@ -142,8 +144,6 @@ interface Sip9Asset extends BaseNonFungibleCryptoAsset {
     readonly attributes?: Sip9Attribute[];
     readonly collection?: Sip9Collection;
     readonly creator?: string;
-    readonly floorPrice?: Money;
-    readonly latestSale?: Money;
     readonly rarityRank?: number;
 }
 
@@ -201,11 +201,13 @@ interface BaseFungibleCryptoAsset extends BaseCryptoAsset {
 interface BtcAsset extends BaseFungibleCryptoAsset {
     readonly chain: 'bitcoin';
     readonly protocol: 'nativeBtc';
+    readonly name: 'Bitcoin';
     readonly symbol: 'BTC';
 }
 interface StxAsset extends BaseFungibleCryptoAsset {
     readonly chain: 'stacks';
     readonly protocol: 'nativeStx';
+    readonly name: 'Stacks';
     readonly symbol: 'STX';
 }
 interface Brc20Asset extends BaseFungibleCryptoAsset {
@@ -262,6 +264,7 @@ interface InscriptionAsset extends BaseNonFungibleCryptoAsset {
     readonly offset: string;
     readonly preview: string;
     readonly src: string;
+    readonly thumbnailSrc?: string;
     readonly value: string;
     readonly genesisBlockHash: string;
     readonly genesisTimestamp: number;
@@ -377,7 +380,6 @@ type Activity = OnChainActivity | WalletActivity | GeneralActivity;
 interface CryptoAssetId {
     protocol: CryptoAssetProtocol;
     id: string;
-    tokenId?: number;
 }
 
 declare function isFungibleAsset(asset: CryptoAsset): asset is FungibleCryptoAsset;
@@ -739,7 +741,8 @@ interface SwapProviderAsset {
     providerAssetId: string;
     assetId: CryptoAssetId;
 }
-interface SwapQuote {
+type SwapQuote = AlexSdkSwapQuote | VelarSdkSwapQuote | BitflowSdkSwapQuote | SbtcBridgeSwapQuote;
+interface BaseSwapQuote {
     executionType: SwapExecutionType;
     providerId: SwapProviderId;
     providerQuoteData: unknown;
@@ -749,6 +752,30 @@ interface SwapQuote {
     dexPath: SwapDex[];
     assetPath: (NativeCryptoAsset | Sip10Asset)[];
 }
+interface AlexSdkSwapQuote extends BaseSwapQuote {
+    providerId: 'alex-sdk';
+    providerQuoteData: {
+        baseProviderAssetId: string;
+        targetProviderAssetId: string;
+        alexSdkAmmRoute: unknown;
+    };
+}
+interface VelarSdkSwapQuote extends BaseSwapQuote {
+    providerId: 'velar-sdk';
+    providerQuoteData: {
+        baseProviderAssetId: string;
+        targetProviderAssetId: string;
+    };
+}
+interface BitflowSdkSwapQuote extends BaseSwapQuote {
+    providerId: 'bitflow-sdk';
+    providerQuoteData: {
+        bitflowSdkSelectedSwapRoute: unknown;
+    };
+}
+interface SbtcBridgeSwapQuote extends BaseSwapQuote {
+    providerId: 'sbtc-bridge';
+}
 interface SwapDex {
     name: string;
     url: string;
@@ -893,6 +920,11 @@ declare const YieldProviderKeys: {
     readonly zest: "zest";
     readonly granite: "granite";
     readonly stackingDao: "stackingdao";
+    readonly lisa: "lisa";
+    readonly hermetica: "hermetica";
+    readonly fastPool: "fast-pool";
+    readonly xverse: "xverse";
+    readonly velar: "velar";
 };
 type YieldProviderKey = (typeof YieldProviderKeys)[keyof typeof YieldProviderKeys];
 interface YieldProvider {
@@ -904,53 +936,77 @@ interface YieldProvider {
 
 declare const YieldProductKeys: {
     readonly bitflowAmmLp: "bitflow-amm-lp";
-    readonly zestBorrow: "zest-borrow";
-    readonly graniteV1: "granite-v1";
-    readonly stackingDaoLst: "stackingdao-lst";
+    readonly bitflowAmmStaking: "bitflow-amm-staking";
+    readonly zestBorrowMarket: "zest-borrow-market";
+    readonly graniteV1Earn: "granite-v1-earn";
+    readonly graniteV1Borrow: "granite-v1-borrow";
+    readonly stackingDaoStstx: "stackingdao-ststx";
+    readonly stackingDaoStstxbtc: "stackingdao-ststxbtc";
     readonly stackingDaoPooledStacking: "stackingdao-pooled-stacking";
+    readonly lisaListx: "lisa-listx";
+    readonly lisaLiquidStaking: "lisa-liquid-staking";
+    readonly hermeticaUsdhStaking: "hermetica-usdh-staking";
+    readonly velarAmmLp: "velar-amm-lp";
+    readonly velarPerps: "velar-perps";
+    readonly velarAmmLpFarming: "velar-amm-lp-farming";
+    readonly fastPoolPooledStacking: "fast-pool-pooled-stacking";
+    readonly xversePooledStacking: "xverse-pooled-stacking";
 };
 type YieldProductKey = (typeof YieldProductKeys)[keyof typeof YieldProductKeys];
 declare const YieldProductCategories: {
     readonly AMM: "amm";
     readonly LENDING: "lending";
-    readonly LST: "lst";
-    readonly CDP: "cdp";
+    readonly LIQUID_STACKING: "liquid-stacking";
     readonly POOLED_STACKING: "pooled-stacking";
+    readonly STAKING: "staking";
     readonly PERPS: "perps";
 };
 type YieldProductCategory = (typeof YieldProductCategories)[keyof typeof YieldProductCategories];
-declare const YieldProductToProtocolMap: {
+declare const YieldProductToProviderMap: {
     readonly "bitflow-amm-lp": "bitflow";
-    readonly "zest-borrow": "zest";
-    readonly "granite-v1": "granite";
-    readonly "stackingdao-lst": "stackingdao";
+    readonly "bitflow-amm-staking": "bitflow";
+    readonly "zest-borrow-market": "zest";
+    readonly "granite-v1-earn": "granite";
+    readonly "granite-v1-borrow": "granite";
+    readonly "stackingdao-ststx": "stackingdao";
+    readonly "stackingdao-ststxbtc": "stackingdao";
     readonly "stackingdao-pooled-stacking": "stackingdao";
+    readonly "lisa-listx": "lisa";
+    readonly "lisa-liquid-staking": "lisa";
+    readonly "hermetica-usdh-staking": "hermetica";
+    readonly "velar-amm-lp": "velar";
+    readonly "velar-perps": "velar";
+    readonly "velar-amm-lp-farming": "velar";
+    readonly "fast-pool-pooled-stacking": "fast-pool";
+    readonly "xverse-pooled-stacking": "xverse";
 };
-interface YieldProduct {
+type YieldProduct = BaseYieldProduct | PooledStackingYieldProduct;
+interface BaseYieldProduct {
     readonly key: YieldProductKey;
     readonly provider: YieldProviderKey;
+    readonly category: YieldProductCategory;
     readonly name: string;
     readonly url: string;
-    readonly category: YieldProductCategory;
-    readonly tvl?: Money;
+}
+interface PooledStackingYieldProduct extends BaseYieldProduct {
+    readonly category: 'pooled-stacking';
+    readonly stackerCount: number;
 }
 
 interface BaseYieldPosition {
+    readonly id: string;
     readonly provider: YieldProviderKey;
     readonly product: YieldProductKey;
     readonly totalBalance: Money;
-    readonly netApy?: number;
-    readonly updatedAtBlockHeight: number;
-    readonly updatedAt: Date;
+    readonly apy: number;
+}
+interface BasePooledStackingPosition extends BaseYieldPosition {
+    readonly stackedBalanceStx: Money;
 }
 
 interface BitflowAmmLpPosition extends BaseYieldPosition {
-    provider: typeof YieldProviderKeys.bitflow;
-    product: typeof YieldProductKeys.bitflowAmmLp;
-    pools: BitflowAmmLpPool[];
-}
-interface BitflowAmmLpPool {
-    apy: number;
+    provider: 'bitflow';
+    product: 'bitflow-amm-lp';
     poolSharePercentage: number;
     lpToken: {
         asset: FungibleCryptoAsset;
@@ -968,24 +1024,35 @@ interface BitflowAmmLpPool {
         balanceQuote: Money;
     };
 }
-
-interface GraniteV1Position extends BaseYieldPosition {
-    provider: typeof YieldProviderKeys.granite;
-    product: typeof YieldProductKeys.graniteV1;
-    collateralBalance: Money;
-    aeusdcMarket: {
+interface BitflowAmmStakingPosition extends BaseYieldPosition {
+    provider: 'bitflow';
+    product: 'bitflow-amm-staking';
+    stakedLpToken: {
         asset: FungibleCryptoAsset;
-        earnApy: number;
-        borrowApy: number;
-    };
-    earn?: {
         balance: Money;
         balanceQuote: Money;
     };
-    borrow?: {
+    rewardToken?: {
+        asset: FungibleCryptoAsset;
         balance: Money;
         balanceQuote: Money;
     };
+}
+
+interface GraniteV1EarnPosition extends BaseYieldPosition {
+    provider: 'granite';
+    product: 'granite-v1-earn';
+    marketAsset: FungibleCryptoAsset;
+    marketAssetSupplyBalance: Money;
+    marketAssetSupplyBalanceQuote: Money;
+}
+interface GraniteV1BorrowPosition extends BaseYieldPosition {
+    provider: 'granite';
+    product: 'granite-v1-borrow';
+    marketAsset: FungibleCryptoAsset;
+    marketAssetBorrowBalance: Money;
+    marketAssetBorrowBalanceQuote: Money;
+    collateralBalanceQuote: Money;
     collateral: GraniteV1CollateralAsset[];
 }
 interface GraniteV1CollateralAsset {
@@ -994,16 +1061,19 @@ interface GraniteV1CollateralAsset {
     balanceQuote: Money;
 }
 
-interface StackingDaoLstPosition extends BaseYieldPosition {
-    provider: typeof YieldProviderKeys.stackingDao;
-    product: typeof YieldProductKeys.stackingDaoLst;
-    totalBalance: Money;
+interface BaseStackingDaoLstPosition extends BaseYieldPosition {
+    provider: 'stackingdao';
     withdrawalsBalance: Money;
-    ststx?: StackingDaoLstHolding;
-    ststxbtc?: StackingDaoLstHolding;
-    sbtcReward?: StackingDaoReward;
+    lstHolding?: StackingDaoLstHolding;
     withdrawals: StackingDaoLstWithdrawal[];
 }
+interface StackingDaoStStxPosition extends BaseStackingDaoLstPosition {
+    product: 'stackingdao-ststx';
+}
+interface StackingDaoStStxBtcPosition extends BaseStackingDaoLstPosition {
+    product: 'stackingdao-ststxbtc';
+    sbtcReward?: StackingDaoReward;
+}
 interface StackingDaoLstHolding {
     asset: FungibleCryptoAsset;
     balance: Money;
@@ -1025,14 +1095,14 @@ interface StackingDaoLstWithdrawal {
     burnBlocksUntilUnlock: number;
     unlockBurnHeight: number;
 }
-interface StackingDaoPooledStackingPosition extends BaseYieldPosition {
-    provider: typeof YieldProviderKeys.stackingDao;
-    product: typeof YieldProductKeys.stackingDaoPooledStacking;
+interface StackingDaoPooledStackingPosition extends BasePooledStackingPosition {
+    provider: 'stackingdao';
+    product: 'stackingdao-pooled-stacking';
 }
 
-interface ZestBorrowPosition extends BaseYieldPosition {
-    provider: typeof YieldProviderKeys.zest;
-    product: typeof YieldProductKeys.zestBorrow;
+interface ZestBorrowMarketPosition extends BaseYieldPosition {
+    provider: 'zest';
+    product: 'zest-borrow-market';
     supplyBalance: Money;
     borrowBalance: Money;
     ltvPercentage: number;
@@ -1046,39 +1116,133 @@ interface ZestBorrowAsset {
     balanceQuote: Money;
 }
 
-type YieldPosition = BitflowAmmLpPosition | ZestBorrowPosition | GraniteV1Position | StackingDaoLstPosition | StackingDaoPooledStackingPosition;
+interface FastPoolPooledStackingPosition extends BasePooledStackingPosition {
+    provider: 'fast-pool';
+    product: 'fast-pool-pooled-stacking';
+}
+
+interface HermeticaUsdhStakingPosition extends BaseYieldPosition {
+    provider: 'hermetica';
+    product: 'hermetica-usdh-staking';
+    staking: HermeticaStaking;
+}
+interface HermeticaStaking {
+    asset: FungibleCryptoAsset;
+    balance: Money;
+    balanceQuote: Money;
+    apy: number;
+    rewardAsset?: FungibleCryptoAsset;
+    rewardBalance?: Money;
+    rewardBalanceQuote?: Money;
+}
+
+interface LisaLiStxPosition extends BaseYieldPosition {
+    provider: 'lisa';
+    product: 'lisa-listx';
+    holding: LisaLstHolding;
+}
+interface LisaLiquidStakingPosition extends BaseYieldPosition {
+    provider: 'lisa';
+    product: 'lisa-liquid-staking';
+    holding: LisaLstHolding;
+}
+interface LisaLstHolding {
+    asset: FungibleCryptoAsset;
+    balance: Money;
+    balanceQuote: Money;
+    apy: number;
+}
+
+interface VelarAmmLpPosition extends BaseYieldPosition {
+    provider: 'velar';
+    product: 'velar-amm-lp';
+    poolSharePercentage: number;
+    lpToken: {
+        asset: FungibleCryptoAsset;
+        balance: Money;
+        balanceQuote: Money;
+    };
+    tokenX: {
+        asset: FungibleCryptoAsset;
+        balance: Money;
+        balanceQuote: Money;
+    };
+    tokenY: {
+        asset: FungibleCryptoAsset;
+        balance: Money;
+        balanceQuote: Money;
+    };
+}
+interface VelarFarmPosition extends BaseYieldPosition {
+    provider: 'velar';
+    product: 'velar-amm-lp-farming';
+    stakedLpToken: {
+        asset: FungibleCryptoAsset;
+        balance: Money;
+        balanceQuote: Money;
+    };
+    rewardToken?: {
+        asset: FungibleCryptoAsset;
+        balance: Money;
+        balanceQuote: Money;
+    };
+}
+
+interface XversePooledStackingPosition extends BasePooledStackingPosition {
+    provider: 'xverse';
+    product: 'xverse-pooled-stacking';
+}
 
-declare function isBitflowPosition(pos: YieldPosition): pos is BitflowAmmLpPosition;
-declare function isZestPosition(pos: YieldPosition): pos is ZestBorrowPosition;
-declare function isGranitePosition(pos: YieldPosition): pos is GraniteV1Position;
-declare function isStackingDaoLstPosition(pos: YieldPosition): pos is StackingDaoLstPosition;
+type YieldPosition = BitflowAmmLpPosition | BitflowAmmStakingPosition | ZestBorrowMarketPosition | GraniteV1EarnPosition | GraniteV1BorrowPosition | StackingDaoStStxPosition | StackingDaoStStxBtcPosition | StackingDaoPooledStackingPosition | VelarAmmLpPosition | VelarFarmPosition | LisaLiStxPosition | LisaLiquidStakingPosition | HermeticaUsdhStakingPosition | FastPoolPooledStackingPosition | XversePooledStackingPosition;
+
+declare function isBitflowAmmLpPosition(pos: YieldPosition): pos is BitflowAmmLpPosition;
+declare function isBitflowAmmStakingPosition(pos: YieldPosition): pos is BitflowAmmStakingPosition;
+declare function isZestPosition(pos: YieldPosition): pos is ZestBorrowMarketPosition;
+declare function isGraniteEarnPosition(pos: YieldPosition): pos is GraniteV1EarnPosition;
+declare function isGraniteBorrowPosition(pos: YieldPosition): pos is GraniteV1BorrowPosition;
+declare function isStackingDaoStStxPosition(pos: YieldPosition): pos is StackingDaoStStxPosition;
+declare function isStackingDaoStStxBtcPosition(pos: YieldPosition): pos is StackingDaoStStxBtcPosition;
 declare function isStackingDaoPooledPosition(pos: YieldPosition): pos is StackingDaoPooledStackingPosition;
-declare function filterPositionsByProtocol(positions: YieldPosition[], protocol: YieldProviderKey): YieldPosition[];
+declare function filterPositionsByProvider(positions: YieldPosition[], provider: YieldProviderKey): YieldPosition[];
 declare function filterPositionsByProduct(positions: YieldPosition[], product: YieldProductKey): YieldPosition[];
 declare function filterPositionsByCategory(positions: YieldPosition[], products: YieldProduct[], category: YieldProductCategory): YieldPosition[];
 declare function sortPositionsByBalance(positions: YieldPosition[], ascending?: boolean): YieldPosition[];
 declare function sortPositionsByApy(positions: YieldPosition[], ascending?: boolean): YieldPosition[];
 declare function sortPositionsByUpdateTime(positions: YieldPosition[], ascending?: boolean): YieldPosition[];
-declare function getProtocolForProduct(product: YieldProductKey): YieldProviderKey;
+declare function getProviderForProduct(product: YieldProductKey): YieldProviderKey;
 declare function getCategoryForProduct(product: YieldProduct): YieldProductCategory;
-declare function isProductInProtocol(product: YieldProductKey, protocol: YieldProviderKey): boolean;
-declare function getProductsForProtocol(protocol: YieldProviderKey): YieldProductKey[];
+declare function isProductInProvider(product: YieldProductKey, provider: YieldProviderKey): boolean;
+declare function getProductsForProvider(provider: YieldProviderKey): YieldProductKey[];
 declare function getProductsInCategory(products: YieldProduct[], category: YieldProductCategory): YieldProduct[];
-declare function groupPositionsByProtocol(positions: YieldPosition[]): Record<YieldProviderKey, YieldPosition[]>;
+declare function groupPositionsByProvider(positions: YieldPosition[]): Record<YieldProviderKey, YieldPosition[]>;
 declare function groupPositionsByCategory(positions: YieldPosition[], products: YieldProduct[]): Record<string, YieldPosition[]>;
 declare function getPositionsInCategories(positions: YieldPosition[], products: YieldProduct[], categories: YieldProductCategory[]): YieldPosition[];
-declare function hasPositionsInProtocol(positions: YieldPosition[], protocol: YieldProviderKey): boolean;
+declare function hasPositionsInProvider(positions: YieldPosition[], provider: YieldProviderKey): boolean;
 declare function hasPositionsInCategory(positions: YieldPosition[], products: YieldProduct[], category: YieldProductCategory): boolean;
-declare function enrichPositionWithProtocol<T extends YieldPosition>(position: T, protocol: YieldProvider): T & {
-    protocolData: YieldProvider;
+declare function enrichPositionWithProvider<T extends YieldPosition>(position: T, provider: YieldProvider): T & {
+    providerData: YieldProvider;
 };
 declare function enrichPositionWithProduct<T extends YieldPosition>(position: T, product: YieldProduct): T & {
     productData: YieldProduct;
 };
-declare function enrichPositionWithMetadata<T extends YieldPosition>(position: T, protocol: YieldProvider, product: YieldProduct): T & {
-    protocolData: YieldProvider;
+declare function enrichPositionWithMetadata<T extends YieldPosition>(position: T, provider: YieldProvider, product: YieldProduct): T & {
+    providerData: YieldProvider;
     productData: YieldProduct;
 };
 declare function getCategoryDisplayName(category: YieldProductCategory): string;
 
-export { type AccountAddresses, type AccountDisplayPreference, type AccountDisplayPreferenceInfo, type AccountId, type AccountLevelActivity, type Activity, type ActivityLevel, ActivityLevels, type ActivityType, type AllowAdditionalProperties, type AnalyticsPreference, type AppLevelActivity, type AverageBitcoinFeeRates, BESTINSLOT_API_BASE_URL_MAINNET, BESTINSLOT_API_BASE_URL_TESTNET, BITCOIN_API_BASE_URL_MAINNET, BITCOIN_API_BASE_URL_SIGNET, BITCOIN_API_BASE_URL_TESTNET3, BITCOIN_API_BASE_URL_TESTNET4, BNS_V2_API_BASE_URL, type BaseActivity, type BaseCryptoAsset, type BaseCryptoAssetBalance, type BaseNonFungibleCryptoAsset, type BaseOnChainActivity, type BaseSwapExecutionData, type BaseTransactionFeeQuote, type BaseWalletActivity, type BaseYieldPosition, type BitcoinAddress, type BitcoinAddressInfo, type BitcoinChainConfig, type BitcoinNetwork, type BitcoinNetworkModes, type BitcoinTransaction, type BitcoinTransactionFeeQuote, type BitcoinTransactionVectorInput, type BitcoinTransactionVectorOutput, type BitcoinTransactionVin, type BitcoinTransactionVout, type BitcoinTx, type BitcoinUnit, type BitcoinUnitInfo, type BitcoinUnitSymbol, type BitflowAmmLpPool, type BitflowAmmLpPosition, type Blockchain, type BnsName, type BnsProfile, type BnsProfileData, type BnsProfileDataAddresses, type Brc20Asset, type BtcAsset, type BtcBalance, BtcFeeType, ChainId, type ConnectAppActivity, type CryptoAsset, type CryptoAssetBalance, CryptoAssetCategories, type CryptoAssetCategory, type CryptoAssetChain, CryptoAssetChains, type CryptoAssetId, type CryptoAssetProtocol, CryptoAssetProtocols, type CryptoCurrency, type Currency, type DefaultNetworkConfigurations, type DeploySmartContractActivity, type EmailAddress, type Entries, type EvmTransactionFeeQuote, type ExecuteSmartContractActivity, FeeCalculationTypes, FeeTypes, type Fees, type FlatTransactionFeeQuote, type FtTransfer, type FungibleAssetId, type FungibleCryptoAsset, type FungibleCryptoAssetProtocol, FungibleCryptoAssetProtocols, type GeneralActivity, type GeneralActivityType, GeneralActivityTypes, type GraniteV1CollateralAsset, type GraniteV1Position, HIRO_API_BASE_URL_MAINNET, HIRO_API_BASE_URL_MAINNET_EXTENDED, HIRO_API_BASE_URL_NAKAMOTO_TESTNET, HIRO_API_BASE_URL_TESTNET, HIRO_API_BASE_URL_TESTNET_EXTENDED, type HistoricalPeriod, type InscriptionAsset, type InscriptionMimeType, type LiteralUnion, type LockAssetActivity, type MarketData, type MarketPriceHistory, type MarketPriceSnapshot, type Money, type NativeCryptoAsset, type NetworkConfiguration, type NetworkModes, type NonFungibleCryptoAsset, type NonFungibleCryptoAssetProtocol, NonFungibleCryptoAssetProtocols, type NumType, type OnChainActivity, type OnChainActivityStatus, OnChainActivityStatuses, type OnChainActivityType, OnChainActivityTypes, type OwnedUtxo, type Prettify, type QuoteCurrency, type ReceiveAssetActivity, type ReplaceTypes, type RuneAsset, STX20_API_BASE_URL_MAINNET, type SbtcBridgeTransferSwapExecutionData, type SendAssetActivity, type SignMessageActivity, type Sip10Asset, type Sip9Asset, type Sip9AssetContent, type Sip9Attribute, type Sip9Collection, type Sip9ContentType, type Src20Asset, type StackingDaoLstHolding, type StackingDaoLstPosition, type StackingDaoLstWithdrawal, type StackingDaoPooledStackingPosition, type StackingDaoReward, type StacksAddressInfo, type StacksChainConfig, type StacksContractCallSwapExecutionData, type StacksFeeEstimate, type StacksTransactionFeeQuote, type StacksTx, type StacksTxStatus, type StampAsset, type Stx20Asset, type StxAsset, type StxBalance, type StxTransfer, type SupportedBlockchains, type SwapAsset, type SwapAssetsActivity, type SwapDex, type SwapExecutionData, type SwapExecutionType, type SwapProvider, type SwapProviderAsset, type SwapProviderId, type SwapQuote, type SwappableFungibleCryptoAsset, type TransactionErrorKey, type TransactionFeeQuote, type TransactionFeeQuoteType, type TransactionFeeTier, type TransactionFees, type Utxo, type UtxoId, type ValueOf, type WalletActivity, type WalletActivityType, WalletActivityTypes, WalletDefaultNetworkConfigurationIds, type WalletId, type YieldPosition, type YieldProduct, YieldProductCategories, type YieldProductCategory, type YieldProductKey, YieldProductKeys, YieldProductToProtocolMap, type YieldProvider, type YieldProviderKey, YieldProviderKeys, type ZestBorrowAsset, type ZestBorrowPosition, accountAddressesSchema, accountDisplayPreferenceSchema, accountIdSchema, analyticsPreferenceSchema, bitcoinAddressInfoSchema, bitcoinNetworkModesSchema, bitcoinNetworkSchema, bitcoinNetworkToNetworkMode, bitcoinNetworks, bitcoinUnitSchema, bnsContractAddress, bnsContractName, btcTxTimeMap, createMarketData, createMarketPair, defaultCurrentNetwork, defaultNetworkConfigurationsSchema, defaultNetworksKeyedById, emailAddressSchema, enrichPositionWithMetadata, enrichPositionWithProduct, enrichPositionWithProtocol, filterPositionsByCategory, filterPositionsByProduct, filterPositionsByProtocol, formatMarketPair, getCategoryDisplayName, getCategoryForProduct, getPositionsInCategories, getProductsForProtocol, getProductsInCategory, getProtocolForProduct, groupPositionsByCategory, groupPositionsByProtocol, hasPositionsInCategory, hasPositionsInProtocol, historicalPeriods, inscriptionMimeTypes, isBitflowPosition, isBrc20Asset, isBtcAsset, isFungibleAsset, isGranitePosition, isInscriptionAsset, isNativeAsset, isNonFungibleAsset, isProductInProtocol, isRuneAsset, isSip10Asset, isSip9Asset, isSrc20Asset, isStackingDaoLstPosition, isStackingDaoPooledPosition, isStampAsset, isStx20Asset, isStxAsset, isSwappableAsset, isZestPosition, networkConfigurationSchema, networkModes, sip9ContentTypes, sortPositionsByApy, sortPositionsByBalance, sortPositionsByUpdateTime, stacksAddressInfoSchema, supportedBlockchains, swapExecutionTypes, swapProviderIds, testnetModes, transactionFeeQuoteType, transactionFeeTiers, walletIdSchema };
+type BitcoinNetworkPreference = 'mainnet' | 'testnet4' | 'signet';
+interface MakeActivityArgs {
+    txid: string;
+    networkPreference: NetworkConfiguration;
+    asset?: CryptoAsset;
+}
+declare function makeActivityLink({ txid, networkPreference, asset }: MakeActivityArgs): string | null;
+interface GetMempoolExplorerLinkArgs {
+    id: string;
+    type: 'txid' | 'block';
+    networkPreference: BitcoinNetworkPreference;
+}
+declare function getMempoolExplorerLink({ id, type, networkPreference, }: GetMempoolExplorerLinkArgs): string | null;
+
+export { type AccountAddresses, type AccountDisplayPreference, type AccountDisplayPreferenceInfo, type AccountId, type AccountLevelActivity, type Activity, type ActivityLevel, ActivityLevels, type ActivityType, type AlexSdkSwapQuote, type AllowAdditionalProperties, type AnalyticsPreference, type AppLevelActivity, type AverageBitcoinFeeRates, BESTINSLOT_API_BASE_URL_MAINNET, BESTINSLOT_API_BASE_URL_TESTNET, BITCOIN_API_BASE_URL_MAINNET, BITCOIN_API_BASE_URL_SIGNET, BITCOIN_API_BASE_URL_TESTNET3, BITCOIN_API_BASE_URL_TESTNET4, BNS_V2_API_BASE_URL, type BaseActivity, type BaseCryptoAsset, type BaseCryptoAssetBalance, type BaseNonFungibleCryptoAsset, type BaseOnChainActivity, type BasePooledStackingPosition, type BaseSwapExecutionData, type BaseSwapQuote, type BaseTransactionFeeQuote, type BaseWalletActivity, type BaseYieldPosition, type BaseYieldProduct, type BitcoinAddress, type BitcoinAddressInfo, type BitcoinChainConfig, type BitcoinNetwork, type BitcoinNetworkModes, type BitcoinNetworkPreference, type BitcoinTransaction, type BitcoinTransactionFeeQuote, type BitcoinTransactionVectorInput, type BitcoinTransactionVectorOutput, type BitcoinTransactionVin, type BitcoinTransactionVout, type BitcoinTx, type BitcoinUnit, type BitcoinUnitInfo, type BitcoinUnitSymbol, type BitflowAmmLpPosition, type BitflowAmmStakingPosition, type BitflowSdkSwapQuote, type Blockchain, type BnsName, type BnsProfile, type BnsProfileData, type BnsProfileDataAddresses, type Brc20Asset, type BtcAsset, type BtcBalance, BtcFeeType, ChainId, type ConnectAppActivity, type CryptoAsset, type CryptoAssetBalance, CryptoAssetCategories, type CryptoAssetCategory, type CryptoAssetChain, CryptoAssetChains, type CryptoAssetId, type CryptoAssetProtocol, CryptoAssetProtocols, type CryptoCurrency, type Currency, type DefaultNetworkConfigurations, type DeploySmartContractActivity, type EmailAddress, type Entries, type EvmTransactionFeeQuote, type ExecuteSmartContractActivity, type FastPoolPooledStackingPosition, FeeCalculationTypes, FeeTypes, type Fees, type FlatTransactionFeeQuote, type FtTransfer, type FungibleAssetId, type FungibleCryptoAsset, type FungibleCryptoAssetProtocol, FungibleCryptoAssetProtocols, type GeneralActivity, type GeneralActivityType, GeneralActivityTypes, type GetMempoolExplorerLinkArgs, type GraniteV1BorrowPosition, type GraniteV1CollateralAsset, type GraniteV1EarnPosition, HIRO_API_BASE_URL_MAINNET, HIRO_API_BASE_URL_MAINNET_EXTENDED, HIRO_API_BASE_URL_NAKAMOTO_TESTNET, HIRO_API_BASE_URL_TESTNET, HIRO_API_BASE_URL_TESTNET_EXTENDED, type HermeticaStaking, type HermeticaUsdhStakingPosition, type HistoricalPeriod, type InscriptionAsset, type InscriptionMimeType, type LisaLiStxPosition, type LisaLiquidStakingPosition, type LisaLstHolding, type LiteralUnion, type LockAssetActivity, type MakeActivityArgs, type MarketData, type MarketPriceHistory, type MarketPriceSnapshot, type Money, type NativeCryptoAsset, type NetworkConfiguration, type NetworkModes, type NonFungibleCryptoAsset, type NonFungibleCryptoAssetProtocol, NonFungibleCryptoAssetProtocols, type NumType, type OnChainActivity, type OnChainActivityStatus, OnChainActivityStatuses, type OnChainActivityType, OnChainActivityTypes, type OwnedUtxo, type PooledStackingYieldProduct, type Prettify, type QuoteCurrency, type ReceiveAssetActivity, type ReplaceTypes, type RuneAsset, STX20_API_BASE_URL_MAINNET, type SbtcBridgeSwapQuote, type SbtcBridgeTransferSwapExecutionData, type SendAssetActivity, type SignMessageActivity, type Sip10Asset, type Sip9Asset, type Sip9AssetContent, type Sip9Attribute, type Sip9Collection, type Sip9ContentType, type Src20Asset, type StackingDaoLstHolding, type StackingDaoLstWithdrawal, type StackingDaoPooledStackingPosition, type StackingDaoReward, type StackingDaoStStxBtcPosition, type StackingDaoStStxPosition, type StacksAddressInfo, type StacksChainConfig, type StacksContractCallSwapExecutionData, type StacksFeeEstimate, type StacksTransactionFeeQuote, type StacksTx, type StacksTxStatus, type StampAsset, type Stx20Asset, type StxAsset, type StxBalance, type StxTransfer, type SupportedBlockchains, type SwapAsset, type SwapAssetsActivity, type SwapDex, type SwapExecutionData, type SwapExecutionType, type SwapProvider, type SwapProviderAsset, type SwapProviderId, type SwapQuote, type SwappableFungibleCryptoAsset, type TransactionErrorKey, type TransactionFeeQuote, type TransactionFeeQuoteType, type TransactionFeeTier, type TransactionFees, type Utxo, type UtxoId, type ValueOf, type VelarAmmLpPosition, type VelarFarmPosition, type VelarSdkSwapQuote, type WalletActivity, type WalletActivityType, WalletActivityTypes, WalletDefaultNetworkConfigurationIds, type WalletId, type XversePooledStackingPosition, type YieldPosition, type YieldProduct, YieldProductCategories, type YieldProductCategory, type YieldProductKey, YieldProductKeys, YieldProductToProviderMap, type YieldProvider, type YieldProviderKey, YieldProviderKeys, type ZestBorrowAsset, type ZestBorrowMarketPosition, accountAddressesSchema, accountDisplayPreferenceSchema, accountIdSchema, analyticsPreferenceSchema, bitcoinAddressInfoSchema, bitcoinNetworkModesSchema, bitcoinNetworkSchema, bitcoinNetworkToNetworkMode, bitcoinNetworks, bitcoinUnitSchema, bnsContractAddress, bnsContractName, btcTxTimeMap, createMarketData, createMarketPair, defaultCurrentNetwork, defaultNetworkConfigurationsSchema, defaultNetworksKeyedById, emailAddressSchema, enrichPositionWithMetadata, enrichPositionWithProduct, enrichPositionWithProvider, filterPositionsByCategory, filterPositionsByProduct, filterPositionsByProvider, formatMarketPair, getCategoryDisplayName, getCategoryForProduct, getMempoolExplorerLink, getPositionsInCategories, getProductsForProvider, getProductsInCategory, getProviderForProduct, groupPositionsByCategory, groupPositionsByProvider, hasPositionsInCategory, hasPositionsInProvider, historicalPeriods, inscriptionMimeTypes, isBitflowAmmLpPosition, isBitflowAmmStakingPosition, isBrc20Asset, isBtcAsset, isFungibleAsset, isGraniteBorrowPosition, isGraniteEarnPosition, isInscriptionAsset, isNativeAsset, isNonFungibleAsset, isProductInProvider, isRuneAsset, isSip10Asset, isSip9Asset, isSrc20Asset, isStackingDaoPooledPosition, isStackingDaoStStxBtcPosition, isStackingDaoStStxPosition, isStampAsset, isStx20Asset, isStxAsset, isSwappableAsset, isZestPosition, makeActivityLink, networkConfigurationSchema, networkModes, sip9ContentTypes, sortPositionsByApy, sortPositionsByBalance, sortPositionsByUpdateTime, stacksAddressInfoSchema, supportedBlockchains, swapExecutionTypes, swapProviderIds, testnetModes, transactionFeeQuoteType, transactionFeeTiers, walletIdSchema };