@pezkuwi/api-derive 16.5.5 → 16.5.6

package/tx/extrinsicInfo.d.ts

@@ -0,0 +1,61 @@
+import type { Observable } from 'rxjs';
+import type { GenericExtrinsic } from '@pezkuwi/types';
+import type { EventRecord, Hash } from '@pezkuwi/types/interfaces';
+import type { DeriveApi } from '../types.js';
+interface ExtrinsicInfo {
+    blockHash: Hash | string;
+    blockNumber: number;
+    extrinsic: GenericExtrinsic;
+    events: EventRecord[];
+    success: boolean;
+}
+interface ExtrinsicsInfo {
+    blockHash: Hash | string;
+    blockNumber: number;
+    extrinsics: {
+        events: EventRecord[];
+        extrinsic: GenericExtrinsic;
+        success: boolean;
+    }[];
+}
+/**
+ * @name extrinsicInfo
+ * @param { Hash } at The block hash to query at.
+ * @param { Uint8Array | string } transactionHash A transaction hash as U8 array or string.
+ * @description Retrieves the extrinsic information and its events.
+ * @example
+ * ```javascript
+ * const blockHash = api.registry.createType(
+ *   'Hash',
+ *   '0xb772e4949d2f3eb5ba356aa43f885cc4f9097ee9812c5436543f3846a0491729'
+ * );
+ * const extrinsicInfo = await api.derive.tx.extrinsicInfo(
+ *   blockHash,
+ *   '0xcd96520b05e0c4648ea365f3f063f27c5cdd8be10d41a1c44566428c91f37dcb'
+ * );
+ *
+ * console.log(extrinsicInfo.extrinsic.toHuman());
+ * ```
+ */
+export declare function extrinsicInfo(instanceId: string, api: DeriveApi): (at: Hash, transactionHash: Uint8Array | string) => Observable<ExtrinsicInfo | null>;
+/**
+ * @name accountExtrinsics
+ * @description Retrieves information about every extrinsic submitted by an account at a given block.
+ * @param { Hash } at The block hash to query at.
+ * @param { Uint8Array | strings } accountId The account identifier to query.
+ * @example
+ * ```javascript
+   const blockHash = api.registry.createType(
+    'Hash',
+    '0xb772e4949d2f3eb5ba356aa43f885cc4f9097ee9812c5436543f3846a0491729'
+  );
+  const extrinsicsInfo = await api.derive.tx.accountExtrinsics(
+    blockHash,
+    '0x21895DdfD4640b4e0aDCa2865b907f2CE6e6B777'
+  );
+
+  console.log(extrinsicsInfo.extrinsics[0]).extrinsic.toHuman();
+ * ```
+ */
+export declare function accountExtrinsics(instanceId: string, api: DeriveApi): (at: Hash, accountId: Uint8Array | string) => Observable<ExtrinsicsInfo>;
+export {};

package/tx/extrinsicInfo.js

