@pezkuwi/api-contract 16.5.6 → 16.5.8

package/build-deno/Abi/toV2.ts

@@ -0,0 +1,56 @@
+
+import type { Text } from 'https://deno.land/x/pezkuwi/types/mod.ts';
+import type { ContractConstructorSpecV0, ContractEventSpecV0, ContractMessageSpecV0, ContractMetadataV1, ContractMetadataV2 } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { Registry } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+
+import { objectSpread } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+type WithArgs = keyof typeof ARG_TYPES;
+
+interface NamedEntry {
+  name: Text | Text[];
+}
+
+type GetArgsType<T extends WithArgs> = T extends 'ContractConstructorSpec'
+  ? ContractConstructorSpecV0
+  : T extends ContractEventSpecV0
+    ? ContractEventSpecV0
+    : ContractMessageSpecV0;
+
+interface ArgsEntry <T extends WithArgs> extends NamedEntry {
+  args: GetArgsType<T>['args'][0][];
+}
+
+const ARG_TYPES = {
+  ContractConstructorSpec: 'ContractMessageParamSpecV2',
+  ContractEventSpec: 'ContractEventParamSpecV2',
+  ContractMessageSpec: 'ContractMessageParamSpecV2'
+} as const;
+
+function v1ToV2Label (entry: NamedEntry): { label: Text } {
+  return objectSpread({}, entry, {
+    label: Array.isArray(entry.name)
+      ? entry.name.join('::')
+      : entry.name
+  });
+}
+
+function v1ToV2Labels <T extends WithArgs> (registry: Registry, outType: T, all: ArgsEntry<T>[]): unknown[] {
+  return all.map((e) =>
+    registry.createType(`${outType}V2`, objectSpread(v1ToV2Label(e), {
+      args: e.args.map((a) =>
+        registry.createType(ARG_TYPES[outType], v1ToV2Label(a))
+      )
+    }))
+  );
+}
+
+export function v1ToV2 (registry: Registry, v1: ContractMetadataV1): ContractMetadataV2 {
+  return registry.createType('ContractMetadataV2', objectSpread({}, v1, {
+    spec: objectSpread({}, v1.spec, {
+      constructors: v1ToV2Labels(registry, 'ContractConstructorSpec', v1.spec.constructors),
+      events: v1ToV2Labels(registry, 'ContractEventSpec', v1.spec.events),
+      messages: v1ToV2Labels(registry, 'ContractMessageSpec', v1.spec.messages)
+    })
+  }));
+}

package/build-deno/Abi/toV3.ts

@@ -0,0 +1,16 @@
+
+import type { ContractMetadataV2, ContractMetadataV3 } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { Registry } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+
+import { objectSpread } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+export function v2ToV3 (registry: Registry, v2: ContractMetadataV2): ContractMetadataV3 {
+  return registry.createType('ContractMetadataV3', objectSpread({}, v2, {
+    spec: objectSpread({}, v2.spec, {
+      constructors: v2.spec.constructors.map((c) =>
+        // V3 introduces the payable flag on constructors, for <V3, it is always true
+        registry.createType('ContractConstructorSpecV3', objectSpread({}, c, { payable: true }))
+      )
+    })
+  }));
+}

package/build-deno/Abi/toV4.ts

@@ -0,0 +1,19 @@
+
+import type { ContractMetadataV3, ContractMetadataV4 } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { Registry } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+
+import { objectSpread } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+export function v3ToV4 (registry: Registry, v3: ContractMetadataV3): ContractMetadataV4 {
+  return registry.createType('ContractMetadataV4', objectSpread({}, v3, {
+    spec: objectSpread({}, v3.spec, {
+      constructors: v3.spec.constructors.map((c) =>
+        registry.createType('ContractConstructorSpecV4', objectSpread({}, c))
+      ),
+      messages: v3.spec.messages.map((m) =>
+        registry.createType('ContractMessageSpecV3', objectSpread({}, m))
+      )
+    }),
+    version: registry.createType('Text', '4')
+  }));
+}

package/build-deno/README.md

@@ -0,0 +1,3 @@
+# @pezkuwi/api-contract
+
+Interfaces to allow for the encoding and decoding of Bizinikiwi contract ABIs.

