@chainlink/external-adapter-framework 0.9.0 → 0.10.1

package/README.md

@@ -0,0 +1,67 @@
+# EA Framework v3
+
+> **Warning**
+> This framework is in a Beta state, and under active development. While many of the features from version 2 are present, they have not been tested extensively enough to mark this as production ready. You can find v2 in the [External Adapters Monorepo](https://github.com/smartcontractkit/external-adapters-js)
+
+Framework to create External adapters, microservices that serve as middleware to facilitate connections between Chainlink Nodes and Data Providers (DP).
+
+## Requirements
+
+- Node.js 16+
+- Yarn
+
+### Optional development tools
+
+If available, consider setting up your development environment with:
+
+- ESLint
+- Prettier
+
+Note that both of the above are not necessary, but PRs submitted to the repo will be blocked from merging unless they comply with the linting and formatting rules.
+
+## Setup
+
+```sh
+yarn # Install yarn dependencies
+```
+
+## Guides & Docs
+
+- [Basics](./docs/basics.md)
+- Porting a v2 EA to v3
+- Creating a new v3 EA
+- Transports
+  - Basic
+    - REST
+    - WebSocket
+    - SSE
+  - Meta
+    - Routing
+
+## Testing
+
+The EA framework is tested by a suite of integration tests located [here](./test).
+
+```
+yarn test
+```
+
+## Publishing releases
+
+### Automatic
+
+The normal flow for publishing a release is through a series o GitHub actions that are triggered when a PR is closed by merging with the base branch. Full details about our workflows can be found in [./.github/WORKFLOW-README.MD]. A summary of our publish workflow follows:
+
+1. Close a PR containing your changes
+2. If the PR was merged and if it contains a version label instruction (patch, minor, major, none), a new PR will be created that contains the result of running `npm version LABEL` on master with the original PR author assigned as a reviewer.
+3. A link to the newly created version bump PR will be added to your original PR. Click on that link, and approve it to be merged.
+4. Close the version bump PR. If merged, the package will be published to npm.
+5. When the publish workflow finishes, a comment will be added to the version bump PR that tells you if it ran successfully
+
+This adds an extra step (approving a version bump PR) that has to be taken every time a PR is merged. This is annoying, but it is an effective workaround for permissions issues when running against protected branches, and eliminates the need for the PR author to manually update their branch's version by referring to master.
+
+### Manual
+
+If you need to publish a release manually, you can do so by running `yarn release` at the project root
+
+This runs a script that publishes the package from dist/src. If you publish from the root directory, imports will be in the form of: `import {something} from "@chainlink/external-adapter-framework/src/some_directory"`. By publishing the package from dist/src, the "src" part of the import path gets dropped, which looks cleaner: `import {something} from "@chainlink/external-adapter-framework/some_directory"`.

package/adapter/basic.d.ts

@@ -1,24 +1,33 @@
-import { SettingsMap, BaseAdapterConfig, AdapterConfig } from '../config';
+import { AdapterConfig, BaseAdapterConfig, SettingsMap } from '../config';
+import { AdapterRequest, AdapterResponse, Merge } from '../util';
 import { AdapterEndpoint } from './endpoint';
-import { AdapterDependencies, AdapterParams, AdapterRateLimitingConfig, CustomAdapterSettings } from './types';
+import { AdapterDependencies, AdapterParams, AdapterRateLimitingConfig, CustomAdapterSettings, EndpointGenerics, RequestTransform } from './types';
 /**
  * Main class to represent an External Adapter
  */
-export declare class Adapter<CustomSettings extends CustomAdapterSettings = SettingsMap> implements AdapterParams<CustomSettings> {
-    name: string;
+export declare class Adapter<CustomSettings extends CustomAdapterSettings = SettingsMap> implements Omit<AdapterParams<CustomSettings>, 'bootstrap'> {
+    name: Uppercase<string>;
     defaultEndpoint?: string | undefined;
-    endpoints: AdapterEndpoint<unknown, unknown, CustomSettings>[];
+    endpoints: AdapterEndpoint<Merge<EndpointGenerics, {
+        CustomSettings: CustomSettings;
+    }>>[];
     envDefaultOverrides?: Partial<BaseAdapterConfig> | undefined;
     customSettings?: SettingsMap | undefined;
     rateLimiting?: AdapterRateLimitingConfig | undefined;
     overrides?: Record<string, string> | undefined;
+    requestTransforms?: RequestTransform[];
+    envVarsPrefix?: string;
     initialized: boolean;
     /** Object containing alias translations for all endpoints */
-    endpointsMap: Record<string, AdapterEndpoint<unknown, unknown, CustomSettings>>;
+    endpointsMap: Record<string, AdapterEndpoint<Merge<EndpointGenerics, {
+        CustomSettings: CustomSettings;
+    }>>>;
     /** Initialized dependencies that the adapter will use */
     dependencies: AdapterDependencies;
     /** Configuration params for various adapter properties */
-    config: AdapterConfig;
+    config: AdapterConfig<CustomSettings>;
+    /** Bootstrap function that will run when initializing the adapter */
+    private readonly bootstrap?;
     constructor(params: AdapterParams<CustomSettings>);
     /**
      * Initializes all of the [[Transport]]s in the adapter, passing along any [[AdapterDependencies]] and [[AdapterConfig]].
@@ -41,6 +50,11 @@ export declare class Adapter<CustomSettings extends CustomAdapterSettings = Sett
      * using the sensitive flag in the adapter config
      */
     private buildCensorList;
+    /**
+     * Logs a warning for certain configs if set to particular values.
+     * Used to warn stakeholders of potential risks.
+     */
+    private logConfigWarnings;
     /**
      * This function will process dependencies for an adapter, such as caches or rate limiters,
      * in order to inject them into transports and other relevant places later in the lifecycle.
@@ -49,4 +63,34 @@ export declare class Adapter<CustomSettings extends CustomAdapterSettings = Sett
      * @returns a set of AdapterDependencies all initialized
      */
     initializeDependencies(inputDependencies?: Partial<AdapterDependencies>): AdapterDependencies;
+    /**
+     * Attempts to find a value from the Cache and return that if found.
+     *
+     * @param req - the incoming request to this adapter
+     * @returns the cached value if exists
+     */
+    findResponseInCache(req: AdapterRequest): Promise<AdapterResponse | undefined>;
+    /**
+     * Default request transform that takes requests and manipulates
+     *
+     * @param adapter - the current adapter
+     * @param req - the current adapter request
+     * @returns the modified (or new) request
+     */
+    symbolOverrider(req: AdapterRequest): AdapterRequest<import("../util").RequestGenerics>;
+    /**
+     * Takes the incoming request and applies all request transforms in the adapter
+     *
+     * @param req - the current adapter request
+     * @returns the request after passing through all request transforms
+     */
+    runRequestTransforms(req: AdapterRequest): void;
+    /**
+     * Function to serve as middleware to pass along the AdapterRequest to the appropriate Transport (acc. to the endpoint in the req.)
+     *
+     * @param req - the incoming request to this adapter
+     * @param replySent - a promise that resolves when the reply has already been sent
+     * @returns a simple Promise when it's done
+     */
+    handleRequest(req: AdapterRequest, replySent: Promise<unknown>): Promise<AdapterResponse>;
 }

package/adapter/basic.js

@@ -31,9 +31,11 @@ const ioredis_1 = __importDefault(require("ioredis"));
 const cache_1 = require("../cache");
 const cacheMetrics = __importStar(require("../cache/metrics"));
 const config_1 = require("../config");
+const transportMetrics = __importStar(require("../transports/metrics"));
 const rate_limiting_1 = require("../rate-limiting");
 const util_1 = require("../util");
 const censor_list_1 = __importDefault(require("../util/censor/censor-list"));
+const error_1 = require("../validation/error");
 const logger = (0, util_1.makeLogger)('Adapter');
 /**
  * Main class to represent an External Adapter
@@ -52,9 +54,12 @@ class Adapter {
         this.customSettings = params.customSettings;
         this.rateLimiting = params.rateLimiting;
         this.overrides = params.overrides;
+        this.requestTransforms = [this.symbolOverrider.bind(this), ...(params.requestTransforms || [])];
+        this.bootstrap = params.bootstrap;
         this.config = (0, config_1.buildAdapterConfig)({
             overrides: this.envDefaultOverrides,
             customSettings: this.customSettings,
+            envVarsPrefix: this.envVarsPrefix,
         });
         this.normalizeEndpointNames();
         this.calculateRateLimitAllocations();
@@ -67,6 +72,13 @@ class Adapter {
         if (this.initialized) {
             throw new Error('This adapter has already been initialized!');
         }
+        // Building configs during initialization to avoid validation errors during construction
+        (0, config_1.validateAdapterConfig)(this.config, this.customSettings);
+        // Log warnings for risks associated with certain configs and values
+        this.logConfigWarnings();
+        if (this.bootstrap) {
+            await this.bootstrap(this);
+        }
         this.dependencies = this.initializeDependencies(dependencies);
         for (const endpoint of this.endpoints) {
             // Add aliases to map to use in validation
@@ -132,7 +144,10 @@ class Adapter {
     buildCensorList() {
         const censorList = Object.entries(config_1.BaseSettings)
             .concat(Object.entries(this.customSettings || {}))
-            .filter(([name, setting]) => setting && setting.type === 'string' && setting.sensitive && this.config[name])
+            .filter(([name, setting]) => setting &&
+            setting.type === 'string' &&
+            setting.sensitive &&
+            this.config[name])
             .map(([name]) => ({
             key: name,
             // Escaping potential special characters in values before creating regex
@@ -142,6 +157,19 @@ class Adapter {
         }));
         censor_list_1.default.set(censorList);
     }
+    /**
+     * Logs a warning for certain configs if set to particular values.
+     * Used to warn stakeholders of potential risks.
+     */
+    logConfigWarnings() {
+        if (this.config.LOG_LEVEL.toUpperCase() === 'DEBUG' ||
+            this.config.LOG_LEVEL.toUpperCase() === 'TRACE') {
+            logger.warn(`LOG_LEVEL has been set to ${this.config.LOG_LEVEL.toUpperCase()}. Setting higher log levels results in increased memory usage and potentially slower performance.`);
+        }
+        if (this.config.DEBUG === true) {
+            logger.warn(`The adapter is running with DEBUG mode on.`);
+        }
+    }
     /**
      * This function will process dependencies for an adapter, such as caches or rate limiters,
      * in order to inject them into transports and other relevant places later in the lifecycle.
@@ -153,14 +181,28 @@ class Adapter {
         const dependencies = inputDependencies || {};
         if (!dependencies.redisClient) {
             if (this.config.CACHE_TYPE === 'redis') {
-                dependencies.redisClient = new ioredis_1.default({
+                const maxCooldown = this.config.CACHE_REDIS_MAX_RECONNECT_COOLDOWN;
+                const redisOptions = {
                     enableAutoPipelining: true,
                     host: this.config.CACHE_REDIS_HOST,
                     port: this.config.CACHE_REDIS_PORT,
                     password: this.config.CACHE_REDIS_PASSWORD,
                     path: this.config.CACHE_REDIS_PATH,
                     timeout: this.config.CACHE_REDIS_TIMEOUT,
-                });
+                    retryStrategy(times) {
+                        cacheMetrics.redisRetriesCount.inc();
+                        logger.warn(`Redis reconnect attempt #${times}`);
+                        return Math.min(times * 100, maxCooldown); // Next reconnect attempt time
+                    },
+                    connectTimeout: this.config.CACHE_REDIS_CONNECTION_TIMEOUT,
+                    maxRetriesPerRequest: 30, // Limits the number of retries before the adapter shuts down
+                };
+                if (this.config.CACHE_REDIS_URL) {
+                    dependencies.redisClient = new ioredis_1.default(this.config.CACHE_REDIS_URL, redisOptions);
+                }
+                else {
+                    dependencies.redisClient = new ioredis_1.default(redisOptions);
+                }
                 dependencies.redisClient.on('connect', () => {
                     cacheMetrics.redisConnectionsOpen.inc();
                 });
@@ -177,10 +219,148 @@ class Adapter {
             dependencies.backgroundExecuteRateLimiter = new rate_limiting_1.FixedFrequencyRateLimiter().initialize(this.endpoints, rateLimitingTier);
         }
         if (!dependencies.subscriptionSetFactory) {
-            dependencies.subscriptionSetFactory = new util_1.SubscriptionSetFactory(this.config, dependencies.redisClient, this.name);
+            dependencies.subscriptionSetFactory = new util_1.SubscriptionSetFactory(this.config, this.name, dependencies.redisClient);
         }
         return dependencies;
     }
+    /**
+     * Attempts to find a value from the Cache and return that if found.
+     *
+     * @param req - the incoming request to this adapter
+     * @returns the cached value if exists
+     */
+    async findResponseInCache(req) {
+        const response = await this.dependencies.cache.get(req.requestContext.cacheKey);
+        if (response) {
+            if (this.config.METRICS_ENABLED && this.config.EXPERIMENTAL_METRICS_ENABLED) {
+                const label = cacheMetrics.cacheMetricsLabel(req.requestContext.cacheKey, req.requestContext.meta?.metrics?.feedId || 'N/A', this.config.CACHE_TYPE);
+                // Record cache staleness and cache get count and value
+                const staleness = (0, cache_1.calculateStaleness)(response.maxAge, this.config.CACHE_MAX_AGE);
+                cacheMetrics.cacheGet(label, response.result, staleness);
+                req.requestContext.meta = {
+                    ...req.requestContext.meta,
+                    metrics: { ...req.requestContext.meta?.metrics, cacheHit: true },
+                };
+            }
+            return response;
+        }
+    }
+    /**
+     * Default request transform that takes requests and manipulates
+     *
+     * @param adapter - the current adapter
+     * @param req - the current adapter request
+     * @returns the modified (or new) request
+     */
+    symbolOverrider(req) {
+        const rawRequestBody = req.body;
+        const requestOverrides = rawRequestBody.data?.overrides?.[this.name.toLowerCase()];
+        const base = req.requestContext.data['base'];
+        if (requestOverrides?.[base]) {
+            // Perform overrides specified in the request payload
+            req.requestContext.data['base'] = requestOverrides[base];
+        }
+        else if (this.overrides?.[base]) {
+            // Perform hardcoded adapter overrides
+            req.requestContext.data['base'] = this.overrides[base];
+        }
+        return req;
+    }
+    /**
+     * Takes the incoming request and applies all request transforms in the adapter
+     *
+     * @param req - the current adapter request
+     * @returns the request after passing through all request transforms
+     */
+    runRequestTransforms(req) {
+        if (!this.requestTransforms) {
+            return;
+        }
+        for (const transform of this.requestTransforms) {
+            transform(req);
+        }
+    }
+    /**
+     * Function to serve as middleware to pass along the AdapterRequest to the appropriate Transport (acc. to the endpoint in the req.)
+     *
+     * @param req - the incoming request to this adapter
+     * @param replySent - a promise that resolves when the reply has already been sent
+     * @returns a simple Promise when it's done
+     */
+    async handleRequest(req, replySent) {
+        // Get transport, must be here because it's already checked in the validator
+        const transport = this.endpointsMap[req.requestContext.endpointName].transport;
+        // First try to find the response in our cache, keep it ready
+        const cachedResponse = await this.findResponseInCache(req);
+        // Next we fire off the transport's registration of the request if defined, regardless of if we already have a cached response.
+        // This is necessary to ensure things like subscription sets are updated each time we get a request
+        let requestRegistrationPromise;
+        let requestRegistrationError;
+        if (transport.registerRequest) {
+            const handler = async () => {
+                // If we already have a cached response, wait for it to be sent back before continuing with registration
+                // This way we respond to incoming requests from the cache as fast as possible
+                if (cachedResponse) {
+                    await replySent;
+                }
+                try {
+                    // `await` is required to catch the error, you'll get an unhandled promise rejection otherwise
+                    // Disable non-null assertion operator because we already checked for the existence of registerRequest
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    return await transport.registerRequest(req, this.config);
+                }
+                catch (err) {
+                    logger.error(`Error registering request: ${err}`);
+                    requestRegistrationError = err;
+                }
+            };
+            // Execute the registration handler without blocking
+            logger.debug(`Firing request registration handler${cachedResponse ? ' (cached response already sent)' : ''}`);
+            requestRegistrationPromise = handler();
+        }
+        // Now that we have dealt with request registration, can return the cached response if present
+        if (cachedResponse) {
+            logger.debug('Found response from cache, sending that');
+            return cachedResponse;
+        }
+        // If there was no cached response, execute the foregroundExecute if defined
+        const immediateResponse = transport.foregroundExecute && (await transport.foregroundExecute(req, this.config));
+        if (immediateResponse) {
+            logger.debug('Got immediate response from transport, sending as response');
+            return immediateResponse;
+        }
+        // Finally, either because there was no synchronous execute or because it returned an empty response,
+        // we wait for the cache to be filled (either from background work started in the sync execute, or the backgroundExecute).
+        // We can wait for the request registration to have finished here, since we're going to be sleeping for the cache anyways,
+        // and it's useful in case the registration throws a promise so that it doesn't go unhandled.
+        await requestRegistrationPromise;
+        if (requestRegistrationError) {
+            throw requestRegistrationError;
+        }
+        // Observe the idle time taken for polling response
+        const metricsTimer = transportMetrics.transportPollingDurationSeconds
+            .labels({ endpoint: req.requestContext.endpointName })
+            .startTimer();
+        logger.debug('Transport is set up, polling cache for response...');
+        const response = await (0, cache_1.pollResponseFromCache)(this.dependencies.cache, req.requestContext.cacheKey, {
+            maxRetries: this.config.CACHE_POLLING_MAX_RETRIES,
+            sleep: this.config.CACHE_POLLING_SLEEP_MS,
+        });
+        metricsTimer({ succeeded: String(!!response) });
+        if (response) {
+            logger.debug('Got a response from polling the cache, sending that back');
+            return response;
+        }
+        // Record polling mechanism failure to return response
+        transportMetrics.transportPollingFailureCount
+            .labels({ endpoint: req.requestContext.endpointName })
+            .inc();
+        logger.debug('Ran out of polling attempts, returning timeout');
+        throw new error_1.AdapterTimeoutError({
+            message: 'Timed out waiting for provider result.',
+            statusCode: 504,
+        });
+    }
 }
 exports.Adapter = Adapter;
 //# sourceMappingURL=basic.js.map

package/adapter/basic.js.map

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

package/adapter/endpoint.d.ts

@@ -1,17 +1,17 @@
-import { SettingsMap } from '../config';
-import { Transport } from '../transports';
+import { MetaTransport, Transport } from '../transports';
 import { InputParameters } from '../validation';
-import { AdapterEndpointParams, EndpointRateLimitingConfig } from './types';
 import { InputValidator } from '../validation/input-validator';
+import { AdapterEndpointParams, EndpointGenerics, EndpointRateLimitingConfig } from './types';
 /**
  * Main class to represent an endpoint within an External Adapter
  */
-export declare class AdapterEndpoint<Params, Result, CustomSettings extends SettingsMap> implements AdapterEndpointParams<Params, Result, CustomSettings> {
+export declare class AdapterEndpoint<T extends EndpointGenerics> implements AdapterEndpointParams<T> {
     name: string;
     aliases?: string[] | undefined;
-    transport: Transport<Params, Result, CustomSettings>;
+    transport: Transport<T> | MetaTransport<T>;
     inputParameters: InputParameters;
     rateLimiting?: EndpointRateLimitingConfig | undefined;
     validator: InputValidator;
-    constructor(params: AdapterEndpointParams<Params, Result, CustomSettings>);
+    cacheKeyGenerator?: (data: Record<string, unknown>) => string;
+    constructor(params: AdapterEndpointParams<T>);
 }

package/adapter/endpoint.js

@@ -13,6 +13,7 @@ class AdapterEndpoint {
         this.inputParameters = params.inputParameters;
         this.rateLimiting = params.rateLimiting;
         this.validator = new input_validator_1.InputValidator(this.inputParameters);
+        this.cacheKeyGenerator = params.cacheKeyGenerator;
     }
 }
 exports.AdapterEndpoint = AdapterEndpoint;

package/adapter/endpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../../src/adapter/endpoint.ts"],"names":[],"mappings":";;;AAIA,mEAA8D;AAE9D;;GAEG;AACH,MAAa,eAAe;IAU1B,YAAY,MAA6D;QACvE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAC7B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;QACjC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAA;QAC7C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC3D,CAAC;CACF;AAlBD,0CAkBC"}
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../../src/adapter/endpoint.ts"],"names":[],"mappings":";;;AAEA,mEAA8D;AAG9D;;GAEG;AACH,MAAa,eAAe;IAS1B,YAAY,MAAgC;QAC1C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAC7B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;QACjC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAA;QAC7C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACzD,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAA;IACnD,CAAC;CACF;AAlBD,0CAkBC"}

package/adapter/price.d.ts

@@ -1,6 +1,7 @@
-import { Adapter, AdapterEndpointParams, AdapterParams } from './index';
-import { AdapterEndpoint } from './endpoint';
 import { SettingsMap } from '../config';
+import { AdapterRequest, AdapterRequestContext, AdapterResponse, RequestGenerics } from '../util';
+import { AdapterEndpoint } from './endpoint';
+import { Adapter, AdapterEndpointParams, AdapterParams, EndpointGenerics } from './index';
 /**
  * Type for the base input parameter config that any [[PriceEndpoint]] must extend
  */
@@ -9,13 +10,13 @@ export declare type PriceEndpointInputParameters = {
         aliases: readonly ['from', 'coin', ...string[]];
         type: 'string';
         description: 'The symbol of symbols of the currency to query';
-        required: true;
+        required: boolean;
     };
     quote: {
         aliases: readonly ['to', 'market', ...string[]];
         type: 'string';
         description: 'The symbol of the currency to convert to';
-        required: true;
+        required: boolean;
     };
 };
 /**
@@ -25,23 +26,52 @@ export declare const priceEndpointInputParameters: PriceEndpointInputParameters;
 /**
  * Type for base input params for a PriceEndpoint
  */
