Skip to main content
All OP tokenholders, a key stakeholder group, are represented in governance via the Token House. The Token House uses token-weighted voting, giving influence proportional to OP token holdings. Tokenholders may vote themselves or assign their voting power to a “delegate.” The primary role of tokenholders is to express their financial interest in the evolution of the Superchain and to hold proposers accountable. Tokenholders may vote on:Protocol UpgradesDelegates have the power to veto decisions about protocol upgrades made by the Developer Advisory Board (DAB). This veto power serves as a critical check on technical changes, with the aim of ensuring they align with the interests of those who rely on the protocol.Capital AllocationDelegates participate in resource allocation decisions, including:
  • Approving the Collective Intent, missions, and budget
  • Approving Governance Fund proposals
Representative ElectionsDelegates elect members to the Councils and Boards and/or approve any alternative selection mechanismsRatificationDelegates may ratify core governing documents.For a full description of the voting mechanics for each of these proposal types, please refer to the Operating Manual. In future phases, the Token House may gain additional governance powers.
Unlock Your Voting PowerOP token holders are able to vote on some of the most important decisions for the Collective. This empowers one of the Collective’s key stakeholders to have a say in the development of the system.You can either vote yourself with your OP tokens, or you can delegate the voting power of your OP tokens to someone else to make decisions on your behalf.Get started at vote.optimism.io/delegates
Unlock Your Voting PowerOP token holders are able to vote on some of the most important decisions for the Collective. This empowers one of the Collective’s key stakeholders to have a say in the development of the system.You can either vote yourself with your OP tokens, or you can delegate the voting power of your OP tokens to someone else to make decisions on your behalf.Get started at vote.optimism.io/delegates
Users, Apps, and Chains, key stakeholder groups, are represented in governance via the Citizens’ House. The Citizens’ House uses a 1 member, 1 vote model, so all members have the same level of influence. The primary role of Citizens is to express their preferences in the evolution of the Superchain and to hold proposers accountable. Citizens may vote on:Protocol UpgradesCitizens have the power to veto decisions about protocol upgrades made by the Developer Advisory Board (DAB). This veto power serves as a critical check on technical changes, ensuring they align with the interests of those who rely on the protocol.Resource AllocationCitizens participate in resource allocation decisions, including:
  • Approving the Collective Intent, missions, and budget
Representative ElectionsCitizens elect representatives to the Developer Advisory Board, ensuring it remains accountable to their interests.RatificationCitizens may ratify core governing documents.For a full description of the voting mechanics for each of these proposal types, please refer to the Operating Manual. In future phases, the Citizens’ House may gain additional governance powers.
The Token House and the Citizens’ House together represent all key stakeholders of the Superchain: tokenholders, chains, apps, and end-users. Both houses vote on proposals when the interests of all stakeholders should be represented in a particular decision. Each house has a distinct voting mechanism which, when combined together, creates a system of checks and balances aimed at balancing competing interests.Voting happens on a regular schedule via three-week voting cycles. Regular voting Cycles begin on Thursday at 19:00p GMT (12p PST) and end on Wednesday at 19:00 GMT (12p PST). Protocol Upgrades may go through an accelerated process. You can view full details here. You can track cycles on the governance calendar.
Key stakeholders of the Superchain can protect their interests by participating in Optimism’s public decision making process (governance). This process allows stakeholders to influence the future of the Superchain with limited day-to-day involvement.Key stakeholders will be asked to:
  • Vote: 1-2 times per year
  • Provide input: 3-4 times per year
  • Veto: only as needed
Email notifications will be sent to all stakeholders whenever any of the above actions is possible. Stakeholders can also monitor activity directly at vote.optimism.io or atlas.optimism.ioToken House Voters
  1. Activity: The social standard for being an active delegate is participating in 70% of all votes.
  2. No self-dealing: Voters are prohibited from approving and voting on their own proposals. Voters may not vote solely for their own candidacy in an election. In the case of approval/ranked choice elections, optimists may vote for themselves, so long as they also cast votes for the remaining elected positions.
  3. Conflicts of Interest: Any actual or reasonably anticipated conflicts of interest must be disclosed in writing and prominently displayed ahead of any voting (i.e. when approving proposal drafts, when running for an elected position, when making public recommendations).
