@dedot/codegen 0.0.1-next.41a5fa17.16 → 0.0.1-next.49d80ab2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. package/{generator → chaintypes/generator}/ApiGen.d.ts +13 -13
  2. package/chaintypes/generator/ConstsGen.d.ts +4 -0
  3. package/{generator → chaintypes/generator}/ConstsGen.js +6 -6
  4. package/{generator → chaintypes/generator}/ErrorsGen.d.ts +1 -1
  5. package/{generator → chaintypes/generator}/ErrorsGen.js +10 -10
  6. package/{generator → chaintypes/generator}/EventsGen.d.ts +1 -1
  7. package/{generator → chaintypes/generator}/EventsGen.js +10 -10
  8. package/chaintypes/generator/IndexGen.d.ts +5 -0
  9. package/chaintypes/generator/IndexGen.js +17 -0
  10. package/chaintypes/generator/JsonRpcGen.d.ts +8 -0
  11. package/chaintypes/generator/JsonRpcGen.js +55 -0
  12. package/chaintypes/generator/QueryGen.d.ts +5 -0
  13. package/{generator → chaintypes/generator}/QueryGen.js +27 -18
  14. package/chaintypes/generator/RuntimeApisGen.d.ts +9 -0
  15. package/{generator → chaintypes/generator}/RuntimeApisGen.js +95 -20
  16. package/{generator → chaintypes/generator}/TxGen.d.ts +1 -1
  17. package/{generator → chaintypes/generator}/TxGen.js +17 -15
  18. package/chaintypes/generator/TypesGen.d.ts +11 -0
  19. package/chaintypes/generator/TypesGen.js +55 -0
  20. package/{generator → chaintypes/generator}/index.d.ts +1 -1
  21. package/{generator → chaintypes/generator}/index.js +1 -1
  22. package/chaintypes/index.d.ts +3 -0
  23. package/chaintypes/index.js +49 -0
  24. package/chaintypes/templates/consts.hbs +7 -0
  25. package/chaintypes/templates/errors.hbs +7 -0
  26. package/chaintypes/templates/events.hbs +7 -0
  27. package/chaintypes/templates/index.hbs +27 -0
  28. package/chaintypes/templates/json-rpc.hbs +5 -0
  29. package/chaintypes/templates/query.hbs +7 -0
  30. package/chaintypes/templates/runtime.hbs +8 -0
  31. package/chaintypes/templates/tx.hbs +9 -0
  32. package/{cjs → chaintypes}/templates/types.hbs +1 -1
  33. package/cjs/{generator → chaintypes/generator}/ConstsGen.js +7 -7
  34. package/cjs/{generator → chaintypes/generator}/ErrorsGen.js +10 -10
  35. package/cjs/{generator → chaintypes/generator}/EventsGen.js +10 -10
  36. package/cjs/chaintypes/generator/IndexGen.js +21 -0
  37. package/cjs/chaintypes/generator/JsonRpcGen.js +59 -0
  38. package/cjs/{generator → chaintypes/generator}/QueryGen.js +28 -19
  39. package/cjs/{generator → chaintypes/generator}/RuntimeApisGen.js +97 -22
  40. package/cjs/{generator → chaintypes/generator}/TxGen.js +17 -15
  41. package/cjs/chaintypes/generator/TypesGen.js +59 -0
  42. package/cjs/{generator → chaintypes/generator}/index.js +1 -1
  43. package/cjs/chaintypes/index.js +77 -0
  44. package/cjs/chaintypes/templates/consts.hbs +7 -0
  45. package/cjs/chaintypes/templates/errors.hbs +7 -0
  46. package/cjs/chaintypes/templates/events.hbs +7 -0
  47. package/cjs/chaintypes/templates/index.hbs +27 -0
  48. package/cjs/chaintypes/templates/json-rpc.hbs +5 -0
  49. package/cjs/chaintypes/templates/query.hbs +7 -0
  50. package/cjs/chaintypes/templates/runtime.hbs +8 -0
  51. package/cjs/chaintypes/templates/tx.hbs +9 -0
  52. package/{templates → cjs/chaintypes/templates}/types.hbs +1 -1
  53. package/cjs/index.js +4 -62
  54. package/cjs/{generator/TypesGen.js → shared/BaseTypesGen.js} +112 -166
  55. package/cjs/{generator → shared}/TypeImports.js +29 -3
  56. package/cjs/shared/index.js +19 -0
  57. package/cjs/{generator → shared}/known-codecs.js +24 -5
  58. package/cjs/typink/generator/ConstructorQueryGen.js +24 -0
  59. package/cjs/typink/generator/ConstructorTxGen.js +24 -0
  60. package/cjs/typink/generator/IndexGen.js +24 -0
  61. package/cjs/typink/generator/QueryGen.js +72 -0
  62. package/cjs/typink/generator/TxGen.js +25 -0
  63. package/cjs/typink/generator/TypesGen.js +28 -0
  64. package/cjs/typink/generator/index.js +22 -0
  65. package/cjs/typink/index.js +37 -0
  66. package/cjs/typink/templates/constructor-query.hbs +7 -0
  67. package/cjs/typink/templates/constructor-tx.hbs +7 -0
  68. package/cjs/typink/templates/index.hbs +14 -0
  69. package/cjs/typink/templates/query.hbs +7 -0
  70. package/cjs/typink/templates/tx.hbs +7 -0
  71. package/cjs/typink/templates/types.hbs +5 -0
  72. package/cjs/{generator/utils.js → utils.js} +4 -4
  73. package/index.d.ts +2 -4
  74. package/index.js +2 -48
  75. package/package.json +15 -17
  76. package/{generator/TypesGen.d.ts → shared/BaseTypesGen.d.ts} +12 -11
  77. package/{generator/TypesGen.js → shared/BaseTypesGen.js} +109 -163
  78. package/{generator → shared}/TypeImports.d.ts +12 -1
  79. package/{generator → shared}/TypeImports.js +29 -3
  80. package/shared/index.d.ts +3 -0
  81. package/shared/index.js +3 -0
  82. package/{generator → shared}/known-codecs.d.ts +1 -1
  83. package/{generator → shared}/known-codecs.js +22 -3
  84. package/typink/generator/ConstructorQueryGen.d.ts +6 -0
  85. package/typink/generator/ConstructorQueryGen.js +20 -0
  86. package/typink/generator/ConstructorTxGen.d.ts +6 -0
  87. package/typink/generator/ConstructorTxGen.js +20 -0
  88. package/typink/generator/IndexGen.d.ts +6 -0
  89. package/typink/generator/IndexGen.js +20 -0
  90. package/typink/generator/QueryGen.d.ts +12 -0
  91. package/typink/generator/QueryGen.js +68 -0
  92. package/typink/generator/TxGen.d.ts +6 -0
  93. package/typink/generator/TxGen.js +21 -0
  94. package/typink/generator/TypesGen.d.ts +7 -0
  95. package/typink/generator/TypesGen.js +24 -0
  96. package/typink/generator/index.d.ts +6 -0
  97. package/typink/generator/index.js +6 -0
  98. package/typink/index.d.ts +2 -0
  99. package/typink/index.js +30 -0
  100. package/typink/templates/constructor-query.hbs +7 -0
  101. package/typink/templates/constructor-tx.hbs +7 -0
  102. package/typink/templates/index.hbs +14 -0
  103. package/typink/templates/query.hbs +7 -0
  104. package/typink/templates/tx.hbs +7 -0
  105. package/typink/templates/types.hbs +5 -0
  106. package/{generator/utils.d.ts → utils.d.ts} +1 -1
  107. package/{generator/utils.js → utils.js} +4 -4
  108. package/cjs/genSupportedChainTypes.js +0 -83
  109. package/cjs/generator/IndexGen.js +0 -18
  110. package/cjs/generator/RpcGen.js +0 -175
  111. package/cjs/generator/known-types.js +0 -33
  112. package/cjs/packageInfo.js +0 -5
  113. package/cjs/templates/consts.hbs +0 -7
  114. package/cjs/templates/errors.hbs +0 -7
  115. package/cjs/templates/events.hbs +0 -7
  116. package/cjs/templates/index.hbs +0 -22
  117. package/cjs/templates/query.hbs +0 -7
  118. package/cjs/templates/rpc.hbs +0 -7
  119. package/cjs/templates/runtime.hbs +0 -8
  120. package/cjs/templates/tx.hbs +0 -9
  121. package/cjs/types.js +0 -2
  122. package/genSupportedChainTypes.d.ts +0 -1
  123. package/genSupportedChainTypes.js +0 -78
  124. package/generator/ConstsGen.d.ts +0 -4
  125. package/generator/IndexGen.d.ts +0 -6
  126. package/generator/IndexGen.js +0 -14
  127. package/generator/QueryGen.d.ts +0 -5
  128. package/generator/RpcGen.d.ts +0 -10
  129. package/generator/RpcGen.js +0 -171
  130. package/generator/RuntimeApisGen.d.ts +0 -9
  131. package/generator/known-types.d.ts +0 -6
  132. package/generator/known-types.js +0 -30
  133. package/packageInfo.d.ts +0 -4
  134. package/packageInfo.js +0 -2
  135. package/templates/consts.hbs +0 -7
  136. package/templates/errors.hbs +0 -7
  137. package/templates/events.hbs +0 -7
  138. package/templates/index.hbs +0 -22
  139. package/templates/query.hbs +0 -7
  140. package/templates/rpc.hbs +0 -7
  141. package/templates/runtime.hbs +0 -8
  142. package/templates/tx.hbs +0 -9
  143. package/types.d.ts +0 -6
  144. package/types.js +0 -1
  145. /package/{generator → chaintypes/generator}/ApiGen.js +0 -0
  146. /package/cjs/{generator → chaintypes/generator}/ApiGen.js +0 -0
  147. /package/cjs/{generator/dirname.js → dirname.js} +0 -0
  148. /package/{generator/dirname.d.ts → dirname.d.ts} +0 -0
  149. /package/{generator/dirname.js → dirname.js} +0 -0
