DeFiPy 1.0.9__py3-none-any.whl

defipy/agents/VolumeSpikeNotifierAgent.py

@@ -0,0 +1,190 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from pydantic import BaseModel
+from web3scout.utils.connect import ConnectW3
+from web3scout.abi.abi_load import ABILoad
+from web3scout.event.process.retrieve_events import RetrieveEvents
+from web3scout.token.fetch.fetch_token import FetchToken
+from .config import VolumeSpikeConfig
+from .data import UniswapPoolData
+from uniswappy import * 
+from web3 import Web3
+
+class VolumeSpikeNotifierAgent:
+    def __init__(self, config: VolumeSpikeConfig, verbose: bool = False):
+        self.config = config
+        self.abi = ABILoad(self.config.platform, self.config.abi_name)  # Load ABI here  
+        self.connector = ConnectW3(self.config.provider_url)  # Web3Scout setup
+        self.connector.apply()
+        self.verbose = verbose
+        self.pool_volume = None
+        self.lp_contract = None
+        self.lp_data = None
+        self.lp_state = None
+
+    def init(self):
+        self.lp_contract = self._init_lp_contract()
+        
+        reserves = self.lp_contract.functions.getReserves().call()
+        token0_address = self.lp_contract.functions.token0().call()
+        token1_address = self.lp_contract.functions.token1().call()
+        reserve0 = reserves[0]; reserve1 = reserves[1]
+
+        w3 = self.connector.get_w3()
+        FetchERC20 = FetchToken(w3)
+        TKN0 = FetchERC20.apply(token0_address)
+        TKN1 = FetchERC20.apply(token1_address)
+
+        self.lp_data = UniswapPoolData(TKN0, TKN1, reserves)
+
+    def get_connector(self):
+        return self.connector
+
+    def get_abi(self):
+        return self.abi
+
+    def get_w3(self):
+        return self.connector.get_w3() 
+
+    def get_contract_instance(self):
+        return self.lp_contract
+
+    def get_lp_data(self):
+        return self.lp_data
+
+    def prime_mock_pool(self, start_block, user_nm = None):
+        w3 = self.get_w3() 
+        fetch_tkn = FetchToken(w3)
+        
+        lp_contract = self._init_lp_contract()
+        tkn0_addr = lp_contract.functions.token0().call()
+        tkn1_addr = lp_contract.functions.token1().call()
+        total_supply = lp_contract.functions.totalSupply().call(block_identifier=start_block)
+        reserves = lp_contract.functions.getReserves().call(block_identifier=start_block)
+        
+        # Step 2: Define tokens
+        tkn0 = fetch_tkn.apply(tkn0_addr)
+        tkn1 = fetch_tkn.apply(tkn1_addr)
+        
+        amt0 = fetch_tkn.amt_to_decimal(tkn0, reserves[0])
+        amt1 = fetch_tkn.amt_to_decimal(tkn1, reserves[1])
+        
+        # Step 3:  Initialize factory
+        factory = UniswapFactory("Pool factory", "0x2")
+        
+        # Step 4: Set up exchange data for V2
+        exch_data = UniswapExchangeData(tkn0=tkn0, tkn1=tkn1, symbol="LP", address=self.config.pool_address)
+        
+        # Step 5: Deploy pool
+        self.lp_state = factory.deploy(exch_data)
+        
+        # Step 6: Add initial liquidity
+        join = Join()
+        join.apply(self.lp_state, user_nm, amt0, amt1)
+        self.lp_state.total_supply = total_supply # override total supply
+    
+        return self.lp_state
+
+    def update_mock_pool(self, lp, cur_block):
+        w3 = self.get_w3() 
+        fetch_tkn = FetchToken(w3)
+        
+        lp_contract = self._init_lp_contract()
+        tkn0_addr = lp_contract.functions.token0().call()
+        tkn1_addr = lp_contract.functions.token1().call()
+        total_supply = lp_contract.functions.totalSupply().call(block_identifier=int(cur_block))
+        reserves = lp_contract.functions.getReserves().call(block_identifier=int(cur_block))
+        
+        tkn0 = self.get_lp_data().tkn0
+        tkn1 = self.get_lp_data().tkn1
+        amt0 = fetch_tkn.amt_to_decimal(tkn0, reserves[0])
+        amt1 = fetch_tkn.amt_to_decimal(tkn1, reserves[1])
+        
+        prev_total_supply = lp.total_supply
+        lp.reserve0 = lp.convert_to_machine(amt0)      # override reserve0
+        lp.reserve1 = lp.convert_to_machine(amt1)      # override reserve1
+        lp.total_supply = total_supply                 # override total supply
+        lp.last_liquidity_deposit = abs(prev_total_supply - lp.total_supply)
+        
+        return lp
+
+    def run_batch(self, lp, tkn, user_nm, events: dict):
+        """Process batched Sync events to check TVL and trigger exits."""
+        if not events:
+            print("No Sync events found in range.")
+            return
+        for k in events:
+            block_num = events[k]['blockNumber']
+            self.apply(lp, tkn, user_nm, block_num)
+
+    def apply(self, lp, tkn, user_nm, block_num):
+        """Execute liquidity exit if condition met."""
+        if self.check_condition(lp, tkn, self.config.volume_threshold, block_num):
+            vol = self.pool_volume
+            print(f"Block {block_num}: Volume ({tkn.token_name}) = {vol}, outside threshold {self.config.volume_threshold}")
+            return vol
+        else:
+            print(f"Block {block_num}: Volume threshold condition met for {lp.name} LP")
+            return None
+
+    def take_mock_position(self, lp, tkn, user_nm, amt):
+        SwapDeposit().apply(lp, tkn, user_nm, amt)
+        self.mock_lp_pos_amt = lp.get_last_liquidity_deposit()
+        return self.mock_lp_pos_amt
+
+    def withdraw_mock_position(self, lp, tkn, user_nm, lp_amt = None):
+        assert self.mock_lp_pos_amt != None, 'TVLBasedLiquidityExitAgent: MOCK_POSITION_UNAVAILABLE' 
+        lp_amt = self.mock_lp_pos_amt if lp_amt == None else lp_amt
+        tkn_amt = LPQuote(False).get_amount_from_lp(lp, tkn0, lp_amt)
+        amount_out = WithdrawSwap().apply(lp, tkn0, user_nm, tkn_amt)
+        return amount_out
+
+    def get_pool_volume(self, lp, tkn, block_num):
+        """Calculate TVL from reserves (sum in USD, assuming base_token normalization)."""
+
+        tkn0 = self.get_lp_data().tkn0
+        tkn1 = self.get_lp_data().tkn1
+        prev_tkn0 = lp.get_reserve(tkn0)
+        prev_tkn1 = lp.get_reserve(tkn1)
+
+        lp = self.update_mock_pool(lp, block_num)
+        
+        dtkn0 = abs(lp.get_reserve(tkn0) - prev_tkn0)
+        dtkn1 = abs(lp.get_reserve(tkn1) - prev_tkn1)
+
+        if(tkn.token_name == tkn0.token_name):
+            volume = dtkn0 + LPQuote().get_amount(lp, tkn1, dtkn1)  
+        elif(tkn.token_name == tkn1.token_name):
+            volume = dtkn1 + LPQuote().get_amount(lp, tkn0, dtkn0)
+        
+        self.pool_volume = volume
+        return volume
+
+    def check_condition(self, lp, tkn, threshold, block_num = None):
+        """Check if TVL is below threshold."""
+        block_num = self.get_w3().eth.block_number if block_num == None else block_num
+        volume = self.get_pool_volume(lp, tkn, block_num)
+        return volume > threshold
+
+    def _init_lp_contract(self): 
+        pair_address = self.config.pool_address
+        w3 = self.get_w3()       
+        abi_obj = self.get_abi()
+        lp_contract = abi_obj.apply(w3, pair_address)   
+        return lp_contract

