@strkfarm/sdk 1.0.37 → 1.0.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strkfarm/sdk",
-  "version": "1.0.37",
+  "version": "1.0.39",
   "description": "STRKFarm TS SDK (Meant for our internal use, but feel free to use it)",
   "typings": "dist/index.d.ts",
   "types": "dist/index.d.ts",
@@ -51,7 +51,8 @@
     "typescript": "^5.5.3"
   },
   "peerDependencies": {
-    "react": "19.1.0"
+    "react": "19.1.0",
+    "starknet": "^6.11.0"
   },
   "dependencies": {
     "@avnu/avnu-sdk": "^3.0.2",
@@ -67,7 +68,6 @@
     "proxy-from-env": "^1.1.0",
     "redis": "^4.7.0",
     "stacktrace-js": "^2.0.2",
-    "starknet": "^6.11.0",
     "winston": "^3.13.0"
   }
 }

package/src/dataTypes/_bignumber.ts

@@ -1,65 +1,67 @@
-import { logger } from "@/global";
+import { logger } from "@/utils/logger";
 import BigNumber from "bignumber.js";
 
 export class _Web3Number<T extends _Web3Number<T>> extends BigNumber {
-    decimals: number;
+  decimals: number;
 
-    constructor(value: string | number, decimals: number) {
-        super(value);
-        this.decimals = decimals;
-    }
+  constructor(value: string | number, decimals: number) {
+    super(value);
+    this.decimals = decimals;
+  }
 
-    toWei() {
-        return this.mul(10 ** this.decimals).toFixed(0);
-    }
+  toWei() {
+    return this.mul(10 ** this.decimals).toFixed(0);
+  }
 
-    multipliedBy(value: string | number | T): T {
-        const _value = this.getStandardString(value);
-        return this.construct(this.mul(_value).toString(), this.decimals);
-    }
+  multipliedBy(value: string | number | T): T {
+    const _value = this.getStandardString(value);
+    return this.construct(this.mul(_value).toString(), this.decimals);
+  }
 
-    dividedBy(value: string | number | T): T {
-        const _value = this.getStandardString(value);
-        return this.construct(this.div(_value).toString(), this.decimals);
-    }
+  dividedBy(value: string | number | T): T {
+    const _value = this.getStandardString(value);
+    return this.construct(this.div(_value).toString(), this.decimals);
+  }
 
-    plus(value: string | number | T): T {
-        const _value = this.getStandardString(value);
-        return this.construct(this.add(_value).toString(), this.decimals);
-    }
+  plus(value: string | number | T): T {
+    const _value = this.getStandardString(value);
+    return this.construct(this.add(_value).toString(), this.decimals);
+  }
 
-    minus(n: number | string | T, base?: number): T {
-        const _value = this.getStandardString(n);
-        return this.construct(super.minus(_value, base).toString(), this.decimals);
-    }
+  minus(n: number | string | T, base?: number): T {
+    const _value = this.getStandardString(n);
+    return this.construct(super.minus(_value, base).toString(), this.decimals);
+  }
 
-    protected construct(value: string | number, decimals: number): T {
-        return new (this.constructor as { new (value: string | number, decimals: number): T })(value, decimals);
-    }
+  protected construct(value: string | number, decimals: number): T {
+    return new (this.constructor as {
+      new (value: string | number, decimals: number): T;
+    })(value, decimals);
+  }
 
-    toString(decimals: number | undefined = this.maxToFixedDecimals()): string {
-        return super.toFixed(decimals);
-    }
+  toString(): string {
+    return super.toString();
+  }
 
-    toJSON() {
-        return this.toString();
-    }
+  toJSON() {
+    return this.toString();
+  }
 
-    valueOf() {
-        return this.toString();
-    }
+  valueOf() {
+    return this.toString();
+  }
 
-    private maxToFixedDecimals() {
-        return Math.min(this.decimals, 18);
-    }
+  private maxToFixedDecimals() {
+    return Math.min(this.decimals, 18);
+  }
 
-    private getStandardString(value: string | number | T): string {
-        if (typeof value == 'string') {
-            return value
-        }
-        return value.toFixed(this.maxToFixedDecimals())
+  private getStandardString(value: string | number | T): string {
+    if (typeof value == "string") {
+      return value;
     }
+    return value.toFixed(this.maxToFixedDecimals());
+  }
 }
 
-BigNumber.config({ DECIMAL_PLACES: 18, ROUNDING_MODE: BigNumber.ROUND_DOWN })
-_Web3Number.config({ DECIMAL_PLACES: 18, ROUNDING_MODE: BigNumber.ROUND_DOWN })
+BigNumber.config({ DECIMAL_PLACES: 18, ROUNDING_MODE: BigNumber.ROUND_DOWN });
+_Web3Number.config({ DECIMAL_PLACES: 18, ROUNDING_MODE: BigNumber.ROUND_DOWN });

package/src/global.ts

@@ -1,39 +1,7 @@
 import axios from 'axios';
 import { TokenInfo } from './interfaces';
 import { ContractAddr } from './dataTypes';
-
-const colors = {
-    error: 'red',
-    warn: 'yellow',
-    info: 'blue',
-    verbose: 'white',
-    debug: 'white',
-}
-
-// Add custom colors to Winston
-// winston.addColors(colors);
-
-// export const logger = createLogger({
-//   level: 'verbose', // Set the minimum logging level
-//   format: format.combine(
-//     format.colorize({ all: true }), // Apply custom colors
-//     format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), // Add timestamp to log messages
-//     format.printf(({ timestamp, level, message }) => {
-//       return `${timestamp} ${level}: ${message}`;
-//     })
-//   ),
-//   transports: [
-//     // new transports.Console() // Output logs to the console
-//   ]
-// });
-
-
-export const logger = {
-    ...console,
-    verbose(message: string) {
-        console.log(`[VERBOSE] ${message}`);
-    }
-};
+import { logger } from '@/utils/logger';
 
 
 export class FatalError extends Error {

package/src/interfaces/common.ts

@@ -1,60 +1,65 @@
-import { ContractAddr, Web3Number } from "@/dataTypes"
-import { BlockIdentifier, RpcProvider } from "starknet"
-import React from 'react';
+import { ContractAddr, Web3Number } from "@/dataTypes";
+import { BlockIdentifier, RpcProvider } from "starknet";
+import React from "react";
 
 export enum RiskType {
-    MARKET_RISK = 'Market Risk',
-    // if non-correalted pairs, this is 3 (STRK/USDC)
-    // if highly correalted pairs, this is 1 (e.g. xSTRK/STRK)
-    // if correalted pairs, this is 2 (e.g. BTC/SOL)
-    // If there is added leverage on top, can go till 5
-    IMPERMANENT_LOSS = 'Impermanent Loss Risk',
-    LIQUIDATION_RISK = 'Liquidation Risk',
-    LOW_LIQUIDITY_RISK = 'Low Liquidity Risk',
-    SMART_CONTRACT_RISK = 'Smart Contract Risk',
-    ORACLE_RISK = 'Oracle Risk',
-    TECHNICAL_RISK = 'Technical Risk',
-    COUNTERPARTY_RISK = 'Counterparty Risk', // e.g. bad debt
+  MARKET_RISK = "Market Risk",
+  // if non-correalted pairs, this is 3 (STRK/USDC)
+  // if highly correalted pairs, this is 1 (e.g. xSTRK/STRK)
+  // if correalted pairs, this is 2 (e.g. BTC/SOL)
+  // If there is added leverage on top, can go till 5
+  IMPERMANENT_LOSS = "Impermanent Loss Risk",
+  LIQUIDATION_RISK = "Liquidation Risk",
+  LOW_LIQUIDITY_RISK = "Low Liquidity Risk",
+  SMART_CONTRACT_RISK = "Smart Contract Risk",
+  ORACLE_RISK = "Oracle Risk",
+  TECHNICAL_RISK = "Technical Risk",
+  COUNTERPARTY_RISK = "Counterparty Risk" // e.g. bad debt
 }
 
 export interface RiskFactor {
-    type: RiskType,
-    value: number, // 0 to 5
-    weight: number // 0 to 100
+  type: RiskType;
+  value: number; // 0 to 5
+  weight: number; // 0 to 100
 }
 
 export interface TokenInfo {
-    name: string,
-    symbol: string,
-    address: ContractAddr,
-    decimals: number,
-    logo: string,
-    coingeckId?: string,
-    displayDecimals: number
+  name: string;
+  symbol: string;
+  address: ContractAddr;
+  decimals: number;
+  logo: string;
+  coingeckId?: string;
+  displayDecimals: number;
 }
 
 export enum Network {
-    mainnet = "mainnet",
-    sepolia = "sepolia",
-    devnet = "devnet"
+  mainnet = "mainnet",
+  sepolia = "sepolia",
+  devnet = "devnet"
 }
 
 export interface IConfig {
-    provider: RpcProvider,
-    network: Network,
-    stage: 'production' | 'staging',
-    heartbeatUrl?: string
+  provider: RpcProvider;
+  network: Network;
+  stage: "production" | "staging";
+  heartbeatUrl?: string;
 }
 
 export interface IProtocol {
-    name: string,
-    logo: string,
+  name: string;
+  logo: string;
 }
 
 export enum FlowChartColors {
-    Green = 'purple',
-    Blue = '#35484f',
-    Purple = '#6e53dc',
+  Green = "purple",
+  Blue = "#35484f",
+  Purple = "#6e53dc"
+}
+
+export interface FAQ {
+  question: string | React.ReactNode;
+  answer: string | React.ReactNode;
 }
 
 /**
@@ -62,78 +67,87 @@ export enum FlowChartColors {
  * @property risk.riskFactor.factor - The value of the risk factor from 0 to 10, 0 being the lowest and 10 being the highest.
  */
 export interface IStrategyMetadata<T> {
-    name: string,
-    description: string | React.ReactNode,
-    address: ContractAddr,
-    type: 'ERC4626' | 'ERC721' | 'Other',
-    depositTokens: TokenInfo[],
-    protocols: IProtocol[],
-    auditUrl?: string,
-    maxTVL: Web3Number,
-    risk: {
-        riskFactor: RiskFactor[],
-        netRisk: number,
-        notARisks: string[]
-    },
-    apyMethodology?: string,
-    additionalInfo: T
+  name: string;
+  description: string | React.ReactNode;
+  address: ContractAddr;
+  launchBlock: number;
+  type: "ERC4626" | "ERC721" | "Other";
+  depositTokens: TokenInfo[];
+  protocols: IProtocol[];
+  auditUrl?: string;
+  maxTVL: Web3Number;
+  risk: {
+    riskFactor: RiskFactor[];
+    netRisk: number;
+    notARisks: string[];
+  };
+  apyMethodology?: string;
+  additionalInfo: T;
+  faqs: FAQ[];
 }
 
 export interface IInvestmentFlow {
-    id?: string, // used to link flows
-    title: string,
-    subItems: {key: string, value: string}[],
-    linkedFlows: IInvestmentFlow[],
-    style?: any
+  id?: string; // used to link flows
+  title: string;
+  subItems: { key: string; value: string }[];
+  linkedFlows: IInvestmentFlow[];
+  style?: any;
 }
 
-export function getMainnetConfig(rpcUrl = "https://starknet-mainnet.public.blastapi.io", blockIdentifier: BlockIdentifier = 'pending'): IConfig {
-    return {
-        provider: new RpcProvider({
-            nodeUrl: rpcUrl,
-            blockIdentifier: blockIdentifier
-        }),
-        stage: "production",
-        network: Network.mainnet
-    }
+export function getMainnetConfig(
+  rpcUrl = "https://starknet-mainnet.public.blastapi.io",
+  blockIdentifier: BlockIdentifier = "pending"
+): IConfig {
+  return {
+    provider: new RpcProvider({
+      nodeUrl: rpcUrl,
+      blockIdentifier: blockIdentifier
+    }),
+    stage: "production",
+    network: Network.mainnet
+  };
 }
 
 export const getRiskExplaination = (riskType: RiskType) => {
-    switch (riskType) {
-        case RiskType.MARKET_RISK:
-            return "The risk of the market moving against the position."
-        case RiskType.IMPERMANENT_LOSS:
-            return "The temporary loss of value experienced by liquidity providers in AMMs when asset prices diverge compared to simply holding them."
-        case RiskType.LIQUIDATION_RISK:
-            return "The risk of losing funds due to the position being liquidated."
-        case RiskType.LOW_LIQUIDITY_RISK:
-            return "The risk of low liquidity in the pool, which can lead to high slippages or reduced in-abilities to quickly exit the position."
-        case RiskType.ORACLE_RISK:
-            return "The risk of the oracle being manipulated or incorrect."
-        case RiskType.SMART_CONTRACT_RISK:
-            return "The risk of the smart contract being vulnerable to attacks."
-        case RiskType.TECHNICAL_RISK:
-            return "The risk of technical issues e.g. backend failure."
-        case RiskType.COUNTERPARTY_RISK:
-            return "The risk of the counterparty defaulting e.g. bad debt on lending platforms."
-    }
-}  
+  switch (riskType) {
+    case RiskType.MARKET_RISK:
+      return "The risk of the market moving against the position.";
+    case RiskType.IMPERMANENT_LOSS:
+      return "The temporary loss of value experienced by liquidity providers in AMMs when asset prices diverge compared to simply holding them.";
+    case RiskType.LIQUIDATION_RISK:
+      return "The risk of losing funds due to the position being liquidated.";
+    case RiskType.LOW_LIQUIDITY_RISK:
+      return "The risk of low liquidity in the pool, which can lead to high slippages or reduced in-abilities to quickly exit the position.";
+    case RiskType.ORACLE_RISK:
+      return "The risk of the oracle being manipulated or incorrect.";
+    case RiskType.SMART_CONTRACT_RISK:
+      return "The risk of the smart contract being vulnerable to attacks.";
+    case RiskType.TECHNICAL_RISK:
+      return "The risk of technical issues e.g. backend failure.";
+    case RiskType.COUNTERPARTY_RISK:
+      return "The risk of the counterparty defaulting e.g. bad debt on lending platforms.";
+  }
+};
 
 export const getRiskColor = (risk: RiskFactor) => {
-    const value = risk.value;
-    if (value === 0) return 'green';
-    if (value < 2.5) return 'yellow';
-    return 'red';
-}
+  const value = risk.value;
+  if (value === 0) return "green";
+  if (value < 2.5) return "yellow";
+  return "red";
+};
 
 export const getNoRiskTags = (risks: RiskFactor[]) => {
-    const noRisks1 = risks.filter(risk => risk.value === 0).map(risk => risk.type);
+  const noRisks1 = risks
+    .filter((risk) => risk.value === 0)
+    .map((risk) => risk.type);
+
+  // const risks not present
+  const noRisks2 = Object.values(RiskType).filter(
+    (risk) => !risks.map((risk) => risk.type).includes(risk)
+  );
 
-    // const risks not present
-    const noRisks2 = Object.values(RiskType).filter(risk => !risks.map(risk => risk.type).includes(risk));
+  const mergedUnique = [...new Set([...noRisks1, ...noRisks2])];
 
-    const mergedUnique = [...new Set([...noRisks1, ...noRisks2])];
-    
-    // add `No` to the start of each risk
-    return mergedUnique.map(risk => `No ${risk}`);
-}
+  // add `No` to the start of each risk
+  return mergedUnique.map((risk) => `No ${risk}`);
+};

