OPDATA-3845: Decouple proof-of-reserves from dependencies (#4279)

dskloetc · app-token-issuer-data-feeds[bot] · web-flow · commit af6a86f376b2 · 2025-11-20T12:52:29.000Z
* Decouple proof-of-reserves from dependencies

* changeset

---------

Co-authored-by: app-token-issuer-data-feeds[bot] &lt;134377064+app-token-issuer-data-feeds[bot]@users.noreply.github.com&gt;
diff --git a/.changeset/serious-garlics-press.md b/.changeset/serious-garlics-press.md
@@ -0,0 +1,5 @@
+---
+'@chainlink/proof-of-reserves-adapter': patch
+---
+
+Decouple from adapter dependencies
diff --git a/packages/composites/proof-of-reserves/package.json b/packages/composites/proof-of-reserves/package.json
@@ -31,6 +31,13 @@
     "start": "yarn server:dist"
   },
   "dependencies": {
+    "@chainlink/ea-bootstrap": "workspace:*",
+    "@chainlink/reduce-adapter": "workspace:*",
+    "decimal.js": "^10.3.1",
+    "ethers": "^5.4.6",
+    "tslib": "^2.3.1"
+  },
+  "devDependencies": {
     "@chainlink/ada-balance-adapter": "workspace:*",
     "@chainlink/amberdata-adapter": "workspace:*",
     "@chainlink/avalanche-platform-adapter": "workspace:*",
@@ -43,10 +50,10 @@
     "@chainlink/chain-reserve-wallet-adapter": "workspace:*",
     "@chainlink/coinbase-prime-adapter": "workspace:*",
     "@chainlink/cryptoapis-adapter": "workspace:*",
-    "@chainlink/ea-bootstrap": "workspace:*",
     "@chainlink/ea-test-helpers": "workspace:*",
     "@chainlink/eth-balance-adapter": "workspace:*",
     "@chainlink/eth-beacon-adapter": "workspace:*",
+    "@chainlink/external-adapter-framework": "2.8.0",
     "@chainlink/gemini-adapter": "workspace:*",
     "@chainlink/ignition-address-list-adapter": "workspace:*",
     "@chainlink/lotus-adapter": "workspace:*",
@@ -55,7 +62,6 @@
     "@chainlink/polkadot-balance-adapter": "workspace:*",
     "@chainlink/por-address-list-adapter": "workspace:*",
     "@chainlink/por-indexer-adapter": "workspace:*",
-    "@chainlink/reduce-adapter": "workspace:*",
     "@chainlink/renvm-address-set-adapter": "workspace:*",
     "@chainlink/sochain-adapter": "workspace:*",
     "@chainlink/stader-address-list-adapter": "workspace:*",
@@ -65,12 +71,6 @@
     "@chainlink/view-function-multi-chain-adapter": "workspace:*",
     "@chainlink/wbtc-address-set-adapter": "workspace:*",
     "@chainlink/wrapped-adapter": "workspace:*",
-    "decimal.js": "^10.3.1",
-    "ethers": "^5.4.6",
-    "tslib": "^2.3.1"
-  },
-  "devDependencies": {
-    "@chainlink/external-adapter-framework": "2.8.0",
     "@types/jest": "^29.5.14",
     "@types/node": "22.14.1",
     "@types/supertest": "2.0.16",
diff --git a/packages/composites/proof-of-reserves/src/config/index.ts b/packages/composites/proof-of-reserves/src/config/index.ts
@@ -1,13 +1,13 @@
 import { DefaultConfig, Requester, util } from '@chainlink/ea-bootstrap'
 import {
-  adaptersV2 as BalanceAdaptersV2,
-  adaptersV3 as BalanceAdaptersV3,
+  adapterNamesV2 as BalanceAdaptersV2,
+  adapterNamesV3 as BalanceAdaptersV3,
   ETHEREUM_CL_INDEXER,
 } from '../utils/balance'
 import {
   LIST_ADAPTER,
-  adaptersV2 as ProtocolAdaptersV2,
-  adaptersV3 as ProtocolAdaptersV3,
+  adapterNamesV2 as ProtocolAdaptersV2,
+  adapterNamesV3 as ProtocolAdaptersV3,
 } from '../utils/protocol'
 
 export interface Config extends DefaultConfig {
@@ -33,32 +33,32 @@ export const makeOptions = (): Options => {
     protocol: [],
     indexer: [],
   }
-  for (const a of ProtocolAdaptersV2) {
-    const url = util.getURL(a.NAME)
+  for (const a of Object.values(ProtocolAdaptersV2)) {
+    const url = util.getURL(a)
     if (url) {
-      options.protocol.push(a.NAME)
-      options.protocol.push(a.NAME.toLowerCase())
+      options.protocol.push(a)
+      options.protocol.push(a.toLowerCase())
     }
   }
-  for (const a of ProtocolAdaptersV3) {
-    const url = util.getURL(a.name)
+  for (const a of Object.values(ProtocolAdaptersV3)) {
+    const url = util.getURL(a)
     if (url) {
-      options.protocol.push(a.name)
-      options.protocol.push(a.name.toLowerCase())
+      options.protocol.push(a)
+      options.protocol.push(a.toLowerCase())
     }
   }
-  for (const a of BalanceAdaptersV2) {
-    const url = util.getURL(a.NAME)
+  for (const a of Object.values(BalanceAdaptersV2)) {
+    const url = util.getURL(a)
     if (url) {
-      options.indexer.push(a.NAME)
-      options.indexer.push(a.NAME.toLowerCase())
+      options.indexer.push(a)
+      options.indexer.push(a.toLowerCase())
     }
   }
-  for (const a of BalanceAdaptersV3) {
-    const url = util.getURL(a.name)
+  for (const a of Object.values(BalanceAdaptersV3)) {
+    const url = util.getURL(a)
     if (url) {
-      options.indexer.push(a.name)
-      options.indexer.push(a.name.toLowerCase())
+      options.indexer.push(a)
+      options.indexer.push(a.toLowerCase())
     }
   }
   options.protocol.push(LIST_ADAPTER)
diff --git a/packages/composites/proof-of-reserves/src/endpoint/reserves.ts b/packages/composites/proof-of-reserves/src/endpoint/reserves.ts
@@ -4,13 +4,13 @@ import { Config } from '../config'
 import { getValidAddresses } from '../utils/addressValidator'
 import {
   ETHEREUM_CL_INDEXER,
-  adaptersV2 as indexerAdaptersV2,
-  adaptersV3 as indexerAdaptersV3,
+  adapterNamesV2 as indexerAdaptersV2,
+  adapterNamesV3 as indexerAdaptersV3,
   runBalanceAdapter,
 } from '../utils/balance'
 import {
-  adaptersV2 as protocolAdaptersV2,
-  adaptersV3 as protocolAdaptersV3,
+  adapterNamesV2 as protocolAdaptersV2,
+  adapterNamesV3 as protocolAdaptersV3,
   runProtocolAdapter,
 } from '../utils/protocol'
 import { runReduceAdapter } from '../utils/reduce'
@@ -40,10 +40,10 @@ const inputParameters: InputParameters<TInputParameters> = {
     type: 'string',
     description: 'The protocol external adapter to use',
     options: [
-      ...protocolAdaptersV2.map(({ NAME }) => NAME.toLowerCase()),
-      ...protocolAdaptersV2.map(({ NAME }) => NAME.toUpperCase()),
-      ...protocolAdaptersV3.map(({ name }) => name.toLowerCase()),
-      ...protocolAdaptersV3.map(({ name }) => name.toUpperCase()),
+      ...Object.values(protocolAdaptersV2).map((name) => name.toLowerCase()),
+      ...Object.values(protocolAdaptersV2).map((name) => name.toUpperCase()),
+      ...Object.values(protocolAdaptersV3).map((name) => name.toLowerCase()),
+      ...Object.values(protocolAdaptersV3).map((name) => name.toUpperCase()),
       'coinbase_prime_eth',
       'COINBASE_PRIME_ETH',
       'list',
@@ -59,10 +59,10 @@ const inputParameters: InputParameters<TInputParameters> = {
     type: 'string',
     description: 'The indexer external adapter to use',
     options: [
-      ...indexerAdaptersV2.map(({ NAME }) => NAME.toLowerCase()),
-      ...indexerAdaptersV2.map(({ NAME }) => NAME.toUpperCase()),
-      ...indexerAdaptersV3.map(({ name }) => name.toLowerCase()),
-      ...indexerAdaptersV3.map(({ name }) => name.toUpperCase()),
+      ...Object.values(indexerAdaptersV2).map((name) => name.toLowerCase()),
+      ...Object.values(indexerAdaptersV2).map((name) => name.toUpperCase()),
+      ...Object.values(indexerAdaptersV3).map((name) => name.toLowerCase()),
+      ...Object.values(indexerAdaptersV3).map((name) => name.toUpperCase()),
       ETHEREUM_CL_INDEXER,
     ],
   },
diff --git a/packages/composites/proof-of-reserves/src/utils/balance.ts b/packages/composites/proof-of-reserves/src/utils/balance.ts
@@ -1,59 +1,31 @@
-import type {
-  Account,
-  AdapterContext,
-  AdapterResponse,
-  Config,
-  AdapterImplementation as v2AdapterImplementation,
-} from '@chainlink/ea-bootstrap'
-import { Adapter as v3AdapterImplementation } from '@chainlink/external-adapter-framework/adapter'
+import type { Account, AdapterContext, AdapterResponse, Config } from '@chainlink/ea-bootstrap'
 import { callAdapter, makeRequestFactory } from '.'
 
-// balance adapters
-import * as adaBalance from '@chainlink/ada-balance-adapter'
-import * as amberdata from '@chainlink/amberdata-adapter'
-import { adapter as avalanchePlatform } from '@chainlink/avalanche-platform-adapter'
-import * as bitcoinJsonRpc from '@chainlink/bitcoin-json-rpc-adapter'
-import * as blockchainCom from '@chainlink/blockchain.com-adapter'
-import * as blockchair from '@chainlink/blockchair-adapter'
-import * as btcCom from '@chainlink/btc.com-adapter'
-import { adapter as ceffu } from '@chainlink/ceffu-adapter'
-import * as cryptoapis from '@chainlink/cryptoapis-adapter'
-import * as ethBalance from '@chainlink/eth-balance-adapter'
-import { adapter as ethBeacon } from '@chainlink/eth-beacon-adapter'
-import { adapter as lotus } from '@chainlink/lotus-adapter'
-import { adapter as polkadotBalance } from '@chainlink/polkadot-balance-adapter'
-import { adapter as porIndexer } from '@chainlink/por-indexer-adapter'
-import * as sochain from '@chainlink/sochain-adapter'
-import { adapter as staderBalance } from '@chainlink/stader-balance-adapter'
-import { adapter as tokenBalance } from '@chainlink/token-balance-adapter'
-import { adapter as viewFunctionMultiChain } from '@chainlink/view-function-multi-chain-adapter'
-
 export const ETHEREUM_CL_INDEXER = 'ETHEREUM_CL_INDEXER'
 
-// TODO: type
-export const adaptersV2: v2AdapterImplementation[] = [
-  amberdata as unknown as v2AdapterImplementation,
-  bitcoinJsonRpc as unknown as v2AdapterImplementation,
-  blockchainCom as unknown as v2AdapterImplementation,
-  blockchair as unknown as v2AdapterImplementation,
-  btcCom as unknown as v2AdapterImplementation,
-  cryptoapis as unknown as v2AdapterImplementation,
-  sochain as unknown as v2AdapterImplementation,
-  ethBalance as unknown as v2AdapterImplementation,
-  adaBalance as unknown as v2AdapterImplementation,
-]
+export const adapterNamesV2 = {
+  amberdata: 'AMBERDATA',
+  bitcoinJsonRpc: 'BITCOIN_JSON_RPC',
+  blockchainCom: 'BLOCKCHAIN_COM',
+  blockchair: 'BLOCKCHAIR',
+  btcCom: 'BTC_COM',
+  cryptoapis: 'CRYPTOAPIS',
+  sochain: 'SOCHAIN',
+  ethBalance: 'ETH_BALANCE',
+  adaBalance: 'ADA_BALANCE',
+}
 
-export const adaptersV3: v3AdapterImplementation[] = [
-  polkadotBalance,
-  staderBalance,
-  ethBeacon,
-  avalanchePlatform,
-  lotus,
-  porIndexer,
-  tokenBalance,
-  ceffu,
-  viewFunctionMultiChain,
-]
+export const adapterNamesV3 = {
+  polkadotBalance: 'POLKADOT_BALANCE',
+  staderBalance: 'STADER_BALANCE',
+  ethBeacon: 'ETH_BEACON',
+  avalanchePlatform: 'AVALANCHE_PLATFORM',
+  lotus: 'LOTUS',
+  porIndexer: 'POR_INDEXER',
+  tokenBalance: 'TOKEN_BALANCE',
+  ceffu: 'CEFFU',
+  viewFunctionMultiChain: 'VIEW_FUNCTION_MULTI_CHAIN',
+}
 
 // Get balances for address set
 export const runBalanceAdapter = async (
@@ -69,19 +41,19 @@ export const runBalanceAdapter = async (
   const execute = makeRequestFactory(config, indexer, postfix)
   let next
   switch (indexer) {
-    case bitcoinJsonRpc.NAME:
+    case adapterNamesV2.bitcoinJsonRpc:
       next = buildLocalBitcoinNodeRequest(input)
       break
-    case porIndexer.name:
+    case adapterNamesV3.porIndexer:
       next = buildPorIndexerRequest(input, confirmations)
       break
-    case tokenBalance.name:
+    case adapterNamesV3.tokenBalance:
       next = buildTokenBalanceRequest(input, confirmations)
       break
-    case ceffu.name:
+    case adapterNamesV3.ceffu:
       next = buildCeffuRequest(input)
       break
-    case ethBeacon.name:
+    case adapterNamesV3.ethBeacon:
       next = {
         id: input.jobRunID,
         data: {
@@ -94,7 +66,7 @@ export const runBalanceAdapter = async (
         },
       }
       break
-    case staderBalance.name:
+    case adapterNamesV3.staderBalance:
       next = {
         id: input.jobRunID,
         data: {
diff --git a/packages/composites/proof-of-reserves/src/utils/protocol.ts b/packages/composites/proof-of-reserves/src/utils/protocol.ts
@@ -1,49 +1,26 @@
-import {
-  AdapterContext,
-  AdapterResponse,
-  Config,
-  Requester,
-  AdapterImplementation as v2AdapterImplementation,
-} from '@chainlink/ea-bootstrap'
+import { AdapterContext, AdapterResponse, Config, Requester } from '@chainlink/ea-bootstrap'
 import { callAdapter, makeRequestFactory } from '.'
 
-// protocol adapters
-import * as celsiusAddressList from '@chainlink/celsius-address-list-adapter'
-import * as chainReserveWallets from '@chainlink/chain-reserve-wallet-adapter'
-import { adapter as coinbasePrime } from '@chainlink/coinbase-prime-adapter'
-import { Adapter as v3AdapterImplementation } from '@chainlink/external-adapter-framework/adapter'
-import { adapter as gemini } from '@chainlink/gemini-adapter'
-import { adapter as ignitionAddressList } from '@chainlink/ignition-address-list-adapter'
-import { adapter as moonbeamAddressList } from '@chainlink/moonbeam-address-list-adapter'
-import { adapter as multiAddressList } from '@chainlink/multi-address-list-adapter'
-import { adapter as porAddressList } from '@chainlink/por-address-list-adapter'
-import * as renVM from '@chainlink/renvm-address-set-adapter'
-import { adapter as staderList } from '@chainlink/stader-address-list-adapter'
-import * as swellList from '@chainlink/swell-address-list-adapter'
-import { adapter as wBTC } from '@chainlink/wbtc-address-set-adapter'
-import * as wrapped from '@chainlink/wrapped-adapter'
-
 export const LIST_ADAPTER = 'LIST'
 
-// TODO: consistent package exports
-export const adaptersV2: v2AdapterImplementation[] = [
-  renVM as unknown as v2AdapterImplementation,
-  celsiusAddressList as unknown as v2AdapterImplementation,
-  chainReserveWallets as unknown as v2AdapterImplementation,
-  wrapped as unknown as v2AdapterImplementation,
-  swellList as unknown as v2AdapterImplementation,
-]
+export const adapterNamesV2 = {
+  renVM: 'RENVM',
+  celsiusAddressList: 'CELSIUS_ADDRESS_LIST',
+  chainReserveWallets: 'CHAIN_RESERVE_WALLET',
+  wrapped: 'WRAPPED',
+  swellList: 'SWELL_ADDRESS_LIST',
+}
 
-export const adaptersV3: v3AdapterImplementation[] = [
-  moonbeamAddressList,
-  staderList,
-  wBTC,
-  gemini,
-  porAddressList,
-  coinbasePrime,
-  multiAddressList,
-  ignitionAddressList,
-]
+export const adapterNamesV3 = {
+  moonbeamAddressList: 'MOONBEAM_ADDRESS_LIST',
+  staderList: 'STADER_ADDRESS_LIST',
+  wBTC: 'WBTC',
+  gemini: 'GEMINI',
+  porAddressList: 'POR_ADDRESS_LIST',
+  coinbasePrime: 'COINBASE_PRIME',
+  multiAddressList: 'MULTI_ADDRESS_LIST',
+  ignitionAddressList: 'IGNITION_ADDRESS_LIST',
+}
 
 type AddressData = ({ token: string; chainId: string; network: string } | AddressList) & {
   endpoint: string
diff --git a/packages/composites/proof-of-reserves/src/utils/reduce.ts b/packages/composites/proof-of-reserves/src/utils/reduce.ts
diff --git a/packages/composites/proof-of-reserves/test/unit/adapter-names.test.ts b/packages/composites/proof-of-reserves/test/unit/adapter-names.test.ts

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'@chainlink/proof-of-reserves-adapter': patch
 +---
++
 +Decouple from adapter dependencies