@chainlink/external-adapter-framework 0.30.2 → 0.30.3

package/adapter/price.js

@@ -75,7 +75,8 @@ class PriceAdapter extends index_1.Adapter {
         const response = await super.handleRequest(req, replySent);
         if (this.includesMap && req.requestContext.priceMeta?.inverse) {
             // We need to search in the reverse order (quote -> base) because the request transform will have inverted the pair
-            const cloneResponse = { ...response };
+            // Deep clone the response, as it may contain objects which won't be cloned by simply destructuring
+            const cloneResponse = JSON.parse(JSON.stringify(response));
             const inverseResult = 1 / cloneResponse.result;
             cloneResponse.result = inverseResult;
             // Check if response data has a result within it

package/adapter/price.js.map

@@ -1 +1 @@
-{"version":3,"file":"price.js","sourceRoot":"","sources":["../../../src/adapter/price.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../../src/adapter/price.ts"],"names":[],"mappings":"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"}

package/adapter-generator.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var path_1 = require("path");
+var child_process_1 = require("child_process");
+var pathArg = process.argv[2] || '';
+var generatorPath = (0, path_1.resolve)(__dirname, './generator-adapter');
+var generatorCommand = "yo ".concat(generatorPath, " ").concat(pathArg, " ");
+(0, child_process_1.execSync)(generatorCommand, { stdio: 'inherit' });

package/generator-adapter/generators/app/index.js

@@ -0,0 +1,337 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Generator = require("yeoman-generator");
+module.exports = class extends Generator {
+    constructor(args, opts) {
+        super(args, opts);
+        this.endpointsAndAliases = new Set();
+        // When EXTERNAL_ADAPTER_GENERATOR_NO_INTERACTIVE is set to true, the generator will not prompt the user and will use the
+        // default values to create one endpoint with all transports. This is useful for testing the generator in CI, or in cases
+        // where the user wants to quickly generate the boilerplate code.
+        this.promptDisabled = process.env.EXTERNAL_ADAPTER_GENERATOR_NO_INTERACTIVE === 'true';
+        // When EXTERNAL_ADAPTER_GENERATOR_STANDALONE is set to true, tsconfig files (tsconfig.json and tsconfig.test.json) will not
+        // extend tsconfig.base.json which is present in external-adapters-js monorepo, but rather generator will create new tsconfig.base.json
+        // with the same content in the same directory and extend from it. Also, new packages and config files (jest, babel) will be added
+        // to be able to run the tests
+        this.standalone = process.env.EXTERNAL_ADAPTER_GENERATOR_STANDALONE === 'true';
+        this.argument('rootPath', {
+            type: String,
+            required: false,
+            default: './',
+            description: 'Root path where new External Adapter will be created',
+        });
+    }
+    // prompting stage is used to get input from the user, validate and store it to use it for next stages
+    async prompting() {
+        const adapterName = await this._promptAdapterName();
+        const endpointCount = await this._promptEndpointCount();
+        const endpoints = {};
+        for (let i = 0; i < endpointCount; i++) {
+            let inputEndpointName = await this._promptEndpointName(i);
+            this.endpointsAndAliases.add(inputEndpointName);
+            let endpointAliases = await this._promptAliases(inputEndpointName);
+            endpointAliases.forEach(alias => this.endpointsAndAliases.add(alias));
+            const inputTransports = await this._promptTransports(inputEndpointName);
+            endpoints[i] = {
+                inputEndpointName,
+                normalizedEndpointName: this._normalizeEndpointName(inputEndpointName),
+                inputTransports,
+                normalizedEndpointNameCap: '',
+                endpointAliases,
+            };
+            endpoints[i].normalizedEndpointNameCap = endpoints[i].normalizedEndpointName.charAt(0).toUpperCase() + endpoints[i].normalizedEndpointName.slice(1);
+        }
+        const endpointNames = Object.values(endpoints).map(e => e.normalizedEndpointName).join(', ');
+        const includeComments = await this._promptConfirmation(adapterName, endpointNames);
+        this.props = {
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            frameworkVersion: (await Promise.resolve().then(() => require('../../../package.json'))).version,
+            adapterName,
+            endpoints,
+            endpointNames,
+            defaultEndpoint: endpoints[0],
+            includeComments,
+        };
+    }
+    // writing stage is used to create new folder/files with templates based on user-provided input
+    writing() {
+        // Copy base files
+        const baseFiles = [
+            'CHANGELOG.md',
+            'package.json',
+            'README.md',
+            'test-payload.json',
+            'tsconfig.json',
+            'tsconfig.test.json',
+        ];
+        // If the generator is in standalone mode, also create tsconfig.base.json in the same directory
+        // so that both tsconfig and tsconfig.test can extend it. If the generator is not in standalone mode,
+        // tsconfig files will extend base settings from external-adapter-js monorepo base tsconfig.
+        // Same way jest and babel config files are also created to be able to run the integration tests
+        if (this.standalone) {
+            baseFiles.push('tsconfig.base.json', 'babel.config.js', 'jest.config.js');
+        }
+        baseFiles.forEach(fileName => {
+            this.fs.copyTpl(this.templatePath(fileName), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/${fileName}`), { ...this.props, standalone: this.standalone });
+        });
+        // copy main index.ts file
+        this.fs.copyTpl(this.templatePath(`src/index.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/index.ts`), this.props);
+        // Copy config
+        this.fs.copy(this.templatePath('src/config/index.ts'), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/config/index.ts`));
+        this.fs.copyTpl(this.templatePath('src/config/overrides.json'), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/config/overrides.json`), this.props);
+        // Create endpoint and transport files
+        Object.values(this.props.endpoints).forEach(({ inputEndpointName, inputTransports, endpointAliases }) => {
+            if (inputTransports.length > 1) {
+                // Router endpoints
+                this.fs.copyTpl(this.templatePath('src/endpoint/endpoint-router.ts.ejs'), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/endpoint/${inputEndpointName}.ts`), {
+                    inputEndpointName,
+                    inputTransports,
+                    endpointAliases,
+                    adapterName: this.props.adapterName,
+                    includeComments: this.props.includeComments,
+                });
+                inputTransports.forEach(transport => {
+                    this.fs.copyTpl(this.templatePath(`src/transport/${transport.type}.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/transport/${inputEndpointName}-${transport.type}.ts`), { inputEndpointName, includeComments: this.props.includeComments });
+                });
+            }
+            else {
+                // Single transport endpoints
+                this.fs.copyTpl(this.templatePath('src/endpoint/endpoint.ts.ejs'), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/endpoint/${inputEndpointName}.ts`), {
+                    inputEndpointName,
+                    inputTransports,
+                    endpointAliases,
+                    adapterName: this.props.adapterName,
+                    includeComments: this.props.includeComments,
+                });
+                this.fs.copyTpl(this.templatePath(`src/transport/${inputTransports[0].type}.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/transport/${inputEndpointName}.ts`), { inputEndpointName, includeComments: this.props.includeComments });
+            }
+        });
+        // Create endpoint barrel file
+        this.fs.copyTpl(this.templatePath(`src/endpoint/index.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/src/endpoint/index.ts`), { endpoints: Object.values(this.props.endpoints) });
+        // Create test files
+        const httpEndpoints = Object.values(this.props.endpoints).filter((e) => e.inputTransports.some(t => t.type === 'http'));
+        const wsEndpoints = Object.values(this.props.endpoints).filter((e) => e.inputTransports.some(t => t.type === 'ws'));
+        const customEndpoints = Object.values(this.props.endpoints).filter((e) => e.inputTransports.some(t => t.type === 'custom'));
+        // Create adapter.test.ts if there is at least one endpoint with httpTransport
+        if (httpEndpoints.length) {
+            this.fs.copyTpl(this.templatePath(`test/adapter.test.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/test/integration/adapter.test.ts`), { endpoints: httpEndpoints, transportName: 'rest' });
+        }
+        // Create adapter.test.ts or adapter-ws.test.ts if there is at least one endpoint with wsTransport
+        if (wsEndpoints.length) {
+            let fileName = 'adapter.test.ts';
+            if (httpEndpoints.length || customEndpoints.length) {
+                fileName = 'adapter-ws.test.ts';
+            }
+            this.fs.copyTpl(this.templatePath(`test/adapter-ws.test.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/test/integration/${fileName}`), { endpoints: wsEndpoints });
+        }
+        // Create adapter.test.ts or adapter-custom.test.ts if there is at least one endpoint with customTransport.
+        // Custom transport integration tests use the same template as http, but in separate file. This is not ideal
+        // since the setup is the same (usually) and we could have just another test describe block, but at least this is
+        // consistent behavior as each transport-specific test is in its own file.
+        if (customEndpoints.length) {
+            let fileName = 'adapter.test.ts';
+            if (httpEndpoints.length || wsEndpoints.length) {
+                fileName = 'adapter-custom.test.ts';
+            }
+            this.fs.copyTpl(this.templatePath(`test/adapter.test.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/test/integration/${fileName}`), { endpoints: customEndpoints, transportName: 'custom' });
+        }
+        // Copy test fixtures
+        this.fs.copyTpl(this.templatePath(`test/fixtures.ts.ejs`), this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/test/integration/fixtures.ts`), {
+            includeWsFixtures: wsEndpoints.length > 0,
+            includeHttpFixtures: httpEndpoints.length > 0 || customEndpoints.length > 0,
+        });
+        // Add dependencies to existing package.json
+        const pkgJson = {
+            devDependencies: {
+                '@types/jest': '27.5.2',
+                '@types/node': '16.11.51',
+                nock: '13.2.9',
+                typescript: '5.0.4',
+            },
+            dependencies: {
+                '@chainlink/external-adapter-framework': this.props.frameworkVersion,
+                tslib: '2.4.1',
+            },
+            scripts: {}
+        };
+        // If EA has websocket transports add additional packages for tests.
+        if (wsEndpoints.length) {
+            pkgJson.devDependencies['@sinonjs/fake-timers'] = '9.1.2';
+            pkgJson.devDependencies['@types/sinonjs__fake-timers'] = '8.1.2';
+        }
+        // If the generator is in standalone mode, add additional packages and a script for running the tests with jest
+        if (this.standalone) {
+            pkgJson.devDependencies['@babel/core'] = '7.21.8';
+            pkgJson.devDependencies['@babel/preset-env'] = '7.20.2';
+            pkgJson.devDependencies['@babel/preset-typescript'] = "7.21.5";
+            pkgJson.devDependencies['jest'] = '29.5.0';
+            pkgJson.scripts['test'] = 'EA_PORT=0 METRICS_ENABLED=false jest --updateSnapshot';
+        }
+        this.fs.extendJSON(this.destinationPath(`${this.options.rootPath}/${this.props.adapterName}/package.json`), pkgJson);
+    }
+    // install stage is used to run npm or yarn install scripts
+    install() {
+        this.yarnInstall([], { cwd: `${this.options.rootPath}/${this.props.adapterName}` });
+    }
+    // end is the last stage. can be used for messages or cleanup
+    end() {
+        this.log(`🚀 Adapter '${this.props.adapterName}' was successfully created. 📍${this.options.rootPath}/${this.props.adapterName}`);
+    }
+    async _promptAdapterName() {
+        if (this.promptDisabled) {
+            return 'example-adapter';
+        }
+        let { adapterName } = await this.prompt({
+            type: 'input',
+            name: 'adapterName',
+            message: 'What is the name of adapter?:',
+            default: 'example-adapter',
+        });
+        adapterName = this._normalizeStringInput(adapterName);
+        if (adapterName === '') {
+            this.log('Adapter name cannot be empty');
+            return this._promptAdapterName();
+        }
+        return adapterName;
+    }
+    async _promptEndpointCount() {
+        if (this.promptDisabled) {
+            return 1;
+        }
+        let { endpointCount } = await this.prompt({
+            type: 'input',
+            name: 'endpointCount',
+            message: 'How many endpoints does adapter have?:',
+            default: '1',
+        });
+        endpointCount = parseInt(endpointCount);
+        if (isNaN(endpointCount) || endpointCount <= 0) {
+            this.log('Adapter should have at least one endpoint');
+            return this._promptEndpointCount();
+        }
+        return endpointCount;
+    }
+    async _promptEndpointName(index) {
+        if (this.promptDisabled) {
+            return 'price';
+        }
+        const { inputEndpointName } = await this.prompt({
+            type: 'input',
+            name: 'inputEndpointName',
+            message: `What is the name of endpoint #${index + 1}:`,
+            default: 'price',
+        });
+        const endpointName = this._normalizeStringInput(inputEndpointName);
+        if (endpointName === '') {
+            this.log('Endpoint name cannot be empty');
+            return this._promptEndpointName(index);
+        }
+        if (this.endpointsAndAliases.has(endpointName)) {
+            this.log(`Endpoint named or aliased '${endpointName}' already exists`);
+            return this._promptEndpointName(index);
+        }
+        return endpointName;
+    }
+    async _promptAliases(inputEndpointName) {
+        if (this.promptDisabled) {
+            return [];
+        }
+        const { endpointAliasesAnswer } = await this.prompt({
+            type: 'input',
+            name: 'endpointAliasesAnswer',
+            message: `Comma separated aliases for endpoint '${inputEndpointName}':`,
+            default: 'empty',
+        });
+        let endpointAliases;
+        if (endpointAliasesAnswer === 'empty' || endpointAliasesAnswer.trim().length === 0) {
+            return [];
+        }
+        else {
+            endpointAliases = [...new Set(...[endpointAliasesAnswer.split(',').map(a => this._normalizeStringInput(a.trim()))])];
+        }
+        let existingEndpoint = endpointAliases.some(a => this.endpointsAndAliases.has(a));
+        if (existingEndpoint) {
+            this.log(`One of endpoints already contains one or more provided aliases.`);
+            return this._promptAliases(inputEndpointName);
+        }
+        return endpointAliases;
+    }
+    async _promptTransports(inputEndpointName) {
+        if (this.promptDisabled) {
+            return [
+                { type: 'http', name: 'httpTransport' }, { type: 'ws', name: 'wsTransport' }, { type: 'custom', name: 'customTransport', }
+            ];
+        }
+        const { inputTransports } = await this.prompt({
+            type: 'checkbox',
+            name: 'inputTransports',
+            message: `Select transports that endpoint '${inputEndpointName}' supports:`,
+            choices: [
+                {
+                    name: 'Http',
+                    value: {
+                        type: 'http',
+                        name: 'httpTransport',
+                    },
+                    checked: true,
+                },
+                {
+                    name: 'Websocket',
+                    value: {
+                        type: 'ws',
+                        name: 'wsTransport',
+                    },
+                },
+                {
+                    name: 'Custom',
+                    value: {
+                        type: 'custom',
+                        name: 'customTransport',
+                    },
+                },
+            ],
+        });
+        if (!inputTransports.length) {
+            this.log('Endpoint should have at least one transport');
+            return this._promptTransports(inputEndpointName);
+        }
+        return inputTransports;
+    }
+    async _promptConfirmation(adapterName, endpointNames) {
+        if (this.promptDisabled) {
+            return true;
+        }
+        const { useComments } = await this.prompt({
+            type: 'confirm',
+            name: 'useComments',
+            default: true,
+            message: `Do you want helpful explicative comments to be included along with the source code? (These are usually not included with adapters but can be helpful if you're new to EA development):`,
+        });
+        const { confirmed } = await this.prompt({
+            type: 'confirm',
+            name: 'confirmed',
+            message: `New adapter '${adapterName}' will be created with following endpoints '${endpointNames}'`,
+        });
+        if (!confirmed) {
+            process.exit(0);
+        }
+        return useComments;
+    }
+    //convert endpoint name to normalized name that can be used in imports/exports, i.e. crypto-one-two -> cryptoOneTwo
+    _normalizeEndpointName(endpointName) {
+        const words = endpointName.split('-');
+        const capitalizedWords = words.map((word, index) => {
+            if (index === 0) {
+                return word;
+            }
+            else {
+                return word.charAt(0).toUpperCase() + word.slice(1);
+            }
+        });
+        return capitalizedWords.join('');
+    }
+    _normalizeStringInput(input) {
+        return input.trim().replace(/ /g, '-');
+    }
+};

package/generator-adapter/generators/app/templates/README.md

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

package/generator-adapter/generators/app/templates/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [['@babel/preset-env', { targets: { node: 'current' } }], '@babel/preset-typescript'],
+}

