@ledgerhq/coin-canton 0.3.0 → 0.4.0-nightly.0

package/lib-es/network/node.unit.test.js

@@ -0,0 +1,26 @@
+// myModule.test.ts
+import { getLedgerEnd, generateJWT } from "./node";
+import coinConfig from "../config";
+jest.mock("@ledgerhq/live-network", () => jest.fn().mockResolvedValue({ data: { offset: 12345 } }));
+describe("generateJWT", () => {
+    it("should generate a valid JWT format", () => {
+        const jwt = generateJWT();
+        expect(jwt.split(".")).toHaveLength(3);
+    });
+});
+describe("getLedgerEnd", () => {
+    beforeAll(() => {
+        coinConfig.setCoinConfig(() => ({
+            nodeUrl: "http://node-url",
+            networkType: "mainnet",
+            status: {
+                type: "active",
+            },
+        }));
+    });
+    it("should return the ledger offset from API response", async () => {
+        const result = await getLedgerEnd();
+        expect(result).toBe(12345);
+    });
+});
+//# sourceMappingURL=node.unit.test.js.map

package/lib-es/network/node.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.unit.test.js","sourceRoot":"","sources":["../../src/network/node.unit.test.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,UAAU,MAAM,WAAW,CAAC;AAEnC,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpG,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;YAC9B,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,SAAS;YACtB,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;aACf;SACF,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib-es/types/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/types/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,SAAS,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG;IAC5C,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG;IAClD,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,CAAC"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/types/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,SAAS,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG;IAC5C,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG;IAClD,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ledgerhq/coin-canton",
-  "version": "0.3.0",
+  "version": "0.4.0-nightly.0",
   "description": "Canton coin integration",
   "keywords": [
     "Ledger",
@@ -101,12 +101,12 @@
     "bignumber.js": "^9.1.2",
     "invariant": "^2.2.4",
     "rxjs": "^7.8.1",
-    "@ledgerhq/coin-framework": "^6.2.0",
-    "@ledgerhq/cryptoassets": "^13.26.0",
-    "@ledgerhq/devices": "8.5.0",
-    "@ledgerhq/errors": "^6.24.0",
-    "@ledgerhq/live-env": "^2.14.0",
-    "@ledgerhq/live-network": "^2.0.15",
+    "@ledgerhq/coin-framework": "^6.2.1-nightly.0",
+    "@ledgerhq/cryptoassets": "^13.27.0-nightly.0",
+    "@ledgerhq/devices": "8.5.1-nightly.0",
+    "@ledgerhq/errors": "^6.25.0-nightly.0",
+    "@ledgerhq/live-env": "^2.15.0-nightly.1",
+    "@ledgerhq/live-network": "^2.0.16-nightly.1",
     "@ledgerhq/types-live": "^6.82.0"
   },
   "devDependencies": {
@@ -117,7 +117,7 @@
     "jest": "^29.7.0",
     "ts-jest": "^29.1.1",
     "typescript": "^5.4.5",
-    "@ledgerhq/types-cryptoassets": "^7.25.0",
+    "@ledgerhq/types-cryptoassets": "^7.26.0-nightly.1",
     "@ledgerhq/disable-network-setup": "^0.0.0"
   },
   "scripts": {

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

@@ -0,0 +1,28 @@
+import { AlpacaApi } from "@ledgerhq/coin-framework/lib/api/types";
+import { createApi } from ".";
+
+let api: AlpacaApi;
+
+describe("devnet", () => {
+  beforeAll(() => {
+    api = createApi({
+      nodeUrl: "https://wallet-validator-devnet-canton.ledger-test.com/v2",
+      networkType: "devnet",
+      gatewayUrl: "https://canton-gateway.api.live.ledger-test.com",
+      useGateway: true,
+      nativeInstrumentId:
+        "6e9fc50fb94e56751b49f09ba2dc84da53a9d7cff08115ebb4f6b7a12d0c990c:Splice.Amulet:Amulet",
+    });
+  });
+
+  describe("getBalance", () => {
+    it("should return user balance", async () => {
+      const balance = await api.getBalance(
+        "party-4f2e1485107adf5f::122027c6dbbbdbffe0fa3122ae05175f3b9328e879e9ce96b670354deb64a45683c1",
+      );
+      expect(balance.length).toBeGreaterThanOrEqual(1);
+      const nativeBalance = balance.find(b => b.asset.type === "native");
+      expect(nativeBalance?.value).toBeGreaterThanOrEqual(0);
+    });
+  });
+});

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

@@ -0,0 +1,39 @@
+import { AlpacaApi } from "@ledgerhq/coin-framework/lib/api/types";
+import { createApi } from ".";
+import { CantonCoinConfig } from "../config";
+
+let api: AlpacaApi;
+
+describe.skip("localnet", () => {
+  beforeAll(() => {
+    api = createApi({
+      nodeUrl: "http://localhost:2975/v2",
+      networkType: "localnet",
+    } satisfies Partial<CantonCoinConfig>);
+  });
+
+  describe("lastBlock", () => {
+    it("should return ledger end", async () => {
+      const lastBlock = await api.lastBlock();
+      expect(lastBlock.height).toBeGreaterThan(0);
+    });
+  });
+});
+
+describe("devnet", () => {
+  beforeAll(() => {
+    api = createApi({
+      nodeUrl: "https://wallet-validator-devnet-canton.ledger-test.com/v2",
+      networkType: "devnet",
+      gatewayUrl: "https://canton-gateway.api.live.ledger-test.com",
+      useGateway: true,
+    });
+  });
+
+  describe("lastBlock", () => {
+    it("should return ledger end", async () => {
+      const lastBlock = await api.lastBlock();
+      expect(lastBlock.height).toBeGreaterThan(0);
+    });
+  });
+});

package/src/bridge/createTransaction.test.ts

@@ -7,6 +7,6 @@ describe("createTransaction", () => {
   });
 
   it("should create a transaction with boilerplate family", () => {
-    expect(createTransaction({} as AccountLike<Account>).family).toEqual("boilerplate");
+    expect(createTransaction({} as AccountLike<Account>).family).toEqual("canton");
   });
 });