These guidelines help ensure that the Token House remains active and resistant to capture or manipulation.Citizens House VotersTo maintain the integrity of the Citizens’ House, several important rules govern participation:
  1. No Double Representation: If you are an admin of a Citizen project or organization, you may not also join the Citizens’ House as a Superchain user.
  2. Organization Priority: An organization and a project under that organization can never both get votes in the Citizens’ House. If both are eligible, membership defaults to the organization.
  3. No Multiple Accounts: It is forbidden to create multiple accounts to attempt to get multiple votes in the Citizens’ House as a Superchain user. In Season 8, Citizens will be manually reviewed for possible Sybil activity by the Optimism Foundation.
  4. Seasonal Recalculation: The eligibility criteria for being a member of the Citizens’ House will be recalculated every Season and may change—being a Citizen now doesn’t guarantee future Citizens’ House membership.
These rules help ensure that the Citizens’ House remains balanced, representative, and resistant to capture or manipulation.You can view the Code of Conduct here.
Funding public goods is core to Optimism’s values and vision for a healthy ecosystem. Retroactive Public Goods Funding (Retro Funding) is an experimental grant program to reward public goods that have created impact in the Optimism ecosystem. Learn more at atlas.optimism.io
This guide covers Ethereum Attestation Service (“EAS”), an open-source public good that is included as a predeploy in the OP Stack. It also covers EAS contract addresses, how to read and write attestations, and indexing.
This guide covers Ethereum Attestation Service (“EAS”), an open-source public good that is included as a predeploy in the OP Stack. It also covers EAS contract addresses, how to read and write attestations, and indexing.EAS contract addressesThe Ethereum Attestation Service is deployed on these addresses:
NetworkAttestation ContractSchema Registry Contract
OP Sepolia0x42000000000000000000000000000000000000210x4200000000000000000000000000000000000020
OP Mainnet0x42000000000000000000000000000000000000210x4200000000000000000000000000000000000020
How to read and write attestationsYou can read and write attestations in several ways:IndexingIndexing is available via:
Schemas define the structure and type of data that can be included in an attestation.Below you will find a list of relevant schemas that are being used on OP Mainnet. Schemas are built using the Ethereum Attestation Service.

​
General schemas

