@nadohq/indexer-client 0.1.0-alpha.2 → 0.1.0-alpha.21

package/src/types/clientTypes.ts

@@ -1,24 +1,25 @@
 import {
+  BigDecimal,
   EIP712OrderValues,
   Market,
-  OrderExpirationType,
+  OrderAppendix,
   PerpBalance,
   PerpMarket,
   ProductEngineType,
   SpotBalance,
   SpotMarket,
   Subaccount,
-} from '@nadohq/contracts';
-import { BigDecimal } from '@nadohq/utils';
-import { Hex } from 'viem';
+} from '@nadohq/shared';
+import { Address, Hex } from 'viem';
 import { CandlestickPeriod } from './CandlestickPeriod';
 import { IndexerEventType } from './IndexerEventType';
 import { IndexerLeaderboardRankType } from './IndexerLeaderboardType';
+import { NadoTx, NadoWithdrawCollateralTx } from './NadoTx';
 import {
   IndexerServerFastWithdrawalSignatureParams,
   IndexerServerListSubaccountsParams,
+  IndexerServerTriggerTypeFilter,
 } from './serverTypes';
-import { NadoTx, NadoWithdrawCollateralTx } from './NadoTx';
 
 /**
  * Base types
@@ -53,6 +54,7 @@ export interface IndexerBalanceTrackedVars {
   netFundingCumulative: BigDecimal;
   netEntryUnrealized: BigDecimal;
   netEntryCumulative: BigDecimal;
+  quoteVolumeCumulative: BigDecimal;
 }
 
 export interface IndexerEvent<
@@ -341,6 +343,7 @@ export interface GetIndexerOrdersParams {
   maxTimestampInclusive?: number;
   limit?: number;
   productIds?: number[];
+  triggerTypes?: IndexerServerTriggerTypeFilter[];
   // If not given, will return both isolated & non-iso orders
   isolated?: boolean;
   digests?: string[];
@@ -349,16 +352,13 @@ export interface GetIndexerOrdersParams {
 export interface IndexerOrder {
   digest: string;
   subaccount: string;
-  isolated: boolean;
   productId: number;
   submissionIndex: string;
   amount: BigDecimal;
   price: BigDecimal;
-  // This includes the order type
-  rawExpiration: BigDecimal;
-  isReduceOnly: boolean;
-  orderType: OrderExpirationType;
   expiration: number;
+  // Order metadata from appendix
+  appendix: OrderAppendix;
   nonce: BigDecimal;
   // Derived from the nonce
   recvTimeSeconds: number;
@@ -651,8 +651,8 @@ export interface IndexerNlpSnapshot {
   // Total volume traded by the NLP, in terms of the primary quote
   cumulativeVolume: BigDecimal;
   cumulativeTrades: BigDecimal;
-  cumulativeMintAmountUsdc: BigDecimal;
-  cumulativeBurnAmountUsdc: BigDecimal;
+  cumulativeMintAmountQuote: BigDecimal;
+  cumulativeBurnAmountQuote: BigDecimal;
   cumulativePnl: BigDecimal;
   tvl: BigDecimal;
   oraclePrice: BigDecimal;
@@ -677,3 +677,68 @@ export interface GetIndexerBacklogResponse {
   // Current submission rate in transactions per second (float) (null if unavailable)
   txsPerSecond: BigDecimal | null;
 }
+
+export interface GetIndexerSubaccountDDAParams {
+  subaccount: Subaccount;
+}
+
+export interface GetIndexerSubaccountDDAResponse {
+  address: Address;
+}
+
+/**
+ * V2 Tickers
+ */
+
+/**
+ * Market type for ticker filtering
+ */
+export type TickerMarketType = 'spot' | 'perp';
+
+/**
+ * Parameters for querying v2 tickers endpoint
+ */
+export interface GetIndexerV2TickersParams {
+  /**
+   * Filter tickers by market type (spot or perp)
+   * @example 'spot'
+   * @example 'perp'
+   */
+  market?: TickerMarketType;
+  /**
+   * Whether to include edge products
+   * @default false
+   */
+  edge?: boolean;
+}
+
+/**
+ * Individual ticker data from v2 endpoint
+ */
+export interface IndexerV2TickerResponse {
+  /** Unique product identifier */
+  productId: number;
+  /** Unique ticker identifier */
+  tickerId: string;
+  /** Base currency symbol */
+  baseCurrency: string;
+  /** Quote currency symbol */
+  quoteCurrency: string;
+  /** Last traded price */
+  lastPrice: number;
+  /** 24h trading volume in base currency */
+  baseVolume: number;
+  /** 24h trading volume in quote currency */
+  quoteVolume: number;
+  /** 24h price change percentage */
+  priceChangePercent24h: number;
+}
+
+/**
+ * Response from v2 tickers endpoint
+ * Maps ticker IDs to their respective ticker data
+ */
+export type GetIndexerV2TickersResponse = Record<
+  string,
+  IndexerV2TickerResponse
+>;