package/generator-adapter/generators/app/templates/jest.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  modulePathIgnorePatterns: ['./dist'],
+}

package/generator-adapter/generators/app/templates/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@chainlink/<%= adapterName %>-adapter",
+  "version": "0.0.0",
+  "description": "Chainlink <%= adapterName %> adapter.",
+  "keywords": [
+    "Chainlink",
+    "LINK",
+    "blockchain",
+    "oracle",
+    "<%= adapterName %>"
+  ],
+  "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"
+  }
+}

package/generator-adapter/generators/app/templates/src/config/index.ts

@@ -0,0 +1,25 @@
+import { AdapterConfig } from '@chainlink/external-adapter-framework/config'
+
+export const config = new AdapterConfig(
+  {
+    API_KEY: {
+      description:
+        'An API key for Data Provider',
+      type: 'string',
+      required: true,
+      sensitive: true,
+    },
+    API_ENDPOINT: {
+      description:
+        'An API endpoint for Data Provider',
+      type: 'string',
+      default: 'https://dataproviderapi.com',
+    },
+    WS_API_ENDPOINT: {
+      description:
+        'WS endpoint for Data Provider',
+      type: 'string',
+      default: 'ws://localhost:9090',
+    },
+  },
+)

package/generator-adapter/generators/app/templates/src/config/overrides.json