defipy/agents/__init__.py

@@ -0,0 +1,4 @@
+from .PriceThresholdSwapAgent import PriceThresholdSwapAgent
+from .TVLBasedLiquidityExitAgent import TVLBasedLiquidityExitAgent
+from .VolumeSpikeNotifierAgent import VolumeSpikeNotifierAgent
+from .ImpermanentLossAgent import ImpermanentLossAgent

defipy/agents/config/ImpermanentLossConfig.py

@@ -0,0 +1,28 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from pydantic import BaseModel
+
+class ImpermanentLossConfig(BaseModel):
+    il_threshold: float  # Impermanent loss threshold percentage (e.g., 5.0 for 5%)
+    pool_address: str       # Uniswap V2 pool address
+    provider_url: str       # Web3 provider URL (e.g., Infura)
+    abi_name: str  # e.g., 'UniswapV2Pair' (new field for ABI identifier)
+    platform: str  # e.g., 'UNI' or 'SUSHI' for the protocoll
+    user_position: float    # Initial mock position amount for off-chain testing
+    exit_percentage: float  # Percentage of position to exit upon trigger (e.g., 1.0 for 100%)

defipy/agents/config/PriceThresholdConfig.py

@@ -0,0 +1,27 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from pydantic import BaseModel
+
+class PriceThresholdConfig(BaseModel):  
+    threshold: float  # e.g., 3000.0 (price above which to swap)
+    swap_amount: float  # e.g., 1.0 (swap amount if threshold met)
+    pool_address: str  # Uniswap V2 pool
+    provider_url: str  # e.g., Infura for Web3Scout
+    abi_name: str  # e.g., 'UniswapV2Pair' (new field for ABI identifier)
+    platform: str  # e.g., 'UNI' or 'SUSHI' for the protocoll

