@kamino-finance/klend-sdk 2.10.6

package/dist/referrals/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/referrals/instructions.ts"],"names":[],"mappings":"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","sourcesContent":["import { PublicKey, SYSVAR_RENT_PUBKEY, SystemProgram, TransactionInstruction, Connection } from '@solana/web3.js';\nimport { KaminoMarket } from '../classes';\nimport { checkIfAccountExists, referrerStatePda, referrerTokenStatePda, shortUrlPda, userMetadataPda } from '../utils';\nimport {\n  PROGRAM_ID,\n  ReferrerState,\n  deleteReferrerStateAndShortUrl,\n  initReferrerStateAndShortUrl,\n  initReferrerTokenState,\n} from '../lib';\n\nexport const getInitAllReferrerTokenStateIxns = async ({\n  referrer,\n  kaminoMarket,\n}: {\n  referrer: PublicKey;\n  kaminoMarket: KaminoMarket;\n}) => {\n  if (referrer.equals(PublicKey.default)) {\n    throw new Error('Referrer not set');\n  }\n\n  await kaminoMarket.loadReserves();\n\n  const initReferrerTokenStateIxns: TransactionInstruction[] = [];\n\n  const tokenStatesToCreate: [PublicKey, PublicKey][] = [];\n  for (const reserve of kaminoMarket.reserves.values()) {\n    const referrerTokenStateAddress = referrerTokenStatePda(referrer, reserve.address, kaminoMarket.programId)[0];\n\n    if (!(await checkIfAccountExists(kaminoMarket.getConnection(), referrerTokenStateAddress))) {\n      tokenStatesToCreate.push([referrerTokenStateAddress, reserve?.address]);\n    }\n  }\n\n  tokenStatesToCreate.forEach(([referrerTokenStateAddress, reserveAddress]) => {\n    const initReferrerTokenStateIx = initReferrerTokenState(\n      {\n        referrer: referrer,\n      },\n      {\n        lendingMarket: kaminoMarket.getAddress(),\n        payer: referrer,\n        reserve: reserveAddress,\n        referrerTokenState: referrerTokenStateAddress,\n        rent: SYSVAR_RENT_PUBKEY,\n        systemProgram: SystemProgram.programId,\n      }\n    );\n\n    initReferrerTokenStateIxns.push(initReferrerTokenStateIx);\n  });\n\n  return initReferrerTokenStateIxns;\n};\n\nexport const getInitReferrerStateAndShortUrlIxns = ({\n  referrer,\n  shortUrl,\n  programId = PROGRAM_ID,\n}: {\n  referrer: PublicKey;\n  shortUrl: string;\n  programId: PublicKey;\n}) => {\n  const [referrerStateAddress] = referrerStatePda(referrer, programId);\n  const [shortUrlAddress] = shortUrlPda(shortUrl, programId);\n\n  const referrerUserMetadataAddress = userMetadataPda(referrer, programId)[0];\n\n  const initReferrerStateAndShortUrlIx = initReferrerStateAndShortUrl(\n    {\n      shortUrl: shortUrl,\n    },\n    {\n      referrer: referrer,\n      referrerState: referrerStateAddress,\n      referrerShortUrl: shortUrlAddress,\n      referrerUserMetadata: referrerUserMetadataAddress,\n      rent: SYSVAR_RENT_PUBKEY,\n      systemProgram: SystemProgram.programId,\n    },\n    programId\n  );\n\n  return initReferrerStateAndShortUrlIx;\n};\n\n// TODO: 1 thing left before adding program id\nexport const getDeleteReferrerStateAndShortUrlIxns = async ({\n  referrer,\n  connection,\n  programId = PROGRAM_ID,\n}: {\n  referrer: PublicKey;\n  connection: Connection;\n  programId: PublicKey;\n}) => {\n  const [referrerStateAddress] = referrerStatePda(referrer, programId);\n  const referrerState = await ReferrerState.fetch(connection, referrerStateAddress, programId);\n\n  const initReferrerStateAndShortUrlIx = deleteReferrerStateAndShortUrl(\n    {\n      referrer: referrer,\n      referrerState: referrerStateAddress,\n      shortUrl: referrerState!.shortUrl,\n      rent: SYSVAR_RENT_PUBKEY,\n      systemProgram: SystemProgram.programId,\n    },\n    programId\n  );\n\n  return initReferrerStateAndShortUrlIx;\n};\n"]}

package/dist/referrals/operations.d.ts