package/src/bridge/getTransactionStatus.ts

@@ -25,7 +25,7 @@ export const getTransactionStatus: AccountBridge<
   const warnings: Record<string, Error> = {};
 
   // reserveAmount is the minimum amount of currency that an account must hold in order to stay activated
-  const reserveAmount = new BigNumber(coinConfig.getCoinConfig().minReserve);
+  const reserveAmount = new BigNumber(coinConfig.getCoinConfig().minReserve || 0);
   const estimatedFees = new BigNumber(transaction.fee || 0);
   const totalSpent = new BigNumber(transaction.amount).plus(estimatedFees);
   const amount = new BigNumber(transaction.amount);

package/src/bridge/sync.ts

@@ -3,7 +3,7 @@ import { Operation } from "@ledgerhq/types-live";
 import { encodeAccountId } from "@ledgerhq/coin-framework/account/index";
 import { GetAccountShape, mergeOps } from "@ledgerhq/coin-framework/bridge/jsHelpers";
 import { getTransactions } from "../network/indexer";
-import { getAccountInfo, getBlockHeight } from "../network/node";
+import { getAccountInfo, getLedgerEnd } from "../network/node";
 
 import { encodeOperationId } from "@ledgerhq/coin-framework/operation";
 import { BoilerplateOperation } from "../network/types";
@@ -73,13 +73,15 @@ export const getAccountShape: GetAccountShape = async info => {
   });
 
   // blockheight retrieval
-  const blockHeight = await getBlockHeight();
+  const blockHeight = await getLedgerEnd();
 
   // Account info retrieval + spendable balance calculation
   const accountInfo = await getAccountInfo(address);
   const balance = new BigNumber(accountInfo.account_data.Balance);
-  const reserveMin = coinConfig.getCoinConfig().minReserve;
-  const spendableBalance = new BigNumber(accountInfo.account_data.Balance).minus(reserveMin);
+  const reserveMin = coinConfig.getCoinConfig().minReserve || 0;
+  const spendableBalance = new BigNumber(accountInfo.account_data.Balance).minus(
+    BigNumber(reserveMin),
+  );
 
   // Tx history fetching
   const oldOperations = initialAccount?.operations || [];

