@pezkuwi/api-derive 16.5.6 → 16.5.8

package/build-tsc-cjs/balances/account.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.account = account;
+const rxjs_1 = require("rxjs");
+const util_1 = require("@pezkuwi/util");
+const index_js_1 = require("../util/index.js");
+function zeroBalance(api) {
+    return api.registry.createType('Balance');
+}
+function getBalance(api, [freeBalance, reservedBalance, frozenFeeOrFrozen, frozenMiscOrFlags], accType) {
+    const votingBalance = api.registry.createType('Balance', freeBalance.toBn());
+    if (accType.isFrameAccountData) {
+        return {
+            frameSystemAccountInfo: {
+                flags: frozenMiscOrFlags,
+                frozen: frozenFeeOrFrozen
+            },
+            freeBalance,
+            frozenFee: api.registry.createType('Balance', 0),
+            frozenMisc: api.registry.createType('Balance', 0),
+            reservedBalance,
+            votingBalance
+        };
+    }
+    return {
+        freeBalance,
+        frozenFee: frozenFeeOrFrozen,
+        frozenMisc: frozenMiscOrFlags,
+        reservedBalance,
+        votingBalance
+    };
+}
+function calcBalances(api, [accountId, [accountNonce, [primary, ...additional], accType]]) {
+    return (0, util_1.objectSpread)({
+        accountId,
+        accountNonce,
+        additional: additional.map((b) => getBalance(api, b, accType))
+    }, getBalance(api, primary, accType));
+}
+function queryBalancesFree(api, accountId) {
+    return (0, rxjs_1.combineLatest)([
+        api.query.balances['freeBalance'](accountId),
+        api.query.balances['reservedBalance'](accountId),
+        api.query.system['accountNonce'](accountId)
+    ]).pipe((0, rxjs_1.map)(([freeBalance, reservedBalance, accountNonce]) => [
+        accountNonce,
+        [[freeBalance, reservedBalance, zeroBalance(api), zeroBalance(api)]],
+        { isFrameAccountData: false }
+    ]));
+}
+function queryNonceOnly(api, accountId) {
+    const fill = (nonce) => [
+        nonce,
+        [[zeroBalance(api), zeroBalance(api), zeroBalance(api), zeroBalance(api)]],
+        { isFrameAccountData: false }
+    ];
+    return (0, util_1.isFunction)(api.query.system.account)
+        ? api.query.system.account(accountId).pipe((0, rxjs_1.map)(({ nonce }) => fill(nonce)))
+        : (0, util_1.isFunction)(api.query.system['accountNonce'])
+            ? api.query.system['accountNonce'](accountId).pipe((0, rxjs_1.map)((nonce) => fill(nonce)))
+            : (0, rxjs_1.of)(fill(api.registry.createType('Index')));
+}
+function queryBalancesAccount(api, accountId, modules = ['balances']) {
+    const balances = modules
+        .map((m) => api.derive[m]?.customAccount || api.query[m]?.account)
+        .filter((q) => (0, util_1.isFunction)(q));
+    const extract = (nonce, data) => [
+        nonce,
+        data.map(({ feeFrozen, free, miscFrozen, reserved }) => [free, reserved, feeFrozen, miscFrozen]),
+        { isFrameAccountData: false }
+    ];
+    // NOTE this is for the first case where we do have instances specified
+    return balances.length
+        ? (0, util_1.isFunction)(api.query.system.account)
+            ? (0, rxjs_1.combineLatest)([
+                api.query.system.account(accountId),
+                ...balances.map((c) => c(accountId))
+            ]).pipe((0, rxjs_1.map)(([{ nonce }, ...balances]) => extract(nonce, balances)))
+            : (0, rxjs_1.combineLatest)([
+                api.query.system['accountNonce'](accountId),
+                ...balances.map((c) => c(accountId))
+            ]).pipe((0, rxjs_1.map)(([nonce, ...balances]) => extract(nonce, balances)))
+        : queryNonceOnly(api, accountId);
+}
+function querySystemAccount(api, accountId) {
+    // AccountInfo is current, support old, eg. Edgeware
+    return api.query.system.account(accountId).pipe((0, rxjs_1.map)((infoOrTuple) => {
+        const data = infoOrTuple.nonce
+            ? infoOrTuple.data
+            : infoOrTuple[1];
+        const nonce = infoOrTuple.nonce || infoOrTuple[0];
+        if (!data || data.isEmpty) {
+            return [
+                nonce,
+                [[zeroBalance(api), zeroBalance(api), zeroBalance(api), zeroBalance(api)]],
+                { isFrameAccountData: false }
+            ];
+        }
+        const isFrameType = !!infoOrTuple.data.frozen;
+        if (isFrameType) {
+            const { flags, free, frozen, reserved } = data;
+            return [
+                nonce,
+                [[free, reserved, frozen, flags]],
+                { isFrameAccountData: true }
+            ];
+        }
+        else {
+            const { feeFrozen, free, miscFrozen, reserved } = data;
+            return [
+                nonce,
+                [[free, reserved, feeFrozen, miscFrozen]],
+                { isFrameAccountData: false }
+            ];
+        }
+    }));
+}
+/**
+ * @name account
+ * @description Retrieves the essential balance details for an account, such as free balance and account nonce.
+ * @param {( AccountIndex | AccountId | Address | string )} address An accountsId in different formats.
+ * @example
+ * ```javascript
+ * const ALICE = 'F7Hs';
+ *
+ * api.derive.balances.all(ALICE, ({ accountId, lockedBalance }) => {
+ *   console.log(`The account ${accountId} has a locked balance ${lockedBalance} units.`);
+ * });
+ * ```
+ */
+function account(instanceId, api) {
+    const balanceInstances = api.registry.getModuleInstances(api.runtimeVersion.specName, 'balances');
+    const nonDefaultBalances = balanceInstances && balanceInstances[0] !== 'balances';
+    return (0, index_js_1.memo)(instanceId, (address) => api.derive.accounts.accountId(address).pipe((0, rxjs_1.switchMap)((accountId) => (accountId
+        ? (0, rxjs_1.combineLatest)([
+            (0, rxjs_1.of)(accountId),
+            nonDefaultBalances
+                ? queryBalancesAccount(api, accountId, balanceInstances)
+                : (0, util_1.isFunction)(api.query.system?.account)
+                    ? querySystemAccount(api, accountId)
+                    : (0, util_1.isFunction)(api.query.balances?.account)
+                        ? queryBalancesAccount(api, accountId)
+                        : (0, util_1.isFunction)(api.query.balances?.['freeBalance'])
+                            ? queryBalancesFree(api, accountId)
+                            : queryNonceOnly(api, accountId)
+        ])
+        : (0, rxjs_1.of)([api.registry.createType('AccountId'), [
+                api.registry.createType('Index'),
+                [[zeroBalance(api), zeroBalance(api), zeroBalance(api), zeroBalance(api)]],
+                { isFrameAccountData: false }
+            ]]))), (0, rxjs_1.map)((result) => calcBalances(api, result))));
+}

