Add Doma Protocol TVL adapter

Doma is a DomainFi protocol enabling fractionalization of web3 domains
on the Doma L2 (Chain ID: 97477).

TVL tracks USDC.e balances in protocol contracts:
- DomaFractionalization (diamond proxy)
- DomaLaunchpad contracts
- Associated Uniswap V3 pools

Addresses discovered dynamically via Blockscout explorer API.

Author: mmarfinetz

projects/doma/index.js

@@ -0,0 +1,163 @@
+const { get } = require('../helper/http')
+const { sumTokens2 } = require('../helper/unwrapLPs')
+
+// VERIFIED ADDRESSES - 2024-11-27 via explorer.doma.xyz
+// USDC.e (Bridged USDC via Stargate) - 6 decimals
+// https://explorer.doma.xyz/token/0x31EEf89D5215C305304a2fA5376a1f1b6C5dc477
+const USDC_E_ADDRESS = '0x31EEf89D5215C305304a2fA5376a1f1b6C5dc477'
+
+// DomaFractionalization Diamond Proxy - verified via explorer.doma.xyz
+// https://explorer.doma.xyz/address/0xd00000000004f450f1438cfA436587d8f8A55A29
+const DOMA_FRACTIONALIZATION = '0xd00000000004f450f1438cfA436587d8f8A55A29'
+
+// Blockscout explorer API (public, no auth required)
+const EXPLORER_API = 'https://explorer.doma.xyz/api/v2'
+
+// NameTokenFractionalized event topic (from explorer logs)
+// Event: NameTokenFractionalized(address indexed tokenAddress, uint256 indexed tokenId,
+//        address tokenOwner, address fractionalTokenAddress, address launchpadAddress,
+//        address vestingWallet, uint256 fractionalizationVersion, tuple params)
+const FRACTIONALIZED_EVENT_TOPIC = '0x033884feaa2ca8a3d4414e2f3b49f102e4eeaf1b0baf49466e0407c4770de3e5'
+
+/**
+ * Fetches all NameTokenFractionalized events from the DomaFractionalization contract
+ * to discover deployed launchpad and vesting wallet addresses
+ */
+async function fetchFractionalizedTokens() {
+  const tokens = []
+  let nextPageParams = null
+
+  do {
+    let url = `${EXPLORER_API}/addresses/${DOMA_FRACTIONALIZATION}/logs`
+    if (nextPageParams) {
+      const params = new URLSearchParams(nextPageParams)
+      url += `?${params.toString()}`
+    }
+
+    const response = await get(url)
+
+    if (!response?.items) {
+      throw new Error(`Invalid explorer response: ${JSON.stringify(response)}`)
+    }
+
+    for (const log of response.items) {
+      // Filter for NameTokenFractionalized events
+      const topics = log.topics || []
+      if (topics[0]?.toLowerCase() !== FRACTIONALIZED_EVENT_TOPIC.toLowerCase()) {
+        continue
+      }
+
+      // Extract addresses from decoded event data
+      const decoded = log.decoded?.parameters
+      if (!decoded) continue
+
+      const fractionalToken = decoded.find(p => p.name === 'fractionalTokenAddress')?.value
+      const launchpad = decoded.find(p => p.name === 'launchpadAddress')?.value
+      const vestingWallet = decoded.find(p => p.name === 'vestingWallet')?.value
+
+      if (fractionalToken && launchpad) {
+        tokens.push({
+          fractionalToken,
+          launchpad,
+          vestingWallet,
+        })
+      }
+    }
+
+    nextPageParams = response.next_page_params
+  } while (nextPageParams)
+
+  return tokens
+}
+
+/**
+ * Fetches UniswapV3 pools that hold USDC.e (for graduated tokens)
+ * These are pools where fractionalized domain tokens trade against USDC.e
+ */
+async function fetchUniswapV3Pools() {
+  const pools = []
+  let nextPageParams = null
+
+  do {
+    let url = `${EXPLORER_API}/tokens/${USDC_E_ADDRESS}/holders`
+    if (nextPageParams) {
+      const params = new URLSearchParams(nextPageParams)
+      url += `?${params.toString()}`
+    }
+
+    const response = await get(url)
+    if (!response?.items) break
+
+    for (const holder of response.items) {
+      const address = holder?.address
+      if (!address?.is_contract || !address?.is_verified) continue
+
+      // Only include UniswapV3Pool contracts
+      if (address.name === 'UniswapV3Pool') {
+        pools.push(address.hash)
+      }
+    }
+
+    nextPageParams = response.next_page_params
+  } while (nextPageParams)
+
+  return pools
+}
+
+async function tvl(api) {
+  // Get all fractionalized tokens (includes launchpads and vesting wallets)
+  const fractionalizedTokens = await fetchFractionalizedTokens()
+
+  // Get UniswapV3 pools holding USDC.e (for graduated tokens)
+  const uniV3Pools = await fetchUniswapV3Pools()
+
+  // Collect all protocol-owned addresses
+  const protocolAddresses = new Set()
+
+  // Add main fractionalization contract
+  protocolAddresses.add(DOMA_FRACTIONALIZATION)
+
+  // Add launchpads and vesting wallets from fractionalization events
+  for (const token of fractionalizedTokens) {
+    if (token.launchpad) protocolAddresses.add(token.launchpad)
+    if (token.vestingWallet) protocolAddresses.add(token.vestingWallet)
+  }
+
+  // Add UniswapV3 pools
+  for (const pool of uniV3Pools) {
+    protocolAddresses.add(pool)
+  }
+
+  const addressList = Array.from(protocolAddresses)
+
+  console.log(`Found ${fractionalizedTokens.length} fractionalized tokens`)
+  console.log(`Found ${uniV3Pools.length} UniswapV3 pools`)
+  console.log(`Total protocol addresses: ${addressList.length}`)
+
+  if (addressList.length === 0) {
+    console.warn('No protocol addresses found - TVL will be empty')
+    return {}
+  }
+
+  // Build token-owner pairs for on-chain balance queries
+  const tokensAndOwners = addressList.map(owner => [USDC_E_ADDRESS, owner])
+
+  return sumTokens2({
+    api,
+    tokensAndOwners,
+    resolveLP: false,
+  })
+}
+
+module.exports = {
+  timetravel: false,
+  misrepresentedTokens: true,
+  methodology:
+    'TVL is calculated by summing USDC.e balances held in Doma protocol contracts. ' +
+    'Protocol addresses are discovered by querying NameTokenFractionalized events from the ' +
+    'DomaFractionalization contract (0xd00000000004f450f1438cfA436587d8f8A55A29) to enumerate ' +
+    'all deployed launchpads and vesting wallets. UniswapV3 pools holding USDC.e liquidity ' +
+    'for graduated fractional tokens are also included. Balances are fetched via on-chain ' +
+    'ERC-20 balanceOf() calls on the Doma network (Chain ID: 97477).',
+  doma: { tvl },
+}

projects/helper/chains.json

@@ -111,6 +111,7 @@
   "dfk",
   "dfs",
   "doge",
+  "doma",
   "dogechain",
   "dsc",
   "duckchain",

projects/helper/tokenMapping.js

@@ -66,6 +66,10 @@ const fixBalancesTokens = {
     YLDS: { coingeckoId: 'usd-coin', decimals: 0 },
     'pm.sale.pool.3dxq3fk9llvhrqqwhodiap': { coingeckoId: 'usd-coin', decimals: 0 },
   },
+  doma: {
+    // USDC.e (Bridged USDC via Stargate) - Verified 2024-11-27 via explorer.doma.xyz/token/0x31EEf89D5215C305304a2fA5376a1f1b6C5dc477
+    '0x31eef89d5215c305304a2fa5376a1f1b6c5dc477': { coingeckoId: 'usd-coin', decimals: 6 },
+  },
 }
 
 ibcChains.forEach(chain => fixBalancesTokens[chain] = { ...ibcMappings, ...(fixBalancesTokens[chain] || {}) })