@substrate/api-sidecar 20.7.3 → 20.9.0

package/build/src/controllers/rc/blocks/index.js

@@ -18,11 +18,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RcBlocksTrace = exports.RcBlocksRawExtrinsics = exports.RcBlocksExtrinsics = exports.RcBlocks = void 0;
+exports.RcBlocksTrace = exports.RcBlocksRawExtrinsics = exports.RcBlocksParaInclusions = exports.RcBlocksExtrinsics = exports.RcBlocks = void 0;
 var RcBlocksController_1 = require("./RcBlocksController");
 Object.defineProperty(exports, "RcBlocks", { enumerable: true, get: function () { return __importDefault(RcBlocksController_1).default; } });
 var RcBlocksExtrinsicsController_1 = require("./RcBlocksExtrinsicsController");
 Object.defineProperty(exports, "RcBlocksExtrinsics", { enumerable: true, get: function () { return __importDefault(RcBlocksExtrinsicsController_1).default; } });
+var RcBlocksParaInclusionsController_1 = require("./RcBlocksParaInclusionsController");
+Object.defineProperty(exports, "RcBlocksParaInclusions", { enumerable: true, get: function () { return __importDefault(RcBlocksParaInclusionsController_1).default; } });
 var RcBlocksRawExtrinsicsController_1 = require("./RcBlocksRawExtrinsicsController");
 Object.defineProperty(exports, "RcBlocksRawExtrinsics", { enumerable: true, get: function () { return __importDefault(RcBlocksRawExtrinsicsController_1).default; } });
 var RcBlocksTraceController_1 = require("./RcBlocksTraceController");

package/build/src/controllers/rc/blocks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/controllers/rc/blocks/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;AAExE,2DAA2D;AAAlD,+HAAA,OAAO,OAAY;AAC5B,+EAA+E;AAAtE,mJAAA,OAAO,OAAsB;AACtC,qFAAqF;AAA5E,yJAAA,OAAO,OAAyB;AACzC,qEAAqE;AAA5D,yIAAA,OAAO,OAAiB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/controllers/rc/blocks/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;AAExE,2DAA2D;AAAlD,+HAAA,OAAO,OAAY;AAC5B,+EAA+E;AAAtE,mJAAA,OAAO,OAAsB;AACtC,uFAAuF;AAA9E,2JAAA,OAAO,OAA0B;AAC1C,qFAAqF;AAA5E,yJAAA,OAAO,OAAyB;AACzC,qEAAqE;AAA5D,yIAAA,OAAO,OAAiB"}

package/build/src/services/blocks/BlocksParaInclusionsService.d.ts

@@ -0,0 +1,17 @@
+import { BlockHash } from '@polkadot/types/interfaces';
+import { IBlockParaInclusions } from '../../types/responses';
+import { AbstractService } from '../AbstractService';
+/**
+ * Service for fetching parachain inclusion information from relay chain blocks
+ */
+export declare class BlocksParaInclusionsService extends AbstractService {
+    constructor(api: string);
+    /**
+     * Fetch all decoded parachain inclusion information for a relay chain block
+     *
+     * @param hash - The relay chain block hash to query
+     * @param paraIdFilter - Optional parachain ID to filter results
+     * @returns IBlockParaInclusions containing all parachain inclusions in the block
+     */
+    fetchParaInclusions(hash: BlockHash, paraIdFilter?: number): Promise<IBlockParaInclusions>;
+}

package/build/src/services/blocks/BlocksParaInclusionsService.js