Schemas related to project creation and Retro funding applicationProject and organization identifierUsed as the unique identifier for projects and organizations created on or after 23 August 2024. For projects created earlier, please see the archived section at the bottom of this page.
Schema UID0xff0b916851c1c5507406cfcaa60e5d549c91b7f642eb74e33b88143cae4b47d0
IssuerAttestations issued as part of Retro Funding sign up are issued by 0xF6872D315CC2E1AfF6abae5dd814fd54755fE97C
farcasterIDThe Farcaster id of the individual who created the project or organization
type”Project” or “Organization”
Organization metadataUsed to associate metadata to an organization. Re-issued each time there is a change to metadata
Schema UID0xc2b376d1a140287b1fa1519747baae1317cf37e0d27289b86f85aa7cebfd649f
IssuerAttestations issued as part of Retro Funding sign up are issued by 0xF6872D315CC2E1AfF6abae5dd814fd54755fE97C
RecipientNull
RefUIDThe attestation UID of the organization this metadata relates to
farcasterIDThe Farcaster id of the individual who published the organization metadata
nameThe name of the organization
projectsThe array of projects that belong to this organization
parentOrgUIDThe attestation UID of this organization’s parent, in case it has one
metadataTypeHow the metadata can be accessed. 1 for ipfs, 2 for http
metadataUrlThe storage location where the metadata can be retrieved
Project metadataUsed to associate metadata to a project. Re-issued each time there is a change to metadata.
Schema UID0xe035e3fe27a64c8d7291ae54c6e85676addcbc2d179224fe7fc1f7f05a8c6eac
IssuerAttestations issued as part of Retro Funding sign up are issued by 0xF6872D315CC2E1AfF6abae5dd814fd54755fE97C
RecipientNull
projectRefUIDThe attestation UID of the project this metadata relates to
farcasterIDThe Farcaster id of the individual who published the project metadata
nameThe name of the project
categoryThe category of the project
parentProject RefUIDThe attestation UID of this project’s parent project, in case it has a parent
metadataTypeHow the metadata can be accessed. 1 for ipfs, 2 for http
metadataUrlThe storage location where the metadata can be retrieved
Retro funding applicationUsed to identify a project’s application to a specific Retro Funding Round. This attestation is used for Retro Funding Round 6 and beyond.
Schema UID0x2169b74bfcb5d10a6616bbc8931dc1c56f8d1c305319a9eeca77623a991d4b80
IssuerAttestations issued as part of Retro Funding sign up are issued by: 0xF6872D315CC2E1AfF6abae5dd814fd54755fE97C
RecipientNull
roundThe round number for which this application was submitted
metadataTypeHow the metadata can be accessed. 1 for ipfs, 2 for http
metadataUrlThe storage location where the metadata can be retrieved
farcasterIDThe individual that submitted this application on behalf of the project.
metadataSnapshot RefUIDThe project metadata at the time the application was submitted.
Retro funding application approval/rejectionUsed to identify which Retro Funding applications have been approved or rejected.
Schema UID0x683b1b399d47aabed79c9aa8f2674729021174b6e5cce1e20675eab404fc82d6
IssuerCurrently, the Optimism Foundation issues these from the following address: 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F
RecipientNull
projectApplicationUIDThe unique identifier of the projects Retro Funding application.
StatusThe status of the Retro Funding application.
ReasonIdentifier for the reason an application was rejected. 1 = “Duplicate Application”, 2 = “Deceiving Badgeholders”, 3 = “Spam”, 4 = “Not meeting eligibility criteria”
Retro funding rewardsUsed to identify the reward amount each approved project received in a Retro Funding round
Schema UID0x670ad6e6ffb842d37e050ea6d3a5ab308195c6f584cf2121076067e0d8adde18
IssuerCurrently, the Optimism Foundation issues these from one the following address: 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F
RecipientNull
refUIDThe UID of the Retro Funding application
projectRefUIDThe unique identifier of the project
roundThe retro round for which the project was rewarded
OPamountThe amount of OP awarded to the project
Token house grant approvedIssued by the Grants Council when a project is approved for a grant. Does not indicate that the grant has been completed.
Schema UID0x8aef6b9adab6252367588ad337f304da1c060cc3190f01d7b72c7e512b9bfb38
IssuerCurrently issued by the Grants Council lead.
RecipientThe address where the tokens will be delivered once the grant has been completed.
refUIDCurrently null
projectRefUIDThe unique identifier of the project that was approved for the grant.
UserIncentivesOPThe OP amount approved for user incentives.
BuildersOPThe OP amount approved for the builder.
SeasonThe season (number) in which the grant was approved
IntentThe intent (number) to which the mission belongs
MissionThe name of the mission (in words) under which this grant was made.
Approval dateThe date the grant was approved, in the following format MM/DD/YYYY
MetadataUrlCurrently null
CitizensCitizen attestations were first issued in Season 6 and are used to represent Citizenship separately from the ability to vote in a specific Retro Round. The resolver contract checks that the issuer is the Foundation with following address 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F
Schema UID0xc35634c4ca8a54dce0a2af61a9a9a5a3067398cb3916b133238c4f6ba721bc8a
RefUIDIn case the Citizen is a chain or an app, the refUID field will reference the organization/project id of the chain or app. If null, the Citizen is an end-user
FarcasterIDThe Citizen’s unique identifier
SelectionMethodA Code representing the method through which the Citizen was selected. Codes beginning with the number 1 refer to various flavours of Web of Trust selection.
Retro funding votersThese attestations are voting Badges issued for Retro Round 5 and beyond. They are different from the previous schema to include new fields like votingGroup, used to assign voters to sub-categories in the round.
Schema UID0x41513aa7b99bfea09d389c74aacedaeb13c28fb748569e9e2400109cbe284ee5
FarcasterIDThe voter’s unique identifier
RoundThe round number for which this voting Badge was valid
voterTypeGuest or Citizen
votingGroupUsed to assign voters to subcategories in case the Round has subcategories
selectionMethodThe method in which this voter was selected
MetaGov contribution
Schema UID0x84260b9102b41041692558a4e0cba6b7e5f9b813be56402c3db820c06dd4a5f1
IssuerCurrently, the Optimism Foundation issues these from one of the following addresses: 0x621477dBA416E12df7FF0d48E14c4D20DC85D7D9 or 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F.
RecipientThe address of the individual who made the contribution
refUIDThe UID of the project, in case this contribution is represented as a project
FarcasterIDThe id of the individual who made the contribution, if known
ImpactThis field is not currently being used
SeasonThe season in which the contribution was made
Decision ModuleThe decision module to which the contribution relates
Contribution TypeThe type of contribution
MetadataUrlThis field is not currently being used
Foundation mission request completed
Schema UID0x649cc6df5af7561b66384405a62682c44e2428584d2f17a202ac3ef4506e2457
IssuerCurrently, the Optimism Foundation issues these from one of the following addresses: 0x621477dBA416E12df7FF0d48E14c4D20DC85D7D9 or 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F.
projectRefUIDThe UID of the project that represents the work completed as part of the Foundation Mission Request
OP AmountThe OP Amount that was awarded for the completion of this Mission Request
SeasonThe season in which this Mission Request was completed
Retro funding governance contribution
Schema UID0x3743be2afa818ee40304516c153427be55931f238d961af5d98653a93192cdb3
IssuerCurrently, the Optimism Foundation issues these from one of the following addresses: 0x621477dBA416E12df7FF0d48E14c4D20DC85D7D9 or 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F.
RecipientThe address of the individual who made the contribution
Rpgf_roundThe round number for which this contribution was made
RetroPGF_ContributionThe type of contribution made
Governance contributionIssued to those who held governance roles in the Collective, such as Grants Council members.
Schema UID0xef874554718a2afc254b064e5ce9c58c9082fb9f770250499bf406fc112bd315
IssuerCurrently, the Optimism Foundation issues these from one of the following addresses: 0x621477dBA416E12df7FF0d48E14c4D20DC85D7D9 or 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F.
IssuerCurrently, the Optimism Foundation issues these from one of the following addresses: 0x621477dBA416E12df7FF0d48E14c4D20DC85D7D9 or 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F
RecipientThe address of the individual who made the contribution
govSeasonThe season the individual held the role
govRoleThe role held by the individual