defipy/agents/config/TVLExitConfig.py

@@ -0,0 +1,28 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from pydantic import BaseModel
+
+class TVLExitConfig(BaseModel):
+    tvl_threshold: float  # e.g., 1000000.0 (minimum TVL in USD)
+    exit_percentage: float  # e.g., 1.0 (full exit) or 0.5 (half)
+    pool_address: str  # Pool contract address
+    provider_url: str  # Web3 provider URL
+    abi_name: str  # e.g., 'UniswapV2Pair' (new field for ABI identifier)
+    platform: str  # e.g., 'UNI' or 'SUSHI' for the protocoll
+    user_position: float  # User's LP shares or amount

defipy/agents/config/VolumeSpikeConfig.py

@@ -0,0 +1,27 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from pydantic import BaseModel
+
+class VolumeSpikeConfig(BaseModel):
+    volume_threshold: float  # Volume threshold for notification (e.g., USD value of trades)
+    pool_address: str       # Uniswap V2 pool address
+    provider_url: str       # Web3 provider URL (e.g., Infura)
+    abi_name: str  # e.g., 'UniswapV2Pair' (new field for ABI identifier)
+    platform: str  # e.g., 'UNI' or 'SUSHI' for the protocoll
+    user_position: float  # User's LP shares or amount

defipy/agents/config/__init__.py

@@ -0,0 +1,7 @@
+from .PriceThresholdConfig import PriceThresholdConfig
+from .TVLExitConfig import TVLExitConfig
+from .VolumeSpikeConfig import VolumeSpikeConfig
+from .ImpermanentLossConfig import ImpermanentLossConfig
+
+
+

defipy/agents/data/UniswapPoolData.py

@@ -0,0 +1,26 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from dataclasses import dataclass
+from uniswappy.erc import ERC20
+
+@dataclass
+class UniswapPoolData:
+    tkn0: ERC20 = None
+    tkn1: ERC20 = None
+    reserves: list = None

defipy/agents/data/__init__.py

@@ -0,0 +1 @@
+from .UniswapPoolData import UniswapPoolData

defipy/analytics/risk/__init__.py

@@ -0,0 +1 @@
+from uniswappy.analytics.risk import *

defipy/analytics/simulate/__init__.py

@@ -0,0 +1 @@
+from uniswappy.analytics.simulate import *

defipy/erc/__init__.py

@@ -0,0 +1 @@
+from uniswappy.erc import *

defipy/math/basic/__init__.py

@@ -0,0 +1 @@
+from uniswappy.math.basic import *

defipy/math/interest/__init__.py

@@ -0,0 +1 @@
+from uniswappy.math.interest import *

defipy/math/interest/ips/__init__.py

@@ -0,0 +1 @@
+from uniswappy.math.interest.ips import *

defipy/math/interest/ips/aggregate/__init__.py