@@ -0,0 +1,83 @@
+import { map } from 'rxjs';
+import { memo } from '../util/index.js';
+/**
+ * @name extrinsicInfo
+ * @param { Hash } at The block hash to query at.
+ * @param { Uint8Array | string } transactionHash A transaction hash as U8 array or string.
+ * @description Retrieves the extrinsic information and its events.
+ * @example
+ * ```javascript
+ * const blockHash = api.registry.createType(
+ *   'Hash',
+ *   '0xb772e4949d2f3eb5ba356aa43f885cc4f9097ee9812c5436543f3846a0491729'
+ * );
+ * const extrinsicInfo = await api.derive.tx.extrinsicInfo(
+ *   blockHash,
+ *   '0xcd96520b05e0c4648ea365f3f063f27c5cdd8be10d41a1c44566428c91f37dcb'
+ * );
+ *
+ * console.log(extrinsicInfo.extrinsic.toHuman());
+ * ```
+ */
+export function extrinsicInfo(instanceId, api) {
+    return memo(instanceId, (at, transactionHash) => {
+        return api.derive.tx.events(at).pipe(map(({ block, events }) => {
+            const index = block.block.extrinsics.findIndex((ext) => ext.hash.toString() === transactionHash);
+            if (index === -1) {
+                return null;
+            }
+            const extEvents = events.filter(({ phase }) => phase.isApplyExtrinsic && phase.asApplyExtrinsic.eq(index));
+            return {
+                blockHash: block.hash.toHex(),
+                blockNumber: block.block.header.number.toNumber(),
+                events: extEvents,
+                extrinsic: block.block.extrinsics[index],
+                success: (extEvents.findIndex((ev) => ev.event.method === 'ExtrinsicSuccess') !== -1)
+            };
+        }));
+    });
+}
+/**
+ * @name accountExtrinsics
+ * @description Retrieves information about every extrinsic submitted by an account at a given block.
+ * @param { Hash } at The block hash to query at.
+ * @param { Uint8Array | strings } accountId The account identifier to query.
+ * @example
+ * ```javascript
+   const blockHash = api.registry.createType(
+    'Hash',
+    '0xb772e4949d2f3eb5ba356aa43f885cc4f9097ee9812c5436543f3846a0491729'
+  );
+  const extrinsicsInfo = await api.derive.tx.accountExtrinsics(
+    blockHash,
+    '0x21895DdfD4640b4e0aDCa2865b907f2CE6e6B777'
+  );
+
+  console.log(extrinsicsInfo.extrinsics[0]).extrinsic.toHuman();
+ * ```
+ */
+export function accountExtrinsics(instanceId, api) {
+    return memo(instanceId, (at, accountId) => {
+        return api.derive.tx.events(at).pipe(map(({ block, events }) => {
+            const indexes = [];
+            return {
+                blockHash: block.hash.toHex(),
+                blockNumber: block.block.header.number.toNumber(),
+                extrinsics: block.block.extrinsics.filter((ext, index) => {
+                    if (ext.signer.toString() === accountId) {
+                        indexes.push(index);
+                        return true;
+                    }
+                    return false;
+                }).map((ext, i) => {
+                    const extEvents = events.filter(({ phase }) => phase.isApplyExtrinsic && phase.asApplyExtrinsic.eq(indexes[i]));
+                    return {
+                        events: extEvents,
+                        extrinsic: ext,
+                        success: (extEvents.findIndex((ev) => ev.event.method === 'ExtrinsicSuccess') !== -1)
+                    };
+                })
+            };
+        }));
+    });
+}

package/tx/index.d.ts

@@ -0,0 +1,3 @@
+export * from './events.js';
+export * from './extrinsicInfo.js';
+export * from './signingInfo.js';

package/tx/index.js

@@ -0,0 +1,3 @@
+export * from './events.js';
+export * from './extrinsicInfo.js';
+export * from './signingInfo.js';

package/tx/signingInfo.d.ts

@@ -0,0 +1,25 @@
+import type { Observable } from 'rxjs';
+import type { Header, Index } from '@pezkuwi/types/interfaces';
+import type { AnyNumber, Codec, IExtrinsicEra } from '@pezkuwi/types/types';
+import type { DeriveApi } from '../types.js';
+interface Result {
+    header: Header | null;
+    mortalLength: number;
+    nonce: Index;
+}
+/**
+ * @name signingInfo
+ * @description Retrieves signing-related information for an account, including the nonce, block header, and mortal length.
+ * @param {string} address The account address for which signing information is needed.
+ * @param { BN | bigint | Uint8Array | number | string } nonce? (Optional) The nonce to use. If `undefined`, the latest nonce is retrieved.
+ * @param { IExtrinsicEra | number } era? (Optional) The transaction era.
+ * @example
+ * ```javascript
+ * const info = await api.derive.tx.signingInfo(
+ *   "14mM9FRDDtwSYicjNxSvMfQkap8o4m9zHq7hNW4JpbSL4PPU"
+ * );
+ * console.log(info);
+ * ```
+ */
+export declare function signingInfo(_instanceId: string, api: DeriveApi): (address: string, nonce?: AnyNumber | Codec, era?: IExtrinsicEra | number) => Observable<Result>;
+export {};

