New ICE Fx EA via NetDania jsApi (#3916)

* DF-21369 new ICE EA via NetDania jsApi

streaming transport based on jsApi
local price cache to deal with partial updates
include jsApi license terms

* DF-21369 abstract XHR instantiation in jsApi

for testing

* DF-21369 NetDania API double

basic tests run both against double and real

* DF-21369 ICE adapter end-to-end tests

Makes use of netdania double (via xhr mocking)

Author: vlfig

.changeset/tough-hornets-fetch.md

@@ -0,0 +1,5 @@
+---
+'@chainlink/ice-adapter': major
+---
+
+First version

.pnp.cjs

@@ -0,0 +1,9 @@
+NetDania License Terms
+
+This project includes modified versions of software originally developed by NetDania Creations ApS. The Intellectual Property Rights related to this software are owned by NetDania and shall not be transferred to any other person or legal entity.
+
+These components are proprietary and may only be used:
+- As part of the Chainlink External Adapter (EA) project;
+- By Chainlink Labs and Chainlink Node Operators in order to retrieve the content provided by NetDania.
+
+For additional usage terms and attributions, please refer to the copyright notice included at the top of each relevant file.

NetDania-License.txt

@@ -0,0 +1,3 @@
+# Chainlink External Adapter for ice
+
+This README will be generated automatically when code is merged to `main`. If you would like to generate a preview of the README, please run `yarn generate:readme ice`.

packages/sources/ice/CHANGELOG.md

@@ -0,0 +1,41 @@
+{
+  "name": "@chainlink/ice-adapter",
+  "version": "0.0.0",
+  "description": "Chainlink ice adapter.",
+  "keywords": [
+    "Chainlink",
+    "LINK",
+    "blockchain",
+    "oracle",
+    "ice"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "url": "https://github.com/smartcontractkit/external-adapters-js",
+    "type": "git"
+  },
+  "license": "MIT",
+  "scripts": {
+    "clean": "rm -rf dist && rm -f tsconfig.tsbuildinfo",
+    "prepack": "yarn build",
+    "build": "tsc -b",
+    "server": "node -e 'require(\"./index.js\").server()'",
+    "server:dist": "node -e 'require(\"./dist/index.js\").server()'",
+    "start": "yarn server:dist"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "22.14.1",
+    "mock-xmlhttprequest": "8.4.1",
+    "typescript": "5.8.3",
+    "xmlhttprequest": "1.8.0"
+  },
+  "dependencies": {
+    "@chainlink/external-adapter-framework": "2.6.0",
+    "tslib": "^2.8.0"
+  }
+}

packages/sources/ice/README.md

@@ -0,0 +1,48 @@
+import { AdapterConfig } from '@chainlink/external-adapter-framework/config'
+
+export const config = new AdapterConfig({
+  USER_GROUP: {
+    description: 'User group for ICE',
+    type: 'string',
+    default: 'chain.link',
+  },
+  NETDANIA_PASSWORD: {
+    description: 'Password for ICE',
+    type: 'string',
+    required: true,
+    sensitive: true,
+  },
+  API_ENDPOINT: {
+    description: 'streaming server endpoint for ICE',
+    type: 'string',
+    required: true,
+  },
+  API_ENDPOINT_FAILOVER_1: {
+    description: 'failover endpoint for ICE',
+    type: 'string',
+    default: '',
+    required: false,
+  },
+  API_ENDPOINT_FAILOVER_2: {
+    description: 'failover endpoint for ICE',
+    type: 'string',
+    default: '',
+    required: false,
+  },
+  API_ENDPOINT_FAILOVER_3: {
+    description: 'failover endpoint for ICE',
+    type: 'string',
+    default: '',
+    required: false,
+  },
+  POLLING_INTERVAL: {
+    description: 'Polling interval for ICE',
+    type: 'number',
+    default: 2000,
+  },
+  CONNECTING_TIMEOUT_MS: {
+    description: 'Connecting timeout in milliseconds for ICE',
+    type: 'number',
+    default: 4000,
+  },
+})

packages/sources/ice/package.json

@@ -0,0 +1 @@
+export { endpoint as price } from './price'

packages/sources/ice/src/config/index.ts

@@ -0,0 +1,28 @@
+import {
+  LwbaEndpoint,
+  lwbaEndpointInputParametersDefinition,
+  LwbaResponseDataFields,
+} from '@chainlink/external-adapter-framework/adapter'
+import { InputParameters } from '@chainlink/external-adapter-framework/validation'
+import { config } from '../config'
+import { transport } from '../transport/price'
+
+export const inputParameters = new InputParameters(lwbaEndpointInputParametersDefinition, [
+  {
+    base: 'EUR',
+    quote: 'USD',
+  },
+])
+
+export type BaseEndpointTypes = {
+  Parameters: typeof inputParameters.definition
+  Response: LwbaResponseDataFields
+  Settings: typeof config.settings
+}
+
+export const endpoint = new LwbaEndpoint({
+  name: 'price',
+  aliases: ['latest-price', 'data-price', 'getReqObjPrice'],
+  transport: transport,
+  inputParameters,
+})

packages/sources/ice/src/endpoint/index.ts

@@ -0,0 +1,13 @@
+import { expose, ServerInstance } from '@chainlink/external-adapter-framework'
+import { Adapter } from '@chainlink/external-adapter-framework/adapter'
+import { config } from './config'
+import { price } from './endpoint'
+
+export const adapter = new Adapter({
+  defaultEndpoint: price.name,
+  name: 'ICE',
+  config,
+  endpoints: [price],
+})
+
+export const server = (): Promise<ServerInstance | undefined> => expose(adapter)