@cygnus-wealth/data-models 1.2.0 → 1.4.0

package/dist/cjs/enums/ChainFamily.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainFamily = void 0;
+/**
+ * Classification of blockchain protocol families.
+ *
+ * Groups blockchain networks by their underlying protocol family rather than
+ * individual chain identity. Used for routing (which integration handles which
+ * addresses), discovery (which standard detects which providers), and display
+ * (chain family badges in UI).
+ *
+ * `ChainFamily` is distinct from `Chain` — a chain family contains multiple
+ * chains (e.g., EVM family includes Ethereum, Polygon, Arbitrum, etc.).
+ *
+ * This is a closed enum. Adding new families requires Enterprise Architecture
+ * approval, a new integration bounded context, and correlation registry entries.
+ *
+ * @example
+ * ```typescript
+ * import { ChainFamily } from '@cygnus-wealth/data-models';
+ *
+ * // Route address to correct integration
+ * function getIntegration(family: ChainFamily) {
+ *   switch (family) {
+ *     case ChainFamily.EVM:
+ *       return evmIntegration;
+ *     case ChainFamily.SOLANA:
+ *       return solIntegration;
+ *     default:
+ *       throw new Error(`No integration for ${family}`);
+ *   }
+ * }
+ * ```
+ *
+ * @since 1.5.0
+ * @stability extended
+ *
+ * @see {@link Chain} for specific chain identification within a family
+ */
+var ChainFamily;
+(function (ChainFamily) {
+    /** EVM-compatible chains (Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BSC, Base) */
+    ChainFamily["EVM"] = "evm";
+    /** Solana mainnet */
+    ChainFamily["SOLANA"] = "solana";
+    /** SUI mainnet (Move-based L1) */
+    ChainFamily["SUI"] = "sui";
+    /** Bitcoin mainnet (UTXO model) */
+    ChainFamily["BITCOIN"] = "bitcoin";
+    /** Cosmos ecosystem chains (Cosmos Hub, Osmosis, etc.) */
+    ChainFamily["COSMOS"] = "cosmos";
+    /** Aptos mainnet (Move-based L1) */
+    ChainFamily["APTOS"] = "aptos";
+})(ChainFamily || (exports.ChainFamily = ChainFamily = {}));

package/dist/cjs/enums/DeFiDiscoverySource.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeFiDiscoverySource = void 0;
+/**
+ * How a DeFi position was discovered during portfolio scanning.
+ *
+ * Distinguishes between positions found by scanning wallet token balances
+ * (receipt tokens like aTokens, cTokens, LP tokens) versus positions found
+ * by querying protocol smart contract state directly.
+ *
+ * This distinction matters for reconciliation: wallet-scanned positions are
+ * inferred from token holdings, while contract-queried positions come from
+ * authoritative on-chain state.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiDiscoverySource } from '@cygnus-wealth/data-models';
+ *
+ * // Found aUSDC in wallet — infer Aave supply position
+ * const walletDiscovered = DeFiDiscoverySource.WALLET_TOKEN_SCAN;
+ *
+ * // Queried Aave LendingPool.getUserAccountData() directly
+ * const contractDiscovered = DeFiDiscoverySource.CONTRACT_QUERY;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in position interfaces
+ */
+var DeFiDiscoverySource;
+(function (DeFiDiscoverySource) {
+    /** Position inferred from receipt/derivative tokens found in wallet balance scan */
+    DeFiDiscoverySource["WALLET_TOKEN_SCAN"] = "WALLET_TOKEN_SCAN";
+    /** Position discovered by querying protocol smart contract state directly */
+    DeFiDiscoverySource["CONTRACT_QUERY"] = "CONTRACT_QUERY";
+})(DeFiDiscoverySource || (exports.DeFiDiscoverySource = DeFiDiscoverySource = {}));