@@ -0,0 +1,3 @@
+{
+  "<%= adapterName %>": {}
+}

package/generator-adapter/generators/app/templates/src/endpoint/base.ts.ejs

@@ -0,0 +1,21 @@
+<% if (includeComments) { %>// Input parameters define the structure of the request expected by the endpoint.<% } %>
+export const inputParameters = new InputParameters({
+  base: {
+    aliases: ['from', 'coin', 'symbol', 'market'],
+    required: true,
+    type: 'string',
+    description: 'The symbol of symbols of the currency to query',
+  },
+  quote: {
+    aliases: ['to', 'convert'],
+    required: true,
+    type: 'string',
+    description: 'The symbol of the currency to convert to',
+  },
+})
+<% if (includeComments) { %>// Endpoints contain a type parameter that allows specifying relevant types of an endpoint, for example, request payload type, Adapter response type and Adapter configuration (environment variables) type<% } %>
+export type BaseEndpointTypes = {
+  Parameters: typeof inputParameters.definition
+  Response: SingleNumberResultResponse
+  Settings: typeof config.settings
+}

package/generator-adapter/generators/app/templates/src/endpoint/endpoint-router.ts.ejs

@@ -0,0 +1,33 @@
+import { AdapterEndpoint } from '@chainlink/external-adapter-framework/adapter'
+import { InputParameters } from '@chainlink/external-adapter-framework/validation'
+import { SingleNumberResultResponse } from '@chainlink/external-adapter-framework/util'
+import { TransportRoutes } from '@chainlink/external-adapter-framework/transports'
+import { config } from '../config'
+import overrides from '../config/overrides.json'
+<% for(let i=0; i<inputTransports.length; i++) {%>
+import { <%= inputTransports[i].name %> } from '../transport/<%= inputEndpointName %>-<%= inputTransports[i].type %>' <% }
+%>
+
+<%- include ./base.ts.ejs %>
+
+export const endpoint = new AdapterEndpoint({
+<% if (includeComments) { -%>
+  // Endpoint name
+<% } -%><%= ' ' %> name: '<%= inputEndpointName %>',
+<% if (includeComments) { -%>
+  // Alternative endpoint names for this endpoint
+<% } -%><%= ' ' %> aliases: <%- endpointAliases.length ? JSON.stringify(endpointAliases) : JSON.stringify([]) -%>,
+<% if (includeComments) { -%>
+  // Transport handles incoming requests, data processing and communication for this endpoint.
+  // In case endpoint supports multiple transports (i.e. http and websocket) TransportRoutes is used to register all supported transports.
+  // To use specific transport, provide `transport: [transportName]` in the request
+<% } -%><%= ' ' %> transportRoutes: new TransportRoutes<BaseEndpointTypes>()
+<% for(let i=0; i<inputTransports.length; i++) {-%>
+  .register('<%- inputTransports[i].type === "http" ? `rest` : inputTransports[i].type %>', <%- inputTransports[i].name %>)<%}%>,
+<% if (includeComments) { -%>
+  // Supported input parameters for this endpoint
+<% } -%><%= ' ' %> inputParameters,
+<% if (includeComments) { -%>
+  // Overrides are defined in the `/config/overrides.json` file. They allow input parameters to be overriden from a generic symbol to something more specific for the data provider such as an ID.
+<% } -%><%= ' ' %> overrides: overrides['<%= adapterName %>']
+})

package/generator-adapter/generators/app/templates/src/endpoint/endpoint.ts.ejs

@@ -0,0 +1,26 @@
+import { AdapterEndpoint } from '@chainlink/external-adapter-framework/adapter'
+import { InputParameters } from '@chainlink/external-adapter-framework/validation'
+import { SingleNumberResultResponse } from '@chainlink/external-adapter-framework/util'
+import { config } from '../config'
+import overrides from '../config/overrides.json'
+import { <%= inputTransports[0].name %> } from '../transport/<%= inputEndpointName %>'
+
+<%- include ./base.ts.ejs %>
+
+export const endpoint = new AdapterEndpoint({
+<% if (includeComments) { -%>
+  // Endpoint name
+<% } -%><%= ' ' %> name: '<%= inputEndpointName %>',
+<% if (includeComments) { -%>
+  // Alternative endpoint names for this endpoint
+<% } -%><%= ' ' %> aliases: <%- endpointAliases.length ? JSON.stringify(endpointAliases) : JSON.stringify([]) -%>,
+<% if (includeComments) { -%>
+  // Transport handles incoming requests, data processing and communication for this endpoint
+<% } -%><%= ' ' %> transport: <%= inputTransports[0].name %>,
+<% if (includeComments) { -%>
+  // Supported input parameters for this endpoint
+<% } -%><%= ' ' %> inputParameters,
+<% if (includeComments) { -%>
+  // Overrides are defined in the `/config/overrides.json` file. They allow input parameters to be overriden from a generic symbol to something more specific for the data provider such as an ID.
+<% } -%><%= ' ' %> overrides: overrides['<%= adapterName %>']
+})

package/generator-adapter/generators/app/templates/src/endpoint/index.ts.ejs

@@ -0,0 +1 @@
+<% for(let i=0; i<endpoints.length; i++) {%>export { endpoint as <%- endpoints[i].normalizedEndpointName %> } from './<%= endpoints[i].inputEndpointName %>' <%- '\n' %><%}%>

package/generator-adapter/generators/app/templates/src/index.ts.ejs

@@ -0,0 +1,21 @@
+import { expose, ServerInstance } from '@chainlink/external-adapter-framework'
+import { Adapter } from '@chainlink/external-adapter-framework/adapter'
+import { config } from './config'
+import { <%= endpointNames %> } from './endpoint'
+
+export const adapter = new Adapter({
+<% if (includeComments) { -%>
+  //Requests will direct to this endpoint if the `endpoint` input parameter is not specified.
+<% } -%><%= ' ' %> defaultEndpoint: <%= defaultEndpoint.normalizedEndpointName %>.name,
+<% if (includeComments) { -%>
+  // Adapter name
+<% } -%><%= ' ' %> name: '<%= adapterName.toUpperCase() %>',
+<% if (includeComments) { -%>
+  // Adapter configuration (environment variables)
+<% } -%><%= ' ' %> config,
+<% if (includeComments) { -%>
+  // List of supported endpoints
+<% } -%><%= ' ' %> endpoints: [<%= endpointNames %>],
+})
+
+export const server = (): Promise<ServerInstance | undefined> => expose(adapter)

package/generator-adapter/generators/app/templates/src/transport/custom.ts.ejs

@@ -0,0 +1,87 @@
+import { Transport, TransportDependencies } from '@chainlink/external-adapter-framework/transports'
+import { ResponseCache } from '@chainlink/external-adapter-framework/cache/response'
+import { Requester } from '@chainlink/external-adapter-framework/util/requester'
+import {
+  AdapterRequest,
+  AdapterResponse,
+} from '@chainlink/external-adapter-framework/util'
+import { TypeFromDefinition } from '@chainlink/external-adapter-framework/validation/input-params'
+import { BaseEndpointTypes } from '../endpoint/<%= inputEndpointName %>'
+
+<% if (includeComments) { -%>
+// CustomTransport extends base types from endpoint and adds additional, Provider-specific types (if needed).
+<% } -%>
+export type CustomTransportTypes = BaseEndpointTypes & {
+  Provider: {
+    RequestBody: never
+    ResponseBody: any
+  }
+}
+<% if (includeComments) { -%>
+// CustomTransport is used to perform custom data fetching and processing from a Provider. The framework provides built-in transports to
+// fetch data from a Provider using several protocols, including `http`, `websocket`, and `sse`. Use CustomTransport when the Provider uses
+// different protocol, or you need custom functionality that built-in transports don't support. For example, custom, multistep authentication
+// for requests, paginated requests, on-chain data retrieval using third party libraries, and so on.
+<% } -%>
+export class CustomTransport<T extends CustomTransportTypes> implements Transport<T> {
+<% if (includeComments) { -%>
+  // name of the transport, used for logging
+<% } -%>
+  name!: string
+<% if (includeComments) { -%>
+  // cache instance for caching responses from provider
+<% } -%>
+  responseCache!: ResponseCache<T>
+<% if (includeComments) { -%>
+  // instance of Requester to be used for data fetching. Use this instance to perform http calls
+<% } -%>
+  requester!: Requester
+
+<% if (includeComments) { -%>
+  // REQUIRED. Transport will be automatically initialized by the framework using this method. It will be called with transport
+  // dependencies, adapter settings, endpoint name, and transport name as arguments. Use this method to initialize transport state
+<% } -%>
+  async initialize(dependencies: TransportDependencies<T>, _adapterSettings: CustomTransportTypes['Settings'], _endpointName: string, transportName: string): Promise<void> {
+    this.responseCache = dependencies.responseCache
+    this.requester = dependencies.requester
+    this.name = transportName
+  }
+<% if (includeComments) { -%>
+  // 'foregroundExecute' performs synchronous fetch/processing of information within the lifecycle of an incoming request. It takes
+  // request object (adapter request, which is wrapper around fastify request) and adapter settings. Use this method to handle the incoming
+  // request, process it,save it in the cache and return to user.
+<% } -%>
+  async foregroundExecute(
+    req: AdapterRequest<TypeFromDefinition<T['Parameters']>>,
+  ): Promise<AdapterResponse<CustomTransportTypes['Response']>> {
+
+    // Custom transport logic
+
+    const response = {
+      data: {
+        result: 100,
+      },
+      statusCode: 200,
+      result: 100,
+      timestamps: {
+        providerDataRequestedUnixMs: Date.now(),
+        providerDataReceivedUnixMs: Date.now(),
+        providerIndicatedTimeUnixMs: undefined,
+      },
+    }
+<% if (includeComments) { -%>
+    // Once the response object is ready, write it to the cache. Use the transport name, request payload and constructed response. Once cache is
+    // saved, return the response to the user.
+<% } -%>
+    await this.responseCache.write(this.name, [
+      {
+        params: req.requestContext.data,
+        response,
+      },
+    ])
+
+    return response
+  }
+}
+
+export const customTransport = new CustomTransport()

package/generator-adapter/generators/app/templates/src/transport/http.ts.ejs

@@ -0,0 +1,98 @@
+import { HttpTransport } from '@chainlink/external-adapter-framework/transports'
+import { BaseEndpointTypes } from '../endpoint/<%= inputEndpointName %>'
+
+export interface ResponseSchema {
+  [key: string]: {
+    price: number
+    errorMessage?: string
+  }
+}
+
+<% if (includeComments) { -%>
+// HttpTransport extends base types from endpoint and adds additional, Provider-specific types like 'RequestBody', which is the type of
+// request body (not the request to adapter, but the request that adapter sends to Data Provider), and 'ResponseBody' which is
+// the type of raw response from Data Provider
+<% } -%>
+export type HttpTransportTypes = BaseEndpointTypes & {
+  Provider: {
+    RequestBody: never
+    ResponseBody: ResponseSchema
+  }
+}
+<% if (includeComments) { -%>
+// HttpTransport is used to fetch and process data from a Provider using HTTP(S) protocol. It usually needs two methods
+// `prepareRequests` and `parseResponse`
+<% } -%>
+export const httpTransport = new HttpTransport<HttpTransportTypes>({
+<% if (includeComments) { -%>
+  // `prepareRequests` method receives request payloads sent to associated endpoint alongside adapter config(environment variables)
+  // and should return 'request information' to the Data Provider. Use this method to construct one or many requests, and the framework
+  // will send them to Data Provider
+<% } -%>
+  prepareRequests: (params, config) => {
+    return params.map((param) => {
+      return {
+<% if (includeComments) { -%>
+        // `params` are parameters associated to this single request and will also be available in the 'parseResponse' method.
+<% } -%>
+        params: [param],
+<% if (includeComments) { -%>
+        // `request` contains any valid axios request configuration
+<% } -%>
+        request: {
+          baseURL: config.API_ENDPOINT,
+          url: '/cryptocurrency/price',
+          headers: {
+            'X_API_KEY': config.API_KEY,
+          },
+          params: {
+            symbol: param.base.toUpperCase(),
+            convert: param.quote.toUpperCase(),
+          },
+        },
+      }
+    })
+  },
+<% if (includeComments) { -%>
+  // `parseResponse` takes the 'params' specified in the `prepareRequests` and the 'response' from Data Provider and should return
+  // an array of response objects to be stored in cache. Use this method to construct a list of response objects for every parameter in 'params'
+  // and the framework will save them in cache and return to user
+<% } -%>
+  parseResponse: (params, response) => {
+<% if (includeComments) { -%>
+    // In case error was received, it's a good practice to return meaningful information to user
+<% } -%>
+    if (!response.data) {
+      return params.map((param) => {
+        return {
+          params: param,
+          response: {
+            errorMessage: `The data provider didn't return any value for ${param.base}/${param.quote}`,
+            statusCode: 502,
+          },
+        }
+      })
+    }
+
+<% if (includeComments) { -%>
+    // For successful responses for each 'param' a new response object is created and returned as an array
+<% } -%>
+    return params.map((param) => {
+      const result = response.data[param.base.toUpperCase()].price
+<% if (includeComments) { -%>
+      // Response objects, whether successful or errors, contain two properties, 'params' and 'response'. 'response' is what will be
+      // stored in the cache and returned as adapter response and 'params' determines the identifier so that the next request with same 'params'
+      // will immediately return the response from the cache
+<% } -%>
+      return {
+        params: param,
+        response: {
+          result,
+          data: {
+            result
+          }
+        },
+      }
+    })
+  },
+})

package/generator-adapter/generators/app/templates/src/transport/ws.ts.ejs

@@ -0,0 +1,94 @@
+import { WebSocketTransport } from '@chainlink/external-adapter-framework/transports'
+import { BaseEndpointTypes } from '../endpoint/<%= inputEndpointName %>'
+
+export interface WSResponse {
+  success: boolean
+  price: number
+  base: string
+  quote: string
+  time: number
+}
+
+<% if (includeComments) { -%>
+// WsTransport extends base types from endpoint and adds additional, Provider-specific types like 'WsMessage', which is the type of
+// websocket received message
+<% } -%>
+export type WsTransportTypes = BaseEndpointTypes & {
+  Provider: {
+    WsMessage: WSResponse
+  }
+}
+<% if (includeComments) { -%>
+// WebSocketTransport is used to fetch and process data from a Provider using Websocket protocol.
+<% } -%>
+export const wsTransport = new WebSocketTransport<WsTransportTypes>({
+<% if (includeComments) { -%>
+  // use `url` method to provide connection url. It accepts adapter context, so you have access to adapter config(environment variables) and
+  // request payload if needed
+<% } -%>
+  url: (context) => context.adapterSettings.WS_API_ENDPOINT,
+<% if (includeComments) { -%>
+  // 'handler' contains two helpful methods. one of them is `message`. This method is called when there is a new websocket message.
+  // The other one is 'open' method. It is called when the websocket connection is successfully opened. Use this method to execute some logic
+  // when the connection is established (custom authentication, logging, ...)
+<% } -%>
+  handlers: {
+<% if (includeComments) { -%>
+    // 'message' handler receives a raw websocket message as first argument and adapter context as second and should return an array of
+    // response objects. Use this method to construct a list of response objects, and the framework will save them in cache and return to user
+<% } -%>
+    message(message) {
+<% if (includeComments) { -%>
+      // in cases when error or unknown message is received, use 'return' to skip the iteration.
+<% } -%>
+      if (message.success === false) {
+        return
+      }
+
+<% if (includeComments) { -%>
+    // Response objects, whether successful or errors (if not skipped), contain two properties, 'params' and 'response'. 'response' is what
+    // will be stored in the cache and returned as adapter response and 'params' determines the identifier so that the next request with
+    // same 'params' will immediately return the response from the cache
+<% } -%>
+      return [
+        {
+          params: { base: message.base, quote: message.quote },
+          response: {
+            result: message.price,
+            data: {
+             result: message.price
+            },
+            timestamps: {
+              providerIndicatedTimeUnixMs: message.time,
+            },
+          },
+        },
+      ]
+    },
+  },
+<% if (includeComments) { -%>
+  // `builders` are builder methods, that will be used to prepare specific WS messages to be sent to Data Provider
+<% } -%>
+  builders: {
+<% if (includeComments) { -%>
+    // `subscribeMessage` accepts request parameters and should construct and return a payload that will be sent to Data Provider
+    // Use this method to subscribe to live feeds
+<% } -%>
+    subscribeMessage: (params) => {
+      return {
+        type: 'subscribe',
+        symbols: `${params.base}/${params.quote}`.toUpperCase()
+      }
+    },
+<% if (includeComments) { -%>
+    // `unsubscribeMessage` accepts request parameters and should construct and return a payload that will be sent to Data Provider
+    // Use this method to unsubscribe from live feeds
+<% } -%>
+    unsubscribeMessage: (params) => {
+      return {
+        type: 'unsubscribe',
+        symbols: `${params.base}/${params.quote}`.toUpperCase()
+      }
+    },
+  },
+})

package/generator-adapter/generators/app/templates/test/adapter-ws.test.ts.ejs

@@ -0,0 +1,58 @@
+import { WebSocketClassProvider } from '@chainlink/external-adapter-framework/transports'
+import {
+  TestAdapter,
+  setEnvVariables,
+  mockWebSocketProvider,
+  MockWebsocketServer,
+} from '@chainlink/external-adapter-framework/util/testing-utils'
+import FakeTimers from '@sinonjs/fake-timers'
+import { mockWebsocketServer } from './fixtures'
+
+
+describe('websocket', () => {
+  let mockWsServer: MockWebsocketServer | undefined
+  let testAdapter: TestAdapter
+  const wsEndpoint = 'ws://localhost:9090'
+  let oldEnv: NodeJS.ProcessEnv
+<% for(let i=0; i<endpoints.length; i++) {%>
+  const data<%- endpoints[i].normalizedEndpointNameCap %> = {
+    base: 'ETH',
+    quote: 'USD',
+    endpoint: '<%- endpoints[i].inputEndpointName %>',
+    transport: 'ws'
+  }
+<% } %>
+  beforeAll(async () => {
+    oldEnv = JSON.parse(JSON.stringify(process.env))
+    process.env['WS_API_ENDPOINT'] = wsEndpoint
+    process.env['API_KEY'] = 'fake-api-key'
+    mockWebSocketProvider(WebSocketClassProvider)
+    mockWsServer = mockWebsocketServer(wsEndpoint)
+
+    const adapter = (await import('./../../src')).adapter
+    testAdapter = await TestAdapter.startWithMockedCache(adapter, {
+      clock: FakeTimers.install(),
+      testAdapter: {} as TestAdapter<never>,
+    })
+
+    // Send initial request to start background execute and wait for cache to be filled with results
+<% for(var i=0; i<endpoints.length; i++) {%>
+    await testAdapter.request(data<%- endpoints[i].normalizedEndpointNameCap %>) <% } %>
+    await testAdapter.waitForCache(<%- endpoints.length %>)
+  })
+
+  afterAll(async () => {
+    setEnvVariables(oldEnv)
+    mockWsServer?.close()
+    testAdapter.clock?.uninstall()
+    await testAdapter.api.close()
+  })
+<% for(var i=0; i<endpoints.length; i++) {%>
+  describe('<%= endpoints[i].inputEndpointName %> endpoint', () => {
+    it('should return success', async () => {
+      const response = await testAdapter.request(data<%- endpoints[i].normalizedEndpointNameCap %>)
+      expect(response.json()).toMatchSnapshot()
+    })
+  })
+<% } %>
+})

package/generator-adapter/generators/app/templates/test/adapter.test.ts.ejs

@@ -0,0 +1,50 @@
+import {
+  TestAdapter,
+  setEnvVariables,
+} from '@chainlink/external-adapter-framework/util/testing-utils'
+import * as nock from 'nock'
+import { mockResponseSuccess } from './fixtures'
+
+describe('execute', () => {
+  let spy: jest.SpyInstance
+  let testAdapter: TestAdapter
+  let oldEnv: NodeJS.ProcessEnv
+
+  beforeAll(async () => {
+    oldEnv = JSON.parse(JSON.stringify(process.env))
+    process.env.API_KEY = process.env.API_KEY ?? 'fake-api-key'
+    const mockDate = new Date('2001-01-01T11:11:11.111Z')
+    spy = jest.spyOn(Date, 'now').mockReturnValue(mockDate.getTime())
+
+    const adapter = (await import('./../../src')).adapter
+    adapter.rateLimiting = undefined
+    testAdapter = await TestAdapter.startWithMockedCache(adapter, {
+      testAdapter: {} as TestAdapter<never>,
+    })
+  })
+
+  afterAll(async () => {
+    setEnvVariables(oldEnv)
+    await testAdapter.api.close()
+    nock.restore()
+    nock.cleanAll()
+    spy.mockRestore()
+  })
+
+  <% for(var i=0; i<endpoints.length; i++) {%>
+  describe('<%= endpoints[i].inputEndpointName %> endpoint', () => {
+    it('should return success', async () => {
+      const data = {
+        base: 'ETH',
+        quote: 'USD',
+        endpoint: '<%= endpoints[i].inputEndpointName %>',
+        transport: '<%= transportName %>'
+      }
+      mockResponseSuccess()
+      const response = await testAdapter.request(data)
+      expect(response.statusCode).toBe(200)
+      expect(response.json()).toMatchSnapshot()
+    })
+  })
+      <% } %>
+})

package/generator-adapter/generators/app/templates/test/fixtures.ts.ejs

@@ -0,0 +1,44 @@
+<% if (includeHttpFixtures) { %>import nock from 'nock'<% } %>
+<% if (includeWsFixtures) { %>import { MockWebsocketServer } from '@chainlink/external-adapter-framework/util/testing-utils'<% } %>
+<% if (includeHttpFixtures) { %>
+export const mockResponseSuccess = (): nock.Scope =>
+    nock('https://dataproviderapi.com', {
+      encodedQueryParams: true,
+    })
+      .get('/cryptocurrency/price')
+      .query({
+        symbol: 'ETH',
+        convert: 'USD',
+      })
+      .reply(200, () => ({ ETH: { price: 10000 } }), [
+        'Content-Type',
+        'application/json',
+        'Connection',
+        'close',
+        'Vary',
+        'Accept-Encoding',
+        'Vary',
+        'Origin',
+      ])
+      .persist()
+<% } %>
+<% if (includeWsFixtures) { %>
+export const mockWebsocketServer = (URL: string): MockWebsocketServer => {
+    const mockWsServer = new MockWebsocketServer(URL, { mock: false })
+    mockWsServer.on('connection', (socket) => {
+      socket.on('message', (message) => {
+          return socket.send(
+            JSON.stringify({
+              success: true,
+              price: 1000,
+              base: 'ETH',
+              quote: 'USD',
+              time: '1999999'
+            }),
+          )
+      })
+    })
+
+    return mockWsServer
+  }
+<% } %>

package/generator-adapter/generators/app/templates/test-payload.json

@@ -0,0 +1,6 @@
+{
+ "requests": [{
+  "from": "BTC",
+  "to": "USD"
+ }]
+}

package/generator-adapter/generators/app/templates/tsconfig.base.json

@@ -0,0 +1,40 @@
+{
+  "compilerOptions": {
+    /* Basic Options */
+    "incremental": true /* Enable incremental compilation */,
+    "target": "ES2020" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */,
+    "module": "commonjs" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */,
+    "composite": true /* Enable project compilation */,
+    "declaration": true /* Generates corresponding '.d.ts' file. */,
+    "declarationMap": true /* Generates a sourcemap for each corresponding '.d.ts' file. */,
+    "noEmit": false /* Do not emit outputs. */,
+    "noErrorTruncation": true /* Do not truncate error messages */,
+    "skipLibCheck": true /* Skip type checking of declaration files. Requires TypeScript version 2.0 or later. */,
+    "importHelpers": true /* Import emit helpers from 'tslib'. */,
+
+    /* Strict Type-Checking Options */
+    "strict": true /* Enable all strict type-checking options. */,
+
+    /* Additional Checks */
+    "noUnusedLocals": true /* Report errors on unused locals. */,
+    "noUnusedParameters": true /* Report errors on unused parameters. */,
+    "noImplicitReturns": true /* Report error when not all code paths in function return a value. */,
+    "noFallthroughCasesInSwitch": true /* Report errors for fallthrough cases in switch statement. */,
+    "forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */,
+
+    /* Module Resolution Options */
+    "moduleResolution": "node" /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */,
+    "allowSyntheticDefaultImports": true /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */,
+    "esModuleInterop": true /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */,
+
+    /* Source Map Options */
+    "inlineSourceMap": true /* Emit a single file with source maps instead of having a separate file. */,
+    "inlineSources": true /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */,
+
+    /* Experimental Options */
+    "experimentalDecorators": true /* Enables experimental support for ES7 decorators. */,
+    "emitDecoratorMetadata": true /* Enables experimental support for emitting type metadata for decorators. */,
+
+    "resolveJsonModule": true /* Allows importing modules with a ‘.json’ extension */
+  }
+}

package/generator-adapter/generators/app/templates/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "<%- standalone ? "./tsconfig.base.json" : "../../tsconfig.base.json" %>",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*", "src/**/*.json"],
+  "exclude": ["dist", "**/*.spec.ts", "**/*.test.ts"]
+}

package/generator-adapter/generators/app/templates/tsconfig.test.json

@@ -0,0 +1,7 @@
+{
+  "extends": "<%- standalone ? "./tsconfig.base.json" : "../../tsconfig.base.json" %>",
+  "include": ["src/**/*", "**/test", "src/**/*.json"],
+  "compilerOptions": {
+    "noEmit": true
+  }
+}

package/generator-adapter/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "generator-adapter",
+  "version": "0.0.1",
+  "files": [
+    "generators"
+  ],
+  "main": "generators/app/index.js",
+  "keywords": [
+    "yeoman-generator",
+    "extnerl-adapter-generator"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainlink/external-adapter-framework",
-  "version": "0.30.2",
+  "version": "0.30.3",
   "main": "dist/index.js",
   "license": "MIT",
   "dependencies": {
@@ -14,10 +14,12 @@
     "prom-client": "13.2.0",
     "ws": "8.9.0",
     "redlock": "5.0.0-beta.2",
-    "mock-socket": "9.1.5"
+    "mock-socket": "9.1.5",
+    "yeoman-generator": "3.1.1"
   },
   "scripts": {
-    "build": "mkdir -p ./dist/src && cp package.json dist/src && cp README.md dist/src && tsc",
+    "build": "mkdir -p ./dist/src && cp package.json dist/src && cp README.md dist/src && tsc && yarn build-generator",
+    "build-generator": "mkdir -p ./dist/src/generator-adapter/generators/app/templates && cp -R scripts/generator-adapter/generators/app/templates dist/src/generator-adapter/generators/app && cp scripts/generator-adapter/package.json dist/src/generator-adapter && tsc --project scripts/generator-adapter/tsconfig.json && tsc scripts/adapter-generator.ts --outDir dist/src",
     "generate-docs": "typedoc src/**/*.ts",
     "generate-ref-tables": "ts-node scripts/metrics-table.ts > docs/reference-tables/metrics.md && ts-node scripts/ea-settings-table.ts > docs/reference-tables/ea-settings.md && yarn prettier --write docs/reference-tables",
     "lint-fix": "eslint --max-warnings=0 --fix . && prettier --write ./src/**/*.ts ./test/**/*.ts ./*.{json,js,yaml}",
@@ -28,6 +30,9 @@
     "verify": "yarn lint && yarn build && yarn build -p ./test/tsconfig.json && yarn test && yarn code-coverage",
     "code-coverage": "c8 check-coverage --statements 95 --lines 95 --functions 95 --branches 90"
   },
+  "bin": {
+    "create-external-adapter": "adapter-generator.js"
+  },
   "devDependencies": {
     "@sinonjs/fake-timers": "9.1.2",
     "@types/eventsource": "1.1.11",
@@ -47,7 +52,8 @@
     "ts-node": "10.9.1",
     "ts-node-dev": "2.0.0",
     "typedoc": "0.23.21",
-    "typescript": "5.0.4"
+    "typescript": "5.0.4",
+    "@types/yeoman-generator": "5.2.11"
   },
   "prettier": {
     "semi": false,