@lagoon-protocol/lagoon-mcp 0.5.0 → 0.7.0

package/dist/graphql/queries/export.queries.d.ts

@@ -19,7 +19,7 @@
  * );
  * ```
  */
-export declare const EXPORT_VAULTS_QUERY = "\n  query ExportVaults($addresses: [String!]!, $chainId: Int!) {\n    vaults(where: { address_in: $addresses, chainId_eq: $chainId }) {\n      items {\n        ...VaultFragment\n      }\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      totalAssets\n      totalAssetsUsd\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n      }\n      managementFee\n      performanceFee\n      protocolFee\n      isWhitelistActivated\n      whitelist\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n    bundles {\n      octav\n      debank\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
+export declare const EXPORT_VAULTS_QUERY = "\n  query ExportVaults($addresses: [String!]!, $chainId: Int!) {\n    vaults(where: { address_in: $addresses, chainId_eq: $chainId }) {\n      items {\n        ...VaultFragment\n      }\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    creationDate\n    inception\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      version\n      syncMode\n      isAsyncOnly\n      isPaused\n      safeLocked\n      superOperatorLocked\n      allowHighWaterMarkReset\n      accessMode\n      blacklist\n      externalSanctionsList\n      maxCap\n      totalAssets\n      totalAssetsUsd\n      totalAssetsExpiration\n      totalAssetsLifespan\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n        securityCouncil\n        superOperator\n      }\n      managementFee\n      performanceFee\n      protocolFee\n      entryRate\n      exitRate\n      haircutRate\n      upcomingManagementFee\n      upcomingPerformanceFee\n      feeRatesCooldown\n      newRatesTimestamp\n      guardrails {\n        activated\n        lowerRate\n        upperRate\n      }\n      isWhitelistActivated\n      whitelist\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n    bundles {\n      octav\n      debank\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    twrrNetApr\n    twrrNetAprWithoutExtraYields\n    twrrGrossAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
 /**
  * GraphQL query for transaction export
  *
@@ -36,11 +36,9 @@ export declare const EXPORT_VAULTS_QUERY = "\n  query ExportVaults($addresses: [
  * );
  * ```
  */
-export declare const EXPORT_TRANSACTIONS_QUERY = "\n  query ExportTransactions($vault_in: [Address!]!, $chainId: Int!, $first: Int!) {\n    transactions(\n      where: { vault_in: $vault_in, chainId_eq: $chainId },\n      orderBy: timestamp,\n      orderDirection: desc,\n      first: $first\n    ) {\n      items {\n        ...TransactionBaseFragment\n        data {\n          ... on SettleDeposit {\n            assetsDeposited\n            assetsDepositedUsd\n            sharesMinted\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n          ... on SettleRedeem {\n            assetsWithdrawed\n            assetsWithdrawedUsd\n            sharesBurned\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n          ... on DepositRequest {\n            owner\n            assets\n            assetsUsd\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n          ... on RedeemRequest {\n            owner\n            shares\n            sharesUsd\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n  \n  fragment TransactionBaseFragment on Transaction {\n    id\n    type\n    timestamp\n    blockNumber\n    hash\n    logIndex\n    chain {\n      id\n      name\n    }\n  }\n\n";
+export declare const EXPORT_TRANSACTIONS_QUERY = "\n  query ExportTransactions($vault_in: [Address!]!, $chainId: Int!, $first: Int!) {\n    transactions(\n      where: { vault_in: $vault_in, chainId_eq: $chainId },\n      orderBy: timestamp,\n      orderDirection: desc,\n      first: $first\n    ) {\n      items {\n        ...TransactionBaseFragment\n        data {\n          ... on SettleDeposit {\n            assetsDeposited\n            assetsDepositedUsd\n            sharesMinted\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n          ... on SettleRedeem {\n            assetsWithdrawed\n            assetsWithdrawedUsd\n            sharesBurned\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n          ... on DepositRequest {\n            owner\n            assets\n            assetsUsd\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n          ... on RedeemRequest {\n            owner\n            shares\n            sharesUsd\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n  \n  fragment TransactionBaseFragment on Transaction {\n    type\n    timestamp\n    blockNumber\n    hash\n    logIndex\n    chain {\n      id\n      name\n    }\n  }\n\n";
 /**
- * GraphQL query for price history export
- *
- * Fetches historical price data for OHLCV export.
+ * GraphQL query for price history export — typed PPS time series for one vault.
  *
  * Used by: export_data tool (dataType: 'price_history')
  *
@@ -48,11 +46,11 @@ export declare const EXPORT_TRANSACTIONS_QUERY = "\n  query ExportTransactions($
  * ```typescript
  * const data = await graphqlClient.request<PriceHistoryExportResponse>(
  *   EXPORT_PRICE_HISTORY_QUERY,
- *   { vault_in: ['0x...'], first: 1000 }
+ *   { vaultAddress: '0x...', chainId: 1 }
  * );
  * ```
  */
