feat: transaction summary

.changeset/modern-starfishes-study.md

@@ -0,0 +1,9 @@
+---
+'@penumbra-zone/protobuf': major
+'@penumbra-zone/storage': major
+'@penumbra-zone/types': major
+'@penumbra-zone/services': minor
+'@penumbra-zone/wasm': minor
+---
+
+transaction summary support for transaction info rpc

packages/protobuf/package.json

@@ -16,7 +16,7 @@
     "gen:ibc": "buf generate buf.build/cosmos/ibc:7ab44ae956a0488ea04e04511efa5f70",
     "gen:ics23": "buf generate buf.build/cosmos/ics23:55085f7c710a45f58fa09947208eb70b",
     "gen:noble": "buf generate buf.build/noble-assets/forwarding:5a8609a6772d417584a9c60cd8b80881",
-    "gen:penumbra": "buf generate buf.build/penumbra-zone/penumbra:ae2300bce202a7d429727f1340e7412d3b9f810c",
+    "gen:penumbra": "buf generate buf.build/penumbra-zone/penumbra:f6682d4ef839bb06e2da4fae487eb9d565ea04d6",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
     "lint:strict": "tsc --noEmit && eslint src --max-warnings 0",

packages/services/src/view-service/transaction-info.ts

@@ -1,10 +1,14 @@
 import type { Impl } from './index.js';
 import { servicesCtx } from '../ctx/prax.js';
 import { TransactionInfo } from '@penumbra-zone/protobuf/penumbra/view/v1/view_pb';
-import { generateTransactionInfo } from '@penumbra-zone/wasm/transaction';
+import {
+  generateTransactionInfo,
+  generateTransactionSummary,
+} from '@penumbra-zone/wasm/transaction';
 import { fvkCtx } from '../ctx/full-viewing-key.js';
 import {
   TransactionPerspective,
+  TransactionSummary,
   TransactionView,
 } from '@penumbra-zone/protobuf/penumbra/core/transaction/v1/transaction_pb';
 
@@ -24,11 +28,14 @@ export const transactionInfo: Impl['transactionInfo'] = async function* (_req, c
     const tx_info = await indexedDb.getTransactionInfo(txRecord.id);
     let perspective: TransactionPerspective;
     let view: TransactionView;
+    let summary: TransactionSummary;
 
-    // If TxP + TxV already exist in database, then simply yield them.
+    // If TxP + TxV + summary already exist in database, then simply yield them.
     if (tx_info) {
       perspective = tx_info.perspective;
       view = tx_info.view;
+      summary = tx_info.summary;
+
       // Otherwise, generate the TxP + TxV from the transaction in wasm
       // and store them.
     } else {
@@ -38,7 +45,10 @@ export const transactionInfo: Impl['transactionInfo'] = async function* (_req, c
         indexedDb.constants(),
       );
 
-      await indexedDb.saveTransactionInfo(txRecord.id, txp, txv);
+      // Generate and save transaction info summary from the TxV.
+      summary = await generateTransactionSummary(txv);
+      await indexedDb.saveTransactionInfo(txRecord.id, txp, txv, summary);
+
       perspective = txp;
       view = txv;
     }
@@ -50,6 +60,7 @@ export const transactionInfo: Impl['transactionInfo'] = async function* (_req, c
         transaction: txRecord.transaction,
         perspective,
         view,
+        summary,
       }),
     };
   }

packages/storage/src/indexed-db/config.ts

@@ -2,4 +2,4 @@
  * The version number for the IndexedDB schema. This version number is used to manage
  * database upgrades and ensure that the correct schema version is applied.
  */
-export const IDB_VERSION = 49;
+export const IDB_VERSION = 50;

packages/storage/src/indexed-db/index.ts

@@ -37,6 +37,7 @@ import { ValidatorInfo } from '@penumbra-zone/protobuf/penumbra/core/component/s
 import {
   Transaction,
   TransactionPerspective,
+  TransactionSummary,
   TransactionView,
 } from '@penumbra-zone/protobuf/penumbra/core/transaction/v1/transaction_pb';
 import { bech32mAssetId } from '@penumbra-zone/bech32m/passet';
@@ -366,33 +367,40 @@ export class IndexedDb implements IndexedDbInterface {
     );
   }
 
