test: integrate runtime-tests as a helper library

.eslintignore

@@ -1,3 +1,4 @@
 **/build/*
 calc
 docs
+runtime-tests

.gitignore

@@ -1,6 +1,7 @@
 /.vscode
 **/node_modules
 /build
+/runtime-tests/build
 /target
 yarn-error.log
 **/*.rs.bk
@@ -12,7 +13,6 @@ yarn-error.log
 **.log
 **/logs
 .yarn/*
-/docs/.yarn/*
 !.yarn/releases
 !.yarn/plugins
 /docs/.yarn

README.md

@@ -286,7 +286,7 @@ All the commits in this repo follow the [Conventional Commits spec](https://www.
     * @polkadot/apps-config [release notes](https://github.com/polkadot-js/apps/releases)
     * @polkadot/util-crypto [release notes](https://github.com/polkadot-js/common/releases)
 
-1. After updating the dependencies, the next step is making sure the release will work against all noted runtimes for Polkadot, Kusama, and Westend. This can be handled via the [sidecar-runtime-test](https://github.com/TarikGul/sidecar-runtime-test) helper library. Instructions for how to run it are in the repos README.md. Before moving forward ensure all tests pass, and if it warns of any missing types feel free to make an issue [here](https://github.com/paritytech/substrate-api-sidecar/issues).
+1. After updating the dependencies, the next step is making sure the release will work against all noted runtimes for Polkadot, Kusama, and Westend. This can be handled by running `yarn test:init-runtime-tests`. You must have `python3`, and `psutil` installed to run the script. Before moving forward ensure all tests pass, and if it warns of any missing types feel free to make an issue [here](https://github.com/paritytech/substrate-api-sidecar/issues).
 
 1. Update the version in the package.json (this is very important for releasing on NPM).
 

jest.config.js

@@ -2,5 +2,5 @@ const base = require('@substrate/dev/config/jest')
 
 module.exports = {
 	...base,
-	testPathIgnorePatterns: ['/build/', '/node_modules/', '/docs/'],
+	testPathIgnorePatterns: ['/build/', '/node_modules/', '/docs/', '/runtime-tests'],
 };

package.json

@@ -36,7 +36,11 @@
     "start": "yarn run main",
     "start:log-rpc": "yarn run build && NODE_ENV=test yarn run main ",
     "dev": "tsc-watch --onSuccess \"yarn run main\"",
-    "test": "substrate-exec-jest --silent"
+    "test": "substrate-exec-jest --silent",
+    "lint:runtime-tests": "cd runtime-tests && substrate-dev-run-lint",
+    "build:runtime-tests": "(cd runtime-tests && substrate-exec-tsc)",
+    "test:runtime-tests": "yarn build:runtime-tests && node ./runtime-tests/build/index.js --config=./runtime-tests/jest.config.js",
+    "test:init-runtime-tests": "python3 ./scripts/run_chain_tests.py"
   },
   "dependencies": {
     "@polkadot/api": "beta",

runtime-tests/.eslintignore

@@ -0,0 +1 @@
+**/build/*

runtime-tests/.eslintrc.js

@@ -0,0 +1 @@
+module.exports = require('@substrate/dev/config/eslint');

runtime-tests/README.md

@@ -0,0 +1,30 @@
+## Summary
+
+This is a helper library for Sidecar to run runtime tests against specific chains, at certain blocks. 
+
+## Testing
+
+The below instructions are specific to runtime-tests against one chain. 
+If you are looking to run the runtime-tests against all 3 chains (Polkadot, Kusama, Westend) then run `yarn test:init-runtime-tests` in 
+the root directory of sidecar.
+
+### Polkadot 
+
+Lets first get sidecar ready in a seperate terminal.
+
+```
+$ cd substrate-api-sidecar
+$ git checkout <your_branch>
+$ export SAS_SUBSTRATE_WS_URL=<network archive node>
+$ yarn
+$ yarn build && yarn start
+```
+
+Sidecar should be now connected to the node, and running successfully. If you find a bug file an issue [here](https://github.com/paritytech/substrate-api-sidecar/issues).
+
+Now lets run our runtime tests against polkadot. Go to a separate terminal and run:
+
+`yarn test:runtime-tests --chain polkadot`
+
+Thats it! 
+All the tests should come back with green checkmarks.

runtime-tests/endpoints/index.ts

@@ -0,0 +1,10 @@
+import { ChainSpec } from '../types';
+import { kusamaEndpoints } from './kusamaEndpoints';
+import { polkadotEndpoints } from './polkadotEndpoints';
+import { westendEndpoints } from './westendEndpoints';
+
+export const endpoints: Record<ChainSpec, string[][]> = {
+	kusama: kusamaEndpoints,
+	polkadot: polkadotEndpoints,
+	westend: westendEndpoints,
+};

runtime-tests/endpoints/kusamaEndpoints.ts

@@ -0,0 +1,20 @@
+export const kusamaEndpoints = [
+	['/blocks/2350438', '2350438'], //v1062
+	['/blocks/2684767', '2684767'], //v2005
+	['/blocks/2713513', '2713513'], //v2007
+	['/blocks/2786879', '2786879'], //v2008
+	['/blocks/2863649', '2863649'], //v2011
+	['/blocks/3102680', '3102680'], //v2012
+	['/blocks/3305067', '3305067'], //v2015
+	['/blocks/3492347', '3492347'], //v2019
+	['/blocks/3573193', '3573193'], //v2022
+	['/blocks/4086065', '4086065'], //v2023
+	['/blocks/4178606', '4178606'], //v2024
+	['/blocks/4542697', '4542697'], //v2025
+	['/blocks/5265416', '5265416'], //v2026
+	['/blocks/6065416', '6065416'], //v2027
+	['/blocks/6396694', '6396694'], //v2028
+	['/blocks/6566865', '6566865'], //v2029
+	['/blocks/6819725', '6819725'], //v2029
+	['/blocks/7354817', '7354817'], //v2030
+];

runtime-tests/endpoints/polkadotEndpoints.ts

@@ -0,0 +1,12 @@
+export const polkadotEndpoints = [
+	['/blocks/943438', '943438'], //v17
+	['/blocks/1603025', '1603025'], //v18
+	['/blocks/1662525', '1662525'], //v23
+	['/blocks/1993625', '1993625'], //v24
+	['/blocks/2392625', '2392625'], //v25
+	['/blocks/3592619', '3592619'], //v26
+	['/blocks/3892620', '3892620'], //v27
+	['/blocks/4092619', '4092619'], //v28
+	['/blocks/4392619', '4392619'], //v29
+	['/blocks/4947391', '4947391'], //v30
+];

runtime-tests/endpoints/westendEndpoints.ts

@@ -0,0 +1,10 @@
+export const westendEndpoints = [
+	['/blocks/3813629', '3813629'],
+	['/blocks/3032259', '3032259'],
+	['/blocks/3891809', '3891809'],
+	['/blocks/4781573', '4781573'],
+	['/blocks/5277929', '5277929'],
+	['/blocks/5480769', '5480769'], //v9000
+	['/blocks/5493461', '5493461'], //v9000
+	['/blocks/5495855', '5495855'], //v9000
+];

runtime-tests/helpers/consts.ts

@@ -0,0 +1,9 @@
+/**
+ * Port to Substrate-api-sidecar
+ */
+export const PORT = 8080;
+
+/**
+ * Path to Substrate-api-sidecar
+ */
+export const URL_PATH = '127.0.0.1';

