From 8f43b5264f5cc9c46ba135983d75db08f088942c Mon Sep 17 00:00:00 2001
From: Chad Ostrowski <221614+chadoh@users.noreply.github.com>
Date: Tue, 23 Jul 2024 09:27:49 -0400
Subject: [PATCH] feat: add equitx contract stubs

---
 Cargo.lock                            | 16 +++++++++
 contracts/data-feed/README.md         |  3 ++
 contracts/equitx-landscape/Cargo.toml | 23 +++++++++++++
 contracts/equitx-landscape/README.md  |  7 ++++
 contracts/equitx-landscape/src/lib.rs |  3 ++
 contracts/xasset/Cargo.toml           | 23 +++++++++++++
 contracts/xasset/README.md            | 47 +++++++++++++++++++++++++++
 contracts/xasset/src/lib.rs           |  3 ++
 8 files changed, 125 insertions(+)
 create mode 100644 contracts/data-feed/README.md
 create mode 100644 contracts/equitx-landscape/Cargo.toml
 create mode 100644 contracts/equitx-landscape/README.md
 create mode 100644 contracts/equitx-landscape/src/lib.rs
 create mode 100644 contracts/xasset/Cargo.toml
 create mode 100644 contracts/xasset/README.md
 create mode 100644 contracts/xasset/src/lib.rs

diff --git a/Cargo.lock b/Cargo.lock
index 34a0e59..4de65f7 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -440,6 +440,14 @@ dependencies = [
  "zeroize",
 ]
 
+[[package]]
+name = "equitx-landscape"
+version = "0.0.0"
+dependencies = [
+ "loam-sdk",
+ "loam-subcontract-core",
+]
+
 [[package]]
 name = "equivalent"
 version = "1.0.1"
@@ -1683,6 +1691,14 @@ version = "0.52.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dff9641d1cd4be8d1a070daf9e3773c5f67e78b4d9d42263020c057706765c04"
 
+[[package]]
+name = "xasset"
+version = "0.0.0"
+dependencies = [
+ "loam-sdk",
+ "loam-subcontract-core",
+]
+
 [[package]]
 name = "zeroize"
 version = "1.7.0"
