@pezkuwi/api 16.5.16 → 16.5.18

package/build-deno/submittable/createClass.ts

@@ -0,0 +1,437 @@
+
+/* eslint-disable no-dupe-class-members */
+
+import type { Observable } from 'https://esm.sh/rxjs@7.8.1';
+import type { Address, ApplyExtrinsicResult, Call, Extrinsic, ExtrinsicEra, ExtrinsicStatus, Hash, Header, Index, RuntimeDispatchInfo, SignerPayload } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { Callback, Codec, CodecClass, ISubmittableResult, SignatureOptions } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+import type { Registry } from 'https://deno.land/x/pezkuwi/types-codec/types/index.ts';
+import type { HexString } from 'https://deno.land/x/pezkuwi/util/types.ts';
+import type { ApiBase } from '../base/index.ts';
+import type { ApiInterfaceRx, ApiTypes, PromiseOrObs, SignerResult } from '../types/index.ts';
+import type { AddressOrPair, SignerOptions, SubmittableDryRunResult, SubmittableExtrinsic, SubmittablePaymentResult, SubmittableResultResult, SubmittableResultSubscription } from './types.ts';
+
+import { catchError, first, map, mergeMap, of, switchMap, tap } from 'https://esm.sh/rxjs@7.8.1';
+
+import { identity, isBn, isFunction, isNumber, isString, isU8a, objectSpread } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+import { filterEvents, isKeyringPair } from '../util/index.ts';
+import { SubmittableResult } from './Result.ts';
+
+interface SubmittableOptions<ApiType extends ApiTypes> {
+  api: ApiInterfaceRx;
+  apiType: ApiTypes;
+  blockHash?: Uint8Array | undefined;
+  decorateMethod: ApiBase<ApiType>['_decorateMethod'];
+}
+
+interface UpdateInfo {
+  options: SignatureOptions;
+  updateId: number;
+  signedTransaction: HexString | Uint8Array | null;
+}
+
+interface SignerInfo {
+  id: number;
+  signedTransaction?: HexString | Uint8Array;
+}
+
+function makeEraOptions (api: ApiInterfaceRx, registry: Registry, partialOptions: Partial<SignerOptions>, { header, mortalLength, nonce }: { header: Header | null; mortalLength: number; nonce: Index }): SignatureOptions {
+  if (!header) {
+    if (partialOptions.era && !partialOptions.blockHash) {
+      throw new Error('Expected blockHash to be passed alongside non-immortal era options');
+    }
+
+    if (isNumber(partialOptions.era)) {
+      // since we have no header, it is immortal, remove any option overrides
+      // so we only supply the genesisHash and no era to the construction
+      delete partialOptions.era;
+      delete partialOptions.blockHash;
+    }
+
+    return makeSignOptions(api, partialOptions, { nonce });
+  }
+
+  return makeSignOptions(api, partialOptions, {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    blockHash: header.hash as any,
+    era: registry.createTypeUnsafe<ExtrinsicEra>('ExtrinsicEra', [{
+      current: header.number,
+      period: partialOptions.era || mortalLength
+    }]),
+    nonce
+  });
+}
+
+function makeSignAndSendOptions (partialOptions?: Partial<SignerOptions> | Callback<ISubmittableResult>, statusCb?: Callback<ISubmittableResult>): [Partial<SignerOptions>, Callback<ISubmittableResult> | undefined] {
+  let options: Partial<SignerOptions> = {};
+
+  if (isFunction(partialOptions)) {
+    statusCb = partialOptions;
+  } else {
+    options = objectSpread({}, partialOptions);
+  }
+
+  return [options, statusCb];
+}
+
+function makeSignOptions (api: ApiInterfaceRx, partialOptions: Partial<SignerOptions>, extras: { blockHash?: Hash; era?: ExtrinsicEra; nonce?: Index }): SignatureOptions {
+  return objectSpread(
+    { blockHash: api.genesisHash, genesisHash: api.genesisHash },
+    partialOptions,
+    extras,
+    { runtimeVersion: api.runtimeVersion, signedExtensions: api.registry.signedExtensions, version: api.extrinsicType }
+  );
+}
+
+function optionsOrNonce (partialOptions: Partial<SignerOptions> = {}): Partial<SignerOptions> {
+  return isBn(partialOptions) || isNumber(partialOptions)
+    ? { nonce: partialOptions }
+    : partialOptions;
+}
+
+export function createClass <ApiType extends ApiTypes> ({ api, apiType, blockHash, decorateMethod }: SubmittableOptions<ApiType>): CodecClass<SubmittableExtrinsic<ApiType>> {
+  // an instance of the base extrinsic for us to extend
+  const ExtrinsicBase = api.registry.createClass('Extrinsic');
+  const extrinsicInfoMap = new WeakMap<SubmittableExtrinsic<ApiType>, UpdateInfo>();
+
+  class Submittable extends ExtrinsicBase implements SubmittableExtrinsic<ApiType> {
+    readonly #ignoreStatusCb: boolean;
+
+    #transformResult = identity<ISubmittableResult>;
+
+    constructor (registry: Registry, extrinsic: Call | Extrinsic | Uint8Array | string) {
+      super(registry, extrinsic, { version: api.extrinsicType });
+
+      this.#ignoreStatusCb = apiType === 'rxjs';
+    }
+
+    public get hasDryRun (): boolean {
+      return isFunction(api.rpc.system?.dryRun);
+    }
+
+    public get hasPaymentInfo (): boolean {
+      return isFunction(api.call.transactionPaymentApi?.queryInfo);
+    }
+
+    // dry run an extrinsic
+    public dryRun (account: AddressOrPair, optionsOrHash?: Partial<SignerOptions> | Uint8Array | string): SubmittableDryRunResult<ApiType> {
+      if (!this.hasDryRun) {
+        throw new Error('The system.dryRun RPC call is not available in your environment');
+      }
+
+      if (blockHash || isString(optionsOrHash) || isU8a(optionsOrHash)) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return decorateMethod(
+          () => api.rpc.system.dryRun(this.toHex(), blockHash || optionsOrHash as string)
+        );
+      }
+
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return,@typescript-eslint/no-unsafe-call
+      return decorateMethod(
+        (): Observable<ApplyExtrinsicResult> =>
+          this.#observeSign(account, optionsOrHash).pipe(
+            switchMap(() => api.rpc.system.dryRun(this.toHex()))
+          )
+      )();
+    }
+
+    // calculate the payment info for this transaction (if signed and submitted)
+    public paymentInfo (account: AddressOrPair, optionsOrHash?: Partial<SignerOptions> | Uint8Array | string): SubmittablePaymentResult<ApiType> {
+      if (!this.hasPaymentInfo) {
+        throw new Error('The transactionPaymentApi.queryInfo runtime call is not available in your environment');
+      }
+
+      if (blockHash || isString(optionsOrHash) || isU8a(optionsOrHash)) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return decorateMethod(
+          (): Observable<RuntimeDispatchInfo> =>
+            api.callAt(blockHash || optionsOrHash as string).pipe(
+              switchMap((callAt): Observable<RuntimeDispatchInfo> => {
+                const u8a = this.toU8a();
+
+                return callAt.transactionPaymentApi.queryInfo(u8a, u8a.length);
+              })
+            )
+        );
+      }
+
+      const [allOptions] = makeSignAndSendOptions(optionsOrHash);
+      const address = isKeyringPair(account) ? account.address : account.toString();
+
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return,@typescript-eslint/no-unsafe-call
+      return decorateMethod(
+        (): Observable<RuntimeDispatchInfo> =>
+          api.derive.tx.signingInfo(address, allOptions.nonce, allOptions.era).pipe(
+            first(),
+            switchMap((signingInfo): Observable<RuntimeDispatchInfo> => {
+              // setup our options (same way as in signAndSend)
+              const eraOptions = makeEraOptions(api, this.registry, allOptions, signingInfo);
+              const signOptions = makeSignOptions(api, eraOptions, {});
+
+              // 1. Don't use the internal objects inside the new tx (hence toU8a)
+              // 2. Don't override the data from existing signed extrinsics
+              // 3. Ensure that this object stays intact, with no new sign after operation
+              const u8a = api.tx(this.toU8a()).signFake(address, signOptions).toU8a();
+
+              return api.call.transactionPaymentApi.queryInfo(u8a, u8a.length);
+            })
+          )
+      )();
+    }
+
+    // send with an immediate Hash result
+    public send (): SubmittableResultResult<ApiType>;
+
+    // send with a status callback
+    public send (statusCb: Callback<ISubmittableResult>): SubmittableResultSubscription<ApiType>;
+
+    // send implementation for both immediate Hash and statusCb variants
+    public send (statusCb?: Callback<ISubmittableResult>): SubmittableResultResult<ApiType> | SubmittableResultSubscription<ApiType> {
+      const isSubscription = api.hasSubscriptions && (this.#ignoreStatusCb || !!statusCb);
+      const updatedInfo = extrinsicInfoMap.get(this);
+
+      extrinsicInfoMap.delete(this);
+
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return,@typescript-eslint/no-unsafe-call
+      return decorateMethod(
+        isSubscription
+          ? () => this.#observeSubscribe(updatedInfo)
+          : () => this.#observeSend(updatedInfo)
+      )(statusCb);
+    }
+
+    /**
+     * @description Signs a transaction, returning `this` to allow chaining. E.g.: `signAsync(...).send()`. Like `.signAndSend` this will retrieve the nonce and blockHash to send the tx with.
+    */
+    public signAsync (account: AddressOrPair, partialOptions?: Partial<SignerOptions>): PromiseOrObs<ApiType, this> {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return,@typescript-eslint/no-unsafe-call
+      return decorateMethod(
+        (): Observable<this> =>
+          this.#observeSign(account, partialOptions).pipe(
+            map((info) => {
+              // If we got a full signed transaction from the signer, attach it
+              if (info.signedTransaction) {
+                const extrinsic = new Submittable(api.registry, info.signedTransaction);
+
+                extrinsicInfoMap.set(this, info);
+
+                return extrinsic as this;
+              }
+
+              // Fallback if signer didn’t return signedTransaction
+              return this;
+            })
+          )
+      )();
+    }
+
+    // signAndSend with an immediate Hash result
+    public signAndSend (account: AddressOrPair, partialOptions?: Partial<SignerOptions>): SubmittableResultResult<ApiType>;
+
+    // signAndSend with a subscription, i.e. callback provided
+    public signAndSend (account: AddressOrPair, statusCb: Callback<ISubmittableResult>): SubmittableResultSubscription<ApiType>;
+
+    // signAndSend with options and a callback
+    public signAndSend (account: AddressOrPair, partialOptions: Partial<SignerOptions>, statusCb?: Callback<ISubmittableResult>): SubmittableResultSubscription<ApiType>;
+
+    // signAndSend implementation for all 3 cases above
+    public signAndSend (account: AddressOrPair, partialOptions?: Partial<SignerOptions> | Callback<ISubmittableResult>, optionalStatusCb?: Callback<ISubmittableResult>): SubmittableResultResult<ApiType> | SubmittableResultSubscription<ApiType> {
+      const [options, statusCb] = makeSignAndSendOptions(partialOptions, optionalStatusCb);
+      const isSubscription = api.hasSubscriptions && (this.#ignoreStatusCb || !!statusCb);
+
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return,@typescript-eslint/no-unsafe-call
+      return decorateMethod(
+        (): Observable<Codec> => (
+          this.#observeSign(account, options).pipe(
+            switchMap((info): Observable<ISubmittableResult> | Observable<Hash> =>
+              isSubscription
+                ? this.#observeSubscribe(info)
+                : this.#observeSend(info)
+            )
+          ) as Observable<Codec>) // FIXME This is wrong, SubmittableResult is _not_ a codec
+      )(statusCb);
+    }
+
+    // adds a transform to the result, applied before result is returned
+    withResultTransform (transform: (input: ISubmittableResult) => ISubmittableResult): this {
+      this.#transformResult = transform;
+
+      return this;
+    }
+
+    #observeSign = (account: AddressOrPair, partialOptions?: Partial<SignerOptions>): Observable<UpdateInfo> => {
+      const address = isKeyringPair(account) ? account.address : account.toString();
+      const options = optionsOrNonce(partialOptions);
+
+      return api.derive.tx.signingInfo(address, options.nonce, options.era).pipe(
+        first(),
+        mergeMap(async (signingInfo): Promise<UpdateInfo> => {
+          const eraOptions = makeEraOptions(api, this.registry, options, signingInfo);
+          let updateId = -1;
+          let signedTx = null;
+
+          if (isKeyringPair(account)) {
+            this.sign(account, eraOptions);
+          } else {
+            const result = await this.#signViaSigner(address, eraOptions, signingInfo.header);
+
+            updateId = result.id;
+
+            if (result.signedTransaction) {
+              signedTx = result.signedTransaction;
+            }
+          }
+
+          return { options: eraOptions, signedTransaction: signedTx, updateId };
+        })
+      );
+    };
+
+    #observeStatus = (txHash: Hash, status: ExtrinsicStatus): Observable<ISubmittableResult> => {
+      if (!status.isFinalized && !status.isInBlock) {
+        return of(this.#transformResult(new SubmittableResult({
+          status,
+          txHash
+        })));
+      }
+
+      const blockHash = status.isInBlock
+        ? status.asInBlock
+        : status.asFinalized;
+
+      return api.derive.tx.events(blockHash).pipe(
+        map(({ block, events }): ISubmittableResult =>
+          this.#transformResult(new SubmittableResult({
+            ...filterEvents(txHash, block, events, status),
+            status,
+            txHash
+          }))
+        ),
+        catchError((internalError: Error) =>
+          of(this.#transformResult(new SubmittableResult({
+            internalError,
+            status,
+            txHash
+          })))
+        )
+      );
+    };
+
+    #observeSend = (info?: UpdateInfo): Observable<Hash> => {
+      return api.rpc.author.submitExtrinsic(info?.signedTransaction || this).pipe(
+        tap((hash): void => {
+          this.#updateSigner(hash, info);
+        })
+      );
+    };
+
+    #observeSubscribe = (info?: UpdateInfo): Observable<ISubmittableResult> => {
+      const txHash = this.hash;
+
+      return api.rpc.author.submitAndWatchExtrinsic(info?.signedTransaction || this).pipe(
+        switchMap((status): Observable<ISubmittableResult> =>
+          this.#observeStatus(txHash, status)
+        ),
+        tap((status): void => {
+          this.#updateSigner(status, info);
+        })
+      );
+    };
+
+    #signViaSigner = async (address: Address | string | Uint8Array, options: SignatureOptions, header: Header | null): Promise<SignerInfo> => {
+      const signer = options.signer || api.signer;
+      const allowCallDataAlteration = options.allowCallDataAlteration ?? true;
+
+      if (!signer) {
+        throw new Error('No signer specified, either via api.setSigner or via sign options. You possibly need to pass through an explicit keypair for the origin so it can be used for signing.');
+      }
+
+      const payload = this.registry.createTypeUnsafe<SignerPayload>('SignerPayload', [objectSpread({}, options, {
+        address,
+        blockNumber: header ? header.number : 0,
+        method: this.method
+      })]);
+      let result: SignerResult;
+
+      if (isFunction(signer.signPayload)) {
+        result = await signer.signPayload(payload.toPayload());
+
+        if (result.signedTransaction && !options.withSignedTransaction) {
+          throw new Error('The `signedTransaction` field may not be submitted when `withSignedTransaction` is disabled');
+        }
+
+        if (result.signedTransaction && options.withSignedTransaction) {
+          const ext = this.registry.createTypeUnsafe<Extrinsic>('Extrinsic', [result.signedTransaction]);
+          const newSignerPayload = this.registry.createTypeUnsafe<SignerPayload>('SignerPayload', [objectSpread({}, {
+            address,
+            assetId: ext.assetId && ext.assetId.isSome ? ext.assetId.toHex() : null,
+            blockHash: payload.blockHash,
+            blockNumber: header ? header.number : 0,
+            era: ext.era.toHex(),
+            genesisHash: payload.genesisHash,
+            metadataHash: ext.metadataHash ? ext.metadataHash.toHex() : null,
+            method: ext.method.toHex(),
+            mode: ext.mode ? ext.mode.toHex() : null,
+            nonce: ext.nonce.toHex(),
+            runtimeVersion: payload.runtimeVersion,
+            signedExtensions: payload.signedExtensions,
+            tip: ext.tip ? ext.tip.toHex() : null,
+            version: payload.version
+          })]);
+
+          if (!ext.isSigned) {
+            throw new Error(`When using the signedTransaction field, the transaction must be signed. Recieved isSigned: ${ext.isSigned}`);
+          }
+
+          if (!allowCallDataAlteration) {
+            this.#validateSignedTransaction(payload, ext);
+          }
+
+          // This is only used for signAsync - signAndSend does not need to adjust the super payload or
+          // add the signature.
+          super.addSignature(address, result.signature, newSignerPayload.toPayload());
+
+          return { id: result.id, signedTransaction: result.signedTransaction };
+        }
+      } else if (isFunction(signer.signRaw)) {
+        result = await signer.signRaw(payload.toRaw());
+      } else {
+        throw new Error('Invalid signer interface, it should implement either signPayload or signRaw (or both)');
+      }
+
+      // Here we explicitly call `toPayload()` again instead of working with an object
+      // (reference) as passed to the signer. This means that we are sure that the
+      // payload data is not modified from our inputs, but the signer
+      super.addSignature(address, result.signature, payload.toPayload());
+
+      return { id: result.id };
+    };
+
+    #updateSigner = (status: Hash | ISubmittableResult, info?: UpdateInfo): void => {
+      if (info && (info.updateId !== -1)) {
+        const { options, updateId } = info;
+        const signer = options.signer || api.signer;
+
+        if (signer && isFunction(signer.update)) {
+          signer.update(updateId, status);
+        }
+      }
+    };
+
+    /**
+     * When a signer includes `signedTransaction` within the SignerResult this will validate
+     * specific fields within the signed extrinsic against the original payload that was passed
+     * to the signer.
+     */
+    #validateSignedTransaction = (signerPayload: SignerPayload, signedExt: Extrinsic): void => {
+      const payload = signerPayload.toPayload();
+      const errMsg = (field: string) => `signAndSend: ${field} does not match the original payload`;
+
+      if (payload.method !== signedExt.method.toHex()) {
+        throw new Error(errMsg('call data'));
+      }
+    };
+  }
+
+  return Submittable;
+}