package/build-deno/augment.ts

@@ -0,0 +1,2 @@
+
+import 'https://deno.land/x/pezkuwi/api-augment/mod.ts';

package/build-deno/base/Base.ts

@@ -0,0 +1,50 @@
+
+import type { ApiBase } from 'https://deno.land/x/pezkuwi/api/base/index.ts';
+import type { ApiTypes, DecorateMethod } from 'https://deno.land/x/pezkuwi/api/types/index.ts';
+import type { WeightV2 } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { Registry } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+
+import { isFunction } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+import { Abi } from '../Abi/index.ts';
+
+export abstract class Base<ApiType extends ApiTypes> {
+  readonly abi: Abi;
+  readonly api: ApiBase<ApiType>;
+
+  protected readonly _decorateMethod: DecorateMethod<ApiType>;
+  protected readonly _isWeightV1: boolean;
+  protected readonly _isRevive: boolean;
+
+  constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, decorateMethod: DecorateMethod<ApiType>) {
+    if (!api || !api.isConnected || !api.tx) {
+      throw new Error('Your API has not been initialized correctly and is not connected to a chain');
+    }
+
+    this.abi = abi instanceof Abi
+      ? abi
+      : new Abi(abi, api.registry.getChainProperties());
+    this.api = api;
+    this._decorateMethod = decorateMethod;
+    this._isWeightV1 = !api.registry.createType<WeightV2>('Weight').proofSize;
+    this._isRevive = this.abi.isRevive;
+
+    if (this._isRevive) {
+      if (!api.tx.revive || !isFunction(api.tx.revive.instantiateWithCode) || api.tx.revive.instantiateWithCode.meta.args.length !== 6) {
+        throw new Error('The runtime does not expose api.tx.revive.instantiateWithCode with storageDepositLimit');
+      } else if (!api.call.reviveApi || !isFunction(api.call.reviveApi.call)) {
+        throw new Error('Your runtime does not expose the api.call.reviveApi.call runtime interfaces');
+      }
+    } else {
+      if (!api.tx.contracts || !isFunction(api.tx.contracts.instantiateWithCode) || api.tx.contracts.instantiateWithCode.meta.args.length !== 6) {
+        throw new Error('The runtime does not expose api.tx.contracts.instantiateWithCode with storageDepositLimit');
+      } else if (!api.call.contractsApi || !isFunction(api.call.contractsApi.call)) {
+        throw new Error('Your runtime does not expose the api.call.contractsApi.call runtime interfaces');
+      }
+    }
+  }
+
+  public get registry (): Registry {
+    return this.api.registry;
+  }
+}

package/build-deno/base/Blueprint.ts

