Add EA for Asseto Finance (#4046)

* add ea for asseto finance

* fix vulnerable npm axios package

* remove override file from config

* Apply suggestion from @mmcallister-cll

Co-authored-by: mmcallister-cll <139181225+mmcallister-cll@users.noreply.github.com>

* Apply suggestion from @mmcallister-cll

Co-authored-by: mmcallister-cll <139181225+mmcallister-cll@users.noreply.github.com>

* remove unsued file and update test

* refactor api endpoints in helpers

* add helper tests

* remove axios dependency

* refactor transport and endppint functions

* add more tests for edge cases

* Update .changeset/rich-fishes-travel.md

* refactor tests and comments

* remove changes to contributing.md

* escape ripcord detail strings in snapshot

---------

Co-authored-by: mmcallister-cll <139181225+mmcallister-cll@users.noreply.github.com>
Co-authored-by: Matthew McAllister <matthew.mcallister@smartcontract.com>

Author: cl-mayowa

.changeset/rich-fishes-travel.md

@@ -0,0 +1,5 @@
+---
+'@chainlink/asseto-finance-adapter': major
+---
+
+asseto-finance initial release

.pnp.cjs

@@ -0,0 +1,3 @@
+# Chainlink External Adapter for asseto-finance
+
+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 asseto-finance`.

packages/sources/asseto-finance/CHANGELOG.md

@@ -0,0 +1,40 @@
+{
+  "name": "@chainlink/asseto-finance-adapter",
+  "version": "0.0.0",
+  "description": "Chainlink asseto-finance adapter.",
+  "keywords": [
+    "Chainlink",
+    "LINK",
+    "blockchain",
+    "oracle",
+    "asseto-finance"
+  ],
+  "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",
+    "nock": "13.5.6",
+    "typescript": "5.8.3"
+  },
+  "dependencies": {
+    "@chainlink/external-adapter-framework": "2.7.0",
+    "tslib": "2.4.1"
+  }
+}

packages/sources/asseto-finance/README.md

@@ -0,0 +1,31 @@
+import { AdapterConfig } from '@chainlink/external-adapter-framework/config'
+
+export const config = new AdapterConfig({
+  API_ENDPOINT: {
+    description: 'An API endpoint for Data Provider',
+    type: 'string',
+    default: 'https://open.syncnav.com/api',
+  },
+  CLIENT_ID: {
+    description: 'Data Provider client ID',
+    type: 'string',
+    default: 'chainlink',
+  },
+  CLIENT_SECRET: {
+    description: 'Data Provider client secret',
+    type: 'string',
+    required: true,
+    sensitive: true,
+  },
+  GRANT_TYPE: {
+    description: 'Grant type for credentials',
+    type: 'string',
+    default: 'client_credentials',
+  },
+  BACKGROUND_EXECUTE_MS: {
+    description:
+      'The amount of time the background execute should sleep before performing the next request',
+    type: 'number',
+    default: 10_000,
+  },
+})

packages/sources/asseto-finance/package.json

@@ -0,0 +1,16 @@
+import { InputParameters } from '@chainlink/external-adapter-framework/validation'
+
+export const inputParameters = new InputParameters(
+  {
+    fundId: {
+      required: true,
+      type: 'number',
+      description: 'The fund id of the reserves to query',
+    },
+  },
+  [
+    {
+      fundId: 3,
+    },
+  ],
+)

packages/sources/asseto-finance/src/config/index.ts

@@ -0,0 +1,2 @@
+export { endpoint as nav } from './nav'
+export { endpoint as reserve } from './reserve'

packages/sources/asseto-finance/src/endpoint/common.ts

@@ -0,0 +1,26 @@
+import { AdapterEndpoint } from '@chainlink/external-adapter-framework/adapter'
+import { config } from '../config'
+import { navTransport } from '../transport/nav'
+import { inputParameters } from './common'
+
+export type NavResultResponse = {
+  Result: number
+  Data: {
+    fundId: number
+    fundName: string
+    netAssetValue: number
+    navDate: string
+  }
+}
+
+export type BaseEndpointTypes = {
+  Parameters: typeof inputParameters.definition
+  Response: NavResultResponse
+  Settings: typeof config.settings
+}
+
+export const endpoint = new AdapterEndpoint({
+  name: 'nav',
+  inputParameters,
+  transport: navTransport,
+})

packages/sources/asseto-finance/src/endpoint/index.ts

@@ -0,0 +1,34 @@
+import { AdapterEndpoint } from '@chainlink/external-adapter-framework/adapter'
+import { config } from '../config'
+import { reserveTransport } from '../transport/reserve'
+import { inputParameters } from './common'
+
+export type ReserveResultResponse = {
+  Result: number
+  Data: {
+    fundId: number
+    fundName: string
+    totalAUM: number
+    totalDate: string
+    ripcord: string
+  }
+}
+
+export type ReserveResultErrorResponse = ReserveResultResponse & {
+  Data: {
+    errorMessage: string
+    ripcordDetails?: string
+  }
+}
+
+export type BaseEndpointTypes = {
+  Parameters: typeof inputParameters.definition
+  Response: ReserveResultResponse | ReserveResultErrorResponse
+  Settings: typeof config.settings
+}
+
+export const endpoint = new AdapterEndpoint({
+  name: 'reserve',
+  transport: reserveTransport,
+  inputParameters,
+})