package/build-deno/submittable/createSubmittable.ts

@@ -0,0 +1,17 @@
+
+import type { Call, Extrinsic } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { Registry } from 'https://deno.land/x/pezkuwi/types-codec/types/index.ts';
+import type { ApiBase } from '../base/index.ts';
+import type { ApiInterfaceRx, ApiTypes } from '../types/index.ts';
+import type { SubmittableExtrinsic } from './types.ts';
+
+import { createClass } from './createClass.ts';
+
+type Creator<ApiType extends ApiTypes> = (extrinsic: Call | Uint8Array | string) => SubmittableExtrinsic<ApiType>;
+
+export function createSubmittable<ApiType extends ApiTypes> (apiType: ApiTypes, api: ApiInterfaceRx, decorateMethod: ApiBase<ApiType>['_decorateMethod'], registry?: Registry, blockHash?: Uint8Array): Creator<ApiType> {
+  const Submittable = createClass<ApiType>({ api, apiType, blockHash, decorateMethod });
+
+  return (extrinsic: Call | Extrinsic | Uint8Array | string): SubmittableExtrinsic<ApiType> =>
+    new Submittable(registry || api.registry, extrinsic);
+}

package/build-deno/submittable/index.ts

@@ -0,0 +1,3 @@
+
+export { createSubmittable } from './createSubmittable.ts';
+export { SubmittableResult } from './Result.ts';

