diff --git a/bindings/java-bindings/.gitignore b/bindings/java-bindings/.gitignore
new file mode 100644
index 000000000..b63da4551
--- /dev/null
+++ b/bindings/java-bindings/.gitignore
@@ -0,0 +1,42 @@
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### IntelliJ IDEA ###
+.idea/modules.xml
+.idea/jarRepositories.xml
+.idea/compiler.xml
+.idea/libraries/
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### Eclipse ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/
+
+### Mac OS ###
+.DS_Store
\ No newline at end of file
diff --git a/bindings/java-bindings/build.gradle b/bindings/java-bindings/build.gradle
new file mode 100644
index 000000000..ed41e9463
--- /dev/null
+++ b/bindings/java-bindings/build.gradle
@@ -0,0 +1,27 @@
+plugins {
+ id 'java'
+}
+
+group = 'me.grapebaba'
+version = '1.0-SNAPSHOT'
+
+repositories {
+ mavenCentral()
+}
+
+java {
+ toolchain {
+ languageVersion.set(JavaLanguageVersion.of(21))
+ }
+}
+
+dependencies {
+ testImplementation platform(testLibs.junit.bom)
+ testImplementation testLibs.bundles.junit
+}
+
+test {
+ useJUnitPlatform()
+}
+
+
diff --git a/bindings/java-bindings/gradle/wrapper/gradle-wrapper.jar b/bindings/java-bindings/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 000000000..249e5832f
Binary files /dev/null and b/bindings/java-bindings/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/bindings/java-bindings/gradle/wrapper/gradle-wrapper.properties b/bindings/java-bindings/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 000000000..cf731511e
--- /dev/null
+++ b/bindings/java-bindings/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,6 @@
+#Sat Jun 22 13:53:47 CST 2024
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/bindings/java-bindings/gradlew b/bindings/java-bindings/gradlew
new file mode 100755
index 000000000..1b6c78733
--- /dev/null
+++ b/bindings/java-bindings/gradlew
@@ -0,0 +1,234 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+#
+# Gradle start up script for POSIX generated by Gradle.
+#
+# Important for running:
+#
+# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+# noncompliant, but you have some other compliant shell such as ksh or
+# bash, then to run this script, type that shell name before the whole
+# command line, like:
+#
+# ksh Gradle
+#
+# Busybox and similar reduced shells will NOT work, because this script
+# requires all of these POSIX shell features:
+# * functions;
+# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+# * compound commands having a testable exit status, especially «case»;
+# * various built-in commands including «command», «set», and «ulimit».
+#
+# Important for patching:
+#
+# (2) This script targets any POSIX shell, so it avoids extensions provided
+# by Bash, Ksh, etc; in particular arrays are avoided.
+#
+# The "traditional" practice of packing multiple parameters into a
+# space-separated string is a well documented source of bugs and security
+# problems, so this is (mostly) avoided, by progressively accumulating
+# options in "$@", and eventually passing that to Java.
+#
+# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+# see the in-line comments for details.
+#
+# There are tweaks for specific operating systems such as AIX, CygWin,
+# Darwin, MinGW, and NonStop.
+#
+# (3) This script is generated from the Groovy template
+# https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+# within the Gradle project.
+#
+# You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+ APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
+ [ -h "$app_path" ]
+do
+ ls=$( ls -ld "$app_path" )
+ link=${ls#*' -> '}
+ case $link in #(
+ /*) app_path=$link ;; #(
+ *) app_path=$APP_HOME$link ;;
+ esac
+done
+
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
+
+APP_NAME="Gradle"
+APP_BASE_NAME=${0##*/}
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+ echo "$*"
+} >&2
+
+die () {
+ echo
+ echo "$*"
+ echo
+ exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in #(
+ CYGWIN* ) cygwin=true ;; #(
+ Darwin* ) darwin=true ;; #(
+ MSYS* | MINGW* ) msys=true ;; #(
+ NONSTOP* ) nonstop=true ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD=$JAVA_HOME/jre/sh/java
+ else
+ JAVACMD=$JAVA_HOME/bin/java
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD=java
+ which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+ case $MAX_FD in #(
+ max*)
+ MAX_FD=$( ulimit -H -n ) ||
+ warn "Could not query maximum file descriptor limit"
+ esac
+ case $MAX_FD in #(
+ '' | soft) :;; #(
+ *)
+ ulimit -n "$MAX_FD" ||
+ warn "Could not set maximum file descriptor limit to $MAX_FD"
+ esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+# * args from the command line
+# * the main class name
+# * -classpath
+# * -D...appname settings
+# * --module-path (only if needed)
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+ APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+ CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+ JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ for arg do
+ if
+ case $arg in #(
+ -*) false ;; # don't mess with options #(
+ /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
+ [ -e "$t" ] ;; #(
+ *) false ;;
+ esac
+ then
+ arg=$( cygpath --path --ignore --mixed "$arg" )
+ fi
+ # Roll the args list around exactly as many times as the number of
+ # args, so each arg winds up back in the position where it started, but
+ # possibly modified.
+ #
+ # NB: a `for` loop captures its iteration list before it begins, so
+ # changing the positional parameters here affects neither the number of
+ # iterations, nor the values presented in `arg`.
+ shift # remove old arg
+ set -- "$@" "$arg" # push replacement arg
+ done
+fi
+
+# Collect all arguments for the java command;
+# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
+# shell script including quotes and variable substitutions, so put them in
+# double quotes to make sure that they get re-expanded; and
+# * put everything else in single quotes, so that it's not re-expanded.
+
+set -- \
+ "-Dorg.gradle.appname=$APP_BASE_NAME" \
+ -classpath "$CLASSPATH" \
+ org.gradle.wrapper.GradleWrapperMain \
+ "$@"
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+# set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+ printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+ xargs -n1 |
+ sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+ tr '\n' ' '
+ )" '"$@"'
+
+exec "$JAVACMD" "$@"
diff --git a/bindings/java-bindings/gradlew.bat b/bindings/java-bindings/gradlew.bat
new file mode 100644
index 000000000..ac1b06f93
--- /dev/null
+++ b/bindings/java-bindings/gradlew.bat
@@ -0,0 +1,89 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/bindings/java-bindings/settings.gradle b/bindings/java-bindings/settings.gradle
new file mode 100644
index 000000000..fcf49f28b
--- /dev/null
+++ b/bindings/java-bindings/settings.gradle
@@ -0,0 +1,34 @@
+rootProject.name = 'superchain-bindings'
+include 'superchain-registry'
+include 'superchain-primitives'
+
+dependencyResolutionManagement {
+ versionCatalogs {
+ libs{
+ version('besu', '24.6.0')
+ version('jackson', '2.17.1')
+ version('tuweni', '2.4.2')
+ version('guava', '33.2.1-jre')
+ version('vertx', '4.5.8')
+
+ library('besu-datatypes', 'org.hyperledger.besu', 'besu-datatypes').versionRef('besu')
+ library('jackson-datatype-jdk8', 'com.fasterxml.jackson.datatype', 'jackson-datatype-jdk8').versionRef('jackson')
+ library('jackson-dataformat-yaml', 'com.fasterxml.jackson.dataformat', 'jackson-dataformat-yaml').versionRef('jackson')
+ library('jackson-dataformat-toml', 'com.fasterxml.jackson.dataformat', 'jackson-dataformat-toml').versionRef('jackson')
+ library('tuweni-bytes', 'io.tmio', 'tuweni-bytes').versionRef('tuweni')
+ library('guava', 'com.google.guava', 'guava').versionRef('guava')
+ library('vertx-core', 'io.vertx', 'vertx-core').versionRef('vertx')
+
+ bundle('jackson', ['jackson-datatype-jdk8', 'jackson-dataformat-yaml', 'jackson-dataformat-toml'])
+ }
+
+ testLibs {
+ def junit5 = version('junit5', '5.10.0')
+ library('junit-bom', 'org.junit', 'junit-bom').versionRef(junit5)
+ library('junit-api', 'org.junit.jupiter', 'junit-jupiter-api').versionRef(junit5)
+ library('junit-engine', 'org.junit.jupiter', 'junit-jupiter-engine').versionRef(junit5)
+
+ bundle('junit', ['junit-api', 'junit-engine'])
+ }
+ }
+}
diff --git a/bindings/java-bindings/superchain-primitives/build.gradle b/bindings/java-bindings/superchain-primitives/build.gradle
new file mode 100644
index 000000000..6516c91a6
--- /dev/null
+++ b/bindings/java-bindings/superchain-primitives/build.gradle
@@ -0,0 +1,35 @@
+plugins {
+ id 'java'
+}
+
+group = 'me.grapebaba'
+version = '1.0-SNAPSHOT'
+
+repositories {
+ mavenCentral()
+
+ maven {
+ url "https://hyperledger.jfrog.io/artifactory/besu-maven/"
+ }
+
+}
+
+java {
+ toolchain {
+ languageVersion.set(JavaLanguageVersion.of(21))
+ }
+}
+
+dependencies {
+ implementation libs.besu.datatypes
+ implementation libs.bundles.jackson
+ implementation libs.tuweni.bytes
+ testImplementation platform(testLibs.junit.bom)
+ testImplementation testLibs.bundles.junit
+ implementation 'io.vertx:vertx-core:4.5.8'
+
+}
+
+test {
+ useJUnitPlatform()
+}
diff --git a/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/AddressList.java b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/AddressList.java
new file mode 100644
index 000000000..cc85c181b
--- /dev/null
+++ b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/AddressList.java
@@ -0,0 +1,256 @@
+package io.optimism.superchain;
+
+
+import org.hyperledger.besu.datatypes.Address;
+
+import java.util.Objects;
+import java.util.Optional;
+
+/**
+ * AddressList is a POJO that represents the addresses of the contracts that are deployed on the
+ * Superchain. This class is used to deserialize the JSON file that contains the addresses of the
+ * contracts.
+ *
+ * @author grapebaba
+ * @since 0.1.0
+ */
+public class AddressList {
+ private Address addressManager;
+
+ private Address l1CrossDomainMessengerProxy;
+
+ private Address l1ERC721BridgeProxy;
+
+ private Address l1StandardBridgeProxy;
+
+ private Optional
l2OutputOracleProxy= Optional.empty();
+
+ private Address optimismMintableERC20FactoryProxy;
+
+ private Address optimismPortalProxy;
+
+ private Address systemConfigProxy;
+
+ private Address systemConfigOwner;
+
+ private Address proxyAdmin;
+
+ private Address proxyAdminOwner;
+
+ private Address guardian;
+
+ private Optional challenger= Optional.empty();
+
+ // Fault Proof Contract Addresses
+ private Optional anchorStateRegistryProxy = Optional.empty();
+
+ private Optional delayedWETHProxy = Optional.empty();
+
+ private Optional disputeGameFactoryProxy = Optional.empty();
+
+ private Optional faultDisputeGame = Optional.empty();
+
+ private Optional mips = Optional.empty();
+
+ private Optional permissionedDisputeGame = Optional.empty();
+
+ private Optional preimageOracle = Optional.empty();
+
+ public Address getAddressManager() {
+ return addressManager;
+ }
+
+ public void setAddressManager(Address addressManager) {
+ this.addressManager = addressManager;
+ }
+
+ public Address getL1CrossDomainMessengerProxy() {
+ return l1CrossDomainMessengerProxy;
+ }
+
+ public void setL1CrossDomainMessengerProxy(Address l1CrossDomainMessengerProxy) {
+ this.l1CrossDomainMessengerProxy = l1CrossDomainMessengerProxy;
+ }
+
+ public Address getL1ERC721BridgeProxy() {
+ return l1ERC721BridgeProxy;
+ }
+
+ public void setL1ERC721BridgeProxy(Address l1ERC721BridgeProxy) {
+ this.l1ERC721BridgeProxy = l1ERC721BridgeProxy;
+ }
+
+ public Address getL1StandardBridgeProxy() {
+ return l1StandardBridgeProxy;
+ }
+
+ public void setL1StandardBridgeProxy(Address l1StandardBridgeProxy) {
+ this.l1StandardBridgeProxy = l1StandardBridgeProxy;
+ }
+
+ public Optional getL2OutputOracleProxy() {
+ return l2OutputOracleProxy;
+ }
+
+ public void setL2OutputOracleProxy(Optional l2OutputOracleProxy) {
+ this.l2OutputOracleProxy = l2OutputOracleProxy;
+ }
+
+ public Address getOptimismMintableERC20FactoryProxy() {
+ return optimismMintableERC20FactoryProxy;
+ }
+
+ public void setOptimismMintableERC20FactoryProxy(Address optimismMintableERC20FactoryProxy) {
+ this.optimismMintableERC20FactoryProxy = optimismMintableERC20FactoryProxy;
+ }
+
+ public Address getOptimismPortalProxy() {
+ return optimismPortalProxy;
+ }
+
+ public void setOptimismPortalProxy(Address optimismPortalProxy) {
+ this.optimismPortalProxy = optimismPortalProxy;
+ }
+
+ public Address getSystemConfigProxy() {
+ return systemConfigProxy;
+ }
+
+ public void setSystemConfigProxy(Address systemConfigProxy) {
+ this.systemConfigProxy = systemConfigProxy;
+ }
+
+ public Address getSystemConfigOwner() {
+ return systemConfigOwner;
+ }
+
+ public void setSystemConfigOwner(Address systemConfigOwner) {
+ this.systemConfigOwner = systemConfigOwner;
+ }
+
+ public Address getProxyAdmin() {
+ return proxyAdmin;
+ }
+
+ public void setProxyAdmin(Address proxyAdmin) {
+ this.proxyAdmin = proxyAdmin;
+ }
+
+ public Address getProxyAdminOwner() {
+ return proxyAdminOwner;
+ }
+
+ public void setProxyAdminOwner(Address proxyAdminOwner) {
+ this.proxyAdminOwner = proxyAdminOwner;
+ }
+
+ public Address getGuardian() {
+ return guardian;
+ }
+
+ public void setGuardian(Address guardian) {
+ this.guardian = guardian;
+ }
+
+ public Optional getChallenger() {
+ return challenger;
+ }
+
+ public void setChallenger(Optional challenger) {
+ this.challenger = challenger;
+ }
+
+ public Optional getAnchorStateRegistryProxy() {
+ return anchorStateRegistryProxy;
+ }
+
+ public void setAnchorStateRegistryProxy(Optional anchorStateRegistryProxy) {
+ this.anchorStateRegistryProxy = anchorStateRegistryProxy;
+ }
+
+ public Optional getDelayedWETHProxy() {
+ return delayedWETHProxy;
+ }
+
+ public void setDelayedWETHProxy(Optional delayedWETHProxy) {
+ this.delayedWETHProxy = delayedWETHProxy;
+ }
+
+ public Optional getDisputeGameFactoryProxy() {
+ return disputeGameFactoryProxy;
+ }
+
+ public void setDisputeGameFactoryProxy(Optional disputeGameFactoryProxy) {
+ this.disputeGameFactoryProxy = disputeGameFactoryProxy;
+ }
+
+ public Optional getFaultDisputeGame() {
+ return faultDisputeGame;
+ }
+
+ public void setFaultDisputeGame(Optional faultDisputeGame) {
+ this.faultDisputeGame = faultDisputeGame;
+ }
+
+ public Optional getMips() {
+ return mips;
+ }
+
+ public void setMips(Optional mips) {
+ this.mips = mips;
+ }
+
+ public Optional getPermissionedDisputeGame() {
+ return permissionedDisputeGame;
+ }
+
+ public void setPermissionedDisputeGame(Optional permissionedDisputeGame) {
+ this.permissionedDisputeGame = permissionedDisputeGame;
+ }
+
+ public Optional getPreimageOracle() {
+ return preimageOracle;
+ }
+
+ public void setPreimageOracle(Optional preimageOracle) {
+ this.preimageOracle = preimageOracle;
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) return true;
+ if (!(o instanceof AddressList that)) return false;
+ return Objects.equals(getAddressManager(), that.getAddressManager()) && Objects.equals(getL1CrossDomainMessengerProxy(), that.getL1CrossDomainMessengerProxy()) && Objects.equals(getL1ERC721BridgeProxy(), that.getL1ERC721BridgeProxy()) && Objects.equals(getL1StandardBridgeProxy(), that.getL1StandardBridgeProxy()) && Objects.equals(getL2OutputOracleProxy(), that.getL2OutputOracleProxy()) && Objects.equals(getOptimismMintableERC20FactoryProxy(), that.getOptimismMintableERC20FactoryProxy()) && Objects.equals(getOptimismPortalProxy(), that.getOptimismPortalProxy()) && Objects.equals(getSystemConfigProxy(), that.getSystemConfigProxy()) && Objects.equals(getSystemConfigOwner(), that.getSystemConfigOwner()) && Objects.equals(getProxyAdmin(), that.getProxyAdmin()) && Objects.equals(getProxyAdminOwner(), that.getProxyAdminOwner()) && Objects.equals(getGuardian(), that.getGuardian()) && Objects.equals(getChallenger(), that.getChallenger()) && Objects.equals(getAnchorStateRegistryProxy(), that.getAnchorStateRegistryProxy()) && Objects.equals(getDelayedWETHProxy(), that.getDelayedWETHProxy()) && Objects.equals(getDisputeGameFactoryProxy(), that.getDisputeGameFactoryProxy()) && Objects.equals(getFaultDisputeGame(), that.getFaultDisputeGame()) && Objects.equals(getMips(), that.getMips()) && Objects.equals(getPermissionedDisputeGame(), that.getPermissionedDisputeGame()) && Objects.equals(getPreimageOracle(), that.getPreimageOracle());
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(getAddressManager(), getL1CrossDomainMessengerProxy(), getL1ERC721BridgeProxy(), getL1StandardBridgeProxy(), getL2OutputOracleProxy(), getOptimismMintableERC20FactoryProxy(), getOptimismPortalProxy(), getSystemConfigProxy(), getSystemConfigOwner(), getProxyAdmin(), getProxyAdminOwner(), getGuardian(), getChallenger(), getAnchorStateRegistryProxy(), getDelayedWETHProxy(), getDisputeGameFactoryProxy(), getFaultDisputeGame(), getMips(), getPermissionedDisputeGame(), getPreimageOracle());
+ }
+
+ @Override
+ public String toString() {
+ return "AddressList{" +
+ "addressManager=" + addressManager +
+ ", l1CrossDomainMessengerProxy=" + l1CrossDomainMessengerProxy +
+ ", l1ERC721BridgeProxy=" + l1ERC721BridgeProxy +
+ ", l1StandardBridgeProxy=" + l1StandardBridgeProxy +
+ ", l2OutputOracleProxy=" + l2OutputOracleProxy +
+ ", optimismMintableERC20FactoryProxy=" + optimismMintableERC20FactoryProxy +
+ ", optimismPortalProxy=" + optimismPortalProxy +
+ ", systemConfigProxy=" + systemConfigProxy +
+ ", systemConfigOwner=" + systemConfigOwner +
+ ", proxyAdmin=" + proxyAdmin +
+ ", proxyAdminOwner=" + proxyAdminOwner +
+ ", guardian=" + guardian +
+ ", challenger=" + challenger +
+ ", anchorStateRegistryProxy=" + anchorStateRegistryProxy +
+ ", delayedWETHProxy=" + delayedWETHProxy +
+ ", disputeGameFactoryProxy=" + disputeGameFactoryProxy +
+ ", faultDisputeGame=" + faultDisputeGame +
+ ", mips=" + mips +
+ ", permissionedDisputeGame=" + permissionedDisputeGame +
+ ", preimageOracle=" + preimageOracle +
+ '}';
+ }
+}
diff --git a/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/BlockID.java b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/BlockID.java
new file mode 100644
index 000000000..bc085ca5b
--- /dev/null
+++ b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/BlockID.java
@@ -0,0 +1,50 @@
+package io.optimism.superchain;
+
+
+import org.hyperledger.besu.datatypes.Hash;
+
+import java.math.BigInteger;
+import java.util.Objects;
+
+public class BlockID {
+
+ private Hash hash;
+
+ private BigInteger number;
+
+ public Hash getHash() {
+ return hash;
+ }
+
+ public void setHash(Hash hash) {
+ this.hash = hash;
+ }
+
+ public BigInteger getNumber() {
+ return number;
+ }
+
+ public void setNumber(BigInteger number) {
+ this.number = number;
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) return true;
+ if (!(o instanceof BlockID blockID)) return false;
+ return Objects.equals(getHash(), blockID.getHash()) && Objects.equals(getNumber(), blockID.getNumber());
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(getHash(), getNumber());
+ }
+
+ @Override
+ public String toString() {
+ return "BlockID{" +
+ "hash=" + hash +
+ ", number=" + number +
+ '}';
+ }
+}
diff --git a/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ChainConfig.java b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ChainConfig.java
new file mode 100644
index 000000000..a35238bdb
--- /dev/null
+++ b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ChainConfig.java
@@ -0,0 +1,212 @@
+package io.optimism.superchain;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonUnwrapped;
+import org.hyperledger.besu.datatypes.Address;
+
+import java.util.Objects;
+import java.util.Optional;
+
+/**
+ * Represents the configuration of a chain.
+ *
+ * @author grapebaba
+ * @since 0.1.0
+ */
+public class ChainConfig {
+
+ private String name;
+
+ private long chainId;
+
+ private String publicRpc;
+
+ private String sequencerRpc;
+
+ private String explorer;
+
+ private SuperchainLevel superchainLevel;
+
+ private Optional superchainTime = Optional.empty();
+
+ private Address batchInboxAddr;
+
+ private ChainGenesis genesis;
+
+ @JsonProperty("superchain")
+ @JsonIgnore
+ private String superchain;
+
+ @JsonProperty("chain")
+ @JsonIgnore
+ private String chain;
+
+ @JsonProperty("hardfork_configuration")
+ @JsonUnwrapped
+ private HardForkConfiguration hardforkConfiguration;
+
+ @JsonProperty("plasma")
+ private Optional plasma = Optional.empty();
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ public long getChainId() {
+ return chainId;
+ }
+
+ public void setChainId(long chainId) {
+ this.chainId = chainId;
+ }
+
+ public String getPublicRpc() {
+ return publicRpc;
+ }
+
+ public void setPublicRpc(String publicRpc) {
+ this.publicRpc = publicRpc;
+ }
+
+ public String getSequencerRpc() {
+ return sequencerRpc;
+ }
+
+ public void setSequencerRpc(String sequencerRpc) {
+ this.sequencerRpc = sequencerRpc;
+ }
+
+ public String getExplorer() {
+ return explorer;
+ }
+
+ public void setExplorer(String explorer) {
+ this.explorer = explorer;
+ }
+
+ public SuperchainLevel getSuperchainLevel() {
+ return superchainLevel;
+ }
+
+ public void setSuperchainLevel(SuperchainLevel superchainLevel) {
+ this.superchainLevel = superchainLevel;
+ }
+
+ public Optional getSuperchainTime() {
+ return superchainTime;
+ }
+
+ public void setSuperchainTime(Optional superchainTime) {
+ this.superchainTime = superchainTime;
+ }
+
+ public Address getBatchInboxAddr() {
+ return batchInboxAddr;
+ }
+
+ public void setBatchInboxAddr(Address batchInboxAddr) {
+ this.batchInboxAddr = batchInboxAddr;
+ }
+
+ public ChainGenesis getGenesis() {
+ return genesis;
+ }
+
+ public void setGenesis(ChainGenesis genesis) {
+ this.genesis = genesis;
+ }
+
+ public String getSuperchain() {
+ return superchain;
+ }
+
+ public void setSuperchain(String superchain) {
+ this.superchain = superchain;
+ }
+
+ public String getChain() {
+ return chain;
+ }
+
+ public void setChain(String chain) {
+ this.chain = chain;
+ }
+
+ public HardForkConfiguration getHardforkConfiguration() {
+ return hardforkConfiguration;
+ }
+
+ public void setHardforkConfiguration(HardForkConfiguration hardforkConfiguration) {
+ this.hardforkConfiguration = hardforkConfiguration;
+ }
+
+ public Optional getPlasma() {
+ return plasma;
+ }
+
+ public void setPlasma(Optional plasma) {
+ this.plasma = plasma;
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) return true;
+ if (!(o instanceof ChainConfig that)) return false;
+ return getChainId() == that.getChainId() && Objects.equals(getName(), that.getName()) && Objects.equals(getPublicRpc(), that.getPublicRpc()) && Objects.equals(getSequencerRpc(), that.getSequencerRpc()) && Objects.equals(getExplorer(), that.getExplorer()) && getSuperchainLevel() == that.getSuperchainLevel() && Objects.equals(getSuperchainTime(), that.getSuperchainTime()) && Objects.equals(getBatchInboxAddr(), that.getBatchInboxAddr()) && Objects.equals(getGenesis(), that.getGenesis()) && Objects.equals(getSuperchain(), that.getSuperchain()) && Objects.equals(getChain(), that.getChain()) && Objects.equals(getHardforkConfiguration(), that.getHardforkConfiguration()) && Objects.equals(getPlasma(), that.getPlasma());
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(getName(), getChainId(), getPublicRpc(), getSequencerRpc(), getExplorer(), getSuperchainLevel(), getSuperchainTime(), getBatchInboxAddr(), getGenesis(), getSuperchain(), getChain(), getHardforkConfiguration(), getPlasma());
+ }
+
+ @Override
+ public String toString() {
+ return "ChainConfig{" +
+ "name='" + name + '\'' +
+ ", chainId=" + chainId +
+ ", publicRpc='" + publicRpc + '\'' +
+ ", sequencerRpc='" + sequencerRpc + '\'' +
+ ", explorer='" + explorer + '\'' +
+ ", superchainLevel=" + superchainLevel +
+ ", superchainTime=" + superchainTime +
+ ", batchInboxAddr=" + batchInboxAddr +
+ ", genesis=" + genesis +
+ ", superchain='" + superchain + '\'' +
+ ", chain='" + chain + '\'' +
+ ", hardforkConfiguration=" + hardforkConfiguration +
+ ", plasma=" + plasma +
+ '}';
+ }
+
+ public void setMissingForkConfigs(HardForkConfiguration defaults) {
+ if (this.superchainTime.isEmpty()) {
+ return;
+ }
+
+ long superchainTime = this.superchainTime.get();
+
+ HardForkConfiguration cfg = this.hardforkConfiguration;
+
+ if (cfg.getCanyonTime().isPresent() && cfg.getCanyonTime().get() > superchainTime) {
+ cfg.setCanyonTime(defaults.getCanyonTime());
+ }
+
+ if (cfg.getDeltaTime().isPresent() && cfg.getDeltaTime().get() > superchainTime) {
+ cfg.setDeltaTime(defaults.getDeltaTime());
+ }
+
+ if (cfg.getEcotoneTime().isPresent() && cfg.getEcotoneTime().get() > superchainTime) {
+ cfg.setEcotoneTime(defaults.getEcotoneTime());
+ }
+
+ if (cfg.getFjordTime().isPresent() && cfg.getFjordTime().get() > superchainTime) {
+ cfg.setFjordTime(defaults.getFjordTime());
+ }
+ }
+}
diff --git a/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ChainGenesis.java b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ChainGenesis.java
new file mode 100644
index 000000000..08a168eba
--- /dev/null
+++ b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ChainGenesis.java
@@ -0,0 +1,136 @@
+package io.optimism.superchain;
+
+import java.util.Objects;
+import java.util.Optional;
+
+/**
+ * Represents the genesis of a chain.
+ *
+ * @author grapebaba
+ * @since 0.1.0
+ */
+public class ChainGenesis {
+
+ private BlockID l1;
+
+ private BlockID l2;
+
+ private long l2Time;
+
+ private Optional extraData = Optional.empty();
+
+ private Optional systemConfig = Optional.empty();
+
+ /**
+ * Gets l1.
+ *
+ * @return the l1
+ */
+ public BlockID getL1() {
+ return l1;
+ }
+
+ /**
+ * Sets l1.
+ *
+ * @param l1 the l1
+ */
+ public void setL1(BlockID l1) {
+ this.l1 = l1;
+ }
+
+ /**
+ * Gets l2.
+ *
+ * @return the l2
+ */
+ public BlockID getL2() {
+ return l2;
+ }
+
+ /**
+ * Sets l2.
+ *
+ * @param l2 the l2
+ */
+ public void setL2(BlockID l2) {
+ this.l2 = l2;
+ }
+
+ /**
+ * Gets l2 time.
+ *
+ * @return the l2 time
+ */
+ public long getL2Time() {
+ return l2Time;
+ }
+
+ /**
+ * Sets l2 time.
+ *
+ * @param l2Time the l2 time
+ */
+ public void setL2Time(long l2Time) {
+ this.l2Time = l2Time;
+ }
+
+ /**
+ * Gets extra data.
+ *
+ * @return the extra data
+ */
+ public Optional getExtraData() {
+ return extraData;
+ }
+
+ /**
+ * Sets extra data.
+ *
+ * @param extraData the extra data
+ */
+ public void setExtraData(Optional extraData) {
+ this.extraData = extraData;
+ }
+
+ /**
+ * Gets system config.
+ *
+ * @return the system config
+ */
+ public Optional getSystemConfig() {
+ return systemConfig;
+ }
+
+ /**
+ * Sets system config.
+ *
+ * @param systemConfig the system config
+ */
+ public void setSystemConfig(Optional systemConfig) {
+ this.systemConfig = systemConfig;
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) return true;
+ if (!(o instanceof ChainGenesis that)) return false;
+ return Objects.equals(getL1(), that.getL1()) && Objects.equals(getL2(), that.getL2()) && Objects.equals(getL2Time(), that.getL2Time()) && Objects.equals(getExtraData(), that.getExtraData()) && Objects.equals(getSystemConfig(), that.getSystemConfig());
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(getL1(), getL2(), getL2Time(), getExtraData(), getSystemConfig());
+ }
+
+ @Override
+ public String toString() {
+ return "ChainGenesis{" +
+ "l1=" + l1 +
+ ", l2=" + l2 +
+ ", l2Time=" + l2Time +
+ ", extraData=" + extraData +
+ ", systemConfig=" + systemConfig +
+ '}';
+ }
+}
diff --git a/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ContractImplementations.java b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ContractImplementations.java
new file mode 100644
index 000000000..cad1a5da4
--- /dev/null
+++ b/bindings/java-bindings/superchain-primitives/src/main/java/io/optimism/superchain/ContractImplementations.java
@@ -0,0 +1,223 @@
+package io.optimism.superchain;
+
+import org.hyperledger.besu.datatypes.Address;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Optional;
+
+
+public class ContractImplementations {
+
+ private Map l1CrossDomainMessenger= new HashMap<>();
+
+ private Map l1ERC721Bridge= new HashMap<>();
+
+ private Map l1StandardBridge= new HashMap<>();
+
+ private Map l2OutputOracle= new HashMap<>();
+
+ private Map optimismMintableERC20Factory= new HashMap<>();
+
+ private Map optimismPortal= new HashMap<>();
+
+ private Map systemConfig= new HashMap<>();
+ // Fault Proof Contracts
+ private Optional