@@ -0,0 +1,97 @@
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+import { KaminoMarket } from '../classes';
+import { UserMetadata } from '../lib';
+import Decimal from 'decimal.js';
+/**
+ * Initialize all referrer token states for a given referrer
+ * @param referrer
+ * @param kaminoMarket
+ */
+export declare const initAllReferrerTokenStates: ({ referrer, kaminoMarket, }: {
+    referrer: Keypair;
+    kaminoMarket: KaminoMarket;
+}) => Promise<string>;
+/**
+ * Initialize referrer state and short url
+ * @param connection
+ * @param referrer
+ * @param shortUrl
+ */
+export declare const createReferrerStateAndShortUrl: ({ connection, referrer, shortUrl, programId, }: {
+    connection: Connection;
+    referrer: Keypair;
+    shortUrl: string;
+    programId?: PublicKey | undefined;
+}) => Promise<string>;
+/**
+ * Initialize referrer state and short url
+ * @param connection
+ * @param referrer
+ * @param newShortUrl
+ */
+export declare const updateReferrerStateAndShortUrl: ({ connection, referrer, newShortUrl, programId, }: {
+    connection: Connection;
+    referrer: Keypair;
+    newShortUrl: string;
+    programId?: PublicKey | undefined;
+}) => Promise<string>;
+/**
+ * Check if short URL available - also checks if short URL is valid (ascii-alphanumeric plus '_' '-', max 32 chars)
+ * @param connection
+ * @param shortUrl
+ * @param programId
+ */
+export declare function isShortUrlAvailable(connection: Connection, shortUrl: string, programId?: PublicKey): Promise<boolean>;
+/**
+ * Get referrer short URL address and shortUrl
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+export declare function getReferrerShortUrl(connection: Connection, referrer: PublicKey, programId?: PublicKey): Promise<[PublicKey | null, string | null]>;
+/**
+ * Get referrer for a given Short URL
+ * @param connection
+ * @param shortUrl
+ * @param programId
+ */
+export declare function getReferrerForShortUrl(connection: Connection, shortUrl: string, programId?: PublicKey): Promise<PublicKey>;
+/**
+ * Get referrer all UserMetadata user accounts linked to a given referrer
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+export declare function getUserMetadatasByReferrer(connection: Connection, referrer: PublicKey, programId?: PublicKey): Promise<UserMetadata[]>;
+/**
+ * Get referrer all UserMetadata user accounts
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+export declare function getAllUserMetadatas(connection: Connection, programId?: PublicKey): Promise<UserMetadata[]>;
+/**
+ * Get referrer all UserMetadata user accounts linked to a given referrer
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+export declare function getTotalUsersReferred(connection: Connection, referrer: PublicKey, programId?: PublicKey): Promise<number>;
+export type ReferralRank = {
+    referrer: PublicKey;
+    totalUsersReferred: number;
+    totalEarningsUsd: Decimal;
+};
+/**
+ * Get ReferralRank array of all referrers ordered by how much they've earned in USD
+ * @param connection
+ * @param kaminoMarket
+ */
+export declare function getReferralsRanking(connection: Connection, kaminoMarket: KaminoMarket): Promise<ReferralRank[]>;
+/**
+ * Get ReferralRank array of all referrers ordered by how much they've earned in USD
+ * @param connection
+ * @param user
+ * @param programId
+ */
+export declare function getUserReferralRanking(connection: Connection, user: PublicKey, kaminoMarket: KaminoMarket): Promise<number | undefined>;

package/dist/referrals/operations.js

