@exponent-labs/klend-idl 0.9.24 → 0.9.26

package/build/types/index.js

@@ -33,31 +33,47 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CurvePoint = exports.BorrowRateCurve = exports.TokenInfo = exports.SwitchboardConfiguration = exports.ScopeConfiguration = exports.PythConfiguration = exports.PriceHeuristic = exports.WithdrawalCaps = exports.ReserveStatus = exports.ReserveLiquidity = exports.ReserveFees = exports.ReserveFarmKind = exports.ReserveConfig = exports.ReserveCollateral = exports.FeeCalculation = exports.BigFractionBytes = exports.AssetTier = exports.ObligationLiquidity = exports.ObligationCollateral = exports.InitObligationArgs = exports.ElevationGroup = exports.LastUpdate = exports.UpdateLendingMarketMode = exports.UpdateLendingMarketConfigValue = exports.UpdateConfigMode = void 0;
+exports.CurvePoint = exports.BorrowRateCurve = exports.ProgressCallbackType = exports.TokenInfo = exports.SwitchboardConfiguration = exports.ScopeConfiguration = exports.PythConfiguration = exports.PriceHeuristic = exports.WithdrawalCaps = exports.WithdrawQueue = exports.ReserveStatus = exports.ReserveLiquidity = exports.ReserveFees = exports.ReserveFarmKind = exports.ReserveConfig = exports.ReserveCollateral = exports.FeeCalculation = exports.BigFractionBytes = exports.UpdateObligationConfigMode = exports.ObligationOrder = exports.ObligationLiquidity = exports.ObligationCollateral = exports.InitObligationArgs = exports.FixedTermBorrowRolloverConfig = exports.BorrowOrder = exports.ElevationGroup = exports.LastUpdate = exports.UpdateGlobalConfigMode = exports.UpdateLendingMarketMode = exports.UpdateLendingMarketConfigValue = exports.UpdateConfigMode = exports.BorrowOrderConfigArgs = exports.ReserveConfigCustomizationArgs = exports.ExchangeRateWithDecimals = void 0;
 const UpdateConfigMode = __importStar(require("./UpdateConfigMode"));
 exports.UpdateConfigMode = UpdateConfigMode;
 const UpdateLendingMarketConfigValue = __importStar(require("./UpdateLendingMarketConfigValue"));
 exports.UpdateLendingMarketConfigValue = UpdateLendingMarketConfigValue;
 const UpdateLendingMarketMode = __importStar(require("./UpdateLendingMarketMode"));
 exports.UpdateLendingMarketMode = UpdateLendingMarketMode;
-const AssetTier = __importStar(require("./AssetTier"));
-exports.AssetTier = AssetTier;
+const UpdateGlobalConfigMode = __importStar(require("./UpdateGlobalConfigMode"));
+exports.UpdateGlobalConfigMode = UpdateGlobalConfigMode;
+const UpdateObligationConfigMode = __importStar(require("./UpdateObligationConfigMode"));
+exports.UpdateObligationConfigMode = UpdateObligationConfigMode;
 const FeeCalculation = __importStar(require("./FeeCalculation"));
 exports.FeeCalculation = FeeCalculation;
 const ReserveFarmKind = __importStar(require("./ReserveFarmKind"));
 exports.ReserveFarmKind = ReserveFarmKind;
 const ReserveStatus = __importStar(require("./ReserveStatus"));
 exports.ReserveStatus = ReserveStatus;
+const ProgressCallbackType = __importStar(require("./ProgressCallbackType"));
+exports.ProgressCallbackType = ProgressCallbackType;
+var ExchangeRateWithDecimals_1 = require("./ExchangeRateWithDecimals");
+Object.defineProperty(exports, "ExchangeRateWithDecimals", { enumerable: true, get: function () { return ExchangeRateWithDecimals_1.ExchangeRateWithDecimals; } });
+var ReserveConfigCustomizationArgs_1 = require("./ReserveConfigCustomizationArgs");
+Object.defineProperty(exports, "ReserveConfigCustomizationArgs", { enumerable: true, get: function () { return ReserveConfigCustomizationArgs_1.ReserveConfigCustomizationArgs; } });
+var BorrowOrderConfigArgs_1 = require("./BorrowOrderConfigArgs");
+Object.defineProperty(exports, "BorrowOrderConfigArgs", { enumerable: true, get: function () { return BorrowOrderConfigArgs_1.BorrowOrderConfigArgs; } });
 var LastUpdate_1 = require("./LastUpdate");
 Object.defineProperty(exports, "LastUpdate", { enumerable: true, get: function () { return LastUpdate_1.LastUpdate; } });
 var ElevationGroup_1 = require("./ElevationGroup");
 Object.defineProperty(exports, "ElevationGroup", { enumerable: true, get: function () { return ElevationGroup_1.ElevationGroup; } });