package/src/common-logic/account/getBalance.ts

@@ -1,8 +1,23 @@
 import { Balance } from "@ledgerhq/coin-framework/api/types";
-import { getAccountInfo } from "../../network/node";
+import { getBalance as gatewayGetBalance, type InstrumentBalance } from "../../network/gateway";
+import coinConfig from "../../config";
 
-// Could be getAccountInfo so it is used in both bridge and api
-export async function getBalance(address: string): Promise<Balance[]> {
-  const accountInfo = await getAccountInfo(address);
-  return [{ asset: { type: "native" }, value: BigInt(accountInfo.account_data.Balance) }]; // TODO: add more info like spendableBalance, etc.
+const useGateway = () => coinConfig.getCoinConfig().useGateway === true;
+const getNativeId = () => coinConfig.getCoinConfig().nativeInstrumentId;
+
+function adaptInstrument(instrument: InstrumentBalance): Balance {
+  return {
+    value: BigInt(instrument.amount),
+    locked: instrument.locked === true ? BigInt(instrument.amount) : BigInt(0),
+    asset:
+      getNativeId() === instrument.instrumentId
+        ? { type: "native" }
+        : { type: "token", assetReference: instrument.instrumentId },
+  };
+}
+
+export async function getBalance(partyId: string): Promise<Balance[]> {
+  if (useGateway())
+    return (await gatewayGetBalance(partyId)).map(instrument => adaptInstrument(instrument));
+  else throw new Error("Not implemented");
 }

package/src/common-logic/account/getBalance.unit.test.ts

@@ -0,0 +1,63 @@
+import { getBalance as getBalanceFromNetwork } from "../../network/gateway";
+import * as coinConfigModule from "../../config";
+import { getBalance } from "./getBalance";
+import { Balance } from "@ledgerhq/coin-framework/api/types";
+
+jest.mock("../../network/gateway", () => ({
+  getBalance: jest.fn(),
+}));
+
+describe("getBalance", () => {
+  const mockGetCoinConfig = jest.spyOn(coinConfigModule.default, "getCoinConfig");
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it("should return adapted balances when useGateway is true", async () => {
+    mockGetCoinConfig.mockReturnValue({
+      useGateway: true,
+      nativeInstrumentId: "native-id",
+    } as any);
+
+    const mockInstruments = [
+      {
+        instrumentId: "native-id",
+        amount: "1000",
+        locked: false,
+      },
+      {
+        instrumentId: "token-123",
+        amount: "5000",
+        locked: true,
+      },
+    ];
+
+    (getBalanceFromNetwork as jest.Mock).mockResolvedValue(mockInstruments);
+
+    const result = await getBalance("party-id");
+
+    expect(getBalanceFromNetwork).toHaveBeenCalledWith("party-id");
+    expect(result).toEqual<Balance[]>([
+      {
+        value: BigInt(1000),
+        locked: BigInt(0),
+        asset: { type: "native" },
+      },
+      {
+        value: BigInt(5000),
+        locked: BigInt(5000),
+        asset: { type: "token", assetReference: "token-123" },
+      },
+    ]);
+  });
+
+  it("should throw an error when useGateway is false (not implemented with node)", async () => {
+    mockGetCoinConfig.mockReturnValue({
+      useGateway: false,
+    } as any);
+
+    await expect(getBalance("party-id")).rejects.toThrow("Not implemented");
+    expect(getBalanceFromNetwork).not.toHaveBeenCalled();
+  });
+});

package/src/common-logic/history/lastBlock.test.ts

@@ -0,0 +1,47 @@
+import { lastBlock } from "./lastBlock";
+import { getLedgerEnd as gatewayGetLedgerEnd } from "../../network/gateway";
+import { getLedgerEnd as nodeGetLedgerEnd } from "../../network/node";
+
+jest.mock("../../network/gateway", () => ({
+  getLedgerEnd: jest.fn(),
+}));
+jest.mock("../../network/node", () => ({
+  getLedgerEnd: jest.fn(),
+}));
+
+jest.mock("../../config", () => ({
+  __esModule: true,
+  default: {
+    getCoinConfig: jest.fn(),
+  },
+}));
+
+import coinConfig from "../../config";
+
+describe("lastBlock", () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it("should use gateway.getLedgerEnd when useGateway is true", async () => {
+    (coinConfig.getCoinConfig as jest.Mock).mockReturnValue({ useGateway: true });
+    (gatewayGetLedgerEnd as jest.Mock).mockResolvedValue(100);
+
+    const result = await lastBlock();
+
+    expect(result).toEqual({ height: 100 });
+    expect(gatewayGetLedgerEnd).toHaveBeenCalledTimes(1);
+    expect(nodeGetLedgerEnd).not.toHaveBeenCalled();
+  });
+
+  it("should use node.getLedgerEnd when useGateway is false", async () => {
+    (coinConfig.getCoinConfig as jest.Mock).mockReturnValue({ useGateway: false });
+    (nodeGetLedgerEnd as jest.Mock).mockResolvedValue(200);
+
+    const result = await lastBlock();
+
+    expect(result).toEqual({ height: 200 });
+    expect(nodeGetLedgerEnd).toHaveBeenCalledTimes(1);
+    expect(gatewayGetLedgerEnd).not.toHaveBeenCalled();
+  });
+});

