Feat/neptune service

packages/sdk-ts/src/client/wasm/index.ts

@@ -1,5 +1,6 @@
-export * from './swap/index.js'
 export * from './types.js'
+export * from './swap/index.js'
+export * from './neptune/index.js'
 export * from './incentives/index.js'
 export * from './nameservice/index.js'
 export * from './trading_strategies/index.js'

packages/sdk-ts/src/client/wasm/neptune/helper.ts

@@ -0,0 +1,9 @@
+import { AssetInfo } from './types.js'
+
+export function getDenom(assetInfo: AssetInfo): string | undefined {
+  if ('native_token' in assetInfo) {
+    return assetInfo.native_token.denom
+  }
+
+  return assetInfo.token.contract_addr
+}

packages/sdk-ts/src/client/wasm/neptune/index.ts

@@ -0,0 +1,6 @@
+export * from './types.js'
+export * from './service.js'
+export * from './transformer.js'
+export * from './queries/index.js'
+
+export const NEPTUNE_PRICE_CONTRACT = 'inj1u6cclz0qh5tep9m2qayry9k97dm46pnlqf8nre'

packages/sdk-ts/src/client/wasm/neptune/queries/QueryGetPrices.ts

@@ -0,0 +1,19 @@
+import { BaseWasmQuery } from '../../BaseWasmQuery.js'
+import { toBase64 } from '../../../../utils/index.js'
+import { AssetInfo } from '../types.js'
+
+export declare namespace QueryGetPrices {
+  export interface Params {
+    assets: AssetInfo[]
+  }
+}
+
+export class QueryGetPrices extends BaseWasmQuery<QueryGetPrices.Params> {
+  toPayload() {
+    return toBase64({
+      get_prices: {
+        assets: this.params.assets,
+      },
+    })
+  }
+}

packages/sdk-ts/src/client/wasm/neptune/queries/QueryLendingRates.ts

@@ -0,0 +1,23 @@
+import { BaseWasmQuery } from '../../BaseWasmQuery.js';
+import { toBase64 } from '../../../../utils/index.js';
+import { AssetInfo } from '../types.js';
+
+export declare namespace QueryGetAllLendingRates {
+  export interface Params {
+    limit?: number;
+    startAfter?: AssetInfo;
+  }
+}
+
+export class QueryGetAllLendingRates extends BaseWasmQuery<QueryGetAllLendingRates.Params> {
+  toPayload() {
+    const payload = {
+      get_all_lending_rates: {
+        ...(this.params.limit !== undefined ? { limit: this.params.limit } : {}),
+        ...(this.params.startAfter ? { start_after: this.params.startAfter } : {}),
+      },
+    };
+
+    return toBase64(payload);
+  }
+}

packages/sdk-ts/src/client/wasm/neptune/queries/index.ts

@@ -0,0 +1,2 @@
+export { QueryGetPrices } from './QueryGetPrices.js'
+export { QueryGetAllLendingRates } from './QueryLendingRates.js'

packages/sdk-ts/src/client/wasm/neptune/service.ts