package/build-tsc-cjs/balances/all.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.all = all;
+const rxjs_1 = require("rxjs");
+const util_1 = require("@pezkuwi/util");
+const index_js_1 = require("../util/index.js");
+const VESTING_ID = '0x76657374696e6720';
+function calcLocked(api, bestNumber, locks) {
+    let lockedBalance = api.registry.createType('Balance');
+    let lockedBreakdown = [];
+    let vestingLocked = api.registry.createType('Balance');
+    let allLocked = false;
+    if (Array.isArray(locks)) {
+        // only get the locks that are valid until passed the current block
+        lockedBreakdown = locks.filter(({ until }) => !until || (bestNumber && until.gt(bestNumber)));
+        allLocked = lockedBreakdown.some(({ amount }) => amount && amount.isMax());
+        vestingLocked = api.registry.createType('Balance', lockedBreakdown.filter(({ id }) => id.eq(VESTING_ID)).reduce((result, { amount }) => result.iadd(amount), new util_1.BN(0)));
+        // get the maximum of the locks according to https://github.com/pezkuwichain/bizinikiwi/blob/master/srml/balances/src/lib.rs#L699
+        const notAll = lockedBreakdown.filter(({ amount }) => amount && !amount.isMax());
+        if (notAll.length) {
+            lockedBalance = api.registry.createType('Balance', (0, util_1.bnMax)(...notAll.map(({ amount }) => amount)));
+        }
+    }
+    return { allLocked, lockedBalance, lockedBreakdown, vestingLocked };
+}
+function calcShared(api, bestNumber, data, locks) {
+    const { allLocked, lockedBalance, lockedBreakdown, vestingLocked } = calcLocked(api, bestNumber, locks);
+    let transferable = null;
+    if (data?.frameSystemAccountInfo?.frozen) {
+        const { frameSystemAccountInfo, freeBalance, reservedBalance } = data;
+        const noFrozenReserved = frameSystemAccountInfo.frozen.isZero() && reservedBalance.isZero();
+        const ED = api.consts.balances.existentialDeposit;
+        const maybeED = noFrozenReserved ? new util_1.BN(0) : ED;
+        const frozenReserveDif = frameSystemAccountInfo.frozen.sub(reservedBalance);
+        transferable = api.registry.createType('Balance', allLocked
+            ? 0
+            : (0, util_1.bnMax)(new util_1.BN(0), freeBalance.sub((0, util_1.bnMax)(maybeED, frozenReserveDif))));
+    }
+    return (0, util_1.objectSpread)({}, data, {
+        availableBalance: api.registry.createType('Balance', allLocked ? 0 : (0, util_1.bnMax)(new util_1.BN(0), data?.freeBalance ? data.freeBalance.sub(lockedBalance) : new util_1.BN(0))),
+        lockedBalance,
+        lockedBreakdown,
+        transferable,
+        vestingLocked
+    });
+}
+function calcVesting(bestNumber, shared, _vesting) {
+    // Calculate the vesting balances,
+    //  - offset = balance locked at startingBlock
+    //  - perBlock is the unlock amount
+    const vesting = _vesting || [];
+    const isVesting = !shared.vestingLocked.isZero();
+    const vestedBalances = vesting.map(({ locked, perBlock, startingBlock }) => bestNumber.gt(startingBlock)
+        ? (0, util_1.bnMin)(locked, perBlock.mul(bestNumber.sub(startingBlock)))
+        : util_1.BN_ZERO);
+    const vestedBalance = vestedBalances.reduce((all, value) => all.iadd(value), new util_1.BN(0));
+    const vestingTotal = vesting.reduce((all, { locked }) => all.iadd(locked), new util_1.BN(0));
+    return {
+        isVesting,
+        vestedBalance,
+        vestedClaimable: isVesting
+            ? shared.vestingLocked.sub(vestingTotal.sub(vestedBalance))
+            : util_1.BN_ZERO,
+        vesting: vesting
+            .map(({ locked, perBlock, startingBlock }, index) => ({
+            endBlock: locked.div(perBlock).iadd(startingBlock),
+            locked,
+            perBlock,
+            startingBlock,
+            vested: vestedBalances[index]
+        }))
+            .filter(({ locked }) => !locked.isZero()),
+        vestingTotal
+    };
+}
+function calcBalances(api, result) {
+    const [data, [vesting, allLocks, namedReserves], bestNumber] = result;
+    const shared = calcShared(api, bestNumber, data, allLocks[0]);
+    return (0, util_1.objectSpread)(shared, calcVesting(bestNumber, shared, vesting), {
+        accountId: data.accountId,
+        accountNonce: data.accountNonce,
+        additional: allLocks
+            .slice(1)
+            .map((l, index) => calcShared(api, bestNumber, data.additional[index], l)),
+        namedReserves
+    });
+}
+function queryOld(api, accountId) {
+    return (0, rxjs_1.combineLatest)([
+        api.query.balances.locks(accountId),
+        api.query.balances['vesting'](accountId)
+    ]).pipe((0, rxjs_1.map)(([locks, optVesting]) => {
+        let vestingNew = null;
+        if (optVesting.isSome) {
+            const { offset: locked, perBlock, startingBlock } = optVesting.unwrap();
+            vestingNew = api.registry.createType('VestingInfo', { locked, perBlock, startingBlock });
+        }
+        return [
+            vestingNew
+                ? [vestingNew]
+                : null,
+            [locks],
+            []
+        ];
+    }));
+}
+const isNonNullable = (nullable) => !!nullable;
+function createCalls(calls) {
+    return [
+        calls.map((c) => !c),
+        calls.filter(isNonNullable)
+    ];
+}
+function queryCurrent(api, accountId, balanceInstances = ['balances']) {
+    const [lockEmpty, lockQueries] = createCalls(balanceInstances.map((m) => api.derive[m]?.customLocks || api.query[m]?.locks));
+    const [reserveEmpty, reserveQueries] = createCalls(balanceInstances.map((m) => api.query[m]?.reserves));
+    return (0, rxjs_1.combineLatest)([
+        api.query.vesting?.vesting
+            ? api.query.vesting.vesting(accountId)
+            : (0, rxjs_1.of)(api.registry.createType('Option<VestingInfo>')),
+        lockQueries.length
+            ? (0, rxjs_1.combineLatest)(lockQueries.map((c) => c(accountId)))
+            : (0, rxjs_1.of)([]),
+        reserveQueries.length
+            ? (0, rxjs_1.combineLatest)(reserveQueries.map((c) => c(accountId)))
+            : (0, rxjs_1.of)([])
+    ]).pipe((0, rxjs_1.map)(([opt, locks, reserves]) => {
+        let offsetLock = -1;
+        let offsetReserve = -1;
+        const vesting = opt.unwrapOr(null);
+        return [
+            vesting
+                ? Array.isArray(vesting)
+                    ? vesting
+                    : [vesting]
+                : null,
+            lockEmpty.map((e) => e ? api.registry.createType('Vec<BalanceLock>') : locks[++offsetLock]),
+            reserveEmpty.map((e) => e ? api.registry.createType('Vec<PezpalletBalancesReserveData>') : reserves[++offsetReserve])
+        ];
+    }));
+}
+/**
+ * @name all
+ * @description Retrieves the complete balance information for an account, including free balance, locked balance, reserved balance, and more.
+ * @param {( AccountId | string )} address An accountsId in different formats.
+ * @example
+ * ```javascript
+ * const ALICE = 'F7Hs';
+ *
+ * api.derive.balances.account(ALICE, (accountInfo) => {
+ *   console.log(
+ *     `${accountInfo.accountId} info:`,
+ *     Object.keys(accountInfo).map((key) => `${key}: ${accountInfo[key]}`)
+ *   );
+ * });
+ * ```
+ */
+function all(instanceId, api) {
+    const balanceInstances = api.registry.getModuleInstances(api.runtimeVersion.specName, 'balances');
+    return (0, index_js_1.memo)(instanceId, (address) => (0, rxjs_1.combineLatest)([
+        api.derive.balances.account(address),
+        (0, util_1.isFunction)(api.query.system?.account) || (0, util_1.isFunction)(api.query.balances?.account)
+            ? queryCurrent(api, address, balanceInstances)
+            : queryOld(api, address)
+    ]).pipe((0, rxjs_1.switchMap)(([account, locks]) => (0, rxjs_1.combineLatest)([
+        (0, rxjs_1.of)(account),
+        (0, rxjs_1.of)(locks),
+        api.derive.chain.bestNumber()
+    ])), (0, rxjs_1.map)((result) => calcBalances(api, result))));
+}

