From 35b6192c3eb8022bd8e81b77f06878ae3fe92715 Mon Sep 17 00:00:00 2001
From: refcell <abigger87@gmail.com>
Date: Tue, 27 Aug 2024 18:51:24 -0400
Subject: [PATCH] fix: readme

---
 README.md       | 32 +++++++++++++++++++++++++++++---
 assets/.gitkeep |  0
 2 files changed, 29 insertions(+), 3 deletions(-)
 create mode 100644 assets/.gitkeep

diff --git a/README.md b/README.md
index 190a5fe..35c941b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,29 @@
-# `superchain`
+<h1 align="center">
+    <img src="./assets/banner.png" alt="Superchain" width="100%" align="center">
+</h1>
 
-Rust Bindings for the [superchain-registry][sr].
+<h4 align="center">
+    Rust bindings for the <a href="https://github.com/ethereum-optimism/superchain-registry">superchain-registry</a>.
+</h4>
+
+<p align="center">
+  <a href="https://github.com/anton-rs/superchain/actions/workflows/rust_ci.yaml"><img src="https://github.com/anton-rs/superchain/actions/workflows/rust_ci.yaml/badge.svg?label=ci" alt="CI"></a>
+  <img src="https://img.shields.io/badge/License-MIT-green.svg?label=license&labelColor=2a2f35" alt="License">
+  <a href="https://github.com/ethereum-optimism/monorepo"><img src="https://img.shields.io/badge/OP%20Stack-monorepo-red?labelColor=2a2f35" alt="OP Stack"></a>
+</p>
+
+<p align="center">
+  <a href="#whats-superchain">What's Superchain?</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#example">Example</a> •
+  <a href="#credits">Credits</a>
+</p>
+
+## What's Superchain?
+
+The [Superchain](https://docs.optimism.io/stack/explainer) is a network of chains that share bridging, decentralized governance, upgrades, a communication layer and more.
+
+This repository contains rust bindings for the [superchain-registry][sr].
 
 The best way to work with this repo is through the [`superchain`][sup]
 crate. [`superchain`][sup] is an optionally `no_std` crate that provides
@@ -60,6 +83,10 @@ println!("OP Mainnet Chain Config: {:?}", op_chain_config);
 - `serde`: Enables [`serde`][s] support for types and makes [`superchain-registry`][scr] types available.
 - `std`: Uses the standard library to pull in environment variables.
 
+## Credits
+
+This repository could not be built without OP Labs contributors working on the [superchain-registry][scr] and [alloy-rs](https://github.com/alloy-rs) contributors.
+
 <!-- Hyperlinks -->
 
 [sp]: ./crates/superchain-primitives
@@ -70,4 +97,3 @@ println!("OP Mainnet Chain Config: {:?}", op_chain_config);
 [sup]: https://crates.io/crates/superchain
 [scp]: https://crates.io/crates/superchain-primitives
 [superchain]: https://github.com/anton-rs/superchain
-
diff --git a/assets/.gitkeep b/assets/.gitkeep
new file mode 100644
index 0000000..e69de29