@ledgerhq/wallet-pnl 0.2.0-nightly.20260513030606

package/.eslintrc.js

@@ -0,0 +1,28 @@
+module.exports = {
+  env: {
+    browser: true,
+    es6: true,
+  },
+  globals: {
+    Atomics: "readonly",
+    SharedArrayBuffer: "readonly",
+  },
+  extends: ["plugin:import/typescript"],
+  plugins: ["import"],
+  rules: {
+    "no-console": ["error", { allow: ["warn", "error"] }],
+    "linebreak-style": ["error", "unix"],
+    "@typescript-eslint/no-empty-function": "off",
+    "@typescript-eslint/no-namespace": ["error", { allowDeclarations: true }],
+    "@typescript-eslint/no-explicit-any": "warn",
+  },
+  overrides: [
+    {
+      files: ["src/**/*.test.{ts,tsx}"],
+      env: {
+        "jest/globals": true,
+      },
+      plugins: ["jest"],
+    },
+  ],
+};

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @ledgerhq/wallet-pnl
+
+## 0.2.0-nightly.20260513030606
+
+### Minor Changes
+
+- [#17343](https://github.com/LedgerHQ/ledger-live/pull/17343) [`f753ec7`](https://github.com/LedgerHQ/ledger-live/commit/f753ec7f73a870fc4b9f24d213f399773bc50600) Thanks [@mcayuelas-ledger](https://github.com/mcayuelas-ledger)! - Add `@ledgerhq/wallet-pnl`: average cost basis PnL (per-asset and portfolio), operation classification, countervalue-backed cost basis cache.
+
+### Patch Changes
+
+- Updated dependencies [[`f39fede`](https://github.com/LedgerHQ/ledger-live/commit/f39fede0a6eb4e427a15219e5a3c8fbc3302815f), [`ed0dc8a`](https://github.com/LedgerHQ/ledger-live/commit/ed0dc8abc2c8f5054e655c4e12efe6fb433fbaca), [`b812751`](https://github.com/LedgerHQ/ledger-live/commit/b8127519474e63c543b1b937a2d3b11ad162a78e), [`4ddd97a`](https://github.com/LedgerHQ/ledger-live/commit/4ddd97a99bab5b581ad5ccfd36eb420ec4ee6352), [`3b746ee`](https://github.com/LedgerHQ/ledger-live/commit/3b746eea7f3f2be633947e8e9112987457c864a5), [`7fafa10`](https://github.com/LedgerHQ/ledger-live/commit/7fafa10d8af581f4433a60ea908980a726d3a777), [`ac26c8b`](https://github.com/LedgerHQ/ledger-live/commit/ac26c8bffa9b5cc9f28bed5ce3d44e32982d655c), [`1368afd`](https://github.com/LedgerHQ/ledger-live/commit/1368afdc7218a68c803672e6e412f8f9f6e62142), [`fb79639`](https://github.com/LedgerHQ/ledger-live/commit/fb79639eb81258bae4830ed6ffe375ae625054ad), [`0d11df6`](https://github.com/LedgerHQ/ledger-live/commit/0d11df6ef8dc781171071824ad1c39e3beed7730), [`321a0e2`](https://github.com/LedgerHQ/ledger-live/commit/321a0e2ce948fac11f7bdf0e106eb0af57168caa), [`3cd7abb`](https://github.com/LedgerHQ/ledger-live/commit/3cd7abb4d6f6072bad62073108d797faf23f9e8c), [`6e832a0`](https://github.com/LedgerHQ/ledger-live/commit/6e832a044bd7abb704f0a45ea782e55c1b25487c), [`21e69fe`](https://github.com/LedgerHQ/ledger-live/commit/21e69fea49cffc0b1204903e539a64b83e4b28f0), [`2257d43`](https://github.com/LedgerHQ/ledger-live/commit/2257d43630933127549300f39ade1e2b01f94cb8), [`08762c2`](https://github.com/LedgerHQ/ledger-live/commit/08762c286e38136293108c19efa72ae8fbd1286b), [`fb4d165`](https://github.com/LedgerHQ/ledger-live/commit/fb4d1656be8dc8e933e55600970a2e991fbaeebb), [`73bfe05`](https://github.com/LedgerHQ/ledger-live/commit/73bfe055ec23e0d630f2da9f4dbc9731b6fe5190)]:
+  - @ledgerhq/types-live@6.107.0-nightly.20260513030606
+  - @ledgerhq/ledger-wallet-framework@1.4.0-nightly.20260513030606
+  - @ledgerhq/cryptoassets@13.47.0-nightly.20260513030606
+  - @ledgerhq/live-countervalues@0.18.3-nightly.20260513030606

package/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2017-present Ledger https://www.ledger.com/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/jest.config.js

@@ -0,0 +1,25 @@
+module.exports = {
+  transform: {
+    "^.+\\.(ts|tsx)?$": [
+      "@swc/jest",
+      {
+        jsc: {
+          target: "esnext",
+          transform: {
+            react: {
+              runtime: "automatic",
+            },
+          },
+        },
+      },
+    ],
+  },
+  testEnvironment: "jsdom",
+  testPathIgnorePatterns: ["lib/", "lib-es/", "helpers/"],
+  coverageReporters: ["json", ["lcov", { file: "lcov.info", projectRoot: "../../" }], "text"],
+  reporters: [
+    "default",
+    ...(process.env.CI ? ["github-actions"] : []),
+    ["jest-sonar", { outputName: "sonar-executionTests-report.xml", reportedFilePath: "absolute" }],
+  ],
+};

package/lib/assetPnL.d.ts

@@ -0,0 +1,6 @@
+import type { AccountLike } from "@ledgerhq/types-live";
+import type { Currency } from "@ledgerhq/types-cryptoassets";
+import type { CounterValuesState } from "@ledgerhq/live-countervalues/types";
+import type { AssetPnL, ComputePnLOptions } from "./types";
+export declare function computeAssetPnL(account: AccountLike, countervalues: CounterValuesState, fiat: Currency, options?: ComputePnLOptions): AssetPnL | null;
+//# sourceMappingURL=assetPnL.d.ts.map

package/lib/assetPnL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetPnL.d.ts","sourceRoot":"","sources":["../src/assetPnL.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAI7E,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAkB,MAAM,SAAS,CAAC;AAI3E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,kBAAkB,EACjC,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,QAAQ,GAAG,IAAI,CAwDjB"}

package/lib/assetPnL.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeAssetPnL = computeAssetPnL;
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
+const logic_1 = require("@ledgerhq/live-countervalues/logic");
+const account_1 = require("@ledgerhq/ledger-wallet-framework/account");
+const costBasisCache_1 = require("./costBasisCache");
+const costBasisReconciliation_1 = require("./costBasisReconciliation");
+const ZERO = new bignumber_js_1.default(0);
+function computeAssetPnL(account, countervalues, fiat, options) {
+    const asset = (0, account_1.getAccountCurrency)(account);
+    const rawState = (0, costBasisCache_1.getCostBasis)(account, fiat, countervalues, options);
+    const hasOps = account.operations.length > 0;
+    const hasBalance = account.balance.gt(0);
+    if (!hasOps && !hasBalance)
+        return null;
+    // Reconciliation defaults to ON: if the chain says the wallet holds X and
+    // the cost-basis reducer thinks Y, we close the gap so consumers don't see
+    // a wildly negative `unrealisedPnL` on tokens whose disposals weren't
+    // captured (typical ERC-20 `transferFrom`-after-`APPROVE` flows). Callers
+    // that need raw, op-only values can pass `reconcileWithBalance: false`.
+    //
+    // Detection (`detectBalanceGap`) is pure and always cheap; only the actual
+    // repair (`applyBalanceReconciliation`) is gated on the opt-in flag. This
+    // keeps the diagnostic available for downstream UIs even when the repair
+    // is suppressed.
+    const apply = options?.reconcileWithBalance !== false;
+    const gap = (0, costBasisReconciliation_1.detectBalanceGap)(rawState, account.balance);
+    let state = rawState;
+    let applied = false;
+    if (apply && !gap.isClean) {
+        const result = (0, costBasisReconciliation_1.applyBalanceReconciliation)(rawState, gap, asset, fiat, countervalues);
+        state = result.state;
+        applied = result.applied;
+    }
+    const reconciliation = { ...gap, applied };
+    const hasHistory = !state.totalAmount.isZero() || !state.realisedPnL.isZero();
+    let unrealisedPnL = ZERO;
+    if (hasBalance) {
+        const latestCV = (0, logic_1.calculate)(countervalues, {
+            value: account.balance.toNumber(),
+            from: asset,
+            to: fiat,
+            disableRounding: true,
+        });
+        if (typeof latestCV === "number") {
+            unrealisedPnL = new bignumber_js_1.default(latestCV).minus(state.totalCostInCounterValue);
+        }
+        else if (!hasHistory) {
+            return null;
+        }
+    }
+    return {
+        unrealisedPnL,
+        realisedPnL: state.realisedPnL,
+        totalPnL: state.realisedPnL.plus(unrealisedPnL),
+        costBasis: state.totalCostInCounterValue,
+        lifetimeCost: state.lifetimeCostInCounterValue,
+        averageEntryPrice: state.averageEntryPrice,
+        reconciliation,
+    };
+}
+//# sourceMappingURL=assetPnL.js.map

package/lib/assetPnL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetPnL.js","sourceRoot":"","sources":["../src/assetPnL.ts"],"names":[],"mappings":";;;;;AAYA,0CA6DC;AAzED,gEAAqC;AAGrC,8DAA+D;AAE/D,uEAA+E;AAC/E,qDAAgD;AAChD,uEAAyF;AAGzF,MAAM,IAAI,GAAG,IAAI,sBAAS,CAAC,CAAC,CAAC,CAAC;AAE9B,SAAgB,eAAe,CAC7B,OAAoB,EACpB,aAAiC,EACjC,IAAc,EACd,OAA2B;IAE3B,MAAM,KAAK,GAAG,IAAA,4BAAkB,EAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAA,6BAAY,EAAC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzC,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAExC,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,0EAA0E;IAC1E,wEAAwE;IACxE,EAAE;IACF,2EAA2E;IAC3E,0EAA0E;IAC1E,yEAAyE;IACzE,iBAAiB;IACjB,MAAM,KAAK,GAAG,OAAO,EAAE,oBAAoB,KAAK,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,IAAA,0CAAgB,EAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,KAAK,GAAG,QAAQ,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAA,oDAA0B,EAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QACrF,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACrB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,CAAC;IACD,MAAM,cAAc,GAAmB,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC;IAE3D,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IAE9E,IAAI,aAAa,GAAG,IAAI,CAAC;IACzB,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAA,iBAAS,EAAC,aAAa,EAAE;YACxC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;YACjC,IAAI,EAAE,KAAK;YACX,EAAE,EAAE,IAAI;YACR,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QACH,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,aAAa,GAAG,IAAI,sBAAS,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC/E,CAAC;aAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa;QACb,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC;QAC/C,SAAS,EAAE,KAAK,CAAC,uBAAuB;QACxC,YAAY,EAAE,KAAK,CAAC,0BAA0B;QAC9C,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,cAAc;KACf,CAAC;AACJ,CAAC"}

package/lib/classifyOperation.d.ts

@@ -0,0 +1,29 @@
+import type { Operation, OperationType } from "@ledgerhq/types-live";
+import type { OperationFlow } from "./types";
+/**
+ * Operation types that move asset INTO the account from a cost-basis
+ * perspective. Derived from the canonical
+ * {@link OPERATION_TYPE_IN_FAMILY} taxonomy of `@ledgerhq/ledger-wallet-framework`,
+ * extended with DeFi types not modelled at the framework level
+ * (`SUPPLY`, `NFT_IN`).
+ */
+export declare const INFLOWS: ReadonlySet<OperationType | string>;
+/**
+ * Operation types that move asset OUT of the account from a cost-basis
+ * perspective. Derived from the canonical
+ * {@link OPERATION_TYPE_OUT_FAMILY} taxonomy of `@ledgerhq/ledger-wallet-framework`,
+ * extended with DeFi types not modelled at the framework level
+ * (`REDEEM`, `SELL`, `NFT_OUT`).
+ *
+ * Note: `OPERATION_TYPE_STAKE_FAMILY` ops (`BOND`, `STAKE`, `APPROVE`,
+ * `WITHDRAW_UNBONDED`, ...) are intentionally NOT included — they only move
+ * fees, not principal, so they're treated as `"ignored"` by `classifyOperation`.
+ */
+export declare const OUTFLOWS: ReadonlySet<OperationType | string>;
+/**
+ * Stake-family ops are exposed for callers (and tests) that need to assert
+ * they're treated as no-ops by the cost-basis reducer.
+ */
+export declare const STAKE_FAMILY: ReadonlySet<OperationType | string>;
+export declare function classifyOperation(op: Operation): OperationFlow;
+//# sourceMappingURL=classifyOperation.d.ts.map

package/lib/classifyOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifyOperation.d.ts","sourceRoot":"","sources":["../src/classifyOperation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,aAAa,GAAG,MAAM,CAItD,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,aAAa,GAAG,MAAM,CAKvD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,aAAa,GAAG,MAAM,CAE5D,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa,CAK9D"}

package/lib/classifyOperation.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STAKE_FAMILY = exports.OUTFLOWS = exports.INFLOWS = void 0;
+exports.classifyOperation = classifyOperation;
+const operation_1 = require("@ledgerhq/ledger-wallet-framework/operation");
+/**
+ * Operation types that move asset INTO the account from a cost-basis
+ * perspective. Derived from the canonical
+ * {@link OPERATION_TYPE_IN_FAMILY} taxonomy of `@ledgerhq/ledger-wallet-framework`,
+ * extended with DeFi types not modelled at the framework level
+ * (`SUPPLY`, `NFT_IN`).
+ */
+exports.INFLOWS = new Set([
+    ...operation_1.OPERATION_TYPE_IN_FAMILY,
+    "NFT_IN",
+    "SUPPLY",
+]);
+/**
+ * Operation types that move asset OUT of the account from a cost-basis
+ * perspective. Derived from the canonical
+ * {@link OPERATION_TYPE_OUT_FAMILY} taxonomy of `@ledgerhq/ledger-wallet-framework`,
+ * extended with DeFi types not modelled at the framework level
+ * (`REDEEM`, `SELL`, `NFT_OUT`).
+ *
+ * Note: `OPERATION_TYPE_STAKE_FAMILY` ops (`BOND`, `STAKE`, `APPROVE`,
+ * `WITHDRAW_UNBONDED`, ...) are intentionally NOT included — they only move
+ * fees, not principal, so they're treated as `"ignored"` by `classifyOperation`.
+ */
+exports.OUTFLOWS = new Set([
+    ...operation_1.OPERATION_TYPE_OUT_FAMILY,
+    "NFT_OUT",
+    "REDEEM",
+    "SELL",
+]);
+/**
+ * Stake-family ops are exposed for callers (and tests) that need to assert
+ * they're treated as no-ops by the cost-basis reducer.
+ */
+exports.STAKE_FAMILY = new Set(operation_1.OPERATION_TYPE_STAKE_FAMILY);
+function classifyOperation(op) {
+    if (op.hasFailed)
+        return "ignored";
+    if (exports.INFLOWS.has(op.type))
+        return "inflow";
+    if (exports.OUTFLOWS.has(op.type))
+        return "outflow";
+    return "ignored";
+}
+//# sourceMappingURL=classifyOperation.js.map

package/lib/classifyOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifyOperation.js","sourceRoot":"","sources":["../src/classifyOperation.ts"],"names":[],"mappings":";;;AA+CA,8CAKC;AAnDD,2EAIqD;AAGrD;;;;;;GAMG;AACU,QAAA,OAAO,GAAwC,IAAI,GAAG,CAAyB;IAC1F,GAAG,oCAAwB;IAC3B,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACU,QAAA,QAAQ,GAAwC,IAAI,GAAG,CAAyB;IAC3F,GAAG,qCAAyB;IAC5B,SAAS;IACT,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,YAAY,GAAwC,IAAI,GAAG,CACtE,uCAA2B,CAC5B,CAAC;AAEF,SAAgB,iBAAiB,CAAC,EAAa;IAC7C,IAAI,EAAE,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,eAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,IAAI,gBAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/costBasis.d.ts

@@ -0,0 +1,14 @@
+import type { AccountLike, Operation } from "@ledgerhq/types-live";
+import type { Currency } from "@ledgerhq/types-cryptoassets";
+import type { CounterValuesState } from "@ledgerhq/live-countervalues/types";
+import type { ComputePnLOptions, CostBasisState } from "./types";
+export declare const initialCostBasisState: CostBasisState;
+/**
+ * Append-only ACB reducer. Folds `newOps` into `prev` and returns a new
+ * `CostBasisState`. Reads ONLY historical countervalues at op dates — never
+ * `latest` — so the result is stable under price ticks.
+ *
+ * Returns `prev` (same reference) when nothing new applies.
+ */
+export declare function reduceCostBasis(prev: CostBasisState, newOps: Operation[], account: AccountLike, countervalues: CounterValuesState, fiat: Currency, options?: ComputePnLOptions): CostBasisState;
+//# sourceMappingURL=costBasis.d.ts.map

package/lib/costBasis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costBasis.d.ts","sourceRoot":"","sources":["../src/costBasis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,KAAK,EAAE,iBAAiB,EAAgB,cAAc,EAAiB,MAAM,SAAS,CAAC;AAI9F,eAAO,MAAM,qBAAqB,EAAE,cAQnC,CAAC;AA2EF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,kBAAkB,EACjC,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,cAAc,CA+ChB"}

package/lib/costBasis.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initialCostBasisState = void 0;
+exports.reduceCostBasis = reduceCostBasis;
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
+const logic_1 = require("@ledgerhq/live-countervalues/logic");
+const account_1 = require("@ledgerhq/ledger-wallet-framework/account");
+const classifyOperation_1 = require("./classifyOperation");
+const ZERO = new bignumber_js_1.default(0);
+exports.initialCostBasisState = {
+    totalAmount: ZERO,
+    totalCostInCounterValue: ZERO,
+    lifetimeCostInCounterValue: ZERO,
+    realisedPnL: ZERO,
+    averageEntryPrice: ZERO,
+    lastOperationId: null,
+    lastOperationDate: null,
+};
+function compareOps(a, b) {
+    const da = a.date.getTime();
+    const db = b.date.getTime();
+    if (da !== db)
+        return da - db;
+    if (a.id < b.id)
+        return -1;
+    if (a.id > b.id)
+        return 1;
+    return 0;
+}
+function isAfterBookmark(op, prev) {
+    if (prev.lastOperationDate === null)
+        return true;
+    const opTime = op.date.getTime();
+    const bookTime = prev.lastOperationDate.getTime();
+    if (opTime > bookTime)
+        return true;
+    if (opTime < bookTime)
+        return false;
+    return prev.lastOperationId !== null && op.id > prev.lastOperationId;
+}
+function applyInflow(acc, value, cvBN) {
+    const totalCost = acc.totalCost.plus(cvBN);
+    const totalAmount = acc.totalAmount.plus(value);
+    return {
+        totalAmount,
+        totalCost,
+        lifetimeCost: acc.lifetimeCost.plus(cvBN),
+        realised: acc.realised,
+        averageEntryPrice: totalAmount.gt(0) ? totalCost.div(totalAmount) : acc.averageEntryPrice,
+    };
+}
+function applyOutflow(acc, value, cvBN) {
+    if (acc.totalAmount.lte(0))
+        return acc;
+    const sold = bignumber_js_1.default.minimum(value, acc.totalAmount);
+    const costOfSale = sold.times(acc.averageEntryPrice);
+    // Scale exit CV proportionally when we clamped a sell that exceeded held amount.
+    const exitCV = sold.eq(value) ? cvBN : cvBN.times(sold).div(value);
+    return {
+        totalAmount: acc.totalAmount.minus(sold),
+        totalCost: acc.totalCost.minus(costOfSale),
+        // `lifetimeCost` is intentionally untouched on sells — it represents
+        // "money put in over the lifetime of the position", not the running
+        // basis of remaining coins.
+        lifetimeCost: acc.lifetimeCost,
+        realised: acc.realised.plus(exitCV.minus(costOfSale)),
+        averageEntryPrice: acc.averageEntryPrice,
+    };
+}
+function applyOperation(acc, op, flow, asset, fiat, countervalues) {
+    if (op.value.isZero() || op.value.isNegative())
+        return acc;
+    const cvAtDate = (0, logic_1.calculate)(countervalues, {
+        value: op.value.toNumber(),
+        from: asset,
+        to: fiat,
+        date: op.date,
+        disableRounding: true,
+    });
+    if (typeof cvAtDate !== "number")
+        return acc;
+    const cvBN = new bignumber_js_1.default(cvAtDate);
+    return flow === "inflow" ? applyInflow(acc, op.value, cvBN) : applyOutflow(acc, op.value, cvBN);
+}
+/**
+ * Append-only ACB reducer. Folds `newOps` into `prev` and returns a new
+ * `CostBasisState`. Reads ONLY historical countervalues at op dates — never
+ * `latest` — so the result is stable under price ticks.
+ *
+ * Returns `prev` (same reference) when nothing new applies.
+ */
+function reduceCostBasis(prev, newOps, account, countervalues, fiat, options) {
+    if (newOps.length === 0)
+        return prev;
+    const pending = [];
+    for (const op of newOps) {
+        if (isAfterBookmark(op, prev))
+            pending.push(op);
+    }
+    if (pending.length === 0)
+        return prev;
+    pending.sort(compareOps);
+    const asset = (0, account_1.getAccountCurrency)(account);
+    const isSpam = options?.isSpamOperation;
+    let acc = {
+        totalAmount: prev.totalAmount,
+        totalCost: prev.totalCostInCounterValue,
+        lifetimeCost: prev.lifetimeCostInCounterValue,
+        realised: prev.realisedPnL,
+        averageEntryPrice: prev.averageEntryPrice,
+    };
+    let lastOperationId = prev.lastOperationId;
+    let lastOperationDate = prev.lastOperationDate;
+    for (const op of pending) {
+        // Advance the bookmark for every seen op (even ignored ones) so that
+        // re-passing the same ops is a true no-op.
+        lastOperationId = op.id;
+        lastOperationDate = op.date;
+        if (isSpam?.(op, account))
+            continue;
+        const flow = (0, classifyOperation_1.classifyOperation)(op);
+        if (flow === "ignored")
+            continue;
+        acc = applyOperation(acc, op, flow, asset, fiat, countervalues);
+    }
+    return {
+        totalAmount: acc.totalAmount,
+        totalCostInCounterValue: acc.totalCost,
+        lifetimeCostInCounterValue: acc.lifetimeCost,
+        realisedPnL: acc.realised,
+        averageEntryPrice: acc.averageEntryPrice,
+        lastOperationId,
+        lastOperationDate,
+    };
+}
+//# sourceMappingURL=costBasis.js.map

package/lib/costBasis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costBasis.js","sourceRoot":"","sources":["../src/costBasis.ts"],"names":[],"mappings":"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"}

package/lib/costBasisCache.d.ts

@@ -0,0 +1,7 @@
+import type { AccountLike } from "@ledgerhq/types-live";
+import type { Currency } from "@ledgerhq/types-cryptoassets";
+import type { CounterValuesState } from "@ledgerhq/live-countervalues/types";
+import type { ComputePnLOptions, CostBasisState } from "./types";
+export declare function getCostBasis(account: AccountLike, fiat: Currency, countervalues: CounterValuesState, options?: ComputePnLOptions): CostBasisState;
+export declare function invalidatePnLCache(accountId?: string): void;
+//# sourceMappingURL=costBasisCache.d.ts.map

package/lib/costBasisCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costBasisCache.d.ts","sourceRoot":"","sources":["../src/costBasisCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiCjE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,kBAAkB,EACjC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,cAAc,CAgChB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAS3D"}

package/lib/costBasisCache.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCostBasis = getCostBasis;
+exports.invalidatePnLCache = invalidatePnLCache;
+const logic_1 = require("@ledgerhq/live-countervalues/logic");
+const helpers_1 = require("@ledgerhq/live-countervalues/helpers");
+const account_1 = require("@ledgerhq/ledger-wallet-framework/account");
+const costBasis_1 = require("./costBasis");
+const cache = new Map();
+function getHistoryKey(state, from, to, lastOpDate) {
+    if ((0, helpers_1.inferCurrencyAPIID)(from) === (0, helpers_1.inferCurrencyAPIID)(to))
+        return "identity";
+    const pairCache = (0, logic_1.lenseRateMap)(state, { from, to });
+    if (!pairCache)
+        return "noCV";
+    const { oldest, earliest, earliestStableDate } = pairCache.stats;
+    const bucket = lastOpDate ? (0, helpers_1.formatCounterValueDay)(lastOpDate) : "0";
+    const earliestRelevant = earliest && earliest <= bucket ? earliest : "";
+    return `${oldest ?? "_"}|${earliestStableDate ?? "_"}|${earliestRelevant}`;
+}
+function getLastOpBookmark(account) {
+    const ops = account.operations;
+    if (ops.length === 0)
+        return { id: "_", date: null };
+    let best = ops[0];
+    for (let i = 1; i < ops.length; i++) {
+        const op = ops[i];
+        const opTime = op.date.getTime();
+        const bestTime = best.date.getTime();
+        if (opTime > bestTime || (opTime === bestTime && op.id > best.id))
+            best = op;
+    }
+    return { id: best.id, date: best.date };
+}
+function getCostBasis(account, fiat, countervalues, options) {
+    const asset = (0, account_1.getAccountCurrency)(account);
+    if (options?.isSpamOperation) {
+        return (0, costBasis_1.reduceCostBasis)(costBasis_1.initialCostBasisState, account.operations, account, countervalues, fiat, options);
+    }
+    const { id: lastOpId, date: lastOpDate } = getLastOpBookmark(account);
+    const historyKey = getHistoryKey(countervalues, asset, fiat, lastOpDate);
+    const fiatKey = (0, helpers_1.inferCurrencyAPIID)(fiat);
+    const key = `${account.id}|${fiatKey}|${lastOpId}|${historyKey}`;
+    const hit = cache.get(key);
+    if (hit)
+        return hit;
+    const fresh = (0, costBasis_1.reduceCostBasis)(costBasis_1.initialCostBasisState, account.operations, account, countervalues, fiat, options);
+    cache.set(key, fresh);
+    return fresh;
+}
+function invalidatePnLCache(accountId) {
+    if (!accountId) {
+        cache.clear();
+        return;
+    }
+    const prefix = `${accountId}|`;
+    for (const key of cache.keys()) {
+        if (key.startsWith(prefix))
+            cache.delete(key);
+    }
+}
+//# sourceMappingURL=costBasisCache.js.map

package/lib/costBasisCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costBasisCache.js","sourceRoot":"","sources":["../src/costBasisCache.ts"],"names":[],"mappings":"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"}

package/lib/costBasisReconciliation.d.ts

@@ -0,0 +1,59 @@
+import BigNumber from "bignumber.js";
+import type { Currency } from "@ledgerhq/types-cryptoassets";
+import type { CounterValuesState } from "@ledgerhq/live-countervalues/types";
+import type { CostBasisState, Reconciliation } from "./types";
+/**
+ * Pure detection: compares the operations-derived `state.totalAmount` to the
+ * on-chain `balance` and returns the diagnostic. **Never** does any I/O on
+ * countervalues, **never** mutates state, **always** returns `applied: false`.
+ *
+ * The repair step is a separate concern — see {@link applyBalanceReconciliation}.
+ * This split lets callers detect anomalies (UI badges, audit logs) without
+ * paying the cost of the heuristic repair, and keeps the reducer pipeline
+ * trivially testable.
+ */
+export declare function detectBalanceGap(state: CostBasisState, balance: BigNumber): Reconciliation;
+/**
+ * Opinionated repair: when the `gap` shows a non-zero `delta`, folds a
+ * synthetic operation into the cost-basis state to close it.
+ *
+ * - `delta > 0` → synthetic INFLOW valued at the latest counter-value
+ *                 (rebase tokens, missing IN op…). Pushes the average
+ *                 entry price toward the latest market.
+ * - `delta < 0` → synthetic OUTFLOW priced at `state.lastOperationDate`
+ *                 (best-effort proxy for the unknown disposal date).
+ *                 The realised gain/loss equals `delta_value − sold × AEP`.
+ *
+ * `lifetimeCostInCounterValue` is intentionally NEVER touched here, even on
+ * a positive delta: rebase yield / silent accruals are not real cash
+ * investments, so they would distort a "% vs invested" KPI.
+ *
+ * Returns `applied: false` (and an unchanged state) when:
+ * - the gap is clean,
+ * - the counter-value lookup for the delta fails,
+ * - or a negative delta hits an empty position.
+ *
+ * Callers that want the combined detect+repair flow with the legacy signature
+ * should use {@link reconcileCostBasisWithBalance}.
+ */
+export declare function applyBalanceReconciliation(state: CostBasisState, gap: Reconciliation, asset: Currency, fiat: Currency, countervalues: CounterValuesState): {
+    state: CostBasisState;
+    applied: boolean;
+};
+/**
+ * Legacy combined detect+repair entry point, preserved for API stability.
+ * New code should prefer composing {@link detectBalanceGap} and
+ * {@link applyBalanceReconciliation} explicitly so the conditional mutation
+ * is obvious to the reader.
+ *
+ * Always returns the {@link Reconciliation} diagnostic so callers can flag
+ * the result in the UI (e.g. show a warning badge on the asset row).
+ *
+ * If `apply` is `false`, the gap is detected but no repair is attempted —
+ * `applied` will be `false` regardless of the delta.
+ */
+export declare function reconcileCostBasisWithBalance(state: CostBasisState, balance: BigNumber, asset: Currency, fiat: Currency, countervalues: CounterValuesState, apply: boolean): {
+    state: CostBasisState;
+    reconciliation: Reconciliation;
+};
+//# sourceMappingURL=costBasisReconciliation.d.ts.map

package/lib/costBasisReconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costBasisReconciliation.d.ts","sourceRoot":"","sources":["../src/costBasisReconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,GAAG,cAAc,CAS1F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,kBAAkB,GAChC;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA8D7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,SAAS,EAClB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,kBAAkB,EACjC,KAAK,EAAE,OAAO,GACb;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,cAAc,CAAA;CAAE,CAY3D"}