@@ -0,0 +1,258 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserReferralRanking = exports.getReferralsRanking = exports.getTotalUsersReferred = exports.getAllUserMetadatas = exports.getUserMetadatasByReferrer = exports.getReferrerForShortUrl = exports.getReferrerShortUrl = exports.isShortUrlAvailable = exports.updateReferrerStateAndShortUrl = exports.createReferrerStateAndShortUrl = exports.initAllReferrerTokenStates = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const utils_1 = require("../utils");
+const instructions_1 = require("./instructions");
+const lib_1 = require("../lib");
+const decimal_js_1 = __importDefault(require("decimal.js"));
+/**
+ * Initialize all referrer token states for a given referrer
+ * @param referrer
+ * @param kaminoMarket
+ */
+const initAllReferrerTokenStates = ({ referrer, kaminoMarket, }) => __awaiter(void 0, void 0, void 0, function* () {
+    const ixns = yield (0, instructions_1.getInitAllReferrerTokenStateIxns)({ referrer: referrer.publicKey, kaminoMarket });
+    const tx = yield (0, utils_1.buildVersionedTransaction)(kaminoMarket.getConnection(), referrer.publicKey, ixns);
+    console.log('Init Referral Token States');
+    return yield (0, utils_1.buildAndSendTxnWithLogs)(kaminoMarket.getConnection(), tx, referrer, [referrer]);
+});
+exports.initAllReferrerTokenStates = initAllReferrerTokenStates;
+/**
+ * Initialize referrer state and short url
+ * @param connection
+ * @param referrer
+ * @param shortUrl
+ */
+const createReferrerStateAndShortUrl = ({ connection, referrer, shortUrl, programId = lib_1.PROGRAM_ID, }) => __awaiter(void 0, void 0, void 0, function* () {
+    const ixn = (0, instructions_1.getInitReferrerStateAndShortUrlIxns)({ referrer: referrer.publicKey, shortUrl, programId });
+    const tx = yield (0, utils_1.buildVersionedTransaction)(connection, referrer.publicKey, [ixn]);
+    console.log('Init ReferrerState for referrer ' + referrer.publicKey.toBase58() + ' and shortUrl ' + shortUrl);
+    return yield (0, utils_1.buildAndSendTxnWithLogs)(connection, tx, referrer, [referrer]);
+});
+exports.createReferrerStateAndShortUrl = createReferrerStateAndShortUrl;
+/**
+ * Initialize referrer state and short url
+ * @param connection
+ * @param referrer
+ * @param newShortUrl
+ */
+const updateReferrerStateAndShortUrl = ({ connection, referrer, newShortUrl, programId = lib_1.PROGRAM_ID, }) => __awaiter(void 0, void 0, void 0, function* () {
+    const deleteIxn = yield (0, instructions_1.getDeleteReferrerStateAndShortUrlIxns)({
+        referrer: referrer.publicKey,
+        connection,
+        programId,
+    });
+    const initIxn = (0, instructions_1.getInitReferrerStateAndShortUrlIxns)({
+        referrer: referrer.publicKey,
+        shortUrl: newShortUrl,
+        programId,
+    });
+    const tx = yield (0, utils_1.buildVersionedTransaction)(connection, referrer.publicKey, [deleteIxn, initIxn]);
+    console.log('Update ReferrerState for referrer ' + referrer.publicKey.toBase58() + ' and shortUrl ' + newShortUrl);
+    return yield (0, utils_1.buildAndSendTxnWithLogs)(connection, tx, referrer, [referrer]);
+});
+exports.updateReferrerStateAndShortUrl = updateReferrerStateAndShortUrl;
+/**
+ * Check if short URL available - also checks if short URL is valid (ascii-alphanumeric plus '_' '-', max 32 chars)
+ * @param connection
+ * @param shortUrl
+ * @param programId
+ */
+function isShortUrlAvailable(connection, shortUrl, programId = lib_1.PROGRAM_ID) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (shortUrl.length > 32) {
+            return false;
+        }
+        if (!/^[a-zA-Z0-9-_]+$/.test(shortUrl)) {
+            return false;
+        }
+        const [shortUrlAddress] = (0, utils_1.shortUrlPda)(shortUrl, programId);
+        const info = yield connection.getAccountInfo(shortUrlAddress);
+        return info === null;
+    });
+}
+exports.isShortUrlAvailable = isShortUrlAvailable;
+/**
+ * Get referrer short URL address and shortUrl
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+function getReferrerShortUrl(connection, referrer, programId = lib_1.PROGRAM_ID) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const [referrerStateAddress] = (0, utils_1.referrerStatePda)(referrer, programId);
+        const referrerState = yield lib_1.ReferrerState.fetch(connection, referrerStateAddress, programId);
+        const shortUrlState = yield lib_1.ShortUrl.fetch(connection, referrerState.shortUrl, programId);
+        const shortUrlAddress = referrerState ? referrerState.shortUrl : null;
+        const shortUrl = shortUrlState ? shortUrlState.shortUrl : null;
+        return [shortUrlAddress, shortUrl];
+    });
+}
+exports.getReferrerShortUrl = getReferrerShortUrl;
+/**
+ * Get referrer for a given Short URL
+ * @param connection
+ * @param shortUrl
+ * @param programId
+ */
+function getReferrerForShortUrl(connection, shortUrl, programId = lib_1.PROGRAM_ID) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const [shortUrlAddress] = (0, utils_1.shortUrlPda)(shortUrl, programId);
+        const shortUrlState = yield lib_1.ShortUrl.fetch(connection, shortUrlAddress, programId);
+        return shortUrlState.referrer;
+    });
+}
+exports.getReferrerForShortUrl = getReferrerForShortUrl;
+/**
+ * Get referrer all UserMetadata user accounts linked to a given referrer
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+function getUserMetadatasByReferrer(connection, referrer, programId = lib_1.PROGRAM_ID) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const userMetadatas = yield connection.getProgramAccounts(programId, {
+            filters: [
+                {
+                    dataSize: lib_1.UserMetadata.layout.span + 8,
+                },
+                {
+                    memcmp: {
+                        offset: 8,
+                        bytes: referrer.toBase58(),
+                    },
+                },
+            ],
+        });
+        return userMetadatas.map((userMetadata) => {
+            if (userMetadata.account === null) {
+                throw new Error('Invalid account');
+            }
+            if (!userMetadata.account.owner.equals(programId)) {
+                throw new Error("account doesn't belong to this program");
+            }
+            const userMetadataAccount = lib_1.UserMetadata.decode(userMetadata.account.data);
+            if (!userMetadataAccount) {
+                throw Error('Could not parse obligation.');
+            }
+            return userMetadataAccount;
+        });
+    });
+}
+exports.getUserMetadatasByReferrer = getUserMetadatasByReferrer;
+/**
+ * Get referrer all UserMetadata user accounts
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+function getAllUserMetadatas(connection, programId = lib_1.PROGRAM_ID) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const userMetadatas = yield connection.getProgramAccounts(programId, {
+            filters: [
+                {
+                    dataSize: lib_1.UserMetadata.layout.span + 8,
+                },
+            ],
+        });
+        return userMetadatas.map((userMetadata) => {
+            if (userMetadata.account === null) {
+                throw new Error('Invalid account');
+            }
+            if (!userMetadata.account.owner.equals(programId)) {
+                throw new Error("account doesn't belong to this program");
+            }
+            const userMetadataAccount = lib_1.UserMetadata.decode(userMetadata.account.data);
+            if (!userMetadataAccount) {
+                throw Error('Could not parse obligation.');
+            }
+            return userMetadataAccount;
+        });
+    });
+}
+exports.getAllUserMetadatas = getAllUserMetadatas;
+/**
+ * Get referrer all UserMetadata user accounts linked to a given referrer
+ * @param connection
+ * @param referrer
+ * @param programId
+ */
+function getTotalUsersReferred(connection, referrer, programId = lib_1.PROGRAM_ID) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const userMetadatas = yield getUserMetadatasByReferrer(connection, referrer, programId);
+        return userMetadatas.length;
+    });
+}
+exports.getTotalUsersReferred = getTotalUsersReferred;
+/**
+ * Get ReferralRank array of all referrers ordered by how much they've earned in USD
+ * @param connection
+ * @param kaminoMarket
+ */
+function getReferralsRanking(connection, kaminoMarket) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const referrersUsersReferred = new utils_1.PublicKeyMap();
+        // counting users referred for each referrer
+        const userMetadatas = yield getAllUserMetadatas(connection, kaminoMarket.programId);
+        for (const userMetadata of userMetadatas) {
+            const referrer = userMetadata.referrer;
+            const usersReferred = referrersUsersReferred.get(referrer);
+            if (usersReferred) {
+                referrersUsersReferred.set(referrer, usersReferred + 1);
+            }
+            else {
+                referrersUsersReferred.set(referrer, 1);
+            }
+        }
+        const referralsRankArray = [];
+        for (const referrer of referrersUsersReferred.keys()) {
+            const referrerTokenStates = yield kaminoMarket.getAllReferrerFeesCumulative(referrer);
+            let totalEarningsUsd = new decimal_js_1.default(0);
+            // calculating earnings for each referrer
+            for (const reserve of kaminoMarket.reserves.values()) {
+                totalEarningsUsd = totalEarningsUsd.add(referrerTokenStates.get(reserve.getLiquidityMint()).mul(reserve.getReserveMarketPrice()));
+            }
+            referralsRankArray.push({
+                referrer: new web3_js_1.PublicKey(referrer),
+                totalUsersReferred: referrersUsersReferred.get(referrer),
+                totalEarningsUsd: totalEarningsUsd,
+            });
+        }
+        referralsRankArray.sort((a, b) => {
+            return b.totalEarningsUsd.comparedTo(a.totalEarningsUsd);
+        });
+        return referralsRankArray;
+    });
+}
+exports.getReferralsRanking = getReferralsRanking;
+/**
+ * Get ReferralRank array of all referrers ordered by how much they've earned in USD
+ * @param connection
+ * @param user
+ * @param programId
+ */
+function getUserReferralRanking(connection, user, kaminoMarket) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const referralsRanking = yield getReferralsRanking(connection, kaminoMarket);
+        for (let index = 0; index < referralsRanking.length; index++) {
+            if (user.equals(referralsRanking[index].referrer)) {
+                return index + 1;
+            }
+        }
+    });
+}
+exports.getUserReferralRanking = getUserReferralRanking;
+//# sourceMappingURL=operations.js.map