@@ -0,0 +1 @@
+from uniswappy.math.interest.ips.aggregate import *

defipy/math/model/__init__.py

@@ -0,0 +1 @@
+from uniswappy.math.model import *

defipy/math/risk/__init__.py

@@ -0,0 +1 @@
+from uniswappy.math.risk import *

defipy/process/__init__.py

@@ -0,0 +1 @@
+from uniswappy.process import *

defipy/process/burn/__init__.py

@@ -0,0 +1 @@
+from uniswappy.process.burn import *

defipy/process/deposit/__init__.py

@@ -0,0 +1 @@
+from uniswappy.process.deposit import *

defipy/process/join/Join.py

@@ -0,0 +1,57 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from uniswappy.process.join import Join as UniswapJoin
+from balancerpy.process.join import Join as BalancerJoin
+from stableswappy.process.join import Join as StableswapJoin
+
+class Join():
+    
+    """ Process to join x and y amounts to pool              
+    """       
+
+    def __init__(self):
+        pass
+
+    def apply(self, lp, v1 = None, v2 = None, v3 = None, v4 = None, v5 = None):
+        """ apply
+
+            Join x and y amounts to pool
+
+            UniswapJoin().apply(lp, user_nm, amount0, amount1, lwr_tick = None, upr_tick = None):
+            
+            BalancerJoin().apply(lp, user_nm, shares)
+            
+            StableswapJoin().apply(lp, user_nm, shares)
+                     
+            Returns
+            -------
+            out : dictionary
+                join output               
+        """ 
+
+        if type(lp).__name__ == 'UniswapExchange' or type(lp).__name__ == 'UniswapV3Exchange':
+            out = UniswapJoin().apply(lp, v1, v2, v3, v4, v5)
+        elif type(lp).__name__ == 'BalancerExchange':
+            out = BalancerJoin().apply(lp, v1, v2)     
+        elif type(lp).__name__ == 'StableswapExchange':
+            out = StableswapJoin().apply(lp, v1, v2)     
+        else:
+            print('DeFiPy: WRONG EXCHANGE TYPE OR VARIABLES')
+             
+        return out 

defipy/process/join/__init__.py

@@ -0,0 +1,2 @@
+from .Join import Join
+from uniswappy.process.join import JoinTree

defipy/process/liquidity/AddLiquidity.py

@@ -0,0 +1,57 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from uniswappy.process.liquidity import AddLiquidity as UniswapAddLiquidity
+from balancerpy.process.liquidity import AddLiquidity as BalancerAddLiquidity
+from stableswappy.process.liquidity import AddLiquidity as StableswapAddLiquidity
+
+class AddLiquidity():
+    
+    """ Add liquidity process             
+    """       
+
+    def __init__(self, global_var1 = None):
+        self.gvar = global_var1
+
+    def apply(self, lp, v1 = None, v2 = None, v3 = None, v4 = None, v5 = None):
+        """ apply
+
+            Add liquidity process
+
+            UniswapAddLiquidity().apply(lp, user_nm, amount0, amount1, lwr_tick = None, upr_tick = None):
+            
+            BalancerAddLiquidity(Proc.ADDTKN).apply(lp, tkn_in, user_nm, amt_tkn_in)
+            
+            StableswapAddLiquidity().apply(lp, tkn_in, user_nm, amt_tkn_in)
+                     
+            Returns
+            -------
+            out : dictionary
+                join output               
+        """ 
+
+        if type(lp).__name__ == 'UniswapExchange' or type(lp).__name__ == 'UniswapV3Exchange':
+            out = UniswapAddLiquidity().apply(lp, v1, v2, v3, v4, v5)
+        elif type(lp).__name__ == 'BalancerExchange':
+            out = BalancerAddLiquidity(self.gvar).apply(lp, v1, v2, v3)     
+        elif type(lp).__name__ == 'StableswapExchange':
+            out = StableswapAddLiquidity().apply(lp, v1, v2, v3)     
+        else:
+            print('DeFiPy: WRONG EXCHANGE TYPE OR VARIABLES')
+             
+        return out 

defipy/process/liquidity/RemoveLiquidity.py