@@ -0,0 +1,85 @@
+"use strict";
+// Copyright 2017-2025 Parity Technologies (UK) Ltd.
+// This file is part of Substrate API Sidecar.
+//
+// Substrate API Sidecar is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlocksParaInclusionsService = void 0;
+const http_errors_1 = require("http-errors");
+const AbstractService_1 = require("../AbstractService");
+/**
+ * Service for fetching parachain inclusion information from relay chain blocks
+ */
+class BlocksParaInclusionsService extends AbstractService_1.AbstractService {
+    constructor(api) {
+        super(api);
+    }
+    /**
+     * Fetch all decoded parachain inclusion information for a relay chain block
+     *
+     * @param hash - The relay chain block hash to query
+     * @param paraIdFilter - Optional parachain ID to filter results
+     * @returns IBlockParaInclusions containing all parachain inclusions in the block
+     */
+    async fetchParaInclusions(hash, paraIdFilter) {
+        const { api } = this;
+        const [apiAt, header] = await Promise.all([api.at(hash), api.rpc.chain.getHeader(hash)]);
+        const events = await apiAt.query.system.events();
+        const inclusionEvents = events.filter((record) => {
+            return record.event.section === 'paraInclusion' && record.event.method === 'CandidateIncluded';
+        });
+        if (inclusionEvents.length === 0) {
+            throw new http_errors_1.BadRequest(`Block ${header.number.toString()} on chain ${this.specName} doesn't have the paraInclusion event`);
+        }
+        const inclusions = inclusionEvents.map((record) => {
+            const eventData = record.event.data;
+            const candidateReceipt = eventData[0].toJSON();
+            const descriptor = candidateReceipt.descriptor;
+            const headData = eventData[1];
+            const header = apiAt.registry.createType('Header', headData);
+            const paraBlockNumber = header.number.toNumber();
+            const paraBlockHash = header.hash.toString();
+            const coreIndex = eventData[2].toString();
+            const groupIndex = eventData[3].toString();
+            return {
+                paraId: descriptor.paraId.toString(),
+                paraBlockNumber,
+                paraBlockHash,
+                descriptor: {
+                    relayParent: descriptor.relayParent.toString(),
+                    persistedValidationDataHash: descriptor.persistedValidationDataHash.toString(),
+                    povHash: descriptor.povHash.toString(),
+                    erasureRoot: descriptor.erasureRoot.toString(),
+                    paraHead: descriptor.paraHead.toString(),
+                    validationCodeHash: descriptor.validationCodeHash.toString(),
+                },
+                commitmentsHash: candidateReceipt.commitmentsHash.toString(),
+                coreIndex,
+                groupIndex,
+            };
+        });
+        const filteredInclusions = paraIdFilter !== undefined
+            ? inclusions.filter((inclusion) => parseInt(inclusion.paraId) === paraIdFilter)
+            : inclusions;
+        return {
+            at: {
+                hash: hash.toString(),
+                height: header.number.toString(),
+            },
+            inclusions: filteredInclusions.sort((a, b) => parseInt(a.paraId) - parseInt(b.paraId)),
+        };
+    }
+}
+exports.BlocksParaInclusionsService = BlocksParaInclusionsService;
+//# sourceMappingURL=BlocksParaInclusionsService.js.map

package/build/src/services/blocks/BlocksParaInclusionsService.js.map

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

package/build/src/services/blocks/index.d.ts

@@ -1,2 +1,3 @@
+export * from './BlocksParaInclusionsService';
 export * from './BlocksService';
 export * from './BlocksTraceService';

package/build/src/services/blocks/index.js

@@ -29,6 +29,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BlocksParaInclusionsService"), exports);
 __exportStar(require("./BlocksService"), exports);
 __exportStar(require("./BlocksTraceService"), exports);
 //# sourceMappingURL=index.js.map

package/build/src/services/blocks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/blocks/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;;;;;;;;;;;AAExE,kDAAgC;AAChC,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/blocks/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;;;;;;;;;;;AAExE,gEAA8C;AAC9C,kDAAgC;AAChC,uDAAqC"}

package/build/src/services/paras/ParasInclusionService.d.ts

@@ -0,0 +1,24 @@
+import { BlockHash } from '@polkadot/types/interfaces';
+import { u32 } from '@polkadot/types-codec';
+import { IParachainInclusion } from '../../types/responses';
+import { AbstractService } from '../AbstractService';
+export declare class ParasInclusionService extends AbstractService {
+    constructor(api: string);
+    /**
+     * Find the relay chain inclusion information for a specific parachain block.
+     *
+     * @param hash - The relay chain block hash to start searching from
+     * @param blockNumber - The parachain block number
+     * @param depth - Search depth (defaults to 10)
+     */
+    getParachainInclusion(hash: BlockHash, paraId: u32, number: string, depth?: number): Promise<IParachainInclusion>;
+    /**
+     * Search relay chain blocks for inclusion of a specific parachain block
+     * Uses optimized candidate_events runtime API when available, falls back to system events for historical support
+     */
+    private searchForInclusion;
+    /**
+     * Search using system events
+     */
+    private searchWithSystemEvents;
+}

package/build/src/services/paras/ParasInclusionService.js

