--- name: scan.madhousewallet.com description: scan.madhousewallet.com provides on-chain risk scanning for EVM wallet addresses, returning a toxicity score, risk level classification, and flag recommendation. It supports Avalanche, Optimism, and general EVM chains via three distinct endpoints, all powered by Web3 Antivirus signals. host: scan.madhousewallet.com --- # scan.madhousewallet.com Madhouse Wallet's scan host is a compliance and risk-screening tool for agents that need to evaluate wallet addresses before executing transactions, filtering counterparties, or enforcing trust policies. It covers multiple EVM chains through chain-specific and general-purpose endpoints, returning structured risk signals (toxicScore, riskLevel, shouldFlag, traits/flaggedMetrics) suitable for automated gating logic. It does not perform deep forensic tracing or support non-EVM chains. ## When to use this host Use this host when an agent needs a fast, structured risk signal for an EVM wallet address prior to a transaction, off-ramp, or counterparty trust decision. For Avalanche-specific addresses use fetch-avalanche-quick-scan; for Optimism or other EVM chains use fetch-optimism-quick-scan with the chain parameter; for general EVM addresses or ENS names use scan-evm-wallet-risk. Do not use this host for non-EVM chains such as Solana or Bitcoin — no skill here supports them. Do not use this host for deep forensic analysis, transaction-level tracing, or real-time streaming monitoring; these skills are single-shot address scans only. For those needs, a dedicated blockchain analytics platform (e.g., Chainalysis, TRM Labs) would be more appropriate. ## Capabilities ### EVM Wallet Risk Screening Scans EVM wallet addresses or ENS names for on-chain risk signals, producing a toxicity score, risk level, and flag recommendation usable in transaction gating or compliance workflows. - **`scan-evm-wallet-risk`** — Scans any EVM wallet address or ENS name for on-chain risk signals, returning a toxic score (0–1), risk level (PASS/LOW/MIDDLE/CRITICAL), and flagged risk categories powered by Web3 Antivirus. - **`fetch-optimism-quick-scan`** — Scans an Optimism (or other EVM chain) wallet address for onchain risk signals, returning a toxic score, risk level, and flag status. - **`fetch-avalanche-quick-scan`** — Scans an Avalanche address for on-chain risk signals and returns a toxicity score, risk level, and flag recommendation. ## Workflows ### Multi-Chain Counterparty Risk Check *Use when an agent needs to assess the same or different wallet addresses across multiple EVM chains (e.g., Avalanche and Optimism) before approving a cross-chain interaction or multi-chain transaction.* 1. **`fetch-avalanche-quick-scan`** — Scan the target address on Avalanche to retrieve its toxicScore, riskLevel, and shouldFlag status on that chain. 2. **`fetch-optimism-quick-scan`** — Scan the same or related address on Optimism to retrieve its risk signals on that chain. 3. **`scan-evm-wallet-risk`** — Run a general EVM scan (including ENS resolution if applicable) to consolidate flaggedMetrics and confirm overall risk posture before making a final allow/block decision. ## Skill reference ### `fetch-avalanche-quick-scan` **Avalanche Quick Scan** — Scans an Avalanche address for on-chain risk signals and returns a toxicity score, risk level, and flag recommendation. *Use when:* Use when an agent needs to assess the risk profile of an Avalanche wallet address before interacting with it, sending funds, or displaying trust indicators to a user. *Not for:* Do not use for non-Avalanche chains; use the corresponding chain-specific quick-scan endpoint instead. Not suitable for deep forensic analysis or transaction-level tracing. **Inputs:** - `address` (string, required) — The Avalanche wallet address to scan for risk signals. **Returns:** Returns the scanned address, a toxicScore integer, a riskLevel string (e.g. PASS), a shouldFlag boolean, and a traits array listing any detected risk signals. **Example:** `GET https://scan.madhousewallet.com/api/public/quick-scan/avalanche?address=0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `fetch-optimism-quick-scan` **Optimism Quick Scan** — Scans an Optimism (or other EVM chain) wallet address for onchain risk signals, returning a toxic score, risk level, and flag status. *Use when:* Use when an agent needs a fast risk assessment of a wallet address on Optimism or a compatible EVM chain, such as before executing a transaction, filtering counterparties, or flagging suspicious addresses. *Not for:* Do not use for deep forensic chain analysis or transaction-level tracing; this is a quick single-address risk signal only. Not suitable for non-EVM chains. **Inputs:** - `chain` (string, required) — EVM chain identifier to scan against (e.g. 'optimism', 'base'). - `address` (string, required) — EVM wallet address to scan (0x-prefixed, 42 characters). **Returns:** Returns the scanned address with toxicScore (0 = clean), riskLevel string (e.g. PASS), shouldFlag boolean, and a traits array listing any detected risk labels. **Example:** `GET https://scan.madhousewallet.com/api/public/quick-scan/optimism?chain=optimism&address=0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `scan-evm-wallet-risk` **Madhouse Wallet EVM Risk Scan** — Scans any EVM wallet address or ENS name for on-chain risk signals, returning a toxic score (0–1), risk level (PASS/LOW/MIDDLE/CRITICAL), and flagged risk categories powered by Web3 Antivirus. *Use when:* Use when an agent needs to assess the risk profile of an EVM wallet address or ENS name before processing a transaction, off-ramp, or compliance check — especially when a shouldFlag=true result should block the operation. *Not for:* Do not use for non-EVM chains (e.g., Solana, Bitcoin). Not suitable for real-time streaming risk monitoring; this is a single-shot scan per address. **Inputs:** - `address` (string, required) — EVM wallet address (0x-prefixed, checksummed) or ENS name to scan. **Returns:** Returns address, toxicScore=0, riskLevel=PASS, shouldFlag=false, flaggedMetrics=[], and ens=null for a clean wallet; non-zero scores include populated flaggedMetrics with named risk categories. **Example:** `GET https://scan.madhousewallet.com/api/public/scan?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045` ---