Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.
ZK proofs are experimental and under active development. Do not rely on them to secure a production chain yet.
A ZK dispute game accepts proofs only from the program its absolutePrestate identifies: the verification key of the super-aggregation program, which in turn pins the super-range and log-commitment programs. See Absolute prestate for why.This guide shows how to find the prestate for a release, confirm it by rebuilding the programs yourself, build a prestate for a chain that is not in the superchain-registry, and serve the program files that op-zk-proposer needs.
Find the standard prestate
The ZK proof programs are released under the kona-sp1-program/vX.Y.Z tags in the Optimism monorepo. Each standard release’s prestate is recorded in the superchain-registry’s standard-prestates.toml, as an entry of type kona-sp1 under the release’s version.A standard prestate covers every chain whose configuration is in the superchain-registry at that release. Use it if your chain is in the registry.
Rebuild the prestate from source
The programs build reproducibly in Docker, so you can confirm a prestate without trusting the published value. You need a Linux amd64 machine with Docker and mise.
Check out the release tag:
git clone https://github.com/ethereum-optimism/optimism.gitcd optimismgit checkout kona-sp1-program/v<version>mise trust && mise install
Build the programs:
cd rust/kona/sp1just build-elfs
This builds log-commitment, then super-range with the log-commitment key embedded, then super-aggregation with the super-range key embedded. It writes the binaries to elf/ and their verification keys to elf/vkeys.toml.
The super-aggregation value is the prestate. Confirm that it matches the registry entry, and that git_sha is the tagged commit with no -dirty or -custom suffix.Every build embeds the commit it was built from, so you must build from the exact tagged commit. A build of the same code from any other commit produces a different prestate.
Build a prestate for a custom chain
The programs only accept chains whose configuration is compiled into them. If your chain is not in the superchain-registry, build the programs with your chain’s configuration:
cd rust/kona/sp1KONA_CUSTOM_CONFIGS_DIR=/path/to/configs just build-elfs
The directory must contain chainList.json, configs.json, and depsets.json in the superchain-registry’s format. The L1 must be Ethereum mainnet, Sepolia, or Holesky.The resulting prestate is specific to your configuration and the commit you built from, and the manifest’s git_sha ends in -custom. Anyone who wants to verify your chain’s prestate needs your configuration files and the commit, so publish both.
Publish the program files
op-zk-proposer loads each prestate’s programs from OP_ZK_PROPOSER_PRESTATES_URL, by verification key. The directory at that URL must serve, for every prestate in use:
File
Contents
<vkey>.agg.bin.gz
gzip-compressed super-aggregation binary
<vkey>.range.bin.gz
gzip-compressed super-range binary
<vkey>.log.bin.gz
gzip-compressed log-commitment binary
<vkey> is the lowercase, 0x-prefixed super-aggregation key.For standard releases, these files are published for every tag under https://storage.googleapis.com/oplabs-network-data/proofs/kona/sp1/, which you can use as the URL directly. For a custom build, compress the files from elf/ and serve them yourself:
Keep every prestate’s files published for as long as games created under it can be live. The proposer cannot defend, resolve, or claim bonds for a game whose program files it cannot load.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Optimism Documentation","colors":{"primary":"#FF0420","light":"#FF0420","dark":"#FF0420"},"logo":{"light":"https://mintcdn.com/optimism-373f39ad/Vw5vY8zA-CRjBsUF/public/logos/Lockup_docs_dark.svg?fit=max\u0026auto=format\u0026n=Vw5vY8zA-CRjBsUF\u0026q=85\u0026s=a1ab18aecbec09fe5ad40222ce76f00c","dark":"https://mintcdn.com/optimism-373f39ad/Vw5vY8zA-CRjBsUF/public/logos/Lockup_docs_light.svg?fit=max\u0026auto=format\u0026n=Vw5vY8zA-CRjBsUF\u0026q=85\u0026s=edf965cc513f1a46b1897e2a6494b43b"},"favicon":"https://mintcdn.com/optimism-373f39ad/x8TXRvd2PF-Wx1yv/public/favicon.png?fit=max\u0026auto=format\u0026n=x8TXRvd2PF-Wx1yv\u0026q=85\u0026s=7b7a602bd267ee638c0167179f41737c","navbar":{"links":[{"href":"https://www.optimism.io/blog","label":"Blog"},{"href":"https://github.com/ethereum-optimism/optimism/tree/develop/docs/public-docs","label":"GitHub"}]},"footer":{"socials":{"twitter":"https://twitter.com/optimism","github":"https://github.com/ethereum-optimism"}},"seo":{"metatags":{"canonical":"https://docs.optimism.io/","og:title":"Optimism Documentation","og:type":"website","twitter:card":"summary_large_image"}},"integrations":{"mixpanel":{"projectToken":"807e42c62989ff12427a35baa12b6218"}},"contextual":{"options":["copy","chatgpt","claude","mcp"],"display":"header"},"thumbnails":{"preset":"classic","appearance":"dark","surface":"neutral","background":"https://mintcdn.com/optimism-373f39ad/ZyL9bbNrDzMQhMLM/public/img/thumbnail-bg.png?fit=max\u0026auto=format\u0026n=ZyL9bbNrDzMQhMLM\u0026q=85\u0026s=5baf50afc7e4f4e6288de49b3df19d52","fonts":{"family":"Riforma LL","source":"public/fonts/RiformaLL-Regular.woff","format":"woff"},"eyebrow":{"source":"none"}},"interaction":{"drilldown":false},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.optimism.io"},{"anchor":"Faucet","icon":"gas-pump","href":"https://console.optimism.io/faucet"},{"anchor":"Bridge","icon":"bridge-water","href":"https://app.optimism.io/bridge/deposit"}]},"languages":[{"language":"en","href":""},{"language":"ko","href":"ko"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"optimism-373f39ad","hasAudioNarration":false,"actualSubdomain":"optimism-373f39ad","customDomains":["docs.optimism.io"],"gitSource":{"type":"github","owner":"ethereum-optimism","repo":"optimism","deployBranch":"develop","contentDirectory":"docs/public-docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00c43946c8a9cb28c98dab","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"en","tag":"Reference","count":137},{"language":"ko","tag":"참조","count":136},{"language":"en","tag":"Node Operators","count":119},{"language":"ko","tag":"노드 운영자","count":119},{"language":"en","tag":"Protocol","count":106},{"language":"ko","tag":"프로토콜","count":98},{"language":"en","tag":"Chain Operators","count":79},{"language":"ko","tag":"체인 운영자","count":75},{"language":"en","tag":"op-reth","count":74},{"language":"ko","tag":"op-reth","count":74},{"language":"en","tag":"op-reth CLI reference","count":73},{"language":"ko","tag":"op-reth CLI reference","count":73},{"language":"en","tag":"App Developers","count":68},{"language":"ko","tag":"앱 개발자","count":68},{"language":"en","tag":"Guides","count":54},{"language":"ko","tag":"가이드","count":52},{"language":"en","tag":"How the protocol works","count":48},{"language":"en","tag":"Tutorials","count":44},{"language":"ko","tag":"튜토리얼","count":42},{"language":"ko","tag":"프로토콜 작동 방식","count":41}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles/homepage.css","content":"@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Regular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Italic.woff2') format('woff2');font-weight:400;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Medium.woff2') format('woff2');font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-MediumItalic.woff2') format('woff2');font-weight:500;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Bold.woff2') format('woff2');font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-BoldItalic.woff2') format('woff2');font-weight:700;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Heavy.woff2') format('woff2');font-weight:900;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-HeavyItalic.woff2') format('woff2');font-weight:900;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Light.woff2') format('woff2');font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-LightItalic.woff2') format('woff2');font-weight:300;font-style:italic;font-display:swap}body,.nx-prose,.nx-prose p,.nx-prose h1,.nx-prose h2,.nx-prose h3,.nx-prose h4,.nx-prose h5,.nx-prose h6{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif!important}[data-page-id=\"index\"]{max-width:1400px!important;margin-left:auto!important;margin-right:auto!important;padding-left:2rem!important;padding-right:2rem!important}[data-page-id=\"index\"] h1{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif!important;font-size:3rem!important;font-weight:700!important;line-height:1.1!important;margin-bottom:1rem!important;margin-top:0!important;padding-top:0!important;color:#111827!important;letter-spacing:-0.02em!important;max-width:100%!important}html[class*=\"dark\"] [data-page-id=\"index\"] h1{color:#f9fafb!important}[data-page-id=\"index\"]>p:first-of-type,[data-page-id=\"index\"] h1+p{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif!important;font-size:1.25rem!important;line-height:1.6!important;color:#6b7280!important;margin-bottom:2rem!important;margin-top:0!important;max-width:100%!important}html[class*=\"dark\"] [data-page-id=\"index\"]>p:first-of-type,html[class*=\"dark\"] [data-page-id=\"index\"] h1+p{color:#9ca3af!important}[data-page-id=\"index\"] .nx-prose{padding-top:0!important;padding-left:0!important;padding-right:0!important;max-width:100%!important}.nx-container{max-width:none!important;padding:0!important;background:transparent!important}[data-page-id=\"index\"] .nx-prose,[data-page-id=\"index\"]>div>div{max-width:100%!important}body{background:#ffffff!important}html[class*=\"dark\"] body{background:#0f172a!important}.nx-bg-gradient-to-r,.nx-bg-gradient-to-l,.nx-bg-gradient-to-t,.nx-bg-gradient-to-b,.nx-bg-gradient-to-br,.nx-bg-gradient-to-bl,.nx-bg-gradient-to-tr,.nx-bg-gradient-to-tl{background:transparent!important}.hero-section{display:flex;align-items:center;justify-content:space-between;min-height:auto;padding:0;margin-bottom:2.5rem;max-width:100%;margin-left:0;margin-right:0;background:transparent}.hero-content{flex:1;max-width:505px}.hero-content h1{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;font-size:2.5rem;font-weight:600;line-height:1.2;margin-bottom:0.75rem;color:#111827;letter-spacing:-0.025em}html[class*=\"dark\"] .hero-content h1{color:#f9fafb}.hero-content p{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;font-size:1.125rem;font-weight:400;line-height:1.6;margin-bottom:1rem;color:#6b7280}html[class*=\"dark\"] .hero-content p{color:#9ca3af}.hero-visual{flex:1;display:flex;justify-content:center;align-items:center}.hero-visual img{max-width:100%;height:auto}.hero-buttons{display:flex;gap:1rem}.btn-primary{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;background-color:#ef4444;color:white;padding:0.75rem 1.5rem;border:none;border-radius:6px;font-weight:500;cursor:pointer;transition:background-color 0.2s;text-decoration:none;display:inline-flex;align-items:center;justify-content:center;text-align:center}.btn-primary:hover{background-color:#dc2626;color:white;text-decoration:none}.btn-secondary{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;background-color:transparent;color:#1f2937;padding:0.75rem 1.5rem;border:1px solid #d1d5db;border-radius:6px;font-weight:500;cursor:pointer;transition:all 0.2s;text-decoration:none;display:inline-flex;align-items:center;justify-content:center;text-align:center}.btn-secondary:hover{background-color:#f9fafb;border-color:#9ca3af;color:#1f2937;text-decoration:none}html[class*=\"dark\"] .btn-secondary{color:#f9fafb;border-color:#4b5563}html[class*=\"dark\"] .btn-secondary:hover{background-color:#374151;border-color:#6b7280;color:#f9fafb}@media (max-width: 768px){.hero-section{flex-direction:column;text-align:center;min-height:auto;padding:2rem 0}.hero-content{padding-right:0;margin-bottom:2rem}.hero-content h1{font-size:1.75rem}.hero-buttons{justify-content:center}}.home-cards{width:100%;margin-bottom:2.5rem;margin-top:0;max-width:100%;margin-left:0;margin-right:0;padding:0}.home-card{display:flex;flex-direction:column;padding:1.75rem;background:transparent;border:1px solid #e2e8f0;border-radius:12px;transition:all 0.2s ease}html[class*=\"dark\"] .home-card{background:#1e293b;border-color:#334155}.home-card .home-card__title{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif!important;font-size:1.5rem!important;font-weight:600!important;margin:0 0 1.5rem 0;color:#0f172a;letter-spacing:-0.01em}html[class*=\"dark\"] .home-card .home-card__title{color:#f1f5f9}.home-card__footer{margin-top:auto;padding-top:1.5rem}.home-card__footer-link{color:#64748b;text-decoration:none;font-size:0.875rem;font-weight:500;transition:color 0.2s ease}.home-card__footer-link:hover{color:#475569;text-decoration:none}html[class*=\"dark\"] .home-card__footer-link{color:#94a3b8}html[class*=\"dark\"] .home-card__footer-link:hover{color:#cbd5e1}.card-list{display:flex;flex-direction:column;gap:0}.card-list-item{display:flex;align-items:flex-start;gap:1rem;padding:0.875rem 0;border-radius:6px;text-decoration:none;color:inherit;transition:all 0.2s ease;border-bottom:1px solid #f1f5f9}.card-list-item:last-child{border-bottom:none}html[class*=\"dark\"] .card-list-item{border-bottom-color:#334155}.card-list-item:hover .card-list-item__title{color:#ef4444}.card-list-item:hover .card-list-item__description{color:#475569}html[class*=\"dark\"] .card-list-item:hover .card-list-item__description{color:#cbd5e1}.card-list-item__number{width:2rem;height:2rem;border-radius:50%;background:#f1f5f9;display:flex;align-items:center;justify-content:center;font-weight:600;font-size:0.875rem;flex-shrink:0;color:#475569}html[class*=\"dark\"] .card-list-item__number{background:#334155;color:#cbd5e1}.card-list-item__content{flex:1}.card-list-item__header{display:flex;align-items:center;gap:0.75rem;margin-bottom:0.5rem}.card-list-item__title{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;margin:0;font-size:1rem;font-weight:600;color:#0f172a;transition:color 0.2s ease;letter-spacing:-0.01em}html[class*=\"dark\"] .card-list-item__title{color:#f1f5f9}.card-list-item__description{font-family:'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;margin:0;font-size:0.875rem;color:#64748b;line-height:1.5;transition:color 0.2s ease}html[class*=\"dark\"] .card-list-item__description{color:#94a3b8}.card-list-item__badge{padding:0.25rem 0.75rem;border-radius:16px;font-size:0.75rem;font-weight:600;text-transform:capitalize}.card-list-item__badge--easy{background:#dcfce7;color:#166534}.card-list-item__badge--medium{background:#fef3c7;color:#92400e}.card-list-item__badge--hard{background:#fee2e2;color:#991b1b}html[class*=\"dark\"] .card-list-item__badge--easy{background:#14532d;color:#bbf7d0}html[class*=\"dark\"] .card-list-item__badge--medium{background:#92400e;color:#fef3c7}html[class*=\"dark\"] .card-list-item__badge--hard{background:#991b1b;color:#fecaca}.card-list-item__arrow{color:#cbd5e1;font-size:1.25rem;transition:all 0.2s ease;display:flex;align-items:center;justify-content:center;margin-top:0.25rem}.card-list-item:hover .card-list-item__arrow{transform:translateX(4px);color:#ef4444}html[class*=\"dark\"] .card-list-item__arrow{color:#64748b}html[class*=\"dark\"] .card-list-item:hover .card-list-item__arrow{color:#ef4444}.nx-prose:not([data-page-id=\"index\"] .nx-prose){max-width:1400px!important;margin-left:auto!important;margin-right:auto!important;padding-left:2rem!important;padding-right:2rem!important}@media (max-width: 768px){.hero-section{padding:4rem 2rem;flex-direction:column;text-align:center;min-height:auto}.hero-content{margin-bottom:2rem;max-width:none}.home-cards{grid-template-columns:1fr!important;padding:0 2rem}.nx-prose{padding-left:2rem!important;padding-right:2rem!important}.card-list-item__header{flex-direction:column;align-items:flex-start;gap:0.5rem}}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Regular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:block}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Regular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Italic.woff2') format('woff2');font-weight:400;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Medium.woff2') format('woff2');font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-MediumItalic.woff2') format('woff2');font-weight:500;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Bold.woff2') format('woff2');font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-BoldItalic.woff2') format('woff2');font-weight:700;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Heavy.woff2') format('woff2');font-weight:900;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-HeavyItalic.woff2') format('woff2');font-weight:900;font-style:italic;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-Light.woff2') format('woff2');font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:'Riforma LL';src:url('/fonts/RiformaLL-LightItalic.woff2') format('woff2');font-weight:300;font-style:italic;font-display:swap}img[alt*=\"logo\"],.nx-logo img,nav img,header img[src*=\"logo\"],a[href=\"/\"] img{max-height:13px!important;width:auto!important;height:13px!important}:root{--font-riforma: 'Riforma LL', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;--font-mono: 'Roboto Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace}body{font-family:var(--font-riforma)!important}html,body,.nx-prose,.nx-prose p,.nx-prose h1,.nx-prose h2,.nx-prose h3,.nx-prose h4,.nx-prose h5,.nx-prose h6,.nx-prose li,.nx-prose td,.nx-prose th,.nx-prose blockquote,div:not([class*=\"language-\"]):not(pre):not(code),span:not([class*=\"language-\"]):not([class*=\"token\"]),a:not(pre a):not(code a),button{font-family:var(--font-riforma)!important}pre,code,.nx-font-mono,.nx-bg-primary-700\\/5,.language-javascript,.language-typescript,.language-python,.language-json,.language-bash,.language-shell,.language-solidity,.language-yml,.language-yaml,.language-sh,[class*=\"language-\"],.nx-code-block,div[data-language],div[data-theme*=\"dark\"],div[data-theme*=\"light\"],span[class*=\"token\"],.token,.comment,.prolog,.doctype,.cdata,.punctuation,.property,.tag,.boolean,.number,.constant,.symbol,.deleted,.function,.class-name,.regex,.important,.variable,.operator,.keyword{font-family:var(--font-mono)!important;font-feature-settings:normal!important}pre *,code *,.nx-code-block *,div[data-language] *,[class*=\"language-\"] *,pre span,code span,.nx-code-block span,div[data-language] span,[class*=\"language-\"] span{font-family:var(--font-mono)!important;font-feature-settings:normal!important}.nx-prose h1,h1{font-family:var(--font-riforma)!important;font-weight:400!important}.nx-prose h2,h2{font-family:var(--font-riforma)!important;font-weight:400!important}.nx-prose h3,h3{font-family:var(--font-riforma)!important;font-weight:400!important}[data-page-id=\"index\"]{max-width:1400px!important;margin-left:auto!important;margin-right:auto!important;padding-left:2rem!important;padding-right:2rem!important}[data-page-id=\"index\"] h1{font-family:var(--font-riforma)!important;font-size:3rem!important;font-weight:400!important;line-height:1.1!important;margin-bottom:1rem!important;margin-top:0!important;padding-top:0!important;color:#111827!important;letter-spacing:-0.02em!important;max-width:100%!important}html[class*=\"dark\"] [data-page-id=\"index\"] h1{color:#f9fafb!important}[data-page-id=\"index\"]>p:first-of-type,[data-page-id=\"index\"] h1+p{font-family:var(--font-riforma)!important;font-size:1.25rem!important;line-height:1.6!important;color:#6b7280!important;margin-bottom:2rem!important;margin-top:0!important;max-width:100%!important}html[class*=\"dark\"] [data-page-id=\"index\"]>p:first-of-type,html[class*=\"dark\"] [data-page-id=\"index\"] h1+p{color:#9ca3af!important}[data-page-id=\"index\"] .nx-prose{padding-top:0!important;padding-left:0!important;padding-right:0!important;max-width:100%!important}.nx-container{max-width:none!important;padding:0!important;background:transparent!important}[data-page-id=\"index\"] .nx-prose,[data-page-id=\"index\"]>div>div{max-width:100%!important}body{background:#ffffff!important}html[class*=\"dark\"] body{background:#0f172a!important}.nx-bg-gradient-to-r,.nx-bg-gradient-to-l,.nx-bg-gradient-to-t,.nx-bg-gradient-to-b,.nx-bg-gradient-to-br,.nx-bg-gradient-to-bl,.nx-bg-gradient-to-tr,.nx-bg-gradient-to-tl{background:transparent!important}.hero-section{display:flex;align-items:center;justify-content:space-between;min-height:auto;padding:0;margin-bottom:2.5rem;max-width:100%;margin-left:0;margin-right:0;background:transparent}.hero-content{flex:1;max-width:505px}.hero-content h1{font-family:var(--font-riforma)!important;font-size:2.5rem;font-weight:600;line-height:1.2;margin-bottom:0.75rem;color:#111827;letter-spacing:-0.025em}html[class*=\"dark\"] .hero-content h1{color:#f9fafb}.hero-content p{font-family:var(--font-riforma)!important;font-size:1.125rem;font-weight:400;line-height:1.6;margin-bottom:1rem;color:#6b7280}html[class*=\"dark\"] .hero-content p{color:#9ca3af}.hero-visual{flex:1;display:flex;justify-content:center;align-items:center}.hero-visual img{max-width:100%;height:auto}.hero-buttons{display:flex;gap:1rem}.btn-primary{font-family:var(--font-riforma)!important;background-color:#FF0420;color:white;padding:0.75rem 1.5rem;border:none;border-radius:0.75rem;font-weight:500;cursor:pointer;transition:background-color 0.2s;text-decoration:none;display:inline-flex;align-items:center;justify-content:center;text-align:center}.btn-primary:hover{background-color:#e00320;color:white;text-decoration:none}.btn-secondary{font-family:var(--font-riforma)!important;background-color:transparent;color:#1f2937;padding:0.75rem 1.5rem;border:1px solid #d1d5db;border-radius:0.75rem;font-weight:500;cursor:pointer;transition:all 0.2s;text-decoration:none;display:inline-flex;align-items:center;justify-content:center;text-align:center}.btn-secondary:hover{background-color:#f9fafb;border-color:#9ca3af;color:#1f2937;text-decoration:none}html[class*=\"dark\"] .btn-secondary{color:#f9fafb;border-color:#4b5563}html[class*=\"dark\"] .btn-secondary:hover{background-color:#374151;border-color:#6b7280;color:#f9fafb}@media (max-width: 768px){.hero-section{flex-direction:column;text-align:center;min-height:auto;padding:2rem 0}.hero-content{padding-right:0;margin-bottom:2rem}.hero-content h1{font-size:1.75rem}.hero-buttons{justify-content:center}}.home-cards{width:100%;margin-bottom:2.5rem;margin-top:0;max-width:100%;margin-left:0;margin-right:0;padding:0}.home-card{display:flex;flex-direction:column;padding:1.75rem;background:transparent;border:1px solid #e2e8f0;border-radius:12px;transition:all 0.2s ease}html[class*=\"dark\"] .home-card{background:#1e293b;border-color:#334155}.home-card .home-card__title{font-family:var(--font-riforma)!important;font-size:1.5rem!important;font-weight:400!important;margin:0 0 1.5rem 0;color:#0f172a;letter-spacing:-0.01em}html[class*=\"dark\"] .home-card .home-card__title{color:#f1f5f9}.home-card__footer{margin-top:auto;padding-top:1.5rem}.home-card__footer-link{color:#64748b;text-decoration:none;font-size:0.875rem;font-weight:500;transition:color 0.2s ease}.home-card__footer-link:hover{color:#475569;text-decoration:none}html[class*=\"dark\"] .home-card__footer-link{color:#94a3b8}html[class*=\"dark\"] .home-card__footer-link:hover{color:#cbd5e1}.card-list{display:flex;flex-direction:column;gap:0}.card-list-item{display:flex;align-items:flex-start;gap:1rem;padding:0.875rem 0;border-radius:6px;text-decoration:none;color:inherit;transition:all 0.2s ease;border-bottom:1px solid #f1f5f9}.card-list-item:last-child{border-bottom:none}html[class*=\"dark\"] .card-list-item{border-bottom-color:#334155}.card-list-item:hover .card-list-item__title{color:#ef4444}.card-list-item:hover .card-list-item__description{color:#475569}html[class*=\"dark\"] .card-list-item:hover .card-list-item__description{color:#cbd5e1}.card-list-item__number{width:2rem;height:2rem;border-radius:50%;background:#f1f5f9;display:flex;align-items:center;justify-content:center;font-weight:600;font-size:0.875rem;flex-shrink:0;color:#475569}html[class*=\"dark\"] .card-list-item__number{background:#334155;color:#cbd5e1}.card-list-item__content{flex:1}.card-list-item__header{display:flex;align-items:center;gap:0.75rem;margin-bottom:0.5rem}.card-list-item__title{font-family:var(--font-riforma)!important;margin:0;font-size:1rem;font-weight:400;color:#0f172a;transition:color 0.2s ease;letter-spacing:-0.01em}html[class*=\"dark\"] .card-list-item__title{color:#f1f5f9}.card-list-item__description{font-family:var(--font-riforma)!important;margin:0;font-size:0.875rem;color:#64748b;line-height:1.5;transition:color 0.2s ease}html[class*=\"dark\"] .card-list-item__description{color:#94a3b8}.card-list-item__badge{padding:0.25rem 0.75rem;border-radius:16px;font-size:0.75rem;font-weight:600;text-transform:capitalize}.card-list-item__badge--easy{background:#dcfce7;color:#166534}.card-list-item__badge--medium{background:#fef3c7;color:#92400e}.card-list-item__badge--hard{background:#fee2e2;color:#991b1b}html[class*=\"dark\"] .card-list-item__badge--easy{background:#14532d;color:#bbf7d0}html[class*=\"dark\"] .card-list-item__badge--medium{background:#92400e;color:#fef3c7}html[class*=\"dark\"] .card-list-item__badge--hard{background:#991b1b;color:#fecaca}.card-list-item__arrow{color:#cbd5e1;font-size:1.25rem;transition:all 0.2s ease;display:flex;align-items:center;justify-content:center;margin-top:0.25rem}.card-list-item:hover .card-list-item__arrow{transform:translateX(4px);color:#ef4444}html[class*=\"dark\"] .card-list-item__arrow{color:#64748b}html[class*=\"dark\"] .card-list-item:hover .card-list-item__arrow{color:#ef4444}.nx-prose:not([data-page-id=\"index\"] .nx-prose){max-width:1400px!important;margin-left:auto!important;margin-right:auto!important;padding-left:2rem!important;padding-right:2rem!important}@media (max-width: 768px){.hero-section{padding:4rem 2rem;flex-direction:column;text-align:center;min-height:auto}.hero-content{margin-bottom:2rem;max-width:none}.home-cards{grid-template-columns:1fr!important;padding:0 2rem}.nx-prose{padding-left:2rem!important;padding-right:2rem!important}.card-list-item__header{flex-direction:column;align-items:flex-start;gap:0.5rem}}.nx-card img,[class*=\"card\"] img[src*=\"/public/img/\"]{background:transparent!important}"},{"filePath":"styles/op-enterprise.css","content":".op-ent-marker{display:flex;flex-wrap:wrap;align-items:center;gap:0.5rem;margin:0.25rem 0 1rem}.op-ent-badge::before{content:\"\";display:inline-block;width:6px;height:6px;margin-right:6px;background:#FF0420;vertical-align:middle}html[class*=\"dark\"] .op-ent-badge{color:rgb(231 229 228)!important}"}]}
{"page":{"pagePath":"chain-operators/tutorials/zk-prestate","slug":"/chain-operators/tutorials/zk-prestate","pageMetadata":{"title":"Verifying a ZK absolute prestate","description":"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.","diataxis":"how-to","href":"/chain-operators/tutorials/zk-prestate"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsx(_components.p,{children:`ZK proofs are experimental and under active development. Do not rely on them to secure a production chain yet.`})}),`\n`,_jsxs(_components.p,{children:[`A ZK dispute game accepts proofs only from the program its `,_jsx(_components.code,{children:`absolutePrestate`}),` identifies: the verification key of the `,_jsx(_components.code,{children:`super-aggregation`}),` program, which in turn pins the `,_jsx(_components.code,{children:`super-range`}),` and `,_jsx(_components.code,{children:`log-commitment`}),` programs. See `,_jsx(_components.a,{href:`/op-stack/zk-proofs/proof-system#absolute-prestate`,children:`Absolute prestate`}),` for why.`]}),`\n`,_jsxs(_components.p,{children:[`This guide shows how to find the prestate for a release, confirm it by rebuilding the programs yourself, build a prestate for a chain that is not in the superchain-registry, and serve the program files that `,_jsx(_components.a,{href:`/chain-operators/guides/configuration/zk-proposer`,children:_jsx(_components.code,{children:`op-zk-proposer`})}),` needs.`]}),`\n`,_jsx(Heading,{level:`2`,id:`find-the-standard-prestate`,children:`Find the standard prestate`}),`\n`,_jsxs(_components.p,{children:[`The ZK proof programs are released under the `,_jsx(_components.code,{children:`kona-sp1-program/vX.Y.Z`}),` tags in the Optimism monorepo. Each standard release’s prestate is recorded in the superchain-registry’s `,_jsx(_components.a,{href:`https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-prestates.toml`,children:_jsx(_components.code,{children:`standard-prestates.toml`})}),`, as an entry of type `,_jsx(_components.code,{children:`kona-sp1`}),` under the release’s version.`]}),`\n`,_jsx(_components.p,{children:`A standard prestate covers every chain whose configuration is in the superchain-registry at that release. Use it if your chain is in the registry.`}),`\n`,_jsx(Heading,{level:`2`,id:`rebuild-the-prestate-from-source`,children:`Rebuild the prestate from source`}),`\n`,_jsxs(_components.p,{children:[`The programs build reproducibly in Docker, so you can confirm a prestate without trusting the published value. You need a Linux amd64 machine with Docker and `,_jsx(_components.a,{href:`https://mise.jdx.dev/`,children:`mise`}),`.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Check out the release tag:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` clone`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://github.com/ethereum-optimism/optimism.git`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`cd`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` optimism`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` checkout`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` kona-sp1-program/v`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`versio`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mise`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` trust`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026 `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mise`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Build the programs:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`cd`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rust/kona/sp1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`just`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` build-elfs`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`This builds `,_jsx(_components.code,{children:`log-commitment`}),`, then `,_jsx(_components.code,{children:`super-range`}),` with the `,_jsx(_components.code,{children:`log-commitment`}),` key embedded, then `,_jsx(_components.code,{children:`super-aggregation`}),` with the `,_jsx(_components.code,{children:`super-range`}),` key embedded. It writes the binaries to `,_jsx(_components.code,{children:`elf/`}),` and their verification keys to `,_jsx(_components.code,{children:`elf/vkeys.toml`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Read the keys:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cat`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` elf/vkeys.toml`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`toml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`toml`,children:_jsxs(_components.code,{language:`toml`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`sp1_toolchain_tag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cSP1 toolchain version>\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`git_sha`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003ccommit>\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`log-commitment`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x...\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`super-range`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x...\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`super-aggregation`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x...\"`})]}),`\n`]})})}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`super-aggregation`}),` value is the prestate. Confirm that it matches the registry entry, and that `,_jsx(_components.code,{children:`git_sha`}),` is the tagged commit with no `,_jsx(_components.code,{children:`-dirty`}),` or `,_jsx(_components.code,{children:`-custom`}),` suffix.`]}),`\n`,_jsx(_components.p,{children:`Every build embeds the commit it was built from, so you must build from the exact tagged commit. A build of the same code from any other commit produces a different prestate.`}),`\n`,_jsx(Heading,{level:`2`,id:`build-a-prestate-for-a-custom-chain`,children:`Build a prestate for a custom chain`}),`\n`,_jsx(_components.p,{children:`The programs only accept chains whose configuration is compiled into them. If your chain is not in the superchain-registry, build the programs with your chain’s configuration:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`cd`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rust/kona/sp1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`KONA_CUSTOM_CONFIGS_DIR`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/path/to/configs`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` just`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` build-elfs`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The directory must contain `,_jsx(_components.code,{children:`chainList.json`}),`, `,_jsx(_components.code,{children:`configs.json`}),`, and `,_jsx(_components.code,{children:`depsets.json`}),` in the superchain-registry’s format. The L1 must be Ethereum mainnet, Sepolia, or Holesky.`]}),`\n`,_jsxs(_components.p,{children:[`The resulting prestate is specific to your configuration and the commit you built from, and the manifest’s `,_jsx(_components.code,{children:`git_sha`}),` ends in `,_jsx(_components.code,{children:`-custom`}),`. Anyone who wants to verify your chain’s prestate needs your configuration files and the commit, so publish both.`]}),`\n`,_jsx(Heading,{level:`2`,id:`publish-the-program-files`,children:`Publish the program files`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`op-zk-proposer`}),` loads each prestate’s programs from `,_jsx(_components.code,{children:`OP_ZK_PROPOSER_PRESTATES_URL`}),`, by verification key. The directory at that URL must serve, for every prestate in use:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`File`}),_jsx(_components.th,{children:`Contents`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003cvkey>.agg.bin.gz`})}),_jsxs(_components.td,{children:[`gzip-compressed `,_jsx(_components.code,{children:`super-aggregation`}),` binary`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003cvkey>.range.bin.gz`})}),_jsxs(_components.td,{children:[`gzip-compressed `,_jsx(_components.code,{children:`super-range`}),` binary`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003cvkey>.log.bin.gz`})}),_jsxs(_components.td,{children:[`gzip-compressed `,_jsx(_components.code,{children:`log-commitment`}),` binary`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\u003cvkey>`}),` is the lowercase, `,_jsx(_components.code,{children:`0x`}),`-prefixed `,_jsx(_components.code,{children:`super-aggregation`}),` key.`]}),`\n`,_jsxs(_components.p,{children:[`For standard releases, these files are published for every tag under `,_jsx(_components.code,{children:`https://storage.googleapis.com/oplabs-network-data/proofs/kona/sp1/`}),`, which you can use as the URL directly. For a custom build, compress the files from `,_jsx(_components.code,{children:`elf/`}),` and serve them yourself:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`VKEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`grep`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '^super-aggregation'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` elf/vkeys.toml`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` grep`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -oE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '0x[0-9a-fA-F]{64}'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` tr`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'A-F'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'a-f'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gzip`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` elf/super-aggregation-elf`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$VKEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`.agg.bin.gz\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gzip`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` elf/super-range-elf`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$VKEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`.range.bin.gz\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gzip`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` elf/log-commitment-elf`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$VKEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`.log.bin.gz\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Keep every prestate’s files published for as long as games created under it can be live. The proposer cannot defend, resolve, or claim bonds for a game whose program files it cannot load.`}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Set the prestate on your chain: `,_jsx(_components.a,{href:`/chain-operators/tutorials/migrate-to-zk-proofs`,children:`Migrating to ZK proofs`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Point the proposer at the files: `,_jsx(_components.a,{href:`/chain-operators/guides/configuration/zk-proposer`,children:`Configure op-zk-proposer`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Verifying a ZK absolute prestate","description":"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.","diataxis":"how-to","href":"/chain-operators/tutorials/zk-prestate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Find the standard prestate","slug":"find-the-standard-prestate","depth":2,"children":[]},{"title":"Rebuild the prestate from source","slug":"rebuild-the-prestate-from-source","depth":2,"children":[]},{"title":"Build a prestate for a custom chain","slug":"build-a-prestate-for-a-custom-chain","depth":2,"children":[]},{"title":"Publish the program files","slug":"publish-the-program-files","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/optimism-373f39ad/6b11b6c32a46a09b/public/mixpanel-custom.js"],"subdomain":"optimism-373f39ad","siteName":"Optimism Documentation","title":"Optimism Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/chain-operators/tutorials/zk-prestate","matchLevel":0},"ko":{"href":"/ko","matchLevel":4}}},"lastModified":"2026-11-20T22:06:02.755Z","originalFileLocation":"chain-operators/tutorials/zk-prestate.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Optimism Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Optimism Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Optimism Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://optimism-373f39ad.mintlify.site/_mintlify/api/og/v2?title=Verifying+a+ZK+absolute+prestate\u0026amp;description=Find+the+ZK+absolute+prestate+for+a+kona-sp1-program+release%2C+rebuild+it+from+source+to+verify+it%2C+build+one+for+a+custom+chain%2C+and+publish+the+program+files+t\u0026amp;theme=79e08bb9e92ccc1aa11b69ac\u0026amp;signature=57f1279d089d0608968cffc97eed1f05b96fbd22a2cc22e8ae7bb4125f3dd4c0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Optimism Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://optimism-373f39ad.mintlify.site/_mintlify/api/og/v2?title=Verifying+a+ZK+absolute+prestate\u0026amp;description=Find+the+ZK+absolute+prestate+for+a+kona-sp1-program+release%2C+rebuild+it+from+source+to+verify+it%2C+build+one+for+a+custom+chain%2C+and+publish+the+program+files+t\u0026amp;theme=79e08bb9e92ccc1aa11b69ac\u0026amp;signature=57f1279d089d0608968cffc97eed1f05b96fbd22a2cc22e8ae7bb4125f3dd4c0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/optimism-373f39ad/v3BpzhmZ-un_k_ZG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Optimism Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF0420\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/chain-operators/tutorials/zk-prestate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.optimism.io/#organization\",\"name\":\"Optimism Documentation\",\"url\":\"https://docs.optimism.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/optimism-373f39ad/Vw5vY8zA-CRjBsUF/public/logos/Lockup_docs_dark.svg?fit=max\u0026auto=format\u0026n=Vw5vY8zA-CRjBsUF\u0026q=85\u0026s=a1ab18aecbec09fe5ad40222ce76f00c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.optimism.io#website\",\"name\":\"Optimism Documentation\",\"url\":\"https://docs.optimism.io\",\"publisher\":{\"@id\":\"https://docs.optimism.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate#webpage\",\"url\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate\",\"name\":\"Verifying a ZK absolute prestate\",\"description\":\"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.\",\"dateModified\":\"2026-11-20T22:06:02.755Z\",\"isPartOf\":{\"@id\":\"https://docs.optimism.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tutorials\",\"item\":\"https://docs.optimism.io/chain-operators/tutorials/create-l2-rollup\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Proofs \u0026 disputes\",\"item\":\"https://docs.optimism.io/chain-operators/tutorials/absolute-prestate\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Verifying a ZK absolute prestate\",\"item\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate#article\",\"headline\":\"Verifying a ZK absolute prestate\",\"name\":\"Verifying a ZK absolute prestate\",\"description\":\"Find the ZK absolute prestate for a kona-sp1-program release, rebuild it from source to verify it, build one for a custom chain, and publish the program files the proposer needs.\",\"url\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.optimism.io//chain-operators/tutorials/zk-prestate#webpage\"},\"dateModified\":\"2026-11-20T22:06:02.755Z\",\"publisher\":{\"@id\":\"https://docs.optimism.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.optimism.io#website\"}}]}\u003c/script>","agentPointerHref":"/chain-operators/tutorials/zk-prestate.md","siteName":"Optimism Documentation","nav":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.optimism.io"},{"anchor":"Faucet","icon":"gas-pump","href":"https://console.optimism.io/faucet"},{"anchor":"Bridge","icon":"bridge-water","href":"https://app.optimism.io/bridge/deposit"}]},"languages":[{"language":"en","tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Chain Operators","groups":[{"group":"Launch a chain","pages":[{"title":"Chain operators","sidebarTitle":"Overview","href":"/chain-operators"}]},{"group":"Guides","pages":[{"group":"Configuration","pages":[{"title":"Chain Operator Configurations","href":"/chain-operators/guides/configuration/getting-started"},{"title":"Configure the batcher","href":"/chain-operators/guides/configuration/batcher"},{"title":"Proposer Configuration","href":"/chain-operators/guides/configuration/proposer"},{"title":"How to configure challenger for your chain","href":"/chain-operators/guides/configuration/op-challenger-config-guide"},{"title":"Configure op-zk-proposer","href":"/chain-operators/guides/configuration/zk-proposer"},{"title":"Configure op-challenger for ZK dispute games","href":"/chain-operators/guides/configuration/zk-challenger"}]},{"group":"Features","pages":[{"title":"Deploy a Custom Gas Token chain","href":"/chain-operators/guides/features/custom-gas-token-guide"},{"title":"Switch to Kona Proofs","href":"/chain-operators/guides/features/switching-to-kona-proofs"},{"title":"Set the Minimum Base Fee","href":"/chain-operators/guides/features/setting-min-base-fee"},{"title":"Set the Operator Fee","href":"/chain-operators/guides/features/setting-operator-fee"},{"title":"Set the DA Footprint Gas Scalar","href":"/chain-operators/guides/features/setting-da-footprint"},{"title":"Enabling Subblocks","href":"/chain-operators/guides/features/subblocks-guide"},{"title":"Enabling Sequencer Defined Metering","href":"/chain-operators/guides/features/sequencer-defined-metering"},{"title":"How to run an Alt-DA mode chain","href":"/chain-operators/guides/features/alt-da-mode-guide"},{"title":"Post batch data as blobs","href":"/chain-operators/guides/features/blobs"},{"title":"Enable span batches","href":"/chain-operators/guides/features/enable-span-batches"},{"title":"Using snap sync for chain operators","href":"/chain-operators/guides/features/snap-sync"}]},{"group":"Management","pages":[{"title":"Chain operator best practices","href":"/chain-operators/guides/management/best-practices"},{"title":"Network Design Example","href":"/chain-operators/guides/management/network-architecture"},{"title":"Changing gas target/limit","href":"/chain-operators/guides/management/gas-target-limit"},{"title":"Key management","href":"/chain-operators/guides/management/key-management"},{"title":"Rollup operations","href":"/chain-operators/guides/management/operations"},{"title":"Transaction Fees 101","href":"/chain-operators/guides/management/transaction-fees-101"},{"title":"Fee vault operations","href":"/chain-operators/guides/management/fee-vaults"},{"title":"Troubleshooting chain operations","href":"/chain-operators/guides/management/troubleshooting"}]},{"title":"Join the Superchain Registry","href":"/chain-operators/guides/join-superchain-registry"}]},{"group":"Tutorials","pages":[{"group":"Create L2 Rollup","pages":[{"title":"Creating your own L2 rollup testnet","href":"/chain-operators/tutorials/create-l2-rollup/index"},{"title":"Deploy L1 contracts with op-deployer","href":"/chain-operators/tutorials/create-l2-rollup/op-deployer-setup"},{"title":"Spin up sequencer","href":"/chain-operators/tutorials/create-l2-rollup/op-reth-setup"},{"title":"Spin up batcher","href":"/chain-operators/tutorials/create-l2-rollup/op-batcher-setup"},{"title":"Spin up proposer","href":"/chain-operators/tutorials/create-l2-rollup/op-proposer-setup"},{"title":"Spin up challenger","href":"/chain-operators/tutorials/create-l2-rollup/op-challenger-setup"},{"title":"L2 Rollup Code Examples","href":"/chain-operators/tutorials/create-l2-rollup/code-setup"}]},{"group":"L1 contract upgrades","pages":[{"title":"Upgrade L1 contracts using op-deployer","href":"/chain-operators/tutorials/l1-contract-upgrades/op-deployer-upgrade"},{"title":"Upgrade using superchain-ops","href":"/chain-operators/tutorials/l1-contract-upgrades/superchain-ops-guide"},{"title":"Upgrading Smart Contracts from v1.3.0 to v1.8.0","href":"/chain-operators/tutorials/l1-contract-upgrades/upgrade-op-contracts-1-3-1-8"}]},{"group":"Customize your chain","pages":[{"title":"Adding a precompile","href":"/chain-operators/tutorials/adding-precompiles"},{"title":"Modifying predeployed contracts","href":"/chain-operators/tutorials/modifying-predeploys"},{"title":"Adding attributes to the derivation function","href":"/chain-operators/tutorials/adding-derivation-attributes"},{"title":"Integrating a new DA layer with Alt-DA","href":"/chain-operators/tutorials/integrating-da-layer"}]},{"group":"Proofs \u0026 disputes","pages":[{"title":"Generating absolute prestate and preimage files","href":"/chain-operators/tutorials/absolute-prestate"},{"title":"Generating a custom kona-client absolute prestate","href":"/chain-operators/tutorials/kona-custom-prestate"},{"title":"Deploying new dispute games with OPCM","href":"/chain-operators/tutorials/dispute-games"},{"title":"Migrating to permissionless fault proofs on OP Stack","href":"/chain-operators/tutorials/migrating-permissionless"},{"title":"Merging Two Chains Into a Shared Dispute Game","description":"Merge two pre-interop OP Stack chains into a shared DisputeGameFactory and AnchorStateRegistry with opcm.migrate, then cut over op-proposer, op-challenger, and op-dispute-mon to the shared factory.","href":"/chain-operators/tutorials/merge-shared-dispute-game"},{"title":"Verifying a ZK absolute prestate","href":"/chain-operators/tutorials/zk-prestate"},{"title":"Migrating to ZK proofs","description":"Switch an OP Stack chain from its current super-root dispute game to the ZK dispute game with a single opcm.upgrade call, then cut proposals over to op-zk-proposer.","href":"/chain-operators/tutorials/migrate-to-zk-proofs"}]},{"group":"Operations","pages":[{"title":"How to rewind op-geth","href":"/chain-operators/tutorials/rewind-op-geth"},{"title":"Upgrading a Chain From Output Roots to Super Roots","href":"/chain-operators/tutorials/upgrade-chain-to-super-roots"}]}]},{"group":"Tools","pages":[{"title":"Chain monitoring options","href":"/chain-operators/tools/chain-monitoring"},{"title":"Blockscout block explorer","href":"/chain-operators/tools/explorer"},{"group":"OP Conductor","pages":[{"title":"OP Conductor","href":"/chain-operators/tools/op-conductor"},{"title":"Setup","href":"/chain-operators/tools/op-conductor/setup"},{"title":"Configuration and RPCs","href":"/chain-operators/tools/op-conductor/reference"}]},{"group":"OP Deployer","pages":[{"title":"OP Deployer","href":"/chain-operators/tools/op-deployer/overview"},{"title":"Install op-deployer","href":"/chain-operators/tools/op-deployer/installation"},{"group":"Usage","pages":[{"title":"Bootstrap Commands","href":"/chain-operators/tools/op-deployer/usage/bootstrap"},{"title":"Init Command","href":"/chain-operators/tools/op-deployer/usage/init"},{"title":"Apply Command","href":"/chain-operators/tools/op-deployer/usage/apply"},{"title":"Verify Command","href":"/chain-operators/tools/op-deployer/usage/verify"},{"title":"Custom Deployments","href":"/chain-operators/tools/op-deployer/usage/custom-deployments"},{"title":"Release Workflows","href":"/chain-operators/tools/op-deployer/usage/release-workflows"}]},{"title":"Known Limitations","href":"/chain-operators/tools/op-deployer/known-limitations"},{"group":"Reference","pages":[{"group":"Architecture","pages":[{"title":"Architecture","href":"/chain-operators/tools/op-deployer/reference/architecture/overview"},{"title":"Deployment Pipeline","href":"/chain-operators/tools/op-deployer/reference/architecture/pipeline"},{"title":"Scripting Engine","href":"/chain-operators/tools/op-deployer/reference/architecture/engine"}]},{"title":"Artifacts Locators","href":"/chain-operators/tools/op-deployer/reference/artifacts-locators"},{"title":"op-deployer versioning and releases","href":"/chain-operators/tools/op-deployer/reference/releases"}]}]},{"title":"OP Interop Filter","href":"/chain-operators/tools/op-interop-filter"},{"title":"OP Txproxy","href":"/chain-operators/tools/op-txproxy"},{"title":"Run proxyd","href":"/chain-operators/tools/proxyd"}]},{"group":"Reference","pages":[{"title":"Batcher configuration reference","href":"/chain-operators/reference/batcher-configuration"},{"title":"Challenger configuration reference","href":"/chain-operators/reference/challenger-configuration"},{"title":"OP Contracts Manager","href":"/chain-operators/reference/opcm"},{"title":"Rollup deployment configuration","href":"/chain-operators/reference/rollup-deployment-configuration"},{"title":"Fee parameters","href":"/chain-operators/reference/fee-parameters"},{"title":"How the DA footprint block limit works","href":"/chain-operators/reference/da-footprint"}]},{"group":"Archive","pages":[{"title":"Generating an op-program absolute prestate (archived)","href":"/chain-operators/tutorials/archive/op-program-prestate"}]}]},{"tab":"Node Operators","pages":[{"title":"Node Operators","href":"/node-operators/overview"}]},{"tab":"App Developers","pages":[{"title":"App Developers","href":"/app-developers"}]},{"tab":"Protocol","pages":[{"title":"Protocol","href":"/op-stack/introduction/op-stack"}]},{"tab":"OP Mainnet","pages":[{"title":"OP Mainnet","href":"/op-mainnet"}]},{"tab":"Governance","pages":[{"title":"Governance","href":"/governance/protocol-upgrades"}]},{"tab":"Notices","pages":[{"title":"Notices","href":"/notices"}]}]},{"language":"ko","pages":[{"title":"ko","href":"/ko"}]}]},"basePath":"","title":"Optimism Documentation","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}