package/src/common-logic/history/lastBlock.ts

@@ -1,11 +1,12 @@
 import type { BlockInfo } from "@ledgerhq/coin-framework/api/index";
-import { getLastBlock } from "../../network/node";
+import { getLedgerEnd as nodeGetLedgerEnd } from "../../network/node";
+import { getLedgerEnd } from "../../network/gateway";
+import coinConfig from "../../config";
+
+const useGateway = () => coinConfig.getCoinConfig().useGateway === true;
 
 export async function lastBlock(): Promise<BlockInfo> {
-  const result = await getLastBlock();
   return {
-    height: result.blockHeight,
-    hash: result.blockHash,
-    time: new Date(result.timestamp),
+    height: useGateway() ? await getLedgerEnd() : await nodeGetLedgerEnd(),
   };
 }

package/src/config.ts

@@ -1,12 +1,22 @@
-import buildCoinConfig, { type CurrencyConfig } from "@ledgerhq/coin-framework/config";
+import buildCoinConfig, { CoinConfig, type CurrencyConfig } from "@ledgerhq/coin-framework/config";
+import { CryptoCurrency } from "@ledgerhq/types-cryptoassets";
 
 export type CantonConfig = {
-  nodeUrl: string;
-  minReserve: number;
+  nodeUrl?: string;
+  nodeId?: string;
+  gatewayUrl?: string;
+  // TODELETE
+  minReserve?: number;
+  networkType: "mainnet" | "devnet" | "localnet";
+  useGateway?: boolean;
+  nativeInstrumentId?: string;
 };
 
 export type CantonCoinConfig = CurrencyConfig & CantonConfig;
 
-const coinConfig = buildCoinConfig<CantonCoinConfig>();
+const coinConfig: {
+  setCoinConfig: (config: CoinConfig<CantonCoinConfig>) => void;
+  getCoinConfig: (currency?: CryptoCurrency) => CantonCoinConfig;
+} = buildCoinConfig<CantonCoinConfig>();
 
 export default coinConfig;

package/src/network/gateway.integ.test.ts