-declare type PriceEndpointParams = {
+export declare type PriceEndpointParams = {
     base: string;
     quote: string;
 };
+/**
+ * Structure of an "includes" file.
+ * Include pairs describe an incoming price feed request, and the details specify
+ */
+export declare type IncludesFile = IncludePair[];
+declare type IncludeDetails = {
+    from: string;
+    to: string;
+    inverse: boolean;
+};
+declare type IncludePair = {
+    from: string;
+    to: string;
+    includes: IncludeDetails[];
+};
+declare type IncludesMap = Record<string, Record<string, IncludeDetails>>;
 /**
  * A PriceEndpoint is a specific type of AdapterEndpoint. Meant to comply with standard practices for
  * Data Feeds, its InputParameters must extend the basic ones (base/quote).
  */
-export declare class PriceEndpoint<Params extends PriceEndpointParams, ProviderResponseBody, CustomSettings extends SettingsMap> extends AdapterEndpoint<Params, ProviderResponseBody, CustomSettings> {
-    constructor(params: AdapterEndpointParams<Params, ProviderResponseBody, CustomSettings> & {
+export declare class PriceEndpoint<T extends EndpointGenerics> extends AdapterEndpoint<T> {
+    constructor(params: AdapterEndpointParams<T> & {
         inputParameters: PriceEndpointInputParameters;
     });
 }
+declare type PriceAdapterRequest<T extends RequestGenerics> = AdapterRequest<T> & {
+    requestContext: AdapterRequestContext<T> & {
+        priceMeta: {
+            inverse: boolean;
+        };
+    };
+};
 /**
  * A PriceAdapter is a specific kind of Adapter that includes at least one PriceEnpoint.
  */
 export declare class PriceAdapter<CustomSettings extends SettingsMap> extends Adapter<CustomSettings> {
-    constructor(params: AdapterParams<CustomSettings>);
+    includesMap?: IncludesMap;
+    constructor(params: AdapterParams<CustomSettings> & {
+        includes?: IncludesFile;
+    });
+    handleRequest(req: PriceAdapterRequest<{
+        Params: PriceEndpointParams;
+    }>, replySent: Promise<unknown>): Promise<AdapterResponse>;
 }
 export {};

package/adapter/price.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PriceAdapter = exports.PriceEndpoint = exports.priceEndpointInputParameters = void 0;
-const index_1 = require("./index");
 const endpoint_1 = require("./endpoint");
+const index_1 = require("./index");
 /**
  * Base input parameter config that any [[PriceEndpoint]] must extend
  */
@@ -30,6 +30,16 @@ class PriceEndpoint extends endpoint_1.AdapterEndpoint {
     }
 }
 exports.PriceEndpoint = PriceEndpoint;
+const buildIncludesMap = (includesFile) => {
+    const includesMap = {};
+    for (const { from, to, includes } of includesFile) {
+        if (!includesMap[from]) {
+            includesMap[from] = {};
+        }
+        includesMap[from][to] = includes[0];
+    }
+    return includesMap;
+};
 /**
  * A PriceAdapter is a specific kind of Adapter that includes at least one PriceEnpoint.
  */
@@ -40,6 +50,38 @@ class PriceAdapter extends index_1.Adapter {
             throw new Error(`This PriceAdapter's list of endpoints does not contain a valid PriceEndpoint`);
         }
         super(params);
+        if (params.includes) {
+            // Build includes map for constant lookups
+            this.includesMap = buildIncludesMap(params.includes);
+            const requestTransform = (req) => {
+                const priceRequest = req;
+                const requestData = priceRequest.requestContext.data;
+                const includesDetails = this.includesMap?.[requestData.base]?.[requestData.quote];
+                if (includesDetails) {
+                    requestData.base = includesDetails.from || requestData.base;
+                    requestData.quote = includesDetails.to || requestData.quote;
+                }
+                const inverse = includesDetails?.inverse || false;
+                priceRequest.requestContext.priceMeta = {
+                    inverse,
+                };
+            };
+            this.requestTransforms?.push(requestTransform);
+        }
+    }
+    async handleRequest(req, replySent) {
+        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 inverseResult = 1 / response.result;
+            response.result = inverseResult;
+            // Check if response data has a result within it
+            const data = response.data;
+            if (data?.result) {
+                data.result = inverseResult;
+            }
+        }
+        return response;
     }
 }
 exports.PriceAdapter = PriceAdapter;

package/adapter/price.js.map

@@ -1 +1 @@
-{"version":3,"file":"price.js","sourceRoot":"","sources":["../../../src/adapter/price.ts"],"names":[],"mappings":";;;AAAA,mCAAuE;AACvE,yCAA4C;AAqB5C;;GAEG;AACU,QAAA,4BAA4B,GAAiC;IACxE,IAAI,EAAE;QACJ,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACzB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,IAAI;KACf;IACD,KAAK,EAAE;QACL,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;QACzB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,IAAI;KACf;CACF,CAAA;AAUD;;;GAGG;AACH,MAAa,aAIX,SAAQ,0BAA6D;IACrE,YACE,MAEC;QAED,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;CACF;AAZD,sCAYC;AAED;;GAEG;AACH,MAAa,YAAiD,SAAQ,eAAuB;IAC3F,YAAY,MAAqC;QAC/C,yDAAyD;QACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,aAAa,CAAC,EAAE;YAC7D,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAA;SACF;QAED,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;CACF;AAXD,oCAWC"}
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../../src/adapter/price.ts"],"names":[],"mappings":"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"}