package/dist/referrals/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/referrals/operations.ts"],"names":[],"mappings":"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","sourcesContent":["import { Connection, Keypair, PublicKey } from '@solana/web3.js';\nimport { KaminoMarket } from '../classes';\nimport {\n  PublicKeyMap,\n  buildAndSendTxnWithLogs,\n  buildVersionedTransaction,\n  referrerStatePda,\n  shortUrlPda,\n} from '../utils';\nimport {\n  getDeleteReferrerStateAndShortUrlIxns,\n  getInitAllReferrerTokenStateIxns,\n  getInitReferrerStateAndShortUrlIxns,\n} from './instructions';\nimport { PROGRAM_ID, UserMetadata, ReferrerState, ShortUrl } from '../lib';\nimport Decimal from 'decimal.js';\n\n/**\n * Initialize all referrer token states for a given referrer\n * @param referrer\n * @param kaminoMarket\n */\nexport const initAllReferrerTokenStates = async ({\n  referrer,\n  kaminoMarket,\n}: {\n  referrer: Keypair;\n  kaminoMarket: KaminoMarket;\n}) => {\n  const ixns = await getInitAllReferrerTokenStateIxns({ referrer: referrer.publicKey, kaminoMarket });\n\n  const tx = await buildVersionedTransaction(kaminoMarket.getConnection(), referrer.publicKey, ixns);\n\n  console.log('Init Referral Token States');\n\n  return await buildAndSendTxnWithLogs(kaminoMarket.getConnection(), tx, referrer, [referrer]);\n};\n\n/**\n * Initialize referrer state and short url\n * @param connection\n * @param referrer\n * @param shortUrl\n */\nexport const createReferrerStateAndShortUrl = async ({\n  connection,\n  referrer,\n  shortUrl,\n  programId = PROGRAM_ID,\n}: {\n  connection: Connection;\n  referrer: Keypair;\n  shortUrl: string;\n  programId?: PublicKey;\n}) => {\n  const ixn = getInitReferrerStateAndShortUrlIxns({ referrer: referrer.publicKey, shortUrl, programId });\n\n  const tx = await buildVersionedTransaction(connection, referrer.publicKey, [ixn]);\n\n  console.log('Init ReferrerState for referrer ' + referrer.publicKey.toBase58() + ' and shortUrl ' + shortUrl);\n\n  return await buildAndSendTxnWithLogs(connection, tx, referrer, [referrer]);\n};\n\n/**\n * Initialize referrer state and short url\n * @param connection\n * @param referrer\n * @param newShortUrl\n */\nexport const updateReferrerStateAndShortUrl = async ({\n  connection,\n  referrer,\n  newShortUrl,\n  programId = PROGRAM_ID,\n}: {\n  connection: Connection;\n  referrer: Keypair;\n  newShortUrl: string;\n  programId?: PublicKey;\n}) => {\n  const deleteIxn = await getDeleteReferrerStateAndShortUrlIxns({\n    referrer: referrer.publicKey,\n    connection,\n    programId,\n  });\n\n  const initIxn = getInitReferrerStateAndShortUrlIxns({\n    referrer: referrer.publicKey,\n    shortUrl: newShortUrl,\n    programId,\n  });\n\n  const tx = await buildVersionedTransaction(connection, referrer.publicKey, [deleteIxn, initIxn]);\n\n  console.log('Update ReferrerState for referrer ' + referrer.publicKey.toBase58() + ' and shortUrl ' + newShortUrl);\n\n  return await buildAndSendTxnWithLogs(connection, tx, referrer, [referrer]);\n};\n\n/**\n * Check if short URL available - also checks if short URL is valid (ascii-alphanumeric plus '_' '-', max 32 chars)\n * @param connection\n * @param shortUrl\n * @param programId\n */\nexport async function isShortUrlAvailable(\n  connection: Connection,\n  shortUrl: string,\n  programId: PublicKey = PROGRAM_ID\n): Promise<boolean> {\n  if (shortUrl.length > 32) {\n    return false;\n  }\n\n  if (!/^[a-zA-Z0-9-_]+$/.test(shortUrl)) {\n    return false;\n  }\n\n  const [shortUrlAddress] = shortUrlPda(shortUrl, programId);\n  const info = await connection.getAccountInfo(shortUrlAddress);\n  return info === null;\n}\n\n/**\n * Get referrer short URL address and shortUrl\n * @param connection\n * @param referrer\n * @param programId\n */\nexport async function getReferrerShortUrl(\n  connection: Connection,\n  referrer: PublicKey,\n  programId: PublicKey = PROGRAM_ID\n): Promise<[PublicKey | null, string | null]> {\n  const [referrerStateAddress] = referrerStatePda(referrer, programId);\n  const referrerState = await ReferrerState.fetch(connection, referrerStateAddress, programId);\n  const shortUrlState = await ShortUrl.fetch(connection, referrerState!.shortUrl, programId);\n  const shortUrlAddress = referrerState ? referrerState.shortUrl : null;\n  const shortUrl = shortUrlState ? shortUrlState.shortUrl : null;\n  return [shortUrlAddress, shortUrl];\n}\n\n/**\n * Get referrer for a given Short URL\n * @param connection\n * @param shortUrl\n * @param programId\n */\nexport async function getReferrerForShortUrl(\n  connection: Connection,\n  shortUrl: string,\n  programId: PublicKey = PROGRAM_ID\n): Promise<PublicKey> {\n  const [shortUrlAddress] = shortUrlPda(shortUrl, programId);\n  const shortUrlState = await ShortUrl.fetch(connection, shortUrlAddress, programId);\n  return shortUrlState!.referrer;\n}\n\n/**\n * Get referrer all UserMetadata user accounts linked to a given referrer\n * @param connection\n * @param referrer\n * @param programId\n */\nexport async function getUserMetadatasByReferrer(\n  connection: Connection,\n  referrer: PublicKey,\n  programId: PublicKey = PROGRAM_ID\n): Promise<UserMetadata[]> {\n  const userMetadatas = await connection.getProgramAccounts(programId, {\n    filters: [\n      {\n        dataSize: UserMetadata.layout.span + 8,\n      },\n      {\n        memcmp: {\n          offset: 8,\n          bytes: referrer.toBase58(),\n        },\n      },\n    ],\n  });\n\n  return userMetadatas.map((userMetadata) => {\n    if (userMetadata.account === null) {\n      throw new Error('Invalid account');\n    }\n    if (!userMetadata.account.owner.equals(programId)) {\n      throw new Error(\"account doesn't belong to this program\");\n    }\n\n    const userMetadataAccount = UserMetadata.decode(userMetadata.account.data);\n\n    if (!userMetadataAccount) {\n      throw Error('Could not parse obligation.');\n    }\n\n    return userMetadataAccount;\n  });\n}\n\n/**\n * Get referrer all UserMetadata user accounts\n * @param connection\n * @param referrer\n * @param programId\n */\nexport async function getAllUserMetadatas(\n  connection: Connection,\n  programId: PublicKey = PROGRAM_ID\n): Promise<UserMetadata[]> {\n  const userMetadatas = await connection.getProgramAccounts(programId, {\n    filters: [\n      {\n        dataSize: UserMetadata.layout.span + 8,\n      },\n    ],\n  });\n\n  return userMetadatas.map((userMetadata) => {\n    if (userMetadata.account === null) {\n      throw new Error('Invalid account');\n    }\n    if (!userMetadata.account.owner.equals(programId)) {\n      throw new Error(\"account doesn't belong to this program\");\n    }\n\n    const userMetadataAccount = UserMetadata.decode(userMetadata.account.data);\n\n    if (!userMetadataAccount) {\n      throw Error('Could not parse obligation.');\n    }\n\n    return userMetadataAccount;\n  });\n}\n\n/**\n * Get referrer all UserMetadata user accounts linked to a given referrer\n * @param connection\n * @param referrer\n * @param programId\n */\nexport async function getTotalUsersReferred(\n  connection: Connection,\n  referrer: PublicKey,\n  programId: PublicKey = PROGRAM_ID\n): Promise<number> {\n  const userMetadatas = await getUserMetadatasByReferrer(connection, referrer, programId);\n  return userMetadatas.length;\n}\n\nexport type ReferralRank = {\n  referrer: PublicKey;\n  totalUsersReferred: number;\n  totalEarningsUsd: Decimal;\n};\n\n/**\n * Get ReferralRank array of all referrers ordered by how much they've earned in USD\n * @param connection\n * @param kaminoMarket\n */\nexport async function getReferralsRanking(connection: Connection, kaminoMarket: KaminoMarket): Promise<ReferralRank[]> {\n  const referrersUsersReferred = new PublicKeyMap<PublicKey, number>();\n\n  // counting users referred for each referrer\n  const userMetadatas = await getAllUserMetadatas(connection, kaminoMarket.programId);\n  for (const userMetadata of userMetadatas) {\n    const referrer = userMetadata.referrer;\n    const usersReferred = referrersUsersReferred.get(referrer);\n    if (usersReferred) {\n      referrersUsersReferred.set(referrer, usersReferred + 1);\n    } else {\n      referrersUsersReferred.set(referrer, 1);\n    }\n  }\n\n  const referralsRankArray: ReferralRank[] = [];\n\n  for (const referrer of referrersUsersReferred.keys()) {\n    const referrerTokenStates = await kaminoMarket.getAllReferrerFeesCumulative(referrer);\n    let totalEarningsUsd = new Decimal(0);\n    // calculating earnings for each referrer\n    for (const reserve of kaminoMarket.reserves.values()) {\n      totalEarningsUsd = totalEarningsUsd.add(\n        referrerTokenStates.get(reserve.getLiquidityMint())!.mul(reserve.getReserveMarketPrice())\n      );\n    }\n\n    referralsRankArray.push({\n      referrer: new PublicKey(referrer),\n      totalUsersReferred: referrersUsersReferred.get(referrer)!,\n      totalEarningsUsd: totalEarningsUsd,\n    });\n  }\n\n  referralsRankArray.sort((a, b) => {\n    return b.totalEarningsUsd.comparedTo(a.totalEarningsUsd);\n  });\n\n  return referralsRankArray;\n}\n\n/**\n * Get ReferralRank array of all referrers ordered by how much they've earned in USD\n * @param connection\n * @param user\n * @param programId\n */\nexport async function getUserReferralRanking(connection: Connection, user: PublicKey, kaminoMarket: KaminoMarket) {\n  const referralsRanking = await getReferralsRanking(connection, kaminoMarket);\n\n  for (let index = 0; index < referralsRanking.length; index++) {\n    if (user.equals(referralsRanking[index].referrer)) {\n      return index + 1;\n    }\n  }\n}\n"]}

package/dist/utils/ObligationType.d.ts

@@ -0,0 +1,49 @@
+import { PublicKey } from '@solana/web3.js';
+import { KaminoMarket, KaminoObligation } from '../classes';
+export type ObligationType = VanillaObligation | MultiplyObligation | LendingObligation;
+export declare enum ObligationTypeTag {
+    Vanilla = 0,
+    Multiply = 1,
+    Lending = 2,
+    Leverage = 3
+}
+export type InitObligationArgsModel = {
+    tag: number;
+    id: number;
+    seed1: PublicKey;
+    seed2: PublicKey;
+};
+export declare class VanillaObligation {
+    readonly programId: PublicKey;
+    static tag: number;
+    constructor(programId: PublicKey);
+    toArgs(): InitObligationArgsModel;
+    toPda(market: PublicKey, user: PublicKey): PublicKey;
+}
+export declare class MultiplyObligation {
+    readonly collToken: PublicKey;
+    readonly debtToken: PublicKey;
+    readonly programId: PublicKey;
+    static tag: number;
+    constructor(collToken: PublicKey, debtToken: PublicKey, programId: PublicKey);
+    toArgs(): InitObligationArgsModel;
+    toPda(market: PublicKey, user: PublicKey): PublicKey;
+}
+export declare class LeverageObligation {
+    readonly collToken: PublicKey;
+    readonly debtToken: PublicKey;
+    readonly programId: PublicKey;
+    static tag: number;
+    constructor(collToken: PublicKey, debtToken: PublicKey, programId: PublicKey);
+    toArgs(): InitObligationArgsModel;
+    toPda(market: PublicKey, user: PublicKey): PublicKey;
+}
+export declare class LendingObligation {
+    readonly token: PublicKey;
+    readonly programId: PublicKey;
+    static tag: number;
+    constructor(token: PublicKey, programId: PublicKey);
+    toArgs(): InitObligationArgsModel;
+    toPda(market: PublicKey, user: PublicKey): PublicKey;
+}
+export declare function getObligationTypeFromObligation(kaminoMarket: KaminoMarket, obligation: KaminoObligation): ObligationType;

package/dist/utils/ObligationType.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getObligationTypeFromObligation = exports.LendingObligation = exports.LeverageObligation = exports.MultiplyObligation = exports.VanillaObligation = exports.ObligationTypeTag = void 0;
+const web3_js_1 = require("@solana/web3.js");
+var ObligationTypeTag;
+(function (ObligationTypeTag) {
+    ObligationTypeTag[ObligationTypeTag["Vanilla"] = 0] = "Vanilla";
+    ObligationTypeTag[ObligationTypeTag["Multiply"] = 1] = "Multiply";
+    ObligationTypeTag[ObligationTypeTag["Lending"] = 2] = "Lending";
+    ObligationTypeTag[ObligationTypeTag["Leverage"] = 3] = "Leverage";
+})(ObligationTypeTag = exports.ObligationTypeTag || (exports.ObligationTypeTag = {}));
+class VanillaObligation {
+    constructor(programId) {
+        this.programId = programId;
+    }
+    toArgs() {
+        const initObligationArgs = {
+            tag: VanillaObligation.tag,
+            id: 0,
+            seed1: web3_js_1.PublicKey.default,
+            seed2: web3_js_1.PublicKey.default,
+        };
+        return initObligationArgs;
+    }
+    toPda(market, user) {
+        return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);
+    }
+}
+exports.VanillaObligation = VanillaObligation;
+VanillaObligation.tag = 0;
+class MultiplyObligation {
+    constructor(collToken, debtToken, programId) {
+        this.collToken = collToken;
+        this.debtToken = debtToken;
+        this.programId = programId;
+    }
+    toArgs() {
+        const initObligationArgs = {
+            tag: MultiplyObligation.tag,
+            id: 0,
+            seed1: this.collToken,
+            seed2: this.debtToken,
+        };
+        return initObligationArgs;
+    }
+    toPda(market, user) {
+        return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);
+    }
+}
+exports.MultiplyObligation = MultiplyObligation;
+MultiplyObligation.tag = 1;
+class LeverageObligation {
+    constructor(collToken, debtToken, programId) {
+        this.collToken = collToken;
+        this.debtToken = debtToken;
+        this.programId = programId;
+    }
+    toArgs() {
+        const initObligationArgs = {
+            tag: LeverageObligation.tag,
+            id: 0,
+            seed1: this.collToken,
+            seed2: this.debtToken,
+        };
+        return initObligationArgs;
+    }
+    toPda(market, user) {
+        return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);
+    }
+}
+exports.LeverageObligation = LeverageObligation;
+LeverageObligation.tag = 3;
+class LendingObligation {
+    constructor(token, programId) {
+        this.token = token;
+        this.programId = programId;
+    }
+    toArgs() {
+        const initObligationArgs = {
+            tag: LendingObligation.tag,
+            id: 0,
+            seed1: this.token,
+            seed2: this.token,
+        };
+        return initObligationArgs;
+    }
+    toPda(market, user) {
+        return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);
+    }
+}
+exports.LendingObligation = LendingObligation;
+LendingObligation.tag = 2;
+function getObligationPdaWithArgs(market, user, args, programId) {
+    const seed = [
+        Buffer.from([args.tag]),
+        Buffer.from([args.id]),
+        user.toBuffer(),
+        market.toBuffer(),
+        args.seed1.toBuffer(),
+        args.seed2.toBuffer(),
+    ];
+    const [obligationAddress, _obligationAddressBump] = web3_js_1.PublicKey.findProgramAddressSync(seed, programId);
+    return obligationAddress;
+}
+function getObligationTypeFromObligation(kaminoMarket, obligation) {
+    switch (obligation.obligationTag) {
+        case VanillaObligation.tag: {
+            return new VanillaObligation(kaminoMarket.programId);
+            break;
+        }
+        case MultiplyObligation.tag: {
+            return new MultiplyObligation(obligation.deposits[0].mintAddress, obligation.borrows[0].mintAddress, kaminoMarket.programId);
+            break;
+        }
+        case LeverageObligation.tag: {
+            return new LeverageObligation(obligation.deposits[0].mintAddress, obligation.borrows[0].mintAddress, kaminoMarket.programId);
+            break;
+        }
+        case LendingObligation.tag: {
+            return new LendingObligation(obligation.deposits[0].mintAddress, kaminoMarket.programId);
+            break;
+        }
+        default: {
+            throw new Error('Invalid obligation type');
+        }
+    }
+}
+exports.getObligationTypeFromObligation = getObligationTypeFromObligation;
+//# sourceMappingURL=ObligationType.js.map