package/build-tsc-cjs/balances/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.votingBalance = exports.all = void 0;
+const tslib_1 = require("tslib");
+const all_js_1 = require("./all.js");
+Object.defineProperty(exports, "all", { enumerable: true, get: function () { return all_js_1.all; } });
+tslib_1.__exportStar(require("./account.js"), exports);
+tslib_1.__exportStar(require("./votingBalances.js"), exports);
+/**
+ * @name votingBalance
+ * @param {( AccountId | string )} address An accounts Id in different formats.
+ * @returns An object containing the results of various balance queries
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * const ALICE = 'F7Hs';
+ *
+ * api.derive.balances.votingBalance(ALICE, ({ accountId, lockedBalance }) => {
+ *   console.log(`The account ${accountId} has a locked balance ${lockedBalance} units.`);
+ * });
+ * ```
+ */
+const votingBalance = all_js_1.all;
+exports.votingBalance = votingBalance;

package/build-tsc-cjs/balances/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build-tsc-cjs/balances/votingBalances.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.votingBalances = votingBalances;
+const rxjs_1 = require("rxjs");
+const index_js_1 = require("../util/index.js");
+/**
+ * @name votingBalances
+ * @description Retrieves the balance information for multiple accounts, typically used in governance-related contexts to check voting power.
+ * @param {(AccountId | AccountIndex | Address | string)[]} addresses An array of account identifiers.
+ * @example
+ * ```javascript
+ * const addresses = ["5D4b...Zf1", "5HGj...yrV"];
+ * const balances = await api.derive.balances.votingBalances(addresses);
+ * console.log("Voting Balances:", balances);
+ * ```
+ */
+function votingBalances(instanceId, api) {
+    return (0, index_js_1.memo)(instanceId, (addresses) => !addresses?.length
+        ? (0, rxjs_1.of)([])
+        : (0, rxjs_1.combineLatest)(addresses.map((accountId) => api.derive.balances.account(accountId))));
+}