@@ -0,0 +1,268 @@
+import {
+  Network,
+  isMainnet,
+  NetworkEndpoints,
+  getNetworkEndpoints,
+} from '@injectivelabs/networks'
+import { getDenom } from './helper.js'
+import { ChainGrpcWasmApi } from '../../chain/index.js'
+import { QueryGetPrices, QueryGetAllLendingRates } from './queries/index.js'
+import { NeptuneQueryTransformer } from './transformer.js'
+import ExecArgNeptuneDeposit from '../../../core/modules/wasm/exec-args/ExecArgNeptuneDeposit.js'
+import ExecArgNeptuneWithdraw from '../../../core/modules/wasm/exec-args/ExecArgNeptuneWithdraw.js'
+import MsgExecuteContractCompat from '../../../core/modules/wasm/msgs/MsgExecuteContractCompat.js'
+import { GeneralException } from '@injectivelabs/exceptions'
+import { NEPTUNE_PRICE_CONTRACT } from './index.js'
+import {
+  AssetInfo,
+  AssetInfoWithPrice,
+  NEPTUNE_USDT_CW20_CONTRACT,
+} from './types.js'
+
+const NEPTUNE_USDT_MARKET_CONTRACT =
+  'inj1nc7gjkf2mhp34a6gquhurg8qahnw5kxs5u3s4u'
+const NEPTUNE_USDT_INTEREST_CONTRACT =
+  'inj1ftech0pdjrjawltgejlmpx57cyhsz6frdx2dhq'
+
+export class NeptuneService {
+  private client: ChainGrpcWasmApi
+  private priceOracleContract: string
+
+  /**
+   * Constructs a new NeptuneService instan ce.
+   * @param network The network to use (default: Mainnet).
+   * @param endpoints Optional custom network endpoints.
+   */
+  constructor(
+    network: Network = Network.MainnetSentry,
+    endpoints?: NetworkEndpoints,
+  ) {
+    if (!isMainnet(network)) {
+      throw new GeneralException(new Error('Please switch to mainnet network'))
+    }
+
+    const networkEndpoints = endpoints || getNetworkEndpoints(network)
+    this.client = new ChainGrpcWasmApi(networkEndpoints.grpc)
+    this.priceOracleContract = NEPTUNE_PRICE_CONTRACT
+  }
+
+  /**
+   * Fetch prices for given assets from the Neptune Price Oracle contract.
+   * @param assets Array of AssetInfo objects.
+   * @returns Array of Price objects.
+   */
+  async fetchPrices(assets: AssetInfo[]): Promise<AssetInfoWithPrice[]> {
+    const queryGetPricesPayload = new QueryGetPrices({ assets }).toPayload()
+
+    try {
+      const response = await this.client.fetchSmartContractState(
+        this.priceOracleContract,
+        queryGetPricesPayload,
+      )
+
+      const prices =
+        NeptuneQueryTransformer.contractPricesResponseToPrices(response)
+
+      return prices
+    } catch (error) {
+      console.error('Error fetching prices:', error)
+      throw new GeneralException(new Error('Failed to fetch prices'))
+    }
+  }
+
+  /**
+   * Fetch the redemption ratio based on CW20 and native asset prices.
+   * @param cw20Asset AssetInfo for the CW20 token.
+   * @param nativeAsset AssetInfo for the native token.
+   * @returns Redemption ratio as a number.
+   */
+  async fetchRedemptionRatio({
+    cw20Asset,
+    nativeAsset,
+  }: {
+    cw20Asset: AssetInfo
+    nativeAsset: AssetInfo
+  }): Promise<number> {
+    const prices = await this.fetchPrices([cw20Asset, nativeAsset])
+
+    const [cw20Price] = prices
+    const [nativePrice] = prices.reverse()
+
+    if (!cw20Price || !nativePrice) {
+      throw new GeneralException(
+        new Error('Failed to compute redemption ratio'),
+      )
+    }
+
+    return Number(cw20Price.price) / Number(nativePrice.price)
+  }
+
+  /**
+   * Convert CW20 nUSDT to bank nUSDT using the redemption ratio.
+   * @param amountCW20 Amount in CW20 nUSDT.
+   * @param redemptionRatio Redemption ratio.
+   * @returns Amount in bank nUSDT.
+   */
+  calculateBankAmount(amountCW20: number, redemptionRatio: number): number {
+    return amountCW20 * redemptionRatio
+  }
+
+  /**
+   * Convert bank nUSDT to CW20 nUSDT using the redemption ratio.
+   * @param amountBank Amount in bank nUSDT.
+   * @param redemptionRatio Redemption ratio.
+   * @returns Amount in CW20 nUSDT.
+   */
+  calculateCw20Amount(amountBank: number, redemptionRatio: number): number {
+    return amountBank / redemptionRatio
+  }
+
+  /**
+   * Create a deposit message.
+   * @param sender Sender's Injective address.
+   * @param contractAddress USDT market contract address.
+   * @param denom Denomination of the asset.
+   * @param amount Amount to deposit as a string.
+   * @returns MsgExecuteContractCompat message.
+   */
+  createDepositMsg({
+    denom,
+    amount,
+    sender,
+    contractAddress = NEPTUNE_USDT_MARKET_CONTRACT,
+  }: {
+    denom: string
+    amount: string
+    sender: string
+    contractAddress?: string
+  }): MsgExecuteContractCompat {
+    return MsgExecuteContractCompat.fromJSON({
+      sender,
+      contractAddress,
+      execArgs: ExecArgNeptuneDeposit.fromJSON({}),
+      funds: {
+        denom,
+        amount,
+      },
+    })
+  }
+
+  /**
+   * Create a withdraw message.
+   * @param sender Sender's Injective address.
+   * @param contractAddress nUSDT contract address.
+   * @param amount Amount to withdraw as a string.
+   * @returns MsgExecuteContractCompat message.
+   */
+  createWithdrawMsg({
+    amount,
+    sender,
+    cw20ContractAddress = NEPTUNE_USDT_CW20_CONTRACT,
+    marketContractAddress = NEPTUNE_USDT_MARKET_CONTRACT,
+  }: {
+    amount: string
+    sender: string
+    cw20ContractAddress?: string
+    marketContractAddress?: string
+  }): MsgExecuteContractCompat {
+    return MsgExecuteContractCompat.fromJSON({
+      sender,
+      contractAddress: cw20ContractAddress,
+      execArgs: ExecArgNeptuneWithdraw.fromJSON({
+        amount,
+        contract: marketContractAddress,
+      }),
+    })
+  }
+
+  /**
+   * Fetch lending rates with optional pagination parameters.
+   * @param limit Maximum number of lending rates to fetch.
+   * @param startAfter AssetInfo to start after for pagination.
+   * @returns Array of [AssetInfo, Decimal256] tuples.
+   */
+  async getLendingRates({
+    limit,
+    startAfter,
+    contractAddress = NEPTUNE_USDT_INTEREST_CONTRACT,
+  }: {
+    limit?: number
+    startAfter?: AssetInfo
+    contractAddress?: string
+  }): Promise<Array<{ assetInfo: AssetInfo; lendingRate: string }>> {
+    const query = new QueryGetAllLendingRates({ limit, startAfter })
+    const payload = query.toPayload()
+
+    try {
+      const response = await this.client.fetchSmartContractState(
+        contractAddress,
+        payload,
+      )
+
+      const lendingRates =
+        NeptuneQueryTransformer.contractLendingRatesResponseToLendingRates(
+          response,
+        )
+
+      return lendingRates
+    } catch (error) {
+      console.error('Error fetching lending rates:', error)
+      throw new GeneralException(new Error('Failed to fetch lending rates'))
+    }
+  }
+
+  /**
+   * Fetch the lending rate for a specific denom by querying the smart contract with pagination.
+   * @param denom The denomination string of the asset to find the lending rate for.
+   * @returns Lending rate as a string.
+   */
+  async getLendingRateByDenom({
+    denom,
+    contractAddress = NEPTUNE_USDT_INTEREST_CONTRACT,
+  }: {
+    denom: string
+    contractAddress?: string
+  }): Promise<string | undefined> {
+    const limit = 10
+    let startAfter = undefined
+
+    while (true) {
+      const lendingRates = await this.getLendingRates({
+        limit,
+        startAfter,
+        contractAddress,
+      })
+
+      if (lendingRates.length === 0) {
+        return
+      }
+
+      for (const { assetInfo, lendingRate } of lendingRates) {
+        const currentDenom = getDenom(assetInfo)
+
+        if (currentDenom === denom) {
+          return lendingRate
+        }
+      }
+
+      if (lendingRates.length < limit) {
+        return
+      }
+
+      const lastLendingRate = lendingRates[lendingRates.length - 1]
+
+      startAfter = lastLendingRate.assetInfo
+    }
+  }
+
+  /**
+   * Calculates APY from APR and compounding frequency.
+   *
+   * @param apr - The annual percentage rate as a decimal (e.g., 0.10 for 10%)
+   * @param compoundingFrequency - Number of times interest is compounded per year
+   * @returns The annual percentage yield as a decimal
+   */
+  calculateAPY(apr: number, compoundingFrequency = 365): number {
+    return Math.pow(1 + apr / compoundingFrequency, compoundingFrequency) - 1
+  }
+}