package/src/types/index.ts

@@ -1,9 +1,9 @@
-export * from './clientTypes';
-export * from './paginatedEventsTypes';
-export * from './serverTypes';
-export * from './serverModelTypes';
 export * from './CandlestickPeriod';
+export * from './clientTypes';
+export * from './collateralEventType';
 export * from './IndexerEventType';
 export * from './IndexerLeaderboardType';
-export * from './collateralEventType';
 export * from './NadoTx';
+export * from './paginatedEventsTypes';
+export * from './serverModelTypes';
+export * from './serverTypes';

package/src/types/paginatedEventsTypes.ts

@@ -1,5 +1,4 @@
-import { Subaccount } from '@nadohq/contracts';
-import { BigDecimal } from '@nadohq/utils';
+import { BigDecimal, Subaccount } from '@nadohq/shared';
 import {
   GetIndexerInterestFundingPaymentsParams,
   GetIndexerInterestFundingPaymentsResponse,
@@ -104,7 +103,7 @@ export type GetIndexerSubaccountMatchEventsResponse =
  */
 
 export type GetIndexerPaginatedOrdersParams = BaseSubaccountPaginationParams &
-  Pick<GetIndexerOrdersParams, 'productIds' | 'isolated'>;
+  Pick<GetIndexerOrdersParams, 'productIds' | 'triggerTypes' | 'isolated'>;
 
 export interface GetIndexerPaginatedOrdersResponse {
   orders: IndexerOrder[];

package/src/types/serverModelTypes.ts

@@ -1,10 +1,10 @@
-import { EIP712OrderValues } from '@nadohq/contracts';
 import {
   EngineServerPerpBalance,
   EngineServerPerpProduct,
   EngineServerSpotBalance,
   EngineServerSpotProduct,
 } from '@nadohq/engine-client';
+import { EIP712OrderValues } from '@nadohq/shared';
 import { IndexerEventType } from './IndexerEventType';
 import { NadoTx } from './NadoTx';
 
@@ -78,6 +78,10 @@ export interface IndexerServerEvent {
   net_funding_cumulative: string;
   net_entry_unrealized: string;
   net_entry_cumulative: string;
+  /**
+   * Total traded volume in terms of the primary quote (i.e in terms of USDT) for this product
+   */
+  quote_volume_cumulative: string;
 }
 
 export interface IndexerServerTx {
@@ -92,13 +96,13 @@ export interface IndexerServerTx {
 
 export interface IndexerServerOrder {
   digest: string;
-  isolated: boolean;
   subaccount: string;
   product_id: number;
   submission_idx: string;
   amount: string;
   price_x18: string;
   expiration: string;
+  appendix: string;
   nonce: string;
   base_filled: string;
   // Includes fee
@@ -258,8 +262,8 @@ export interface IndexerServerLeaderboardRegistration {
  */
 
 export interface IndexerServerNlpSnapshot {
-  cumulative_burn_usdc: string;
-  cumulative_mint_usdc: string;
+  cumulative_burn_quote: string;
+  cumulative_mint_quote: string;
   cumulative_pnl: string;
   cumulative_trades: string;
   cumulative_volume: string;

package/src/types/serverTypes.ts

@@ -1,7 +1,7 @@
 import {
   EIP712LeaderboardAuthenticationValues,
   SignedTx,
-} from '@nadohq/contracts';
+} from '@nadohq/shared';
 import { IndexerEventType } from './IndexerEventType';
 import { IndexerLeaderboardRankType } from './IndexerLeaderboardType';
 import { NadoWithdrawCollateralTx } from './NadoTx';
@@ -15,13 +15,13 @@ import {
   IndexerServerMarketSnapshot,
   IndexerServerMarketSnapshotInterval,
   IndexerServerMatchEvent,
+  IndexerServerNlpSnapshot,
   IndexerServerOraclePrice,
   IndexerServerOrder,
   IndexerServerProductPayment,
   IndexerServerProductSnapshot,
   IndexerServerSnapshotsInterval,
   IndexerServerTx,
-  IndexerServerNlpSnapshot,
 } from './serverModelTypes';
 
 /**
@@ -112,9 +112,15 @@ export interface IndexerServerEventsParams {
       };
 }
 
+export type IndexerServerTriggerTypeFilter =
+  | 'none'
+  | 'price_trigger'
+  | 'time_trigger';
+
 export interface IndexerServerOrdersParams {
   subaccount?: string;
   product_ids?: number[];
+  trigger_types?: IndexerServerTriggerTypeFilter[];
   digests?: string[];
   max_time?: number;
   limit?: number;
@@ -197,11 +203,16 @@ export interface IndexerServerNlpSnapshotsParams {
   interval: IndexerServerSnapshotsInterval;
 }
 
+export interface IndexerServerDDAQueryParams {
+  subaccount: string;
+}
+
 // Request
 export interface IndexerServerQueryRequestByType {
   account_snapshots: IndexerServerMultiSubaccountSnapshotsParams;
   backlog: Record<string, never>;
   candlesticks: IndexerServerCandlesticksParams;
+  direct_deposit_address: IndexerServerDDAQueryParams;
   edge_candlesticks: IndexerEdgeServerCandlesticksParams;
   edge_market_snapshots: IndexerEdgeServerMarketSnapshotsParams;
   events: IndexerServerEventsParams;
@@ -225,7 +236,7 @@ export interface IndexerServerQueryRequestByType {
   products: IndexerServerProductsParams;
   referral_code: IndexerServerReferralCodeParams;
   subaccounts: IndexerServerListSubaccountsParams;
-  usdc_price: Record<string, never>;
+  quote_price: Record<string, never>;
   nlp_snapshots: IndexerServerNlpSnapshotsParams;
 }
 
@@ -318,7 +329,7 @@ export interface IndexerServerMatchEventsResponse {
   txs: IndexerServerTx[];
 }
 
-export interface IndexerServerUsdcPriceResponse {
+export interface IndexerServerQuotePriceResponse {
   price_x18: string;
 }
 
@@ -379,6 +390,10 @@ export interface IndexerServerNlpSnapshotsResponse {
   snapshots: IndexerServerNlpSnapshot[];
 }
 
+export interface IndexerServerDDAResponse {
+  v1_address: string;
+}
+
 export interface IndexerServerBacklogResponse {
   // Total number of transactions stored in the indexer DB
   total_txs: string;
@@ -399,6 +414,7 @@ export interface IndexerServerQueryResponseByType {
   account_snapshots: IndexerServerMultiSubaccountSnapshotsResponse;
   backlog: IndexerServerBacklogResponse;
   candlesticks: IndexerServerCandlesticksResponse;
+  direct_deposit_address: IndexerServerDDAResponse;
   edge_candlesticks: IndexerEdgeServerCandlesticksResponse;
   edge_market_snapshots: IndexerEdgeServerMarketSnapshotsResponse;
   events: IndexerServerEventsResponse;
@@ -422,6 +438,33 @@ export interface IndexerServerQueryResponseByType {
   products: IndexerServerProductsResponse;
   referral_code: IndexerServerReferralCodeResponse;
   subaccounts: IndexerServerListSubaccountsResponse;
-  usdc_price: IndexerServerUsdcPriceResponse;
+  quote_price: IndexerServerQuotePriceResponse;
   nlp_snapshots: IndexerServerNlpSnapshotsResponse;
 }
+
+/**
+ * V2 API Types
+ */
+
+/**
+ * Individual ticker data from v2 indexer endpoint (server format)
+ */
+export interface IndexerServerV2TickerResponse {
+  product_id: number;
+  ticker_id: string;
+  base_currency: string;
+  quote_currency: string;
+  last_price: number;
+  base_volume: number;
+  quote_volume: number;
+  price_change_percent_24h: number;
+}
+
+/**
+ * Response from v2 tickers endpoint (server format)
+ * Maps ticker IDs to their respective ticker data
+ */
+export type IndexerServerV2TickersResponse = Record<
+  string,
+  IndexerServerV2TickerResponse
+>;

package/src/utils/indexerBalanceValue.ts

@@ -1,4 +1,4 @@
-import { BigDecimal } from '@nadohq/utils';
+import { BigDecimal } from '@nadohq/shared';
 import { IndexerPerpBalance, IndexerSpotBalance } from '../types';
 
 /**