@ledgerhq/coin-hypercore 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ledgerhq/coin-hypercore
 
+## 0.4.0
+
+### Minor Changes
+
+- [#737](https://github.com/LedgerHQ/coin-modules/pull/737) [`8e8c819`](https://github.com/LedgerHQ/coin-modules/commit/8e8c819a2af6d9f47a60ff2f56a6248d55dc271f) Thanks [@YazhuEth](https://github.com/YazhuEth)! - Implement `getBalance` (USDC account balance) and `listOperations` (deposit/withdraw only) for coin-hypercore, backed by the Yield.xyz proxy client
+
+## 0.3.0
+
+### Minor Changes
+
+- [#725](https://github.com/LedgerHQ/coin-modules/pull/725) [`39dd8ef`](https://github.com/LedgerHQ/coin-modules/commit/39dd8ef0eee5974437d6b13925d27cd022d8a940) Thanks [@henri-ly](https://github.com/henri-ly)! - update package to use catalog + hypercore yield client
+
 ## 0.2.1
 
 ### Patch Changes

package/lib/api/getBalance.d.ts

@@ -0,0 +1,3 @@
+import type { Balance } from '@ledgerhq/coin-module-framework/api/types';
+export declare function getBalance(address: string): Promise<Balance[]>;
+//# sourceMappingURL=getBalance.d.ts.map

package/lib/api/getBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBalance.d.ts","sourceRoot":"","sources":["../../src/api/getBalance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2CAA2C,CAAA;AAMxE,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAWpE"}

package/lib/api/getBalance.js

@@ -0,0 +1,21 @@
+"use strict";
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBalance = getBalance;
+const yield_1 = require("../network/yield");
+const utils_1 = require("../utils");
+// The proxy only exposes the USDC collateral, surfaced as the account's native balance:
+// `value` is the total account value, `locked` the margin used by open positions.
+async function getBalance(address) {
+    const { collateral, accountValue, usedMargin } = await (0, yield_1.fetchBalance)(address);
+    const magnitude = collateral.decimals ?? yield_1.USDC_DECIMALS;
+    return [
+        {
+            value: (0, utils_1.scaleToBigInt)(accountValue, magnitude),
+            locked: (0, utils_1.scaleToBigInt)(usedMargin, magnitude),
+            asset: { type: 'native' },
+        },
+    ];
+}
+//# sourceMappingURL=getBalance.js.map

package/lib/api/getBalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBalance.js","sourceRoot":"","sources":["../../src/api/getBalance.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,sCAAsC;;AAQtC,gCAWC;AAhBD,4CAA8D;AAC9D,oCAAwC;AAExC,wFAAwF;AACxF,kFAAkF;AAC3E,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAA;IAC5E,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,IAAI,qBAAa,CAAA;IAEtD,OAAO;QACL;YACE,KAAK,EAAE,IAAA,qBAAa,EAAC,YAAY,EAAE,SAAS,CAAC;YAC7C,MAAM,EAAE,IAAA,qBAAa,EAAC,UAAU,EAAE,SAAS,CAAC;YAC5C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF,CAAA;AACH,CAAC"}

package/lib/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,2CAA2C,CAAA;AAC5F,OAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAE5D,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAuBhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,2CAA2C,CAAA;AAC5F,OAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAI5D,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAuBhE"}

package/lib/api/index.js

@@ -8,6 +8,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createApi = createApi;
 const index_1 = require("@ledgerhq/coin-module-framework/api/index");
 const config_1 = __importDefault(require("../config"));
+const getBalance_1 = require("./getBalance");
+const listOperations_1 = require("./listOperations");
 function createApi(config) {
     config_1.default.setCoinConfig(() => ({ ...config, status: { type: 'active' } }));
     return {
@@ -16,8 +18,8 @@ function createApi(config) {
         getBlock: (0, index_1.notSupported)('getBlock'),
         call: (0, index_1.notSupported)('call'),
         getValidators: (0, index_1.notSupported)('getValidators'),
-        getBalance: (0, index_1.notSupported)('getBalance'),
-        listOperations: (0, index_1.notSupported)('listOperations'),
+        getBalance: getBalance_1.getBalance,
+        listOperations: listOperations_1.listOperations,
         getStakes: (0, index_1.notSupported)('getStakes'),
         getRewards: (0, index_1.notSupported)('getRewards'),
         craftTransaction: (0, index_1.notSupported)('craftTransaction'),

package/lib/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,sCAAsC;;;;;AAKtC,8BAuBC;AA1BD,qEAA4F;AAC5F,uDAA4D;AAE5D,SAAgB,SAAS,CAAC,MAAuB;IAC/C,gBAAU,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,SAAS,EAAE,IAAA,oBAAY,EAAC,WAAW,CAAC;QACpC,YAAY,EAAE,IAAA,oBAAY,EAAC,cAAc,CAAC;QAC1C,QAAQ,EAAE,IAAA,oBAAY,EAAC,UAAU,CAAC;QAClC,IAAI,EAAE,IAAA,oBAAY,EAAC,MAAM,CAAC;QAC1B,aAAa,EAAE,IAAA,oBAAY,EAAC,eAAe,CAAC;QAC5C,UAAU,EAAE,IAAA,oBAAY,EAAC,YAAY,CAAC;QACtC,cAAc,EAAE,IAAA,oBAAY,EAAC,gBAAgB,CAAC;QAC9C,SAAS,EAAE,IAAA,oBAAY,EAAC,WAAW,CAAC;QACpC,UAAU,EAAE,IAAA,oBAAY,EAAC,YAAY,CAAC;QACtC,gBAAgB,EAAE,IAAA,oBAAY,EAAC,kBAAkB,CAAC;QAClD,mBAAmB,EAAE,IAAA,oBAAY,EAAC,qBAAqB,CAAC;QACxD,YAAY,EAAE,IAAA,oBAAY,EAAC,cAAc,CAAC;QAC1C,OAAO,EAAE,IAAA,oBAAY,EAAC,SAAS,CAAC;QAChC,SAAS,EAAE,IAAA,oBAAY,EAAC,WAAW,CAAC;QACpC,cAAc,EAAE,IAAA,oBAAY,EAAC,gBAAgB,CAAC;QAC9C,eAAe,EAAE,IAAA,oBAAY,EAAC,iBAAiB,CAAC;QAChD,eAAe,EAAE,IAAA,oBAAY,EAAC,iBAAiB,CAAC;QAChD,oBAAoB,EAAE,IAAA,oBAAY,EAAC,sBAAsB,CAAC;KAC3D,CAAA;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,sCAAsC;;;;;AAOtC,8BAuBC;AA5BD,qEAA4F;AAC5F,uDAA4D;AAC5D,6CAAyC;AACzC,qDAAiD;AAEjD,SAAgB,SAAS,CAAC,MAAuB;IAC/C,gBAAU,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,SAAS,EAAE,IAAA,oBAAY,EAAC,WAAW,CAAC;QACpC,YAAY,EAAE,IAAA,oBAAY,EAAC,cAAc,CAAC;QAC1C,QAAQ,EAAE,IAAA,oBAAY,EAAC,UAAU,CAAC;QAClC,IAAI,EAAE,IAAA,oBAAY,EAAC,MAAM,CAAC;QAC1B,aAAa,EAAE,IAAA,oBAAY,EAAC,eAAe,CAAC;QAC5C,UAAU,EAAV,uBAAU;QACV,cAAc,EAAd,+BAAc;QACd,SAAS,EAAE,IAAA,oBAAY,EAAC,WAAW,CAAC;QACpC,UAAU,EAAE,IAAA,oBAAY,EAAC,YAAY,CAAC;QACtC,gBAAgB,EAAE,IAAA,oBAAY,EAAC,kBAAkB,CAAC;QAClD,mBAAmB,EAAE,IAAA,oBAAY,EAAC,qBAAqB,CAAC;QACxD,YAAY,EAAE,IAAA,oBAAY,EAAC,cAAc,CAAC;QAC1C,OAAO,EAAE,IAAA,oBAAY,EAAC,SAAS,CAAC;QAChC,SAAS,EAAE,IAAA,oBAAY,EAAC,WAAW,CAAC;QACpC,cAAc,EAAE,IAAA,oBAAY,EAAC,gBAAgB,CAAC;QAC9C,eAAe,EAAE,IAAA,oBAAY,EAAC,iBAAiB,CAAC;QAChD,eAAe,EAAE,IAAA,oBAAY,EAAC,iBAAiB,CAAC;QAChD,oBAAoB,EAAE,IAAA,oBAAY,EAAC,sBAAsB,CAAC;KAC3D,CAAA;AACH,CAAC"}

package/lib/api/listOperations.d.ts

@@ -0,0 +1,3 @@
+import type { ListOperationsOptions, Operation, Page } from '@ledgerhq/coin-module-framework/api/types';
+export declare function listOperations(address: string, { minHeight, cursor, limit, order }: ListOperationsOptions): Promise<Page<Operation>>;
+//# sourceMappingURL=listOperations.d.ts.map

package/lib/api/listOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listOperations.d.ts","sourceRoot":"","sources":["../../src/api/listOperations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,SAAS,EACT,IAAI,EACL,MAAM,2CAA2C,CAAA;AAmDlD,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,qBAAqB,GACzD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAsB1B"}

package/lib/api/listOperations.js

@@ -0,0 +1,64 @@
+"use strict";
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listOperations = listOperations;
+const yield_1 = require("../network/yield");
+const utils_1 = require("../utils");
+const DEFAULT_LIMIT = 100;
+// Deposits/withdrawals that actually settled — drafts (status CREATED) have no completedAt.
+function isSettledTransfer(action) {
+    const isTransfer = action.action === yield_1.FUND_ACTION || action.action === yield_1.WITHDRAW_ACTION;
+    return isTransfer && action.completedAt !== null;
+}
+function toOperation(address, dto) {
+    const isDeposit = dto.action === yield_1.FUND_ACTION;
+    const amount = dto.summary?.amount ?? '0';
+    const date = new Date(dto.completedAt ?? dto.createdAt);
+    return {
+        id: `${address}-${dto.id}`,
+        type: isDeposit ? 'IN' : 'OUT',
+        senders: [address],
+        recipients: [address],
+        value: (0, utils_1.scaleToBigInt)(amount, yield_1.USDC_DECIMALS),
+        asset: { type: 'native' },
+        tx: {
+            hash: dto.id,
+            // HyperCore actions have no block height on this API.
+            block: { height: 0, hash: '', time: date },
+            fees: 0n,
+            date,
+            failed: dto.status.toUpperCase() === 'FAILED',
+        },
+    };
+}
+// The proxy only supports offset pagination, so the cursor is the numeric offset.
+function parseCursor(cursor) {
+    if (cursor === undefined)
+        return 0;
+    const offset = Number(cursor);
+    if (!Number.isInteger(offset) || offset < 0) {
+        throw new Error(`listOperations received an invalid cursor: ${cursor}`);
+    }
+    return offset;
+}
+async function listOperations(address, { minHeight, cursor, limit, order }) {
+    // The proxy has no block height and always returns actions newest-first (descending).
+    if (minHeight > 0) {
+        throw new Error('listOperations with a minHeight is not supported');
+    }
+    if (order === 'asc') {
+        throw new Error('listOperations with an ascending order is not supported');
+    }
+    const offset = parseCursor(cursor);
+    const pageLimit = limit ?? DEFAULT_LIMIT;
+    const page = await (0, yield_1.fetchActions)(address, offset, pageLimit);
+    const items = page.items.filter(isSettledTransfer).map((action) => toOperation(address, action));
+    // Advance by raw items consumed, not the filtered count, so no action is skipped.
+    // The cursor is offset-based (volatile if new actions appear between calls); the proxy
+    // exposes no stable id/date-based pagination.
+    const nextOffset = offset + page.items.length;
+    const next = nextOffset < page.total ? String(nextOffset) : undefined;
+    return { items, next };
+}
+//# sourceMappingURL=listOperations.js.map

package/lib/api/listOperations.js.map

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

package/lib/network/yield.d.ts

@@ -0,0 +1,38 @@
+export declare const USDC_DECIMALS = 6;
+export declare const FUND_ACTION = "fund";
+export declare const WITHDRAW_ACTION = "withdraw";
+export type TokenDto = {
+    symbol: string;
+    network: string;
+    name?: string;
+    decimals?: number;
+    address?: string | null;
+    logoURI?: string | null;
+};
+export type YieldBalanceDto = {
+    providerId: string;
+    collateral: TokenDto;
+    accountValue: number;
+    usedMargin: number;
+    availableBalance: number;
+    unrealizedPnl: number;
+};
+export declare function fetchBalance(address: string): Promise<YieldBalanceDto>;
+export type ActionDto = {
+    id: string;
+    action: string;
+    status: string;
+    summary: {
+        amount: string;
+    } | null;
+    createdAt: string;
+    completedAt: string | null;
+};
+export type ActionsPage = {
+    total: number;
+    offset: number;
+    limit: number;
+    items: ActionDto[];
+};
+export declare function fetchActions(address: string, offset: number, limit: number): Promise<ActionsPage>;
+//# sourceMappingURL=yield.d.ts.map

package/lib/network/yield.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield.d.ts","sourceRoot":"","sources":["../../src/network/yield.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,aAAa,IAAI,CAAA;AAE9B,eAAO,MAAM,WAAW,SAAS,CAAA;AACjC,eAAO,MAAM,eAAe,aAAa,CAAA;AAEzC,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IAEf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,QAAQ,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAO5E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IAEd,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,SAAS,EAAE,CAAA;CACnB,CAAA;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAOtB"}

package/lib/network/yield.js

@@ -0,0 +1,36 @@
+"use strict";
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WITHDRAW_ACTION = exports.FUND_ACTION = exports.USDC_DECIMALS = void 0;
+exports.fetchBalance = fetchBalance;
+exports.fetchActions = fetchActions;
+const live_network_1 = __importDefault(require("@ledgerhq/live-network"));
+const config_1 = __importDefault(require("../config"));
+const PROVIDER_ID = 'hyperliquid';
+const getBaseUrl = () => config_1.default.getCoinConfig().node;
+// The collateral is USDC and the proxy omits its decimals.
+exports.USDC_DECIMALS = 6;
+// A deposit is the `fund` action, a withdrawal the `withdraw` action.
+exports.FUND_ACTION = 'fund';
+exports.WITHDRAW_ACTION = 'withdraw';
+async function fetchBalance(address) {
+    const { data } = await (0, live_network_1.default)({
+        method: 'POST',
+        url: `${getBaseUrl()}/v1/balances`,
+        data: { providerId: PROVIDER_ID, address },
+    });
+    return data;
+}
+async function fetchActions(address, offset, limit) {
+    const { data } = await (0, live_network_1.default)({
+        method: 'GET',
+        url: `${getBaseUrl()}/v1/actions`,
+        params: { address, offset, limit, providerId: PROVIDER_ID },
+    });
+    return data;
+}
+//# sourceMappingURL=yield.js.map

package/lib/network/yield.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield.js","sourceRoot":"","sources":["../../src/network/yield.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,sCAAsC;;;;;;AAiCtC,oCAOC;AAmBD,oCAWC;AApED,0EAA4C;AAC5C,uDAAkC;AAElC,MAAM,WAAW,GAAG,aAAa,CAAA;AACjC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,gBAAU,CAAC,aAAa,EAAE,CAAC,IAAI,CAAA;AAExD,2DAA2D;AAC9C,QAAA,aAAa,GAAG,CAAC,CAAA;AAC9B,sEAAsE;AACzD,QAAA,WAAW,GAAG,MAAM,CAAA;AACpB,QAAA,eAAe,GAAG,UAAU,CAAA;AAqBlC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,sBAAO,EAAkB;QAC9C,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,GAAG,UAAU,EAAE,cAAc;QAClC,IAAI,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE;KAC3C,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC;AAmBM,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,MAAc,EACd,KAAa;IAEb,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,sBAAO,EAAc;QAC1C,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,GAAG,UAAU,EAAE,aAAa;QACjC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE;KAC5D,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC"}

package/lib/utils/index.d.ts

@@ -0,0 +1,2 @@
+export declare function scaleToBigInt(amount: string | number, magnitude: number): bigint;
+//# sourceMappingURL=index.d.ts.map

package/lib/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhF"}

package/lib/utils/index.js

@@ -0,0 +1,11 @@
+"use strict";
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaleToBigInt = scaleToBigInt;
+const currencies_1 = require("@ledgerhq/coin-module-framework/currencies");
+// Convert a decimal amount into its integer base-unit representation.
+function scaleToBigInt(amount, magnitude) {
+    return BigInt((0, currencies_1.parseCurrencyUnit)({ name: '', code: '', magnitude }, String(amount)).toFixed());
+}
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,sCAAsC;;AAKtC,sCAEC;AALD,2EAA8E;AAE9E,sEAAsE;AACtE,SAAgB,aAAa,CAAC,MAAuB,EAAE,SAAiB;IACtE,OAAO,MAAM,CAAC,IAAA,8BAAiB,EAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;AAC/F,CAAC"}

package/lib-es/api/getBalance.d.ts

@@ -0,0 +1,3 @@
+import type { Balance } from '@ledgerhq/coin-module-framework/api/types';
+export declare function getBalance(address: string): Promise<Balance[]>;
+//# sourceMappingURL=getBalance.d.ts.map

package/lib-es/api/getBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBalance.d.ts","sourceRoot":"","sources":["../../src/api/getBalance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2CAA2C,CAAA;AAMxE,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAWpE"}

package/lib-es/api/getBalance.js

@@ -0,0 +1,18 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+import { USDC_DECIMALS, fetchBalance } from '../network/yield';
+import { scaleToBigInt } from '../utils';
+// The proxy only exposes the USDC collateral, surfaced as the account's native balance:
+// `value` is the total account value, `locked` the margin used by open positions.
+export async function getBalance(address) {
+    const { collateral, accountValue, usedMargin } = await fetchBalance(address);
+    const magnitude = collateral.decimals ?? USDC_DECIMALS;
+    return [
+        {
+            value: scaleToBigInt(accountValue, magnitude),
+            locked: scaleToBigInt(usedMargin, magnitude),
+            asset: { type: 'native' },
+        },
+    ];
+}
+//# sourceMappingURL=getBalance.js.map

package/lib-es/api/getBalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBalance.js","sourceRoot":"","sources":["../../src/api/getBalance.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sCAAsC;AAGtC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,wFAAwF;AACxF,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;IAC5E,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,IAAI,aAAa,CAAA;IAEtD,OAAO;QACL;YACE,KAAK,EAAE,aAAa,CAAC,YAAY,EAAE,SAAS,CAAC;YAC7C,MAAM,EAAE,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC;YAC5C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF,CAAA;AACH,CAAC"}

package/lib-es/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,2CAA2C,CAAA;AAC5F,OAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAE5D,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAuBhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,2CAA2C,CAAA;AAC5F,OAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAI5D,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAuBhE"}

package/lib-es/api/index.js

@@ -2,6 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 import { notSupported } from '@ledgerhq/coin-module-framework/api/index';
 import coinConfig from '../config';
+import { getBalance } from './getBalance';
+import { listOperations } from './listOperations';
 export function createApi(config) {
     coinConfig.setCoinConfig(() => ({ ...config, status: { type: 'active' } }));
     return {
@@ -10,8 +12,8 @@ export function createApi(config) {
         getBlock: notSupported('getBlock'),
         call: notSupported('call'),
         getValidators: notSupported('getValidators'),
-        getBalance: notSupported('getBalance'),
-        listOperations: notSupported('listOperations'),
+        getBalance,
+        listOperations,
         getStakes: notSupported('getStakes'),
         getRewards: notSupported('getRewards'),
         craftTransaction: notSupported('craftTransaction'),

package/lib-es/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sCAAsC;AAEtC,OAAO,EAAsB,YAAY,EAAE,MAAM,2CAA2C,CAAA;AAC5F,OAAO,UAAoC,MAAM,WAAW,CAAA;AAE5D,MAAM,UAAU,SAAS,CAAC,MAAuB;IAC/C,UAAU,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC;QACpC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC;QAC1C,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC;QAClC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC;QAC1B,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC;QAC5C,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;QACtC,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC;QAC9C,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC;QACpC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;QACtC,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC;QAClD,mBAAmB,EAAE,YAAY,CAAC,qBAAqB,CAAC;QACxD,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC;QAC1C,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC;QAChC,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC;QACpC,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC;QAC9C,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC;QAChD,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC;QAChD,oBAAoB,EAAE,YAAY,CAAC,sBAAsB,CAAC;KAC3D,CAAA;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sCAAsC;AAEtC,OAAO,EAAsB,YAAY,EAAE,MAAM,2CAA2C,CAAA;AAC5F,OAAO,UAAoC,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,UAAU,SAAS,CAAC,MAAuB;IAC/C,UAAU,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC;QACpC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC;QAC1C,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC;QAClC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC;QAC1B,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC;QAC5C,UAAU;QACV,cAAc;QACd,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC;QACpC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;QACtC,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC;QAClD,mBAAmB,EAAE,YAAY,CAAC,qBAAqB,CAAC;QACxD,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC;QAC1C,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC;QAChC,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC;QACpC,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC;QAC9C,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC;QAChD,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC;QAChD,oBAAoB,EAAE,YAAY,CAAC,sBAAsB,CAAC;KAC3D,CAAA;AACH,CAAC"}

package/lib-es/api/listOperations.d.ts

@@ -0,0 +1,3 @@
+import type { ListOperationsOptions, Operation, Page } from '@ledgerhq/coin-module-framework/api/types';
+export declare function listOperations(address: string, { minHeight, cursor, limit, order }: ListOperationsOptions): Promise<Page<Operation>>;
+//# sourceMappingURL=listOperations.d.ts.map

package/lib-es/api/listOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listOperations.d.ts","sourceRoot":"","sources":["../../src/api/listOperations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,SAAS,EACT,IAAI,EACL,MAAM,2CAA2C,CAAA;AAmDlD,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,qBAAqB,GACzD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAsB1B"}

package/lib-es/api/listOperations.js

@@ -0,0 +1,61 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+import { FUND_ACTION, USDC_DECIMALS, WITHDRAW_ACTION, fetchActions, } from '../network/yield';
+import { scaleToBigInt } from '../utils';
+const DEFAULT_LIMIT = 100;
+// Deposits/withdrawals that actually settled — drafts (status CREATED) have no completedAt.
+function isSettledTransfer(action) {
+    const isTransfer = action.action === FUND_ACTION || action.action === WITHDRAW_ACTION;
+    return isTransfer && action.completedAt !== null;
+}
+function toOperation(address, dto) {
+    const isDeposit = dto.action === FUND_ACTION;
+    const amount = dto.summary?.amount ?? '0';
+    const date = new Date(dto.completedAt ?? dto.createdAt);
+    return {
+        id: `${address}-${dto.id}`,
+        type: isDeposit ? 'IN' : 'OUT',
+        senders: [address],
+        recipients: [address],
+        value: scaleToBigInt(amount, USDC_DECIMALS),
+        asset: { type: 'native' },
+        tx: {
+            hash: dto.id,
+            // HyperCore actions have no block height on this API.
+            block: { height: 0, hash: '', time: date },
+            fees: 0n,
+            date,
+            failed: dto.status.toUpperCase() === 'FAILED',
+        },
+    };
+}
+// The proxy only supports offset pagination, so the cursor is the numeric offset.
+function parseCursor(cursor) {
+    if (cursor === undefined)
+        return 0;
+    const offset = Number(cursor);
+    if (!Number.isInteger(offset) || offset < 0) {
+        throw new Error(`listOperations received an invalid cursor: ${cursor}`);
+    }
+    return offset;
+}
+export async function listOperations(address, { minHeight, cursor, limit, order }) {
+    // The proxy has no block height and always returns actions newest-first (descending).
+    if (minHeight > 0) {
+        throw new Error('listOperations with a minHeight is not supported');
+    }
+    if (order === 'asc') {
+        throw new Error('listOperations with an ascending order is not supported');
+    }
+    const offset = parseCursor(cursor);
+    const pageLimit = limit ?? DEFAULT_LIMIT;
+    const page = await fetchActions(address, offset, pageLimit);
+    const items = page.items.filter(isSettledTransfer).map((action) => toOperation(address, action));
+    // Advance by raw items consumed, not the filtered count, so no action is skipped.
+    // The cursor is offset-based (volatile if new actions appear between calls); the proxy
+    // exposes no stable id/date-based pagination.
+    const nextOffset = offset + page.items.length;
+    const next = nextOffset < page.total ? String(nextOffset) : undefined;
+    return { items, next };
+}
+//# sourceMappingURL=listOperations.js.map

package/lib-es/api/listOperations.js.map

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

package/lib-es/network/yield.d.ts

@@ -0,0 +1,38 @@
+export declare const USDC_DECIMALS = 6;
+export declare const FUND_ACTION = "fund";
+export declare const WITHDRAW_ACTION = "withdraw";
+export type TokenDto = {
+    symbol: string;
+    network: string;
+    name?: string;
+    decimals?: number;
+    address?: string | null;
+    logoURI?: string | null;
+};
+export type YieldBalanceDto = {
+    providerId: string;
+    collateral: TokenDto;
+    accountValue: number;
+    usedMargin: number;
+    availableBalance: number;
+    unrealizedPnl: number;
+};
+export declare function fetchBalance(address: string): Promise<YieldBalanceDto>;
+export type ActionDto = {
+    id: string;
+    action: string;
+    status: string;
+    summary: {
+        amount: string;
+    } | null;
+    createdAt: string;
+    completedAt: string | null;
+};
+export type ActionsPage = {
+    total: number;
+    offset: number;
+    limit: number;
+    items: ActionDto[];
+};
+export declare function fetchActions(address: string, offset: number, limit: number): Promise<ActionsPage>;
+//# sourceMappingURL=yield.d.ts.map

package/lib-es/network/yield.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield.d.ts","sourceRoot":"","sources":["../../src/network/yield.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,aAAa,IAAI,CAAA;AAE9B,eAAO,MAAM,WAAW,SAAS,CAAA;AACjC,eAAO,MAAM,eAAe,aAAa,CAAA;AAEzC,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IAEf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,QAAQ,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAO5E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IAEd,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,SAAS,EAAE,CAAA;CACnB,CAAA;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAOtB"}

package/lib-es/network/yield.js

@@ -0,0 +1,28 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+import network from '@ledgerhq/live-network';
+import coinConfig from '../config';
+const PROVIDER_ID = 'hyperliquid';
+const getBaseUrl = () => coinConfig.getCoinConfig().node;
+// The collateral is USDC and the proxy omits its decimals.
+export const USDC_DECIMALS = 6;
+// A deposit is the `fund` action, a withdrawal the `withdraw` action.
+export const FUND_ACTION = 'fund';
+export const WITHDRAW_ACTION = 'withdraw';
+export async function fetchBalance(address) {
+    const { data } = await network({
+        method: 'POST',
+        url: `${getBaseUrl()}/v1/balances`,
+        data: { providerId: PROVIDER_ID, address },
+    });
+    return data;
+}
+export async function fetchActions(address, offset, limit) {
+    const { data } = await network({
+        method: 'GET',
+        url: `${getBaseUrl()}/v1/actions`,
+        params: { address, offset, limit, providerId: PROVIDER_ID },
+    });
+    return data;
+}
+//# sourceMappingURL=yield.js.map

package/lib-es/network/yield.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield.js","sourceRoot":"","sources":["../../src/network/yield.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sCAAsC;AAEtC,OAAO,OAAO,MAAM,wBAAwB,CAAA;AAC5C,OAAO,UAAU,MAAM,WAAW,CAAA;AAElC,MAAM,WAAW,GAAG,aAAa,CAAA;AACjC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,IAAI,CAAA;AAExD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAA;AAC9B,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAA;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAA;AAqBzC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAkB;QAC9C,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,GAAG,UAAU,EAAE,cAAc;QAClC,IAAI,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE;KAC3C,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC;AAmBD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,MAAc,EACd,KAAa;IAEb,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAc;QAC1C,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,GAAG,UAAU,EAAE,aAAa;QACjC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE;KAC5D,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC"}

package/lib-es/utils/index.d.ts

@@ -0,0 +1,2 @@
+export declare function scaleToBigInt(amount: string | number, magnitude: number): bigint;
+//# sourceMappingURL=index.d.ts.map

package/lib-es/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhF"}

package/lib-es/utils/index.js

@@ -0,0 +1,8 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+import { parseCurrencyUnit } from '@ledgerhq/coin-module-framework/currencies';
+// Convert a decimal amount into its integer base-unit representation.
+export function scaleToBigInt(amount, magnitude) {
+    return BigInt(parseCurrencyUnit({ name: '', code: '', magnitude }, String(amount)).toFixed());
+}
+//# sourceMappingURL=index.js.map

package/lib-es/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sCAAsC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAA;AAE9E,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,MAAuB,EAAE,SAAiB;IACtE,OAAO,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;AAC/F,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ledgerhq/coin-hypercore",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Ledger Hypercore Coin integration",
   "keywords": [
     "Ledger",
@@ -65,7 +65,7 @@
   "author": "LEDGER SAS",
   "license": "Apache-2.0",
   "dependencies": {
-    "@ledgerhq/coin-module-framework": "^4.0.0"
+    "@ledgerhq/coin-module-framework": "^4.0.1"
   },
   "devDependencies": {
     "@swc/core": "1.15.11",

package/src/api/getBalance.test.ts

@@ -0,0 +1,66 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import network from '@ledgerhq/live-network'
+import coinConfig from '../config'
+import { getBalance } from './getBalance'
+
+jest.mock('@ledgerhq/live-network')
+
+const mockNetwork = jest.mocked(network)
+
+beforeAll(() => {
+  coinConfig.setCoinConfig(() => ({
+    node: 'https://perps.live.ledger.com/proxy/perps',
+    status: { type: 'active' },
+  }))
+})
+
+afterEach(() => {
+  mockNetwork.mockClear()
+})
+
+describe('getBalance', () => {
+  it('maps the USDC collateral to a single native balance', async () => {
+    mockNetwork.mockResolvedValueOnce({
+      status: 200,
+      data: {
+        providerId: 'hyperliquid',
+        collateral: { symbol: 'USDC', network: 'hyperliquid' },
+        accountValue: 557.13644,
+        usedMargin: 20,
+        availableBalance: 537.13644,
+        unrealizedPnl: 0,
+      },
+    })
+
+    const balances = await getBalance('0xabc')
+
+    expect(balances).toEqual([
+      {
+        value: 557_136_440n,
+        locked: 20_000_000n,
+        asset: { type: 'native' },
+      },
+    ])
+  })
+
+  it('handles a zero balance without throwing', async () => {
+    mockNetwork.mockResolvedValueOnce({
+      status: 200,
+      data: {
+        providerId: 'hyperliquid',
+        collateral: { symbol: 'USDC', network: 'hyperliquid' },
+        accountValue: 0,
+        usedMargin: 0,
+        availableBalance: 0,
+        unrealizedPnl: 0,
+      },
+    })
+
+    const balances = await getBalance('0xabc')
+
+    expect(balances[0].value).toBe(0n)
+    expect(balances[0].locked).toBe(0n)
+  })
+})

package/src/api/getBalance.ts

@@ -0,0 +1,21 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Balance } from '@ledgerhq/coin-module-framework/api/types'
+import { USDC_DECIMALS, fetchBalance } from '../network/yield'
+import { scaleToBigInt } from '../utils'
+
+// The proxy only exposes the USDC collateral, surfaced as the account's native balance:
+// `value` is the total account value, `locked` the margin used by open positions.
+export async function getBalance(address: string): Promise<Balance[]> {
+  const { collateral, accountValue, usedMargin } = await fetchBalance(address)
+  const magnitude = collateral.decimals ?? USDC_DECIMALS
+
+  return [
+    {
+      value: scaleToBigInt(accountValue, magnitude),
+      locked: scaleToBigInt(usedMargin, magnitude),
+      asset: { type: 'native' },
+    },
+  ]
+}

package/src/api/index.integ.test.ts

@@ -3,6 +3,10 @@
 
 import { createApi } from '.'
 
+const NODE = 'https://perps.live.ledger.com/proxy/perps'
+// A real account with USDC collateral and settled fund/withdraw history, for read-only assertions.
+const ADDRESS = '0x90D5b3f3FaA3cd61fBd78bF1CE3DdB2100F4BFb2'
+
 describe('Hypercore Api (Alpaca stub)', () => {
   const api = createApi({ node: 'https://api.hyperliquid.xyz' })
 
@@ -11,8 +15,6 @@ describe('Hypercore Api (Alpaca stub)', () => {
     'getBlockInfo',
     'getBlock',
     'getValidators',
-    'getBalance',
-    'listOperations',
     'getStakes',
     'getRewards',
     'craftTransaction',
@@ -28,3 +30,53 @@ describe('Hypercore Api (Alpaca stub)', () => {
     expect(api[name]).toThrow('not supported')
   })
 })
+
+describe('Hypercore Api (Alpaca)', () => {
+  const api = createApi({ node: NODE })
+
+  describe('getBalance', () => {
+    it('returns the USDC-denominated account balance', async () => {
+      const balances = await api.getBalance(ADDRESS)
+
+      expect(balances).toHaveLength(1)
+      const [balance] = balances
+      expect(balance.asset.type).toBe('native')
+      expect(typeof balance.value).toBe('bigint')
+      expect(balance.value).toBeGreaterThanOrEqual(0n)
+      expect(balance.locked ?? 0n).toBeGreaterThanOrEqual(0n)
+    })
+  })
+
+  describe('listOperations', () => {
+    it('returns settled deposit/withdraw operations across all pages', async () => {
+      // Small limit to force several pages and exercise cursor chaining end-to-end.
+      const first = await api.listOperations(ADDRESS, { minHeight: 0, limit: 20 })
+      const all = [...first.items]
+      let cursor = first.next
+      while (cursor !== undefined && all.length < 10_000) {
+        const page = await api.listOperations(ADDRESS, { minHeight: 0, cursor, limit: 20 })
+        all.push(...page.items)
+        cursor = page.next
+      }
+
+      expect(all.length).toBeGreaterThan(0)
+      for (const op of all) {
+        expect(['IN', 'OUT']).toContain(op.type)
+        expect(op.senders).toContain(ADDRESS)
+        expect(op.recipients).toContain(ADDRESS)
+        expect(op.value).toBeGreaterThan(0n)
+        expect(op.tx.date).toBeInstanceOf(Date)
+        expect(op.tx.fees).toBe(0n)
+      }
+      // This account has both deposits (IN) and withdrawals (OUT).
+      expect(all.some((op) => op.type === 'IN')).toBe(true)
+      expect(all.some((op) => op.type === 'OUT')).toBe(true)
+    })
+
+    it('rejects a non-zero minHeight', async () => {
+      await expect(api.listOperations(ADDRESS, { minHeight: 1 })).rejects.toThrow(
+        'minHeight is not supported'
+      )
+    })
+  })
+})

package/src/api/index.ts

@@ -3,6 +3,8 @@
 
 import { type CoinModuleApi, notSupported } from '@ledgerhq/coin-module-framework/api/index'
 import coinConfig, { type HypercoreConfig } from '../config'
+import { getBalance } from './getBalance'
+import { listOperations } from './listOperations'
 
 export function createApi(config: HypercoreConfig): CoinModuleApi {
   coinConfig.setCoinConfig(() => ({ ...config, status: { type: 'active' } }))
@@ -13,8 +15,8 @@ export function createApi(config: HypercoreConfig): CoinModuleApi {
     getBlock: notSupported('getBlock'),
     call: notSupported('call'),
     getValidators: notSupported('getValidators'),
-    getBalance: notSupported('getBalance'),
-    listOperations: notSupported('listOperations'),
+    getBalance,
+    listOperations,
     getStakes: notSupported('getStakes'),
     getRewards: notSupported('getRewards'),
     craftTransaction: notSupported('craftTransaction'),

package/src/api/listOperations.test.ts

@@ -0,0 +1,163 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import network from '@ledgerhq/live-network'
+import coinConfig from '../config'
+import { listOperations } from './listOperations'
+
+jest.mock('@ledgerhq/live-network')
+
+const mockNetwork = jest.mocked(network)
+
+const ADDRESS = '0xabc'
+
+beforeAll(() => {
+  coinConfig.setCoinConfig(() => ({
+    node: 'https://perps.live.ledger.com/proxy/perps',
+    status: { type: 'active' },
+  }))
+})
+
+afterEach(() => {
+  mockNetwork.mockClear()
+})
+
+function action(overrides: Record<string, unknown>) {
+  return {
+    id: 'id-1',
+    action: 'fund',
+    status: 'SUCCESS',
+    summary: { amount: '10.5' },
+    createdAt: '2026-01-01T00:00:00.000Z',
+    completedAt: '2026-01-01T00:01:00.000Z',
+    ...overrides,
+  }
+}
+
+describe('listOperations', () => {
+  it('keeps only fund/withdraw actions and maps them to IN/OUT', async () => {
+    mockNetwork.mockResolvedValueOnce({
+      status: 200,
+      data: {
+        total: 3,
+        offset: 0,
+        limit: 100,
+        items: [
+          action({ id: 'dep', action: 'fund', summary: { amount: '10.5' } }),
+          action({ id: 'wit', action: 'withdraw', summary: { amount: '4' } }),
+          action({ id: 'opn', action: 'open', summary: null }),
+        ],
+      },
+    })
+
+    const { items, next } = await listOperations(ADDRESS, { minHeight: 0 })
+
+    expect(items).toHaveLength(2)
+    expect(items[0]).toMatchObject({
+      id: `${ADDRESS}-dep`,
+      type: 'IN',
+      value: 10_500_000n,
+      senders: [ADDRESS],
+      recipients: [ADDRESS],
+      asset: { type: 'native' },
+    })
+    expect(items[0].tx).toMatchObject({ hash: 'dep', fees: 0n, failed: false })
+    expect(items[1]).toMatchObject({ id: `${ADDRESS}-wit`, type: 'OUT', value: 4_000_000n })
+    expect(next).toBeUndefined()
+  })
+
+  it('excludes drafts that never settled (no completedAt)', async () => {
+    mockNetwork.mockResolvedValueOnce({
+      status: 200,
+      data: {
+        total: 2,
+        offset: 0,
+        limit: 100,
+        items: [
+          action({ id: 'settled', completedAt: '2026-01-01T00:01:00.000Z' }),
+          action({ id: 'draft', status: 'CREATED', completedAt: null }),
+        ],
+      },
+    })
+
+    const { items } = await listOperations(ADDRESS, { minHeight: 0 })
+
+    expect(items).toHaveLength(1)
+    expect(items[0].id).toBe(`${ADDRESS}-settled`)
+  })
+
+  it('marks failed actions', async () => {
+    mockNetwork.mockResolvedValueOnce({
+      status: 200,
+      data: {
+        total: 1,
+        offset: 0,
+        limit: 100,
+        items: [action({ id: 'dep', status: 'FAILED' })],
+      },
+    })
+
+    const { items } = await listOperations(ADDRESS, { minHeight: 0 })
+
+    expect(items[0].tx.failed).toBe(true)
+  })
+
+  it('computes the next cursor from the raw page size and total', async () => {
+    mockNetwork.mockResolvedValueOnce({
+      status: 200,
+      data: {
+        total: 10,
+        offset: 0,
+        limit: 2,
+        items: [action({ id: 'a' }), action({ id: 'b', action: 'open', summary: null })],
+      },
+    })
+
+    const { items, next } = await listOperations(ADDRESS, { minHeight: 0, limit: 2 })
+
+    // Only one fund/withdraw kept, but the cursor advances by the two raw items consumed.
+    expect(items).toHaveLength(1)
+    expect(next).toBe('2')
+    expect(mockNetwork).toHaveBeenCalledWith(
+      expect.objectContaining({
+        params: { address: ADDRESS, offset: 0, limit: 2, providerId: 'hyperliquid' },
+      })
+    )
+  })
+
+  it('passes the cursor as offset on subsequent pages', async () => {
+    mockNetwork.mockResolvedValueOnce({
+      status: 200,
+      data: { total: 10, offset: 2, limit: 2, items: [] },
+    })
+
+    await listOperations(ADDRESS, { minHeight: 0, cursor: '2', limit: 2 })
+
+    expect(mockNetwork).toHaveBeenCalledWith(
+      expect.objectContaining({
+        params: { address: ADDRESS, offset: 2, limit: 2, providerId: 'hyperliquid' },
+      })
+    )
+  })
+
+  it('rejects a non-zero minHeight', async () => {
+    await expect(listOperations(ADDRESS, { minHeight: 5 })).rejects.toThrow(
+      'minHeight is not supported'
+    )
+    expect(mockNetwork).not.toHaveBeenCalled()
+  })
+
+  it('rejects an ascending order', async () => {
+    await expect(listOperations(ADDRESS, { minHeight: 0, order: 'asc' })).rejects.toThrow(
+      'ascending order is not supported'
+    )
+    expect(mockNetwork).not.toHaveBeenCalled()
+  })
+
+  it('rejects an invalid cursor', async () => {
+    await expect(listOperations(ADDRESS, { minHeight: 0, cursor: 'not-a-number' })).rejects.toThrow(
+      'invalid cursor'
+    )
+    expect(mockNetwork).not.toHaveBeenCalled()
+  })
+})

package/src/api/listOperations.ts

@@ -0,0 +1,84 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import type {
+  ListOperationsOptions,
+  Operation,
+  Page,
+} from '@ledgerhq/coin-module-framework/api/types'
+import {
+  type ActionDto,
+  FUND_ACTION,
+  USDC_DECIMALS,
+  WITHDRAW_ACTION,
+  fetchActions,
+} from '../network/yield'
+import { scaleToBigInt } from '../utils'
+
+const DEFAULT_LIMIT = 100
+
+// Deposits/withdrawals that actually settled — drafts (status CREATED) have no completedAt.
+function isSettledTransfer(action: ActionDto): boolean {
+  const isTransfer = action.action === FUND_ACTION || action.action === WITHDRAW_ACTION
+  return isTransfer && action.completedAt !== null
+}
+
+function toOperation(address: string, dto: ActionDto): Operation {
+  const isDeposit = dto.action === FUND_ACTION
+  const amount = dto.summary?.amount ?? '0'
+  const date = new Date(dto.completedAt ?? dto.createdAt)
+
+  return {
+    id: `${address}-${dto.id}`,
+    type: isDeposit ? 'IN' : 'OUT',
+    senders: [address],
+    recipients: [address],
+    value: scaleToBigInt(amount, USDC_DECIMALS),
+    asset: { type: 'native' },
+    tx: {
+      hash: dto.id,
+      // HyperCore actions have no block height on this API.
+      block: { height: 0, hash: '', time: date },
+      fees: 0n,
+      date,
+      failed: dto.status.toUpperCase() === 'FAILED',
+    },
+  }
+}
+
+// The proxy only supports offset pagination, so the cursor is the numeric offset.
+function parseCursor(cursor: string | undefined): number {
+  if (cursor === undefined) return 0
+  const offset = Number(cursor)
+  if (!Number.isInteger(offset) || offset < 0) {
+    throw new Error(`listOperations received an invalid cursor: ${cursor}`)
+  }
+  return offset
+}
+
+export async function listOperations(
+  address: string,
+  { minHeight, cursor, limit, order }: ListOperationsOptions
+): Promise<Page<Operation>> {
+  // The proxy has no block height and always returns actions newest-first (descending).
+  if (minHeight > 0) {
+    throw new Error('listOperations with a minHeight is not supported')
+  }
+  if (order === 'asc') {
+    throw new Error('listOperations with an ascending order is not supported')
+  }
+
+  const offset = parseCursor(cursor)
+  const pageLimit = limit ?? DEFAULT_LIMIT
+  const page = await fetchActions(address, offset, pageLimit)
+
+  const items = page.items.filter(isSettledTransfer).map((action) => toOperation(address, action))
+
+  // Advance by raw items consumed, not the filtered count, so no action is skipped.
+  // The cursor is offset-based (volatile if new actions appear between calls); the proxy
+  // exposes no stable id/date-based pagination.
+  const nextOffset = offset + page.items.length
+  const next = nextOffset < page.total ? String(nextOffset) : undefined
+
+  return { items, next }
+}

package/src/network/yield.test.ts

@@ -0,0 +1,72 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import network from '@ledgerhq/live-network'
+import coinConfig from '../config'
+import { fetchBalance, fetchActions } from './yield'
+
+jest.mock('@ledgerhq/live-network')
+
+const mockNetwork = jest.mocked(network)
+
+const BASE_CONFIG = { node: 'https://perps.live.ledger.com/proxy/perps' }
+
+beforeAll(() => {
+  coinConfig.setCoinConfig(() => ({ ...BASE_CONFIG, status: { type: 'active' } }))
+})
+
+afterEach(() => {
+  mockNetwork.mockClear()
+})
+
+const COLLATERAL = {
+  symbol: 'USDC',
+  name: 'USD Coin',
+  network: 'arbitrum',
+  decimals: 6,
+  address: null,
+  logoURI: null,
+}
+
+describe('fetchBalance', () => {
+  it('calls POST /v1/balances with correct args', async () => {
+    const dto = {
+      providerId: 'hyperliquid',
+      collateral: COLLATERAL,
+      accountValue: 100,
+      usedMargin: 20,
+      availableBalance: 80,
+      unrealizedPnl: 5,
+    }
+    mockNetwork.mockResolvedValueOnce({ status: 200, data: dto })
+
+    const result = await fetchBalance('0xabc')
+
+    expect(mockNetwork).toHaveBeenCalledWith(
+      expect.objectContaining({
+        method: 'POST',
+        url: 'https://perps.live.ledger.com/proxy/perps/v1/balances',
+        data: { providerId: 'hyperliquid', address: '0xabc' },
+      })
+    )
+    expect(result).toEqual(dto)
+  })
+})
+
+describe('fetchActions', () => {
+  it('calls GET /v1/actions with correct args', async () => {
+    const dto = { total: 0, offset: 10, limit: 100, items: [] }
+    mockNetwork.mockResolvedValueOnce({ status: 200, data: dto })
+
+    const result = await fetchActions('0xabc', 10, 100)
+
+    expect(mockNetwork).toHaveBeenCalledWith(
+      expect.objectContaining({
+        method: 'GET',
+        url: 'https://perps.live.ledger.com/proxy/perps/v1/actions',
+        params: { address: '0xabc', offset: 10, limit: 100, providerId: 'hyperliquid' },
+      })
+    )
+    expect(result).toEqual(dto)
+  })
+})

package/src/network/yield.ts

@@ -0,0 +1,72 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import network from '@ledgerhq/live-network'
+import coinConfig from '../config'
+
+const PROVIDER_ID = 'hyperliquid'
+const getBaseUrl = () => coinConfig.getCoinConfig().node
+
+// The collateral is USDC and the proxy omits its decimals.
+export const USDC_DECIMALS = 6
+// A deposit is the `fund` action, a withdrawal the `withdraw` action.
+export const FUND_ACTION = 'fund'
+export const WITHDRAW_ACTION = 'withdraw'
+
+export type TokenDto = {
+  symbol: string
+  network: string
+  // The proxy omits these fields for the perps collateral, so they are optional.
+  name?: string
+  decimals?: number
+  address?: string | null
+  logoURI?: string | null
+}
+
+export type YieldBalanceDto = {
+  providerId: string
+  collateral: TokenDto
+  accountValue: number
+  usedMargin: number
+  availableBalance: number
+  unrealizedPnl: number
+}
+
+export async function fetchBalance(address: string): Promise<YieldBalanceDto> {
+  const { data } = await network<YieldBalanceDto>({
+    method: 'POST',
+    url: `${getBaseUrl()}/v1/balances`,
+    data: { providerId: PROVIDER_ID, address },
+  })
+  return data
+}
+
+export type ActionDto = {
+  id: string
+  action: string
+  status: string
+  // `summary` is null for some action types.
+  summary: { amount: string } | null
+  createdAt: string
+  completedAt: string | null
+}
+
+export type ActionsPage = {
+  total: number
+  offset: number
+  limit: number
+  items: ActionDto[]
+}
+
+export async function fetchActions(
+  address: string,
+  offset: number,
+  limit: number
+): Promise<ActionsPage> {
+  const { data } = await network<ActionsPage>({
+    method: 'GET',
+    url: `${getBaseUrl()}/v1/actions`,
+    params: { address, offset, limit, providerId: PROVIDER_ID },
+  })
+  return data
+}

package/src/utils/index.test.ts

@@ -0,0 +1,20 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import { scaleToBigInt } from '.'
+
+describe('scaleToBigInt', () => {
+  it.each([
+    ['557.13644', 6, 557_136_440n],
+    [557.13644, 6, 557_136_440n],
+    ['0', 6, 0n],
+    [0, 6, 0n],
+    ['10', 6, 10_000_000n],
+    ['0.000001', 6, 1n],
+    // extra fractional digits are rounded (framework uses BigNumber.integerValue)
+    ['1.2345678', 6, 1_234_568n],
+    ['-3.5', 6, -3_500_000n],
+  ])('scales %s with %i decimals', (amount, magnitude, expected) => {
+    expect(scaleToBigInt(amount, magnitude)).toBe(expected)
+  })
+})

package/src/utils/index.ts

@@ -0,0 +1,9 @@
+// SPDX-FileCopyrightText: © 2024 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import { parseCurrencyUnit } from '@ledgerhq/coin-module-framework/currencies'
+
+// Convert a decimal amount into its integer base-unit representation.
+export function scaleToBigInt(amount: string | number, magnitude: number): bigint {
+  return BigInt(parseCurrencyUnit({ name: '', code: '', magnitude }, String(amount)).toFixed())
+}