package/dist/cjs/enums/DeFiPositionType.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeFiPositionType = void 0;
+/**
+ * Classification of DeFi position types across protocols.
+ *
+ * Provides a unified taxonomy for all DeFi position categories, enabling
+ * consistent categorization regardless of the specific protocol. Used as
+ * a discriminator on the base {@link DeFiPosition} interface.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiPositionType } from '@cygnus-wealth/data-models';
+ *
+ * const positionType = DeFiPositionType.VAULT;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in the base position interface
+ */
+var DeFiPositionType;
+(function (DeFiPositionType) {
+    /** Yield vault deposit (Yearn, Beefy, Harvest, Sommelier) */
+    DeFiPositionType["VAULT"] = "VAULT";
+    /** Lending protocol supply position (Aave, Compound — depositing to earn interest) */
+    DeFiPositionType["LENDING_SUPPLY"] = "LENDING_SUPPLY";
+    /** Lending protocol borrow position (Aave, Compound — borrowing against collateral) */
+    DeFiPositionType["LENDING_BORROW"] = "LENDING_BORROW";
+    /** AMM liquidity pool position (Uniswap, Curve, Balancer) */
+    DeFiPositionType["LIQUIDITY_POOL"] = "LIQUIDITY_POOL";
+    /** Proof-of-stake or liquid staking position (Lido, Rocket Pool, native staking) */
+    DeFiPositionType["STAKING"] = "STAKING";
+    /** Yield farming / incentive mining position (LP rewards, token emissions) */
+    DeFiPositionType["FARMING"] = "FARMING";
+    /** Perpetual futures or leveraged position (Jupiter, GMX, dYdX) */
+    DeFiPositionType["PERP_POSITION"] = "PERP_POSITION";
+})(DeFiPositionType || (exports.DeFiPositionType = DeFiPositionType = {}));

package/dist/cjs/enums/DeFiProtocol.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeFiProtocol = void 0;
+/**
+ * Well-known DeFi protocol identifiers for position attribution.
+ *
+ * Provides standardized identifiers for major DeFi protocols across chains.
+ * Extensible via OTHER for protocols not yet explicitly enumerated.
+ * Protocol-specific version info (e.g., "Aave V3") should be stored in
+ * position metadata rather than the enum.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiProtocol } from '@cygnus-wealth/data-models';
+ *
+ * const protocol = DeFiProtocol.AAVE;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in position interfaces
+ */
+var DeFiProtocol;
+(function (DeFiProtocol) {
+    /** Beefy Finance — multi-chain yield optimizer / auto-compounder */
+    DeFiProtocol["BEEFY"] = "BEEFY";
+    /** Aave — decentralized lending and borrowing protocol */
+    DeFiProtocol["AAVE"] = "AAVE";
+    /** Uniswap — Ethereum-native AMM / DEX */
+    DeFiProtocol["UNISWAP"] = "UNISWAP";
+    /** Compound — algorithmic money market protocol */
+    DeFiProtocol["COMPOUND"] = "COMPOUND";
+    /** Lido — liquid staking for Ethereum and other PoS chains */
+    DeFiProtocol["LIDO"] = "LIDO";
+    /** Marinade Finance — liquid staking for Solana */
+    DeFiProtocol["MARINADE"] = "MARINADE";
+    /** Raydium — Solana AMM and liquidity provider */
+    DeFiProtocol["RAYDIUM"] = "RAYDIUM";
+    /** Jupiter — Solana DEX aggregator and perps platform */
+    DeFiProtocol["JUPITER"] = "JUPITER";
+    /** Orca — Solana concentrated liquidity DEX */
+    DeFiProtocol["ORCA"] = "ORCA";
+    /** Protocol not covered by other values; store name in metadata */
+    DeFiProtocol["OTHER"] = "OTHER";
+})(DeFiProtocol || (exports.DeFiProtocol = DeFiProtocol = {}));

package/dist/cjs/enums/IntegrationSource.js

@@ -64,6 +64,14 @@ var IntegrationSource;
     IntegrationSource["MANUAL_ENTRY"] = "MANUAL_ENTRY";
     /** Data fetched directly from blockchain via RPC */
     IntegrationSource["BLOCKCHAIN_DIRECT"] = "BLOCKCHAIN_DIRECT";
+    /** SUI blockchain integration */
+    IntegrationSource["SUI"] = "SUI";
+    /** Bitcoin blockchain integration */
+    IntegrationSource["BITCOIN"] = "BITCOIN";
+    /** Cosmos ecosystem integration */
+    IntegrationSource["COSMOS"] = "COSMOS";
+    /** Aptos blockchain integration */
+    IntegrationSource["APTOS"] = "APTOS";
     /** Other or unclassified data source */
     IntegrationSource["OTHER"] = "OTHER";
 })(IntegrationSource || (exports.IntegrationSource = IntegrationSource = {}));

