@substrate/api-sidecar
Version:
REST service that makes it easy to interact with blockchain nodes built using Substrate's FRAME framework.
85 lines • 4.21 kB
JavaScript
;
// 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/>.
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const http_errors_1 = require("http-errors");
const apiRegistry_1 = require("../../../apiRegistry");
const services_1 = require("../../../services");
const AbstractController_1 = __importDefault(require("../../AbstractController"));
/**
* Dry run a transaction on the relay chain.
*
* Returns:
* - `at`:
* - `hash`: The block's hash.
* - `height`: The block's height.
* - `result`:
* - Successfull dry run:
* - `actualWeight`: The actual weight of the transaction.
* - `paysFee`: The fee to be paid.
* - Failed dry run:
* - error reason.
* - Dry run not possible to run:
* - `isUnimplemented`: The dry run is not implemented.
* - `isVersionedConversionFailed`: The versioned conversion failed.
* - `type`: 'Unimplemented' | 'VersionedConversionFailed';.
*
* References:
* - `DispatchError`: https://docs.rs/sp-runtime/39.0.1/sp_runtime/enum.DispatchError.html
* - `PostDispatchInfo`: https://docs.rs/frame-support/38.0.0/frame_support/dispatch/struct.PostDispatchInfo.html
* - `Error Type`: https://paritytech.github.io/polkadot-sdk/master/xcm_runtime_apis/dry_run/enum.Error.html
*
* Note: If you get the error `-32601: Method not found` it means that the node sidecar
* is connected to does not expose the `system_dryRun` RPC. One way to resolve this
* issue is to pass the `--rpc-external` flag to that node.
*/
class RcTransactionDryRunController extends AbstractController_1.default {
constructor(_api) {
var _a;
const rcApiSpecName = (_a = apiRegistry_1.ApiPromiseRegistry.getSpecNameByType('relay')) === null || _a === void 0 ? void 0 : _a.values();
const rcSpecName = rcApiSpecName ? Array.from(rcApiSpecName)[0] : undefined;
if (!rcSpecName) {
throw new Error('Relay chain API spec name is not defined.');
}
super(rcSpecName, '/rc/transaction/dry-run', new services_1.TransactionDryRunService(rcSpecName));
this.dryRunTransaction = async ({ body: { tx, at, senderAddress, xcmVersion } }, res) => {
var _a;
if (!tx) {
throw new http_errors_1.BadRequest('Missing field `tx` on request body.');
}
if (!senderAddress) {
throw new http_errors_1.BadRequest('Missing field `senderAddress` on request body.');
}
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 not found, please use SAS_SUBSTRATE_MULTI_CHAIN_URL env variable');
}
const hash = await this.getHashFromAt(at, { api: rcApi });
RcTransactionDryRunController.sanitizedSend(res, await this.service.dryRuntExtrinsic(rcApi, senderAddress, tx, hash, xcmVersion));
};
this.initRoutes();
}
initRoutes() {
this.router.post(this.path, RcTransactionDryRunController.catchWrap(this.dryRunTransaction));
}
}
RcTransactionDryRunController.controllerName = 'RcTransactionDryRun';
RcTransactionDryRunController.requiredPallets = [];
exports.default = RcTransactionDryRunController;
//# sourceMappingURL=RcTransactionDryRunController.js.map