-export declare const EXPORT_PRICE_HISTORY_QUERY = "\n  query ExportPriceHistory($vault_in: [Address!]!, $first: Int!) {\n    transactions(\n      where: { vault_in: $vault_in, type_in: [TotalAssetsUpdated] },\n      orderBy: timestamp,\n      orderDirection: asc,\n      first: $first\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssets\n            totalAssetsUsd\n            totalSupply\n            vault {\n              id\n              address\n              symbol\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n";
+export declare const EXPORT_PRICE_HISTORY_QUERY = "\n  query ExportPriceHistory(\n    $vaultAddress: Address!,\n    $chainId: Int!,\n    $options: TimeRangeOptions\n  ) {\n    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {\n      address\n      symbol\n      decimals\n      asset {\n        decimals\n      }\n      stateHistory {\n        pricePerShareUsd(options: $options) {\n          x\n          y\n        }\n        totalAssetsUsd(options: $options) {\n          x\n          y\n        }\n      }\n    }\n  }\n";
 /**
  * GraphQL query for performance metrics export
  *

package/dist/graphql/queries/export.queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/export.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,w8FAS/B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,ovDAwErC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B,0oBA6BtC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,+aAmBpC,CAAC"}
+{"version":3,"file":"export.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/export.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,ynHAS/B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,4uDAwErC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,8eAyBtC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,+aAmBpC,CAAC"}

package/dist/graphql/queries/export.queries.js

@@ -120,9 +120,7 @@ export const EXPORT_TRANSACTIONS_QUERY = `
   ${TRANSACTION_BASE_FRAGMENT}
 `;
 /**
- * GraphQL query for price history export
- *
- * Fetches historical price data for OHLCV export.
+ * GraphQL query for price history export — typed PPS time series for one vault.
  *
  * Used by: export_data tool (dataType: 'price_history')
  *
@@ -130,35 +128,31 @@ export const EXPORT_TRANSACTIONS_QUERY = `
  * ```typescript
  * const data = await graphqlClient.request<PriceHistoryExportResponse>(
  *   EXPORT_PRICE_HISTORY_QUERY,
- *   { vault_in: ['0x...'], first: 1000 }
+ *   { vaultAddress: '0x...', chainId: 1 }
  * );
  * ```
  */
 export const EXPORT_PRICE_HISTORY_QUERY = `
-  query ExportPriceHistory($vault_in: [Address!]!, $first: Int!) {
-    transactions(
-      where: { vault_in: $vault_in, type_in: [TotalAssetsUpdated] },
-      orderBy: timestamp,
-      orderDirection: asc,
-      first: $first
-    ) {
-      items {
-        timestamp
-        data {
-          ... on TotalAssetsUpdated {
-            totalAssets
-            totalAssetsUsd
-            totalSupply
-            vault {
-              id
-              address
-              symbol
-              decimals
-              asset {
-                decimals
-              }
-            }
-          }
+  query ExportPriceHistory(
+    $vaultAddress: Address!,
+    $chainId: Int!,
+    $options: TimeRangeOptions
+  ) {
+    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {
+      address
+      symbol
+      decimals
+      asset {
+        decimals
+      }
+      stateHistory {
+        pricePerShareUsd(options: $options) {
+          x
+          y
+        }
+        totalAssetsUsd(options: $options) {
+          x
+          y
         }
       }
     }

package/dist/graphql/queries/export.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/export.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;IAQ/B,cAAc;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuErC,yBAAyB;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BzC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;CAmBvC,CAAC"}
+{"version":3,"file":"export.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/export.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;IAQ/B,cAAc;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuErC,yBAAyB;CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBzC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;CAmBvC,CAAC"}

package/dist/graphql/queries/index.d.ts

@@ -4,13 +4,14 @@
  * Central export point for all GraphQL queries.
  * Import from this file for convenience: `import { GET_VAULT_DATA_QUERY } from '../graphql/queries'`
  */
-export { GET_VAULT_DATA_QUERY, GET_VAULT_FOR_APR_QUERY, COMPARE_VAULTS_QUERY, VAULT_FIRST_TRANSACTION_QUERY, BATCH_VAULT_FIRST_TRANSACTIONS_QUERY, type BatchVaultFirstTransactionsResponse, } from './vault.queries.js';
-export { TRANSACTIONS_QUERY, PRICE_HISTORY_QUERY } from './transaction.queries.js';
+export { GET_VAULT_DATA_QUERY, GET_VAULT_FOR_APR_QUERY, COMPARE_VAULTS_QUERY, VAULT_FIRST_TRANSACTION_QUERY, BATCH_VAULT_FIRST_TRANSACTIONS_QUERY, PRICE_HISTORY_QUERY, type BatchVaultFirstTransactionsResponse, } from './vault.queries.js';
+export { TRANSACTIONS_QUERY } from './transaction.queries.js';
 export { GET_VAULT_PERFORMANCE_QUERY, GET_PERIOD_SUMMARIES_QUERY } from './performance.queries.js';
-export { GET_USER_PORTFOLIO_QUERY, createGetUserPortfolioQuery, type PortfolioResponseFormat, SINGLE_VAULT_OPTIMIZATION_QUERY, PORTFOLIO_OPTIMIZATION_QUERY, } from './portfolio.queries.js';
+export { GET_USER_PORTFOLIO_QUERY, createGetUserPortfolioQuery, type PortfolioResponseFormat, SINGLE_VAULT_OPTIMIZATION_QUERY, } from './portfolio.queries.js';
 export { RISK_ANALYSIS_QUERY, BATCH_RISK_ANALYSIS_QUERY, CROSS_CHAIN_VAULTS_QUERY, } from './risk.queries.js';
 export { YIELD_PREDICTION_QUERY, createYieldPredictionQuery, type PredictionResponseFormat, } from './prediction.queries.js';
 export { EXPORT_VAULTS_QUERY, EXPORT_TRANSACTIONS_QUERY, EXPORT_PRICE_HISTORY_QUERY, EXPORT_PERFORMANCE_QUERY, } from './export.queries.js';
 export { SEARCH_VAULTS_QUERY, createSearchVaultsQuery, type SearchVaultsResponseFormat, } from './search.queries.js';
 export { GET_VAULT_COMPOSITION_QUERY } from './composition.queries.js';
+export { GET_GLOBAL_TVL_QUERY, GET_INDEXING_STATUS_QUERY, LIST_CHAINS_QUERY, LIST_CURATORS_QUERY, GET_CURATOR_QUERY, GET_ASSET_QUERY, GET_HISTORICAL_STATE_QUERY, } from './discovery.queries.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/graphql/queries/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,6BAA6B,EAC7B,oCAAoC,EACpC,KAAK,mCAAmC,GACzC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,6BAA6B,EAC7B,oCAAoC,EACpC,mBAAmB,EACnB,KAAK,mCAAmC,GACzC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,+BAA+B,GAChC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAGvE,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC"}

package/dist/graphql/queries/index.js

@@ -5,13 +5,13 @@
  * Import from this file for convenience: `import { GET_VAULT_DATA_QUERY } from '../graphql/queries'`
  */
 // Vault Queries
-export { GET_VAULT_DATA_QUERY, GET_VAULT_FOR_APR_QUERY, COMPARE_VAULTS_QUERY, VAULT_FIRST_TRANSACTION_QUERY, BATCH_VAULT_FIRST_TRANSACTIONS_QUERY, } from './vault.queries.js';
+export { GET_VAULT_DATA_QUERY, GET_VAULT_FOR_APR_QUERY, COMPARE_VAULTS_QUERY, VAULT_FIRST_TRANSACTION_QUERY, BATCH_VAULT_FIRST_TRANSACTIONS_QUERY, PRICE_HISTORY_QUERY, } from './vault.queries.js';
 // Transaction Queries
-export { TRANSACTIONS_QUERY, PRICE_HISTORY_QUERY } from './transaction.queries.js';
+export { TRANSACTIONS_QUERY } from './transaction.queries.js';
 // Performance Queries
 export { GET_VAULT_PERFORMANCE_QUERY, GET_PERIOD_SUMMARIES_QUERY } from './performance.queries.js';
 // Portfolio Queries
-export { GET_USER_PORTFOLIO_QUERY, createGetUserPortfolioQuery, SINGLE_VAULT_OPTIMIZATION_QUERY, PORTFOLIO_OPTIMIZATION_QUERY, } from './portfolio.queries.js';
+export { GET_USER_PORTFOLIO_QUERY, createGetUserPortfolioQuery, SINGLE_VAULT_OPTIMIZATION_QUERY, } from './portfolio.queries.js';
 // Risk Queries
 export { RISK_ANALYSIS_QUERY, BATCH_RISK_ANALYSIS_QUERY, CROSS_CHAIN_VAULTS_QUERY, } from './risk.queries.js';
 // Prediction Queries
@@ -22,4 +22,6 @@ export { EXPORT_VAULTS_QUERY, EXPORT_TRANSACTIONS_QUERY, EXPORT_PRICE_HISTORY_QU
 export { SEARCH_VAULTS_QUERY, createSearchVaultsQuery, } from './search.queries.js';
 // Composition Queries
 export { GET_VAULT_COMPOSITION_QUERY } from './composition.queries.js';
+// Discovery Queries (Tier 2: thin wrappers around backend metadata endpoints)
+export { GET_GLOBAL_TVL_QUERY, GET_INDEXING_STATUS_QUERY, LIST_CHAINS_QUERY, LIST_CURATORS_QUERY, GET_CURATOR_QUERY, GET_ASSET_QUERY, GET_HISTORICAL_STATE_QUERY, } from './discovery.queries.js';
 //# sourceMappingURL=index.js.map

package/dist/graphql/queries/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,6BAA6B,EAC7B,oCAAoC,GAErC,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEnG,oBAAoB;AACpB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAE3B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,6BAA6B,EAC7B,oCAAoC,EACpC,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEnG,oBAAoB;AACpB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAE3B,+BAA+B,GAChC,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,8EAA8E;AAC9E,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC"}

package/dist/graphql/queries/performance.queries.d.ts

@@ -7,8 +7,10 @@
 /**
  * Vault performance GraphQL query
  *
- * Fetches transactions with TotalAssetsUpdated and PeriodSummary data for
- * historical metrics and trend analysis. Provides time-series performance data.
+ * Fetches TotalAssetsUpdated transactions for historical TVL time-series.
+ * Only TotalAssetsUpdated is queried because it carries totalAssetsUsd in
+ * USD. PeriodSummary records carry totalAssetsAtEnd as a raw token amount in
+ * wei, which is not USD-comparable.
  *
  * Used by: get_vault_performance tool
  *
@@ -19,7 +21,7 @@
  *   {
  *     where: {
  *       vault_in: ['0x...'],
- *       type_in: ['TotalAssetsUpdated', 'PeriodSummary']
+ *       type_in: ['TotalAssetsUpdated']
  *     },
  *     orderBy: 'timestamp',
  *     orderDirection: 'asc',
@@ -28,7 +30,7 @@
  * );
  * ```
  */
