Skip to main content

​
VisualSign Protocol

VisualSign transforms raw blockchain transactions into human-readable visualizations. Instead of showing users hexadecimal strings or complex data structures, VisualSign presents clear, understandable information about what a transaction will do.

​
Core Concept

​
Simple Transfer

Raw Transaction:
0xf86c808504a817c800825208943535353535...

        ↓ VisualSign Parser ↓

Visual Representation:
┌─────────────────────────────┐
│ Ethereum Transfer           │
├─────────────────────────────┤
│ To: 0x3535...3535           │
│ Amount: 1.0 ETH             │
│ Gas: 21000 @ 20 gwei        │
└─────────────────────────────┘

​
Complex DeFi interaction

VisualSign’s true power shows when parsing complex DeFi transactions. Here’s a real Uniswap transaction with multiple nested operations: 
Raw Transaction (1236 characters of hex):
0x02f904cf0181b78477359400847c17b3e383045307943fc91a3afd70395cd496c647d5a6cc9d4b2b7fad80b904a424856bc3...

        ↓ VisualSign Parser ↓

Visual Representation:
┌─ Universal Router
│  Title: Uniswap Universal Router Execute
│  Detail: 4 commands
│
├─ 1. Permit2 Permit
│     Allow router to spend tokens
│     Token: 0x72b658...e417
│     Expires: 2025-12-15
│
├─ 2. V2 Swap Exact In
│     Swap 46.52 tokens for >=0.00276 WETH
│     Path: Token → WETH (1 hop)
│
├─ 3. Pay Portion
│     Pay 0.25% fee to protocol
│
└─ 4. Unwrap WETH
      Convert >=0.00275 WETH to ETH
      Send to: 0x8419e7...6cF
This visualization transforms an incomprehensible hex string into a clear sequence of operations that users can understand and verify before signing.

​
Visualization philosophy

VisualSign follows these principles for creating transaction visualizations:

​
1. Progressive disclosure

Show the most important information first, with details available on demand. 
{
  "Type": "preview_layout",
  "PreviewLayout": {
    "Condensed": {
      "Fields": [/* Essential info */]
    },
    "Expanded": {
      "Fields": [/* All details */]
    }
  }
}

​
2. Context-aware display

Different transaction types get different visualizations:
  • Transfers: Emphasize amount and recipient
  • Swaps: Show token pairs and rates
  • Contract Calls: Display method and parameters
  • NFT Operations: Include metadata and previews

​
3. Risk highlighting

Critical information is prominently displayed:
  • Large value transfers
  • First-time recipients
  • Contract interactions
  • Irreversible operations

​
Architecture

┌───────────────────────────────────────┐
│            Chain Modules              │
├─────────┬────────┬────────┬───────────┤
│Ethereum │ Solana │  Sui   │   Tron    │
└─────────┴────────┴────────┴───────────┘
          │        │        │
          └────────┴────────┘
                   │
          ┌────────────────┐
          │  Core Parser   │
          └────────────────┘
                   │
          ┌────────────────┐
          │ Visualization  │
          │    Engine      │
          └────────────────┘
                   │
          ┌────────────────┐
          │  VisualSign    │
          │     JSON       │
          └────────────────┘

​
Supported chains

Each blockchain has unique transaction structures requiring specialized parsing. See the chain-specific documentation for details:
  • Ethereum - Native transfers, ERC-20/721/1155 tokens, smart contracts, DeFi protocols
  • Solana - System/Token programs, multi-instruction transactions, account management
  • Sui - Object model, Move calls, programmable transactions
  • Tron - Energy/bandwidth system, TRC-20 tokens, TVM compatibility
  • Bitcoin - Coming soon

​
Next steps

​
Repositories