package/build-tsc-cjs/bounties/bounties.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bounties = bounties;
+const rxjs_1 = require("rxjs");
+const index_js_1 = require("../util/index.js");
+const filterBountyProposals_js_1 = require("./helpers/filterBountyProposals.js");
+function parseResult([maybeBounties, maybeDescriptions, ids, bountyProposals]) {
+    const bounties = [];
+    maybeBounties.forEach((bounty, index) => {
+        if (bounty.isSome) {
+            bounties.push({
+                bounty: bounty.unwrap(),
+                description: maybeDescriptions[index].unwrapOrDefault().toUtf8(),
+                index: ids[index],
+                proposals: bountyProposals.filter((bountyProposal) => bountyProposal.proposal && ids[index].eq(bountyProposal.proposal.args[0]))
+            });
+        }
+    });
+    return bounties;
+}
+/**
+ * @name bounties
+ * @descrive Retrieves all active bounties, their descriptions, and associated proposals.
+ * @example
+ * ```javascript
+ * const bounties = await api.derive.bounties();
+ * console.log("Active bounties:", bounties);
+ * ```
+ */
+function bounties(instanceId, api) {
+    const bountyBase = api.query.bounties || api.query.treasury;
+    return (0, index_js_1.memo)(instanceId, () => bountyBase.bounties
+        ? (0, rxjs_1.combineLatest)([
+            bountyBase.bountyCount(),
+            api.query.council
+                ? api.query.council.proposalCount()
+                : (0, rxjs_1.of)(0)
+        ]).pipe((0, rxjs_1.switchMap)(() => (0, rxjs_1.combineLatest)([
+            bountyBase.bounties.keys(),
+            api.derive.council
+                ? api.derive.council.proposals()
+                : (0, rxjs_1.of)([])
+        ])), (0, rxjs_1.switchMap)(([keys, proposals]) => {
+            const ids = keys.map(({ args: [id] }) => id);
+            return (0, rxjs_1.combineLatest)([
+                bountyBase.bounties.multi(ids),
+                bountyBase.bountyDescriptions.multi(ids),
+                (0, rxjs_1.of)(ids),
+                (0, rxjs_1.of)((0, filterBountyProposals_js_1.filterBountiesProposals)(api, proposals))
+            ]);
+        }), (0, rxjs_1.map)(parseResult))
+        : (0, rxjs_1.of)(parseResult([[], [], [], []])));
+}