+var BorrowOrder_1 = require("./BorrowOrder");
+Object.defineProperty(exports, "BorrowOrder", { enumerable: true, get: function () { return BorrowOrder_1.BorrowOrder; } });
+var FixedTermBorrowRolloverConfig_1 = require("./FixedTermBorrowRolloverConfig");
+Object.defineProperty(exports, "FixedTermBorrowRolloverConfig", { enumerable: true, get: function () { return FixedTermBorrowRolloverConfig_1.FixedTermBorrowRolloverConfig; } });
 var InitObligationArgs_1 = require("./InitObligationArgs");
 Object.defineProperty(exports, "InitObligationArgs", { enumerable: true, get: function () { return InitObligationArgs_1.InitObligationArgs; } });
 var ObligationCollateral_1 = require("./ObligationCollateral");
 Object.defineProperty(exports, "ObligationCollateral", { enumerable: true, get: function () { return ObligationCollateral_1.ObligationCollateral; } });
 var ObligationLiquidity_1 = require("./ObligationLiquidity");
 Object.defineProperty(exports, "ObligationLiquidity", { enumerable: true, get: function () { return ObligationLiquidity_1.ObligationLiquidity; } });
+var ObligationOrder_1 = require("./ObligationOrder");
+Object.defineProperty(exports, "ObligationOrder", { enumerable: true, get: function () { return ObligationOrder_1.ObligationOrder; } });
 var BigFractionBytes_1 = require("./BigFractionBytes");
 Object.defineProperty(exports, "BigFractionBytes", { enumerable: true, get: function () { return BigFractionBytes_1.BigFractionBytes; } });
 var ReserveCollateral_1 = require("./ReserveCollateral");
@@ -68,6 +84,8 @@ var ReserveFees_1 = require("./ReserveFees");
 Object.defineProperty(exports, "ReserveFees", { enumerable: true, get: function () { return ReserveFees_1.ReserveFees; } });
 var ReserveLiquidity_1 = require("./ReserveLiquidity");
 Object.defineProperty(exports, "ReserveLiquidity", { enumerable: true, get: function () { return ReserveLiquidity_1.ReserveLiquidity; } });
+var WithdrawQueue_1 = require("./WithdrawQueue");
+Object.defineProperty(exports, "WithdrawQueue", { enumerable: true, get: function () { return WithdrawQueue_1.WithdrawQueue; } });
 var WithdrawalCaps_1 = require("./WithdrawalCaps");
 Object.defineProperty(exports, "WithdrawalCaps", { enumerable: true, get: function () { return WithdrawalCaps_1.WithdrawalCaps; } });
 var PriceHeuristic_1 = require("./PriceHeuristic");

package/build/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qEAAsD;AAQ7C,4CAAgB;AAPzB,iGAAkF;AA0GzE,wEAA8B;AAzGvC,mFAAoE;AA8H3D,0DAAuB;AA7HhC,uDAAwC;AAyL/B,8BAAS;AAxLlB,iEAAkD;AAwMzC,wCAAc;AAvMvB,mEAAoD;AAuN3C,0CAAe;AAtNxB,+DAAgD;AAsOvC,sCAAa;AAnEtB,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AAEnB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AAEvB,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAK3B,+DAA6D;AAApD,4HAAA,oBAAoB,OAAA;AAK7B,6DAA2D;AAAlD,0HAAA,mBAAmB,OAAA;AAgB5B,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AAczB,yDAAuD;AAA9C,sHAAA,iBAAiB,OAAA;AAK1B,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AAWtB,6CAA2C;AAAlC,0GAAA,WAAW,OAAA;AAEpB,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AAgBzB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AAEvB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AAEvB,yDAAuD;AAA9C,sHAAA,iBAAiB,OAAA;AAK1B,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAK3B,uEAAqE;AAA5D,oIAAA,wBAAwB,OAAA;AAKjC,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAElB,qDAAmD;AAA1C,kHAAA,eAAe,OAAA;AAKxB,2CAAyC;AAAhC,wGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qEAAsD;AAyB7C,4CAAgB;AAxBzB,iGAAkF;AAqJzE,wEAA8B;AApJvC,mFAAoE;AA2K3D,0DAAuB;AA1KhC,iFAAkE;AA6QzD,wDAAsB;AA5Q/B,yFAA0E;AAoTjE,gEAA0B;AAnTnC,iEAAkD;AAyUzC,wCAAc;AAxUvB,mEAAoD;AAwV3C,0CAAe;AAvVxB,+DAAgD;AAuWvC,sCAAa;AAtWtB,6EAA8D;AAwYrD,oDAAoB;AAtY7B,uEAAqE;AAA5D,oIAAA,wBAAwB,OAAA;AAKjC,mFAAiF;AAAxE,gJAAA,8BAA8B,OAAA;AAKvC,iEAA+D;AAAtD,8HAAA,qBAAqB,OAAA;AAqQ9B,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AAEnB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AAEvB,6CAA2C;AAAlC,0GAAA,WAAW,OAAA;AAEpB,iFAA+E;AAAtE,8IAAA,6BAA6B,OAAA;AAKtC,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAK3B,+DAA6D;AAApD,4HAAA,oBAAoB,OAAA;AAK7B,6DAA2D;AAAlD,0HAAA,mBAAmB,OAAA;AAK5B,qDAAmD;AAA1C,kHAAA,eAAe,OAAA;AAsBxB,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AAczB,yDAAuD;AAA9C,sHAAA,iBAAiB,OAAA;AAK1B,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AAWtB,6CAA2C;AAAlC,0GAAA,WAAW,OAAA;AAEpB,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AAgBzB,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AAEtB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AAEvB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AAEvB,yDAAuD;AAA9C,sHAAA,iBAAiB,OAAA;AAK1B,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAK3B,uEAAqE;AAA5D,oIAAA,wBAAwB,OAAA;AAKjC,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAWlB,qDAAmD;AAA1C,kHAAA,eAAe,OAAA;AAKxB,2CAAyC;AAAhC,wGAAA,UAAU,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exponent-labs/klend-idl",
-  "version": "0.9.24",
+  "version": "0.9.26",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "exports": {
@@ -37,7 +37,7 @@
   "license": "AGPL-3.0",
   "scripts": {
     "build": "tsc --build",
-    "gen": "anchor-client-gen ./src/kamino_lending.json ./src --program-id=KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD"
+    "gen": "node ./scripts/verify-idl-provenance.mjs && rm -rf src/accounts src/errors src/instructions src/types src/programId.ts && anchor-client-gen ./src/kamino_lending.json ./src --program-id=KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD && node ./scripts/patch-optional-accounts.mjs && node ./scripts/generate-idl-module.mjs && prettier --write ./src/kamino_lending.ts"
   },
   "dependencies": {
     "@coral-xyz/borsh": "^0.28.0",
@@ -45,6 +45,7 @@
     "bn.js": "^5.2.1"
   },
   "devDependencies": {
+    "anchor-client-gen": "0.28.1",
     "typescript": "5.4.5"
   }
 }

package/scripts/generate-idl-module.mjs

@@ -0,0 +1,18 @@
+import { readFileSync, writeFileSync } from "node:fs"
+import { dirname, join } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const idlPath = join(packageRoot, "src", "kamino_lending.json")
+const modulePath = join(packageRoot, "src", "kamino_lending.ts")
+const idl = JSON.parse(readFileSync(idlPath, "utf8"))
+
+const source = `import idl from "./kamino_lending.json"
+
+type KaminoLendingIdl = ${JSON.stringify(idl, null, 2)}
+
+export const IDL = idl as KaminoLendingIdl
+export type KaminoLending = typeof IDL
+`
+
+writeFileSync(modulePath, source)

package/scripts/patch-optional-accounts.mjs