-export declare const GET_VAULT_PERFORMANCE_QUERY = "\n  query GetVaultPerformance(\n    $where: TransactionFilterInput!,\n    $orderBy: TransactionOrderBy!,\n    $orderDirection: OrderDirection!,\n    $first: Int!\n  ) {\n    transactions(\n      where: $where,\n      orderBy: $orderBy,\n      orderDirection: $orderDirection,\n      first: $first\n    ) {\n      items {\n        ...TransactionBaseFragment\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssetsUsd\n            totalAssets\n          }\n          ... on PeriodSummary {\n            duration\n            totalAssetsAtStart\n            totalAssetsAtEnd\n            totalSupplyAtStart\n            totalSupplyAtEnd\n            netTotalSupplyAtEnd\n          }\n        }\n      }\n      pageInfo {\n        ...PageInfoMinimalFragment\n      }\n    }\n  }\n  \n  fragment TransactionBaseFragment on Transaction {\n    id\n    type\n    timestamp\n    blockNumber\n    hash\n    logIndex\n    chain {\n      id\n      name\n    }\n  }\n\n  \n  fragment PageInfoMinimalFragment on PageInfo {\n    hasNextPage\n    hasPreviousPage\n  }\n\n";
+export declare const GET_VAULT_PERFORMANCE_QUERY = "\n  query GetVaultPerformance(\n    $where: TransactionFilterInput!,\n    $orderBy: TransactionOrderBy!,\n    $orderDirection: OrderDirection!,\n    $first: Int!\n  ) {\n    transactions(\n      where: $where,\n      orderBy: $orderBy,\n      orderDirection: $orderDirection,\n      first: $first\n    ) {\n      items {\n        ...TransactionBaseFragment\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssetsUsd\n            totalAssets\n          }\n        }\n      }\n      pageInfo {\n        ...PageInfoMinimalFragment\n      }\n    }\n  }\n  \n  fragment TransactionBaseFragment on Transaction {\n    type\n    timestamp\n    blockNumber\n    hash\n    logIndex\n    chain {\n      id\n      name\n    }\n  }\n\n  \n  fragment PageInfoMinimalFragment on PageInfo {\n    hasNextPage\n    hasPreviousPage\n  }\n\n";
 /**
  * Query to fetch period summaries for a vault
  *

package/dist/graphql/queries/performance.queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"performance.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/performance.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,2BAA2B,4jCAqCvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,0BAA0B,6wBAgCtC,CAAC"}
+{"version":3,"file":"performance.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/performance.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,2BAA2B,k1BA6BvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,0BAA0B,6wBAgCtC,CAAC"}

package/dist/graphql/queries/performance.queries.js

@@ -8,8 +8,10 @@ import { TRANSACTION_BASE_FRAGMENT, PAGEINFO_MINIMAL_FRAGMENT } from '../fragmen
 /**
  * Vault performance GraphQL query
  *
- * Fetches transactions with TotalAssetsUpdated and PeriodSummary data for
- * historical metrics and trend analysis. Provides time-series performance data.
+ * Fetches TotalAssetsUpdated transactions for historical TVL time-series.
+ * Only TotalAssetsUpdated is queried because it carries totalAssetsUsd in
+ * USD. PeriodSummary records carry totalAssetsAtEnd as a raw token amount in
+ * wei, which is not USD-comparable.
  *
  * Used by: get_vault_performance tool
  *
@@ -20,7 +22,7 @@ import { TRANSACTION_BASE_FRAGMENT, PAGEINFO_MINIMAL_FRAGMENT } from '../fragmen
  *   {
  *     where: {
  *       vault_in: ['0x...'],
- *       type_in: ['TotalAssetsUpdated', 'PeriodSummary']
+ *       type_in: ['TotalAssetsUpdated']
  *     },
  *     orderBy: 'timestamp',
  *     orderDirection: 'asc',
@@ -49,14 +51,6 @@ export const GET_VAULT_PERFORMANCE_QUERY = `
             totalAssetsUsd
             totalAssets
           }
-          ... on PeriodSummary {
-            duration
-            totalAssetsAtStart
-            totalAssetsAtEnd
-            totalSupplyAtStart
-            totalSupplyAtEnd
-            netTotalSupplyAtEnd
-          }
         }
       }
       pageInfo {

package/dist/graphql/queries/performance.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"performance.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/performance.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmCvC,yBAAyB;IACzB,yBAAyB;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BtC,yBAAyB;CAC5B,CAAC"}
+{"version":3,"file":"performance.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/performance.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BvC,yBAAyB;IACzB,yBAAyB;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BtC,yBAAyB;CAC5B,CAAC"}

package/dist/graphql/queries/portfolio.queries.d.ts

@@ -16,6 +16,10 @@ export type PortfolioResponseFormat = 'list' | 'summary' | 'full';
  *
  * Used by: get_user_portfolio tool
  *
+ * Aliases: `state.sharesUsd: usd` — backend deprecated
+ * `VaultPositionState.sharesUsd` (schema.gql:2466) in favor of `usd`. The alias
+ * keeps the downstream TS field name stable while reading the canonical field.
+ *
  * @param responseFormat - Detail level: 'list' (~60 tokens/vault), 'summary' (~170 tokens/vault), 'full' (~600 tokens/vault)
  * @returns GraphQL query string with appropriate fragment
  *
@@ -64,7 +68,7 @@ export declare const GET_USER_PORTFOLIO_QUERY: string;
  * );
  * ```
  */