package/dist/utils/ObligationType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObligationType.js","sourceRoot":"","sources":["../../src/utils/ObligationType.ts"],"names":[],"mappings":"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","sourcesContent":["import { PublicKey } from '@solana/web3.js';\nimport { KaminoMarket, KaminoObligation } from '../classes';\n\nexport type ObligationType = VanillaObligation | MultiplyObligation | LendingObligation;\n\nexport enum ObligationTypeTag {\n  Vanilla = 0,\n  Multiply = 1,\n  Lending = 2,\n  Leverage = 3,\n}\n\nexport type InitObligationArgsModel = {\n  tag: number;\n  id: number;\n  seed1: PublicKey;\n  seed2: PublicKey;\n};\n\nexport class VanillaObligation {\n  readonly programId: PublicKey;\n  static tag = 0;\n\n  constructor(programId: PublicKey) {\n    this.programId = programId;\n  }\n  toArgs() {\n    const initObligationArgs: InitObligationArgsModel = {\n      tag: VanillaObligation.tag,\n      id: 0,\n      seed1: PublicKey.default,\n      seed2: PublicKey.default,\n    };\n\n    return initObligationArgs;\n  }\n  toPda(market: PublicKey, user: PublicKey) {\n    return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);\n  }\n}\n\nexport class MultiplyObligation {\n  readonly collToken: PublicKey;\n  readonly debtToken: PublicKey;\n  readonly programId: PublicKey;\n  static tag = 1;\n\n  constructor(collToken: PublicKey, debtToken: PublicKey, programId: PublicKey) {\n    this.collToken = collToken;\n    this.debtToken = debtToken;\n    this.programId = programId;\n  }\n\n  toArgs() {\n    const initObligationArgs: InitObligationArgsModel = {\n      tag: MultiplyObligation.tag,\n      id: 0,\n      seed1: this.collToken,\n      seed2: this.debtToken,\n    };\n\n    return initObligationArgs;\n  }\n  toPda(market: PublicKey, user: PublicKey) {\n    return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);\n  }\n}\n\nexport class LeverageObligation {\n  readonly collToken: PublicKey;\n  readonly debtToken: PublicKey;\n  readonly programId: PublicKey;\n  static tag = 3;\n\n  constructor(collToken: PublicKey, debtToken: PublicKey, programId: PublicKey) {\n    this.collToken = collToken;\n    this.debtToken = debtToken;\n    this.programId = programId;\n  }\n\n  toArgs() {\n    const initObligationArgs: InitObligationArgsModel = {\n      tag: LeverageObligation.tag,\n      id: 0,\n      seed1: this.collToken,\n      seed2: this.debtToken,\n    };\n\n    return initObligationArgs;\n  }\n  toPda(market: PublicKey, user: PublicKey) {\n    return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);\n  }\n}\n\nexport class LendingObligation {\n  readonly token: PublicKey;\n  readonly programId: PublicKey;\n  static tag = 2;\n\n  constructor(token: PublicKey, programId: PublicKey) {\n    this.token = token;\n    this.programId = programId;\n  }\n  toArgs() {\n    const initObligationArgs: InitObligationArgsModel = {\n      tag: LendingObligation.tag,\n      id: 0,\n      seed1: this.token,\n      seed2: this.token,\n    };\n\n    return initObligationArgs;\n  }\n  toPda(market: PublicKey, user: PublicKey) {\n    return getObligationPdaWithArgs(market, user, this.toArgs(), this.programId);\n  }\n}\n\nfunction getObligationPdaWithArgs(\n  market: PublicKey,\n  user: PublicKey,\n  args: InitObligationArgsModel,\n  programId: PublicKey\n) {\n  const seed = [\n    Buffer.from([args.tag]),\n    Buffer.from([args.id]),\n    user.toBuffer(),\n    market.toBuffer(),\n    args.seed1.toBuffer(),\n    args.seed2.toBuffer(),\n  ];\n  const [obligationAddress, _obligationAddressBump] = PublicKey.findProgramAddressSync(seed, programId);\n  return obligationAddress;\n}\n\nexport function getObligationTypeFromObligation(\n  kaminoMarket: KaminoMarket,\n  obligation: KaminoObligation\n): ObligationType {\n  switch (obligation.obligationTag) {\n    case VanillaObligation.tag: {\n      return new VanillaObligation(kaminoMarket.programId);\n      break;\n    }\n    case MultiplyObligation.tag: {\n      return new MultiplyObligation(\n        obligation.deposits[0].mintAddress,\n        obligation.borrows[0].mintAddress,\n        kaminoMarket.programId\n      );\n      break;\n    }\n    case LeverageObligation.tag: {\n      return new LeverageObligation(\n        obligation.deposits[0].mintAddress,\n        obligation.borrows[0].mintAddress,\n        kaminoMarket.programId\n      );\n      break;\n    }\n    case LendingObligation.tag: {\n      return new LendingObligation(obligation.deposits[0].mintAddress, kaminoMarket.programId);\n      break;\n    }\n    default: {\n      throw new Error('Invalid obligation type');\n    }\n  }\n}\n"]}

package/dist/utils/api.d.ts

@@ -0,0 +1,6 @@
+import { PublicKey } from '@solana/web3.js';
+import { ConfigType } from '../classes';
+import { IBackOffOptions } from 'exponential-backoff';
+export declare function getMarketsFromApi(programId?: PublicKey, source?: 'API' | 'CDN'): Promise<ConfigType>;
+export declare const KAMINO_CDN_RETRY: Partial<IBackOffOptions>;
+export declare const KAMINO_API_RETRY: Partial<IBackOffOptions>;