@@ -0,0 +1,76 @@
+import coinConfig from "../config";
+import {
+  getLedgerEnd,
+  prepareOnboarding,
+  getBalance,
+  getTransactions,
+  getPartyById,
+  getPartyByPubKey,
+} from "./gateway";
+
+describe("gateway (devnet)", () => {
+  beforeAll(() => {
+    coinConfig.setCoinConfig(() => ({
+      gatewayUrl: "https://canton-gateway.api.live.ledger-test.com",
+      useGateway: true,
+      networkType: "devnet",
+      status: {
+        type: "active",
+      },
+    }));
+  });
+  describe("prepareOnboarding", () => {
+    it("should prepare onboarding", async () => {
+      const response = await prepareOnboarding(
+        "c59f7f29374d24506dd6490a5db472cf00958e195e146f3dc9c97f96d5c51097",
+        "ed25519",
+      );
+      expect(response).toHaveProperty("party_id");
+      expect(response).toHaveProperty("party_name");
+      expect(response).toHaveProperty("public_key_fingerprint");
+      expect(response).toHaveProperty("topology_transactions_hash");
+    }, 30000);
+  });
+  describe("getLedgerEnd", () => {
+    it("should return ledger end", async () => {
+      const end = await getLedgerEnd();
+      expect(end).toBeGreaterThanOrEqual(0);
+    });
+  });
+
+  describe("getBalance", () => {
+    it("should return user balance", async () => {
+      const balance = await getBalance(
+        "party-4f2e1485107adf5f::122027c6dbbbdbffe0fa3122ae05175f3b9328e879e9ce96b670354deb64a45683c1",
+      );
+      expect(balance.length).toBeGreaterThanOrEqual(1);
+      expect(balance[0].amount).toBeGreaterThanOrEqual(0);
+      expect(balance[0].instrumentId.includes("Splice")).toBe(true);
+    });
+  });
+
+  describe("getPartyById", () => {
+    it.skip("should return party info", async () => {
+      const party = await getPartyById("4f2e1485107adf5f");
+      expect(party).toBeDefined();
+    });
+  });
+
+  describe("getPartyByPubKey", () => {
+    it.skip("should return party info", async () => {
+      const party = await getPartyByPubKey(
+        "122027c6dbbbdbffe0fa3122ae05175f3b9328e879e9ce96b670354deb64a45683c1",
+      );
+      expect(party).toBeDefined();
+    });
+  });
+
+  describe("getTransactions", () => {
+    it("should return user transactions", async () => {
+      const { transactions } = await getTransactions(
+        "party-5f29bb32e9939939::12202becd8062a1d170209956cfd977fca76fcb4d2a892d08c77a7483f35a11d6440",
+      );
+      expect(transactions.length).toBeGreaterThanOrEqual(0);
+    });
+  });
+});

package/src/network/gateway.ts