@@ -0,0 +1,88 @@
+
+import type { ApiBase } from 'https://deno.land/x/pezkuwi/api/base/index.ts';
+import type { SubmittableExtrinsic } from 'https://deno.land/x/pezkuwi/api/submittable/types.ts';
+import type { ApiTypes, DecorateMethod } from 'https://deno.land/x/pezkuwi/api/types/index.ts';
+import type { AccountId, EventRecord, Hash } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { ISubmittableResult } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+import type { Abi } from '../Abi/index.ts';
+import type { AbiConstructor, BlueprintOptions } from '../types.ts';
+import type { MapConstructorExec } from './types.ts';
+
+import { SubmittableResult } from 'https://deno.land/x/pezkuwi/api/mod.ts';
+import { BN_ZERO, isUndefined } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+import { applyOnEvent } from '../util.ts';
+import { Base } from './Base.ts';
+import { Contract } from './Contract.ts';
+import { convertWeight, createBluePrintTx, encodeSalt } from './util.ts';
+
+export type BlueprintConstructor<ApiType extends ApiTypes> = new(api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, codeHash: string | Hash | Uint8Array) => Blueprint<ApiType>;
+
+export class BlueprintSubmittableResult<ApiType extends ApiTypes> extends SubmittableResult {
+  readonly contract?: Contract<ApiType> | undefined;
+
+  constructor (result: ISubmittableResult, contract?: Contract<ApiType>) {
+    super(result);
+
+    this.contract = contract;
+  }
+}
+
+export class Blueprint<ApiType extends ApiTypes> extends Base<ApiType> {
+  /**
+   * @description The on-chain code hash for this blueprint
+   */
+  readonly codeHash: Hash;
+
+  readonly #tx: MapConstructorExec<ApiType> = {};
+
+  constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, codeHash: string | Hash | Uint8Array, decorateMethod: DecorateMethod<ApiType>) {
+    super(api, abi, decorateMethod);
+
+    this.codeHash = this.registry.createType('Hash', codeHash);
+
+    this.abi.constructors.forEach((c): void => {
+      if (isUndefined(this.#tx[c.method])) {
+        this.#tx[c.method] = createBluePrintTx(c, (o, p) => this.#deploy(c, o, p));
+      }
+    });
+  }
+
+  public get tx (): MapConstructorExec<ApiType> {
+    return this.#tx;
+  }
+
+  #deploy = (constructorOrId: AbiConstructor | string | number, { gasLimit = BN_ZERO, salt, storageDepositLimit = null, value = BN_ZERO }: BlueprintOptions, params: unknown[]): SubmittableExtrinsic<ApiType, BlueprintSubmittableResult<ApiType>> => {
+    const palletTx = this._isRevive
+      ? this.api.tx.revive
+      : this.api.tx.contracts;
+
+    return palletTx.instantiate(
+      value,
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore jiggle v1 weights, metadata points to latest
+      this._isWeightV1
+        ? convertWeight(gasLimit).v1Weight
+        : convertWeight(gasLimit).v2Weight,
+      storageDepositLimit,
+      this.codeHash,
+      this.abi.findConstructor(constructorOrId).toU8a(params),
+      encodeSalt(salt)
+    ).withResultTransform((result: ISubmittableResult) =>
+      new BlueprintSubmittableResult(result, applyOnEvent(result, ['Instantiated'], ([record]: EventRecord[]) =>
+        new Contract<ApiType>(this.api, this.abi, record.event.data[1] as AccountId, this._decorateMethod), this._isRevive
+      )
+      )
+    );
+  };
+}
+
+export function extendBlueprint <ApiType extends ApiTypes> (type: ApiType, decorateMethod: DecorateMethod<ApiType>): BlueprintConstructor<ApiType> {
+  return class extends Blueprint<ApiType> {
+    static __BlueprintType = type;
+
+    constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, codeHash: string | Hash | Uint8Array) {
+      super(api, abi, codeHash, decorateMethod);
+    }
+  };
+}

package/build-deno/base/Code.ts