@@ -1,11 +1,11 @@
1
- import { ApiGen } from '../generator/index.js';
2
1
  import { stringCamelCase, stringPascalCase } from '@dedot/utils';
3
- import { beautifySourceCode, commentBlock, compileTemplate, isReservedWord } from './utils.js';
2
+ import { beautifySourceCode, commentBlock, compileTemplate, isReservedWord } from '../../utils.js';
3
+ import { ApiGen } from '../generator/index.js';
4
4
  export class TxGen extends ApiGen {
5
- generate() {
5
+ generate(useSubPaths = false) {
6
6
  const { pallets, types } = this.metadata;
7
7
  this.typesGen.clearCache();
8
- this.typesGen.typeImports.addKnownType('GenericChainTx', 'GenericTxCall', 'ISubmittableExtrinsic', 'ISubmittableResult', 'IRuntimeTxCall');
8
+ this.typesGen.typeImports.addKnownType('GenericChainTx', 'GenericTxCall', 'ISubmittableExtrinsic', 'ISubmittableResult', 'IRuntimeTxCall', 'RpcVersion', 'RpcV2', 'ISubmittableExtrinsicLegacy', 'TransactionStatusLegacy', 'TransactionStatusV2');
9
9
  const { callTypeId, addressTypeId, signatureTypeId } = this.metadata.extrinsic;
10
10
  const callTypeIn = this.typesGen.generateType(callTypeId, 1);
11
11
  const addressTypeIn = this.typesGen.generateType(addressTypeId, 1);
@@ -17,11 +17,11 @@ export class TxGen extends ApiGen {
17
17
  for (let pallet of pallets) {
18
18
  if (pallet.calls === undefined)
19
19
  continue;
20
- const { type } = types[pallet.calls];
21
- if (type.tag !== 'Enum')
20
+ const { typeDef } = types[pallet.calls];
21
+ if (typeDef.type !== 'Enum')
22
22
  continue;
23
- const isFlatEnum = type.value.members.every((m) => m.fields.length === 0);
24
- const typedTxs = type.value.members
23
+ const isFlatEnum = typeDef.value.members.every((m) => m.fields.length === 0);
24
+ const typedTxs = typeDef.value.members
25
25
  .map((one) => ({
26
26
  functionName: stringCamelCase(one.name),
27
27
  params: one.fields.map((f) => ({
@@ -41,22 +41,24 @@ export class TxGen extends ApiGen {
41
41
  txDefsOut += commentBlock(`Pallet \`${pallet.name}\`'s transaction calls`);
42
42
  txDefsOut += `${stringCamelCase(pallet.name)}: {
43
43
  ${typedTxs
44
- .map(({ functionName, params, docs, callInput }) => `${commentBlock(docs, '\n', params.map((p) => `@param {${p.type}} ${p.normalizedName} ${p.docs}`))}${functionName}: GenericTxCall<(${params.map((p) => `${p.normalizedName}: ${p.type}`).join(', ')}) => ChainSubmittableExtrinsic<${callInput}>>`)
44
+ .map(({ functionName, params, docs, callInput }) => `${commentBlock(docs, '\n', params.map((p) => `@param {${p.type}} ${p.normalizedName} ${p.docs}`))}${functionName}: GenericTxCall<Rv, (${params.map((p) => `${p.normalizedName}: ${p.type}`).join(', ')}) => ChainSubmittableExtrinsic<Rv, ${callInput}>>`)
45
45
  .join(',\n')}
46
46
 
47
- ${commentBlock('Generic pallet tx call')}[callName: string]: GenericTxCall<TxCall>,
47
+ ${commentBlock('Generic pallet tx call')}[callName: string]: GenericTxCall<Rv, TxCall<Rv>>,
48
48
  },`;
49
49
  }
50
- const importTypes = this.typesGen.typeImports.toImports();
50
+ const importTypes = this.typesGen.typeImports.toImports({ useSubPaths });
51
51
  // TODO make explicit separate type for Extra
52
52
  const defTypes = `
53
- export type ChainSubmittableExtrinsic<T extends IRuntimeTxCall = ${callTypeIn}> =
53
+ export type ChainSubmittableExtrinsic<Rv extends RpcVersion, T extends IRuntimeTxCall = ${callTypeIn}> =
54
54
  Extrinsic<${addressTypeIn}, T, ${signatureTypeIn}, any[]> &
55
- ISubmittableExtrinsic<ISubmittableResult<FrameSystemEventRecord>>
55
+ (Rv extends RpcV2
56
+ ? ISubmittableExtrinsic<ISubmittableResult<FrameSystemEventRecord, TransactionStatusV2>>
57
+ : ISubmittableExtrinsicLegacy<ISubmittableResult<FrameSystemEventRecord, TransactionStatusLegacy>>)
56
58
 
57
- export type TxCall = (...args: any[]) => ChainSubmittableExtrinsic;
59
+ export type TxCall<Rv extends RpcVersion> = (...args: any[]) => ChainSubmittableExtrinsic<Rv>;
58
60
  `;
59
- const template = compileTemplate('tx.hbs');
61
+ const template = compileTemplate('chaintypes/templates/tx.hbs');
60
62
  return beautifySourceCode(template({ importTypes, defTypes, txDefsOut }));
61
63
  }
62
64
  #normalizeParamName(name) {
@@ -0,0 +1,11 @@
1
+ import { MetadataLatest, PortableRegistry, TypeId } from '@dedot/codecs';
2
+ import { EnumOptions } from '@dedot/shape';
3
+ import { BaseTypesGen } from '../../shared/index.js';
4
+ export declare class TypesGen extends BaseTypesGen {
5
+ metadata: MetadataLatest;
6
+ registry: PortableRegistry;
7
+ constructor(metadata: MetadataLatest);
8
+ generate(useSubPaths?: boolean): Promise<string>;
9
+ shouldGenerateTypeIn(id: TypeId): boolean;
10
+ getEnumOptions(typeId: TypeId): EnumOptions;
11
+ }
@@ -0,0 +1,55 @@
1
+ import { PortableRegistry } from '@dedot/codecs';
2
+ import { BaseTypesGen } from '../../shared/index.js';
3
+ import { beautifySourceCode, commentBlock, compileTemplate } from '../../utils.js';
4
+ // Skip generate types for these
5
+ // as we do have native types for them
6
+ const SKIP_TYPES = [
7
+ 'BoundedBTreeMap',
8
+ 'BoundedBTreeSet',
9
+ 'BoundedVec',
10
+ 'Box',
11
+ 'BTreeMap',
12
+ 'BTreeSet',
13
+ 'Cow',
14
+ 'Option',
15
+ 'Range',
16
+ 'RangeInclusive',
17
+ 'Result',
18
+ 'WeakBoundedVec',
19
+ 'WrapperKeepOpaque',
20
+ 'WrapperOpaque',
21
+ ];
22
+ export class TypesGen extends BaseTypesGen {
23
+ metadata;
24
+ registry;
25
+ constructor(metadata) {
26
+ super(metadata.types);
27
+ this.metadata = metadata;
28
+ this.skipTypes = SKIP_TYPES;
29
+ this.registry = new PortableRegistry(this.metadata);
30
+ this.includedTypes = this.includeTypes();
31
+ }
32
+ generate(useSubPaths = false) {
33
+ this.clearCache();
34
+ let defTypeOut = '';
35
+ Object.values(this.includedTypes)
36
+ .filter(({ skip, knownType }) => !(skip || knownType))
37
+ .forEach(({ name, nameOut, id, docs }) => {
38
+ defTypeOut += `${commentBlock(docs)}export type ${nameOut} = ${this.generateType(id, 0, true)};\n\n`;
39
+ if (this.shouldGenerateTypeIn(id)) {
40
+ defTypeOut += `export type ${name} = ${this.generateType(id)};\n\n`;
41
+ }
42
+ });
43
+ const importTypes = this.typeImports.toImports({ excludeModules: ['./types'], useSubPaths });
44
+ const template = compileTemplate('chaintypes/templates/types.hbs');
45
+ return beautifySourceCode(template({ importTypes, defTypeOut }));
46
+ }
47
+ shouldGenerateTypeIn(id) {
48
+ const { callTypeId } = this.metadata.extrinsic;
49
+ const palletCallTypeIds = this.registry.getFieldTypeIdsFromEnum(callTypeId);
50
+ return callTypeId === id || palletCallTypeIds.includes(id);
51
+ }
52
+ getEnumOptions(typeId) {
53
+ return this.registry.getEnumOptions(typeId);
54
+ }
55
+ }
@@ -2,7 +2,7 @@ export * from './TypesGen.js';
2
2
  export * from './ApiGen.js';
3
3
  export * from './ConstsGen.js';
4
4
  export * from './QueryGen.js';
5
- export * from './RpcGen.js';
5
+ export * from './JsonRpcGen.js';
6
6
  export * from './IndexGen.js';
7
7
  export * from './ErrorsGen.js';
8
8
  export * from './EventsGen.js';
@@ -2,7 +2,7 @@ export * from './TypesGen.js';
2
2
  export * from './ApiGen.js';
3
3
  export * from './ConstsGen.js';
4
4
  export * from './QueryGen.js';
5
- export * from './RpcGen.js';
5
+ export * from './JsonRpcGen.js';
6
6
  export * from './IndexGen.js';
7
7
  export * from './ErrorsGen.js';
8
8
  export * from './EventsGen.js';
@@ -0,0 +1,3 @@
1
+ import { MetadataLatest } from '@dedot/codecs';
2
+ export declare function generateTypesFromEndpoint(chain: string, endpoint: string, outDir?: string, extension?: string, useSubPaths?: boolean): Promise<void>;
3
+ export declare function generateTypes(chain: string, metadata: MetadataLatest, rpcMethods: string[], runtimeApis: Record<string, number>, outDir?: string, extension?: string, useSubPaths?: boolean): Promise<void>;
@@ -0,0 +1,49 @@
1
+ import { LegacyClient } from '@dedot/api';
2
+ import { WsProvider } from '@dedot/providers';
3
+ import { stringCamelCase } from '@dedot/utils';
4
+ import * as fs from 'fs';
5
+ import * as path from 'path';
6
+ import { ConstsGen, ErrorsGen, EventsGen, IndexGen, JsonRpcGen, QueryGen, RuntimeApisGen, TxGen, TypesGen, } from './generator/index.js';
7
+ export async function generateTypesFromEndpoint(chain, endpoint, outDir, extension = 'd.ts', useSubPaths = false) {
8
+ const api = await LegacyClient.new(new WsProvider(endpoint));
9
+ const { methods } = await api.rpc.rpc_methods();
10
+ const apis = api.runtimeVersion.apis || {};
11
+ if (!chain) {
12
+ chain = stringCamelCase(api.runtimeVersion.specName || 'local');
13
+ }
14
+ await generateTypes(chain, api.metadata.latest, methods, apis, outDir, extension, useSubPaths);
15
+ await api.disconnect();
16
+ }
17
+ export async function generateTypes(chain, metadata, rpcMethods, runtimeApis, outDir = '.', extension = 'd.ts', useSubPaths = false) {
18
+ const dirPath = path.resolve(outDir, chain);
19
+ const defTypesFileName = path.join(dirPath, `types.${extension}`);
20
+ const constsTypesFileName = path.join(dirPath, `consts.${extension}`);
21
+ const queryTypesFileName = path.join(dirPath, `query.${extension}`);
22
+ const jsonRpcFileName = path.join(dirPath, `json-rpc.${extension}`);
23
+ const indexFileName = path.join(dirPath, `index.${extension}`);
24
+ const errorsFileName = path.join(dirPath, `errors.${extension}`);
25
+ const eventsFileName = path.join(dirPath, `events.${extension}`);
26
+ const runtimeApisFileName = path.join(dirPath, `runtime.${extension}`);
27
+ const txFileName = path.join(dirPath, `tx.${extension}`);
28
+ if (!fs.existsSync(dirPath)) {
29
+ fs.mkdirSync(dirPath, { recursive: true });
30
+ }
31
+ const typesGen = new TypesGen(metadata);
32
+ const constsGen = new ConstsGen(typesGen);
33
+ const queryGen = new QueryGen(typesGen);
34
+ const jsonRpcGen = new JsonRpcGen(typesGen, rpcMethods);
35
+ const indexGen = new IndexGen(chain);
36
+ const errorsGen = new ErrorsGen(typesGen);
37
+ const eventsGen = new EventsGen(typesGen);
38
+ const runtimeApisGen = new RuntimeApisGen(typesGen, runtimeApis);
39
+ const txGen = new TxGen(typesGen);
40
+ fs.writeFileSync(defTypesFileName, await typesGen.generate(useSubPaths));
41
+ fs.writeFileSync(errorsFileName, await errorsGen.generate(useSubPaths));
42
+ fs.writeFileSync(eventsFileName, await eventsGen.generate(useSubPaths));
43
+ fs.writeFileSync(jsonRpcFileName, await jsonRpcGen.generate(useSubPaths));
44
+ fs.writeFileSync(queryTypesFileName, await queryGen.generate(useSubPaths));
45
+ fs.writeFileSync(constsTypesFileName, await constsGen.generate(useSubPaths));
46
+ fs.writeFileSync(txFileName, await txGen.generate(useSubPaths));
47
+ fs.writeFileSync(indexFileName, await indexGen.generate(useSubPaths));
48
+ fs.writeFileSync(runtimeApisFileName, await runtimeApisGen.generate(useSubPaths));
49
+ }
@@ -0,0 +1,7 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{ importTypes }}}
4
+
5
+ export interface ChainConsts<Rv extends RpcVersion> extends GenericChainConsts<Rv> {
6
+ {{{ defTypeOut }}}
7
+ }
@@ -0,0 +1,7 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{ importTypes }}}
4
+
5
+ export interface ChainErrors<Rv extends RpcVersion> extends GenericChainErrors<Rv> {
6
+ {{{ defTypeOut }}}
7
+ }
@@ -0,0 +1,7 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{ importTypes }}}
4
+
5
+ export interface ChainEvents<Rv extends RpcVersion> extends GenericChainEvents<Rv> {
6
+ {{{ defTypeOut }}}
7
+ }
@@ -0,0 +1,27 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{importTypes}}}
4
+ import { ChainConsts } from './consts';
5
+ import { ChainStorage } from './query';
6
+ import { ChainJsonRpcApis } from './json-rpc';
7
+ import { ChainErrors } from './errors';
8
+ import { ChainEvents } from './events';
9
+ import { RuntimeApis } from './runtime';
10
+ import { ChainTx } from './tx';
11
+
12
+ export * from './types';
13
+
14
+ export interface Versioned{{{interfaceName}}}Api<Rv extends RpcVersion> extends GenericSubstrateApi<Rv> {
15
+ rpc: ChainJsonRpcApis<Rv>;
16
+ consts: ChainConsts<Rv>;
17
+ query: ChainStorage<Rv>;
18
+ errors: ChainErrors<Rv>;
19
+ events: ChainEvents<Rv>;
20
+ call: RuntimeApis<Rv>;
21
+ tx: ChainTx<Rv>;
22
+ }
23
+
24
+ export interface {{{interfaceName}}}Api {
25
+ legacy: Versioned{{{interfaceName}}}Api<RpcLegacy>;
26
+ v2: Versioned{{{interfaceName}}}Api<RpcV2>;
27
+ }
@@ -0,0 +1,5 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{ importTypes }}}
4
+
5
+ export type ChainJsonRpcApis<Rv extends RpcVersion> = Pick<JsonRpcApis, {{{jsonRpcMethods}}}> & GenericJsonRpcApis<Rv>;
@@ -0,0 +1,7 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{ importTypes }}}
4
+
5
+ export interface ChainStorage<Rv extends RpcVersion> extends GenericChainStorage<Rv> {
6
+ {{{ defTypeOut }}}
7
+ }
@@ -0,0 +1,8 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{ importTypes }}}
4
+
5
+ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<Rv> {
6
+ {{{ runtimeCallsOut }}}
7
+ }
8
+
@@ -0,0 +1,9 @@
1
+ // Generated by dedot cli
2
+
3
+ {{{ importTypes }}}
4
+
5
+ {{{ defTypes }}}
6
+
7
+ export interface ChainTx<Rv extends RpcVersion> extends GenericChainTx<Rv, TxCall<Rv>> {
8
+ {{{ txDefsOut }}}
9
+ }
@@ -1,4 +1,4 @@
1
- // Generated by @dedot/codegen
1
+ // Generated by dedot cli
2
2
 