@@ -0,0 +1,168 @@
+import network from "@ledgerhq/live-network";
+import coinConfig from "../config";
+
+type OnboardingPrepareResponse = {
+  party_id: string;
+  party_name: string;
+  public_key_fingerprint: string;
+  topology_transactions_hash: string;
+};
+
+type OnboardingPrepareRequest = {
+  public_key: string;
+  public_key_type: string;
+};
+
+type OnboardingSubmitRequest = {
+  prepare_request: OnboardingPrepareRequest;
+  prepare_response: OnboardingPrepareResponse;
+  signature: string;
+};
+
+type OnboardingSubmitResponse = {
+  party: {
+    party_id: string;
+    public_key: string;
+  };
+};
+
+export type InstrumentBalance = {
+  instrumentId: string;
+  amount: number;
+  locked: boolean;
+};
+
+type PartyInfo = {
+  party_id: string;
+  public_key: string;
+};
+
+type Timestamp = {
+  seconds: number;
+  nanos: number;
+};
+
+type BaseEvent = {
+  type: string;
+  contractId: string;
+  details: string;
+};
+
+type CreatedEvent = BaseEvent & {
+  templateId: {
+    packageId: string;
+    moduleName: string;
+    entityName: string;
+  };
+  signatories: string[];
+  observers: string[];
+};
+
+type ExercisedEvent = BaseEvent & {
+  templateId: {
+    packageId: string;
+    moduleName: string;
+    entityName: string;
+  };
+  choice: string;
+  consuming: boolean;
+  actingParties: string[];
+};
+
+type Event = BaseEvent | CreatedEvent | ExercisedEvent;
+
+type TxInfo = {
+  updateId: string;
+  commandId: string;
+  workflowId: string;
+  effectiveAt: Timestamp;
+  offset: number;
+  synchronizerId: string;
+  recordTime: Timestamp;
+  events: Event[];
+  traceContext: string;
+};
+
+const getGatewayUrl = () => coinConfig.getCoinConfig().gatewayUrl;
+const getNodeId = () => coinConfig.getCoinConfig().nodeId || "ledger-live-devnet-prd";
+
+export async function prepareOnboarding(
+  pubKey: string,
+  pubKeyType: string,
+): Promise<OnboardingPrepareResponse> {
+  const { data } = await network<OnboardingPrepareResponse>({
+    method: "POST",
+    url: `${getGatewayUrl()}/v1/node/${getNodeId()}/onboarding/prepare`,
+    data: {
+      public_key: pubKey,
+      public_key_type: pubKeyType,
+    } satisfies OnboardingPrepareRequest,
+  });
+  return data;
+}
+
+export async function submitOnboarding(
+  prepareRequest: OnboardingPrepareRequest,
+  prepareResponse: OnboardingPrepareResponse,
+  signature: string,
+) {
+  const { data } = await network<OnboardingSubmitResponse>({
+    method: "POST",
+    url: `${getGatewayUrl()}/v1/node/${getNodeId()}/onboarding/submit`,
+    data: {
+      prepare_request: prepareRequest,
+      prepare_response: prepareResponse,
+      signature,
+    } satisfies OnboardingSubmitRequest,
+  });
+  return data;
+}
+
+export async function getBalance(partyId: string): Promise<InstrumentBalance[]> {
+  const { data } = await network<InstrumentBalance[]>({
+    method: "GET",
+    url: `${getGatewayUrl()}/v1/node/${getNodeId()}/party/${partyId}/balance`,
+  });
+  return data;
+}
+
+export async function getPartyById(partyId: string): Promise<PartyInfo> {
+  return await getParty(partyId, "ID");
+}
+
+export async function getPartyByPubKey(pubKey: string): Promise<PartyInfo> {
+  return await getParty(pubKey, "PK");
+}
+
+async function getParty(identifier: string, by: "ID" | "PK"): Promise<PartyInfo> {
+  const { data } = await network<PartyInfo>({
+    method: "GET",
+    url: `${getGatewayUrl()}/v1/node/${getNodeId()}/party/${identifier}`,
+    data: {
+      by,
+    },
+  });
+  return data;
+}
+
+export async function getTransactions(partyId: string): Promise<{
+  next: number;
+  transactions: TxInfo[];
+}> {
+  const { data } = await network<{
+    next: number;
+    transactions: TxInfo[];
+  }>({
+    method: "GET",
+    url: `${getGatewayUrl()}/v1/node/${getNodeId()}/party/${partyId}/transactions`,
+  });
+  return data;
+}
+
+export async function getLedgerEnd(): Promise<number> {
+  const { data } = await network<number>({
+    method: "GET",
+    url: `${getGatewayUrl()}/v1/node/${getNodeId()}/ledger-end`,
+  });
+  return data;
+}

package/src/network/node.integ.test.ts

@@ -0,0 +1,40 @@
+import coinConfig from "../config";
+import { getLedgerEnd } from "./node";
+
+// enable manually, as it requires a running node locally
+describe.skip("Node (localnet)", () => {
+  beforeAll(() => {
+    coinConfig.setCoinConfig(() => ({
+      gatewayUrl: "http://gateway.url",
+      nodeUrl: "http://localhost:2975/v2",
+      networkType: "localnet",
+      status: { type: "active" },
+    }));
+  });
+
+  describe("getLedgerEnd", () => {
+    it("should return ledger end", async () => {
+      const end = await getLedgerEnd();
+      expect(end).toBeGreaterThan(0);
+    });
+  });
+});
+
+// enable manually, as it requires an auth token in env variable
+describe.skip("Node (devnet)", () => {
+  beforeAll(() => {
+    coinConfig.setCoinConfig(() => ({
+      nodeUrl: "https://wallet-validator-devnet-canton.ledger-test.com/v2",
+      networkType: "devnet",
+      status: { type: "active" },
+      gatewayUrl: "http://gateway.url",
+    }));
+  });
+
+  describe("getLedgerEnd", () => {
+    it("should return ledger end", async () => {
+      const end = await getLedgerEnd();
+      expect(end).toBeGreaterThan(0);
+    });
+  });
+});