Product Instances (developer)

interface ProductInstance {
  id: number;
  productId: number;
  instanceId: string;          // on-chain token id (BigInt as string)
  instanceNumber: string;      // 1-based on-chain serial number (BigInt as string)
  ownerAddress: string;        // Current owner address
  minterAddress: string | null; // Who minted it; unchanged by a transfer
  status: InstanceTransactionStatus;
  currencyType: InstanceCurrencyType;
  feePaid: string;             // BigInt as string
  txId: string;
  mintTxId: string | null;
  burnTxId: string | null;
  burnedAt: string | null;
  tokenUri: string;
  detachedTokenUri: string | null;  // permanent URL once the owner detaches (detachable capability)
  detachedLocked?: boolean;         // owner froze the override permanently (lock-detached)
  isFeatured: boolean;
  instanceConfig: { version: number } & Record<string, unknown>; // per-edition capability data
  archival?: { state: string; reason?: string }; // saved / archiving / archived ...; see Storage
  bracketEntryDetails?: BracketEntryDetails | null; // PREDICTION entries
  gameMatchDetails?: GameMatchDetails | null;       // GAME matches
  createdAt: string;
  updatedAt: string;
  product?: SmartProduct;           // populated with ?include=page
}

type InstanceTransactionStatus = "PENDING" | "CONFIRMED" | "FAILED";
type InstanceCurrencyType = "STX" | "SBTC";