3
3
  {{{ importTypes }}}
4
4
 
@@ -2,13 +2,13 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.ConstsGen = void 0;
4
4
  const utils_1 = require("@dedot/utils");
5
- const index_js_1 = require("../generator/index.js");
6
- const utils_js_1 = require("./utils.js");
7
- class ConstsGen extends index_js_1.ApiGen {
8
- generate() {
5
+ const utils_js_1 = require("../../utils.js");
6
+ const ApiGen_js_1 = require("./ApiGen.js");
7
+ class ConstsGen extends ApiGen_js_1.ApiGen {
8
+ generate(useSubPaths = false) {
9
9
  const { pallets } = this.metadata;
10
10
  this.typesGen.clearCache();
11
- this.typesGen.typeImports.addKnownType('GenericChainConsts');
11
+ this.typesGen.typeImports.addKnownType('GenericChainConsts', 'RpcVersion');
12
12
  let defTypeOut = '';
13
13
  for (let pallet of pallets) {
14
14
  const typedConstants = pallet.constants.map((one) => ({
@@ -23,8 +23,8 @@ class ConstsGen extends index_js_1.ApiGen {
23
23
  ${(0, utils_js_1.commentBlock)('Generic pallet constant')}[name: string]: any,
24
24
  },`;
25
25
  }
26
- const importTypes = this.typesGen.typeImports.toImports();
27
- const template = (0, utils_js_1.compileTemplate)('consts.hbs');
26
+ const importTypes = this.typesGen.typeImports.toImports({ useSubPaths });
27
+ const template = (0, utils_js_1.compileTemplate)('chaintypes/templates/consts.hbs');
28
28
  return (0, utils_js_1.beautifySourceCode)(template({ importTypes, defTypeOut }));
29
29
  }
30
30
  }
@@ -1,14 +1,14 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.ErrorsGen = void 0;
4
- const ApiGen_js_1 = require("./ApiGen.js");
5
- const utils_js_1 = require("./utils.js");
6
4
  const utils_1 = require("@dedot/utils");
5
+ const utils_js_1 = require("../../utils.js");
6
+ const ApiGen_js_1 = require("./ApiGen.js");
7
7
  class ErrorsGen extends ApiGen_js_1.ApiGen {
8
- generate() {
8
+ generate(useSubPaths = false) {
9
9
  const { pallets } = this.metadata;
10
10
  this.typesGen.clearCache();
11
- this.typesGen.typeImports.addKnownType('GenericChainErrors', 'GenericPalletError');
11
+ this.typesGen.typeImports.addKnownType('GenericChainErrors', 'GenericPalletError', 'RpcVersion');
12
12
  let defTypeOut = '';
13
13
  for (let pallet of pallets) {
14
14
  const errorTypeId = pallet.error;
@@ -19,21 +19,21 @@ class ErrorsGen extends ApiGen_js_1.ApiGen {
19
19
  defTypeOut += (0, utils_js_1.commentBlock)(`Pallet \`${pallet.name}\`'s errors`);
20
20
  defTypeOut += `${(0, utils_1.stringCamelCase)(pallet.name)}: {
21
21
  ${errorDefs
22
- .map(({ name, docs }) => `${(0, utils_js_1.commentBlock)(docs)}${(0, utils_1.stringPascalCase)(name)}: GenericPalletError`)
22
+ .map(({ name, docs }) => `${(0, utils_js_1.commentBlock)(docs)}${(0, utils_1.stringPascalCase)(name)}: GenericPalletError<Rv>`)
23
23
  .join(',\n')}
24
24
 
25
- ${(0, utils_js_1.commentBlock)('Generic pallet error')}[error: string]: GenericPalletError,
25
+ ${(0, utils_js_1.commentBlock)('Generic pallet error')}[error: string]: GenericPalletError<Rv>,
26
26
  },`;
27
27
  }
28
- const importTypes = this.typesGen.typeImports.toImports();
29
- const template = (0, utils_js_1.compileTemplate)('errors.hbs');
28
+ const importTypes = this.typesGen.typeImports.toImports({ useSubPaths });
29
+ const template = (0, utils_js_1.compileTemplate)('chaintypes/templates/errors.hbs');
30
30
  return (0, utils_js_1.beautifySourceCode)(template({ importTypes, defTypeOut }));
31
31
  }
32
32
  #getErrorDefs(errorTypeId) {
33
33
  const def = this.metadata.types[errorTypeId];
34
34
  (0, utils_1.assert)(def, `Error def not found for id ${errorTypeId}`);
35
- const { tag, value } = def.type;
36
- (0, utils_1.assert)(tag === 'Enum', `Invalid pallet error type!`);
35
+ const { type, value } = def.typeDef;
36
+ (0, utils_1.assert)(type === 'Enum', 'Invalid pallet error type!');
37
37
  return value.members;
38
38
  }
39
39
  }
@@ -1,14 +1,14 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.EventsGen = void 0;
4
- const ApiGen_js_1 = require("./ApiGen.js");
5
- const utils_js_1 = require("./utils.js");
6
4
  const utils_1 = require("@dedot/utils");
5
+ const utils_js_1 = require("../../utils.js");
6
+ const ApiGen_js_1 = require("./ApiGen.js");
7
7
  class EventsGen extends ApiGen_js_1.ApiGen {
8
- generate() {
8
+ generate(useSubPaths = false) {
9
9
  const { pallets } = this.metadata;
10
10
  this.typesGen.clearCache();
11
- this.typesGen.typeImports.addKnownType('GenericChainEvents', 'GenericPalletEvent');
11
+ this.typesGen.typeImports.addKnownType('GenericChainEvents', 'GenericPalletEvent', 'RpcVersion');
12
12
  let defTypeOut = '';
13
13
  for (let pallet of pallets) {
14
14
  const eventTypeId = pallet.event;
@@ -31,21 +31,21 @@ class EventsGen extends ApiGen_js_1.ApiGen {
31
31
  }
32
32
  return { ...def, genericParts };
33
33
  })
34
- .map(({ name, docs, fields, genericParts }) => `${(0, utils_js_1.commentBlock)(docs)}${(0, utils_1.stringPascalCase)(name)}: GenericPalletEvent<${genericParts.join(', ')}>`)
34
+ .map(({ name, docs, fields, genericParts }) => `${(0, utils_js_1.commentBlock)(docs)}${(0, utils_1.stringPascalCase)(name)}: GenericPalletEvent<Rv, ${genericParts.join(', ')}>`)
35
35
  .join(',\n')}
36
36
 
37
- ${(0, utils_js_1.commentBlock)('Generic pallet event')}[prop: string]: GenericPalletEvent,
37
+ ${(0, utils_js_1.commentBlock)('Generic pallet event')}[prop: string]: GenericPalletEvent<Rv>,
38
38
  },`;
39
39
  }
40
- const importTypes = this.typesGen.typeImports.toImports();
41
- const template = (0, utils_js_1.compileTemplate)('events.hbs');
40
+ const importTypes = this.typesGen.typeImports.toImports({ useSubPaths });
41
+ const template = (0, utils_js_1.compileTemplate)('chaintypes/templates/events.hbs');
42
42
  return (0, utils_js_1.beautifySourceCode)(template({ importTypes, defTypeOut }));
43
43
  }
44
44
  #getEventDefs(typeId) {
45
45
  const def = this.metadata.types[typeId];
46
46
  (0, utils_1.assert)(def, `Event def not found for id ${typeId}`);
47
- const { tag, value } = def.type;
48
- (0, utils_1.assert)(tag === 'Enum', 'Invalid pallet event type!');
47
+ const { type, value } = def.typeDef;
48
+ (0, utils_1.assert)(type === 'Enum', 'Invalid pallet event type!');
49
49
  return value.members;
50
50
  }
51
51
  #generateMemberDefType(fields) {
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.IndexGen = void 0;
4
+ const utils_1 = require("@dedot/utils");
5
+ const index_js_1 = require("../../shared/index.js");
6
+ const utils_js_1 = require("../../utils.js");
7
+ class IndexGen {
8
+ chain;
9
+ constructor(chain) {
10
+ this.chain = chain;
11
+ }
12
+ async generate(useSubPaths = false) {
13
+ const interfaceName = (0, utils_1.stringPascalCase)(this.chain);
14
+ const typeImports = new index_js_1.TypeImports();
15
+ typeImports.addKnownType('GenericSubstrateApi', 'RpcLegacy', 'RpcV2', 'RpcVersion');
16
+ const importTypes = typeImports.toImports({ useSubPaths });
17
+ const template = (0, utils_js_1.compileTemplate)('chaintypes/templates/index.hbs');
18
+ return (0, utils_js_1.beautifySourceCode)(template({ importTypes, interfaceName }));
19
+ }
20
+ }
21
+ exports.IndexGen = IndexGen;
@@ -0,0 +1,59 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.JsonRpcGen = void 0;
4
+ const api_1 = require("@dedot/api");
5
+ const utils_js_1 = require("../../utils.js");
6
+ const ApiGen_js_1 = require("./ApiGen.js");
7
+ const HIDDEN_RPCS = [
8
+ // Ref: https://github.com/paritytech/polkadot-sdk/blob/43415ef58c143b985e09015cd000dbd65f6d3997/substrate/client/rpc-servers/src/lib.rs#L152C9-L158
9
+ 'rpc_methods',
10
+ ];
11
+ const ALIAS_RPCS = [
12
+ // TODO include these into the specs
13
+ 'account_nextIndex',
14
+ 'system_dryRunAt',
15
+ 'state_callAt',
16
+ 'state_getKeysPagedAt',
17
+ 'state_getStorageAt',
18
+ 'state_getStorageHashAt',
19
+ 'state_getStorageSizeAt',
20
+ 'chain_getRuntimeVersion',
21
+ 'chain_getHead',
22
+ 'chain_getFinalisedHead',
23
+ 'childstate_getKeysPagedAt',
24
+ // Subscription pairs
25
+ 'chain_subscribeRuntimeVersion',
26
+ 'chain_unsubscribeRuntimeVersion',
27
+ 'chain_unsubscribeNewHead',
28
+ 'chain_subscribeNewHead',
29
+ 'subscribe_newHead',
30
+ 'unsubscribe_newHead',
31
+ 'chain_subscribeFinalisedHeads',
32
+ 'chain_unsubscribeFinalisedHeads',
33
+ ];
34
+ class JsonRpcGen extends ApiGen_js_1.ApiGen {
35
+ typesGen;
36
+ rpcMethods;
37
+ constructor(typesGen, rpcMethods) {
38
+ super(typesGen);
39
+ this.typesGen = typesGen;
40
+ this.rpcMethods = rpcMethods;
41
+ HIDDEN_RPCS.filter((one) => !rpcMethods.includes(one)).forEach((one) => rpcMethods.push(one));
42
+ rpcMethods.sort();
43
+ }
44
+ generate(useSubPaths = false) {
45
+ this.typesGen.clearCache();
46
+ this.typesGen.typeImports.addKnownType('GenericJsonRpcApis', 'RpcVersion');
47
+ this.typesGen.typeImports.addKnownJsonRpcType('JsonRpcApis');
48
+ const toExclude = Object.values(api_1.subscriptionsInfo).flat();
49
+ const importTypes = this.typesGen.typeImports.toImports({ useSubPaths });
50
+ const template = (0, utils_js_1.compileTemplate)('chaintypes/templates/json-rpc.hbs');
51
+ const jsonRpcMethods = this.rpcMethods
52
+ .filter((one) => !ALIAS_RPCS.includes(one)) // exclude alias rpcs
53
+ .filter((one) => !toExclude.includes(one)) // exclude unsubscribe methods
54
+ .map((one) => `'${one}'`)
55
+ .join(' | ');
56
+ return (0, utils_js_1.beautifySourceCode)(template({ importTypes, jsonRpcMethods }));
57
+ }
58
+ }
59
+ exports.JsonRpcGen = JsonRpcGen;
@@ -2,40 +2,48 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.QueryGen = void 0;
4
4
  const utils_1 = require("@dedot/utils");
5
- const index_js_1 = require("../generator/index.js");
6
- const utils_js_1 = require("./utils.js");
7
- class QueryGen extends index_js_1.ApiGen {
8
- generate() {
5
+ const utils_js_1 = require("../../utils.js");
6
+ const ApiGen_js_1 = require("./ApiGen.js");
7
+ class QueryGen extends ApiGen_js_1.ApiGen {
8
+ generate(useSubPaths = false) {
9
9
  const { pallets } = this.metadata;
10
10
  this.typesGen.clearCache();
11
- this.typesGen.typeImports.addKnownType('GenericChainStorage', 'GenericStorageQuery', 'Callback');
11
+ this.typesGen.typeImports.addKnownType('GenericChainStorage', 'GenericStorageQuery', 'Callback', 'RpcVersion');
12
12
  let defTypeOut = '';
13
13
  for (let pallet of pallets) {
14
14
  const storage = pallet.storage;
15
15
  if (!storage)
16
16
  continue;
17
17
  const queries = storage.entries.map((one) => this.#generateEntry(one));
18
- const queryDefs = queries.map(({ name, valueType, keyType, docs }) => `${(0, utils_js_1.commentBlock)(docs)}${name}: GenericStorageQuery<(${keyType}) => ${valueType}>`);
18
+ const queryDefs = queries.map(({ name, valueType, keyType, docs, keyTypeOut }) => {
19
+ if (keyTypeOut) {
20
+ return `${(0, utils_js_1.commentBlock)(docs)}${name}: GenericStorageQuery<Rv, (${keyType}) => ${valueType}, ${keyTypeOut}>`;
21
+ }
22
+ else {
23
+ return `${(0, utils_js_1.commentBlock)(docs)}${name}: GenericStorageQuery<Rv, (${keyType}) => ${valueType}>`;
24
+ }
25
+ });
19
26
  defTypeOut += (0, utils_js_1.commentBlock)(`Pallet \`${pallet.name}\`'s storage queries`);
20
27
  defTypeOut += `${(0, utils_1.stringCamelCase)(pallet.name)}: {
21
28
  ${queryDefs.join(',\n')}
22
29
 
23
- ${(0, utils_js_1.commentBlock)('Generic pallet storage query')}[storage: string]: GenericStorageQuery;
30
+ ${(0, utils_js_1.commentBlock)('Generic pallet storage query')}[storage: string]: GenericStorageQuery<Rv>;
24
31
  },`;
25
32
  }
26
- const importTypes = this.typesGen.typeImports.toImports();
27
- const template = (0, utils_js_1.compileTemplate)('query.hbs');
33
+ const importTypes = this.typesGen.typeImports.toImports({ useSubPaths });
34
+ const template = (0, utils_js_1.compileTemplate)('chaintypes/templates/query.hbs');
28
35
  return (0, utils_js_1.beautifySourceCode)(template({ importTypes, defTypeOut }));
29
36
  }
