import { ChainId } from "../../model/primitives.js";
import { Position, PositionId, PositionKind } from "../../model/positions.js";
import { ChainMetadata, DataResponse } from "../../model/response.js";
import "../../model/index.js";
import { ChainCompareCounts, CompareCounts, DiffPathCount, FieldDiff } from "./fieldDiff.js";
import { Address } from "viem";
//#region src/dev/mode-parity/comparePositions.d.ts
/**
 * Enough of a position to identify it in a report without carrying the whole
 * row.
 **/
export interface PositionRef {
  id: PositionId;
  kind: PositionKind;
  chainId: ChainId;
  name: string;
  /**
   * Set on a pool position.
   **/
  pool?: Address;
  /**
   * Set on a strategy position.
   **/
  creditAccount?: Address;
  creditManager?: Address;
}
/**
 * One position both sources listed for a wallet, and everything they disagree
 * on.
 **/
export interface PositionMatch {
  id: PositionId;
  kind: PositionKind;
  chainId: ChainId;
  onchainName: string;
  offchainName: string;
  /**
   * No unexpected diffs: every disagreement is mode-scoped, backend-preferred,
   * or within tolerance.
   **/
  similar: boolean;
  diffs: FieldDiff[];
}
/**
 * One wallet's comparison, or the error that stopped it.
 **/
export interface WalletComparison {
  wallet: Address;
  /**
   * Why both listings of this wallet could not be read. When set, the rest of
   * the fields are empty.
   **/
  error?: string;
  onlyOnchain: PositionRef[];
  onlyOffchain: PositionRef[];
  matched: PositionMatch[];
}
/**
 * Counts of one wallet.
 **/
export interface WalletCompareCounts extends CompareCounts {
  wallet: Address;
  /**
   * Present when the wallet's listings could not be read.
   **/
  error?: string;
}
/**
 * Totals of the comparison plus the fields that differed most often.
 **/
export interface PositionsCompareSummary extends CompareCounts {
  wallets: number;
  /**
   * Wallets whose listings were read and that have no membership gaps and no
   * unexpected field diffs.
   **/
  walletsSimilar: number;
  walletsFailed: number;
  byChain: ChainCompareCounts[];
  byWallet: WalletCompareCounts[];
  diffsByPath: DiffPathCount[];
}
/**
 * Everything one comparison run produced, ready to be written out as JSON.
 **/
export interface PositionsCompareReport {
  generatedAt: string;
  backendUrl: string;
  networks: string[];
  /**
   * Per-chain metadata collected from the on-chain reads, which says which
   * block each chain answered from. Taken from the first successful wallet
   * listing of each chain.
   **/
  onchainChains: ChainMetadata[];
  /**
   * Per-chain metadata of the backend reads, see {@link onchainChains}.
   **/
  offchainChains: ChainMetadata[];
  summary: PositionsCompareSummary;
  wallets: WalletComparison[];
}
/**
 * Both listings of one wallet.
 **/
export interface WalletPositions {
  wallet: Address;
  onchain: DataResponse<Position[]>;
  offchain: DataResponse<Position[]>;
}
/**
 * A wallet whose listings could not be read from one or both sources.
 **/
export interface WalletPositionsFailure {
  wallet: Address;
  error: string;
}
/**
 * The per-wallet listings to compare, plus what the run was pointed at.
 **/
export interface ComparePositionsInput {
  wallets: WalletPositions[];
  failures?: WalletPositionsFailure[];
  backendUrl: string;
  networks: string[];
  /**
   * ISO timestamp stamped onto the report, defaulting to now. Pinned by tests.
   **/
  generatedAt?: string;
}
/**
 * Matches two position listings per wallet by {@link positionId} and reports
 * every field the two sources disagree on.
 *
 * Nothing is filtered out. A field only one mode can fill, a strategy field
 * both-mode merge overlays from the backend, or a USD value that drifted
 * within snapshot-lag noise, is still reported — tagged
 * {@link FieldDiff.expected} so that {@link CompareCounts.similar} can ignore
 * it.
 **/
export declare function comparePositions(input: ComparePositionsInput): PositionsCompareReport;
/**
 * Every field two versions of one position disagree on.
 **/
export declare function diffPosition(onchain: Position, offchain: Position): FieldDiff[];
//#endregion