onchain-money-trail-analyzer README

The project's README from github.com/Signcluengine/onchain-money-trail-analyzer. As one markdown file: README.md.

Ferret. Find where your crypto went.

Release v1.9.1 Windows 10/11, portable MIT license Free, no account Bitcoin, Ethereum, TRON, BNB Chain, Solana

What it does · Install · Recovery-scam shield · Use it right · Questions

A transaction hash is pasted into Ferret, the money is followed across four hops and two chains, and 79% of it turns out to be at an exchange deposit address

Feel like ZachXBT. Find where your crypto went.

Sent crypto to someone who vanished? The money didn't.

Every transfer is still on the chain. Somewhere down that trail there is usually an exchange that knows exactly who opened the account. Ferret follows the trail for you. Paste one address or one transaction hash, and in seconds you get every hop, where the money stopped, who can freeze it, and a report the police can act on today.

Free. On your PC. No account. Ferret never asks you for money.

What it does

The money trail as a statement, with blue strands showing how the money split and crossed chains Where it landed, with the exchange label, its source and confidence
Follow the money. Every hop, in order, across chains Where it landed. Who can freeze it, and how sure Ferret is
Public clues about who runs the wallet, each with a saved source The report for the police and the exchange
Public clues. Who is behind the wallet, with proof The report. Ready for the police and the exchange

Install

One zip, attached to the latest release. It carries Main.exe, its update settings and the ferret runtime, so nothing else has to be installed:

System File
Windows 10 and 11 onchain-money-trail-analyzer.zip
  1. Unpack the zip and start Main.exe. There is no installer and no admin prompt.
  2. Paste the address you paid, or the hash of your payment, and press Trace.

[!NOTE] Main.exe is code-signed, so Windows starts it without a warning. Keep ferret next to it: they ship together.

Follow the money

Ferret lays the trail out like a bank statement: date and time in UTC, chain, where it went, how much. The blue strands in the margin are your money. Each one is as wide as the amount it carries. It splits where the money was split and crosses over where it was bridged to another chain. The strand that reached an exchange stays solid ink, so your best lead is the first thing you see.

It follows Bitcoin, Ethereum and EVM chains, TRON (USDT on TRON is where most scam money moves), BNB Chain and Solana, including swaps and bridges between them.

Where it landed

Ferret names the end of every strand: an exchange deposit address, a mixer, a bridge, an address on the OFAC sanctions list, or one already reported as a scam.

The exchange deposit address is the one that matters. It belongs to a single customer account, and the exchange can freeze it when the police ask. Every label shows where it came from and how sure Ferret is. Labels can be wrong, and Ferret tells you when it isn't sure.

Public clues

Who runs the wallet? Ferret checks public sources only: ENS names, NFTs the wallet holds or shows as an avatar, the address on a scam site's deposit page, public posts that share it, and earlier scam reports. Every clue links to a saved copy of its source and the time it was taken, so it still holds up after the scam site goes dark.

Clues point to the people running a scam, not to a named person. They go to the police, not into a public post.

The report

One click. Your addresses, every transaction hash with its UTC time, chain, asset and amount, the path to the deposit address, a plain-words summary, and a box for your police reference number. Save it as a PDF, copy it as text, or export the transactions as CSV.

The report ends with what to do next, in order:

  1. Report it to the police. In the US: IC3 and ReportFraud.ftc.gov. In the UK: Report Fraud.
  2. Give them the report and ask them to request a freeze from the exchange.
  3. USDT issuers freeze tokens on police requests too. The addresses in the report are all they need.

Hours matter. Money that sits at a deposit address today can be gone tomorrow.

Recovery-scam shield

Ferret flags a fake recovery service: new domain, 23 scam reports, a wallet paid by 41 people

After a theft come the "recovery experts". Paste the site, wallet or handle of anyone who offers to get your money back, and Ferret checks it before you reply.

The rule it keeps repeating: never pay a fee to get crypto back. No tool and no firm can reverse a blockchain transfer. The FBI warns about fake law firms that sell exactly this (PSA I-081325-PSA), and the FTC gives the same advice.

Watch

Leave a case on watch and Ferret tells you when the money moves again, with the new transaction ready to add to your police report.

Where the data comes from

Data Source
Bitcoin mempool.space API, or your own instance
Ethereum and EVM chains Etherscan V2 (free key) or Blockscout
TRON TronGrid (free key, optional)
Solana Public RPC
Sanctions OFAC SDN addresses
Scam reports Chainabuse
Names ENS, through any Ethereum RPC
Labels Open labelled datasets, in the format of labels/

No key is required. Free Etherscan and TronGrid keys raise the rate limits for big cases; paste them in Settings.

Use it right

Build from source

You need Rust 1.85 or newer and the Tauri prerequisites for your system.

git clone https://github.com/Signcluengine/onchain-money-trail-analyzer.git
cd onchain-money-trail-analyzer
cargo test --workspace
cargo tauri build
Path What's inside
crates/ferret-core Hops, labels, confidence and shares
app/ The desktop window and its icons
labels/ Address labels with their source and confidence
assets/ Images for this README

Questions

Can Ferret get my money back?

No tool can. Exchanges and token issuers freeze funds when the police ask. Ferret gets you to that point fast, with a report they can act on. Anyone who asks for a fee to recover crypto is almost certainly running a scam.

Is it really free?

Yes. There is no paid plan, no account and no fee. Ferret never asks you for money.

Does my case leave my PC?

Cases are stored on your PC. Ferret only sends the addresses it looks up to the public data sources listed above. There is no telemetry.

The trail ends at a mixer. Is that the end?

Often it is for a free tool. Put the case on Watch and include it in your report anyway: the police and the exchanges work with tools that can go further.

Why does a label say "Medium"?

Some labels come from patterns, such as a deposit address that sweeps into an exchange's hot wallet. They are usually right, but not always. Ferret shows the source so you, and the police, can check.

Is Ferret like Chainalysis, Arkham or MetaSleuth?

They're built for analysts and priced for companies. Ferret is built for the person who lost the money: paste one address, see where it went, hand the report to the police. Free, with no account.

License

Ferret is MIT licensed. The UI bundles Inter and Geist Mono, both under the SIL Open Font License 1.1.

Exchange names, addresses and cases in the screenshots are fictional. Ferret isn't affiliated with any exchange, blockchain, data provider or law enforcement agency named here.

ZachXBT, Chainalysis, Arkham and MetaSleuth are named for comparison only. Ferret isn't affiliated with or endorsed by any of them.

onchain-money-trail-analyzer (Signcluengine/onchain-money-trail-analyzer)

Searching Database…