@dedot/contracts 0.0.1-next.cfee875e.21 → 0.1.0

package/Contract.d.ts

@@ -1,13 +1,16 @@
 import { ISubstrateClient } from '@dedot/api';
 import { AccountId32, AccountId32Like } from '@dedot/codecs';
+import { IEventRecord } from '@dedot/types';
 import { TypinkRegistry } from './TypinkRegistry.js';
-import { ContractMetadata, GenericContractApi } from './types/index.js';
+import { ContractEvent, ContractMetadata, GenericContractApi } from './types/index.js';
 export declare class Contract<ContractApi extends GenericContractApi = GenericContractApi> {
     #private;
-    constructor(api: ISubstrateClient, address: AccountId32Like, metadata: ContractMetadata | string);
+    constructor(api: ISubstrateClient, metadata: ContractMetadata | string, address: AccountId32Like);
+    decodeEvent(eventRecord: IEventRecord): ContractEvent;
     get metadata(): ContractMetadata;
     get address(): AccountId32;
     get registry(): TypinkRegistry;
     get query(): ContractApi['query'];
     get tx(): ContractApi['tx'];
+    get events(): ContractApi['events'];
 }

package/Contract.js

@@ -1,19 +1,22 @@
 import { AccountId32 } from '@dedot/codecs';
 import { TypinkRegistry } from './TypinkRegistry.js';