package/tx/signingInfo.js

@@ -0,0 +1,78 @@
+import { catchError, combineLatest, map, of, switchMap } from 'rxjs';
+import { isNumber, isUndefined } from '@pezkuwi/util';
+import { unwrapBlockNumber } from '../util/index.js';
+import { FALLBACK_MAX_HASH_COUNT, FALLBACK_PERIOD, MAX_FINALITY_LAG, MORTAL_PERIOD } from './constants.js';
+function latestNonce(api, address) {
+    return api.derive.balances.account(address).pipe(map(({ accountNonce }) => accountNonce));
+}
+function nextNonce(api, address) {
+    if (api.call.accountNonceApi) {
+        return api.call.accountNonceApi.accountNonce(address);
+    }
+    else {
+        return api.rpc.system?.accountNextIndex
+            ? api.rpc.system.accountNextIndex(address)
+            : latestNonce(api, address);
+    }
+}
+function signingHeader(api) {
+    return combineLatest([
+        api.rpc.chain.getHeader().pipe(switchMap((header) => 
+        // check for chains at genesis (until block 1 is produced, e.g. 6s), since
+        // we do need to allow transactions at chain start (also dev/seal chains)
+        header.parentHash.isEmpty
+            ? of(header)
+            // in the case of the current block, we use the parent to minimize the
+            // impact of forks on the system, but not completely remove it
+            : api.rpc.chain.getHeader(header.parentHash).pipe(catchError(() => of(header))))),
+        api.rpc.chain.getFinalizedHead().pipe(switchMap((hash) => api.rpc.chain.getHeader(hash).pipe(catchError(() => of(null)))))
+    ]).pipe(map(([current, finalized]) => 
+    // determine the hash to use, current when lag > max, else finalized
+    !finalized || unwrapBlockNumber(current).sub(unwrapBlockNumber(finalized)).gt(MAX_FINALITY_LAG)
+        ? current
+        : finalized));
+}
+function babeOrAuraPeriod(api) {
+    const period = api.consts.babe?.expectedBlockTime ||
+        // this will be present ones https://github.com/pezkuwichain/pezkuwi-sdk/pull/3732 is merged
+        // eslint-disable-next-line
+        api.consts['aura']?.['slotDuration'] ||
+        api.consts.timestamp?.minimumPeriod.muln(2);
+    return period && period.isZero && !period.isZero() ? period : undefined;
+}
+/**
+ * @name signingInfo
+ * @description Retrieves signing-related information for an account, including the nonce, block header, and mortal length.
+ * @param {string} address The account address for which signing information is needed.
+ * @param { BN | bigint | Uint8Array | number | string } nonce? (Optional) The nonce to use. If `undefined`, the latest nonce is retrieved.
+ * @param { IExtrinsicEra | number } era? (Optional) The transaction era.
+ * @example
+ * ```javascript
+ * const info = await api.derive.tx.signingInfo(
+ *   "14mM9FRDDtwSYicjNxSvMfQkap8o4m9zHq7hNW4JpbSL4PPU"
+ * );
+ * console.log(info);
+ * ```
+ */
+export function signingInfo(_instanceId, api) {
+    // no memo, we want to do this fresh on each run
+    return (address, nonce, era) => combineLatest([
+        // retrieve nonce if none was specified
+        isUndefined(nonce)
+            ? latestNonce(api, address)
+            : nonce === -1
+                ? nextNonce(api, address)
+                : of(api.registry.createType('Index', nonce)),
+        // if no era (create) or era > 0 (mortal), do block retrieval
+        (isUndefined(era) || (isNumber(era) && era > 0))
+            ? signingHeader(api)
+            : of(null)
+    ]).pipe(map(([nonce, header]) => ({
+        header,
+        mortalLength: Math.min(api.consts.system?.blockHashCount?.toNumber() || FALLBACK_MAX_HASH_COUNT, MORTAL_PERIOD
+            .div(babeOrAuraPeriod(api) || FALLBACK_PERIOD)
+            .iadd(MAX_FINALITY_LAG)
+            .toNumber()),
+        nonce
+    })));
+}

