From 2622d29e38cb5144b44316f99ea9723355cc8c13 Mon Sep 17 00:00:00 2001
From: shaito <106555513+0xShaito@users.noreply.github.com>
Date: Wed, 7 Jun 2023 16:02:43 +0200
Subject: [PATCH] fix: readme (#37)
---
README.md | 4 ++--
assets/architectural-specs.png | Bin 0 -> 182318 bytes
assets/flows.png | Bin 0 -> 254074 bytes
3 files changed, 2 insertions(+), 2 deletions(-)
create mode 100644 assets/architectural-specs.png
create mode 100644 assets/flows.png
diff --git a/README.md b/README.md
index 6fa8deb..2086ef4 100644
--- a/README.md
+++ b/README.md
@@ -11,12 +11,12 @@ xTokens is a standard for bridged tokens. A common interface to be used across d
*XERC20Factory*: The factory is used as a helper to deploy an xToken. It allows the owner to deploy the XERC20 and the Lockbox in one transaction while keeping the same token address on every chain used.
### Architectural Spec
-
+
*The adapter included is an example into how it would work. Any bridge can build their own.
### Flows
-
+
## Setup
diff --git a/assets/architectural-specs.png b/assets/architectural-specs.png
new file mode 100644
index 0000000000000000000000000000000000000000..b6138445bbd7acddb3d6466f770dc8c450b0a458
GIT binary patch
literal 182318
zcmZ_$2|Seh|2~eZNR5ihQY1Q^3T3GbB3mg+vWz9`kg|-evSyE@PKnb(MhIEPHnNO;
zgd)jq>}$$4#*#Jb?|EC!_pSfu-{Wx(GiL7lwLV|hbv>`={Y34$;%*ctijIzM_Z1}t
z4LZ8*WIDQS%R9EiJBD}dgyF{)dkw`4bg9*chTsLgxx9)z9o>gOrbQD5c)jzElCC`+
z9s4olzb#iZ{vM~JTZz4*Ag}3SG}5`Vps``4e4
2pJ=%*h$
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