feat: add makina adapter

Author: Hugoo

src/adaptors/makina/index.ts

@@ -0,0 +1,98 @@
+/**
+ * Makina Protocol
+ *
+ * DeFiLlama slug: makina
+ * DefiLlama page: https://defillama.com/protocol/makina
+ * App: https://makina.finance/
+ * API Docs: https://api.makina.finance/v1/docs
+ * Protocol docs: https://docs.makina.finance/
+ */
+
+const utils = require('../utils');
+
+import { Pool } from '../../types/Pool';
+import { MakinaStrategiesResponse } from './types';
+
+const PROJECT = 'makina';
+
+// API Docs: https://api.makina.finance/v1/docs
+const API_BASE_URL = 'https://api.makina.finance/v1';
+
+const CHAIN_ID_TO_CHAIN_KEY = {
+  1: 'ethereum',
+  143: 'monad',
+  999: 'hyperevm',
+  8453: 'base',
+  42161: 'arbitrum',
+  43114: 'avalanche',
+  57073: 'ink',
+};
+
+const ENDPOINTS = {
+  GET_STRATEGIES: `${API_BASE_URL}/strategies`,
+};
+
+const apy = async () => {
+  const response = await utils.getData(ENDPOINTS.GET_STRATEGIES);
+  const strategies: MakinaStrategiesResponse['data'] = response.data;
+
+  const apys: Pool[] = [];
+
+  const supportedStrategies = strategies.strategies.filter((s) => {
+    return (
+      CHAIN_ID_TO_CHAIN_KEY[s.accountingToken.chainId] &&
+      CHAIN_ID_TO_CHAIN_KEY[s.hubChainId]
+    );
+  });
+
+  const priceKeys = [
+    ...new Set(
+      supportedStrategies.map(
+        (s) =>
+          `${CHAIN_ID_TO_CHAIN_KEY[s.accountingToken.chainId]}:${
+            s.accountingToken.address
+          }`
+      )
+    ),
+  ];
+  const { pricesByAddress } = await utils.getPrices(priceKeys, null);
+
+  for (const strategy of supportedStrategies) {
+    const { aum, accountingToken, sharePrice } = strategy;
+
+    const price = pricesByAddress[accountingToken.address.toLowerCase()];
+    // `aum` is denominated in the accounting token's base units.
+    const aumBaseUnits = BigInt(aum);
+    const scale = 10n ** BigInt(accountingToken.decimals);
+    const whole = aumBaseUnits / scale;
+    const fraction = aumBaseUnits % scale;
+    const aumInTokens = Number(whole) + Number(fraction) / Number(scale);
+
+    if (price == null) continue;
+    const tvlUsd = aumInTokens * price;
+
+    apys.push({
+      pool: `makina-${strategy.address}-${
+        CHAIN_ID_TO_CHAIN_KEY[strategy.hubChainId]
+      }`,
+      chain: utils.formatChain(CHAIN_ID_TO_CHAIN_KEY[strategy.hubChainId]),
+      project: PROJECT,
+      symbol: strategy.shareToken.symbol,
+      token: strategy.shareToken.address,
+      underlyingTokens: [accountingToken.address],
+      apyBase: strategy.apy7d != null ? strategy.apy7d * 100 : null,
+      pricePerShare: sharePrice, // underlying assets per share (e.g. ERC-4626 convertToAssets / 1 share); NOT a USD price. Omit when not applicable.
+      tvlUsd,
+      url: `https://makina.finance/strategy/${strategy.address}`,
+    });
+  }
+
+  return apys;
+};
+
+module.exports = {
+  protocolId: '6964',
+  timetravel: false,
+  apy: apy,
+  url: 'https://makina.finance/explore',
+};

src/adaptors/makina/types.ts

@@ -0,0 +1,79 @@
+export interface Token {
+  /**
+   * Token contract address
+   * @example "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
+   */
+  address: string;
+  /**
+   * Chain ID
+   * @example 1
+   */
+  chainId: number;
+  /**
+   * Token name
+   * @example "USD Coin"
+   */
+  name: string;
+  /**
+   * Token symbol
+   * @example "USDC"
+   */
+  symbol: string;
+  /**
+   * Token decimals
+   * @example 6
+   */
+  decimals: number;
+}
+
+export type MakinaStrategiesResponse = {
+  data: {
+    strategies: Array<{
+      slug: string | null;
+      address: string;
+      hubChainId: number;
+      name: string;
+      logoURI: string | null;
+
+      /**
+       * 7-day average annualized yield
+       * @example 0.0829
+       */
+      apy7d: number | null;
+
+      /**
+       * 30-day average annualized yield
+       * @example 0.0477
+       */
+      apy30d: number | null;
+
+      shareToken: Token;
+      accountingToken: Token;
+      depositToken: Token;
+
+      /**
+       * Live total value of all assets in the accounting token base units. Equals `lastReportedAum` adjusted for any deposits/redeems indexed after `lastReportedAumBlock`.
+       * @example "15333281570441"
+       */
+      aum: string;
+
+      /**
+       * The most recent on-chain reported AUM (from the latest TotalAumUpdated event), in the accounting token base units.
+       * @example "15333281570441"
+       */
+      lastReportedAum: string;
+
+      /**
+       * Block number at which `lastReportedAum` was reported on-chain.
+       * @example "23000000"
+       */
+      lastReportedAumBlock: string;
+
+      /**
+       * The price per share, expressed in accounting tokens per share (human-readable, de-scaled by the accounting token's decimals).
+       * @example 1.020766
+       */
+      sharePrice: number;
+    }>;
+  };
+};