-  async getTransactionInfo(
-    id: TransactionId,
-  ): Promise<
-    { id: TransactionId; perspective: TransactionPerspective; view: TransactionView } | undefined
+  async getTransactionInfo(id: TransactionId): Promise<
+    | {
+        id: TransactionId;
+        perspective: TransactionPerspective;
+        view: TransactionView;
+        summary: TransactionSummary;
+      }
+    | undefined
   > {
     const existingData = await this.db.get('TRANSACTION_INFO', uint8ArrayToBase64(id.inner));
-    if (existingData) {
-      return {
-        id: TransactionId.fromJson(existingData.id, { typeRegistry }),
-        perspective: TransactionPerspective.fromJson(existingData.perspective, { typeRegistry }),
-        view: TransactionView.fromJson(existingData.view, { typeRegistry }),
-      };
-    } else {
+    if (!existingData) {
       return undefined;
     }
+
+    return {
+      id: TransactionId.fromJson(existingData.id, { typeRegistry }),
+      perspective: TransactionPerspective.fromJson(existingData.perspective, { typeRegistry }),
+      view: TransactionView.fromJson(existingData.view, { typeRegistry }),
+      summary: TransactionSummary.fromJson(existingData.summary, { typeRegistry }),
+    };
   }
 
   async saveTransactionInfo(
     id: TransactionId,
     txp: TransactionPerspective,
     txv: TransactionView,
+    summary: TransactionSummary,
   ): Promise<void> {
     assertTransactionId(id);
     const value = {
       id: id.toJson({ typeRegistry }) as Jsonified<TransactionId>,
       perspective: txp.toJson({ typeRegistry }) as Jsonified<TransactionPerspective>,
       view: txv.toJson({ typeRegistry }) as Jsonified<TransactionView>,
+      summary: summary.toJson({ typeRegistry }) as Jsonified<TransactionSummary>,
     };
     await this.u.update({
       table: 'TRANSACTION_INFO',

packages/types/src/indexed-db.ts

@@ -36,6 +36,7 @@ import { AddressIndex, IdentityKey } from '@penumbra-zone/protobuf/penumbra/core
 import {
   Transaction,
   TransactionPerspective,
+  TransactionSummary,
   TransactionView,
 } from '@penumbra-zone/protobuf/penumbra/core/transaction/v1/transaction_pb';
 import { TransactionId } from '@penumbra-zone/protobuf/penumbra/core/txhash/v1/txhash_pb';
@@ -168,12 +169,17 @@ export interface IndexedDbInterface {
     id: TransactionId,
     txp: TransactionPerspective,
     txv: TransactionView,
+    summary: TransactionSummary,
   ): Promise<void>;
 
-  getTransactionInfo(
-    id: TransactionId,
-  ): Promise<
-    { id: TransactionId; perspective: TransactionPerspective; view: TransactionView } | undefined
+  getTransactionInfo(id: TransactionId): Promise<
+    | {
+        id: TransactionId;
+        perspective: TransactionPerspective;
+        view: TransactionView;
+        summary: TransactionSummary;
+      }
+    | undefined
   >;
 
   getPosition(positionId: PositionId): Promise<Position | undefined>;
@@ -241,6 +247,7 @@ export interface PenumbraDb extends DBSchema {
       id: Jsonified<TransactionId>;
       perspective: Jsonified<TransactionPerspective>;
       view: Jsonified<TransactionView>;
+      summary: Jsonified<TransactionSummary>;
     };
   };
   REGISTRY_VERSION: {

packages/wasm/crate/src/tx.rs

@@ -22,6 +22,7 @@ use penumbra_transaction::view::action_view::{
     ActionView, DelegatorVoteView, OutputView, SpendView,
 };
 use penumbra_transaction::Action;
+use penumbra_transaction::TransactionView as TransactionViewComponent;
 use penumbra_transaction::{AuthorizationData, Transaction, WitnessData};
 use prost::Message;
 use rand_core::OsRng;
@@ -384,3 +385,11 @@ async fn add_swap_claim_txn_to_perspective(
 
     Ok(())
 }
+
+#[wasm_bindgen]
+pub async fn transaction_summary(txv: &[u8]) -> WasmResult<Vec<u8>> {
+    let transaction_view = TransactionViewComponent::decode(txv)?;
+    let tx_summary = transaction_view.summary();
+
+    Ok(tx_summary.encode_to_vec())
+}

packages/wasm/src/transaction.ts

@@ -1,7 +1,8 @@
-import { transaction_perspective_and_view } from '../wasm/index.js';
+import { transaction_perspective_and_view, transaction_summary } from '../wasm/index.js';
 import {
   Transaction,
   TransactionPerspective,
+  TransactionSummary,
   TransactionView,
 } from '@penumbra-zone/protobuf/penumbra/core/transaction/v1/transaction_pb';
 import type { IdbConstants } from '@penumbra-zone/types/indexed-db';
@@ -23,3 +24,9 @@ export const generateTransactionInfo = async (
     txv: TransactionView.fromBinary(txv),
   };
 };
+
+export const generateTransactionSummary = async (txv: TransactionView) => {
+  const tx_summary = await transaction_summary(txv.toBinary());
+
+  return TransactionSummary.fromBinary(tx_summary);
+};