feat(#major); kwenta; new subgraph

deployment/deployment.json

@@ -9101,7 +9101,7 @@
         "network": "optimism",
         "status": "dev",
         "versions": {
-          "schema": "1.2.1",
+          "schema": "1.3.3",
           "subgraph": "1.0.0",
           "methodology": "1.0.0"
         },
@@ -9116,7 +9116,7 @@
         },
         "options": {
           "prepare:yaml": true,
-          "prepare:constants": false
+          "prepare:constants": true
         }
       }
     }

subgraphs/kwenta/README.md

@@ -0,0 +1,65 @@
+# Kwenta Subgraph
+
+## Calculation Methodology v1.0.0
+
+### Total Value Locked (TVL)
+
+Sum of all the margin deposits
+
+> TVL of a Pool = ∑ value of all assets to be provided as collateral pool
+
+> TVL of the Protocol = ∑ TVL of of all the pools
+
+### Open Intereest
+
+> Open Interest = ∑ value of open positions
+
+Calculated by fetching pool contract market size and skew data
+
+> Long Open Interest = (marketSize + marketSkew) / 2
+
+> Short Open Interest = (marketSize - marketSkew) / 2
+
+> Total Open Interest = Long + Short Open Interest
+
+### Volume
+
+- Volume: The total cumulative value of all the trades executed
+
+- Inflow Volume: The total cumulative value of margin deposited
+- Outflow Volume: The total cumulative value of margin withdrawn
+
+### Revenue/Fees
+
+The protocol take two fees - Keeper Fees and Maker/Takes Fees
+
+- Keeper Fees: A dynamic fees to execute the trade
+- Maker/Taker Fees: Normal Maker/Taker fees they vary depending on the market
+
+Protocol Side Revenue = Zero
+
+Supply-Side Revenue = Total Fees (currently Kwenta don't charge any fees)
+
+Total Revenue = Total Fees
+
+### Unique Users
+
+**Count of Unique Addresses which have interacted with the protocol via any transaction:**
+
+- Margin deposits and withdrawals
+
+- Position Modified - new, updated or closed
+
+- Liquidations
+
+## References and Useful Links
+
+- Other existing subgraph: https://thegraph.com/hosted-service/subgraph/kwenta/optimism-main
+
+- Other official and unofficial data sources: https://kwenta.eth.limo/stats/, https://tokenterminal.com/terminal/projects/kwenta
+
+- Documentation: https://docs.kwenta.io/
+
+## Note
+
+We are only tracking v2 markets because v1 markets are deprecated and have almost no liquidity, and the current method to calculate open interest is not supported by v1 markets

subgraphs/kwenta/abis/ERC20.json

@@ -0,0 +1,222 @@
+[
+  {
+    "constant": true,
+    "inputs": [],
+    "name": "name",
+    "outputs": [
+      {
+        "name": "",
+        "type": "string"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "constant": false,
+    "inputs": [
+      {
+        "name": "_spender",
+        "type": "address"
+      },
+      {
+        "name": "_value",
+        "type": "uint256"
+      }
+    ],
+    "name": "approve",
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "constant": true,
+    "inputs": [],
+    "name": "totalSupply",
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "constant": false,
+    "inputs": [
+      {
+        "name": "_from",
+        "type": "address"
+      },
+      {
+        "name": "_to",
+        "type": "address"
+      },
+      {
+        "name": "_value",
+        "type": "uint256"
+      }
+    ],
+    "name": "transferFrom",
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "constant": true,
+    "inputs": [],
+    "name": "decimals",
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint8"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "constant": true,
+    "inputs": [
+      {
+        "name": "_owner",
+        "type": "address"
+      }
+    ],
+    "name": "balanceOf",
+    "outputs": [
+      {
+        "name": "balance",
+        "type": "uint256"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "constant": true,
+    "inputs": [],
+    "name": "symbol",
+    "outputs": [
+      {
+        "name": "",
+        "type": "string"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "constant": false,
+    "inputs": [
+      {
+        "name": "_to",
+        "type": "address"
+      },
+      {
+        "name": "_value",
+        "type": "uint256"
+      }
+    ],
+    "name": "transfer",
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "constant": true,
+    "inputs": [
+      {
+        "name": "_owner",
+        "type": "address"
+      },
+      {
+        "name": "_spender",
+        "type": "address"
+      }
+    ],
+    "name": "allowance",
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "payable": true,
+    "stateMutability": "payable",
+    "type": "fallback"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "name": "owner",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "name": "spender",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "name": "value",
+        "type": "uint256"
+      }
+    ],
+    "name": "Approval",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "name": "from",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "name": "value",
+        "type": "uint256"
+      }
+    ],
+    "name": "Transfer",
+    "type": "event"
+  }
+]

subgraphs/kwenta/abis/ERC20NameBytes.json

@@ -0,0 +1,17 @@
+[
+  {
+    "constant": true,
+    "inputs": [],
+    "name": "name",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  }
+]

subgraphs/kwenta/abis/ERC20SymbolBytes.json

@@ -0,0 +1,17 @@
+[
+  {
+    "constant": true,
+    "inputs": [],
+    "name": "symbol",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "payable": false,
+    "stateMutability": "view",
+    "type": "function"
+  }
+]