package/dist/cjs/index.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VaultStrategyType = exports.LendingPositionType = exports.AccountType = exports.TransactionType = exports.IntegrationSource = exports.Chain = exports.AssetType = void 0;
+exports.DeFiDiscoverySource = exports.DeFiProtocol = exports.DeFiPositionType = exports.VaultStrategyType = exports.LendingPositionType = exports.AccountType = exports.TransactionType = exports.IntegrationSource = exports.ChainFamily = exports.Chain = exports.AssetType = void 0;
 // Enums
 var AssetType_1 = require("./enums/AssetType");
 Object.defineProperty(exports, "AssetType", { enumerable: true, get: function () { return AssetType_1.AssetType; } });
 var Chain_1 = require("./enums/Chain");
 Object.defineProperty(exports, "Chain", { enumerable: true, get: function () { return Chain_1.Chain; } });
+var ChainFamily_1 = require("./enums/ChainFamily");
+Object.defineProperty(exports, "ChainFamily", { enumerable: true, get: function () { return ChainFamily_1.ChainFamily; } });
 var IntegrationSource_1 = require("./enums/IntegrationSource");
 Object.defineProperty(exports, "IntegrationSource", { enumerable: true, get: function () { return IntegrationSource_1.IntegrationSource; } });
 var TransactionType_1 = require("./enums/TransactionType");
@@ -16,3 +18,9 @@ var LendingPositionType_1 = require("./enums/LendingPositionType");
 Object.defineProperty(exports, "LendingPositionType", { enumerable: true, get: function () { return LendingPositionType_1.LendingPositionType; } });
 var VaultStrategyType_1 = require("./enums/VaultStrategyType");
 Object.defineProperty(exports, "VaultStrategyType", { enumerable: true, get: function () { return VaultStrategyType_1.VaultStrategyType; } });
+var DeFiPositionType_1 = require("./enums/DeFiPositionType");
+Object.defineProperty(exports, "DeFiPositionType", { enumerable: true, get: function () { return DeFiPositionType_1.DeFiPositionType; } });
+var DeFiProtocol_1 = require("./enums/DeFiProtocol");
+Object.defineProperty(exports, "DeFiProtocol", { enumerable: true, get: function () { return DeFiProtocol_1.DeFiProtocol; } });
+var DeFiDiscoverySource_1 = require("./enums/DeFiDiscoverySource");
+Object.defineProperty(exports, "DeFiDiscoverySource", { enumerable: true, get: function () { return DeFiDiscoverySource_1.DeFiDiscoverySource; } });

package/dist/cjs/interfaces/AccountAssetEntry.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/AccountBalanceList.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/AccountGroup.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/AccountMetadata.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/AccountPortfolio.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/AccountSummary.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/AddressRequest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/AssetDistribution.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/ConnectedAccount.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/DeFiPosition.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/GroupPortfolio.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/TrackedAddress.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/WalletConnection.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/WalletPortfolio.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/interfaces/WatchAddress.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/AccountId.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/Caip2ChainId.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/WalletConnectionId.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/WalletProviderId.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/enums/ChainFamily.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Classification of blockchain protocol families.
+ *
+ * Groups blockchain networks by their underlying protocol family rather than
+ * individual chain identity. Used for routing (which integration handles which
+ * addresses), discovery (which standard detects which providers), and display
+ * (chain family badges in UI).
+ *
+ * `ChainFamily` is distinct from `Chain` — a chain family contains multiple
+ * chains (e.g., EVM family includes Ethereum, Polygon, Arbitrum, etc.).
+ *
+ * This is a closed enum. Adding new families requires Enterprise Architecture
+ * approval, a new integration bounded context, and correlation registry entries.
+ *
+ * @example
+ * ```typescript
+ * import { ChainFamily } from '@cygnus-wealth/data-models';
+ *
+ * // Route address to correct integration
+ * function getIntegration(family: ChainFamily) {
+ *   switch (family) {
+ *     case ChainFamily.EVM:
+ *       return evmIntegration;
+ *     case ChainFamily.SOLANA:
+ *       return solIntegration;
+ *     default:
+ *       throw new Error(`No integration for ${family}`);
+ *   }
+ * }
+ * ```
+ *
+ * @since 1.5.0
+ * @stability extended
+ *
+ * @see {@link Chain} for specific chain identification within a family
+ */
+export declare enum ChainFamily {
+    /** EVM-compatible chains (Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BSC, Base) */
+    EVM = "evm",
+    /** Solana mainnet */
+    SOLANA = "solana",
+    /** SUI mainnet (Move-based L1) */
+    SUI = "sui",
+    /** Bitcoin mainnet (UTXO model) */
+    BITCOIN = "bitcoin",
+    /** Cosmos ecosystem chains (Cosmos Hub, Osmosis, etc.) */
+    COSMOS = "cosmos",
+    /** Aptos mainnet (Move-based L1) */
+    APTOS = "aptos"
+}