@@ -0,0 +1,110 @@
+"use strict";
+// Copyright 2017-2025 Parity Technologies (UK) Ltd.
+// This file is part of Substrate API Sidecar.
+//
+// Substrate API Sidecar is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParasInclusionService = void 0;
+const apiRegistry_1 = require("../../apiRegistry");
+const AbstractService_1 = require("../AbstractService");
+class ParasInclusionService extends AbstractService_1.AbstractService {
+    constructor(api) {
+        super(api);
+    }
+    /**
+     * Find the relay chain inclusion information for a specific parachain block.
+     *
+     * @param hash - The relay chain block hash to start searching from
+     * @param blockNumber - The parachain block number
+     * @param depth - Search depth (defaults to 10)
+     */
+    async getParachainInclusion(hash, paraId, number, depth = 10) {
+        var _a;
+        const { api } = this;
+        const rcApi = (_a = apiRegistry_1.ApiPromiseRegistry.getApiByType('relay')[0]) === null || _a === void 0 ? void 0 : _a.api;
+        if (!rcApi) {
+            throw new Error('Relay chain api must be available');
+        }
+        const [apiAt, { block }] = await Promise.all([api.at(hash), api.rpc.chain.getBlock(hash)]);
+        const setValidationData = block.extrinsics.find((ext) => {
+            return ext.method.method.toString() === 'setValidationData';
+        });
+        if (!setValidationData) {
+            throw new Error("Block contains no set validation data. Can't find relayParentNumber");
+        }
+        const callArgs = apiAt.registry.createType('Call', setValidationData.method);
+        const { relayParentNumber } = callArgs.toJSON().args.data.validationData;
+        // Search for inclusion starting from relay_parent_number + 1
+        const inclusionNumber = await this.searchForInclusion(rcApi, paraId.toNumber(), number, // parachain block number
+        relayParentNumber, depth);
+        // For now, return a placeholder response
+        return {
+            parachainBlock: parseInt(number, 10),
+            parachainBlockHash: hash.toString(),
+            parachainId: paraId.toNumber(),
+            relayParentNumber,
+            inclusionNumber: inclusionNumber || null,
+            found: inclusionNumber !== null,
+        };
+    }
+    /**
+     * Search relay chain blocks for inclusion of a specific parachain block
+     * Uses optimized candidate_events runtime API when available, falls back to system events for historical support
+     */
+    async searchForInclusion(rcApi, paraId, parachainBlockNumber, relayParentNumber, maxDepth) {
+        return this.searchWithSystemEvents(rcApi, paraId, parachainBlockNumber, relayParentNumber, maxDepth);
+    }
+    /**
+     * Search using system events
+     */
+    async searchWithSystemEvents(rcApi, paraId, parachainBlockNumber, relayParentNumber, maxDepth) {
+        // The number is 5 here since most searches are relative to 2-4 blocks from the `relayParentNumber`.
+        // Therefore we give 1 extra block for extra room, while also minimizing the amount of searches we do.
+        const BATCH_SIZE = 5;
+        // Search in batches of 5 for optimal performance
+        for (let offset = 0; offset < maxDepth; offset += BATCH_SIZE) {
+            const batchSize = Math.min(BATCH_SIZE, maxDepth - offset);
+            const searchBlocks = Array.from({ length: batchSize }, (_, i) => relayParentNumber + offset + i + 1);
+            const searchPromises = searchBlocks.map(async (blockNum) => {
+                try {
+                    const relayBlockHash = await rcApi.rpc.chain.getBlockHash(blockNum);
+                    const rcApiAt = await rcApi.at(relayBlockHash);
+                    const events = await rcApiAt.query.system.events();
+                    const foundInclusion = events.find((record) => {
+                        if (record.event.section === 'paraInclusion' && record.event.method === 'CandidateIncluded') {
+                            const eventData = record.event.data[0].toJSON();
+                            if (eventData.descriptor.paraId === paraId) {
+                                const header = rcApiAt.registry.createType('Header', record.event.data[1]);
+                                return header.number.toString() === parachainBlockNumber;
+                            }
+                        }
+                        return false;
+                    });
+                    return foundInclusion ? blockNum : null;
+                }
+                catch {
+                    return null;
+                }
+            });
+            const results = await Promise.all(searchPromises);
+            const found = results.find((result) => result !== null);
+            if (found) {
+                return found; // Early termination when found in this batch
+            }
+        }
+        return null; // Not found within search depth
+    }
+}
+exports.ParasInclusionService = ParasInclusionService;
+//# sourceMappingURL=ParasInclusionService.js.map