package/type/HeaderExtended.d.ts

@@ -0,0 +1,4 @@
+import type { AccountId, Header } from '@pezkuwi/types/interfaces';
+import type { Registry } from '@pezkuwi/types/types';
+import type { HeaderExtended } from './types.js';
+export declare function createHeaderExtended(registry: Registry, header?: Header, validators?: AccountId[] | null, author?: AccountId | null): HeaderExtended;

package/type/HeaderExtended.js

@@ -0,0 +1,20 @@
+import { extractAuthor } from './util.js';
+export function createHeaderExtended(registry, header, validators, author) {
+    // an instance of the base extrinsic for us to extend
+    const HeaderBase = registry.createClass('Header');
+    class Implementation extends HeaderBase {
+        #author;
+        constructor(registry, header, validators, author) {
+            super(registry, header);
+            this.#author = author || extractAuthor(this.digest, validators || []);
+            this.createdAtHash = header?.createdAtHash;
+        }
+        /**
+         * @description Convenience method, returns the author for the block
+         */
+        get author() {
+            return this.#author;
+        }
+    }
+    return new Implementation(registry, header, validators, author);
+}

package/type/SignedBlockExtended.d.ts

@@ -0,0 +1,4 @@
+import type { AccountId, EventRecord, SignedBlock } from '@pezkuwi/types/interfaces';
+import type { Registry } from '@pezkuwi/types/types';
+import type { SignedBlockExtended } from './types.js';
+export declare function createSignedBlockExtended(registry: Registry, block?: SignedBlock, events?: EventRecord[], validators?: AccountId[] | null, author?: AccountId | null): SignedBlockExtended;

package/type/SignedBlockExtended.js

@@ -0,0 +1,57 @@
+import { extractAuthor } from './util.js';
+function mapExtrinsics(extrinsics, records) {
+    return extrinsics.map((extrinsic, index) => {
+        let dispatchError;
+        let dispatchInfo;
+        const events = records
+            .filter(({ phase }) => phase.isApplyExtrinsic && phase.asApplyExtrinsic.eq(index))
+            .map(({ event }) => {
+            if (event.section === 'system') {
+                if (event.method === 'ExtrinsicSuccess') {
+                    dispatchInfo = event.data[0];
+                }
+                else if (event.method === 'ExtrinsicFailed') {
+                    dispatchError = event.data[0];
+                    dispatchInfo = event.data[1];
+                }
+            }
+            return event;
+        });
+        return { dispatchError, dispatchInfo, events, extrinsic };
+    });
+}
+export function createSignedBlockExtended(registry, block, events, validators, author) {
+    // an instance of the base extrinsic for us to extend
+    const SignedBlockBase = registry.createClass('SignedBlock');
+    class Implementation extends SignedBlockBase {
+        #author;
+        #events;
+        #extrinsics;
+        constructor(registry, block, events, validators, author) {
+            super(registry, block);
+            this.#author = author || extractAuthor(this.block.header.digest, validators || []);
+            this.#events = events || [];
+            this.#extrinsics = mapExtrinsics(this.block.extrinsics, this.#events);
+            this.createdAtHash = block?.createdAtHash;
+        }
+        /**
+         * @description Convenience method, returns the author for the block
+         */
+        get author() {
+            return this.#author;
+        }
+        /**
+         * @description Convenience method, returns the events associated with the block
+         */
+        get events() {
+            return this.#events;
+        }
+        /**
+         * @description Returns the extrinsics and their events, mapped
+         */
+        get extrinsics() {
+            return this.#extrinsics;
+        }
+    }
+    return new Implementation(registry, block, events, validators, author);
+}

