@opendatalabs/vana-sdk 2.3.0 → 3.0.1

package/dist/controllers/staking.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/controllers/staking.ts"],"sourcesContent":["/**\n * Provides staking functionality for the VanaPool protocol.\n *\n * @remarks\n * This controller handles interactions with VanaPool staking contracts,\n * allowing users to query staking information such as total VANA staked,\n * entity information, and staker positions.\n *\n * @category Controllers\n * @module StakingController\n */\n\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { TransactionOptions } from \"../types/operations\";\nimport { BaseController } from \"./base\";\nimport { getContract, parseEther } from \"viem\";\nimport type { Address, Hash } from \"viem\";\nimport { getContractAddress } from \"../generated/addresses\";\nimport { getAbi } from \"../generated/abi\";\nimport { BlockchainError } from \"../errors\";\n\n/**\n * Information about a staking entity in the VanaPool protocol.\n */\nexport interface EntityInfo {\n  entityId: bigint;\n  ownerAddress: Address;\n  status: number;\n  name: string;\n  maxAPY: bigint;\n  lockedRewardPool: bigint;\n  activeRewardPool: bigint;\n  totalShares: bigint;\n  lastUpdateTimestamp: bigint;\n  totalDistributedRewards: bigint;\n}\n\n/**\n * Information about a staker's position in an entity.\n */\nexport interface StakerEntityInfo {\n  shares: bigint;\n  costBasis: bigint;\n  rewardEligibilityTimestamp: bigint;\n  realizedRewards: bigint;\n  vestedRewards: bigint;\n}\n\n/**\n * Comprehensive staking summary for a staker in an entity.\n */\nexport interface StakerEntitySummary {\n  /** Number of shares owned by the staker */\n  shares: bigint;\n  /** Cost basis - the original VANA amount staked */\n  costBasis: bigint;\n  /** Current value of the staker's shares in VANA */\n  currentValue: bigint;\n  /** Timestamp when rewards become eligible */\n  rewardEligibilityTimestamp: bigint;\n  /** Remaining bonding time in seconds (0 if bonding period has passed) */\n  remainingBondingTime: bigint;\n  /** Whether the staker is still in the bonding period */\n  isInBondingPeriod: boolean;\n  /** Vested rewards that can be claimed without penalty */\n  vestedRewards: bigint;\n  /** Unvested rewards (pending interest = currentValue - costBasis) */\n  unvestedRewards: bigint;\n  /** Realized/withdrawn rewards (already claimed) */\n  realizedRewards: bigint;\n  /** Total earned rewards (includes vested, unvested, and realized) */\n  earnedRewards: bigint;\n}\n\n/**\n * Controller for VanaPool staking operations.\n *\n * @remarks\n * Provides methods to query staking information from the VanaPool contracts.\n * This includes total VANA staked across the protocol, entity information,\n * and individual staker positions.\n *\n * @example\n * ```typescript\n * // Get total VANA staked in the protocol\n * const totalStaked = await vana.staking.getTotalVanaStaked();\n * console.log(`Total staked: ${totalStaked} wei`);\n *\n * // Get entity information\n * const entity = await vana.staking.getEntity(1n);\n * console.log(`Entity name: ${entity.name}`);\n * ```\n *\n * @category Controllers\n */\nexport class StakingController extends BaseController {\n  constructor(context: ControllerContext) {\n    super(context);\n  }\n\n  /**\n   * Gets the chain ID from context.\n   */\n  private getChainId(): number {\n    const chainId =\n      this.context.walletClient?.chain?.id ??\n      this.context.publicClient.chain?.id;\n    if (!chainId) {\n      throw new Error(\"Chain ID not available\");\n    }\n    return chainId;\n  }\n\n  /**\n   * Gets the VanaPoolEntity contract instance.\n   */\n  private getEntityContract() {\n    const chainId = this.getChainId();\n    return getContract({\n      address: getContractAddress(chainId, \"VanaPoolEntity\"),\n      abi: getAbi(\"VanaPoolEntity\"),\n      client: this.context.publicClient,\n    });\n  }\n\n  /**\n   * Gets the VanaPoolStaking contract instance.\n   */\n  private getStakingContract() {\n    const chainId = this.getChainId();\n    return getContract({\n      address: getContractAddress(chainId, \"VanaPoolStaking\"),\n      abi: getAbi(\"VanaPoolStaking\"),\n      client: this.context.publicClient,\n    });\n  }\n\n  /**\n   * Gets the total amount of VANA staked in the VanaPool protocol or a specific entity.\n   *\n   * @remarks\n   * When called without an entityId, this retrieves the sum of activeRewardPool\n   * across all active entities in the VanaPool protocol.\n   * When called with an entityId, this returns the activeRewardPool for that specific entity.\n   * The value is returned in wei (10^18 = 1 VANA).\n   *\n   * @param entityId - Optional entity ID to get staked amount for a specific entity\n   * @returns The total amount of VANA staked in wei\n   *\n   * @example\n   * ```typescript\n   * // Get total staked across all entities\n   * const totalStaked = await vana.staking.getTotalVanaStaked();\n   * console.log(`Total staked: ${Number(totalStaked) / 1e18} VANA`);\n   *\n   * // Get staked amount for a specific entity\n   * const entityStaked = await vana.staking.getTotalVanaStaked(1n);\n   * console.log(`Entity 1 staked: ${Number(entityStaked) / 1e18} VANA`);\n   * ```\n   */\n  async getTotalVanaStaked(entityId?: bigint): Promise<bigint> {\n    const entityContract = this.getEntityContract();\n\n    // If entityId is provided, return the activeRewardPool for that specific entity\n    if (entityId !== undefined) {\n      const entity = await entityContract.read.entities([entityId]);\n      return entity.activeRewardPool;\n    }\n\n    // Otherwise, sum up the activeRewardPool from all active entities\n    const activeEntityIds = await entityContract.read.activeEntitiesValues();\n\n    let totalStaked = 0n;\n    for (const id of activeEntityIds) {\n      const entity = await entityContract.read.entities([id]);\n      totalStaked += entity.activeRewardPool;\n    }\n\n    return totalStaked;\n  }\n\n  /**\n   * Gets information about a specific staking entity.\n   *\n   * @param entityId - The ID of the entity to query\n   * @returns The entity information including name, APY, shares, and reward pools\n   *\n   * @example\n   * ```typescript\n   * const entity = await vana.staking.getEntity(1n);\n   * console.log(`Entity: ${entity.name}`);\n   * console.log(`Total shares: ${entity.totalShares}`);\n   * console.log(`Max APY: ${Number(entity.maxAPY) / 100}%`);\n   * ```\n   */\n  async getEntity(entityId: bigint): Promise<EntityInfo> {\n    const entityContract = this.getEntityContract();\n\n    const result = await entityContract.read.entities([entityId]);\n\n    return {\n      entityId: result.entityId,\n      ownerAddress: result.ownerAddress as Address,\n      status: result.status,\n      name: result.name,\n      maxAPY: result.maxAPY,\n      lockedRewardPool: result.lockedRewardPool,\n      activeRewardPool: result.activeRewardPool,\n      totalShares: result.totalShares,\n      lastUpdateTimestamp: result.lastUpdateTimestamp,\n      totalDistributedRewards: result.totalDistributedRewards,\n    };\n  }\n\n  /**\n   * Gets the total number of staking entities in the protocol.\n   *\n   * @returns The count of entities\n   *\n   * @example\n   * ```typescript\n   * const count = await vana.staking.getEntitiesCount();\n   * console.log(`Total entities: ${count}`);\n   * ```\n   */\n  async getEntitiesCount(): Promise<bigint> {\n    const entityContract = this.getEntityContract();\n    return entityContract.read.entitiesCount();\n  }\n\n  /**\n   * Gets the IDs of all active staking entities.\n   *\n   * @returns Array of active entity IDs\n   *\n   * @example\n   * ```typescript\n   * const activeIds = await vana.staking.getActiveEntities();\n   * console.log(`Active entities: ${activeIds.join(', ')}`);\n   * ```\n   */\n  async getActiveEntities(): Promise<readonly bigint[]> {\n    const entityContract = this.getEntityContract();\n    return entityContract.read.activeEntitiesValues();\n  }\n\n  /**\n   * Gets a staker's position in a specific entity.\n   *\n   * @param staker - The address of the staker\n   * @param entityId - The ID of the entity\n   * @returns The staker's position information\n   *\n   * @example\n   * ```typescript\n   * const position = await vana.staking.getStakerPosition(\n   *   '0x742d35...',\n   *   1n\n   * );\n   * console.log(`Shares: ${position.shares}`);\n   * console.log(`Rewards: ${position.realizedRewards}`);\n   * ```\n   */\n  async getStakerPosition(\n    staker: Address,\n    entityId: bigint,\n  ): Promise<StakerEntityInfo> {\n    const stakingContract = this.getStakingContract();\n\n    const result = await stakingContract.read.stakerEntities([\n      staker,\n      entityId,\n    ]);\n\n    return {\n      shares: result.shares,\n      costBasis: result.costBasis,\n      rewardEligibilityTimestamp: result.rewardEligibilityTimestamp,\n      realizedRewards: result.realizedRewards,\n      vestedRewards: result.vestedRewards,\n    };\n  }\n\n  /**\n   * Gets the earned rewards for a staker in an entity.\n   *\n   * @param staker - The address of the staker\n   * @param entityId - The ID of the entity\n   * @returns The earned rewards amount in wei\n   *\n   * @example\n   * ```typescript\n   * const rewards = await vana.staking.getEarnedRewards(\n   *   '0x742d35...',\n   *   1n\n   * );\n   * console.log(`Earned: ${Number(rewards) / 1e18} VANA`);\n   * ```\n   */\n  async getEarnedRewards(staker: Address, entityId: bigint): Promise<bigint> {\n    const stakingContract = this.getStakingContract();\n    return stakingContract.read.getEarnedRewards([staker, entityId]);\n  }\n\n  /**\n   * Gets the minimum stake amount required to stake.\n   *\n   * @returns The minimum stake amount in wei\n   *\n   * @example\n   * ```typescript\n   * const minStake = await vana.staking.getMinStakeAmount();\n   * console.log(`Minimum stake: ${Number(minStake) / 1e18} VANA`);\n   * ```\n   */\n  async getMinStakeAmount(): Promise<bigint> {\n    const stakingContract = this.getStakingContract();\n    return stakingContract.read.minStakeAmount();\n  }\n\n  /**\n   * Gets the count of active stakers in the protocol.\n   *\n   * @returns The number of active stakers\n   *\n   * @example\n   * ```typescript\n   * const count = await vana.staking.getActiveStakersCount();\n   * console.log(`Active stakers: ${count}`);\n   * ```\n   */\n  async getActiveStakersCount(): Promise<bigint> {\n    const stakingContract = this.getStakingContract();\n    return stakingContract.read.activeStakersListCount();\n  }\n\n  /**\n   * Gets the bonding period for staking.\n   *\n   * @returns The bonding period in seconds\n   *\n   * @example\n   * ```typescript\n   * const bondingPeriod = await vana.staking.getBondingPeriod();\n   * console.log(`Bonding period: ${bondingPeriod / 86400n} days`);\n   * ```\n   */\n  async getBondingPeriod(): Promise<bigint> {\n    const stakingContract = this.getStakingContract();\n    return stakingContract.read.bondingPeriod();\n  }\n\n  /**\n   * Gets the total distributed rewards for a specific entity from the contract.\n   *\n   * @remarks\n   * This reads the `totalDistributedRewards` field from the entity's on-chain state.\n   * This value represents the sum of all rewards that have been processed\n   * (moved from lockedRewardPool to activeRewardPool) minus any forfeited\n   * rewards that were returned.\n   *\n   * @param entityId - The ID of the entity to query\n   * @returns The total distributed rewards in wei\n   *\n   * @example\n   * ```typescript\n   * const totalRewards = await vana.staking.getTotalDistributedRewards(1n);\n   * const totalRewardsVana = Number(totalRewards) / 1e18;\n   * console.log(`Total distributed rewards: ${totalRewardsVana.toLocaleString()} VANA`);\n   * ```\n   */\n  async getTotalDistributedRewards(entityId: bigint): Promise<bigint> {\n    const entityContract = this.getEntityContract();\n    const result = await entityContract.read.entities([entityId]);\n    return result.totalDistributedRewards;\n  }\n\n  /**\n   * Gets a comprehensive staking summary for a staker in an entity.\n   *\n   * @remarks\n   * This method aggregates all relevant staking information for a staker in a single call,\n   * including staked amount, current value, bonding status, and all reward types.\n   *\n   * Reward breakdown:\n   * - `earnedRewards` = pendingInterest + vestedRewards + realizedRewards\n   * - `pendingInterest` = currentValue - costBasis (unvested appreciation)\n   * - `vestedRewards` = rewards that have vested but not yet withdrawn\n   * - `realizedRewards` = rewards already withdrawn during unstakes\n   *\n   * @param staker - The address of the staker\n   * @param entityId - The ID of the entity\n   * @returns A comprehensive summary of the staker's position\n   *\n   * @example\n   * ```typescript\n   * const summary = await vana.staking.getStakerSummary('0x742d35...', 1n);\n   * console.log(`Total staked: ${Number(summary.totalStaked) / 1e18} VANA`);\n   * console.log(`Current value: ${Number(summary.currentValue) / 1e18} VANA`);\n   * console.log(`In bonding period: ${summary.isInBondingPeriod}`);\n   * console.log(`Remaining bonding time: ${Number(summary.remainingBondingTime) / 86400} days`);\n   * console.log(`Vested rewards: ${Number(summary.vestedRewards) / 1e18} VANA`);\n   * console.log(`Unvested rewards: ${Number(summary.unvestedRewards) / 1e18} VANA`);\n   * console.log(`Realized rewards: ${Number(summary.realizedRewards) / 1e18} VANA`);\n   * console.log(`Total earned: ${Number(summary.earnedRewards) / 1e18} VANA`);\n   * ```\n   */\n  async getStakerSummary(\n    staker: Address,\n    entityId: bigint,\n  ): Promise<StakerEntitySummary> {\n    const chainId = this.getChainId();\n    const stakingAddress = getContractAddress(chainId, \"VanaPoolStaking\");\n    const entityAddress = getContractAddress(chainId, \"VanaPoolEntity\");\n    const stakingAbi = getAbi(\"VanaPoolStaking\");\n    const entityAbi = getAbi(\"VanaPoolEntity\");\n\n    // Get latest block first to ensure all reads are from the same block\n    const block = await this.context.publicClient.getBlock();\n    const blockNumber = block.number;\n\n    // Batch all contract reads into a single multicall RPC request at the same block\n    const multicallResults = await this.context.publicClient.multicall({\n      contracts: [\n        {\n          address: stakingAddress,\n          abi: stakingAbi,\n          functionName: \"stakerEntities\",\n          args: [staker, entityId],\n        },\n        {\n          address: stakingAddress,\n          abi: stakingAbi,\n          functionName: \"getEarnedRewards\",\n          args: [staker, entityId],\n        },\n        {\n          address: entityAddress,\n          abi: entityAbi,\n          functionName: \"entityShareToVana\",\n          args: [entityId],\n        },\n      ],\n      blockNumber,\n    });\n\n    const [positionResult, earnedRewardsResult, shareToVanaResult] =\n      multicallResults;\n\n    if (\n      positionResult.status === \"failure\" ||\n      earnedRewardsResult.status === \"failure\" ||\n      shareToVanaResult.status === \"failure\"\n    ) {\n      throw new BlockchainError(\n        \"Failed to fetch staker summary: one or more contract calls failed\",\n      );\n    }\n\n    const position = positionResult.result as {\n      shares: bigint;\n      costBasis: bigint;\n      rewardEligibilityTimestamp: bigint;\n      realizedRewards: bigint;\n      vestedRewards: bigint;\n    };\n    const earnedRewards = earnedRewardsResult.result as bigint;\n    const shareToVana = shareToVanaResult.result as bigint;\n    const currentTimestamp = block.timestamp;\n\n    // Calculate remaining bonding time\n    const eligibilityTimestamp = position.rewardEligibilityTimestamp;\n    const remainingBondingTime =\n      eligibilityTimestamp > currentTimestamp\n        ? eligibilityTimestamp - currentTimestamp\n        : 0n;\n    const isInBondingPeriod = remainingBondingTime > 0n;\n\n    // Calculate current value of shares\n    // entityShareToVana returns the VANA value of 1 share (scaled by 1e18)\n    const currentValue = (position.shares * shareToVana) / 10n ** 18n;\n\n    // Calculate pending interest (unvested rewards)\n    // pendingInterest = currentValue - costBasis (if positive)\n    const unvestedRewards =\n      currentValue > position.costBasis\n        ? currentValue - position.costBasis\n        : 0n;\n\n    return {\n      shares: position.shares,\n      costBasis: position.costBasis,\n      currentValue,\n      rewardEligibilityTimestamp: eligibilityTimestamp,\n      remainingBondingTime,\n      isInBondingPeriod,\n      vestedRewards: position.vestedRewards,\n      unvestedRewards,\n      realizedRewards: position.realizedRewards,\n      earnedRewards,\n    };\n  }\n\n  /**\n   * Stakes VANA to an entity in the VanaPool protocol.\n   *\n   * @remarks\n   * This method stakes native VANA tokens to a specified entity. The staker will receive\n   * shares in proportion to their stake amount. A bonding period applies during which\n   * rewards cannot be fully claimed without penalty.\n   *\n   * Requires a wallet client to be configured in the Vana constructor.\n   *\n   * @param params - The staking parameters\n   * @param params.entityId - The ID of the entity to stake to\n   * @param params.amount - The amount of VANA to stake (in wei, or as a string like \"1.5\" for 1.5 VANA)\n   * @param params.recipient - Optional recipient address for the shares (defaults to the sender)\n   * @param params.minShares - Optional minimum shares to receive (slippage protection, defaults to 0)\n   * @returns The transaction hash\n   * @throws {BlockchainError} When wallet client is not configured\n   *\n   * @example\n   * ```typescript\n   * // Stake 100 VANA to entity 1\n   * const txHash = await vana.staking.stake({\n   *   entityId: 1n,\n   *   amount: \"100\", // 100 VANA\n   * });\n   * console.log(`Staked! Transaction: ${txHash}`);\n   *\n   * // Stake with slippage protection\n   * const txHash2 = await vana.staking.stake({\n   *   entityId: 1n,\n   *   amount: parseEther(\"50\"), // 50 VANA in wei\n   *   minShares: parseEther(\"49\"), // Expect at least 49 shares\n   * });\n   * ```\n   */\n  async stake(\n    params: {\n      entityId: bigint;\n      amount: bigint | string;\n      recipient?: Address;\n      minShares?: bigint;\n    },\n    options?: TransactionOptions,\n  ): Promise<Hash> {\n    this.assertWallet();\n\n    const chainId = this.getChainId();\n    const stakingAddress = getContractAddress(chainId, \"VanaPoolStaking\");\n    const stakingAbi = getAbi(\"VanaPoolStaking\");\n\n    // Convert amount to bigint if it's a string (e.g., \"1.5\" -> 1.5 VANA in wei)\n    const amountWei =\n      typeof params.amount === \"string\"\n        ? parseEther(params.amount)\n        : params.amount;\n\n    // Get account with fallback to userAddress\n    const account =\n      this.context.walletClient.account ?? this.context.userAddress;\n    const accountAddress =\n      typeof account === \"string\" ? account : account.address;\n\n    // Default recipient to the sender's address\n    const recipient = params.recipient ?? accountAddress;\n\n    // Default minShares to 0 (no slippage protection)\n    const minShares = params.minShares ?? 0n;\n\n    const txHash = await this.context.walletClient.writeContract({\n      address: stakingAddress,\n      abi: stakingAbi,\n      functionName: \"stake\",\n      args: [params.entityId, recipient, minShares],\n      value: amountWei,\n      account,\n      chain: this.context.walletClient.chain,\n      ...this.spreadTransactionOptions(options),\n    });\n\n    return txHash;\n  }\n\n  /**\n   * Gets the maximum amount of VANA that can be unstaked in a single transaction.\n   *\n   * @remarks\n   * This calls the contract's getMaxUnstakeAmount which returns the minimum of:\n   * 1. The withdrawable VANA (costBasis if in bonding period, shareValue if eligible)\n   * 2. The entity's activeRewardPool (what the entity has available)\n   * 3. The treasury balance (what can be paid out)\n   *\n   * The limiting factor indicates what's constraining the unstake:\n   * - 0 = user shares/costBasis\n   * - 1 = activeRewardPool\n   * - 2 = treasury\n   *\n   * @param staker - The address of the staker\n   * @param entityId - The ID of the entity\n   * @returns Object containing maxVana, maxShares, limitingFactor, and isInBondingPeriod\n   *\n   * @example\n   * ```typescript\n   * const result = await vana.staking.getMaxUnstakeAmount('0x742d35...', 1n);\n   * console.log(`Max unstake: ${Number(result.maxVana) / 1e18} VANA`);\n   * console.log(`Max shares: ${result.maxShares}`);\n   * console.log(`In bonding period: ${result.isInBondingPeriod}`);\n   * ```\n   */\n  async getMaxUnstakeAmount(\n    staker: Address,\n    entityId: bigint,\n  ): Promise<{\n    maxVana: bigint;\n    maxShares: bigint;\n    limitingFactor: number;\n    isInBondingPeriod: boolean;\n  }> {\n    const stakingContract = this.getStakingContract();\n\n    const result = await stakingContract.read.getMaxUnstakeAmount([\n      staker,\n      entityId,\n    ]);\n\n    return {\n      maxVana: result[0],\n      maxShares: result[1],\n      limitingFactor: Number(result[2]),\n      isInBondingPeriod: result[3],\n    };\n  }\n\n  /**\n   * Computes the new bonding period end timestamp after adding stake.\n   *\n   * @remarks\n   * When a staker adds more stake to an existing position, the reward eligibility timestamp\n   * is recalculated as a weighted average of the existing and new positions. This function\n   * allows you to preview what the new eligibility timestamp would be without executing\n   * the stake transaction.\n   *\n   * The formula used (matching the contract):\n   * ```\n   * newEligibility = (existingShares * existingEligibility + newShares * newEligibility) / totalShares\n   * ```\n   *\n   * Where `newEligibility` for the incoming stake is `currentTimestamp + bondingPeriod`.\n   *\n   * @param params - The parameters for computing the new bonding period\n   * @param params.staker - The address of the staker\n   * @param params.entityId - The ID of the entity\n   * @param params.stakeAmount - The amount of VANA to stake (in wei)\n   * @returns Object containing the new eligibility timestamp and related info\n   *\n   * @example\n   * ```typescript\n   * // Preview bonding period after staking 100 VANA\n   * const preview = await vana.staking.computeNewBondingPeriod({\n   *   staker: '0x742d35...',\n   *   entityId: 1n,\n   *   stakeAmount: parseEther(\"100\"),\n   * });\n   * console.log(`New eligibility: ${new Date(Number(preview.newEligibilityTimestamp) * 1000)}`);\n   * console.log(`Remaining bonding time: ${Number(preview.newRemainingBondingTime) / 86400} days`);\n   * ```\n   */\n  async computeNewBondingPeriod(params: {\n    staker: Address;\n    entityId: bigint;\n    stakeAmount: bigint;\n  }): Promise<{\n    /** The new reward eligibility timestamp after staking */\n    newEligibilityTimestamp: bigint;\n    /** Remaining bonding time in seconds after staking */\n    newRemainingBondingTime: bigint;\n    /** Current eligibility timestamp (before staking) */\n    currentEligibilityTimestamp: bigint;\n    /** Current remaining bonding time (before staking) */\n    currentRemainingBondingTime: bigint;\n    /** Current shares held by staker */\n    currentShares: bigint;\n    /** Estimated new shares to be received */\n    estimatedNewShares: bigint;\n    /** Total shares after staking */\n    totalSharesAfter: bigint;\n    /** The bonding period duration in seconds */\n    bondingPeriodDuration: bigint;\n    /** Current block timestamp used for calculation */\n    currentTimestamp: bigint;\n  }> {\n    const chainId = this.getChainId();\n    const stakingAddress = getContractAddress(chainId, \"VanaPoolStaking\");\n    const entityAddress = getContractAddress(chainId, \"VanaPoolEntity\");\n    const stakingAbi = getAbi(\"VanaPoolStaking\");\n    const entityAbi = getAbi(\"VanaPoolEntity\");\n\n    // Get latest block first to ensure all reads are from the same block\n    const block = await this.context.publicClient.getBlock();\n    const blockNumber = block.number;\n    const currentTimestamp = block.timestamp;\n\n    // Batch all contract reads into a single multicall RPC request at the same block\n    const multicallResults = await this.context.publicClient.multicall({\n      contracts: [\n        {\n          address: stakingAddress,\n          abi: stakingAbi,\n          functionName: \"stakerEntities\",\n          args: [params.staker, params.entityId],\n        },\n        {\n          address: stakingAddress,\n          abi: stakingAbi,\n          functionName: \"bondingPeriod\",\n          args: [],\n        },\n        {\n          address: entityAddress,\n          abi: entityAbi,\n          functionName: \"vanaToEntityShare\",\n          args: [params.entityId],\n        },\n      ],\n      blockNumber,\n    });\n\n    const [positionResult, bondingPeriodResult, vanaToShareResult] =\n      multicallResults;\n\n    if (\n      positionResult.status === \"failure\" ||\n      bondingPeriodResult.status === \"failure\" ||\n      vanaToShareResult.status === \"failure\"\n    ) {\n      throw new BlockchainError(\n        \"Failed to compute new bonding period: one or more contract calls failed\",\n      );\n    }\n\n    const position = positionResult.result as {\n      shares: bigint;\n      costBasis: bigint;\n      rewardEligibilityTimestamp: bigint;\n      realizedRewards: bigint;\n      vestedRewards: bigint;\n    };\n    const bondingPeriodDuration = bondingPeriodResult.result as bigint;\n    const vanaToShare = vanaToShareResult.result as bigint;\n\n    const currentShares = position.shares;\n    const currentEligibilityTimestamp = position.rewardEligibilityTimestamp;\n\n    // Calculate current remaining bonding time\n    const currentRemainingBondingTime =\n      currentEligibilityTimestamp > currentTimestamp\n        ? currentEligibilityTimestamp - currentTimestamp\n        : 0n;\n\n    // Estimate new shares: newShares = (stakeAmount * vanaToShare) / 1e18\n    const estimatedNewShares = (params.stakeAmount * vanaToShare) / 10n ** 18n;\n\n    // Calculate new eligibility timestamp using weighted average formula\n    // newEligibility = (existingShares * existingEligibility + newShares * (currentTime + bondingPeriod)) / totalShares\n    const totalSharesAfter = currentShares + estimatedNewShares;\n    const newStakeEligibility = currentTimestamp + bondingPeriodDuration;\n\n    let newEligibilityTimestamp: bigint;\n    if (currentShares === 0n) {\n      // First stake: eligibility is simply current time + bonding period\n      newEligibilityTimestamp = newStakeEligibility;\n    } else {\n      // Weighted average of existing and new positions\n      newEligibilityTimestamp =\n        (currentShares * currentEligibilityTimestamp +\n          estimatedNewShares * newStakeEligibility) /\n        totalSharesAfter;\n    }\n\n    // Calculate new remaining bonding time\n    const newRemainingBondingTime =\n      newEligibilityTimestamp > currentTimestamp\n        ? newEligibilityTimestamp - currentTimestamp\n        : 0n;\n\n    return {\n      newEligibilityTimestamp,\n      newRemainingBondingTime,\n      currentEligibilityTimestamp,\n      currentRemainingBondingTime,\n      currentShares,\n      estimatedNewShares,\n      totalSharesAfter,\n      bondingPeriodDuration,\n      currentTimestamp,\n    };\n  }\n\n  /**\n   * Unstakes VANA from an entity in the VanaPool protocol.\n   *\n   * @remarks\n   * This method unstakes native VANA tokens from a specified entity. The amount\n   * that can be unstaked depends on whether the staker is in the bonding period:\n   *\n   * - **During bonding period**: Only cost basis can be withdrawn; rewards are forfeited\n   * - **After bonding period**: Full current value (cost basis + rewards) can be withdrawn\n   *\n   * Use `getMaxUnstakeAmount` to determine the maximum amount that can be unstaked.\n   *\n   * Requires a wallet client to be configured in the Vana constructor.\n   *\n   * @param params - The unstaking parameters\n   * @param params.entityId - The ID of the entity to unstake from\n   * @param params.amount - The amount of VANA to unstake (in wei, or as a string like \"1.5\" for 1.5 VANA)\n   * @param params.maxShares - Maximum shares to burn for slippage protection (defaults to 0, no protection)\n   * @returns The transaction hash\n   * @throws {BlockchainError} When wallet client is not configured\n   *\n   * @example\n   * ```typescript\n   * // Get max unstake amount first\n   * const maxUnstake = await vana.staking.getMaxUnstakeAmount(address, 1n);\n   *\n   * // Unstake the maximum amount with slippage protection\n   * const txHash = await vana.staking.unstake({\n   *   entityId: 1n,\n   *   amount: maxUnstake.maxVana,\n   *   maxShares: maxUnstake.maxShares,\n   * });\n   * console.log(`Unstaked! Transaction: ${txHash}`);\n   * ```\n   */\n  async unstake(\n    params: {\n      entityId: bigint;\n      amount: bigint | string;\n      maxShares?: bigint;\n    },\n    options?: TransactionOptions,\n  ): Promise<Hash> {\n    this.assertWallet();\n\n    const chainId = this.getChainId();\n    const stakingAddress = getContractAddress(chainId, \"VanaPoolStaking\");\n    const stakingAbi = getAbi(\"VanaPoolStaking\");\n\n    // Convert amount to bigint if it's a string (e.g., \"1.5\" -> 1.5 VANA in wei)\n    const amountWei =\n      typeof params.amount === \"string\"\n        ? parseEther(params.amount)\n        : params.amount;\n\n    // Default maxShares to 0 (no slippage protection)\n    const maxShares = params.maxShares ?? 0n;\n\n    // Get account with fallback to userAddress\n    const account =\n      this.context.walletClient.account ?? this.context.userAddress;\n\n    const txHash = await this.context.walletClient.writeContract({\n      address: stakingAddress,\n      abi: stakingAbi,\n      functionName: \"unstakeVana\",\n      args: [params.entityId, amountWei, maxShares],\n      account,\n      chain: this.context.walletClient.chain,\n      ...this.spreadTransactionOptions(options),\n    });\n\n    return txHash;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core/__tests__/pollingManager.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * @file Tests for the internal PollingManager class
- */
-export {};