package/build-tsc-cjs/bounties/helpers/filterBountyProposals.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterBountiesProposals = filterBountiesProposals;
+function filterBountiesProposals(api, allProposals) {
+    const bountyTxBase = api.tx.bounties ? api.tx.bounties : api.tx.treasury;
+    const bountyProposalCalls = [bountyTxBase.approveBounty, bountyTxBase.closeBounty, bountyTxBase.proposeCurator, bountyTxBase.unassignCurator];
+    return allProposals.filter((proposal) => bountyProposalCalls.find((bountyCall) => proposal.proposal && bountyCall.is(proposal.proposal)));
+}

package/build-tsc-cjs/bounties/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./bounties.js"), exports);

package/build-tsc-cjs/bundle.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lazyDeriveSection = void 0;
+exports.getAvailableDerives = getAvailableDerives;
+const tslib_1 = require("tslib");
+const index_js_1 = require("./util/index.js");
+Object.defineProperty(exports, "lazyDeriveSection", { enumerable: true, get: function () { return index_js_1.lazyDeriveSection; } });
+const derive_js_1 = require("./derive.js");
+tslib_1.__exportStar(require("./derive.js"), exports);
+tslib_1.__exportStar(require("./type/index.js"), exports);
+const checks = {
+    allianceMotion: {
+        instances: ['allianceMotion'],
+        methods: []
+    },
+    bagsList: {
+        instances: ['voterBagsList', 'voterList', 'bagsList'],
+        methods: [],
+        withDetect: true
+    },
+    contracts: {
+        instances: ['contracts'],
+        methods: []
+    },
+    council: {
+        instances: ['council'],
+        methods: [],
+        withDetect: true
+    },
+    crowdloan: {
+        instances: ['crowdloan'],
+        methods: []
+    },
+    democracy: {
+        instances: ['democracy'],
+        methods: []
+    },
+    elections: {
+        instances: ['phragmenElection', 'electionsPhragmen', 'elections', 'council'],
+        methods: [],
+        withDetect: true
+    },
+    imOnline: {
+        instances: ['imOnline'],
+        methods: []
+    },
+    membership: {
+        instances: ['membership'],
+        methods: []
+    },
+    teyrchains: {
+        instances: ['teyrchains', 'registrar'],
+        methods: []
+    },
+    session: {
+        instances: ['session'],
+        methods: []
+    },
+    society: {
+        instances: ['society'],
+        methods: []
+    },
+    staking: {
+        instances: ['staking'],
+        methods: ['erasRewardPoints']
+    },
+    technicalCommittee: {
+        instances: ['technicalCommittee'],
+        methods: [],
+        withDetect: true
+    },
+    treasury: {
+        instances: ['treasury'],
+        methods: []
+    }
+};
+function getModuleInstances(api, specName, moduleName) {
+    return api.registry.getModuleInstances(specName, moduleName) || [];
+}
+/**
+ * Returns an object that will inject `api` into all the functions inside
+ * `allSections`, and keep the object architecture of `allSections`.
+ */
+/** @internal */
+function injectFunctions(instanceId, api, derives) {
+    const result = {};
+    const names = Object.keys(derives);
+    const keys = Object.keys(api.query);
+    const specName = api.runtimeVersion.specName;
+    const filterKeys = (q) => keys.includes(q);
+    const filterInstances = (q) => getModuleInstances(api, specName, q).some(filterKeys);
+    const filterMethods = (all) => (m) => all.some((q) => keys.includes(q) && api.query[q][m]);
+    const getKeys = (s) => Object.keys(derives[s]);
+    const creator = (s, m) => derives[s][m](instanceId, api);
+    const isIncluded = (c) => (!checks[c] || ((checks[c].instances.some(filterKeys) && (!checks[c].methods.length ||
+        checks[c].methods.every(filterMethods(checks[c].instances)))) ||
+        (checks[c].withDetect &&
+            checks[c].instances.some(filterInstances))));
+    for (let i = 0, count = names.length; i < count; i++) {
+        const name = names[i];
+        isIncluded(name) &&
+            (0, index_js_1.lazyDeriveSection)(result, name, getKeys, creator);
+    }
+    return result;
+}
+/** @internal */
+function getAvailableDerives(instanceId, api, custom = {}) {
+    return {
+        ...injectFunctions(instanceId, api, derive_js_1.derive),
+        ...injectFunctions(instanceId, api, custom)
+    };
+}