package/build/src/services/paras/ParasInclusionService.js.map

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

package/build/src/services/paras/index.d.ts

@@ -1 +1,2 @@
+export * from './ParasInclusionService';
 export * from './ParasService';

package/build/src/services/paras/index.js

@@ -29,5 +29,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ParasInclusionService"), exports);
 __exportStar(require("./ParasService"), exports);
 //# sourceMappingURL=index.js.map

package/build/src/services/paras/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/paras/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;;;;;;;;;;;AAExE,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/paras/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;;;;;;;;;;;AAExE,0DAAwC;AACxC,iDAA+B"}

package/build/src/types/responses/BlockParaInclusions.d.ts

@@ -0,0 +1,77 @@
+import { IAt } from '.';
+/**
+ * Response type for /blocks/{blockId}/para-inclusions endpoint
+ * Contains all decoded parachain inclusion information for a relay chain block
+ */
+export interface IBlockParaInclusions {
+    /**
+     * Block height and hash at which the query was made
+     */
+    at: IAt;
+    /**
+     * Array of parachain inclusions in this relay chain block
+     */
+    inclusions: IParaInclusion[];
+}
+/**
+ * Information about a single parachain inclusion event
+ */
+export interface IParaInclusion {
+    /**
+     * The parachain ID
+     */
+    paraId: string;
+    /**
+     * The parachain block number that was included (decoded from HeadData)
+     */
+    paraBlockNumber: number;
+    /**
+     * The parachain block hash that was included (decoded from HeadData)
+     */
+    paraBlockHash: string;
+    /**
+     * Candidate descriptor containing parachain inclusion metadata
+     */
+    descriptor: IParaInclusionDescriptor;
+    /**
+     * Hash of the candidate commitments
+     */
+    commitmentsHash: string;
+    /**
+     * Core index (available in data[2])
+     */
+    coreIndex: string;
+    /**
+     * Group index (available in data[3])
+     */
+    groupIndex: string;
+}
+/**
+ * Candidate descriptor from the parachain inclusion event
+ */
+export interface IParaInclusionDescriptor {
+    /**
+     * The relay chain parent block hash
+     */
+    relayParent: string;
+    /**
+     * Hash of the persisted validation data
+     */
+    persistedValidationDataHash: string;
+    /**
+     * Hash of the Proof of Validity (PoV)
+     */
+    povHash: string;
+    /**
+     * Root hash of the erasure encoding
+     */
+    erasureRoot: string;
+    /**
+     * Hash of the parachain head data
+     */
+    paraHead: string;
+    /**
+     * Hash of the validation code
+     */
+    validationCodeHash: string;
+}

package/build/src/types/responses/BlockParaInclusions.js

@@ -0,0 +1,18 @@
+"use strict";
+// Copyright 2017-2025 Parity Technologies (UK) Ltd.
+// This file is part of Substrate API Sidecar.
+//
+// Substrate API Sidecar is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BlockParaInclusions.js.map

package/build/src/types/responses/BlockParaInclusions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockParaInclusions.js","sourceRoot":"","sources":["../../../../src/types/responses/BlockParaInclusions.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE"}

package/build/src/types/responses/ParachainInclusion.d.ts

@@ -0,0 +1,8 @@
+export interface IParachainInclusion {
+    parachainBlock: number;
+    parachainBlockHash: string;
+    parachainId: number;
+    relayParentNumber: number;
+    inclusionNumber: number | null;
+    found: boolean;
+}

package/build/src/types/responses/ParachainInclusion.js

@@ -0,0 +1,18 @@
+"use strict";
+// Copyright 2017-2025 Parity Technologies (UK) Ltd.
+// This file is part of Substrate API Sidecar.
+//
+// Substrate API Sidecar is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ParachainInclusion.js.map

package/build/src/types/responses/ParachainInclusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParachainInclusion.js","sourceRoot":"","sources":["../../../../src/types/responses/ParachainInclusion.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE"}

package/build/src/types/responses/index.d.ts

@@ -9,6 +9,7 @@ export * from './AccountVestingInfo';
 export * from './Assets';
 export * from './At';
 export * from './Block';
+export * from './BlockParaInclusions';
 export * from './BlockRaw';
 export * from './BlockXCMMessages';
 export * from './Coretime';