package/build-deno/submittable/types.ts

@@ -0,0 +1,2 @@
+
+export type { AddressOrPair, SignerOptions, SubmittableDryRunResult, SubmittableExtrinsic, SubmittablePaymentResult, SubmittableResultResult, SubmittableResultSubscription, SubmittableResultValue } from 'https://deno.land/x/pezkuwi/api-base/types/index.ts';

package/build-deno/test/SingleAccountSigner.ts

@@ -0,0 +1,51 @@
+
+import type { KeyringPair } from 'https://deno.land/x/pezkuwi/keyring/types.ts';
+import type { Registry, SignerPayloadJSON, SignerPayloadRaw } from 'https://deno.land/x/pezkuwi/types/types/index.ts';
+import type { Signer, SignerResult } from '../types/index.ts';
+
+import { hexToU8a, objectSpread, u8aToHex } from 'https://deno.land/x/pezkuwi/util/mod.ts';
+
+let id = 0;
+
+export class SingleAccountSigner implements Signer {
+  readonly #keyringPair: KeyringPair;
+  readonly #registry: Registry;
+  readonly #signDelay: number;
+
+  constructor (registry: Registry, keyringPair: KeyringPair, signDelay = 0) {
+    this.#keyringPair = keyringPair;
+    this.#registry = registry;
+    this.#signDelay = signDelay;
+  }
+
+  public async signPayload (payload: SignerPayloadJSON): Promise<SignerResult> {
+    if (payload.address !== this.#keyringPair.address) {
+      throw new Error('Signer does not have the keyringPair');
+    }
+
+    return new Promise((resolve): void => {
+      setTimeout((): void => {
+        const signed = this.#registry.createType('ExtrinsicPayload', payload, { version: payload.version }).sign(this.#keyringPair);
+
+        resolve(objectSpread({ id: ++id }, signed));
+      }, this.#signDelay);
+    });
+  }
+
+  public async signRaw ({ address, data }: SignerPayloadRaw): Promise<SignerResult> {
+    if (address !== this.#keyringPair.address) {
+      throw new Error('Signer does not have the keyringPair');
+    }
+
+    return new Promise((resolve): void => {
+      setTimeout((): void => {
+        const signature = u8aToHex(this.#keyringPair.sign(hexToU8a(data)));
+
+        resolve({
+          id: ++id,
+          signature
+        });
+      }, this.#signDelay);
+    });
+  }
+}

package/build-deno/test/index.ts

@@ -0,0 +1,3 @@
+
+export * from './logEvents.ts';
+export * from './SingleAccountSigner.ts';

package/build-deno/test/logEvents.ts

@@ -0,0 +1,21 @@
+
+import type { EventRecord } from 'https://deno.land/x/pezkuwi/types/interfaces/index.ts';
+import type { SubmittableResult } from '../index.ts';
+
+export const logEvents = (done: () => Record<string, unknown>): (r: SubmittableResult) => void =>
+  ({ events, status }: SubmittableResult): void => {
+    console.log('Transaction status:', status.type);
+
+    if (status.isInBlock) {
+      console.log('Completed at block hash', status.value.toHex());
+      console.log('Events:');
+
+      events.forEach(({ event: { data, method, section }, phase }: EventRecord): void => {
+        console.log('\t', phase.toString(), `: ${section}.${method}`, data.toString());
+      });
+
+      if (events.length) {
+        done();
+      }
+    }
+  };

package/build-deno/types/calls.ts

@@ -0,0 +1,2 @@
+
+export * from 'https://deno.land/x/pezkuwi/api-base/types/calls.ts';

package/build-deno/types/consts.ts

@@ -0,0 +1,2 @@
+
+export * from 'https://deno.land/x/pezkuwi/api-base/types/consts.ts';

package/build-deno/types/errors.ts

@@ -0,0 +1,2 @@
+
+export * from 'https://deno.land/x/pezkuwi/api-base/types/errors.ts';

package/build-deno/types/events.ts

@@ -0,0 +1,2 @@
+
+export * from 'https://deno.land/x/pezkuwi/api-base/types/events.ts';