@@ -0,0 +1,140 @@
+import { Buffer } from 'node:buffer';
+
+
+import type { ApiBase } from 'https://deno.land/x/pezkuwi/api/base/index.ts';
+import type { SubmittableExtrinsic } from 'https://deno.land/x/pezkuwi/api/submittable/types.ts';
+import type { ApiTypes, DecorateMethod } from 'https://deno.land/x/pezkuwi/api/types/index.ts';
+import type { AccountId, EventRecord } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { ISubmittableResult } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+import type { Codec } from 'https://deno.land/x/pezkuwi/types-codec/types/index.ts';
+import type { Abi } from '../Abi/index.ts';
+import type { AbiConstructor, BlueprintOptions } from '../types.ts';
+import type { MapConstructorExec } from './types.ts';
+
+import { SubmittableResult } from 'https://deno.land/x/pezkuwi/api/mod.ts';
+import { BN_ZERO, compactAddLength, isRiscV, isUndefined, isWasm, u8aToU8a } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+import { applyOnEvent } from '../util.ts';
+import { Base } from './Base.ts';
+import { Blueprint } from './Blueprint.ts';
+import { Contract } from './Contract.ts';
+import { convertWeight, createBluePrintTx, encodeSalt } from './util.ts';
+
+export type CodeConstructor<ApiType extends ApiTypes> = new(api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, wasm: Uint8Array | string | Buffer | null | undefined) => Code<ApiType>;
+
+export class CodeSubmittableResult<ApiType extends ApiTypes> extends SubmittableResult {
+  readonly blueprint?: Blueprint<ApiType> | undefined;
+  readonly contract?: Contract<ApiType> | undefined;
+
+  constructor (result: ISubmittableResult, blueprint?: Blueprint<ApiType> | undefined, contract?: Contract<ApiType> | undefined) {
+    super(result);
+
+    this.blueprint = blueprint;
+    this.contract = contract;
+  }
+}
+
+function isValidCode (code: Uint8Array): boolean {
+  return isWasm(code) || isRiscV(code);
+}
+
+export class Code<ApiType extends ApiTypes> extends Base<ApiType> {
+  readonly code: Uint8Array;
+
+  readonly #tx: MapConstructorExec<ApiType> = {};
+
+  constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, wasm: Uint8Array | string | Buffer | null | undefined, decorateMethod: DecorateMethod<ApiType>) {
+    super(api, abi, decorateMethod);
+
+    this.code = isValidCode(this.abi.info.source.wasm)
+      ? this.abi.info.source.wasm
+      : u8aToU8a(wasm);
+
+    if (!isValidCode(this.code)) {
+      throw new Error('Invalid code provided');
+    }
+
+    this.abi.constructors.forEach((c): void => {
+      if (isUndefined(this.#tx[c.method])) {
+        this.#tx[c.method] = createBluePrintTx(c, (o, p) => this.#instantiate(c, o, p));
+      }
+    });
+  }
+
+  public get tx (): MapConstructorExec<ApiType> {
+    return this.#tx;
+  }
+
+  #instantiate = (constructorOrId: AbiConstructor | string | number, { gasLimit = BN_ZERO, salt, storageDepositLimit = null, value = BN_ZERO }: BlueprintOptions, params: unknown[]): SubmittableExtrinsic<ApiType, CodeSubmittableResult<ApiType>> => {
+    const palletTx = this._isRevive ? this.api.tx.revive : this.api.tx.contracts;
+
+    if (this._isRevive) {
+      return palletTx.instantiateWithCode(
+        value,
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore jiggle v1 weights, metadata points to latest
+        this._isWeightV1
+          ? convertWeight(gasLimit).v1Weight
+          : convertWeight(gasLimit).v2Weight,
+        storageDepositLimit,
+        compactAddLength(this.code),
+        this.abi.findConstructor(constructorOrId).toU8a(params),
+        encodeSalt(salt)
+      ).withResultTransform((result: ISubmittableResult) =>
+        new CodeSubmittableResult(
+          result,
+          ...(applyOnEvent(result, ['Instantiated'], (records: EventRecord[]) =>
+            records.reduce<[Blueprint<ApiType> | undefined, Contract<ApiType> | undefined]>(
+              ([blueprint, contract], { event }) =>
+                this.api.events.revive['Instantiated'].is(event)
+                  ? [
+                    blueprint,
+                    new Contract<ApiType>(
+                      this.api,
+                      this.abi,
+                      (event as unknown as { data: [Codec, AccountId] }).data[1],
+                      this._decorateMethod
+                    )
+                  ]
+                  : [blueprint, contract],
+              [undefined, undefined]
+            ), this._isRevive
+          ) || [undefined, undefined])
+        )
+      );
+    }
+
+    return palletTx.instantiateWithCode(
+      value,
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore jiggle v1 weights, metadata points to latest
+      this._isWeightV1
+        ? convertWeight(gasLimit).v1Weight
+        : convertWeight(gasLimit).v2Weight,
+      storageDepositLimit,
+      compactAddLength(this.code),
+      this.abi.findConstructor(constructorOrId).toU8a(params),
+      encodeSalt(salt)
+    ).withResultTransform((result: ISubmittableResult) =>
+      new CodeSubmittableResult(result, ...(applyOnEvent(result, ['CodeStored', 'Instantiated'], (records: EventRecord[]) =>
+        records.reduce<[Blueprint<ApiType> | undefined, Contract<ApiType> | undefined]>(([blueprint, contract], { event }) =>
+          this.api.events.contracts.Instantiated.is(event)
+            ? [blueprint, new Contract<ApiType>(this.api, this.abi, (event as unknown as { data: [Codec, AccountId] }).data[1], this._decorateMethod)]
+            : this.api.events.contracts.CodeStored.is(event)
+              ? [new Blueprint<ApiType>(this.api, this.abi, (event as unknown as { data: [AccountId] }).data[0], this._decorateMethod), contract]
+              : [blueprint, contract],
+        [undefined, undefined]), this._isRevive
+      ) || [undefined, undefined]))
+    );
+  };
+}
+
+export function extendCode <ApiType extends ApiTypes> (type: ApiType, decorateMethod: DecorateMethod<ApiType>): CodeConstructor<ApiType> {
+  return class extends Code<ApiType> {
+    static __CodeType = type;
+
+    constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, wasm: Uint8Array | string | Buffer | null | undefined) {
+      super(api, abi, wasm, decorateMethod);
+    }
+  };
+}