package/src/interfaces/lending.ts

@@ -1,10 +1,9 @@
 import { IConfig } from "@/interfaces/common";
 import { TokenInfo } from "./common";
 import { ContractAddr } from "@/dataTypes/address";
-import { loggers } from "winston";
-import { logger } from "@/global";
 import { log } from "console";
 import { Web3Number } from "@/dataTypes";
+import { logger } from "@/utils/logger";
 
 export interface ILendingMetadata {
     name: string;

package/src/modules/avnu.ts

@@ -3,7 +3,7 @@ import { uint256 } from "starknet";
 import { Call, Uint256 } from "starknet";
 import { fetchBuildExecuteTransaction, fetchQuotes, Quote } from "@avnu/avnu-sdk";
 import { assert } from "../utils";
-import { logger } from "@/global";
+import { logger } from "@/utils/logger";
 
 export interface Route {
     token_from: string,

package/src/modules/erc20.ts

@@ -20,4 +20,10 @@ export class ERC20 {
         const balance = await contract.call('balanceOf', [address.toString()]);
         return Web3Number.fromWei(balance.toString(), tokenDecimals);
     }
+
+    async allowance(token: string | ContractAddr, owner: string | ContractAddr, spender: string | ContractAddr, tokenDecimals: number) {
+        const contract = this.contract(token);
+        const allowance = await contract.call('allowance', [owner.toString(), spender.toString()]);
+        return Web3Number.fromWei(allowance.toString(), tokenDecimals);
+    }
 }

package/src/modules/harvests.ts

@@ -1,5 +1,5 @@
 import { ContractAddr, Web3Number } from "@/dataTypes";
-import { logger } from "@/global";
+import { logger } from "@/utils/logger";
 import { IConfig } from "@/interfaces";
 import { assert } from "@/utils";
 import { Contract, num } from "starknet";

package/src/modules/pragma.ts

@@ -1,6 +1,6 @@
 import { Contract, RpcProvider } from "starknet";
 import PragmaAbi from '@/data/pragma.abi.json';
-import { logger } from "@/global";
+import { logger } from "@/utils/logger";
 
 export class Pragma {
     contractAddr = '0x023fb3afbff2c0e3399f896dcf7400acf1a161941cfb386e34a123f228c62832';

package/src/modules/pricer-from-api.ts

@@ -1,8 +1,8 @@
-import { logger } from "@/global";
-import { PriceInfo } from "./pricer";
+    import { PriceInfo } from "./pricer";
 import axios from "axios";
 import { IConfig, TokenInfo } from "@/interfaces";
 import { PricerBase } from "./pricerBase";
+import { logger } from "@/utils/logger";
 
 export class PricerFromApi extends PricerBase {
     constructor(config: IConfig, tokens: TokenInfo[]) {
@@ -15,7 +15,7 @@ export class PricerFromApi extends PricerBase {
         } catch (e: any) {
             logger.warn('getPriceFromMyAPI error', JSON.stringify(e.message || e));
         }
-        logger.log('getPrice coinbase', tokenSymbol);
+        logger.info('getPrice coinbase', tokenSymbol);
         let retry = 0;
         const MAX_RETRIES = 5;
         for (retry = 1; retry < MAX_RETRIES + 1; retry++) {

package/src/modules/pricer.ts

@@ -1,9 +1,10 @@
 import axios from "axios";
-import { FatalError, Global, logger } from "@/global";
+import { FatalError, Global } from "@/global";
 import { TokenInfo } from "@/interfaces/common";
 import { IConfig } from "@/interfaces/common";
 import { Web3Number } from "@/dataTypes";
 import { PricerBase } from "./pricerBase";
+import { logger } from "@/utils/logger";
 
 export interface PriceInfo {
     price: number,

package/src/modules/zkLend.ts

@@ -1,12 +1,13 @@
 import axios from "axios";
 import BigNumber from "bignumber.js";
 import { Web3Number } from "@/dataTypes/bignumber.browser";
-import { FatalError, Global, logger } from "@/global";
+import { FatalError, Global } from "@/global";
 import { TokenInfo } from "@/interfaces";
 import { ILending, ILendingPosition, LendingToken, MarginType } from "@/interfaces/lending";
 import { ContractAddr } from "@/dataTypes/address";
 import { IConfig } from "@/interfaces";
 import { Pricer } from "./pricer";
+import { logger } from "@/utils/logger";
 
 export class ZkLend extends ILending implements ILending {
     readonly pricer: Pricer;

package/src/node/pricer-redis.ts

@@ -1,8 +1,9 @@
-import { FatalError, Global, logger } from '@/global';
+import { FatalError, Global } from '@/global';
 import { IConfig, TokenInfo } from '@/interfaces';
 import { PriceInfo, Pricer } from '@/modules/pricer';
 import { createClient } from 'redis';
 import type { RedisClientType } from 'redis'
+import { logger } from "@/utils/logger";
 
 export class PricerRedis extends Pricer {
     private redisClient: RedisClientType | null = null;

package/src/notifs/telegram.ts

@@ -1,5 +1,5 @@
-import { logger } from "@/global";
 import TelegramBot from "node-telegram-bot-api";
+import { logger } from "@/utils/logger";
 
 export class TelegramNotif {
     private subscribers: string[] = [