@@ -0,0 +1,98 @@
+import { readFileSync, writeFileSync } from "node:fs"
+import { dirname, join } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const idlPath = join(packageRoot, "src", "kamino_lending.json")
+const idl = JSON.parse(readFileSync(idlPath, "utf8"))
+
+const OPTIONAL_ACCOUNT_META = `function optionalAccountMeta(
+  pubkey: PublicKey | null | undefined,
+  isWritable: boolean,
+  programId: PublicKey
+): AccountMeta {
+  return {
+    pubkey: pubkey ?? programId,
+    isSigner: false,
+    isWritable: pubkey === null || pubkey === undefined ? false : isWritable,
+  }
+}`
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+}
+
+function collectOptionalAccounts(accounts, parentPath = []) {
+  return accounts.flatMap((account) => {
+    const accountPath = [...parentPath, account.name]
+    if (account.accounts) {
+      return collectOptionalAccounts(account.accounts, accountPath)
+    }
+    return account.isOptional ? [{ ...account, path: accountPath }] : []
+  })
+}
+
+function replaceAndCount(source, pattern, replacement) {
+  let count = 0
+  return {
+    source: source.replace(pattern, (...args) => {
+      count += 1
+      return typeof replacement === "function" ? replacement(...args) : replacement
+    }),
+    count,
+  }
+}
+
+for (const instruction of idl.instructions) {
+  const optionalAccounts = collectOptionalAccounts(instruction.accounts)
+  if (optionalAccounts.length === 0) continue
+
+  const instructionPath = join(packageRoot, "src", "instructions", `${instruction.name}.ts`)
+  let source = readFileSync(instructionPath, "utf8")
+  const optionalNameCounts = new Map()
+
+  for (const account of optionalAccounts) {
+    optionalNameCounts.set(account.name, (optionalNameCounts.get(account.name) ?? 0) + 1)
+  }
+
+  for (const [accountName, expectedCount] of optionalNameCounts) {
+    const propertyPattern = new RegExp(`(^\\s+${escapeRegExp(accountName)}): PublicKey$`, "gm")
+    const result = replaceAndCount(source, propertyPattern, (_match, propertyPrefix) => {
+      return `${propertyPrefix}?: PublicKey | null`
+    })
+    if (result.count !== expectedCount) {
+      throw new Error(
+        `Expected ${expectedCount} optional ${accountName} properties in ${instruction.name}, found ${result.count}`,
+      )
+    }
+    source = result.source
+  }
+
+  for (const account of optionalAccounts) {
+    const accountExpression = `accounts.${account.path.join(".")}`
+    const metaPattern = new RegExp(
+      `\\{\\s*pubkey: ${escapeRegExp(accountExpression)},\\s*isSigner: false,\\s*isWritable: (true|false),?\\s*\\}`,
+      "g",
+    )
+    const result = replaceAndCount(source, metaPattern, (_match, generatedWritable) => {
+      if (generatedWritable !== String(account.isMut)) {
+        throw new Error(
+          `Generated writable metadata differs from the IDL for ${instruction.name}.${account.path.join(".")}`,
+        )
+      }
+      return `optionalAccountMeta(${accountExpression}, ${account.isMut}, programId)`
+    })
+    if (result.count !== 1) {
+      throw new Error(`Expected one optional account meta for ${instruction.name}.${account.path.join(".")}`)
+    }
+    source = result.source
+  }
+
+  const functionMarker = "export function "
+  const markerIndex = source.indexOf(functionMarker)
+  if (markerIndex < 0) {
+    throw new Error(`Unable to find the instruction builder in ${instruction.name}`)
+  }
+  source = `${source.slice(0, markerIndex)}${OPTIONAL_ACCOUNT_META}\n\n${source.slice(markerIndex)}`
+  writeFileSync(instructionPath, source)
+}

package/scripts/verify-idl-provenance.mjs

@@ -0,0 +1,16 @@
+import { createHash } from "node:crypto"
+import { readFileSync } from "node:fs"
+import { dirname, join } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const KLEND_SDK_VERSION = "11.0.2"
+const EXPECTED_IDL_SHA256 = "8227dbd383940cb42f93cee9623f2127192b988f75aa5cb8dbc477b938930c62"
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const idlPath = join(packageRoot, "src", "kamino_lending.json")
+const actualIdlSha256 = createHash("sha256").update(readFileSync(idlPath)).digest("hex")
+
+if (actualIdlSha256 !== EXPECTED_IDL_SHA256) {
+  throw new Error(
+    `KLend IDL does not match @kamino-finance/klend-sdk@${KLEND_SDK_VERSION}: expected ${EXPECTED_IDL_SHA256}, received ${actualIdlSha256}`,
+  )
+}

