Halva Spec Builder

Report Bug | Request Feature

Spec-Builder

This npm module is a chain specification file modifier for a Substrate node.

Features

---

• Key generation type sr25519 and ed25519
• Custom middleware support
• Built-in cli

Installation

---

1npm install @halva-suite/halva-spec-builder

Use Module

---

Use middleware runner

1const spec = await HalvaSpecModifier.init('path/to/spec.json', 100, 10)
2  .apply(auraMiddleware)
3  .apply(balanceMiddleware)
4  .apply(grandpaMiddleware)
5  .run();
6spec.output('/path/from/save/shc.json');

Create custom middleware

1 .apply((context: HalvaMiddlewareContext): any => {
2 const ed25519pairs = context.ed25519Keys.getPairs();
3 for (let i = 0; i < ed25519pairs.length; i++) {
4   context.jsonSchema.genesis.runtime.customObject.customField.push(ed25519pairs[i].address);
5 }
6 return context.jsonSchema;
7})

Context structure

1interface HalvaMiddlewareContext {
2jsonSchema: any;
3ed25519Keys: Keyring;
4sr25519Keys: Keyring;
5customArgs: any;
6path: string;
7mnemonic: string;
8balance: number;
9count: number;
10}

Use cli

1spec-builder -i /path/to/spec.json 

1spec-builder -i /path/to/spec.json -a 100 -b 1152921504606847000

1spec-builder -i /path/to/spec.json -a 100 -b 1152921504606847000 -m clip organ olive upper oak void inject side suit toilet stick narrow

You can also use separate middleware when working with cli

1spec-builder -i /path/to/spec.json --am --bm # am - AuraMiddleware bm - BalanceMiddleware 
2                                             #The grandpa block will not be filled, because the --gm argument is missing

Script Commands

---

• yarn test -- Runs tests.
• yarn typecheck -- Checks TypeScript types for correctness. This is disabled during tests for performance reasons.
• yarn lint -- Runs linting.
• yarn format -- Reformats all of the .ts and .tsx files with Prettier.
• yarn build -- Regenerates dist folder that gets included into NPM module.

Contributing

---

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT