Knowledge Graph

Intuition Attestation Trust

TrustGate surfaces a second trust signal alongside behavioral scoring: what others have attested about an entity in the Intuition knowledge graph. Available on the Oracle and Token Shield score views only. Not exposed to integrators, the widget, or the public API.

Behavioral vs knowledge graph

TrustGate's default signal is behavioral: what an address has done onchain. The knowledge graph signal measures something different: what others have attested, endorsed, or connected to that entity in Intuition.

These are independent lenses on the same address. A wallet can score HIGH behaviorally and show sparse graph coverage, or the reverse. TrustGate does not blend them into a single score. The toggle exists so you can compare both and decide what weight each deserves.

Where it is available

The Knowledge Graph toggle appears on platform score views only:

Oracle — wallet trust playground
Token Shield — token and contract scoring UI

Integrators calling the oracle, widget endpoint, or REST proxy receive behavioral scores only. Graph trust is not published through those surfaces.

How results are resolved

When you switch to Knowledge Graph, trustgated.xyz queries Intuition through a server-side proxy at /api/graph-trust. The proxy calls the Intuition MCP and merges two result types:

1. Personalized path trust

When a trust path exists from the configured anchor set to the queried address, you get a path score, path count, linked source accounts, and top relationships. This is the strongest graph signal.

2. Global standing fallback

When no personalized path exists but the address has attestation history in the graph, TrustGate falls back to a global composite score, confidence percentage, and verdict from explain_trust_score. The UI labels this as global standing only and recommends caution.

3. Not found

When neither a path nor meaningful global standing exists, the UI shows an honest empty state: the graph has not indexed this address yet. Unknown is not the same as bad.

Query address
    │
    ├─ Personalized path exists? ──yes──► path score + relationships
    │
    └─ no
         │
         ├─ Global composite exists? ──yes──► global standing + verdict
         │
         └─ no ──► not_found (no graph data yet)

Graph tier bands

Graph tiers use the same 0 to 100 scale as behavioral scoring but are derived from attestation confidence and path density, not onchain activity.

Tier	Score	Meaning
HIGH	70 to 100	Strong attestation standing with sufficient confidence
MEDIUM	40 to 69	Reasonable graph standing, moderate confidence
LOW	1 to 39	Limited attestation coverage
UNKNOWN	0 or sparse	Insufficient data to classify

Coverage states

indexed — enough paths and sources for a reliable signal
sparse — some data exists but confidence is low; treat as weak signal
not_found — no meaningful graph data for this address

Architecture

Browser clients never call Intuition directly. The Next.js route at src/app/api/graph-trust/route.ts performs the MCP handshake, calls personalized trust and global explain tools, and returns a normalized GraphTrust payload for the UI.

Default MCP endpoint: https://mcp-trust.intuition.box/mcp. Override with INTUITION_MCP_URL in server environment variables.

Personalized paths use a default anchor address set. Override with GRAPH_TRUST_ANCHOR_ADDRESSES (comma-separated 0x addresses) when deploying.

What this is not

Not a replacement for behavioral TrustGate scoring
Not available on the widget, oracle API, or integrator proxy
Not identity verification or KYC
Not a blended or averaged score with behavioral trust

For behavioral scoring detail, see Trust Scoring. For public API surfaces integrators can call, see API Reference.