-export declare const SINGLE_VAULT_OPTIMIZATION_QUERY = "\n  query SingleVaultOptimization($vaultAddress: Address!, $chainId: Int!) {\n    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {\n      ...VaultFragment\n    }\n\n    # Get price history for volatility calculation\n    priceHistory: transactions(\n      where: {\n        vault_in: [$vaultAddress],\n        type_in: [TotalAssetsUpdated]\n      },\n      orderBy: timestamp,\n      orderDirection: asc,\n      first: 1000\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssets\n            totalAssetsUsd\n            totalSupply\n            vault {\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      totalAssets\n      totalAssetsUsd\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n      }\n      managementFee\n      performanceFee\n      protocolFee\n      isWhitelistActivated\n      whitelist\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n    bundles {\n      octav\n      debank\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
+export declare const SINGLE_VAULT_OPTIMIZATION_QUERY = "\n  query SingleVaultOptimization(\n    $vaultAddress: Address!,\n    $chainId: Int!,\n    $options: TimeRangeOptions\n  ) {\n    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {\n      ...VaultFragment\n      stateHistory {\n        pricePerShareUsd(options: $options) {\n          x\n          y\n        }\n      }\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    creationDate\n    inception\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      version\n      syncMode\n      isAsyncOnly\n      isPaused\n      safeLocked\n      superOperatorLocked\n      allowHighWaterMarkReset\n      accessMode\n      blacklist\n      externalSanctionsList\n      maxCap\n      totalAssets\n      totalAssetsUsd\n      totalAssetsExpiration\n      totalAssetsLifespan\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n        securityCouncil\n        superOperator\n      }\n      managementFee\n      performanceFee\n      protocolFee\n      entryRate\n      exitRate\n      haircutRate\n      upcomingManagementFee\n      upcomingPerformanceFee\n      feeRatesCooldown\n      newRatesTimestamp\n      guardrails {\n        activated\n        lowerRate\n        upperRate\n      }\n      isWhitelistActivated\n      whitelist\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n    bundles {\n      octav\n      debank\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    twrrNetApr\n    twrrNetAprWithoutExtraYields\n    twrrGrossAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
 /**
  * GraphQL query for single vault composition data
  *
@@ -86,15 +90,5 @@ export declare const SINGLE_VAULT_OPTIMIZATION_QUERY = "\n  query SingleVaultOpt
  * );
  * ```
  */