package/dist/enums/ChainFamily.js

@@ -0,0 +1,51 @@
+/**
+ * Classification of blockchain protocol families.
+ *
+ * Groups blockchain networks by their underlying protocol family rather than
+ * individual chain identity. Used for routing (which integration handles which
+ * addresses), discovery (which standard detects which providers), and display
+ * (chain family badges in UI).
+ *
+ * `ChainFamily` is distinct from `Chain` — a chain family contains multiple
+ * chains (e.g., EVM family includes Ethereum, Polygon, Arbitrum, etc.).
+ *
+ * This is a closed enum. Adding new families requires Enterprise Architecture
+ * approval, a new integration bounded context, and correlation registry entries.
+ *
+ * @example
+ * ```typescript
+ * import { ChainFamily } from '@cygnus-wealth/data-models';
+ *
+ * // Route address to correct integration
+ * function getIntegration(family: ChainFamily) {
+ *   switch (family) {
+ *     case ChainFamily.EVM:
+ *       return evmIntegration;
+ *     case ChainFamily.SOLANA:
+ *       return solIntegration;
+ *     default:
+ *       throw new Error(`No integration for ${family}`);
+ *   }
+ * }
+ * ```
+ *
+ * @since 1.5.0
+ * @stability extended
+ *
+ * @see {@link Chain} for specific chain identification within a family
+ */
+export var ChainFamily;
+(function (ChainFamily) {
+    /** EVM-compatible chains (Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BSC, Base) */
+    ChainFamily["EVM"] = "evm";
+    /** Solana mainnet */
+    ChainFamily["SOLANA"] = "solana";
+    /** SUI mainnet (Move-based L1) */
+    ChainFamily["SUI"] = "sui";
+    /** Bitcoin mainnet (UTXO model) */
+    ChainFamily["BITCOIN"] = "bitcoin";
+    /** Cosmos ecosystem chains (Cosmos Hub, Osmosis, etc.) */
+    ChainFamily["COSMOS"] = "cosmos";
+    /** Aptos mainnet (Move-based L1) */
+    ChainFamily["APTOS"] = "aptos";
+})(ChainFamily || (ChainFamily = {}));

package/dist/enums/DeFiDiscoverySource.d.ts

@@ -0,0 +1,33 @@
+/**
+ * How a DeFi position was discovered during portfolio scanning.
+ *
+ * Distinguishes between positions found by scanning wallet token balances
+ * (receipt tokens like aTokens, cTokens, LP tokens) versus positions found
+ * by querying protocol smart contract state directly.
+ *
+ * This distinction matters for reconciliation: wallet-scanned positions are
+ * inferred from token holdings, while contract-queried positions come from
+ * authoritative on-chain state.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiDiscoverySource } from '@cygnus-wealth/data-models';
+ *
+ * // Found aUSDC in wallet — infer Aave supply position
+ * const walletDiscovered = DeFiDiscoverySource.WALLET_TOKEN_SCAN;
+ *
+ * // Queried Aave LendingPool.getUserAccountData() directly
+ * const contractDiscovered = DeFiDiscoverySource.CONTRACT_QUERY;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in position interfaces
+ */
+export declare enum DeFiDiscoverySource {
+    /** Position inferred from receipt/derivative tokens found in wallet balance scan */
+    WALLET_TOKEN_SCAN = "WALLET_TOKEN_SCAN",
+    /** Position discovered by querying protocol smart contract state directly */
+    CONTRACT_QUERY = "CONTRACT_QUERY"
+}

package/dist/enums/DeFiDiscoverySource.js

