To help you get started, we've collected the most common ways that lisk-framework is being used within popular public projects.

LiskHQ / lisk-core / scripts / update_config.js View on Github

if (typeof network === 'undefined') {
	console.error('No network is provided');
	process.exit(1);
}

// TODO: Default config is not accessible this way right now
// 	Will be fixed with https://github.com/LiskHQ/lisk/issues/3171
const appConfig = {
	app: {
		version: packageJSON.version,
		minVersion: packageJSON.lisk.minVersion,
		protocolVersion: packageJSON.lisk.protocolVersion,
	},
};
configurator.loadConfig(appConfig);
const defaultConfig = configurator.getConfig({}, { failOnInvalidArg: false });

const networkConfig = loadJSONFileIfExists(
	path.resolve(rootPath, `config/${network}/config.json`)
);

const unifiedNewConfig = _.merge({}, defaultConfig, networkConfig);

const userConfig = loadJSONFileIfExists(configFilePath);

const history = new JSONHistory('lisk config file', console);

const moveElement = (config, pathFrom, pathTo) => {
	config = _.set(config, pathTo, _.get(config, pathFrom));
	config = _.omit(config, pathFrom);
	return config;
};

View more ways to use lisk-framework

Lisk Framework

What is Lisk Framework

Lisk Framework is an application framework to create a blockchain application compatible with the Lisk protocol. It provides an application where off-chain and on-chain logic can be extended with user defined plugins and modules.

Architecture Overview

The diagram below provides a high-level overview of the architecture:

The framework consists of 3 main parts, an application, a controller and a node.

The application is an entry point and manages the controller and the node. The node is responsible for blockchain protocol logic using user defined modules, while the controller is responsible for maintaining plugins and managing the interaction between plugins and the application.

Installation

$ npm install --save lisk-framework

Tests

npm run test:

testType can be unit|integration|functional

Executing the tests per file:

npm run test: -- [testPathPattern] [jestCliOptions]

Contribution

To test the changes in framework you can run example application under examples,

./bin/run start

If you want to test the changes in lisk-sdk/elements to reflect in lisk-sdk/framework, please make sure you run npm run build at lisk-sdk after making any changes in elements library and run the example app above.

Get Involved

License

Copyright 2016-2020 Lisk Foundation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.