Skip to content
TrustList

Names, trust and privacy, layered on a wallet

An address proves control of funds, not who you're paying.

Anatomy of a contact

  1. 1Addresses and purposes
  2. 2Tags
  3. 3Trust level
  4. 4Verifiable signals
  5. 5Private note
  6. 6Visibility

Inès Roy

Treasurer, Campus Blockchain Club

Main wallet

0x7a3f91c0…e0f3c19e

Frequent collaboratorTrusted partner
Trusted
Verified by owner7 people vouch for this address

Signs the club's multisig with Théo and me.

Circle · Campus Blockchain Club

Where your list lives

Signing in derives a key from your wallet. It never leaves your device.

  1. Your device

    Private

    Encrypted with your wallet-derived key. No fee.

  2. Your circle

    Circle

    Encrypted on IPFS. Only members can read it.

  3. IPFS + chain

    Public

    Public, with its content ID anchored on-chain.

Only public entries pay a network fee.

Trust signals, and why there's no score

A score hides whose opinion it is. TrustList keeps judgement and evidence apart.

  • Your trust level

    Your call, in four plain levels.

  • Verified by owner

    The owner signed to confirm the name. Proves control, nothing more.

  • Vouches

    Public, signed "I know this address" statements.

TrustedKnownUnverifiedFlagged

How the address check decides

It stops at the first rule that matches.

  1. 1

    Is it an address?

    0x and 40 hex characters.

  2. 2

    Is it yours?

    One of your own wallets.

  3. 3

    Is it in your list?

    Your trust level decides the answer.

  4. 4

    Does it imitate someone?

    Same start and end as a contact: a lookalike.

  5. 5

    Do your circles know it?

    Vouched for or flagged by members.

  6. 6

    Otherwise, it's a stranger

    Send a small test amount first.

For developers

Apps never download your list. Your wallet names the addresses on screen, within the scopes you granted.

Show the resolve API

Permission scopes

names
Names and address purposes.
trust
Trust levels, tags, owner verification.
warnings
Flagged addresses and lookalike alerts.

Notes are not a scope: no app can request them.

// Inside a connected app (e.g. TaskFlow)
const names = await trustlist.resolve([
  "0x4b1c0e7da29f63b85c1e0a4d97f2b6c3e58a9e02",
  "0xd3f2201769e1f60fb3278e7f1fe1ae6b6fb7b4dd",
], { scopes: ["names", "trust", "warnings"] })

// → [
//   { name: "Malik Haddad", purpose: "Main wallet",
//     trust: "known", verified: false },
//   { warning: "flagged", source: "circle" },
// ]
// Notes are never part of the response.

Questions

Who can see my contacts?

Only you, unless you put a contact in a circle or make it public.

What do apps see?

Only the scopes you allow. Never your notes. Revoke access at any time.

Does it cost anything?

Private and circle contacts are free. Public entries and vouches pay a network fee.

Is this a real product?

It's a working demo of Monark's Trust Contacts module. No real funds are involved.

Paste a lookalike and see

Launch the demo