Contracts

This repository contains all the contracts deployed by the Farcaster protocol. The contracts are:

Id Registry - tracks ownership of farcaster identities (fids).
Storage Registry - allocates storage to fids and collects rent.
Key Registry - tracks associations between fids and key pairs for signing messages.
Id Gateway - issues farcaster identities (fids) to new users.
Key Gateway - adds new associations between fids and keys.
Bundler - allows calling gateways and storage in a single transaction.
Signed Key Request Validator - validates key registry metadata.
Recovery Proxy - proxy for recovery service operators to initiate fid recovery.
Fname Resolver - validates Farcaster ENS names which were issued off-chain.

Read the docs for more details on how the contracts work.

Deployments

The v3.1 contracts are deployed across both OP Mainnet and Ethereum Mainnet.

Contract	Address
IdRegistry	0x00000000fc6c5f01fc30151999387bb99a9f489b
StorageRegistry	0x00000000fcce7f938e7ae6d3c335bd6a1a7c593d
KeyRegistry	0x00000000fc1237824fb747abde0ff18990e59b7e
IdGateway	0x00000000fc25870c6ed6b6c7e41fb078b7656f69
KeyGateway	0x00000000fc56947c7e7183f8ca4b62398caadf0b
Bundler	0x00000000fc04c910a0b5fea33b03e0447ad0b0aa
SignedKeyRequestValidator	0x00000000fc700472606ed4fa22623acf62c60553
RecoveryProxy	0x00000000fcb080a4d6c39a9354da9eb9bc104cd7

Contract	Address
FnameResolver	Not yet deployed

The v3.1 contracts contracts were reviewed by 0xMacro and Cyfrin.

The v3.0 contracts contracts were reviewed by 0xMacro:

Name		Name	Last commit message	Last commit date
Latest commit History 287 Commits
.github		.github
.vscode		.vscode
docs		docs
lib		lib
script		script
src		src
test		test
.env.example		.env.example
.env.local		.env.local
.env.prod		.env.prod
.env.upgrade		.env.upgrade
.gas-snapshot		.gas-snapshot
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.lintstagedrc		.lintstagedrc
.rusty-hook.toml		.rusty-hook.toml
.solhint.json		.solhint.json
.solhintignore		.solhintignore
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.toml		Cargo.toml
Dockerfile.foundry		Dockerfile.foundry
README.md		README.md
build.rs		build.rs
docker-compose.yml		docker-compose.yml
foundry.toml		foundry.toml
main.rs		main.rs
slither.config.json		slither.config.json