diff --git a/contracts/data-feed/README.md b/contracts/data-feed/README.md
new file mode 100644
index 0000000..c499d74
--- /dev/null
+++ b/contracts/data-feed/README.md
@@ -0,0 +1,3 @@
+# Reflector Network contract clone
+
+This is a minimum viable clone of the Reflector contract, to iron out how we are going to use Loam SDK and to allow for rapid local development.
diff --git a/contracts/equitx-landscape/Cargo.toml b/contracts/equitx-landscape/Cargo.toml
new file mode 100644
index 0000000..e1958a4
--- /dev/null
+++ b/contracts/equitx-landscape/Cargo.toml
@@ -0,0 +1,23 @@
+[package]
+name = "equitx-landscape"
+description = "Keeps track of all EquitX contracts and allows deploying new ones"
+version = "0.0.0"
+authors = ["Aha Labs <help@ahalabs.dev>"]
+license = "Apache-2.0"
+edition = "2021"
+publish = false
+
+[lib]
+crate-type = ["cdylib"]
+doctest = false
+
+[dependencies]
+loam-sdk = { workspace = true, features = ["loam-soroban-sdk"] }
+loam-subcontract-core = { workspace = true }
+
+
+[dev_dependencies]
+loam-sdk = { workspace = true, features = ["soroban-sdk-testutils"] }
+
+[package.metadata.loam]
+contract = true
diff --git a/contracts/equitx-landscape/README.md b/contracts/equitx-landscape/README.md
new file mode 100644
index 0000000..f0a59b9
--- /dev/null
+++ b/contracts/equitx-landscape/README.md
@@ -0,0 +1,7 @@
+# EquitX Landscape Contract
+
+This contract will have:
+
+- a map of asset names ("xUSD") to contract addresses ("C123…")
+- a method to deploy new xAsset contract (so it will need to store the wasm of the xAsset contract, or a reference to it by name on the Loam Registry), which is only callable by admin.
+- a method to list all CDPs for a given account, so it can iterate the "map of asset names" keys and make cross-contract calls to see if the given account has an entry in its CDPs map.
diff --git a/contracts/equitx-landscape/src/lib.rs b/contracts/equitx-landscape/src/lib.rs
new file mode 100644
index 0000000..6b86832
--- /dev/null
+++ b/contracts/equitx-landscape/src/lib.rs
@@ -0,0 +1,3 @@
+#![no_std]
+use loam_sdk::{derive_contract, soroban_sdk::Vec};
+use loam_subcontract_core::{admin::Admin, Core};
diff --git a/contracts/xasset/Cargo.toml b/contracts/xasset/Cargo.toml
new file mode 100644
index 0000000..b8bd0df
--- /dev/null
+++ b/contracts/xasset/Cargo.toml
@@ -0,0 +1,23 @@
+[package]
+name = "xasset"
+description = "Fungible Token that wraps another asset, creates a stability pool for it, and allows creating Collateralized Debt Positions (CDPs) against it."
+version = "0.0.0"
+authors = ["Aha Labs <help@ahalabs.dev>"]
+license = "Apache-2.0"
+edition = "2021"
+publish = false
+
+[lib]
+crate-type = ["cdylib"]
+doctest = false
+
+[dependencies]
+loam-sdk = { workspace = true, features = ["loam-soroban-sdk"] }
+loam-subcontract-core = { workspace = true }
+
+
+[dev_dependencies]
+loam-sdk = { workspace = true, features = ["soroban-sdk-testutils"] }
+
+[package.metadata.loam]
+contract = true
diff --git a/contracts/xasset/README.md b/contracts/xasset/README.md
new file mode 100644
index 0000000..51a0c22
--- /dev/null
+++ b/contracts/xasset/README.md
@@ -0,0 +1,47 @@
+# xAsset Contract
+
+This is mostly just a Fungible Token ([example implementation](https://github.com/loambuild/loam-sdk/tree/main/examples/soroban/ft)), but will also contain most of the other logic described in the Indigo white paper. This includes Stability Pool functionality, and the iAsset/xAsset functionality. We need to come up with a better name for this one. Maybe "BorrowableAsset" or "CollateralizedAsset" or "CDPAsset". These will each be implemented as Loam subcontracts, which will 1. make them easy to split out to separate contracts later if needed and 2. make them easy to publish and share, which means they need understandable names that don't make them sound app-specific. This "asset that wraps another, which people can borrow using CDPs, where these CDPs get liquidated if the collateralization ratio falls below some minimum" is a fairly common pattern across the blockchain space at this point, and it would be nice to give it a recognizable name.
+
+Let's call this subcontract CollateralizedAsset for now. Here's the data managed by this subcontract:
+
+```rs
+struct CollateralizedAsset {
+    /// Oracle ID & which asset from Oracle this tracks. Might be worth storing these as separate fields?
+    pegged_to: String;
+    /// basis points; default 110%; updateable by admin
+    minimum_collateralization_ratio: u16;
+    /// each Address can only have one CDP per Asset. Given that you can adjust your CDPs freely, that seems fine?
+    cdps: Map<Address, CDP>;
+}
+```
+
+Where CDP needs to have:
+
+```rs
+struct CDP {
+    xlm_deposited: u128,
+    usd_lent: u128,
+    status: CDPStatus,
+}
+
+/// Descriptions of these on page 5 of Indigo white paper
+enum CDPStatus {
+    Open,
+    Insolvent, // not sure if `Insolvent` needs to be hard-coded or if it can be calculated on-demand while data's small and as part of our eventual indexing layer once data's big
+    Frozen,
+    Closed,
+}
+```
+
+
+Ok, onto the StabilityPool subcontract.
+
+```
+/// all attributes listed here are described in the Indigo white paper
+struct StabilityPool {
+    product_constant: u32; // maybe u64? not sure it will ever get that big
+    compounded_constant: u32; // or u64! or float??
+}
+```
+
+I think that might be it, for xAsset contracts. It's at least a good starting point and already gives us lots of functionality to implement and play with. 
diff --git a/contracts/xasset/src/lib.rs b/contracts/xasset/src/lib.rs
new file mode 100644
index 0000000..6b86832
--- /dev/null
+++ b/contracts/xasset/src/lib.rs
@@ -0,0 +1,3 @@
+#![no_std]
+use loam_sdk::{derive_contract, soroban_sdk::Vec};
+use loam_subcontract_core::{admin::Admin, Core};