30
37
  #generateEntry(entry) {
31
- const { name, type, docs, modifier } = entry;
32
- let valueType, keyType;
33
- if (type.tag === 'Plain') {
34
- valueType = this.typesGen.generateType(type.value.valueTypeId, 1, true);
38
+ const { name, storageType, docs, modifier } = entry;
39
+ let valueType, keyTypeOut, keyTypeIn;
40
+ if (storageType.type === 'Plain') {
41
+ valueType = this.typesGen.generateType(storageType.value.valueTypeId, 1, true);
35
42
  }
36
- else if (type.tag === 'Map') {
37
- valueType = this.typesGen.generateType(type.value.valueTypeId, 1, true);
38
- keyType = this.typesGen.generateType(type.value.keyTypeId, 1);
43
+ else if (storageType.type === 'Map') {
44
+ valueType = this.typesGen.generateType(storageType.value.valueTypeId, 1, true);
45
+ keyTypeOut = this.typesGen.generateType(storageType.value.keyTypeId, 1, true);
46
+ keyTypeIn = this.typesGen.generateType(storageType.value.keyTypeId, 1);
39
47
  }
40
48
  else {
41
49
  throw Error('Invalid entry type!');
@@ -43,14 +51,15 @@ class QueryGen extends index_js_1.ApiGen {
43
51
  const isOptional = modifier === 'Optional';
44
52
  valueType = `${valueType}${isOptional ? ' | undefined' : ''}`;
45
53
  docs.push('\n');
46
- if (keyType) {
47
- docs.push(`@param {${keyType}} arg`);
54
+ if (keyTypeIn) {
55
+ docs.push(`@param {${keyTypeIn}} arg`);
48
56
  }
49
57
  docs.push(`@param {Callback<${valueType}> =} callback`);
50
58
  return {
51
59
  name: (0, utils_1.normalizeName)(name),
52
60
  valueType,
53
- keyType: keyType ? `arg: ${keyType}` : '',
61
+ keyType: keyTypeIn ? `arg: ${keyTypeIn}` : '',
62
+ keyTypeOut,
54
63
  docs,
55
64
  };
56
65
  }