-export declare const SINGLE_VAULT_COMPOSITION_QUERY = "\n  query SingleVaultComposition($walletAddress: Address!) {\n    vaultComposition(walletAddress: $walletAddress)\n  }\n";
-/**
- * GraphQL query for portfolio optimization data (DEPRECATED)
- *
- * This query is deprecated in favor of SINGLE_VAULT_OPTIMIZATION_QUERY
- * executed in parallel for each vault. Multi-vault queries cannot
- * distinguish which transactions belong to which vault.
- *
- * @deprecated Use SINGLE_VAULT_OPTIMIZATION_QUERY with Promise.all instead
- */
-export declare const PORTFOLIO_OPTIMIZATION_QUERY = "\n  query PortfolioOptimization($vaultAddresses: [String!]!, $chainId: Int!) {\n    vaults(where: { address_in: $vaultAddresses, chainId_eq: $chainId }) {\n      items {\n        ...VaultFragment\n      }\n    }\n\n    # Get price history for volatility calculation\n    priceHistory: transactions(\n      where: {\n        vault_in: $vaultAddresses,\n        type_in: [\"TotalAssetsUpdated\"]\n      },\n      orderBy: \"timestamp\",\n      orderDirection: \"asc\",\n      first: 1000\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            pricePerShareUsd\n          }\n        }\n      }\n    }\n\n    # Get APR data for return estimation\n    performanceData: transactions(\n      where: {\n        vault_in: $vaultAddresses,\n        type_in: [\"PeriodSummary\"]\n      },\n      orderBy: \"timestamp\",\n      orderDirection: \"asc\",\n      first: 1000\n    ) {\n      items {\n        timestamp\n        data {\n          ... on PeriodSummary {\n            linearNetApr\n          }\n        }\n      }\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      totalAssets\n      totalAssetsUsd\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n      }\n      managementFee\n      performanceFee\n      protocolFee\n      isWhitelistActivated\n      whitelist\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n    bundles {\n      octav\n      debank\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
+export declare const SINGLE_VAULT_COMPOSITION_QUERY = "\n  query SingleVaultComposition($address: Address!, $chainId: Int!) {\n    vaultByAddress(address: $address, chainId: $chainId) {\n      address\n      composition {\n        ...CompositionFragment\n      }\n    }\n  }\n  \n  fragment CompositionFragment on CompositionData {\n    totalValueInUsd\n    compositions {\n      protocol\n      valueInUsd\n      repartition\n      logoUrl\n      details {\n        protocol\n        valueInUsd\n        repartition\n        logoUrl\n      }\n    }\n    tokenCompositions {\n      symbol\n      name\n      contract\n      chainKey\n      valueInUsd\n      repartition\n      logoUrl\n      details {\n        symbol\n        name\n        contract\n        chainKey\n        valueInUsd\n        repartition\n        logoUrl\n      }\n    }\n  }\n\n";
 //# sourceMappingURL=portfolio.queries.d.ts.map