package/{src/type/index.ts → type/index.d.ts}

@@ -1,5 +1,2 @@
-// Copyright 2017-2025 @polkadot/api-derive authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
 export { createHeaderExtended } from './HeaderExtended.js';
 export { createSignedBlockExtended } from './SignedBlockExtended.js';

package/type/index.js

@@ -0,0 +1,2 @@
+export { createHeaderExtended } from './HeaderExtended.js';
+export { createSignedBlockExtended } from './SignedBlockExtended.js';

package/type/types.d.ts

@@ -0,0 +1,15 @@
+import type { AccountId, DispatchError, DispatchInfo, Event, EventRecord, Extrinsic, Header, SignedBlock } from '@pezkuwi/types/interfaces';
+export interface HeaderExtended extends Header {
+    readonly author: AccountId | undefined;
+}
+export interface SignedBlockExtended extends SignedBlock {
+    readonly author: AccountId | undefined;
+    readonly events: EventRecord[];
+    readonly extrinsics: TxWithEvent[];
+}
+export interface TxWithEvent {
+    dispatchError?: DispatchError | undefined;
+    dispatchInfo?: DispatchInfo | undefined;
+    events: Event[];
+    extrinsic: Extrinsic;
+}

package/type/types.js

@@ -0,0 +1 @@
+export {};

package/type/util.d.ts

@@ -0,0 +1,2 @@
+import type { AccountId, Digest } from '@pezkuwi/types/interfaces';
+export declare function extractAuthor(digest: Digest, sessionValidators: AccountId[]): AccountId | undefined;

package/type/util.js

@@ -0,0 +1,33 @@
+export function extractAuthor(digest, sessionValidators) {
+    const [citem] = digest.logs.filter((e) => e.isConsensus);
+    const preRuntimeItems = digest.logs.filter((e) => e.isPreRuntime);
+    const [sitem] = digest.logs.filter((e) => e.isSeal);
+    let accountId;
+    try {
+        // This is critical to be first for BABE (before Consensus)
+        // If not first, we end up dropping the author at session-end
+        // Iterate through ALL preRuntime logs to find a recognized engine
+        // (teyrchains may have multiple preRuntime logs, e.g., CMLS + aura)
+        for (const pitem of preRuntimeItems) {
+            const [engine, data] = pitem.asPreRuntime;
+            accountId = engine.extractAuthor(data, sessionValidators);
+            // Stop at first recognized engine that returns an author
+            if (accountId) {
+                return accountId;
+            }
+        }
+        if (!accountId && citem) {
+            const [engine, data] = citem.asConsensus;
+            accountId = engine.extractAuthor(data, sessionValidators);
+        }
+        // SEAL, still used in e.g. Kulupu for pow
+        if (!accountId && sitem) {
+            const [engine, data] = sitem.asSeal;
+            accountId = engine.extractAuthor(data, sessionValidators);
+        }
+    }
+    catch {
+        // ignore
+    }
+    return accountId;
+}

package/{src/types.ts → types.d.ts}

@@ -1,13 +1,9 @@
-// Copyright 2017-2025 @polkadot/api-derive authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
 import type { ApiInterfaceRx } from '@pezkuwi/api-base/types';
 import type { u32 } from '@pezkuwi/types';
 import type { Balance, BlockNumber, BountyIndex, Hash, Proposal, ProposalIndex, SetIndex, Votes } from '@pezkuwi/types/interfaces';
-import type { PalletBountiesBounty, PalletTreasuryProposal } from '@pezkuwi/types/lookup';
+import type { PezpalletBountiesBounty, PezpalletTreasuryProposal } from '@pezkuwi/types/lookup';
 import type { BN } from '@pezkuwi/util';
 import type { ExactDerive } from './derive.js';
-
 export * from './accounts/types.js';
 export * from './bagsList/types.js';
 export * from './balances/types.js';