​
Archived schemas

These schemas are no longer being actively issued, but capture valuable historical data.Retro funding applicationUsed to identify a project’s application to a specific Retro Funding Round. This attestation was used for Retro Funding Rounds 4 and 5.
Schema UID0x88b62595c76fbcd261710d0930b5f1cc2e56758e155dea537f82bf0baadd9a32
IssuerAttestations issued as part of Retro Funding sign up are issued by: 0xF6872D315CC2E1AfF6abae5dd814fd54755fE97C
RecipientNull
roundThe round number for which this application was submitted
projectRefUIDThe unique identifier of the project that submitted this application
farcasterIDThe individual that submitted this application on behalf of the project.
metadataSnapshot RefUIDThe project metadata at the time the application was submitted.
Retro funding badgeholdersThese attestations are considered “voting Badges” and allow an individual to vote in any given iteration of Retro Funding. They were used up to and including Retro Round 4.
Schema UID0xfdcfdad2dbe7489e0ce56b260348b7f14e8365a8a325aef9834818c00d46b31b
IssuerCurrently, the Optimism Foundation issues these from one of the following addresses: 0x621477dBA416E12df7FF0d48E14c4D20DC85D7D9 or 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F
RecipientThe Badgeholder’s address
rpgfRoundThe round number for which this voting Badge was valid
referredByIn early rounds, new Badges were issued by referral. This field captures the address of the referrer, if there was one
referredMethodIf this voting Badge was issued by referral, this field captures the referral method
Project identifierUsed as the unique identifier for projects created in the Collective before 23 August 2024. Attestations issued from this schema prior to 23 August 2024 are still used as the unique identifier for projects. New projects created after 23 August 2024 use the new entity identifier (see above).
Schema UID0x7ae9f4adabd9214049df72f58eceffc48c4a69e920882f5b06a6c69a3157e5bd
IssuerAttestations issued as part of Retro Funding sign up are issued by 0xF6872D315CC2E1AfF6abae5dd814fd54755fE97C
RecipientNull
farcasterIDThe Farcaster id of the individual who created the project
Here you’ll find the Superchain Health Dashboard, below are relevant OP trackers, reports, and addresses.Governing DocumentationOP TrackersFoundation Budget Reports
  • These can be found here on the governance forum.