packages/sdk-ts/src/client/wasm/neptune/transformer.ts

@@ -0,0 +1,27 @@
+import { WasmContractQueryResponse } from '../types.js'
+import { toUtf8 } from '../../../utils/index.js'
+import { AssetInfo, PriceResponse, LendingRateResponse } from './types.js'
+
+export class NeptuneQueryTransformer {
+  static contractPricesResponseToPrices(
+    response: WasmContractQueryResponse,
+  ): Array<{ assetInfo: AssetInfo; price: string }> {
+    const data = JSON.parse(toUtf8(response.data)) as PriceResponse
+
+    return data.map(([assetInfo, priceInfo]) => ({
+      assetInfo,
+      price: priceInfo.price,
+    }))
+  }
+
+  static contractLendingRatesResponseToLendingRates(
+    response: WasmContractQueryResponse,
+  ): Array<{ assetInfo: AssetInfo; lendingRate: string }> {
+    const data = JSON.parse(toUtf8(response.data)) as LendingRateResponse
+
+    return data.map(([assetInfo, lendingRate]) => ({
+      assetInfo,
+      lendingRate,
+    }))
+  }
+}

packages/sdk-ts/src/client/wasm/neptune/types.ts

@@ -0,0 +1,19 @@
+export type AssetInfo =
+  | {
+      token: {
+        contract_addr: string
+      }
+    }
+  | {
+      native_token: {
+        denom: string
+      }
+    }
+
+export type AssetInfoWithPrice = {assetInfo: AssetInfo, price: string }
+
+export type PriceResponse = Array<[AssetInfo, { price: string }]>
+export type LendingRateResponse = Array<[AssetInfo, string]>
+
+export const NEPTUNE_USDT_CW20_CONTRACT =
+  'inj1cy9hes20vww2yr6crvs75gxy5hpycya2hmjg9s'