@pezkuwi/api-derive 16.5.5

package/build/technicalCommittee/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @name members
+ * @description Retrieves the list of members in the "technicalCommittee" collective.
+ * @example
+ * ```javascript
+ * const members = await api.derive.technicalCommittee.members();
+ * console.log(`Members: ${JSON.stringify(members)});
+ * ```
+ */
+export declare const members: import("../collective/types.js").MembersFnRet;
+/**
+ * @name hasProposals
+ * @description Checks if there are any active proposals in the "technicalCommittee" collective.
+ * @example
+ * ```javascript
+ * const exists = await api.derive.technicalCommittee.hasProposals();
+ * console.log(exists);
+ * ```
+ */
+export declare const hasProposals: import("../collective/types.js").HasProposalsFnRet;
+/**
+ * @name proposal
+ * @description Retrieves details of a specific proposal in the "technicalCommitteeMotion" collective by its hash.
+ * @example
+ * ```javascript
+ * const proposalDetails = await api.derive.technicalCommittee.proposal(PROPOSAL_HASH);
+ * console.log(proposalDetails);
+ * ```
+ */
+export declare const proposal: import("../collective/types.js").ProposalFnRet;
+/**
+ * @name proposalCount
+ * @description Retrieves the total number of proposals in the "technicalCommittee" collective.
+ * @example
+ * ```javascript
+ * const count = await api.derive.technicalCommittee.proposalCount();
+ * console.log(`Amount of proposals: ${count}`);
+ * ```
+ */
+export declare const proposalCount: import("../collective/types.js").ProposalCountFnRet;
+/**
+ * @name proposalHashes
+ * @description Retrieves an array of hashes for all active proposals in the "technicalCommittee" collective.
+ * @example
+ * ```javascript
+ * const hashes = await api.derive.technicalCommittee.proposalHashes();
+ * console.log(`Proposals ${JSON.stringify(hashes)}`);
+ * ```
+ */
+export declare const proposalHashes: import("../collective/types.js").ProposalHashesFnRet;
+/**
+ * @name proposals
+ * @description Retrieves a list of all active proposals in the "technicalCommittee" collective.
+ * @example
+ * ```javascript
+ * const proposals = await api.derive.technicalCommittee.proposals();
+ * console.log(proposals);
+ * ```
+ */
+export declare const proposals: import("../collective/types.js").ProposalsFnRet;
+/**
+ * @name prime
+ * @description Retrieves the prime member of the "technicalCommittee" collective, if one exists.
+ * @example
+ * ```javascript
+ * const primeMember = await api.derive.technicalCommittee.prime();
+ * console.log(primeMember);
+ * ```
+ */
+export declare const prime: import("../collective/types.js").PrimeFnRet;

package/build/treasury/index.d.ts

@@ -0,0 +1 @@
+export * from './proposals.js';

package/build/treasury/proposals.d.ts

@@ -0,0 +1,12 @@
+import type { Observable } from 'rxjs';
+import type { DeriveApi, DeriveTreasuryProposals } from '../types.js';
+/**
+ * @name proposals
+ * @description Retrieve all active and approved treasury proposals, along with their info.
+ * @example
+ * ```javascript
+ * const treasuryProposals = await api.derive.treasury.proposals();
+ * console.log(treasuryProposals);
+ * ```
+ */
+export declare function proposals(instanceId: string, api: DeriveApi): () => Observable<DeriveTreasuryProposals>;

package/build/tx/constants.d.ts

@@ -0,0 +1,5 @@
+import { BN } from '@pezkuwi/util';
+export declare const FALLBACK_MAX_HASH_COUNT = 250;
+export declare const FALLBACK_PERIOD: BN;
+export declare const MAX_FINALITY_LAG: BN;
+export declare const MORTAL_PERIOD: BN;

package/build/tx/events.d.ts

@@ -0,0 +1,22 @@
+import type { Observable } from 'rxjs';
+import type { EventRecord, Hash, SignedBlock } from '@pezkuwi/types/interfaces';
+import type { DeriveApi } from '../types.js';
+interface Result {
+    block: SignedBlock;
+    events: EventRecord[];
+}
+/**
+ * @name events
+ * @param {Hash} at Block hash to query at.
+ * @description Retrieves the block information alongside its events at a given block hash
+ * @example
+ * ```javascript
+ * const blockHash = api.registry.createType(
+ *   "Hash",
+ *   "0xf1dc2efe8265be67deea5e91b05a98a7f9f81f66854e92825cf36f541beb7af6"
+ * );
+ * const { events, block } = await api.derive.tx.events(blockHash);
+ * ```
+ */
+export declare function events(instanceId: string, api: DeriveApi): (at: Hash) => Observable<Result>;
+export {};

package/build/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/build/tx/index.d.ts

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

package/build/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/build/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/build/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/build/type/index.d.ts

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

package/build/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/build/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/build/types.d.ts

@@ -0,0 +1,79 @@
+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 { 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';
+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 './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;
+}
+export interface DeriveContractFees {
+    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;
+}
+export interface DeriveFees {
+    creationFee: Balance;
+    existentialDeposit: Balance;
+    transactionBaseFee: Balance;
+    transactionByteFee: Balance;
+    transferFee: Balance;
+}
+export interface DeriveHeartbeatAuthor {
+    blockCount: u32;
+    hasMessage: boolean;
+    isOnline: boolean;
+}
+export type DeriveHeartbeats = Record<string, DeriveHeartbeatAuthor>;
+export interface RecentlyOffline {
+    blockNumber: BlockNumber;
+    count: BN;
+}
+export type DeriveRecentlyOffline = Record<string, RecentlyOffline[]>;
+export interface DeriveTreasuryProposal {
+    council: DeriveCollectiveProposal[];
+    id: ProposalIndex;
+    proposal: PalletTreasuryProposal;
+}
+export interface DeriveTreasuryProposals {
+    approvals: DeriveTreasuryProposal[];
+    proposalCount: ProposalIndex;
+    proposals: DeriveTreasuryProposal[];
+}
+export interface VoterPosition {
+    globalIndex: BN;
+    index: BN;
+    setIndex: SetIndex;
+}
+export type DeriveVoterPositions = Record<string, VoterPosition>;
+export interface DeriveBounty {
+    bounty: PalletBountiesBounty;
+    description: string;
+    index: BountyIndex;
+    proposals: DeriveCollectiveProposal[];
+}
+export type DeriveBounties = DeriveBounty[];

package/build/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/build/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/build/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/build/util/cacheImpl.d.ts

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

package/build/util/first.d.ts

@@ -0,0 +1,4 @@
+import type { Observable } from 'rxjs';
+import type { DeriveApi } from '../types.js';
+export declare function firstObservable<T>(obs: Observable<T[]>): Observable<T>;
+export declare function firstMemo<T, A extends any[]>(fn: (api: DeriveApi, ...args: A) => Observable<T[]>): (instanceId: string, api: DeriveApi) => (...args: A) => Observable<T>;

package/build/util/index.d.ts

@@ -0,0 +1,7 @@
+export { drr, memo } from '@pezkuwi/rpc-core';
+export * from './approvalFlagsToBools.js';
+export * from './blockNumber.js';
+export * from './cache.js';
+export * from './cacheImpl.js';
+export * from './first.js';
+export * from './lazy.js';

package/build/util/lazy.d.ts

@@ -0,0 +1,4 @@
+type LazySection<T> = Record<string, T>;
+type LazyRecord<T> = Record<string, LazySection<T>>;
+export declare function lazyDeriveSection<T>(result: LazyRecord<T>, section: string, getKeys: (s: string) => string[], creator: (s: string, m: string) => T): void;
+export {};

package/build/util/types.d.ts

@@ -0,0 +1,6 @@
+export interface DeriveCache {
+    del: (key: string) => void;
+    forEach: (cb: (key: string, value: any) => void) => void;
+    get: <T = any>(key: string) => T | undefined;
+    set: (key: string, value: any) => void;
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "author": "Jaco Greeff <jacogr@gmail.com>",
+  "bugs": "https://github.com/pezkuwichain/pezkuwi-api/issues",
+  "description": "Common functions used across Polkadot, derived from RPC calls and storage queries.",
+  "engines": {
+    "node": ">=18"
+  },
+  "homepage": "https://github.com/pezkuwichain/pezkuwi-api/tree/master/packages/api-derive#readme",
+  "license": "Apache-2.0",
+  "name": "@pezkuwi/api-derive",
+  "repository": {
+    "directory": "packages/api-derive",
+    "type": "git",
+    "url": "https://github.com/pezkuwichain/pezkuwi-api.git"
+  },
+  "sideEffects": [
+    "./packageDetect.js",
+    "./packageDetect.cjs"
+  ],
+  "type": "module",
+  "version": "16.5.5",
+  "main": "index.js",
+  "dependencies": {
+    "@pezkuwi/api": "16.5.5",
+    "@pezkuwi/api-augment": "16.5.5",
+    "@pezkuwi/api-base": "16.5.5",
+    "@pezkuwi/rpc-core": "16.5.5",
+    "@pezkuwi/types": "16.5.5",
+    "@pezkuwi/types-codec": "16.5.5",
+    "@pezkuwi/util": "14.0.5",
+    "@pezkuwi/util-crypto": "14.0.5",
+    "rxjs": "^7.8.1",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@pezkuwi/api": "16.5.5",
+    "@pezkuwi/api-augment": "16.5.5",
+    "@pezkuwi/rpc-augment": "16.5.5",
+    "@pezkuwi/rpc-provider": "16.5.5",
+    "@pezkuwi/types-support": "16.5.5"
+  }
+}

package/src/accounts/accountId.ts

@@ -0,0 +1,44 @@
+// Copyright 2017-2025 @polkadot/api-derive authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Observable } from 'rxjs';
+import type { AccountId, AccountIndex, Address } from '@pezkuwi/types/interfaces';
+import type { DeriveApi } from '../types.js';
+
+import { map, of } from 'rxjs';
+
+import { assertReturn, isU8a } from '@pezkuwi/util';
+import { decodeAddress } from '@pezkuwi/util-crypto';
+
+import { memo } from '../util/index.js';
+
+/**
+ * @name accountId
+ * @param {(Address | AccountId | AccountIndex | string | null)} address An accounts address in various formats.
+ * @description Resolves an address (in different formats) to its corresponding `AccountId`.
+ * @example
+ * ```javascript
+ * const ALICE = "F7Hs";
+ *
+ * api.derive.accounts.accountId(ALICE, (accountId) => {
+ *   console.log(`Resolved AccountId: ${accountId}`);
+ * });
+ * ```
+ */
+export function accountId (instanceId: string, api: DeriveApi): (address?: Address | AccountId | AccountIndex | string | null) => Observable<AccountId> {
+  return memo(instanceId, (address?: Address | AccountId | AccountIndex | string | null): Observable<AccountId> => {
+    const decoded = isU8a(address)
+      ? address
+      : decodeAddress((address || '').toString());
+
+    if (decoded.length > 8) {
+      return of(api.registry.createType(decoded.length === 20 ? 'AccountId20' : 'AccountId', decoded));
+    }
+
+    const accountIndex = api.registry.createType('AccountIndex', decoded);
+
+    return api.derive.accounts.indexToId(accountIndex.toString()).pipe(
+      map((a) => assertReturn(a, 'Unable to retrieve accountId'))
+    );
+  });
+}

package/src/accounts/flags.ts

@@ -0,0 +1,90 @@
+// Copyright 2017-2025 @polkadot/api-derive authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Observable } from 'rxjs';
+import type { AccountId, Address, Balance } from '@pezkuwi/types/interfaces';
+import type{ PalletElectionsPhragmenSeatHolder } from '@pezkuwi/types/lookup';
+import type { Codec } from '@pezkuwi/types/types';
+import type { Option } from '@pezkuwi/types-codec';
+import type { DeriveAccountFlags, DeriveApi } from '../types.js';
+
+import { map, of } from 'rxjs';
+
+import { isFunction } from '@pezkuwi/util';
+
+import { memo } from '../util/index.js';
+
+type FlagsIntermediate = [
+  PalletElectionsPhragmenSeatHolder[] | [AccountId, Balance][] | undefined,
+  AccountId[],
+  AccountId[],
+  AccountId[],
+  Option<AccountId> | AccountId | undefined
+];
+
+function parseFlags (address: AccountId | Address | string | null | undefined, [electionsMembers, councilMembers, technicalCommitteeMembers, societyMembers, sudoKey]: FlagsIntermediate): DeriveAccountFlags {
+  const addrStr = address?.toString();
+  const isIncluded = (id: AccountId | Address | string) =>
+    id.toString() === addrStr;
+
+  return {
+    isCouncil: (electionsMembers?.map((r) => Array.isArray(r) ? r[0] : r.who) || councilMembers || []).some(isIncluded),
+    isSociety: (societyMembers || []).some(isIncluded),
+    isSudo: sudoKey?.toString() === addrStr,
+    isTechCommittee: (technicalCommitteeMembers || []).some(isIncluded)
+  };
+}
+
+export function _flags (instanceId: string, api: DeriveApi): () => Observable<FlagsIntermediate> {
+  return memo(instanceId, (): Observable<FlagsIntermediate> => {
+    const results: unknown[] = [undefined, [], [], [], undefined];
+    const calls = [
+      (api.query.elections || api.query['phragmenElection'] || api.query['electionsPhragmen'])?.members,
+      api.query.council?.members,
+      api.query.technicalCommittee?.members,
+      api.query.society?.members,
+      api.query.sudo?.key
+    ];
+    const filtered = calls.filter((c) => c);
+
+    if (!filtered.length) {
+      return of(results as FlagsIntermediate);
+    }
+
+    return api.queryMulti(filtered).pipe(
+      map((values: Codec[]): FlagsIntermediate => {
+        let resultIndex = -1;
+
+        for (let i = 0, count = calls.length; i < count; i++) {
+          if (isFunction(calls[i])) {
+            results[i] = values[++resultIndex];
+          }
+        }
+
+        return results as FlagsIntermediate;
+      })
+    );
+  });
+}
+
+/**
+ * @name flags
+ * @param {(AccountId | Address | string | null)} address The account identifier.
+ * @description Retrieves the membership flags for a given account.
+ * @example
+ * const ALICE = "F7Hs";
+ *
+ * api.derive.accounts.flags(ALICE, (flags) => {
+ *   console.log(
+ *     `Account Flags:`,
+ *     Object.keys(flags).map((flag) => `${flag}: ${flags[flag]}`)
+ *   );
+ * });
+ */
+export function flags (instanceId: string, api: DeriveApi): (address?: AccountId | Address | string | null) => Observable<DeriveAccountFlags> {
+  return memo(instanceId, (address?: AccountId | Address | string | null): Observable<DeriveAccountFlags> =>
+    api.derive.accounts._flags().pipe(
+      map((r) => parseFlags(address, r))
+    )
+  );
+}

package/src/accounts/idAndIndex.ts

@@ -0,0 +1,51 @@
+// Copyright 2017-2025 @polkadot/api-derive authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Observable } from 'rxjs';
+import type { AccountId, AccountIndex, Address } from '@pezkuwi/types/interfaces';
+import type { AccountIdAndIndex, DeriveApi } from '../types.js';
+
+import { map, of } from 'rxjs';
+
+import { isU8a } from '@pezkuwi/util';
+import { decodeAddress } from '@pezkuwi/util-crypto';
+
+import { memo } from '../util/index.js';
+
+/**
+ * @name idAndIndex
+ * @param {(Address | AccountId | AccountIndex | Uint8Array | string | null)} address An accounts address in various formats.
+ * @description An array containing the [[AccountId]] and [[AccountIndex]] as optional values.
+ * @example
+ * ```javascript
+ * api.derive.accounts.idAndIndex('F7Hs', ([id, ix]) => {
+ *   console.log(`AccountId #${id} with corresponding AccountIndex ${ix}`);
+ * });
+ * ```
+ */
+export function idAndIndex (instanceId: string, api: DeriveApi): (address?: Address | AccountId | AccountIndex | Uint8Array | string | null) => Observable<AccountIdAndIndex> {
+  return memo(instanceId, (address?: Address | AccountId | AccountIndex | Uint8Array | string | null): Observable<AccountIdAndIndex> => {
+    try {
+      // yes, this can fail, don't care too much, catch will catch it
+      const decoded = isU8a(address)
+        ? address
+        : decodeAddress((address || '').toString());
+
+      if (decoded.length > 8) {
+        const accountId = api.registry.createType(decoded.length === 20 ? 'AccountId20' : 'AccountId', decoded);
+
+        return api.derive.accounts.idToIndex(accountId).pipe(
+          map((accountIndex): AccountIdAndIndex => [accountId, accountIndex])
+        );
+      }
+
+      const accountIndex = api.registry.createType('AccountIndex', decoded);
+
+      return api.derive.accounts.indexToId(accountIndex.toString()).pipe(
+        map((accountId): AccountIdAndIndex => [accountId, accountIndex])
+      );
+    } catch {
+      return of([undefined, undefined]);
+    }
+  });
+}

package/src/accounts/idToIndex.ts

@@ -0,0 +1,31 @@
+// Copyright 2017-2025 @polkadot/api-derive authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Observable } from 'rxjs';
+import type { AccountId, AccountIndex } from '@pezkuwi/types/interfaces';
+import type { AccountIndexes, DeriveApi } from '../types.js';
+
+import { map } from 'rxjs';
+
+import { memo } from '../util/index.js';
+
+/**
+ * @name idToIndex
+ * @description Retrieves the corresponding AccountIndex.
+ * @param {( AccountId | string )} accountId An accounts Id in different formats.
+ * @example
+ * ```javascript
+ * const ALICE = '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY';
+ * api.derive.accounts.idToIndex(ALICE, (accountIndex) => {
+ *   console.log(`The AccountIndex of ${ALICE} is ${accountIndex}`);
+ * });
+ * ```
+ */
+export function idToIndex (instanceId: string, api: DeriveApi): (accountId: AccountId | string) => Observable<AccountIndex | undefined> {
+  return memo(instanceId, (accountId: AccountId | string): Observable<AccountIndex | undefined> =>
+    api.derive.accounts.indexes().pipe(
+      map((indexes: AccountIndexes): AccountIndex | undefined =>
+        indexes[accountId.toString()]
+      )
+    ));
+}