package/build-deno/base/Contract.ts

@@ -0,0 +1,194 @@
+
+import type { ApiBase } from 'https://deno.land/x/pezkuwi/api/base/index.ts';
+import type { SubmittableExtrinsic } from 'https://deno.land/x/pezkuwi/api/submittable/types.ts';
+import type { ApiTypes, DecorateMethod } from 'https://deno.land/x/pezkuwi/api/types/index.ts';
+import type { AccountId, AccountId20, ContractExecResult, EventRecord, Weight, WeightV2 } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { ISubmittableResult } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+import type { Abi } from '../Abi/index.ts';
+import type { AbiMessage, ContractCallOutcome, ContractOptions, DecodedEvent, WeightAll } from '../types.ts';
+import type { ContractCallResult, ContractCallSend, ContractQuery, ContractTx, MapMessageQuery, MapMessageTx } from './types.ts';
+
+import { map } from 'https://esm.sh/rxjs@7.8.1';
+
+import { SubmittableResult } from 'https://deno.land/x/pezkuwi/api/mod.ts';
+import { BN, BN_HUNDRED, BN_ONE, BN_ZERO, isUndefined, logger } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+import { applyOnEvent } from '../util.ts';
+import { Base } from './Base.ts';
+import { convertWeight, withMeta } from './util.ts';
+
+export type ContractConstructor<ApiType extends ApiTypes> = new(api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, address: string | AccountId) => Contract<ApiType>;
+
+const MAX_CALL_GAS = new BN(5_000_000_000_000).isub(BN_ONE);
+
+const l = logger('Contract');
+
+function createQuery <ApiType extends ApiTypes> (meta: AbiMessage, fn: (origin: string | AccountId | Uint8Array, options: ContractOptions, params: unknown[]) => ContractCallResult<ApiType, ContractCallOutcome>): ContractQuery<ApiType> {
+  return withMeta(meta, (origin: string | AccountId | Uint8Array, options: ContractOptions, ...params: unknown[]): ContractCallResult<ApiType, ContractCallOutcome> =>
+    fn(origin, options, params)
+  );
+}
+
+function createTx <ApiType extends ApiTypes> (meta: AbiMessage, fn: (options: ContractOptions, params: unknown[]) => SubmittableExtrinsic<ApiType>): ContractTx<ApiType> {
+  return withMeta(meta, (options: ContractOptions, ...params: unknown[]): SubmittableExtrinsic<ApiType> =>
+    fn(options, params)
+  );
+}
+
+export class ContractSubmittableResult extends SubmittableResult {
+  readonly contractEvents?: DecodedEvent[] | undefined;
+
+  constructor (result: ISubmittableResult, contractEvents?: DecodedEvent[]) {
+    super(result);
+
+    this.contractEvents = contractEvents;
+  }
+}
+
+export class Contract<ApiType extends ApiTypes> extends Base<ApiType> {
+  /**
+   * @description The on-chain address for this contract
+   */
+  readonly address: AccountId | AccountId20;
+
+  readonly #query: MapMessageQuery<ApiType> = {};
+  readonly #tx: MapMessageTx<ApiType> = {};
+
+  constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, address: string | AccountId | AccountId20, decorateMethod: DecorateMethod<ApiType>) {
+    super(api, abi, decorateMethod);
+
+    this.address = this.registry.createType(this._isRevive ? 'AccountId20' : 'AccountId', address);
+
+    this.abi.messages.forEach((m): void => {
+      if (isUndefined(this.#tx[m.method])) {
+        this.#tx[m.method] = createTx(m, (o, p) => this.#exec(m, o, p));
+      }
+
+      if (isUndefined(this.#query[m.method])) {
+        this.#query[m.method] = createQuery(m, (f, o, p) => this.#read(m, o, p).send(f));
+      }
+    });
+  }
+
+  public get query (): MapMessageQuery<ApiType> {
+    return this.#query;
+  }
+
+  public get tx (): MapMessageTx<ApiType> {
+    return this.#tx;
+  }
+
+  #getGas = (_gasLimit: bigint | BN | string | number | WeightV2, isCall = false): WeightAll => {
+    const weight = convertWeight(_gasLimit);
+
+    if (weight.v1Weight.gt(BN_ZERO)) {
+      return weight;
+    }
+
+    return convertWeight(
+      isCall
+        ? MAX_CALL_GAS
+        : convertWeight(
+          this.api.consts.system.blockWeights
+            ? (this.api.consts.system.blockWeights as unknown as { maxBlock: WeightV2 }).maxBlock
+            : this.api.consts.system['maximumBlockWeight'] as Weight
+        ).v1Weight.muln(64).div(BN_HUNDRED)
+    );
+  };
+
+  #exec = (messageOrId: AbiMessage | string | number, { gasLimit = BN_ZERO, storageDepositLimit = null, value = BN_ZERO }: ContractOptions, params: unknown[]): SubmittableExtrinsic<ApiType> => {
+    const palletTx = this._isRevive ? this.api.tx.revive : this.api.tx.contracts;
+
+    return palletTx.call(
+      this.address,
+      value,
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore jiggle v1 weights, metadata points to latest
+      this._isWeightV1
+        ? convertWeight(gasLimit).v1Weight
+        : convertWeight(gasLimit).v2Weight,
+      storageDepositLimit,
+      this.abi.findMessage(messageOrId).toU8a(params)
+    ).withResultTransform((result: ISubmittableResult) =>
+      // ContractEmitted is the current generation, ContractExecution is the previous generation
+      new ContractSubmittableResult(result, applyOnEvent(result, ['ContractEmitted', 'ContractExecution'], (records: EventRecord[]) =>
+        records
+          // Filter to only decode events emitted by this specific contract instance.
+          .filter((record): boolean => {
+            try {
+              const contractAddress = record.event.data[0];
+
+              if (this.address.eq(contractAddress)) {
+                return true;
+              }
+
+              l.debug(`Skipping event from different contract ${contractAddress.toString()} (this contract: ${this.address.toString()})`);
+
+              return false;
+            } catch (error) {
+              l.warn(`Unable to extract contract address from event: ${(error as Error).message}`);
+
+              return false;
+            }
+          })
+          .map((record): DecodedEvent | null => {
+            try {
+              return this.abi.decodeEvent(record);
+            } catch (error) {
+              l.error(`Unable to decode contract event: ${(error as Error).message}`);
+
+              return null;
+            }
+          })
+          .filter((decoded): decoded is DecodedEvent => !!decoded), this._isRevive
+      ))
+    );
+  };
+
+  #read = (messageOrId: AbiMessage | string | number, { gasLimit = BN_ZERO, storageDepositLimit = null, value = BN_ZERO }: ContractOptions, params: unknown[]): ContractCallSend<ApiType> => {
+    const message = this.abi.findMessage(messageOrId);
+
+    return {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+      send: this._decorateMethod((origin: string | AccountId | Uint8Array) =>
+        (this._isRevive
+          ? this.api.rx.call.reviveApi.call
+          : this.api.rx.call.contractsApi.call)<ContractExecResult>(
+          origin,
+          this.address,
+          value,
+          // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+          // @ts-ignore jiggle v1 weights, metadata points to latest
+          this._isWeightV1
+            ? this.#getGas(gasLimit, true).v1Weight
+            : this.#getGas(gasLimit, true).v2Weight,
+          storageDepositLimit,
+          message.toU8a(params)
+        ).pipe(
+          map(({ debugMessage, gasConsumed, gasRequired, result, storageDeposit }): ContractCallOutcome => ({
+            debugMessage,
+            gasConsumed,
+            gasRequired: gasRequired && !convertWeight(gasRequired).v1Weight.isZero()
+              ? gasRequired
+              : gasConsumed,
+            output: result.isOk && message.returnType
+              ? this.abi.registry.createTypeUnsafe(message.returnType.lookupName || message.returnType.type, [result.asOk.data.toU8a(true)], { isPedantic: true })
+              : null,
+            result,
+            storageDeposit
+          }))
+        )
+      )
+    };
+  };
+}
+
+export function extendContract <ApiType extends ApiTypes> (type: ApiType, decorateMethod: DecorateMethod<ApiType>): ContractConstructor<ApiType> {
+  return class extends Contract<ApiType> {
+    static __ContractType = type;
+
+    constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, address: string | AccountId) {
+      super(api, abi, address, decorateMethod);
+    }
+  };
+}