@@ -0,0 +1,34 @@
+/**
+ * How a DeFi position was discovered during portfolio scanning.
+ *
+ * Distinguishes between positions found by scanning wallet token balances
+ * (receipt tokens like aTokens, cTokens, LP tokens) versus positions found
+ * by querying protocol smart contract state directly.
+ *
+ * This distinction matters for reconciliation: wallet-scanned positions are
+ * inferred from token holdings, while contract-queried positions come from
+ * authoritative on-chain state.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiDiscoverySource } from '@cygnus-wealth/data-models';
+ *
+ * // Found aUSDC in wallet — infer Aave supply position
+ * const walletDiscovered = DeFiDiscoverySource.WALLET_TOKEN_SCAN;
+ *
+ * // Queried Aave LendingPool.getUserAccountData() directly
+ * const contractDiscovered = DeFiDiscoverySource.CONTRACT_QUERY;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in position interfaces
+ */
+export var DeFiDiscoverySource;
+(function (DeFiDiscoverySource) {
+    /** Position inferred from receipt/derivative tokens found in wallet balance scan */
+    DeFiDiscoverySource["WALLET_TOKEN_SCAN"] = "WALLET_TOKEN_SCAN";
+    /** Position discovered by querying protocol smart contract state directly */
+    DeFiDiscoverySource["CONTRACT_QUERY"] = "CONTRACT_QUERY";
+})(DeFiDiscoverySource || (DeFiDiscoverySource = {}));

package/dist/enums/DeFiPositionType.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Classification of DeFi position types across protocols.
+ *
+ * Provides a unified taxonomy for all DeFi position categories, enabling
+ * consistent categorization regardless of the specific protocol. Used as
+ * a discriminator on the base {@link DeFiPosition} interface.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiPositionType } from '@cygnus-wealth/data-models';
+ *
+ * const positionType = DeFiPositionType.VAULT;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in the base position interface
+ */
+export declare enum DeFiPositionType {
+    /** Yield vault deposit (Yearn, Beefy, Harvest, Sommelier) */
+    VAULT = "VAULT",
+    /** Lending protocol supply position (Aave, Compound — depositing to earn interest) */
+    LENDING_SUPPLY = "LENDING_SUPPLY",
+    /** Lending protocol borrow position (Aave, Compound — borrowing against collateral) */
+    LENDING_BORROW = "LENDING_BORROW",
+    /** AMM liquidity pool position (Uniswap, Curve, Balancer) */
+    LIQUIDITY_POOL = "LIQUIDITY_POOL",
+    /** Proof-of-stake or liquid staking position (Lido, Rocket Pool, native staking) */
+    STAKING = "STAKING",
+    /** Yield farming / incentive mining position (LP rewards, token emissions) */
+    FARMING = "FARMING",
+    /** Perpetual futures or leveraged position (Jupiter, GMX, dYdX) */
+    PERP_POSITION = "PERP_POSITION"
+}

package/dist/enums/DeFiPositionType.js

@@ -0,0 +1,36 @@
+/**
+ * Classification of DeFi position types across protocols.
+ *
+ * Provides a unified taxonomy for all DeFi position categories, enabling
+ * consistent categorization regardless of the specific protocol. Used as
+ * a discriminator on the base {@link DeFiPosition} interface.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiPositionType } from '@cygnus-wealth/data-models';
+ *
+ * const positionType = DeFiPositionType.VAULT;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in the base position interface
+ */
+export var DeFiPositionType;
+(function (DeFiPositionType) {
+    /** Yield vault deposit (Yearn, Beefy, Harvest, Sommelier) */
+    DeFiPositionType["VAULT"] = "VAULT";
+    /** Lending protocol supply position (Aave, Compound — depositing to earn interest) */
+    DeFiPositionType["LENDING_SUPPLY"] = "LENDING_SUPPLY";
+    /** Lending protocol borrow position (Aave, Compound — borrowing against collateral) */
+    DeFiPositionType["LENDING_BORROW"] = "LENDING_BORROW";
+    /** AMM liquidity pool position (Uniswap, Curve, Balancer) */
+    DeFiPositionType["LIQUIDITY_POOL"] = "LIQUIDITY_POOL";
+    /** Proof-of-stake or liquid staking position (Lido, Rocket Pool, native staking) */
+    DeFiPositionType["STAKING"] = "STAKING";
+    /** Yield farming / incentive mining position (LP rewards, token emissions) */
+    DeFiPositionType["FARMING"] = "FARMING";
+    /** Perpetual futures or leveraged position (Jupiter, GMX, dYdX) */
+    DeFiPositionType["PERP_POSITION"] = "PERP_POSITION";
+})(DeFiPositionType || (DeFiPositionType = {}));