package/dist/graphql/queries/portfolio.queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAqBlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,GAAE,uBAAmC,GAClD,MAAM,CAyBR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,QAAsC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+BAA+B,uhHAmC3C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,8BAA8B,6HAI1C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,0zHAiDxC,CAAC"}
+{"version":3,"file":"portfolio.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAqBlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,GAAE,uBAAmC,GAClD,MAAM,CAyBR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,QAAsC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+BAA+B,+wHAiB3C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,8BAA8B,gyBAU1C,CAAC"}

package/dist/graphql/queries/portfolio.queries.js

@@ -4,7 +4,7 @@
  * GraphQL queries for user portfolio operations.
  * Includes user portfolio data and portfolio optimization queries.
  */
-import { VAULT_FRAGMENT, VAULT_LIST_FRAGMENT, VAULT_SUMMARY_FRAGMENT } from '../fragments/index.js';
+import { VAULT_FRAGMENT, VAULT_LIST_FRAGMENT, VAULT_SUMMARY_FRAGMENT, COMPOSITION_FRAGMENT, } from '../fragments/index.js';
 /**
  * Get fragment and fragment name based on response format for portfolio queries
  */
@@ -28,6 +28,10 @@ function getFragmentForPortfolioResponseFormat(responseFormat) {
  *
  * Used by: get_user_portfolio tool
  *
+ * Aliases: `state.sharesUsd: usd` — backend deprecated
+ * `VaultPositionState.sharesUsd` (schema.gql:2466) in favor of `usd`. The alias
+ * keeps the downstream TS field name stable while reading the canonical field.
+ *
  * @param responseFormat - Detail level: 'list' (~60 tokens/vault), 'summary' (~170 tokens/vault), 'full' (~600 tokens/vault)
  * @returns GraphQL query string with appropriate fragment
  *
@@ -66,7 +70,7 @@ export function createGetUserPortfolioQuery(responseFormat = 'summary') {
             state {
               assets
               shares
-              sharesUsd
+              sharesUsd: usd
             }
           }
         }