package/build-deno/base/index.ts

@@ -0,0 +1,4 @@
+
+export { Blueprint, BlueprintSubmittableResult, extendBlueprint } from './Blueprint.ts';
+export { Code, CodeSubmittableResult, extendCode } from './Code.ts';
+export { Contract, extendContract } from './Contract.ts';

package/build-deno/base/mock.ts

@@ -0,0 +1,46 @@
+
+import type { ApiBase } from 'https://deno.land/x/pezkuwi/api/base/index.ts';
+
+import { TypeRegistry } from 'https://deno.land/x/pezkuwi/types/mod.ts';
+
+const registry = new TypeRegistry();
+
+const instantiateWithCode = (): never => {
+  throw new Error('mock');
+};
+
+instantiateWithCode.meta = { args: new Array(6) };
+
+export const mockApi = {
+  call: {
+    contractsApi: {
+      call: (): never => {
+        throw new Error('mock');
+      }
+    }
+  },
+  isConnected: true,
+  registry,
+  tx: {
+    contracts: {
+      instantiateWithCode
+    }
+  }
+} as unknown as ApiBase<'promise'>;
+
+export const mockReviveApi = {
+  call: {
+    reviveApi: {
+      call: (): never => {
+        throw new Error('mock');
+      }
+    }
+  },
+  isConnected: true,
+  registry,
+  tx: {
+    revive: {
+      instantiateWithCode
+    }
+  }
+} as unknown as ApiBase<'promise'>;