@@ -15,83 +11,69 @@ export * from './council/types.js';
 export * from './crowdloan/types.js';
 export * from './democracy/types.js';
 export * from './elections/types.js';
-export * from './parachains/types.js';
+export * from './teyrchains/types.js';
 export * from './session/types.js';
 export * from './society/types.js';
 export * from './staking/types.js';
 export * from './type/types.js';
-
 export interface DeriveApi extends ApiInterfaceRx {
-  derive: ExactDerive;
+    derive: ExactDerive;
 }
-
 export interface DeriveContractFees {
-  callBaseFee: BN;
-  contractFee: BN;
-  creationFee: BN;
-  rentByteFee: BN;
-  rentDepositOffset: BN;
-  surchargeReward: BN;
-  tombstoneDeposit: BN;
-  transactionBaseFee: BN;
-  transactionByteFee: BN;
-  transferFee: BN;
+    callBaseFee: BN;
+    contractFee: BN;
+    creationFee: BN;
+    rentByteFee: BN;
+    rentDepositOffset: BN;
+    surchargeReward: BN;
+    tombstoneDeposit: BN;
+    transactionBaseFee: BN;
+    transactionByteFee: BN;
+    transferFee: BN;
 }
-
 export interface DeriveCollectiveProposal {
-  hash: Hash;
-  proposal: Proposal | null;
-  votes: Votes | null;
+    hash: Hash;
+    proposal: Proposal | null;
+    votes: Votes | null;
 }
-
 export interface DeriveFees {
-  creationFee: Balance;
-  existentialDeposit: Balance;
-  transactionBaseFee: Balance;
-  transactionByteFee: Balance;
-  transferFee: Balance;
+    creationFee: Balance;
+    existentialDeposit: Balance;
+    transactionBaseFee: Balance;
+    transactionByteFee: Balance;
+    transferFee: Balance;
 }
-
 export interface DeriveHeartbeatAuthor {
-  blockCount: u32;
-  hasMessage: boolean;
-  isOnline: boolean;
+    blockCount: u32;
+    hasMessage: boolean;
+    isOnline: boolean;
 }
-
 export type DeriveHeartbeats = Record<string, DeriveHeartbeatAuthor>;
-
 export interface RecentlyOffline {
-  blockNumber: BlockNumber;
-  count: BN;
+    blockNumber: BlockNumber;
+    count: BN;
 }
-
 export type DeriveRecentlyOffline = Record<string, RecentlyOffline[]>;
-
 export interface DeriveTreasuryProposal {
-  council: DeriveCollectiveProposal[];
-  id: ProposalIndex;
-  proposal: PalletTreasuryProposal;
+    council: DeriveCollectiveProposal[];
+    id: ProposalIndex;
+    proposal: PezpalletTreasuryProposal;
 }
-
 export interface DeriveTreasuryProposals {
-  approvals: DeriveTreasuryProposal[];
-  proposalCount: ProposalIndex;
-  proposals: DeriveTreasuryProposal[];
+    approvals: DeriveTreasuryProposal[];
+    proposalCount: ProposalIndex;
+    proposals: DeriveTreasuryProposal[];
 }
-
 export interface VoterPosition {
-  globalIndex: BN;
-  index: BN;
-  setIndex: SetIndex;
+    globalIndex: BN;
+    index: BN;
+    setIndex: SetIndex;
 }
-
 export type DeriveVoterPositions = Record<string, VoterPosition>;
-
 export interface DeriveBounty {
-  bounty: PalletBountiesBounty;
-  description: string;
-  index: BountyIndex;
-  proposals: DeriveCollectiveProposal[];
+    bounty: PezpalletBountiesBounty;
+    description: string;
+    index: BountyIndex;
+    proposals: DeriveCollectiveProposal[];
 }
-
 export type DeriveBounties = DeriveBounty[];

package/types.js

