Report Bug |
Request Feature
🔥 ATTENTION 🔥
The module has been tested on Substrate 2.0.0-rc5-2 version, work on other versions is not guaranteed
Inspired by Truffle
Halva is a toolchain for developing Decentralized Applications based on Substrate. It provides a high-level way to configure a development environment, interact with Substrate through external API and writing your test cases. Halva targets testing extrinsics via RPC calls this allows test Substrate (or clients compatible with Substrate RPC) as a black-box.
Halva uses Polkadot.js
- Install
halva-cli
npm install -g halva-cli
- Configure your network in
halva.js
const mnemonic = "bottom drive obey lake curtain smoke basket hold race lonely fit walk";
module.exports = {
networks: {
test: {
mnemonic,
ws: "ws://127.0.0.1:9944",
},
},
polkadotjs: {
provider: { },
types: { }
},
}
To run all tests, run:
halva-cli test -p /path/to/tests/folder -n networkName
If you need help, use
halva-cli --help
To run REPL, simple run:
halva-cli console
You can use global variables provided by halva
describe('Halva test', () => {
describe('test global', () => {
it('Get global var', async () => {
console.log(halva.accounts[0].address); // halva_account global var
});
});
});
halva.accounts
- 10 Keyring pairs for testshalva.polkadot
- ApiPromise object of polkadotalicePair
- KeyringPair object of AlicebobPair
- KeyringPair object of BobcharliePair
- KeyringPair object of CharlienetworkName
- Current network namechainMetadata
- Metadata objectmochaConfigure
- Current Mocha configuration object
Halva
has its own assertion for working with extrinsic
and contracts
(in the future)
passes(asyncFn, message, signer)
- Error if extrinsic call failseventEmitted(asyncFn, eventName, section, message, signer)
- Error if the event was not emitted in the transactioneventNotEmitted(asyncFn, eventName, section, message, signer)
- Error if the event was emitted in a transactionfails(asyncFn, errorName, module, signer, message)
- Error if the call ended without errors or with some other error
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE
for more information.
Project Link: https://github.com/halva-suite/halva