package/build-deno/base/types.ts

@@ -0,0 +1,38 @@
+
+import type { Observable } from 'https://esm.sh/rxjs@7.8.1';
+import type { SubmittableExtrinsic } from 'https://deno.land/x/pezkuwi/api/submittable/types.ts';
+import type { ApiTypes, ObsInnerType } from 'https://deno.land/x/pezkuwi/api/types/index.ts';
+import type { AccountId } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { AbiMessage, BlueprintOptions, ContractCallOutcome, ContractOptions } from '../types.ts';
+
+export interface MessageMeta {
+  readonly meta: AbiMessage;
+}
+
+export interface BlueprintDeploy<ApiType extends ApiTypes> extends MessageMeta {
+  (options: BlueprintOptions, ...params: unknown[]): SubmittableExtrinsic<ApiType>;
+}
+
+export interface ContractQuery<ApiType extends ApiTypes> extends MessageMeta {
+  (origin: AccountId | string | Uint8Array, options: ContractOptions, ...params: unknown[]): ContractCallResult<ApiType, ContractCallOutcome>;
+}
+
+export interface ContractTx<ApiType extends ApiTypes> extends MessageMeta {
+  (options: ContractOptions, ...params: unknown[]): SubmittableExtrinsic<ApiType>;
+}
+
+export type ContractGeneric<O, T> = (messageOrId: AbiMessage | string | number, options: O, ...params: unknown[]) => T;
+
+export type ContractCallResult<ApiType extends ApiTypes, T> = ApiType extends 'rxjs'
+  ? Observable<T>
+  : Promise<ObsInnerType<Observable<T>>>;
+
+export interface ContractCallSend<ApiType extends ApiTypes> {
+  send (account: string | AccountId | Uint8Array): ContractCallResult<ApiType, ContractCallOutcome>;
+}
+
+export type MapConstructorExec<ApiType extends ApiTypes> = Record<string, BlueprintDeploy<ApiType>>;
+
+export type MapMessageTx<ApiType extends ApiTypes> = Record<string, ContractTx<ApiType>>;
+
+export type MapMessageQuery<ApiType extends ApiTypes> = Record<string, ContractQuery<ApiType>>;