package/build-tsc-cjs/chain/bestNumber.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bestNumber = void 0;
+const util_js_1 = require("./util.js");
+/**
+ * @name bestNumber
+ * @descrive Retrieves the latest block number.
+ * @example
+ * ```javascript
+ * api.derive.chain.bestNumber((blockNumber) => {
+ *   console.log(`the current best block is #${blockNumber}`);
+ * });
+ * ```
+ */
+exports.bestNumber = (0, util_js_1.createBlockNumberDerive)((api) => api.rpc.chain.subscribeNewHeads());

package/build-tsc-cjs/chain/bestNumberFinalized.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bestNumberFinalized = void 0;
+const util_js_1 = require("./util.js");
+/**
+ * @name bestNumberFinalized
+ * @returns A BlockNumber
+ * @description Get the latest finalized block number.
+ * @example
+ * ```javascript
+ * api.derive.chain.bestNumberFinalized((blockNumber) => {
+ *   console.log(`the current finalized block is #${blockNumber}`);
+ * });
+ * ```
+ */
+exports.bestNumberFinalized = (0, util_js_1.createBlockNumberDerive)((api) => api.rpc.chain.subscribeFinalizedHeads());

package/build-tsc-cjs/chain/bestNumberLag.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bestNumberLag = bestNumberLag;
+const rxjs_1 = require("rxjs");
+const index_js_1 = require("../util/index.js");
+/**
+ * @name bestNumberLag
+ * @returns A number of blocks
+ * @description Calculates the lag between finalized head and best head
+ * @examplew
+ * ```javascript
+ * api.derive.chain.bestNumberLag((lag) => {
+ *   console.log(`finalized is ${lag} blocks behind head`);
+ * });
+ * ```
+ */
+function bestNumberLag(instanceId, api) {
+    return (0, index_js_1.memo)(instanceId, () => (0, rxjs_1.combineLatest)([
+        api.derive.chain.bestNumber(),
+        api.derive.chain.bestNumberFinalized()
+    ]).pipe((0, rxjs_1.map)(([bestNumber, bestNumberFinalized]) => api.registry.createType('BlockNumber', bestNumber.sub(bestNumberFinalized)))));
+}

