[Alpaca] Add block hash and timestamp

.changeset/quick-frogs-develop.md

@@ -0,0 +1,8 @@
+---
+"@ledgerhq/coin-stellar": minor
+"@ledgerhq/coin-tezos": minor
+"@ledgerhq/coin-xrp": minor
+"@ledgerhq/coin-framework": minor
+---
+
+Add block informations to an operation (hash, time and height of a block)

libs/coin-framework/src/api/types.ts

@@ -1,7 +1,7 @@
 export type BlockInfo = {
   height: number;
-  hash: string;
-  time: Date;
+  hash?: string;
+  time?: Date;
 };
 
 export type Operation = {
@@ -10,7 +10,7 @@ export type Operation = {
   type: string;
   value: bigint;
   fee: bigint;
-  blockHeight: number;
+  block: BlockInfo;
   senders: string[];
   recipients: string[];
   date: Date;

libs/coin-modules/coin-polkadot/src/logic/listOperations.ts

@@ -7,7 +7,11 @@ export type Operation = {
   type: string;
   value: bigint;
   fee: bigint;
-  blockHeight: number;
+  block: {
+    height: number;
+    hash?: string;
+    time?: Date;
+  };
   senders: string[];
   recipients: string[];
   date: Date;
@@ -43,7 +47,9 @@ const convertToCoreOperation = (address: string) => (operation: PolkadotOperatio
     type,
     value: BigInt(value.toString()),
     fee: BigInt(fee.toString()),
-    blockHeight: blockHeight ?? 0,
+    block: {
+      height: blockHeight ?? 0,
+    },
     senders,
     recipients,
     date,

libs/coin-modules/coin-stellar/src/bridge/buildOptimisticOperation.ts

@@ -28,6 +28,7 @@ export async function buildOptimisticOperation(
     transactionSequenceNumber: transactionSequenceNumber?.plus(1).toNumber(),
     extra: {
       ledgerOpType: type,
+      blockTime: new Date(),
     },
   };
 

libs/coin-modules/coin-stellar/src/logic/listOperations.ts

@@ -7,7 +7,11 @@ export type Operation = {
   type: string;
   value: bigint;
   fee: bigint;
-  blockHeight: number;
+  block: {
+    hash?: string;
+    time?: Date;
+    height: number;
+  };
   senders: string[];
   recipients: string[];
   date: Date;
@@ -41,7 +45,11 @@ const convertToCoreOperation = (address: string) => (operation: StellarOperation
     type: operation.type,
     value: BigInt(operation.value.toString()),
     fee: BigInt(operation.fee.toString()),
-    blockHeight: operation.blockHeight!,
+    block: {
+      hash: operation.blockHash!,
+      time: operation.extra.blockTime,
+      height: operation.blockHeight!,
+    },
     senders: operation.senders,
     recipients: operation.recipients,
     date: operation.date,

libs/coin-modules/coin-stellar/src/network/horizon.ts

@@ -64,6 +64,14 @@ Horizon.AxiosClient.interceptors.request.use(config => {
   return config;
 });
 
+// This function allows to fix the URL, because the url returned by the Stellar SDK is not the correct one.
+// It replaces the host of the URL returned with the host of the explorer.
+function useConfigHost(url: string): string {
+  const u = new URL(url);
+  u.host = new URL(coinConfig.getCoinConfig().explorer.url).host;
+  return u.toString();
+}
+
 Horizon.AxiosClient.interceptors.response.use(response => {
   if (coinConfig.getCoinConfig().enableNetworkLogs) {
     const { url, method } = response.config;
@@ -73,14 +81,18 @@ Horizon.AxiosClient.interceptors.response.use(response => {
   // FIXME: workaround for the Stellar SDK not using the correct URL: the "next" URL
   // included in server responses points to the node itself instead of our reverse proxy...
   // (https://github.com/stellar/js-stellar-sdk/issues/637)
+
   const next_href = response?.data?._links?.next?.href;
 
   if (next_href) {
-    const next = new URL(next_href);
-    next.host = new URL(coinConfig.getCoinConfig().explorer.url).host;
-    response.data._links.next.href = next.toString();
+    response.data._links.next.href = useConfigHost(next_href);
   }
 
+  response?.data?._embedded?.records?.forEach((r: any) => {
+    const href = r.transaction?._links?.ledger?.href;
+    if (href) r.transaction._links.ledger.href = useConfigHost(href);
+  });
+
   return response;
 });
 

libs/coin-modules/coin-stellar/src/network/serialization.ts

@@ -79,6 +79,7 @@ async function formatOperation(
   addr: string,
 ): Promise<StellarOperation> {
   const transaction = await rawOperation.transaction();
+  const { hash: blockHash, closed_at: blockTime } = await transaction.ledger();
   const type = getOperationType(rawOperation, addr);
   const value = getValue(rawOperation, transaction, type);
   const recipients = getRecipients(rawOperation);
@@ -103,9 +104,10 @@ async function formatOperation(
     recipients,
     transactionSequenceNumber: Number(transaction.source_account_sequence),
     hasFailed: !rawOperation.transaction_successful,
-    blockHash: null,
+    blockHash: blockHash,
     extra: {
       ledgerOpType: type,
+      blockTime: new Date(blockTime),
     },
   };
 

libs/coin-modules/coin-stellar/src/types/bridge.fixture.ts

@@ -71,6 +71,7 @@ export function createFixtureOperation(operation?: Partial<StellarOperation>): S
   let extra: StellarOperationExtra = {
     assetAmount: operation?.extra?.assetAmount || undefined,
     ledgerOpType: operation?.extra?.ledgerOpType || "IN",
+    blockTime: operation?.extra?.blockTime || faker.date.past(),
   };
   if (operation?.extra?.pagingToken) {
     extra = {

libs/coin-modules/coin-stellar/src/types/bridge.ts

@@ -111,6 +111,7 @@ export type StellarOperationExtra = {
   assetAmount?: string | undefined;
   ledgerOpType: OperationType;
   memo?: string;
+  blockTime: Date;
 };
 
 export type StellarAccount = Account;

libs/coin-modules/coin-tezos/src/api/index.integ.test.ts

@@ -55,6 +55,7 @@ describe("Tezos Api", () => {
         const isSenderOrReceipt =
           operation.senders.includes(address) || operation.recipients.includes(address);
         expect(isSenderOrReceipt).toBeTruthy();
+        expect(operation.block).toBeDefined();
       });
     });
 

libs/coin-modules/coin-tezos/src/logic/listOperations.ts

@@ -12,7 +12,11 @@ export type Operation = {
   type: string;
   value: bigint;
   fee: bigint;
-  blockHeight: number;
+  block: {
+    hash?: string;
+    height: number;
+    time?: Date;
+  };
   senders: string[];
   recipients: string[];
   date: Date;
@@ -48,7 +52,11 @@ function convertOperation(
     value: BigInt(amount),
     // storageFee for transaction is always present
     fee: BigInt(storageFee ?? 0),
-    blockHeight: 0, // operation.block is a string
+    block: {
+      hash: operation.block,
+      height: operation.level,
+      time: new Date(operation.timestamp),
+    },
     senders: [sender?.address ?? ""],
     recipients: [targetAddress],
     date: new Date(timestamp),

libs/coin-modules/coin-xrp/src/api/index.test.ts

@@ -41,25 +41,29 @@ describe("listOperations", () => {
       const fee = 10;
       mockGetTransactions.mockResolvedValue([
         {
+          ledger_hash: "HASH_VALUE_BLOCK",
+          hash: "HASH_VALUE",
+          close_time_iso: "2000-01-01T00:00:01Z",
           meta: { delivered_amount: deliveredAmount.toString() },
-          tx: {
+          tx_json: {
             TransactionType: "Payment",
             Fee: fee.toString(),
-            hash: "HASH_VALUE",
-            inLedger: 1,
+            ledger_index: 1,
             date: 1000,
             Account: opSender,
             Destination: opDestination,
             Sequence: 1,
           },
         },
         {
+          ledger_hash: "HASH_VALUE_BLOCK",
+          hash: "HASH_VALUE",
+          close_time_iso: "2000-01-01T00:00:01Z",
           meta: { delivered_amount: deliveredAmount.toString() },
-          tx: {
+          tx_json: {
             TransactionType: "Payment",
             Fee: fee.toString(),
-            hash: "HASH_VALUE",
-            inLedger: 1,
+            ledger_index: 1,
             date: 1000,
             Account: opSender,
             Destination: opDestination,
@@ -68,12 +72,14 @@ describe("listOperations", () => {
           },
         },
         {
+          ledger_hash: "HASH_VALUE_BLOCK",
+          hash: "HASH_VALUE",
+          close_time_iso: "2000-01-01T00:00:01Z",
           meta: { delivered_amount: deliveredAmount.toString() },
-          tx: {
+          tx_json: {
             TransactionType: "Payment",
             Fee: fee.toString(),
-            hash: "HASH_VALUE",
-            inLedger: 1,
+            ledger_index: 1,
             date: 1000,
             Account: opSender,
             Destination: opDestination,
@@ -106,7 +112,11 @@ describe("listOperations", () => {
           type: "Payment",
           value: expectedValue,
           fee: BigInt(10),
-          blockHeight: 1,
+          block: {
+            hash: "HASH_VALUE_BLOCK",
+            height: 1,
+            time: new Date("2000-01-01T00:00:01Z"),
+          },
           senders: [opSender],
           recipients: [opDestination],
           date: new Date(1000000 + RIPPLE_EPOCH * 1000),
@@ -118,7 +128,11 @@ describe("listOperations", () => {
           type: "Payment",
           value: expectedValue,
           fee: BigInt(10),
-          blockHeight: 1,
+          block: {
+            hash: "HASH_VALUE_BLOCK",
+            height: 1,
+            time: new Date("2000-01-01T00:00:01Z"),
+          },
           senders: [opSender],
           recipients: [opDestination],
           date: new Date(1000000 + RIPPLE_EPOCH * 1000),
@@ -133,7 +147,11 @@ describe("listOperations", () => {
           type: "Payment",
           value: expectedValue,
           fee: BigInt(10),
-          blockHeight: 1,
+          block: {
+            hash: "HASH_VALUE_BLOCK",
+            height: 1,
+            time: new Date("2000-01-01T00:00:01Z"),
+          },
           senders: [opSender],
           recipients: [opDestination],
           date: new Date(1000000 + RIPPLE_EPOCH * 1000),

libs/coin-modules/coin-xrp/src/api/index.ts

@@ -45,11 +45,18 @@ async function operations(
   address: string,
   { limit, start }: Pagination,
 ): Promise<[Operation[], number]> {
-  const [ops, index] = await listOperations(address, { limit, mostRecentIndex: start });
+  const [ops, index] = await listOperations(address, { limit, startAt: start ?? 0 });
   return [
     ops.map(op => {
-      const { simpleType, ...rest } = op;
-      return { ...rest } satisfies Operation;
+      const { simpleType, blockHash, blockTime, blockHeight, ...rest } = op;
+      return {
+        ...rest,
+        block: {
+          height: blockHeight,
+          hash: blockHash,
+          time: blockTime,
+        },
+      } satisfies Operation;
     }),
     index,
   ];

libs/coin-modules/coin-xrp/src/bridge/synchronization.test.ts

@@ -78,12 +78,13 @@ describe("getAccountShape", () => {
     });
     mockGetTransactions.mockResolvedValue([
       {
+        ledger_hash: "HASH_VALUE_BLOCK",
+        hash: "HASH_VALUE",
         meta: { delivered_amount: "100" },
-        tx: {
+        tx_json: {
           TransactionType: "Payment",
           Fee: "10",
-          hash: "HASH_VALUE",
-          inLedger: 1,
+          ledger_index: 1,
           date: 1000,
           Account: "account_addr",
           Destination: "destination_addr",
@@ -117,7 +118,7 @@ describe("getAccountShape", () => {
       operations: [
         {
           accountId: "js:2:ripple:address:",
-          blockHash: null,
+          blockHash: "HASH_VALUE_BLOCK",
           blockHeight: 1,
           date: new Date("2000-01-01T00:16:40.000Z"),
           hash: "HASH_VALUE",

libs/coin-modules/coin-xrp/src/bridge/synchronization.ts

@@ -74,7 +74,7 @@ async function filterOperations(
         type: op.simpleType,
         value: new BigNumber(op.value.toString()),
         fee: new BigNumber(op.fee.toString()),
-        blockHash: null,
+        blockHash: op.blockHash,
         blockHeight: op.blockHeight,
         senders: op.senders,
         recipients: op.recipients,