@@ -101,35 +105,17 @@ export const GET_USER_PORTFOLIO_QUERY = createGetUserPortfolioQuery('full');
  * ```
  */
 export const SINGLE_VAULT_OPTIMIZATION_QUERY = `
-  query SingleVaultOptimization($vaultAddress: Address!, $chainId: Int!) {
+  query SingleVaultOptimization(
+    $vaultAddress: Address!,
+    $chainId: Int!,
+    $options: TimeRangeOptions
+  ) {
     vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {
       ...VaultFragment
-    }
-
-    # Get price history for volatility calculation
-    priceHistory: transactions(
-      where: {
-        vault_in: [$vaultAddress],
-        type_in: [TotalAssetsUpdated]
-      },
-      orderBy: timestamp,
-      orderDirection: asc,
-      first: 1000
-    ) {
-      items {
-        timestamp
-        data {
-          ... on TotalAssetsUpdated {
-            totalAssets
-            totalAssetsUsd
-            totalSupply
-            vault {
-              decimals
-              asset {
-                decimals
-              }
-            }
-          }
+      stateHistory {
+        pricePerShareUsd(options: $options) {
+          x
+          y
         }
       }
     }
@@ -158,67 +144,14 @@ export const SINGLE_VAULT_OPTIMIZATION_QUERY = `
  * ```
  */
 export const SINGLE_VAULT_COMPOSITION_QUERY = `
-  query SingleVaultComposition($walletAddress: Address!) {
-    vaultComposition(walletAddress: $walletAddress)
-  }
-`;
-/**
- * GraphQL query for portfolio optimization data (DEPRECATED)
- *
- * This query is deprecated in favor of SINGLE_VAULT_OPTIMIZATION_QUERY
- * executed in parallel for each vault. Multi-vault queries cannot
- * distinguish which transactions belong to which vault.
- *
- * @deprecated Use SINGLE_VAULT_OPTIMIZATION_QUERY with Promise.all instead
- */
-export const PORTFOLIO_OPTIMIZATION_QUERY = `
-  query PortfolioOptimization($vaultAddresses: [String!]!, $chainId: Int!) {
-    vaults(where: { address_in: $vaultAddresses, chainId_eq: $chainId }) {
-      items {
-        ...VaultFragment
-      }
-    }
-
-    # Get price history for volatility calculation
-    priceHistory: transactions(
-      where: {
-        vault_in: $vaultAddresses,
-        type_in: ["TotalAssetsUpdated"]
-      },
-      orderBy: "timestamp",
-      orderDirection: "asc",
-      first: 1000
-    ) {
-      items {
-        timestamp
-        data {
-          ... on TotalAssetsUpdated {
-            pricePerShareUsd
-          }
-        }
-      }
-    }
-
-    # Get APR data for return estimation
-    performanceData: transactions(
-      where: {
-        vault_in: $vaultAddresses,
-        type_in: ["PeriodSummary"]
-      },
-      orderBy: "timestamp",
-      orderDirection: "asc",
-      first: 1000
-    ) {
-      items {
-        timestamp
-        data {
-          ... on PeriodSummary {
-            linearNetApr
-          }
-        }
+  query SingleVaultComposition($address: Address!, $chainId: Int!) {
+    vaultByAddress(address: $address, chainId: $chainId) {
+      address
+      composition {
+        ...CompositionFragment
       }
     }
   }
-  ${VAULT_FRAGMENT}
+  ${COMPOSITION_FRAGMENT}
 `;
 //# sourceMappingURL=portfolio.queries.js.map

package/dist/graphql/queries/portfolio.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAOpG;;GAEG;AACH,SAAS,qCAAqC,CAAC,cAAuC;IAIpF,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;QAC9E,KAAK,SAAS;YACZ,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;QACpF,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;QACrE;YACE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,2BAA2B,CACzC,iBAA0C,SAAS;IAEnD,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,qCAAqC,CAAC,cAAc,CAAC,CAAC;IAEzF,OAAO;;;;;;;;;mBASU,YAAY;;;;;;;;;;;MAWzB,QAAQ;GACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkC3C,cAAc;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;CAI7C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgDxC,cAAc;CACjB,CAAC"}
+{"version":3,"file":"portfolio.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAO/B;;GAEG;AACH,SAAS,qCAAqC,CAAC,cAAuC;IAIpF,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;QAC9E,KAAK,SAAS;YACZ,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;QACpF,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;QACrE;YACE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,2BAA2B,CACzC,iBAA0C,SAAS;IAEnD,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,qCAAqC,CAAC,cAAc,CAAC,CAAC;IAEzF,OAAO;;;;;;;;;mBASU,YAAY;;;;;;;;;;;MAWzB,QAAQ;GACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;IAgB3C,cAAc;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;;;;;;IAS1C,oBAAoB;CACvB,CAAC"}

package/dist/graphql/queries/prediction.queries.d.ts

@@ -5,13 +5,23 @@
  * Includes historical performance data for ML-based yield prediction.
  */
 /**
- * Response format type for yield prediction query
+ * Response format type for yield prediction output verbosity.
+ *
+ * Note: this only affects the formatted output produced by the tool.
+ * The GraphQL query itself always uses VAULT_FRAGMENT because the
+ * yield calculation requires vault.decimals, asset.decimals,
+ * state.pricePerShare, state.highWaterMark, state.managementFee,
+ * and state.performanceFee — none of which are present on
+ * VaultListFragment.
  */
 export type PredictionResponseFormat = 'quick' | 'detailed';
 /**
- * Create yield prediction GraphQL query with dynamic fragment selection
+ * Create yield prediction GraphQL query.
+ *
+ * The `responseFormat` parameter is accepted for API compatibility but does
+ * not change the query — see PredictionResponseFormat doc for why.
  */
-export declare function createYieldPredictionQuery(responseFormat?: PredictionResponseFormat): string;
+export declare function createYieldPredictionQuery(_responseFormat?: PredictionResponseFormat): string;
 /**
  * GraphQL query for vault yield prediction data
  *
@@ -21,18 +31,6 @@ export declare function createYieldPredictionQuery(responseFormat?: PredictionRe
  * - TVL history (TotalAssetsUpdated) for growth tracking
  *
  * Used by: predict_yield tool
- *
- * Usage:
- * ```typescript
- * const data = await graphqlClient.request<YieldPredictionResponse>(
- *   YIELD_PREDICTION_QUERY,
- *   {
- *     vaultAddress: '0x...',
- *     chainId: 1,
- *     timestamp_gte: '1234567890'
- *   }
- * );
- * ```
  */
 export declare const YIELD_PREDICTION_QUERY: string;
 //# sourceMappingURL=prediction.queries.d.ts.map

package/dist/graphql/queries/prediction.queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prediction.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/prediction.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,UAAU,CAAC;AAmB5D;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,GAAE,wBAAkC,GACjD,MAAM,CAqDR;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,sBAAsB,QAAyC,CAAC"}
+{"version":3,"file":"prediction.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/prediction.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,GAAE,wBAAkC,GAClD,MAAM,CAuDR;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,QAAyC,CAAC"}