package/build-tsc-cjs/chain/getBlock.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBlock = getBlock;
+const rxjs_1 = require("rxjs");
+const index_js_1 = require("../type/index.js");
+const index_js_2 = require("../util/index.js");
+const util_js_1 = require("./util.js");
+/**
+ * @name getBlock
+ * @param {( Uint8Array | string )} hash A block hash as U8 array or string.
+ * @description Get a specific block (e.g. rpc.chain.getBlock) and extend it with the author
+ * @example
+ * ```javascript
+ * const { author, block } = await api.derive.chain.getBlock('0x123...456');
+ *
+ * console.log(`block #${block.header.number} was authored by ${author}`);
+ * ```
+ */
+function getBlock(instanceId, api) {
+    return (0, index_js_2.memo)(instanceId, (blockHash) => (0, rxjs_1.combineLatest)([
+        api.rpc.chain.getBlock(blockHash),
+        api.queryAt(blockHash)
+    ]).pipe((0, rxjs_1.switchMap)(([signedBlock, queryAt]) => (0, rxjs_1.combineLatest)([
+        (0, rxjs_1.of)(signedBlock),
+        queryAt.system.events(),
+        (0, util_js_1.getAuthorDetails)(api, signedBlock.block.header, blockHash)
+    ])), (0, rxjs_1.map)(([signedBlock, events, [, validators, author]]) => (0, index_js_1.createSignedBlockExtended)(events.registry, signedBlock, events, validators, author))));
+}

package/build-tsc-cjs/chain/getBlockByNumber.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBlockByNumber = getBlockByNumber;
+const rxjs_1 = require("rxjs");
+const index_js_1 = require("../util/index.js");
+/**
+ * @name getBlockByNumber
+ * @param {( BN | bigint | Uint8Array | number | string )} blockNumber
+ * @description Get a specific block (e.g. rpc.chain.getBlock) and extend it with the author by block number
+ * @example
+ * ```javascript
+ * const { author, block } = await api.derive.chain.getBlockByNumber(123);
+ *
+ * console.log(`block #${block.header.number} was authored by ${author}`);
+ * ```
+ */
+function getBlockByNumber(instanceId, api) {
+    return (0, index_js_1.memo)(instanceId, (blockNumber) => api.rpc.chain.getBlockHash(blockNumber).pipe((0, rxjs_1.switchMap)((h) => api.derive.chain.getBlock(h))));
+}