-import { QueryExecutor, TxExecutor } from './executor/index.js';
+import { EventExecutor, QueryExecutor, TxExecutor } from './executor/index.js';
 import { ensureSupportContractsPallet, newProxyChain, parseRawMetadata } from './utils.js';
 export class Contract {
     #api;
     #registry;
     #address;
     #metadata;
-    constructor(api, address, metadata) {
+    constructor(api, metadata, address) {
         ensureSupportContractsPallet(api);
         this.#api = api;
         this.#address = new AccountId32(address);
         this.#metadata = typeof metadata === 'string' ? parseRawMetadata(metadata) : metadata;
         this.#registry = new TypinkRegistry(this.#metadata);
     }
+    decodeEvent(eventRecord) {
+        return this.#registry.decodeEvent(eventRecord);
+    }
     get metadata() {
         return this.#metadata;
     }
@@ -29,4 +32,7 @@ export class Contract {
     get tx() {
         return newProxyChain(new TxExecutor(this.#api, this.#registry, this.#address));
     }
+    get events() {
+        return newProxyChain(new EventExecutor(this.#api, this.#registry, this.#address));
+    }
 }

package/TypinkRegistry.d.ts

@@ -1,7 +1,9 @@
 import { TypeRegistry } from '@dedot/codecs';
-import { ContractMetadata } from './types/index.js';
+import { IEventRecord } from '@dedot/types';
+import { ContractEvent, ContractMetadata } from './types/index.js';
 export declare class TypinkRegistry extends TypeRegistry {
     #private;
     constructor(metadata: ContractMetadata);
     get metadata(): ContractMetadata;
+    decodeEvent(eventRecord: IEventRecord): ContractEvent;
 }

package/TypinkRegistry.js

@@ -1,4 +1,6 @@
 import { TypeRegistry } from '@dedot/codecs';
+import * as $ from '@dedot/shape';
+import { DedotError, assert, hexToU8a, stringCamelCase, stringPascalCase } from '@dedot/utils';
 import { extractContractTypes } from './utils.js';
 export class TypinkRegistry extends TypeRegistry {
     #metadata;
@@ -9,4 +11,61 @@ export class TypinkRegistry extends TypeRegistry {
     get metadata() {
         return this.#metadata;
     }
+    decodeEvent(eventRecord) {
+        const { version } = this.#metadata;
+        switch (version) {
+            case 5:
+                return this.#decodeEventV5(eventRecord);
+            case '4':
+                return this.#decodeEventV4(eventRecord);
+            default:
+                throw new DedotError('Unsupported metadata version!');
+        }
+    }
+    #isContractEmittedEvent(eventRecord) {
+        // @ts-ignore
+        return eventRecord.pallet === 'Contracts' && eventRecord.palletEvent.name === 'ContractEmitted';
+    }
+    #decodeEventV4(eventRecord) {
+        assert(this.#metadata.version === '4', 'Invalid metadata version!');
+        assert(this.#isContractEmittedEvent(eventRecord.event), 'Event Record is not valid!');
+        const data = hexToU8a(eventRecord.event.palletEvent.data.data);
+        const index = data.at(0);
+        assert(index !== undefined, 'Unable to decode event index!');
+        const event = this.#metadata.spec.events[index];
+        assert(event, `Event index not found: ${index.toString()}`);
+        return this.#tryDecodeEvent(event, data.subarray(1));
+    }
+    #decodeEventV5(eventRecord) {
+        assert(this.#metadata.version === 5, 'Invalid metadata version!');
+        assert(this.#isContractEmittedEvent(eventRecord.event), 'Event Record is not valid!');
+        const data = hexToU8a(eventRecord.event.palletEvent.data.data);
+        const signatureTopic = eventRecord.topics.at(0);
+        let eventMeta;
+        if (signatureTopic) {
+            eventMeta = this.#metadata.spec.events.find((one) => one.signature_topic === signatureTopic);
+        }
+        // TODO: Handle multiple anonymous events
+        // If `event` does not exist, it means it's an anonymous event
+        // that does not contain a signature topic in the metadata.
+        if (!eventMeta) {
+            const potentialEvents = this.#metadata.spec.events.filter((one) => !one.signature_topic && one.args.filter((arg) => arg.indexed).length === eventRecord.topics.length);
+            assert(potentialEvents.length === 1, 'Unable to determine event!');
+            eventMeta = potentialEvents[0];
+        }
+        return this.#tryDecodeEvent(eventMeta, data);
+    }
+    #tryDecodeEvent(eventMeta, raw) {
+        const { args, label } = eventMeta;
+        const eventCodecFrame = args.reduce((frame, arg) => {
+            const { label, type: { type }, } = arg;
+            const $codec = this.findCodec(type);
+            Object.assign(frame, { [stringCamelCase(label)]: $codec });
+            return frame;
+        }, {});
+        const $eventCodec = $.Struct(eventCodecFrame);
+        const data = $eventCodec.decode(raw);
+        const name = stringPascalCase(label);
+        return args.length ? { name, data } : { name };
+    }
 }

package/cjs/Contract.js

@@ -10,13 +10,16 @@ class Contract {
     #registry;
     #address;
     #metadata;
-    constructor(api, address, metadata) {
+    constructor(api, metadata, address) {
         (0, utils_js_1.ensureSupportContractsPallet)(api);
         this.#api = api;
         this.#address = new codecs_1.AccountId32(address);
         this.#metadata = typeof metadata === 'string' ? (0, utils_js_1.parseRawMetadata)(metadata) : metadata;
         this.#registry = new TypinkRegistry_js_1.TypinkRegistry(this.#metadata);
     }
+    decodeEvent(eventRecord) {
+        return this.#registry.decodeEvent(eventRecord);
+    }
     get metadata() {
         return this.#metadata;
     }
@@ -32,5 +35,8 @@ class Contract {
     get tx() {
         return (0, utils_js_1.newProxyChain)(new index_js_1.TxExecutor(this.#api, this.#registry, this.#address));
     }
+    get events() {
+        return (0, utils_js_1.newProxyChain)(new index_js_1.EventExecutor(this.#api, this.#registry, this.#address));
+    }
 }
 exports.Contract = Contract;

package/cjs/TypinkRegistry.js

@@ -1,7 +1,32 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TypinkRegistry = void 0;
 const codecs_1 = require("@dedot/codecs");
+const $ = __importStar(require("@dedot/shape"));
+const utils_1 = require("@dedot/utils");
 const utils_js_1 = require("./utils.js");
 class TypinkRegistry extends codecs_1.TypeRegistry {
     #metadata;
@@ -12,5 +37,62 @@ class TypinkRegistry extends codecs_1.TypeRegistry {
     get metadata() {
         return this.#metadata;
     }
+    decodeEvent(eventRecord) {
+        const { version } = this.#metadata;
+        switch (version) {
+            case 5:
+                return this.#decodeEventV5(eventRecord);
+            case '4':
+                return this.#decodeEventV4(eventRecord);
+            default:
+                throw new utils_1.DedotError('Unsupported metadata version!');
+        }
+    }
+    #isContractEmittedEvent(eventRecord) {
+        // @ts-ignore
+        return eventRecord.pallet === 'Contracts' && eventRecord.palletEvent.name === 'ContractEmitted';
+    }
+    #decodeEventV4(eventRecord) {
+        (0, utils_1.assert)(this.#metadata.version === '4', 'Invalid metadata version!');
+        (0, utils_1.assert)(this.#isContractEmittedEvent(eventRecord.event), 'Event Record is not valid!');
+        const data = (0, utils_1.hexToU8a)(eventRecord.event.palletEvent.data.data);
+        const index = data.at(0);
+        (0, utils_1.assert)(index !== undefined, 'Unable to decode event index!');
+        const event = this.#metadata.spec.events[index];
+        (0, utils_1.assert)(event, `Event index not found: ${index.toString()}`);
+        return this.#tryDecodeEvent(event, data.subarray(1));
+    }
+    #decodeEventV5(eventRecord) {
+        (0, utils_1.assert)(this.#metadata.version === 5, 'Invalid metadata version!');
+        (0, utils_1.assert)(this.#isContractEmittedEvent(eventRecord.event), 'Event Record is not valid!');
+        const data = (0, utils_1.hexToU8a)(eventRecord.event.palletEvent.data.data);
+        const signatureTopic = eventRecord.topics.at(0);
+        let eventMeta;
+        if (signatureTopic) {
+            eventMeta = this.#metadata.spec.events.find((one) => one.signature_topic === signatureTopic);
+        }
+        // TODO: Handle multiple anonymous events
+        // If `event` does not exist, it means it's an anonymous event
+        // that does not contain a signature topic in the metadata.
+        if (!eventMeta) {
+            const potentialEvents = this.#metadata.spec.events.filter((one) => !one.signature_topic && one.args.filter((arg) => arg.indexed).length === eventRecord.topics.length);
+            (0, utils_1.assert)(potentialEvents.length === 1, 'Unable to determine event!');
+            eventMeta = potentialEvents[0];
+        }
+        return this.#tryDecodeEvent(eventMeta, data);
+    }
+    #tryDecodeEvent(eventMeta, raw) {
+        const { args, label } = eventMeta;
+        const eventCodecFrame = args.reduce((frame, arg) => {
+            const { label, type: { type }, } = arg;
+            const $codec = this.findCodec(type);
+            Object.assign(frame, { [(0, utils_1.stringCamelCase)(label)]: $codec });
+            return frame;
+        }, {});
+        const $eventCodec = $.Struct(eventCodecFrame);
+        const data = $eventCodec.decode(raw);
+        const name = (0, utils_1.stringPascalCase)(label);
+        return args.length ? { name, data } : { name };
+    }
 }
 exports.TypinkRegistry = TypinkRegistry;

package/cjs/executor/ConstructorQueryExecutor.js

@@ -23,7 +23,7 @@ class ConstructorQueryExecutor extends Executor_js_1.Executor {
             const formattedInputs = args.map((arg, index) => this.tryEncode(arg, params[index]));
             const bytes = (0, utils_1.u8aToHex)((0, utils_1.concatU8a)((0, utils_1.hexToU8a)(meta.selector), ...formattedInputs));
             const code = {
-                tag: (0, utils_1.isWasm)(this.code) ? 'Upload' : 'Existing',
+                type: (0, utils_1.isWasm)(this.code) ? 'Upload' : 'Existing',
                 value: this.code,
             };
             return this.api.call.contractsApi.instantiate(caller, value, gasLimit, storageDepositLimit, code, bytes, salt);

package/cjs/executor/EventExecutor.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventExecutor = void 0;
+const Executor_js_1 = require("./Executor.js");
+const utils_1 = require("@dedot/utils");
+class EventExecutor extends Executor_js_1.Executor {
+    doExecute(eventName) {
+        const eventMeta = this.#findEventMeta(eventName);
+        (0, utils_1.assert)(eventMeta, "Contract event metadata not found!");
+        const is = (event) => {
+            return event.name === eventName;
+        };
+        const as = (event) => {
+            return is(event) ? event : undefined;
+        };
+        return {
+            is,
+            as,
+            meta: eventMeta,
+        };
+    }
+    #findEventMeta(eventName) {
+        return this.registry.metadata.spec.events.find(one => (0, utils_1.stringPascalCase)(one.label) === eventName);
+    }
+}
+exports.EventExecutor = EventExecutor;

package/cjs/executor/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./Executor.js"), exports);
 __exportStar(require("./TxExecutor.js"), exports);
 __exportStar(require("./QueryExecutor.js"), exports);
 __exportStar(require("./ConstructorTxExecutor.js"), exports);
+__exportStar(require("./EventExecutor.js"), exports);

package/cjs/utils.js

@@ -6,7 +6,7 @@ const extractContractTypes = (contractMetadata) => {
     const { types } = contractMetadata;
     return types.map(({ type, id }) => ({
         id,
-        type: (0, exports.normalizeContractTypeDef)(type.def),
+        typeDef: (0, exports.normalizeContractTypeDef)(type.def),
         params: [],
         path: type?.path || [],
         docs: [],
@@ -14,10 +14,10 @@ const extractContractTypes = (contractMetadata) => {
 };
 exports.extractContractTypes = extractContractTypes;
 const normalizeContractTypeDef = (def) => {
-    let tag;
+    let type;
     let value;
     if (def.variant) {
-        tag = 'Enum';
+        type = 'Enum';
         value = {
             members: def.variant.variants?.map((variant) => ({
                 fields: variant.fields?.map((fields) => ({ typeId: fields.type, typeName: fields.typeName })) || [],
@@ -27,19 +27,19 @@ const normalizeContractTypeDef = (def) => {
         };
     }
     else if (def.tuple) {
-        tag = 'Tuple';
+        type = 'Tuple';
         value = {
             fields: def.tuple,
         };
     }
     else if (def.sequence) {
-        tag = 'Sequence';
+        type = 'Sequence';
         value = {
             typeParam: def.sequence.type,
         };
     }
     else if (def.composite) {
-        tag = 'Struct';
+        type = 'Struct';
         value = {
             fields: def.composite.fields.map((one) => ({
                 typeId: one.type,
@@ -49,13 +49,13 @@ const normalizeContractTypeDef = (def) => {
         };
     }
     else if (def.primitive) {
-        tag = 'Primitive';
+        type = 'Primitive';
         value = {
             kind: def.primitive,
         };
     }
     else if (def.array) {
-        tag = 'SizedVec';
+        type = 'SizedVec';
         value = {
             len: def.array.len,
             typeParam: def.array.type,
@@ -64,11 +64,11 @@ const normalizeContractTypeDef = (def) => {
     else {
         throw Error(`Invalid contract type def: ${JSON.stringify(def)}`);
     }
-    return { tag, value };
+    return { type, value };
 };
 exports.normalizeContractTypeDef = normalizeContractTypeDef;
 const UNSUPPORTED_VERSIONS = ['V3', 'V2', 'V1'];
-const SUPPORTED_VERSIONS = ['5', '4'];
+const SUPPORTED_VERSIONS = [5, '4'];
 const parseRawMetadata = (rawMetadata) => {
     const metadata = JSON.parse(rawMetadata);
     // This is for V1, V2, V3

package/executor/ConstructorQueryExecutor.js

@@ -20,7 +20,7 @@ export class ConstructorQueryExecutor extends Executor {
             const formattedInputs = args.map((arg, index) => this.tryEncode(arg, params[index]));
             const bytes = u8aToHex(concatU8a(hexToU8a(meta.selector), ...formattedInputs));
             const code = {
-                tag: isWasm(this.code) ? 'Upload' : 'Existing',
+                type: isWasm(this.code) ? 'Upload' : 'Existing',
                 value: this.code,
             };
             return this.api.call.contractsApi.instantiate(caller, value, gasLimit, storageDepositLimit, code, bytes, salt);

package/executor/EventExecutor.d.ts

@@ -0,0 +1,7 @@
+import { GenericSubstrateApi } from "@dedot/types";
+import { Executor } from "./Executor.js";
+import { GenericContractEvent } from "../types/index.js";
+export declare class EventExecutor<ChainApi extends GenericSubstrateApi> extends Executor<ChainApi> {
+    #private;
+    doExecute(eventName: string): GenericContractEvent;
+}

package/executor/EventExecutor.js

@@ -0,0 +1,22 @@
+import { Executor } from "./Executor.js";
+import { assert, stringPascalCase } from "@dedot/utils";
+export class EventExecutor extends Executor {
+    doExecute(eventName) {
+        const eventMeta = this.#findEventMeta(eventName);
+        assert(eventMeta, "Contract event metadata not found!");
+        const is = (event) => {
+            return event.name === eventName;
+        };
+        const as = (event) => {
+            return is(event) ? event : undefined;
+        };
+        return {
+            is,
+            as,
+            meta: eventMeta,
+        };
+    }
+    #findEventMeta(eventName) {
+        return this.registry.metadata.spec.events.find(one => stringPascalCase(one.label) === eventName);
+    }
+}

package/executor/Executor.d.ts

@@ -3,7 +3,7 @@ import { SubstrateApi } from '@dedot/api/chaintypes';
 import { AccountId32 } from '@dedot/codecs';
 import { GenericSubstrateApi, RpcVersion } from '@dedot/types';
 import { TypinkRegistry } from '../TypinkRegistry.js';
-import { ContractMessageArg, ContractMessage } from '../types/index.js';
+import { ContractMessageArg, ContractCallMessage } from '../types/index.js';
 import { ContractMetadata } from '../types/index.js';
 export declare abstract class Executor<ChainApi extends GenericSubstrateApi = SubstrateApi[RpcVersion]> {
     #private;
@@ -14,5 +14,5 @@ export declare abstract class Executor<ChainApi extends GenericSubstrateApi = Su
     get registry(): TypinkRegistry;
     abstract doExecute(...paths: string[]): unknown;
     tryEncode(param: ContractMessageArg, value: any): Uint8Array;
-    tryDecode(meta: ContractMessage, raw: any): unknown;
+    tryDecode(meta: ContractCallMessage, raw: any): unknown;
 }

package/executor/index.d.ts

@@ -2,3 +2,4 @@ export * from './Executor.js';
 export * from './TxExecutor.js';
 export * from './QueryExecutor.js';
 export * from './ConstructorTxExecutor.js';
+export * from './EventExecutor.js';

package/executor/index.js

@@ -2,3 +2,4 @@ export * from './Executor.js';
 export * from './TxExecutor.js';
 export * from './QueryExecutor.js';
 export * from './ConstructorTxExecutor.js';
+export * from './EventExecutor.js';

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@dedot/contracts",
-  "version": "0.0.1-next.cfee875e.21+cfee875",
+  "version": "0.1.0",
   "description": "Delightful ink! Contract APIs",
   "author": "Tung Vu <tung@coongcrafts.io>",
+  "homepage": "https://github.com/dedotdev/dedot/tree/main/packages/contracts",
+  "repository": {
+    "directory": "packages/contracts",
+    "type": "git",
+    "url": "https://github.com/dedotdev/dedot.git"
+  },
   "main": "./cjs/index.js",
   "sideEffects": false,
   "type": "module",
@@ -12,17 +18,17 @@
     "test": "vitest --watch=false"
   },
   "dependencies": {
-    "@dedot/api": "0.0.1-next.cfee875e.21+cfee875",
-    "@dedot/codecs": "0.0.1-next.cfee875e.21+cfee875",
-    "@dedot/types": "0.0.1-next.cfee875e.21+cfee875",
-    "@dedot/utils": "0.0.1-next.cfee875e.21+cfee875"
+    "@dedot/api": "0.1.0",
+    "@dedot/codecs": "0.1.0",
+    "@dedot/types": "0.1.0",
+    "@dedot/utils": "0.1.0"
   },
   "publishConfig": {
     "access": "public",
     "directory": "dist"
   },
   "license": "Apache-2.0",
-  "gitHead": "cfee875eafba07e0fbb8a72556ca549a62ddceff",
+  "gitHead": "c8220a4ab4b171fe04adb49759318bde865d7c17",
   "module": "./index.js",
   "types": "./index.d.ts",
   "exports": {

package/types/index.d.ts

@@ -1,10 +1,11 @@
 import { SubstrateApi } from '@dedot/api/chaintypes';
 import { AccountId32Like, BytesLike, DispatchError, Weight } from '@dedot/codecs';
 import { AnyFunc, AsyncMethod, GenericSubstrateApi, RpcVersion, VersionedGenericSubstrateApi } from '@dedot/types';
-import { ContractConstructorMessage, ContractMessage } from './shared.js';
-import { ContractMetadataV4 } from './v4.js';
-import { ContractMetadataV5 } from './v5.js';
+import { ContractCallMessage, ContractConstructorMessage } from './shared.js';
+import { ContractEventV4, ContractMetadataV4 } from './v4.js';
+import { ContractEventV5, ContractMetadataV5 } from './v5.js';
 export * from './shared.js';
+export type ContractEventMeta = ContractEventV4 | ContractEventV5;
 export type GenericContractCallResult<DecodedData, ContractResult> = ({
     isOk: true;
     data: DecodedData;
@@ -41,10 +42,10 @@ export type ContractTxOptions = CallOptions & {
     gasLimit: Weight;
 };
 export type GenericContractQueryCall<ChainApi extends GenericSubstrateApi, F extends AsyncMethod = (...args: any[]) => Promise<GenericContractCallResult<any, ContractCallResult<ChainApi>>>> = F & {
-    meta: ContractMessage;
+    meta: ContractCallMessage;
 };
 export type GenericContractTxCall<ChainApi extends GenericSubstrateApi, F extends AnyFunc = (...args: any[]) => ContractSubmittableExtrinsic<ChainApi>> = F & {
-    meta: ContractMessage;
+    meta: ContractCallMessage;
 };
 export type GenericConstructorQueryCall<ChainApi extends GenericSubstrateApi, F extends AsyncMethod = (...args: any[]) => Promise<ContractInstantiateResult<ChainApi>>> = F & {
     meta: ContractConstructorMessage;
@@ -64,9 +65,24 @@ export interface GenericConstructorQuery<ChainApi extends GenericSubstrateApi> {
 export interface GenericConstructorTx<ChainApi extends GenericSubstrateApi> {
     [method: string]: GenericConstructorTxCall<ChainApi>;
 }
-export interface GenericContractApi<ChainApi extends VersionedGenericSubstrateApi = SubstrateApi> {
-    query: GenericContractQuery<ChainApi[RpcVersion]>;
-    tx: GenericContractTx<ChainApi[RpcVersion]>;
-    constructorQuery: GenericConstructorQuery<ChainApi[RpcVersion]>;
-    constructorTx: GenericConstructorTx<ChainApi[RpcVersion]>;
+export type ContractEvent<EventName extends string = string, Data extends any = any> = Data extends undefined ? {
+    name: EventName;
+} : {
+    name: EventName;
+    data: Data;
+};
+export interface GenericContractEvent<EventName extends string = string, Data extends any = any> {
+    is: (event: ContractEvent) => event is ContractEvent<EventName, Data>;
+    as: (event: ContractEvent) => ContractEvent<EventName, Data> | undefined;
+    meta: ContractEventMeta;
+}
+export interface GenericContractEvents<_ extends GenericSubstrateApi> {
+    [event: string]: GenericContractEvent;
+}
+export interface GenericContractApi<Rv extends RpcVersion = RpcVersion, ChainApi extends VersionedGenericSubstrateApi = SubstrateApi> {
+    query: GenericContractQuery<ChainApi[Rv]>;
+    tx: GenericContractTx<ChainApi[Rv]>;
+    constructorQuery: GenericConstructorQuery<ChainApi[Rv]>;
+    constructorTx: GenericConstructorTx<ChainApi[Rv]>;
+    events: GenericContractEvents<ChainApi[Rv]>;
 }

package/types/shared.d.ts

@@ -28,7 +28,7 @@ export interface ContractTypeInfo {
     displayName: string[];
     type: number;
 }
-export interface Message {
+export interface ContractMessage {
     args: ContractMessageArg[];
     default: boolean;
     docs: string[];
@@ -37,9 +37,9 @@ export interface Message {
     returnType: ContractTypeInfo;
     selector: string;
 }
-export interface ContractConstructorMessage extends Message {
+export interface ContractConstructorMessage extends ContractMessage {
 }
-export interface ContractMessage extends Message {
+export interface ContractCallMessage extends ContractMessage {
     mutates: boolean;
 }
 export interface ContractType {
@@ -98,3 +98,7 @@ export interface ContractStorage {
         root_key: string;
     };
 }
+export interface ContractEventArg extends ContractMessageArg {
+    docs: string[];
+    indexed: boolean;
+}

package/types/v4.d.ts

@@ -1,4 +1,4 @@
-import { ContractConstructorMessage, ContractInformation, ContractMessage, ContractSource, ContractStorage, ContractType, ContractTypeInfo } from './shared.js';
+import { ContractConstructorMessage, ContractEventArg, ContractInformation, ContractCallMessage, ContractSource, ContractStorage, ContractType, ContractTypeInfo } from './shared.js';
 export interface ContractMetadataV4 {
     source: ContractSource;
     contract: ContractInformation;
@@ -13,12 +13,12 @@ export interface ContractSpecV4 {
     environment: ContractEnvironmentV4;
     events: ContractEventV4[];
     lang_error: ContractTypeInfo;
-    messages: ContractMessage[];
+    messages: ContractCallMessage[];
 }
 export interface ContractEventV4 {
-    args: unknown[];
+    args: ContractEventArg[];
     docs: string[];
-    label: string[];
+    label: string;
 }
 export interface ContractEnvironmentV4 {
     accountId: ContractTypeInfo;

package/types/v5.d.ts

@@ -6,7 +6,7 @@ export interface ContractMetadataV5 {
     spec: ContractSpecV5;
     storage: ContractStorage;
     types: ContractType[];
-    version: '5';
+    version: 5;
 }
 export interface ContractSpecV5 extends ContractSpecV4 {
     environment: ContractEnvironmentV5;
@@ -14,7 +14,7 @@ export interface ContractSpecV5 extends ContractSpecV4 {
 }
 export interface ContractEventV5 extends ContractEventV4 {
     module_path: string;
-    signature_topic: string;
+    signature_topic?: string | null;
 }
 export interface ContractEnvironmentV5 extends ContractEnvironmentV4 {
     staticBufferSize: number;

package/utils.js

@@ -3,17 +3,17 @@ export const extractContractTypes = (contractMetadata) => {
     const { types } = contractMetadata;
     return types.map(({ type, id }) => ({
         id,
-        type: normalizeContractTypeDef(type.def),
+        typeDef: normalizeContractTypeDef(type.def),
         params: [],
         path: type?.path || [],
         docs: [],
     }));
 };
 export const normalizeContractTypeDef = (def) => {
-    let tag;
+    let type;
     let value;
     if (def.variant) {
-        tag = 'Enum';
+        type = 'Enum';
         value = {
             members: def.variant.variants?.map((variant) => ({
                 fields: variant.fields?.map((fields) => ({ typeId: fields.type, typeName: fields.typeName })) || [],
@@ -23,19 +23,19 @@ export const normalizeContractTypeDef = (def) => {
         };
     }
     else if (def.tuple) {
-        tag = 'Tuple';
+        type = 'Tuple';
         value = {
             fields: def.tuple,
         };
     }
     else if (def.sequence) {
-        tag = 'Sequence';
+        type = 'Sequence';
         value = {
             typeParam: def.sequence.type,
         };
     }
     else if (def.composite) {
-        tag = 'Struct';
+        type = 'Struct';
         value = {
             fields: def.composite.fields.map((one) => ({
                 typeId: one.type,
@@ -45,13 +45,13 @@ export const normalizeContractTypeDef = (def) => {
         };
     }
     else if (def.primitive) {
-        tag = 'Primitive';
+        type = 'Primitive';
         value = {
             kind: def.primitive,
         };
     }
     else if (def.array) {
-        tag = 'SizedVec';
+        type = 'SizedVec';
         value = {
             len: def.array.len,
             typeParam: def.array.type,
@@ -60,10 +60,10 @@ export const normalizeContractTypeDef = (def) => {
     else {
         throw Error(`Invalid contract type def: ${JSON.stringify(def)}`);
     }
-    return { tag, value };
+    return { type, value };
 };
 const UNSUPPORTED_VERSIONS = ['V3', 'V2', 'V1'];
-const SUPPORTED_VERSIONS = ['5', '4'];
+const SUPPORTED_VERSIONS = [5, '4'];
 export const parseRawMetadata = (rawMetadata) => {
     const metadata = JSON.parse(rawMetadata);
     // This is for V1, V2, V3