Track User Wallet Addresses via Log File

[Buuh2511]

Track User Wallet Addresses via Log File

Fixes #72

Types of change

• Feature
• Bug
• Enhancement

Comments (optional)

Changes

Database Schema

• Vote table: Added zkVerifyTxHash field for proof transaction hashes
• LoginHistory table: New table tracking all login events
  • Fields: commitment, walletAddress, jobId, zkVerifyTxHash, createdAt
  • Creates new record per login (no overwrites)

Backend Services

zkVerify Integration (zkverify.service.ts)

• submitProofAndWaitFinalized() now returns { jobId, status, txHash }

Authentication (auth.service.ts)

• Saves each login to login_history with zkVerifyTxHash
• Try-catch wrapper prevents DB errors from blocking login

Transaction Voting (transaction.service.ts)

• createTransaction() and approve() store zkVerifyTxHash in Vote records

Analytics Logging (analytics-logger.service.ts)

• All 6 action methods include zkVerifyTxHash: LOGIN, APPROVE, EXECUTE, DENY, ADD_SIGNER, REMOVE_SIGNER, UPDATE_THRESHOLD
• Log format: timestamp | action | user_address | multisig_wallet | nonce | zkverify_txhash

Report Generation

• New script: generate-analytics-report.ts
• Command: yarn report → generates analytics-report.csv
• Columns: Timestamp, Action, User Address, Multisig Wallet, Nonce, zkVerify TxHash, Explorer Link
• Explorer links: https://zkverify-testnet.subscan.io/tx/{txHash}

Frontend

• Updated hooks to pass userAddress: walletClient.account.address
• Modified: useTransactionVote, useTransferTransaction, useSignerTransaction, useBatchTransaction

Storage Architecture

Action Type	Storage Location
LOGIN	login_history table
APPROVE/DENY	votes table
EXECUTE, ADD_SIGNER, REMOVE_SIGNER, UPDATE_THRESHOLD	Log file only

Privacy Model

• Wallet addresses in login_history table and logs only
• NOT linked to ZK commitments in users table
• Random 0-500ms delay prevents timing correlation
• Core ZK privacy model intact

Verification

cd packages/backend && yarn report

• Open reports/analytics-report.csv
• Click explorer links to verify zkVerify proofs onchain
• Check login_history/votes tables in Prisma Studio

Excel file

[Huygon764]

Need to track other actions of users, like user with address A executes tx A,... But it will make our app lose privacy, so take this PR as pending for now

[Huygon764]

@gianalarcon can check here sir.