@@ -36,6 +37,7 @@ export * from './PalletStakingProgress';
 export * from './PalletStakingValidators';
 export * from './PalletStorage';
 export * from './PalletStorageItem';
+export * from './ParachainInclusion';
 export * from './Paras';
 export * from './Payout';
 export * from './PoolAssets';

package/build/src/types/responses/index.js

@@ -40,6 +40,7 @@ __exportStar(require("./AccountVestingInfo"), exports);
 __exportStar(require("./Assets"), exports);
 __exportStar(require("./At"), exports);
 __exportStar(require("./Block"), exports);
+__exportStar(require("./BlockParaInclusions"), exports);
 __exportStar(require("./BlockRaw"), exports);
 __exportStar(require("./BlockXCMMessages"), exports);
 __exportStar(require("./Coretime"), exports);
@@ -67,6 +68,7 @@ __exportStar(require("./PalletStakingProgress"), exports);
 __exportStar(require("./PalletStakingValidators"), exports);
 __exportStar(require("./PalletStorage"), exports);
 __exportStar(require("./PalletStorageItem"), exports);
+__exportStar(require("./ParachainInclusion"), exports);
 __exportStar(require("./Paras"), exports);
 __exportStar(require("./Payout"), exports);
 __exportStar(require("./PoolAssets"), exports);

package/build/src/types/responses/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/responses/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;;;;;;;;;;;AAExE,kDAAgC;AAChC,uDAAqC;AACrC,mDAAiC;AACjC,sDAAoC;AACpC,qDAAmC;AACnC,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AACrC,2CAAyB;AACzB,uCAAqB;AACrB,0CAAwB;AACxB,6CAA2B;AAC3B,qDAAmC;AACnC,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,gDAA8B;AAC9B,wDAAsC;AACtC,gDAA8B;AAC9B,2CAAyB;AACzB,0DAAwC;AACxC,oDAAkC;AAClC,wDAAsC;AACtC,wDAAsC;AACtC,4DAA0C;AAC1C,iDAA+B;AAC/B,qDAAmC;AACnC,iDAA+B;AAC/B,qDAAmC;AACnC,0DAAwC;AACxC,2DAAyC;AACzC,0DAAwC;AACxC,4DAA0C;AAC1C,kDAAgC;AAChC,sDAAoC;AACpC,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,gDAA8B;AAC9B,kDAAgC;AAChC,kDAAgC;AAChC,+DAA6C;AAC7C,mDAAiC;AACjC,+DAA6C;AAC7C,iEAA+C;AAC/C,sDAAoC;AACpC,wDAAsC;AACtC,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/responses/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,gEAAgE;AAChE,+CAA+C;AAC/C,EAAE;AACF,oEAAoE;AACpE,wEAAwE;;;;;;;;;;;;;;;;AAExE,kDAAgC;AAChC,uDAAqC;AACrC,mDAAiC;AACjC,sDAAoC;AACpC,qDAAmC;AACnC,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AACrC,2CAAyB;AACzB,uCAAqB;AACrB,0CAAwB;AACxB,wDAAsC;AACtC,6CAA2B;AAC3B,qDAAmC;AACnC,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,gDAA8B;AAC9B,wDAAsC;AACtC,gDAA8B;AAC9B,2CAAyB;AACzB,0DAAwC;AACxC,oDAAkC;AAClC,wDAAsC;AACtC,wDAAsC;AACtC,4DAA0C;AAC1C,iDAA+B;AAC/B,qDAAmC;AACnC,iDAA+B;AAC/B,qDAAmC;AACnC,0DAAwC;AACxC,2DAAyC;AACzC,0DAAwC;AACxC,4DAA0C;AAC1C,kDAAgC;AAChC,sDAAoC;AACpC,uDAAqC;AACrC,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,gDAA8B;AAC9B,kDAAgC;AAChC,kDAAgC;AAChC,+DAA6C;AAC7C,mDAAiC;AACjC,+DAA6C;AAC7C,iEAA+C;AAC/C,sDAAoC;AACpC,wDAAsC;AACtC,oDAAkC"}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "20.7.3",
+  "version": "20.9.0",
   "name": "@substrate/api-sidecar",
   "description": "REST service that makes it easy to interact with blockchain nodes built using Substrate's FRAME framework.",
   "homepage": "https://github.com/paritytech/substrate-api-sidecar#readme",