Features : DOMAN Docs

Browser Extension
Features

1. Address Tagging

1.1 Tag Types

Tag	Label	Color	Description
`scammer`	SCAM	Red	Proven scam wallet
`suspicious`	WARN	Yellow	Suspicious indicators
`verified`	VER	Green	Verified entity
`bot`	BOT	Purple	Automated wallet
`personal`	TAG	Gray	Personal user label

1.2 Submission Flow

flowchart TD A["User submits tag in popup"] --> B["Validate: address format, not self-tagging, valid tag type"] B --> C["chrome.runtime.sendMessage { type: SUBMIT_ADDRESS_TAG, payload }"] C --> D["background.ts: handleSubmitAddressTag()"] D --> E["Normalize: lowercase, trim, max label 80 chars, max evidence 260 chars"] E --> F["Validate: no self-tagging"] F --> G["submitAddressTagApi( { address, tag, label, evidence, submittedBy })"] G --> H["Return { success, data }"] H --> I["Reload tags for the address"]

1.3 Voting System

Users can vote up/down on existing tags:

chrome.runtime.sendMessage({ type: VOTE_ADDRESS_TAG, payload: { address, tagId, tag, vote } })

1.4 Content Script Integration

Addresses found on dApp pages are automatically tagged:

TreeWalker scans all text nodes
Regex match 0x[a-fA-F0-9]{40}
Inline badge next to the address
Hover shows detail card with votes

2. Contract Scanner

2.1 Scan Flow

flowchart TD A["User triggers scan (from popup menu)"] --> B["Popup resolves target address (wallet / input / address result)"] B --> C["chrome.runtime.sendMessage { type: SCAN_CONTRACT, address }"] C --> D["background.ts: handleScanContract()"] D --> E["Validate address format"] E --> F["scanContractApi(address)"] F --> G["GET /api/v1/contracts/{address}/scan"] G --> H["Return ContractScanData"] H --> I["Return { success, data }"] I --> J["Display scanner modal overlay"]

2.2 Scan Result Format

interface ContractScanData {
  address: string
  riskScore: number                    // 0-100
  level: "safe" | "warning" | "danger" | "unknown"
  checks: ContractScanCheckItem[]      // Individual check results
  source: "api" | "local"
}

interface ContractScanCheckItem {
  key: string                          // e.g. "owner_can_mint"
  label: string                        // e.g. "Owner Can Mint"
  status: "safe" | "warning" | "danger" | "unknown"
  reason: string                       // e.g. "Contract owner has mint function"
}