@@ -0,0 +1,57 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from uniswappy.process.liquidity import RemoveLiquidity as UniswapRemoveLiquidity
+from balancerpy.process.liquidity import RemoveLiquidity as BalancerRemoveLiquidity
+from stableswappy.process.liquidity import RemoveLiquidity as StableswapRemoveLiquidity
+
+class RemoveLiquidity():
+    
+    """ Process to join x and y amounts to pool              
+    """       
+
+    def __init__(self, global_var1 = None):
+        self.gvar = global_var1
+
+    def apply(self, lp, v1 = None, v2 = None, v3 = None, v4 = None, v5 = None):
+        """ apply
+
+            Join x and y amounts to pool
+
+            UniswapRemoveLiquidity().apply(lp, user_nm, amount0, amount1, lwr_tick = None, upr_tick = None):
+            
+            BalancerRemoveLiquidity(Proc.ADDTKN).apply(lp, tkn_in, user_nm, amt_tkn_in)
+            
+            StableswapRemoveLiquidity().apply(lp, tkn_in, user_nm, amt_tkn_in)
+                     
+            Returns
+            -------
+            out : dictionary
+                join output               
+        """ 
+
+        if type(lp).__name__ == 'UniswapExchange' or type(lp).__name__ == 'UniswapV3Exchange':
+            out = UniswapRemoveLiquidity().apply(lp, v1, v2, v3, v4, v5)
+        elif type(lp).__name__ == 'BalancerExchange':
+            out = BalancerRemoveLiquidity(self.gvar).apply(lp, v1, v2, v3)     
+        elif type(lp).__name__ == 'StableswapExchange':
+            out = StableswapRemoveLiquidity().apply(lp, v1, v2, v3)     
+        else:
+            print('DeFiPy: WRONG EXCHANGE TYPE OR VARIABLES')
+             
+        return out 

defipy/process/liquidity/__init__.py

@@ -0,0 +1,2 @@
+from .AddLiquidity import AddLiquidity
+from .RemoveLiquidity import RemoveLiquidity

defipy/process/mint/__init__.py

@@ -0,0 +1 @@
+from uniswappy.process.mint import *

defipy/process/swap/Swap.py

@@ -0,0 +1,57 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Apache 2.0 License (DeFiPy)
+# ─────────────────────────────────────────────────────────────────────────────
+# Copyright 2023–2025 Ian Moore
+# Email: defipy.devs@gmail.com
+#
+# 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
+#
+#     http://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.
+
+from uniswappy.process.swap import Swap as UniswapSwap
+from balancerpy.process.swap import Swap as BalancerSwap
+from stableswappy.process.swap import Swap as StableswapSwap
+
+class Swap():
+    
+    """ Process to swap token X for token Y (and vice verse)            
+    """       
+
+    def __init__(self, global_var1 = None):
+        self.gvar = global_var1
+
+    def apply(self, lp, v1 = None, v2 = None, v3 = None, v4 = None):
+        """ apply
+
+            Swap token X for token Y (and vice verse)  
+
+            UniswapSwap().apply(lp, token_in, user_nm, amount)
+            
+            BalancerSwap().apply(lp, token_in, token_out, user_nm, amount)
+            
+            StableswapSwap().apply(lp, token_in, token_out, user_nm, amount)
+                     
+            Returns
+            -------
+            out : dictionary
+                join output               
+        """ 
+
+        if type(lp).__name__ == 'UniswapExchange' or type(lp).__name__ == 'UniswapV3Exchange':
+            out = UniswapSwap().apply(lp, v1, v2, v3)
+        elif type(lp).__name__ == 'BalancerExchange':
+            out = BalancerSwap(self.gvar).apply(lp, v1, v2, v3, v4)     
+        elif type(lp).__name__ == 'StableswapExchange':
+            out = StableswapSwap().apply(lp, v1, v2, v3, v4)     
+        else:
+            print('DeFiPy: WRONG EXCHANGE TYPE OR VARIABLES')
+             
+        return out 

defipy/process/swap/__init__.py

@@ -0,0 +1,2 @@
+from .Swap import Swap
+from uniswappy.process.swap import WithdrawSwap

defipy/utils/client/__init__.py

@@ -0,0 +1 @@
+from uniswappy.utils.client import *