package/dist/enums/DeFiProtocol.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Well-known DeFi protocol identifiers for position attribution.
+ *
+ * Provides standardized identifiers for major DeFi protocols across chains.
+ * Extensible via OTHER for protocols not yet explicitly enumerated.
+ * Protocol-specific version info (e.g., "Aave V3") should be stored in
+ * position metadata rather than the enum.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiProtocol } from '@cygnus-wealth/data-models';
+ *
+ * const protocol = DeFiProtocol.AAVE;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in position interfaces
+ */
+export declare enum DeFiProtocol {
+    /** Beefy Finance — multi-chain yield optimizer / auto-compounder */
+    BEEFY = "BEEFY",
+    /** Aave — decentralized lending and borrowing protocol */
+    AAVE = "AAVE",
+    /** Uniswap — Ethereum-native AMM / DEX */
+    UNISWAP = "UNISWAP",
+    /** Compound — algorithmic money market protocol */
+    COMPOUND = "COMPOUND",
+    /** Lido — liquid staking for Ethereum and other PoS chains */
+    LIDO = "LIDO",
+    /** Marinade Finance — liquid staking for Solana */
+    MARINADE = "MARINADE",
+    /** Raydium — Solana AMM and liquidity provider */
+    RAYDIUM = "RAYDIUM",
+    /** Jupiter — Solana DEX aggregator and perps platform */
+    JUPITER = "JUPITER",
+    /** Orca — Solana concentrated liquidity DEX */
+    ORCA = "ORCA",
+    /** Protocol not covered by other values; store name in metadata */
+    OTHER = "OTHER"
+}

package/dist/enums/DeFiProtocol.js

@@ -0,0 +1,43 @@
+/**
+ * Well-known DeFi protocol identifiers for position attribution.
+ *
+ * Provides standardized identifiers for major DeFi protocols across chains.
+ * Extensible via OTHER for protocols not yet explicitly enumerated.
+ * Protocol-specific version info (e.g., "Aave V3") should be stored in
+ * position metadata rather than the enum.
+ *
+ * @example
+ * ```typescript
+ * import { DeFiProtocol } from '@cygnus-wealth/data-models';
+ *
+ * const protocol = DeFiProtocol.AAVE;
+ * ```
+ *
+ * @since 1.3.0
+ * @stability extended
+ *
+ * @see {@link DeFiPosition} for usage in position interfaces
+ */
+export var DeFiProtocol;
+(function (DeFiProtocol) {
+    /** Beefy Finance — multi-chain yield optimizer / auto-compounder */
+    DeFiProtocol["BEEFY"] = "BEEFY";
+    /** Aave — decentralized lending and borrowing protocol */
+    DeFiProtocol["AAVE"] = "AAVE";
+    /** Uniswap — Ethereum-native AMM / DEX */
+    DeFiProtocol["UNISWAP"] = "UNISWAP";
+    /** Compound — algorithmic money market protocol */
+    DeFiProtocol["COMPOUND"] = "COMPOUND";
+    /** Lido — liquid staking for Ethereum and other PoS chains */
+    DeFiProtocol["LIDO"] = "LIDO";
+    /** Marinade Finance — liquid staking for Solana */
+    DeFiProtocol["MARINADE"] = "MARINADE";
+    /** Raydium — Solana AMM and liquidity provider */
+    DeFiProtocol["RAYDIUM"] = "RAYDIUM";
+    /** Jupiter — Solana DEX aggregator and perps platform */
+    DeFiProtocol["JUPITER"] = "JUPITER";
+    /** Orca — Solana concentrated liquidity DEX */
+    DeFiProtocol["ORCA"] = "ORCA";
+    /** Protocol not covered by other values; store name in metadata */
+    DeFiProtocol["OTHER"] = "OTHER";
+})(DeFiProtocol || (DeFiProtocol = {}));

package/dist/enums/IntegrationSource.d.ts

@@ -60,6 +60,14 @@ export declare enum IntegrationSource {
     MANUAL_ENTRY = "MANUAL_ENTRY",
     /** Data fetched directly from blockchain via RPC */
     BLOCKCHAIN_DIRECT = "BLOCKCHAIN_DIRECT",
+    /** SUI blockchain integration */
+    SUI = "SUI",
+    /** Bitcoin blockchain integration */
+    BITCOIN = "BITCOIN",
+    /** Cosmos ecosystem integration */
+    COSMOS = "COSMOS",
+    /** Aptos blockchain integration */
+    APTOS = "APTOS",
     /** Other or unclassified data source */
     OTHER = "OTHER"
 }