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,115 @@
+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'
+
+// Blockscout explorer API (public, no auth required)
+const EXPLORER_API = 'https://explorer.doma.xyz/api/v2'
+
+// Protocol contract name patterns to identify TVL-relevant holders
+const PROTOCOL_CONTRACT_PATTERNS = [
+  'UniswapV3Pool',
+  'DomaFractionalization',
+  'DomaLaunchpad',
+]
+
+/**
+ * Fetches all USDC.e token holders from Blockscout explorer
+ * and filters to only verified protocol contracts
+ */
+async function fetchProtocolHolders() {
+  const holders = []
+  let nextPageParams = null
+
+  // Paginate through all holders
+  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) {
+      throw new Error(`Invalid explorer response: ${JSON.stringify(response)}`)
+    }
+
+    // Filter to only verified protocol contracts
+    for (const holder of response.items) {
+      const address = holder?.address
+      if (!address) continue
+
+      // Skip non-contracts (EOAs)
+      if (!address.is_contract) continue
+
+      // Skip unverified contracts for safety
+      if (!address.is_verified) continue
+
+      // Check if contract name matches protocol patterns
+      const contractName = address.name || ''
+      const isProtocolContract = PROTOCOL_CONTRACT_PATTERNS.some(pattern =>
+        contractName.includes(pattern)
+      )
+
+      // Also check implementation names for proxy contracts
+      const implementations = address.implementations || []
+      const isProxyToProtocol = implementations.some(impl =>
+        PROTOCOL_CONTRACT_PATTERNS.some(pattern =>
+          (impl.name || '').includes(pattern)
+        )
+      )
+
+      if (isProtocolContract || isProxyToProtocol) {
+        holders.push({
+          address: address.hash,
+          name: contractName,
+          balance: holder.value,
+        })
+      }
+    }
+
+    nextPageParams = response.next_page_params
+  } while (nextPageParams)
+
+  return holders
+}
+
+async function tvl(api) {
+  const protocolHolders = await fetchProtocolHolders()
+
+  if (protocolHolders.length === 0) {
+    console.warn('No protocol contracts found holding USDC.e - TVL will be empty')
+    return {}
+  }
+
+  console.log(`Found ${protocolHolders.length} protocol contracts:`)
+  protocolHolders.forEach(h => console.log(`  - ${h.name || 'Unknown'}: ${h.address}`))
+
+  // Build token-owner pairs for on-chain balance queries
+  const tokensAndOwners = protocolHolders.map(holder => [
+    USDC_E_ADDRESS,
+    holder.address,
+  ])
+
+  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 ' +
+    '(DomaFractionalization, DomaLaunchpad, and associated Uniswap V3 pools). ' +
+    'Protocol contracts are discovered via the Doma Blockscout explorer API by filtering ' +
+    'verified contracts from USDC.e token holders. 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] || {}) })