schema.graphql

# Vault
type Balancer @entity(immutable: false) {
  id: ID!
  poolCount: Int!
  pools: [Pool!] @derivedFrom(field: "vaultID")
  protocolFeesCollector: Bytes
}
type Pool @entity(immutable: false) {
  id: ID!
  address: Bytes!
  poolType: String
  poolTypeVersion: Int
  factory: Bytes
  strategyType: Int!
  oracleEnabled: Boolean!
  symbol: String
  name: String

  "Indicates if a pool can be swapped against. Combines multiple sources, including offchain curation"
  swapEnabled: Boolean!

  "The native swapEnabled boolean. internal to the pool. Only applies to Gyro, LBPs and InvestmentPools"
  swapEnabledInternal: Boolean

  "External indication from an offchain permissioned actor"
  swapEnabledCurationSignal: Boolean

  swapFee: BigDecimal!
  owner: Bytes
  isPaused: Boolean

  totalWeight: BigDecimal
  totalShares: BigDecimal!
  createTime: Int!
  swapsCount: BigInt!
  holdersCount: BigInt!

  vaultID: Balancer!
  tx: Bytes

  tokensList: [Bytes!]!

  tokens: [PoolToken!] @derivedFrom(field: "poolId")
  joinsExits: [JoinExit!] @derivedFrom(field: "pool")
  swaps: [Swap!] @derivedFrom(field: "poolId")
  shares: [PoolShare!] @derivedFrom(field: "poolId")

  # StablePool Only
  amp: BigInt
  latestAmpUpdate: AmpUpdate
  ampUpdates: [AmpUpdate!] @derivedFrom(field: "poolId")

  # MetaStablePool and LinearPool Only
  priceRateProviders: [PriceRateProvider!] @derivedFrom(field: "poolId")

  # ConvergentCurvePool (Element) Only
  principalToken: Bytes
  baseToken: Bytes
  expiryTime: BigInt
  unitSeconds: BigInt

  # InvestmentPool Only
  managementFee: BigDecimal

  # ManagedPool Only
  joinExitEnabled: Boolean
  mustAllowlistLPs: Boolean
  managementAumFee: BigDecimal
  totalAumFeeCollectedInBPT: BigDecimal

  # LinearPool Only
  mainIndex: Int
  wrappedIndex: Int
  lowerTarget: BigDecimal
  upperTarget: BigDecimal

  # Gyro2Pool Only
  sqrtAlpha: BigDecimal
  sqrtBeta: BigDecimal

  # Gyro3Pool Only
  root3Alpha: BigDecimal

  # GyroEPool Only
  c: BigDecimal
  s: BigDecimal
  tauAlphaX: BigDecimal
  tauAlphaY: BigDecimal
  tauBetaX: BigDecimal
  tauBetaY: BigDecimal
  u: BigDecimal
  v: BigDecimal
  w: BigDecimal
  z: BigDecimal
  dSq: BigDecimal

  # GyroEPool+FXPool Only
  alpha: BigDecimal
  beta: BigDecimal
  lambda: BigDecimal

  # FXPool Only
  delta: BigDecimal
  epsilon: BigDecimal

  # Composable and WeightedV2+ Only
  isInRecoveryMode: Boolean
  protocolSwapFeeCache: BigDecimal
  protocolYieldFeeCache: BigDecimal
  protocolAumFeeCache: BigDecimal
  totalProtocolFeePaidInBPT: BigDecimal

  # Composable Stable Only
  lastJoinExitAmp: BigInt
  lastPostJoinExitInvariant: BigDecimal

  # AaveLinearV3 Only
  protocolId: Int
  protocolIdData: ProtocolIdData
}

type PoolContract @entity(immutable: true) {
  id: ID!
  pool: Pool!
}

type PoolToken @entity(immutable: false) {
  id: ID!
  poolId: Pool
  token: Token!
  symbol: String!
  name: String!
  decimals: Int!
  index: Int!
  address: String!
  oldPriceRate: BigDecimal!
  priceRate: BigDecimal!
  balance: BigDecimal!
  paidProtocolFees: BigDecimal!

  # WeightedPool Only
  weight: BigDecimal

  # ComposableStablePool Only
  isExemptFromYieldProtocolFee: Boolean
}

type PriceRateProvider @entity(immutable: false) {
  id: ID!
  poolId: Pool!
  token: PoolToken!
  address: Bytes!
  rate: BigDecimal
  lastCached: Int
  cacheDuration: Int
  cacheExpiry: Int
}

type PoolShare @entity(immutable: false) {
  id: ID!
  userAddress: Bytes!
  poolId: Pool!
  balance: BigDecimal!
}

type AmpUpdate @entity(immutable: true) {
  id: ID!
  poolId: Pool!
  scheduledTimestamp: Int!
  startTimestamp: BigInt!
  endTimestamp: BigInt!
  startAmp: BigInt!
  endAmp: BigInt!
}

type Swap @entity(immutable: true) {
  id: ID!
  caller: Bytes!
  tokenIn: Bytes!
  tokenInSym: String!
  tokenOut: Bytes!
  tokenOutSym: String!
  tokenAmountIn: BigDecimal!
  tokenAmountOut: BigDecimal!
  poolId: Pool!
  userAddress: Bytes!
  timestamp: Int!
  block: BigInt
  tx: Bytes!
}

enum InvestType {
  Join
  Exit
}

type JoinExit @entity(immutable: true) {
  id: ID!
  type: InvestType!
  sender: Bytes!
  amounts: [BigDecimal!]!
  pool: Pool!
  user: Bytes!
  timestamp: Int!
  tx: Bytes!
  block: BigInt
}

enum OperationType {
  Deposit
  Withdraw
  Update
}

type Token @entity(immutable: false) {
  id: ID!
  symbol: String
  name: String
  decimals: Int!
  address: String!
  totalBalanceNotional: BigDecimal!
  latestFXPrice: BigDecimal # latest "off-chain" price of token in USD, only available if token has an offchain price aggregator
  pool: Pool # pool entity associated with the token, if it is a Balancer pool
  fxOracleDecimals: Int # only available if token has an FX oracle
}

type ProtocolIdData @entity(immutable: false) {
  id: ID!
  name: String!
}

# FXOracle entity where the id is the Chainlink aggregator address
type FXOracle @entity(immutable: false) {
  id: ID! # FX oracle aggregator address
  tokens: [Bytes!]! # token addresses using this oracle
  divisor: String # some oracles require conversion
  decimals: Int
}