package/dist/core/apiClient.cjs

@@ -1,378 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var apiClient_exports = {};
-__export(apiClient_exports, {
-  ApiClient: () => ApiClient
-});
-module.exports = __toCommonJS(apiClient_exports);
-var import_generics = require("./generics");
-class ApiClient {
-  config;
-  middleware;
-  rateLimiter;
-  circuitBreaker;
-  constructor(config = {}) {
-    this.config = {
-      baseUrl: config.baseUrl ?? "",
-      headers: config.headers ?? {},
-      timeout: config.timeout ?? 3e4,
-      retry: config.retry ?? {
-        maxAttempts: 3,
-        baseDelay: 1e3,
-        backoffMultiplier: 2,
-        shouldRetry: (error) => error.message.includes("network")
-      },
-      rateLimit: config.rateLimit ?? {
-        requestsPerWindow: 100,
-        windowMs: 6e4
-      },
-      circuitBreaker: config.circuitBreaker ?? {
-        failureThreshold: 5,
-        recoveryTimeout: 6e4,
-        halfOpenMaxAttempts: 3
-      }
-    };
-    this.middleware = new import_generics.MiddlewarePipeline();
-    this.rateLimiter = new import_generics.RateLimiter(this.config.rateLimit);
-    this.circuitBreaker = new import_generics.CircuitBreaker(this.config.circuitBreaker);
-  }
-  /**
-   * Adds middleware to the request processing pipeline.
-   *
-   * @remarks
-   * Middleware functions execute in order of registration and can transform
-   * requests, responses, or implement cross-cutting concerns like logging,
-   * authentication, or caching.
-   *
-   * @param middleware - The middleware function to add to the pipeline
-   *
-   * @example
-   * ```typescript
-   * // Add authentication middleware
-   * client.use(async (req, next) => {
-   *   req.options.headers = {
-   *     ...req.options.headers,
-   *     'Authorization': `Bearer ${getToken()}`
-   *   };
-   *   return next(req);
-   * });
-   *
-   * // Add response caching
-   * client.use(async (req, next) => {
-   *   const cached = cache.get(req.params.url);
-   *   if (cached) return cached;
-   *
-   *   const res = await next(req);
-   *   if (res.status === 'success') {
-   *     cache.set(req.params.url, res);
-   *   }
-   *   return res;
-   * });
-   * ```
-   */
-  use(middleware) {
-    this.middleware.use(middleware);
-  }
-  /**
-   * Executes an HTTP request with full resilience features.
-   *
-   * @remarks
-   * This is the core request method that applies all configured resilience
-   * patterns including retry, rate limiting, and circuit breaking. It processes
-   * the request through the middleware pipeline before execution.
-   *
-   * @param url - The URL to make the request to.
-   *   Can be relative (uses baseUrl) or absolute.
-   * @param options - Request options including method, headers, body, etc.
-   * @returns Promise resolving to the response data
-   *
-   * @throws {Error} When request fails after all retry attempts.
-   *   Check error message for details.
-   * @throws {Error} When circuit breaker is open.
-   *   Wait for recovery timeout before retrying.
-   *
-   * @example
-   * ```typescript
-   * const response = await client.request('/api/data', {
-   *   method: 'POST',
-   *   headers: { 'Content-Type': 'application/json' },
-   *   params: { name: 'John', age: 30 },
-   *   timeout: 5000
-   * });
-   * ```
-   */
-  async request(url, options = {}) {
-    const fullUrl = this.buildUrl(url);
-    const requestOptions = this.buildRequestOptions(options);
-    const request = {
-      params: {
-        url: fullUrl,
-        options: requestOptions
-      },
-      options: requestOptions
-    };
-    if (!options.skipRateLimit && this.rateLimiter) {
-      await this.rateLimiter.waitForSlot();
-    }
-    if (this.circuitBreaker) {
-      return this.circuitBreaker.execute(
-        () => this.executeRequest(request)
-      );
-    }
-    return this.executeRequest(request);
-  }
-  /**
-   * Make a GET request
-   *
-   * @param url - The URL to make the GET request to
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async get(url, options = {}) {
-    return this.request(url, { ...options, method: "GET" });
-  }
-  /**
-   * Make a POST request
-   *
-   * @param url - The URL to make the POST request to
-   * @param data - The data to send in the request body
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async post(url, data, options = {}) {
-    return this.request(url, {
-      ...options,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...options.headers
-      },
-      params: data
-    });
-  }
-  /**
-   * Make a PUT request
-   *
-   * @param url - The URL to make the PUT request to
-   * @param data - The data to send in the request body
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async put(url, data, options = {}) {
-    return this.request(url, {
-      ...options,
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        ...options.headers
-      },
-      params: data
-    });
-  }
-  /**
-   * Make a DELETE request
-   *
-   * @param url - The URL to make the DELETE request to
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async delete(url, options = {}) {
-    return this.request(url, { ...options, method: "DELETE" });
-  }
-  /**
-   * Make a PATCH request
-   *
-   * @param url - The URL to make the PATCH request to
-   * @param data - The data to send in the request body
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async patch(url, data, options = {}) {
-    return this.request(url, {
-      ...options,
-      method: "PATCH",
-      headers: {
-        "Content-Type": "application/json",
-        ...options.headers
-      },
-      params: data
-    });
-  }
-  /**
-   * Execute the actual HTTP request with middleware and retry
-   *
-   * @param request - The generic request object containing URL and options
-   * @returns Promise resolving to the generic response with data
-   */
-  async executeRequest(request) {
-    const executeWithRetry = async () => {
-      try {
-        const processedRequest = await this.middleware.processRequest(request);
-        const response = await this.makeHttpRequest(
-          processedRequest.params.url,
-          processedRequest.params.options
-        );
-        const processedResponse = await this.middleware.processResponse(response);
-        return processedResponse;
-      } catch (error) {
-        const handledResponse = await this.middleware.handleError(error, request);
-        if (handledResponse) {
-          return handledResponse;
-        }
-        throw error;
-      }
-    };
-    if (!request.params.options.skipRetry) {
-      return import_generics.RetryUtility.withRetry(executeWithRetry, this.config.retry);
-    }
-    return executeWithRetry();
-  }
-  /**
-   * Make the actual HTTP request using fetch API
-   *
-   * @param url - The URL to make the request to
-   * @param options - The request options including method, headers, body, etc.
-   * @returns Promise resolving to the generic response with data
-   */
-  async makeHttpRequest(url, options) {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => {
-      controller.abort();
-    }, options.timeout ?? this.config.timeout);
-    try {
-      const response = await fetch(url, {
-        method: options.method ?? "GET",
-        headers: {
-          ...this.config.headers,
-          ...options.headers
-        },
-        signal: controller.signal,
-        // Add body for POST/PUT/PATCH requests
-        ...options.method && ["POST", "PUT", "PATCH"].includes(options.method) && {
-          body: JSON.stringify(options.params)
-        }
-      });
-      clearTimeout(timeoutId);
-      const responseData = await response.json();
-      const data = responseData;
-      if (!response.ok) {
-        return {
-          data: null,
-          success: false,
-          error: {
-            code: response.status.toString(),
-            message: data.message ?? response.statusText,
-            details: data
-          }
-        };
-      }
-      return {
-        data: responseData,
-        success: true,
-        meta: {
-          status: response.status,
-          statusText: response.statusText,
-          headers: Object.fromEntries(response.headers.entries())
-        }
-      };
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (error instanceof Error && error.name === "AbortError") {
-        return {
-          data: null,
-          success: false,
-          error: {
-            code: "TIMEOUT",
-            message: "Request timeout",
-            details: error
-          }
-        };
-      }
-      return {
-        data: null,
-        success: false,
-        error: {
-          code: "NETWORK_ERROR",
-          message: error instanceof Error ? error.message : "Unknown error",
-          details: error
-        }
-      };
-    }
-  }
-  /**
-   * Build the full URL
-   *
-   * @param url - The URL or path to build the full URL from
-   * @returns The complete URL string
-   */
-  buildUrl(url) {
-    if (url.startsWith("http")) {
-      return url;
-    }
-    const baseUrl = this.config.baseUrl.endsWith("/") ? this.config.baseUrl.slice(0, -1) : this.config.baseUrl;
-    const path = url.startsWith("/") ? url : `/${url}`;
-    return `${baseUrl}${path}`;
-  }
-  /**
-   * Build request options with defaults
-   *
-   * @param options - The request options to merge with defaults
-   * @returns The merged request options with defaults applied
-   */
-  buildRequestOptions(options) {
-    return {
-      method: "GET",
-      headers: {},
-      timeout: this.config.timeout,
-      ...options
-    };
-  }
-  /**
-   * Get client statistics
-   *
-   * @returns Object containing client statistics and performance metrics
-   */
-  getStats() {
-    return {
-      rateLimiter: this.rateLimiter ? {
-        remaining: this.rateLimiter.getRemainingRequests(),
-        resetTime: this.rateLimiter.getResetTime()
-      } : null,
-      circuitBreaker: this.circuitBreaker ? {
-        state: this.circuitBreaker.getState(),
-        failures: this.circuitBreaker.getFailures()
-      } : null,
-      middleware: {
-        count: this.middleware.getMiddleware().length
-      }
-    };
-  }
-  /**
-   * Reset client state
-   */
-  reset() {
-    this.circuitBreaker?.reset();
-    this.middleware.clear();
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ApiClient
-});
-//# sourceMappingURL=apiClient.cjs.map

