feat: initial Pezkuwi Apps rebrand from polkadot-apps

Rebranded terminology: - Polkadot → Pezkuwi - Kusama → Dicle - Westend → Zagros - Rococo → PezkuwiChain - Substrate → Bizinikiwi - parachain → teyrchain Custom logos with Kurdistan brand colors (#e6007a → #86e62a): - bizinikiwi-hexagon.svg - sora-bizinikiwi.svg - hezscanner.svg - heztreasury.svg - pezkuwiscan.svg - pezkuwistats.svg - pezkuwiassembly.svg - pezkuwiholic.svg
2026-04-25 11:37:55 +00:00 · 2026-01-07 13:05:27 +03:00
commit d21bfb1320
5867 changed files with 329019 additions and 0 deletions
@@ -0,0 +1,104 @@
+// Copyright 2017-2025 @pezkuwi/react-hooks authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// This is for the use of `Ledger`
+//
+/* eslint-disable deprecation/deprecation */
+
+import type { ApiPromise } from '@pezkuwi/api';
+import type { TransportType } from '@pezkuwi/hw-ledger-transports/types';
+
+import { useCallback, useMemo } from 'react';
+
+import { Ledger, LedgerGeneric } from '@pezkuwi/hw-ledger';
+import { knownGenesis, knownLedger } from '@pezkuwi/networks/defaults';
+import { settings } from '@pezkuwi/ui-settings';
+import { assert } from '@pezkuwi/util';
+
+import { createNamedHook } from './createNamedHook.js';
+import { useApi } from './useApi.js';
+
+interface StateBase {
+  hasLedgerChain: boolean;
+  hasWebUsb: boolean;
+  isLedgerCapable: boolean;
+  isLedgerEnabled: boolean;
+}
+
+interface State extends StateBase {
+  getLedger: () => LedgerGeneric | Ledger;
+}
+
+const EMPTY_STATE: StateBase = {
+  hasLedgerChain: false,
+  hasWebUsb: false,
+  isLedgerCapable: false,
+  isLedgerEnabled: false
+};
+
+const hasWebUsb = !!(window as unknown as { USB?: unknown }).USB;
+const ledgerChains = Object
+  .keys(knownGenesis)
+  .filter((n) => knownLedger[n]);
+const ledgerHashes = ledgerChains.reduce<string[]>((all, n) => [...all, ...knownGenesis[n]], []);
+let ledger: LedgerGeneric | Ledger | null = null;
+let ledgerType: TransportType | null = null;
+let ledgerApp: string | null;
+
+function retrieveLedger (api: ApiPromise): LedgerGeneric | Ledger {
+  const currType = settings.get().ledgerConn as TransportType;
+  const currApp = settings.get().ledgerApp;
+
+  if (!ledger || ledgerType !== currType || currApp !== ledgerApp) {
+    const genesisHex = api.genesisHash.toHex();
+    const network = ledgerChains.find((network) => knownGenesis[network].includes(genesisHex));
+
+    assert(network, `Unable to find a known Ledger config for genesisHash ${genesisHex}`);
+
+    if (currApp === 'generic') {
+      // All chains use the `slip44` from pezkuwi in their derivation path in ledger.
+      // This interface is specific to the underlying PezkuwiGenericApp.
+      ledger = new LedgerGeneric(currType, network, knownLedger.pezkuwi);
+    } else if (currApp === 'migration') {
+      ledger = new LedgerGeneric(currType, network, knownLedger[network]);
+    } else if (currApp === 'chainSpecific') {
+      ledger = new Ledger(currType, network);
+    } else {
+      // This will never get touched since it will always hit the above two. This satisfies the compiler.
+      ledger = new LedgerGeneric(currType, network, knownLedger.pezkuwi);
+    }
+
+    ledgerType = currType;
+    ledgerApp = currApp;
+  }
+
+  return ledger;
+}
+
+function getState (api: ApiPromise): StateBase {
+  const hasLedgerChain = ledgerHashes.includes(api.genesisHash.toHex());
+  const isLedgerCapable = hasWebUsb && hasLedgerChain;
+
+  return {
+    hasLedgerChain,
+    hasWebUsb,
+    isLedgerCapable,
+    isLedgerEnabled: isLedgerCapable && settings.ledgerConn !== 'none'
+  };
+}
+
+function useLedgerImpl (): State {
+  const { api, isApiReady } = useApi();
+
+  const getLedger = useCallback(
+    () => retrieveLedger(api),
+    [api]
+  );
+
+  return useMemo(
+    () => ({ ...(isApiReady ? getState(api) : EMPTY_STATE), getLedger }),
+    [api, getLedger, isApiReady]
+  );
+}
+
+export const useLedger = createNamedHook('useLedger', useLedgerImpl);