> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memoryproto.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity Graph

> Memory Identity Graphs

## Identity Graphs

### What it is

A user identity is made up of different Web2 identities (Twitter, GitHub, website, email) and onchain identities (wallet, Farcaster, Lens). Apps and developers usually only have access to a portion of this data, and querying it across platforms can be complex.

Memory introduces **Identity Graphs**: an array of different user identities from Web2 and Web3 sources that together form a user's online persona. With the Memory API, you can query the identity graph of any user using just a wallet address, ENS, Basename, or a Farcaster, Lens, or Zora username.

### How it works

Identity Graphs are built by querying publicly available links for a user, registering the source of each identity, and connecting them. At the end, you get a comprehensive list of a user's identities along with their sources, making it possible to evaluate and filter out untrustworthy data.

In addition to public sources, the [Memory App](https://app.memoryproto.co/) allows users to curate their own identity graph by adding or removing identity links.

### In practice

Below you can see the whole identity graph of [Jesse Pollak](https://x.com/jessepollak) by querying its main wallet ENS [jesse.xyz](https://etherscan.io/name-lookup-search?id=jesse.xyz).
As you can see we have identities for Ethereum, Farcaster, Twitter, GitHub, Basenames, Talent Protocol, Lens, website and email, all queried from a single ENS name. And each identity node has a `source` field, which describes from which other identities and platforms the link was found. For more information about the available identities, check the [identities section.](/essentials/identities)

```json theme={null}
[
  // ...
	{
		"id": "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
		"platform": "ethereum",
		"url": "https://etherscan.io/address/0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
		"avatar": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA4IDgiIHNoYXBlLXJlbmRlcmluZz0ib3B0aW1pemVTcGVlZCIgd2lkdGg9IjY0IiBoZWlnaHQ9IjY0Ij48cGF0aCBmaWxsPSJoc2woOTUgNzMlIDc1JSkiIGQ9Ik0wLDBIOFY4SDB6Ii8+PHBhdGggZmlsbD0iaHNsKDEzMCA5MiUgMjQlKSIgZD0iTTAsMGgxdjFoLTF6TTcsMGgxdjFoLTF6TTMsMGgxdjFoLTF6TTQsMGgxdjFoLTF6TTAsMWgxdjFoLTF6TTcsMWgxdjFoLTF6TTMsMWgxdjFoLTF6TTQsMWgxdjFoLTF6TTEsMmgxdjFoLTF6TTYsMmgxdjFoLTF6TTIsM2gxdjFoLTF6TTUsM2gxdjFoLTF6TTIsNGgxdjFoLTF6TTUsNGgxdjFoLTF6TTMsNGgxdjFoLTF6TTQsNGgxdjFoLTF6TTIsNWgxdjFoLTF6TTUsNWgxdjFoLTF6TTMsNWgxdjFoLTF6TTQsNWgxdjFoLTF6TTAsNmgxdjFoLTF6TTcsNmgxdjFoLTF6TTMsNmgxdjFoLTF6TTQsNmgxdjFoLTF6Ii8+PHBhdGggZmlsbD0iaHNsKDg2IDk3JSA4NSUpIiBkPSJNMiwxaDF2MWgtMXpNNSwxaDF2MWgtMXpNMiwyaDF2MWgtMXpNNSwyaDF2MWgtMXpNMSw0aDF2MWgtMXpNNiw0aDF2MWgtMXpNMiw2aDF2MWgtMXpNNSw2aDF2MWgtMXoiLz48L3N2Zz4=",
		"username": null,
		"social": null,
		"sources": [
			{
				"id": "99",
				"platform": "farcaster",
				"verified": true
			},
			{
				"id": "353682",
				"platform": "talent-protocol",
				"verified": true
			}
		]
	},
	{
		"id": "99",
		"platform": "farcaster",
		"url": "https://warpcast.com/jessepollak",
		"social": {
			"followers": 496387,
			"following": 1877,
			"verified": null
		},
		"avatar": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1013b0f6-1bf4-4f4e-15fb-34be06fede00/original",
		"username": "jessepollak",
		"sources": [
			{
				"id": "99",
				"platform": "farcaster",
				"verified": true
			},
			{
				"id": "353682",
				"platform": "talent-protocol",
				"verified": true
			}
		]
	},
	{
		"id": "1097953",
		"username": "jessepollak",
		"social": {
			"verified": null,
			"followers": 1097,
			"following": 61
		},
		"avatar": "https://avatars.githubusercontent.com/u/1097953?v=4",
		"url": "https://github.com/jessepollak",
		"platform": "github",
		"sources": [
			{
				"id": "353682",
				"platform": "talent-protocol",
				"verified": true
			},
			{
				"id": "jesse.xyz",
				"platform": "ens",
				"verified": true
			}
		]
	},
	{
		"id": "jesse.base.eth",
		"social": null,
		"avatar": null,
		"url": "https://www.base.org/name/jesse.base.eth",
		"platform": "basenames",
		"username": null,
		"sources": [
			{
				"id": "353682",
				"platform": "talent-protocol",
				"verified": true
			}
		]
	},
	{
		"id": "0x4c14105711eccb2c3ade694fc0227e3a5cc4f237",
		"avatar": null,
		"platform": "lens",
		"username": "jessepollak",
		"url": "https://hey.xyz/u/jessepollak",
		"social": {
			"verified": null,
			"followers": 150,
			"following": 36
		},
		"sources": [
			{
				"id": "353682",
				"platform": "talent-protocol",
				"verified": true
			},
			{
				"id": "0x4c14105711eccb2c3ade694fc0227e3a5cc4f237",
				"platform": "lens",
				"verified": true
			}
		]
	},
	{
		"id": "353682",
		"avatar": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1013b0f6-1bf4-4f4e-15fb-34be06fede00/original",
		"platform": "talent-protocol",
		"url": "https://app.talentprotocol.com/profile/353682",
		"username": null,
		"social": null,
		"sources": [
			{
				"id": "353682",
				"platform": "talent-protocol",
				"verified": true
			}
		]
	},
	{
		"platform": "ens",
		"id": "jesse.xyz",
		"url": "https://app.ens.domains/jesse.xyz",
		"avatar": "https://s.gravatar.com/avatar/905fd6810cd184a461697d811a319272.jpg",
		"username": null,
		"social": null,
		"sources": [
			{
				"id": "jesse.xyz",
				"platform": "ens",
				"verified": true
			}
		]
	},
	// ...
]
```

## Linking Identities

Memory Lets API consumers to write back to the identity graph by creating new users links that enhance the identity graph by providing a user verification flow for verified projects. If you want to get verified and contribute to Memory's identity graph see the [Developers Page](https://memoryproto.co/developers)

## Identity Metadata

Each identity node (e.g., Twitter/X, GitHub, ENS) can include optional metadata provided by Memory. This may include, for example, Twitter follower/following stats for each account. Identity metadata will be available soon—stay tuned for updates.