package/dist/core/apiClient.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/apiClient.ts"],"sourcesContent":["/**\n * Provides a generic HTTP client with enterprise-grade resilience features.\n *\n * @remarks\n * This module implements a robust API client with automatic retry, rate limiting,\n * circuit breaker pattern, and middleware support. It's used internally by the SDK\n * for all HTTP operations and can be extended for custom API integrations.\n *\n * **Architecture:**\n * - Middleware pipeline for request/response transformation\n * - Exponential backoff retry with configurable policies\n * - Token bucket rate limiting to prevent API throttling\n * - Circuit breaker to fail fast when services are down\n *\n * @category Networking\n * @module apiClient\n */\n\nimport type {\n  GenericRequest,\n  GenericResponse,\n  RetryConfig,\n  RateLimiterConfig,\n  Middleware,\n} from \"../types/generics\";\nimport {\n  RetryUtility,\n  RateLimiter,\n  MiddlewarePipeline,\n  CircuitBreaker,\n} from \"./generics\";\n\n/**\n * Configures the API client's behavior and resilience features.\n *\n * @remarks\n * Provides fine-grained control over HTTP client behavior including\n * retry strategies, rate limiting, and circuit breaker thresholds.\n *\n * @category Networking\n */\nexport interface ApiClientConfig {\n  /** Base URL for all requests */\n  baseUrl?: string;\n  /** Default headers */\n  headers?: Record<string, string>;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n  /** Retry configuration */\n  retry?: RetryConfig;\n  /** Rate limiting configuration */\n  rateLimit?: RateLimiterConfig;\n  /** Circuit breaker configuration */\n  circuitBreaker?: {\n    failureThreshold: number;\n    recoveryTimeout: number;\n    halfOpenMaxAttempts?: number;\n  };\n}\n\n/**\n * Represents supported HTTP methods for API operations.\n *\n * @category Networking\n */\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n\n/**\n * Configures individual HTTP request behavior.\n *\n * @remarks\n * Allows per-request overrides of client defaults including headers,\n * timeout, and resilience features. Use to customize specific requests\n * without affecting global configuration.\n *\n * @category Networking\n */\nexport interface RequestOptions {\n  /** HTTP method */\n  method?: HttpMethod;\n  /** Request headers */\n  headers?: Record<string, string>;\n  /** Query parameters */\n  params?: Record<string, unknown>;\n  /** Request timeout */\n  timeout?: number;\n  /** Skip retry for this request */\n  skipRetry?: boolean;\n  /** Skip rate limiting for this request */\n  skipRateLimit?: boolean;\n}\n\n/**\n * Provides resilient HTTP client functionality with enterprise features.\n *\n * @remarks\n * This client implements multiple resilience patterns to ensure reliable\n * API communication even under adverse conditions. It automatically handles\n * transient failures, rate limits, and service outages while providing\n * hooks for custom behavior through middleware.\n *\n * **Features:**\n * - Automatic retry with exponential backoff\n * - Rate limiting to prevent API throttling\n * - Circuit breaker for fast failure detection\n * - Middleware pipeline for request/response transformation\n * - Configurable timeouts and headers\n *\n * @example\n * ```typescript\n * // Create client with custom configuration\n * const client = new ApiClient({\n *   baseUrl: 'https://api.example.com',\n *   headers: { 'API-Key': 'secret' },\n *   retry: {\n *     maxAttempts: 5,\n *     baseDelay: 2000\n *   },\n *   rateLimit: {\n *     requestsPerWindow: 50,\n *     windowMs: 60000\n *   }\n * });\n *\n * // Add logging middleware\n * client.use(async (req, next) => {\n *   console.log(`Request: ${req.params.url}`);\n *   const res = await next(req);\n *   console.log(`Response: ${res.status}`);\n *   return res;\n * });\n *\n * // Make resilient API calls\n * const data = await client.get('/users');\n * ```\n *\n * @category Networking\n */\nexport class ApiClient {\n  private readonly config: Required<ApiClientConfig>;\n  private readonly middleware: MiddlewarePipeline;\n  private readonly rateLimiter?: RateLimiter;\n  private readonly circuitBreaker?: CircuitBreaker;\n\n  constructor(config: ApiClientConfig = {}) {\n    this.config = {\n      baseUrl: config.baseUrl ?? \"\",\n      headers: config.headers ?? {},\n      timeout: config.timeout ?? 30000,\n      retry: config.retry ?? {\n        maxAttempts: 3,\n        baseDelay: 1000,\n        backoffMultiplier: 2,\n        shouldRetry: (error) => error.message.includes(\"network\"),\n      },\n      rateLimit: config.rateLimit ?? {\n        requestsPerWindow: 100,\n        windowMs: 60000,\n      },\n      circuitBreaker: config.circuitBreaker ?? {\n        failureThreshold: 5,\n        recoveryTimeout: 60000,\n        halfOpenMaxAttempts: 3,\n      },\n    };\n\n    this.middleware = new MiddlewarePipeline();\n    this.rateLimiter = new RateLimiter(this.config.rateLimit);\n    this.circuitBreaker = new CircuitBreaker(this.config.circuitBreaker);\n  }\n\n  /**\n   * Adds middleware to the request processing pipeline.\n   *\n   * @remarks\n   * Middleware functions execute in order of registration and can transform\n   * requests, responses, or implement cross-cutting concerns like logging,\n   * authentication, or caching.\n   *\n   * @param middleware - The middleware function to add to the pipeline\n   *\n   * @example\n   * ```typescript\n   * // Add authentication middleware\n   * client.use(async (req, next) => {\n   *   req.options.headers = {\n   *     ...req.options.headers,\n   *     'Authorization': `Bearer ${getToken()}`\n   *   };\n   *   return next(req);\n   * });\n   *\n   * // Add response caching\n   * client.use(async (req, next) => {\n   *   const cached = cache.get(req.params.url);\n   *   if (cached) return cached;\n   *\n   *   const res = await next(req);\n   *   if (res.status === 'success') {\n   *     cache.set(req.params.url, res);\n   *   }\n   *   return res;\n   * });\n   * ```\n   */\n  use(middleware: Middleware): void {\n    this.middleware.use(middleware);\n  }\n\n  /**\n   * Executes an HTTP request with full resilience features.\n   *\n   * @remarks\n   * This is the core request method that applies all configured resilience\n   * patterns including retry, rate limiting, and circuit breaking. It processes\n   * the request through the middleware pipeline before execution.\n   *\n   * @param url - The URL to make the request to.\n   *   Can be relative (uses baseUrl) or absolute.\n   * @param options - Request options including method, headers, body, etc.\n   * @returns Promise resolving to the response data\n   *\n   * @throws {Error} When request fails after all retry attempts.\n   *   Check error message for details.\n   * @throws {Error} When circuit breaker is open.\n   *   Wait for recovery timeout before retrying.\n   *\n   * @example\n   * ```typescript\n   * const response = await client.request('/api/data', {\n   *   method: 'POST',\n   *   headers: { 'Content-Type': 'application/json' },\n   *   params: { name: 'John', age: 30 },\n   *   timeout: 5000\n   * });\n   * ```\n   */\n  async request<TData = unknown>(\n    url: string,\n    options: RequestOptions = {},\n  ): Promise<GenericResponse<TData>> {\n    const fullUrl = this.buildUrl(url);\n    const requestOptions = this.buildRequestOptions(options);\n\n    const request: GenericRequest<{\n      url: string;\n      options: RequestOptions;\n    }> = {\n      params: {\n        url: fullUrl,\n        options: requestOptions,\n      },\n      options: requestOptions,\n    };\n\n    // Apply rate limiting\n    if (!options.skipRateLimit && this.rateLimiter) {\n      await this.rateLimiter.waitForSlot();\n    }\n\n    // Execute with circuit breaker\n    if (this.circuitBreaker) {\n      return this.circuitBreaker.execute(() =>\n        this.executeRequest<TData>(request),\n      );\n    }\n\n    return this.executeRequest<TData>(request);\n  }\n\n  /**\n   * Make a GET request\n   *\n   * @param url - The URL to make the GET request to\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async get<TData = unknown>(\n    url: string,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, { ...options, method: \"GET\" });\n  }\n\n  /**\n   * Make a POST request\n   *\n   * @param url - The URL to make the POST request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async post<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n      params: data as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Make a PUT request\n   *\n   * @param url - The URL to make the PUT request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async put<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"PUT\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n      params: data as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Make a DELETE request\n   *\n   * @param url - The URL to make the DELETE request to\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async delete<TData = unknown>(\n    url: string,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, { ...options, method: \"DELETE\" });\n  }\n\n  /**\n   * Make a PATCH request\n   *\n   * @param url - The URL to make the PATCH request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async patch<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"PATCH\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n      params: data as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Execute the actual HTTP request with middleware and retry\n   *\n   * @param request - The generic request object containing URL and options\n   * @returns Promise resolving to the generic response with data\n   */\n  private async executeRequest<TData>(\n    request: GenericRequest<{ url: string; options: RequestOptions }>,\n  ): Promise<GenericResponse<TData>> {\n    const executeWithRetry = async (): Promise<GenericResponse<TData>> => {\n      try {\n        // Process request through middleware\n        const processedRequest = await this.middleware.processRequest(request);\n\n        // Make the actual HTTP request\n        const response = await this.makeHttpRequest<TData>(\n          (\n            processedRequest as GenericRequest<{\n              url: string;\n              options: RequestOptions;\n            }>\n          ).params.url,\n          (\n            processedRequest as GenericRequest<{\n              url: string;\n              options: RequestOptions;\n            }>\n          ).params.options,\n        );\n\n        // Process response through middleware\n        const processedResponse =\n          await this.middleware.processResponse(response);\n\n        return processedResponse;\n      } catch (error) {\n        // Try to handle error with middleware\n        const handledResponse = await this.middleware.handleError<\n          typeof request,\n          GenericResponse<TData>\n        >(error as Error, request);\n\n        if (handledResponse) {\n          return handledResponse;\n        }\n\n        throw error;\n      }\n    };\n\n    // Apply retry logic if not skipped\n    if (!request.params.options.skipRetry) {\n      return RetryUtility.withRetry(executeWithRetry, this.config.retry);\n    }\n\n    return executeWithRetry();\n  }\n\n  /**\n   * Make the actual HTTP request using fetch API\n   *\n   * @param url - The URL to make the request to\n   * @param options - The request options including method, headers, body, etc.\n   * @returns Promise resolving to the generic response with data\n   */\n  private async makeHttpRequest<TData>(\n    url: string,\n    options: RequestOptions,\n  ): Promise<GenericResponse<TData>> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => {\n      controller.abort();\n    }, options.timeout ?? this.config.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: options.method ?? \"GET\",\n        headers: {\n          ...this.config.headers,\n          ...options.headers,\n        },\n        signal: controller.signal,\n        // Add body for POST/PUT/PATCH requests\n        ...(options.method &&\n          [\"POST\", \"PUT\", \"PATCH\"].includes(options.method) && {\n            body: JSON.stringify(options.params),\n          }),\n      });\n\n      clearTimeout(timeoutId);\n\n      const responseData: unknown = await response.json();\n      const data = responseData as { message?: string; [key: string]: unknown };\n\n      if (!response.ok) {\n        return {\n          data: null as unknown as TData,\n          success: false,\n          error: {\n            code: response.status.toString(),\n            message: data.message ?? response.statusText,\n            details: data,\n          },\n        };\n      }\n\n      return {\n        data: responseData as TData,\n        success: true,\n        meta: {\n          status: response.status,\n          statusText: response.statusText,\n          headers: Object.fromEntries(response.headers.entries()),\n        },\n      };\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof Error && error.name === \"AbortError\") {\n        return {\n          data: null as unknown as TData,\n          success: false,\n          error: {\n            code: \"TIMEOUT\",\n            message: \"Request timeout\",\n            details: error,\n          },\n        };\n      }\n\n      return {\n        data: null as unknown as TData,\n        success: false,\n        error: {\n          code: \"NETWORK_ERROR\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n          details: error,\n        },\n      };\n    }\n  }\n\n  /**\n   * Build the full URL\n   *\n   * @param url - The URL or path to build the full URL from\n   * @returns The complete URL string\n   */\n  private buildUrl(url: string): string {\n    if (url.startsWith(\"http\")) {\n      return url;\n    }\n\n    const baseUrl = this.config.baseUrl.endsWith(\"/\")\n      ? this.config.baseUrl.slice(0, -1)\n      : this.config.baseUrl;\n    const path = url.startsWith(\"/\") ? url : `/${url}`;\n\n    return `${baseUrl}${path}`;\n  }\n\n  /**\n   * Build request options with defaults\n   *\n   * @param options - The request options to merge with defaults\n   * @returns The merged request options with defaults applied\n   */\n  private buildRequestOptions(options: RequestOptions): RequestOptions {\n    return {\n      method: \"GET\",\n      headers: {},\n      timeout: this.config.timeout,\n      ...options,\n    };\n  }\n\n  /**\n   * Get client statistics\n   *\n   * @returns Object containing client statistics and performance metrics\n   */\n  getStats() {\n    return {\n      rateLimiter: this.rateLimiter\n        ? {\n            remaining: this.rateLimiter.getRemainingRequests(),\n            resetTime: this.rateLimiter.getResetTime(),\n          }\n        : null,\n      circuitBreaker: this.circuitBreaker\n        ? {\n            state: this.circuitBreaker.getState(),\n            failures: this.circuitBreaker.getFailures(),\n          }\n        : null,\n      middleware: {\n        count: this.middleware.getMiddleware().length,\n      },\n    };\n  }\n\n  /**\n   * Reset client state\n   */\n  reset(): void {\n    this.circuitBreaker?.reset();\n    this.middleware.clear();\n  }\n}\n"],"mappings":"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","names":[]}