runtime-tests/helpers/request.ts

@@ -0,0 +1,15 @@
+import http from 'http';
+
+export const request = (
+	path: string,
+	hostname: string,
+	port: number
+): Promise<string> => {
+	return new Promise((resolve) => {
+		http.get({ path, hostname, port }, (response) => {
+			let data = '';
+			response.on('data', (_data) => (data += _data));
+			response.on('end', () => resolve(data));
+		});
+	});
+};

runtime-tests/index.ts

@@ -0,0 +1,39 @@
+const config = {
+	chain: 'polkadot',
+};
+const argv = process.argv.slice(0, 2);
+
+/**
+ * We return empty string's as an indication of a false value. JS recognizes "" as falsey.
+ * NodeJS.Process.argv.reduce expects the return value of the accumulator to
+ * be of type string, this is a way of satisfying the compiler, but also
+ * returning the correct behavior.
+ */
+process.argv.reduce((cmd, arg) => {
+	if (cmd) {
+		if (cmd.startsWith('/')) return '';
+		config[cmd] = arg;
+		return '';
+	}
+
+	if (arg.startsWith('--')) {
+		const sub = arg.substring('--'.length);
+		// Will only accept the flag if it's within the config
+		if (Object.keys(config).includes(sub)) {
+			// Set the sub to the next cmd
+			return sub;
+		}
+	}
+
+	argv.push(arg);
+	return '';
+});
+
+// Store configuration on env
+process.env.__CONFIGURATION = JSON.stringify(config);
+
+// Setting real ARGV
+process.argv = argv;
+
+// Calling jest runner
+require('jest-cli/bin/jest');

runtime-tests/jest.config.js

@@ -0,0 +1,6 @@
+const base = require('@substrate/dev/config/jest')
+
+module.exports = {
+    ...base,
+    testPathIgnorePatterns: ['/build/', '/node_modules/', '/src/'],
+};

runtime-tests/runtimeTests.spec.ts