@@ -0,0 +1,12 @@
+export * from './accounts/types.js';
+export * from './bagsList/types.js';
+export * from './balances/types.js';
+export * from './council/types.js';
+export * from './crowdloan/types.js';
+export * from './democracy/types.js';
+export * from './elections/types.js';
+export * from './teyrchains/types.js';
+export * from './session/types.js';
+export * from './society/types.js';
+export * from './staking/types.js';
+export * from './type/types.js';

package/util/approvalFlagsToBools.d.ts

@@ -0,0 +1,4 @@
+import type { Vec } from '@pezkuwi/types';
+import type { ApprovalFlag } from '@pezkuwi/types/interfaces/elections';
+/** @internal */
+export declare function approvalFlagsToBools(flags: Vec<ApprovalFlag> | ApprovalFlag[]): boolean[];

package/util/approvalFlagsToBools.js

@@ -0,0 +1,16 @@
+/** @internal */
+export function approvalFlagsToBools(flags) {
+    const bools = [];
+    for (let i = 0, count = flags.length; i < count; i++) {
+        const str = flags[i].toString(2);
+        // read from lowest bit to highest
+        for (const bit of str.split('').reverse()) {
+            bools.push(!!parseInt(bit, 10));
+        }
+    }
+    // slice off trailing "false" values, as in bizinikiwi
+    const lastApproval = bools.lastIndexOf(true);
+    return lastApproval >= 0
+        ? bools.slice(0, lastApproval + 1)
+        : [];
+}

package/util/blockNumber.d.ts

@@ -0,0 +1,7 @@
+import type { Compact } from '@pezkuwi/types';
+import type { BlockNumber } from '@pezkuwi/types/interfaces';
+interface CompatHeader {
+    number: Compact<BlockNumber> | BlockNumber;
+}
+export declare function unwrapBlockNumber(hdr: CompatHeader): BlockNumber;
+export {};

package/util/blockNumber.js

@@ -0,0 +1,6 @@
+import { isCompact } from '@pezkuwi/util';
+export function unwrapBlockNumber(hdr) {
+    return isCompact(hdr.number)
+        ? hdr.number.unwrap()
+        : hdr.number;
+}

package/util/cache.d.ts

@@ -0,0 +1,4 @@
+import type { DeriveCache } from './types.js';
+declare let deriveCache: DeriveCache;
+export declare function setDeriveCache(prefix?: string, cache?: DeriveCache): void;
+export { deriveCache };

package/util/cache.js

@@ -0,0 +1,42 @@
+import { deriveNoopCache } from './cacheImpl.js';
+const CACHE_EXPIRY = 7 * (24 * 60) * (60 * 1000);
+let deriveCache;
+function wrapCache(keyStart, cache) {
+    return {
+        del: (partial) => cache.del(`${keyStart}${partial}`),
+        forEach: cache.forEach,
+        get: (partial) => {
+            const key = `${keyStart}${partial}`;
+            const cached = cache.get(key);
+            if (cached) {
+                cached.x = Date.now();
+                cache.set(key, cached);
+                return cached.v;
+            }
+            return undefined;
+        },
+        set: (partial, v) => {
+            cache.set(`${keyStart}${partial}`, { v, x: Date.now() });
+        }
+    };
+}
+function clearCache(cache) {
+    // clear all expired values
+    const now = Date.now();
+    const all = [];
+    cache.forEach((key, { x }) => {
+        ((now - x) > CACHE_EXPIRY) && all.push(key);
+    });
+    // don't do delete inside loop, just in-case
+    all.forEach((key) => cache.del(key));
+}
+export function setDeriveCache(prefix = '', cache) {
+    deriveCache = cache
+        ? wrapCache(`derive:${prefix}:`, cache)
+        : deriveNoopCache;
+    if (cache) {
+        clearCache(cache);
+    }
+}
+setDeriveCache();
+export { deriveCache };

package/util/cacheImpl.d.ts

@@ -0,0 +1,3 @@
+import type { DeriveCache } from './types.js';
+export declare const deriveMapCache: DeriveCache;
+export declare const deriveNoopCache: DeriveCache;