package/src/accounts/GlobalConfig.ts

@@ -0,0 +1,113 @@
+import { PublicKey, Connection } from "@solana/web3.js"
+import BN from "bn.js" // eslint-disable-line @typescript-eslint/no-unused-vars
+import * as borsh from "@coral-xyz/borsh" // eslint-disable-line @typescript-eslint/no-unused-vars
+import * as types from "../types" // eslint-disable-line @typescript-eslint/no-unused-vars
+import { PROGRAM_ID } from "../programId"
+
+export interface GlobalConfigFields {
+  globalAdmin: PublicKey
+  pendingAdmin: PublicKey
+  feeCollector: PublicKey
+  padding: Array<number>
+}
+
+export interface GlobalConfigJSON {
+  globalAdmin: string
+  pendingAdmin: string
+  feeCollector: string
+  padding: Array<number>
+}
+
+export class GlobalConfig {
+  readonly globalAdmin: PublicKey
+  readonly pendingAdmin: PublicKey
+  readonly feeCollector: PublicKey
+  readonly padding: Array<number>
+
+  static readonly discriminator = Buffer.from([
+    149, 8, 156, 202, 160, 252, 176, 217,
+  ])
+
+  static readonly layout = borsh.struct([
+    borsh.publicKey("globalAdmin"),
+    borsh.publicKey("pendingAdmin"),
+    borsh.publicKey("feeCollector"),
+    borsh.array(borsh.u8(), 928, "padding"),
+  ])
+
+  constructor(fields: GlobalConfigFields) {
+    this.globalAdmin = fields.globalAdmin
+    this.pendingAdmin = fields.pendingAdmin
+    this.feeCollector = fields.feeCollector
+    this.padding = fields.padding
+  }
+
+  static async fetch(
+    c: Connection,
+    address: PublicKey,
+    programId: PublicKey = PROGRAM_ID
+  ): Promise<GlobalConfig | null> {
+    const info = await c.getAccountInfo(address)
+
+    if (info === null) {
+      return null
+    }
+    if (!info.owner.equals(programId)) {
+      throw new Error("account doesn't belong to this program")
+    }
+
+    return this.decode(info.data)
+  }
+
+  static async fetchMultiple(
+    c: Connection,
+    addresses: PublicKey[],
+    programId: PublicKey = PROGRAM_ID
+  ): Promise<Array<GlobalConfig | null>> {
+    const infos = await c.getMultipleAccountsInfo(addresses)
+
+    return infos.map((info) => {
+      if (info === null) {
+        return null
+      }
+      if (!info.owner.equals(programId)) {
+        throw new Error("account doesn't belong to this program")
+      }
+
+      return this.decode(info.data)
+    })
+  }
+
+  static decode(data: Buffer): GlobalConfig {
+    if (!data.slice(0, 8).equals(GlobalConfig.discriminator)) {
+      throw new Error("invalid account discriminator")
+    }
+
+    const dec = GlobalConfig.layout.decode(data.slice(8))
+
+    return new GlobalConfig({
+      globalAdmin: dec.globalAdmin,
+      pendingAdmin: dec.pendingAdmin,
+      feeCollector: dec.feeCollector,
+      padding: dec.padding,
+    })
+  }
+
+  toJSON(): GlobalConfigJSON {
+    return {
+      globalAdmin: this.globalAdmin.toString(),
+      pendingAdmin: this.pendingAdmin.toString(),
+      feeCollector: this.feeCollector.toString(),
+      padding: this.padding,
+    }
+  }
+
+  static fromJSON(obj: GlobalConfigJSON): GlobalConfig {
+    return new GlobalConfig({
+      globalAdmin: new PublicKey(obj.globalAdmin),
+      pendingAdmin: new PublicKey(obj.pendingAdmin),
+      feeCollector: new PublicKey(obj.feeCollector),
+      padding: obj.padding,
+    })
+  }
+}