@@ -0,0 +1,26 @@
+import { endpoints } from './endpoints';
+import { PORT, URL_PATH } from './helpers/consts';
+import { request } from './helpers/request';
+import { BlockResponse, ChainConfig, ChainSpec } from './types';
+
+const config = JSON.parse(process.env.__CONFIGURATION as string) as ChainConfig;
+const chain = config.chain as ChainSpec;
+
+const polkadotEndpoints: string[][] = endpoints[chain];
+
+describe('Runtime Tests for blocks', () => {
+	jest.setTimeout(15000);
+
+	/**
+	 * Test runtimes for `/blocks`
+	 */
+	test.each(polkadotEndpoints)(
+		'Given path %p, it should return block height %p',
+		async (blockPath, blockHeight) => {
+			const res = await request(blockPath, URL_PATH, PORT);
+			const responseJson = JSON.parse(res) as BlockResponse;
+
+			expect(responseJson['number']).toBe(blockHeight);
+		}
+	);
+});

runtime-tests/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "extends": "@substrate/dev/config/tsconfig.json",
+    "compilerOptions": {
+        "baseUrl": ".",
+        "outDir": "build",
+        "suppressImplicitAnyIndexErrors": true,
+        "resolveJsonModule": true,
+    },
+}

runtime-tests/types/chainSpec.ts

@@ -0,0 +1,11 @@
+/**
+ * String literal for specific chains that are being tested for
+ */
+export type ChainSpec = 'polkadot' | 'kusama' | 'westend';
+
+/**
+ *
+ */
+export interface ChainConfig {
+	chain: string;
+}

runtime-tests/types/index.ts

@@ -0,0 +1,2 @@
+export * from './chainSpec';
+export * from './responses';

runtime-tests/types/responses.ts

@@ -0,0 +1,16 @@
+/**
+ * Block Responses
+ */
+export interface BlockResponse {
+	number: string;
+	hash: string;
+	parentHash: string;
+	stateRoot: string;
+	extrinsicsRoot: string;
+	authorId: string | undefined;
+	logs: Array<object>;
+	onInitialize: object;
+	extrinsics: Array<object>;
+	onFinalize: object;
+	finalized: boolean | undefined;
+}

scripts/README.md

@@ -0,0 +1,22 @@
+<div style="text-align:center">
+    <h2>Sidecar Scripts</h2>
+    <div>
+    A set of notes and instructions for scripts used in Substrate-api-sidecar
+    </div>
+</div>
+<br></br>
+
+
+## Script `run_chain_tests.py`
+
+### Summary
+
+This script calls the local runtime-tests helper library in order to test the current branch or development enviornment against 
+a collection of different blocks, across different runtimes. It does this for Polkadot, Kusama, and Westend. 
+
+### Requirements
+
+`python3` - required to run the script
+
+`psutil` - package needed to run the script, available with `pip3 install psutil` or `pip install psutil`
+

scripts/run_chain_tests.py

@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+
+import os
+import psutil
+import signal
+import subprocess
+import time
+
+def run_process(args):
+    return subprocess.check_output(args, stderr=subprocess.STDOUT,
+                                   encoding="utf-8")
+
+def run_chain_test(chain):
+    run_process(["yarn"])
+
+    if chain == "polkadot":
+        url = "wss://rpc.polkadot.io"
+        chain = "polkadot"
+    elif chain == "kusama":
+        url = "wss://kusama-rpc.polkadot.io"
+        chain = "kusama"
+    elif chain == "westend":
+        url = "wss://westend-rpc.polkadot.io"
+        chain = "westend"
+    else:
+        return -1
+
+    os.environ["SAS_SUBSTRATE_WS_URL"] = url
+    proc = subprocess.Popen(["yarn", "dev"], stdout=subprocess.PIPE,
+                            stderr=subprocess.STDOUT)
+
+    print('Sidecar is loading in development mode...')
+    time.sleep(20)
+
+    print('Running `yarn`, and checking/loading cache...')
+    run_process(["yarn"])
+
+    print('Running runtime tests for {}'.format(chain))
+    res = run_process(["yarn", "test:runtime-tests", "--chain", chain])
+
+    print('Killing all processes...')
+    for child in psutil.Process(proc.pid).children(recursive=True):
+        child.kill()
+    proc.kill()
+
+    print(res)
+    return res.find("PASS")
+
+
+def main():
+    polka_test = run_chain_test("polkadot")
+    kusama_test = run_chain_test("kusama")
+    westend_test = run_chain_test("westend")
+
+    if polka_test == 0 and kusama_test == 0 and westend_test == 0:
+        return 0
+    else:
+        return -1
+
+
+if __name__ == "__main__":
+    main()

tsconfig.json

@@ -3,6 +3,7 @@
   "compilerOptions": {
     "baseUrl": ".",
     "outDir": "build",
+    "rootDirs": ["./src", "runtime-tests"],
     "suppressImplicitAnyIndexErrors": true,
     "resolveJsonModule": true,
   },