feat: implement Knowledge Graph for Wallet Integration

[Imole203]

feat: Implement Knowledge Graph for Wallet Integration

Summary

Adds a Knowledge Graph layer to the wallet integration, enabling structured
relationship tracking between wallets, users, transactions, tokens, and content
— powering reputation scoring, tip history, and social graph traversal.

Changes

src/lib/wallet/knowledgeGraph.types.ts

Defines all graph primitives:

• Node types: WalletNode, UserNode, TransactionNode, TokenNode, ContentNode
• Edge types: OWNS, SENT, RECEIVED, TIPPED, HOLDS, AUTHORED, TIPPED_CONTENT
• Query result types: WalletProfile, TipRelationship, GraphStats

src/lib/wallet/knowledgeGraph.service.ts

WalletKnowledgeGraphService class with:

• Node/edge CRUD with Map-based adjacency list
• upsertWallet, addTransaction, addToken, addContent helpers
• getWalletProfile — full wallet context (users, txs, tokens, content)
• getTipRelationships — who a wallet has tipped and how much
• getReputationScore — score derived from tip activity (0–100)
• localStorage persistence with graceful fallback
• Exported singleton walletKnowledgeGraph

src/hooks/useWalletKnowledgeGraph.ts

React hook exposing graph queries and mutations:

• registerWallet, recordTip, registerToken, registerContent
• getWalletProfile, getTipRelationships, getReputationScore
• Reactive stats (node/edge counts)

Testing

• Unit tests to be added in follow-up (task feat: set up a new next.js project #5 pending)

Closes

Resolves: Wallet Integration Knowledge Graph implementation
closes #466

[drips-wave]

@Imole203 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits