feat(jellyfish-api-core): listVaultHistory RPC

docs/node/CATEGORIES/16-loan.md

@@ -702,6 +702,7 @@ interface HighestBid {
   owner: string
 }
 ```
+
 ## listAuctionHistory
 
 Returns information about auction history.
@@ -728,4 +729,55 @@ interface ListAuctionHistoryDetail {
   auctionBid: string
   auctionWon: string[]
 }
+```
+
+## listVaultHistory
+
+Returns the history of the specified vault.
+
+```ts title="client.loan.listVaultHistory()"
+interface loan {
+  listVaultHistory (vaultId: string, pagination?: ListVaultHistoryPagination): Promise<ListVaultHistory[]>
+}
+
+interface ListVaultHistoryPagination {
+  maxBlockHeight?: number
+  depth?: number
+  token?: string
+  txType?: string
+  limit?: number
+}
+
+interface ListVaultHistory {
+  blockHeight: number
+  blockHash: string
+  blockTime: number
+  type: string
+  txid: string
+  address?: string,
+  amounts?: string[], // amount@symbol
+  loanScheme?: CreateLoanScheme
+  vaultSnapshot?: VaultHistorySnapshot
+}
+
+interface CreateLoanScheme {
+  minColRatio: number
+  interestRate: BigNumber
+  id: string
+}
+
+interface VaultHistorySnapshot {
+  state: 'inLiquidation' | 'active'
+  collateralAmounts: string[], // amount@symbol
+  collateralValue: number,
+  collateralRatio: number,
+  batches?: VaultLiquidationBatch[]
+}
+
+interface VaultLiquidationBatch {
+  index: number
+  collaterals: string[]
+  loan: string
+  highestBid?: HighestBid
+}
 ```