@ledgerhq/live-wallet 0.16.1-nightly.20251205111238 → 0.16.2

package/src/walletsync/__tests__/modules/recentAddresses.test.ts

@@ -1,487 +0,0 @@
-/* eslint-disable @typescript-eslint/consistent-type-assertions */
-
-import { RecentAddressesState } from "@ledgerhq/types-live";
-import { WalletSyncDataManagerResolutionContext } from "../../types";
-import manager, { DistantRecentAddressesState } from "../../modules/recentAddresses";
-
-describe("recentAddress", () => {
-  describe("diffLocalToDistant", () => {
-    it.each([
-      {
-        localData: {} as RecentAddressesState,
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {} as RecentAddressesState,
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-        },
-        latestState: {} as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-        },
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          solana: ["some random address"],
-        },
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-          solana: ["some random address on Solana"],
-        },
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-          solana: ["some random address on Solana", "some random address on Solana 2"],
-        },
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-          solana: ["some random address on Solana 2", "some random address on Solana 3"],
-        },
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-          solana: [
-            { address: "some random address on Solana", index: 0 },
-            { address: "some random address on Solana 2", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-    ])(
-      "should return true when local data is different from latest state #%#",
-      ({ localData, latestState }) => {
-        const result = manager.diffLocalToDistant(localData, latestState);
-
-        expect(result).toEqual({
-          hasChanges: true,
-          nextState: expect.any(Object),
-        });
-
-        Object.entries(localData).forEach(([key, value]) => {
-          const nextState = result.nextState;
-          expect(nextState[key]).toEqual(
-            expect.arrayContaining(value.map((address, index) => ({ address, index }))),
-          );
-        });
-      },
-    );
-
-    it.each([
-      {
-        localData: {} as RecentAddressesState,
-        latestState: {} as DistantRecentAddressesState,
-      },
-      {
-        localData: { ethereum: ["some random address"] } as RecentAddressesState,
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [
-            { address: "some random address 2", index: 1 },
-            { address: "some random address", index: 0 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-          solana: ["some random address on Solana"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [
-            { address: "some random address 2", index: 1 },
-            { address: "some random address", index: 0 },
-          ],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana", "some random address 2 on Solana"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-          solana: [
-            { address: "some random address on Solana", index: 0 },
-            { address: "some random address 2 on Solana", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana", "some random address 2 on Solana"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-          solana: [
-            { address: "some random address 2 on Solana", index: 1 },
-            { address: "some random address on Solana", index: 0 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana", "some random address 2 on Solana"],
-        } as RecentAddressesState,
-        latestState: {
-          ethereum: [
-            { address: "some random address 2", index: 1 },
-            { address: "some random address", index: 0 },
-          ],
-          solana: [
-            { address: "some random address 2 on Solana", index: 1 },
-            { address: "some random address on Solana", index: 0 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-    ])(
-      "should return false when latest data and latest state have the same data #%#",
-      ({ localData, latestState }) => {
-        const result = manager.diffLocalToDistant(localData, latestState);
-        expect(result).toEqual({
-          hasChanges: false,
-          nextState: latestState,
-        });
-      },
-    );
-  });
-
-  describe("resolveIncrementalUpdate", () => {
-    it("should return no changes when there is no incoming state #%#", async () => {
-      const result = await manager.resolveIncrementalUpdate(
-        {} as unknown as WalletSyncDataManagerResolutionContext,
-        {},
-        {},
-        undefined as unknown as DistantRecentAddressesState,
-      );
-      expect(result).toEqual({
-        hasChanges: false,
-      });
-    });
-
-    it.each([
-      [{} as DistantRecentAddressesState],
-      [{ ethereum: [{ address: "some random address", index: 0 }] } as DistantRecentAddressesState],
-      [
-        {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      ],
-    ])(
-      "should return no changes when latest state and incoming state are the same",
-      async (state: DistantRecentAddressesState) => {
-        const result = await manager.resolveIncrementalUpdate(
-          {} as unknown as WalletSyncDataManagerResolutionContext,
-          {},
-          state,
-          state,
-        );
-        expect(result).toEqual({
-          hasChanges: false,
-        });
-      },
-    );
-
-    it.each([
-      {
-        localData: {} as RecentAddressesState,
-        incomingState: {} as DistantRecentAddressesState,
-      },
-      {
-        localData: { ethereum: ["some random address"] } as RecentAddressesState,
-        incomingState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address 2", index: 1 },
-            { address: "some random address", index: 0 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-          solana: ["some random address on Solana"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address 2", index: 1 },
-            { address: "some random address", index: 0 },
-          ],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana", "some random address 2 on Solana"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-          solana: [
-            { address: "some random address on Solana", index: 0 },
-            { address: "some random address 2 on Solana", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana", "some random address 2 on Solana"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-          solana: [
-            { address: "some random address 2 on Solana", index: 1 },
-            { address: "some random address on Solana", index: 0 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address", "some random address 2"],
-          solana: ["some random address on Solana", "some random address 2 on Solana"],
-        } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address 2", index: 1 },
-            { address: "some random address", index: 0 },
-          ],
-          solana: [
-            { address: "some random address 2 on Solana", index: 1 },
-            { address: "some random address on Solana", index: 0 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-    ])(
-      "should return no changes when local data and incoming state have the same data #%#",
-      async ({ localData, incomingState }) => {
-        const result = await manager.resolveIncrementalUpdate(
-          {} as unknown as WalletSyncDataManagerResolutionContext,
-          localData,
-          {},
-          incomingState,
-        );
-        expect(result).toEqual({
-          hasChanges: false,
-        });
-      },
-    );
-
-    it.each([
-      {
-        localData: {} as RecentAddressesState,
-        incomingState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: { ethereum: ["some random address"] } as RecentAddressesState,
-        incomingState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-        },
-        incomingState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-          solana: [{ address: "some random address on Solana", index: 0 }],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-          solana: ["some random address on Solana"],
-        },
-        incomingState: {
-          ethereum: [{ address: "some random address", index: 0 }],
-          solana: [
-            { address: "some random address on Solana", index: 0 },
-            { address: "some random address on Solana 2", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-      {
-        localData: {
-          ethereum: ["some random address"],
-          solana: ["some random address on Solana"],
-        },
-        incomingState: {
-          ethereum: [
-            { address: "some random address", index: 0 },
-            { address: "some random address 2", index: 1 },
-          ],
-          solana: [
-            { address: "some random address on Solana", index: 0 },
-            { address: "some random address on Solana 2", index: 1 },
-          ],
-        } as DistantRecentAddressesState,
-      },
-    ])(
-      "should return changes present local data is different from incoming state #%#",
-      async ({ localData, incomingState }) => {
-        const result = await manager.resolveIncrementalUpdate(
-          {} as unknown as WalletSyncDataManagerResolutionContext,
-          localData,
-          {},
-          incomingState,
-        );
-
-        const update: RecentAddressesState = {};
-        Object.keys(incomingState).forEach(key => {
-          update[key] = incomingState[key]
-            .sort((current, other) => current.index - other.index)
-            .map(data => data.address);
-        });
-
-        expect(result).toEqual({
-          hasChanges: true,
-          update,
-        });
-      },
-    );
-  });
-
-  describe("applyUpdate", () => {
-    it.each([
-      [{}],
-      [{ ethereum: ["some random address"] }],
-      [{ ethereum: ["some random address", "some random address 2"] }],
-    ])("should return updated data #%#", (update: RecentAddressesState) => {
-      const result = manager.applyUpdate({}, update);
-      expect(result).toEqual(update);
-    });
-  });
-});
-
-//sameDistantState x 558,365 ops/sec ±1.50% (96 runs sampled)

package/src/walletsync/modules/recentAddresses.ts

@@ -1,125 +0,0 @@
-/**
- * @module recentAddresses
- *
- * This module is responsible for synchronizing recent addresses across Wallet instances
- * in the WalletSync system. It manages an ordered list of recently used addresses,
- * ensuring that when a user accesses an address on one Live instance, that address
- * (and its position in the recent list) is propagated to all other synchronized Live instances.
- *
- * Recent addresses are off-chain data (not stored on the blockchain), and therefore need to
- * be synchronized through the WalletSync system to ensure consistency across all Live instances.
- *
- * Key responsibilities:
- * - Tracks local recent address changes and prepares them for synchronization
- * - Resolves incoming recent address updates from other Live instances
- * - Maintains the order/index of addresses in the recent list
- * - Handles conflict resolution by accepting incoming state changes (last-write-wins strategy)
- * - Maintains consistency between local state (string[]) and distant state (RecentAddressesState[])
- *
- * The module preserves the index/position of each address, allowing the UI to maintain
- * a consistent ordering of recently used addresses across all synchronized Live instances.
- */
-
-import { z } from "zod";
-import { WalletSyncDataManager } from "../types";
-import { RecentAddressesState } from "@ledgerhq/types-live";
-
-/**
- * We dont use the same data structure for remote state
- * An index attribute has been added to keep the order (recomputed locally)
- */
-export type DistantRecentAddressesState = Record<
-  string,
-  {
-    address: string;
-    index: number;
-  }[]
->;
-
-export function toDistantState(
-  addressesByCurrency: RecentAddressesState,
-): DistantRecentAddressesState {
-  const state: DistantRecentAddressesState = {};
-  Object.keys(addressesByCurrency).forEach(key => {
-    state[key] = addressesByCurrency[key].map((address, index) => ({ address, index }));
-  });
-
-  return state;
-}
-
-export function toState(addressesByCurrency: DistantRecentAddressesState): RecentAddressesState {
-  const state: RecentAddressesState = {};
-  Object.keys(addressesByCurrency).forEach(key => {
-    state[key] = addressesByCurrency[key]
-      .sort((current, other) => current.index - other.index)
-      .map(data => data.address);
-  });
-
-  return state;
-}
-
-function sameDistantState(
-  localData: RecentAddressesState,
-  distantState: DistantRecentAddressesState,
-) {
-  const localDataKeys = Object.keys(localData);
-  const distantStateKeys = Object.keys(distantState);
-  return (
-    localDataKeys.length === distantStateKeys.length &&
-    distantStateKeys.every(key => {
-      return (
-        localData[key] &&
-        localData[key].length === distantState[key].length &&
-        !distantState[key].some(
-          data =>
-            data.index < 0 ||
-            data.index >= localData[key].length ||
-            localData[key][data.index] !== data.address,
-        )
-      );
-    })
-  );
-}
-
-const recentAddressesSchema = z.object({
-  address: z.string(),
-  index: z.number(),
-});
-
-const schema = z.record(z.string(), z.array(recentAddressesSchema));
-
-const manager: WalletSyncDataManager<RecentAddressesState, RecentAddressesState, typeof schema> = {
-  schema,
-  diffLocalToDistant(localData, latestState) {
-    if (!sameDistantState(localData, latestState ?? {})) {
-      return {
-        hasChanges: true,
-        nextState: toDistantState(localData),
-      };
-    }
-
-    return {
-      hasChanges: false,
-      nextState: latestState ?? {},
-    };
-  },
-  async resolveIncrementalUpdate(_ctx, localData, latestState, incomingState) {
-    if (!incomingState) {
-      return { hasChanges: false };
-    }
-
-    if (latestState === incomingState || sameDistantState(localData, incomingState)) {
-      return { hasChanges: false };
-    }
-
-    return {
-      hasChanges: true,
-      update: toState(incomingState),
-    };
-  },
-  applyUpdate(_localData, update) {
-    return update;
-  },
-};
-
-export default manager;