Retroactive Public Goods Funding Round Results
  • These can be found here on retrofunding.optimism.io.
Relevant AddressesYou can find the list of wallets across L1 and OP Mainnet where the Optimism Collective Revenue earned sits here, on the right-hand side of the Collective Contribution page.
  • OP Treasury Address for Foundation Allocated Budget: 0x2A82Ae142b2e62Cb7D10b55E323ACB1Cab663a26
    • This address hold the remaining OP tokens allocated to the Foundation, which the Foundation requires governance approval to access (via annual FND budget proposals).
  • OP Treasury Address for Foundation Approved Budget: 0x2501c477D0A35545a387Aa4A3EEe4292A9a8B3F0
    • This is the Foundation’s OP Treasury which is available for the Foundation to utilize as the Foundation’s budget granted through the initial token allocation. Transactions from this wallet are typically internal operational movements per the Foundation’s needs.
    • Additional token may be moved from 0x2…a26 to 0x2…3F0 based on governance approval of budgets.
  • OP Foundation Grants Wallet: 0x19793c7824Be70ec58BB673CA42D2779d12581BE
    • This Foundation wallet is used to make private OP grants. This is topped up from the OP Treasury Foundation Approved Budget wallet 0x2…B3F0 as needed.
  • OP Foundation Locked Grants Wallet: 0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F
    • This Foundation wallet is used to hold OP for one year lockups. This is topped up from the OP Foundation Grants Wallet 0x1…81BE as needed.
Optimism Governance Calendar
  • You can find a link to the Governance Calendar here.
The Optimism Foundation is a Cayman Islands foundation company. It operates to support the establishment of the Optimism Collective, the development of the Optimism ecosystem, and the technology that powers it.Consistent with the Collective’s Working Constitution, the Foundation strives to:
  • Support the Collective with a formal legal entity, allowing the Foundation to:
    • Enter into contracts with third parties, such as service providers.
    • Administer intellectual property rights.
    • Make required governmental reports and filings.
How does the Foundation work?The Optimism Foundation is governed by a Board of Directors and a Supervisor.The Board of Directors currently consists of: Abbey Titcomb, Mark Tyneway, Brian Avello, and Jing Wang. The Board’s role is to manage the business and affairs of the Foundation.The Supervisor is the Cayman Islands firm, DS Limited. Its role is to oversee the Foundation’s directors and ensure the observance of their legal obligations.The Foundation also employs officers, contractors and service providers to execute on its operational and administrative aims.How is the Foundation held accountable?As a Cayman Islands foundation company, the Foundation is legally accountable to its governing documentation, which sets up the Foundation to defer to the will of the Optimism Collective and its governance.There are two governance proposal types specifically targeted towards ensuring that the Foundation and its personnel are accountable to the will of the Collective:
  • Director removal - the ability of governance to have a member of the Foundation’s Board of Directors removed from service.
  • Rights protections - a blocking vote, which enables governance to veto any proposed change to the Foundation’s governing documents that would materially reduce the rights of OP token holders.
More information on each of the above proposal types is contained in the Operating Manual.