diff --git a/README.md b/README.md
index 1397b2da..49fce131 100644
--- a/README.md
+++ b/README.md
@@ -1,301 +1,115 @@
-# ποΈ Scaffold Balancer v3
+# ποΈ Balancer v3 Hooks
-A starter kit for building on top of Balancer v3. Accelerate the process of creating custom pools and hooks contracts. Concentrate on mastering the core concepts within a swift and responsive environment augmented by a local fork and a frontend pool operations playground.
+## LP Incentivized Hook
-[](https://www.youtube.com/watch?v=m6q5M34ZdXw)
+The **LPIncentive Hook** is a smart contract designed to incentivize liquidity providers (LPs) based on both the volume of liquidity they provide and the duration for which they keep their liquidity in the pool. This hook allows protocols to reward LPs with more granular control by using these two factors to calculate rewards, ensuring that long-term and high-volume liquidity providers are appropriately rewarded.
-### π Development Life Cycle
+### What the hook does
-1. Learn the core concepts for building on top of Balancer v3
-2. Configure and deploy factories, pools, and hooks contracts to a local anvil fork of Sepolia
-3. Interact with pools via a frontend that runs at [localhost:3000](http://localhost:3000/)
+1. Volume-Based Incentive:
-### πͺ§ Table Of Contents
+**Liquidity Volume:**
+The hook tracks the total volume of liquidity an LP adds to the pool. As LPs reach certain predefined volume milestones, they unlock higher tiers of rewards.
-- [π§βπ» Environment Setup](#-environment-setup)
-- [π©βπ« Learn Core Concepts](#-learn-core-concepts)
-- [π΅οΈ Explore the Examples](#-explore-the-examples)
-- [π Create a Custom Pool](#-create-a-custom-pool)
-- [π Create a Pool Factory](#-create-a-pool-factory)
-- [πͺ Create a Pool Hook](#-create-a-pool-hook)
-- [π’ Deploy the Contracts](#-deploy-the-contracts)
-- [π§ͺ Test the Contracts](#-test-the-contracts)
+**Milestone-Based Rewards:**
+For example, if an LP provides liquidity exceeding certain thresholds (e.g., 10,000 tokens, 50,000 tokens, etc.), they are entitled to receive higher rewards, such as extra tokens or fee rebates.
-## π§βπ» Environment Setup
+2. Time-Based Incentive:
-### 1. Requirements π
+**Holding Duration:**
+LPs are incentivized to keep their liquidity in the pool for a longer period. The longer an LP keeps liquidity staked in the pool without withdrawing, the higher their rewards.
-- [Node (>= v18.17)](https://nodejs.org/en/download/)
-- Yarn ([v1](https://classic.yarnpkg.com/en/docs/install/) or [v2+](https://yarnpkg.com/getting-started/install))
-- [Git](https://git-scm.com/downloads)
-- [Foundry](https://book.getfoundry.sh/getting-started/installation) (>= v0.2.0)
+**Reward Vesting:**
+LP rewards are distributed based on how long the liquidity has been staked. For example, an LP must hold liquidity for at least 30 days to become eligible for certain rewards. If the liquidity is withdrawn before that period, the LP forfeits the time-based reward.
-### 2. Quickstart π
+### Pool Lifecycle Implementation Point(s)
-1. Ensure you have the latest version of foundry installed
+**onAfterAddLiquidity**
+- Update the total liquidity for the user
+- Calculate the rewards
+- Distribute the rewards
-```
-foundryup
-```
+**onAfterRemoveLiquidity**
+- Update the total liquidity for the user
-2. Clone this repo & install dependencies
+### Advantages and Applications
-```bash
-git clone https://github.com/balancer/scaffold-balancer-v3.git
-cd scaffold-balancer-v3
-yarn install
-```
+**Encourages Long-Term Commitment:**
+The time-based rewards ensure that LPs who commit their capital for longer periods are rewarded more generously than short-term participants, promoting pool stability.
-3. Set a `SEPOLIA_RPC_URL` in the `packages/foundry/.env` file
+**Rewards High-Volume LPs:**
+By providing tiered rewards based on volume, the protocol incentivizes LPs to add more liquidity, which improves liquidity depth and enhances the user experience for traders.
-```
-SEPOLIA_RPC_URL=...
-```
+**Fair and Transparent Reward Distribution:**
+With clear volume and time-based milestones, LPs understand exactly how much liquidity and how long they need to stake to maximize their rewards.
-4. Start a local anvil fork of the Sepolia testnet
+**Prevents Abuse:**
+The withdrawal penalty prevents LPs from gaming the system by adding and removing liquidity frequently, ensuring rewards are fairly distributed to committed participants.
-```bash
-yarn fork
-```
-5. Deploy the mock tokens, pool factories, pool hooks, and custom pools contracts
- > By default, the anvil account #0 will be the deployer and recieve the mock tokens and BPT from pool initialization
+## SwapReferrer Hook
-```bash
-yarn deploy
-```
+The **SwapReferrer Hook** is a specialized smart contract that integrates a referral-based discount mechanism into a token swap operation on a decentralized finance (DeFi) platform. This hook allows both users and referrers to benefit from reduced swap fees.
-6. Start the nextjs frontend
+### What the hook does
-```bash
-yarn start
-```
+The **SwapReferrer Hook** is designed for DeFi protocols that want to incentivize user acquisition through a referral system. It allows liquidity providers and swappers to benefit from discounted swap fees when they either use a referral code or are referrers themselves.
-7. Explore the frontend
+The smart contract has the following key features and processes:
-- Navigate to http://localhost:3000 to see the home page
-- Visit the [Pools Page](http://localhost:3000/pools) to search by address or select using the pool buttons
-- Vist the [Debug Page](http://localhost:3000/debug) to see the mock tokens, factory, and hooks contracts
+1. Referral Code Generation:
-8. Run the Foundry tests
+When a user swaps for the first time, a unique referral code is generated for them automatically. This referral code can be used by other users for future swaps, but the user cannot use their own referral code.
+The referral code is stored and linked to the userβs address.
-```
-yarn test
-```
+2. User Benefit (Instant Swap Fee Discount):
-### 3. Scaffold ETH 2 Tips ποΈ
+When a user performs a token swap and provides a referral code, they instantly receive a discount on the swap fee. This discount is a percentage of the predefined swap fee (e.g., 50% off the original fee).
+The predefined swap fee is passed as a percentage by the calling contract (e.g., 0.01e18 for 1%). The discount is calculated as a percentage reduction on this predefined fee.
+For example, if the predefined swap fee is 1% (0.01e18), and the user is eligible for a 50% discount, the user only pays a 0.5% fee.
-SE-2 offers a variety of configuration options for connecting an account, choosing networks, and deploying contracts
+3. Referrer Benefit (Redeemable Swap Fee Discount):
-π₯ Burner Wallet
+For each new user who swaps using a referral code, the referrer accumulates a redeemable swap fee discount (e.g., 30% discount for each referral).
+When the referrer performs their next swap, they can use the accumulated discount to reduce their swap fee.
+If the accumulated discount exceeds 100% of the swap fee, only up to 100% is applied, and any leftover discount is carried over to future swaps.
+For example:
+If 5 users swap using the same referral code, the referrer accumulates a 150% discount (30% per user Γ 5 users).
+When the referrer swaps next, they can only use up to 100% of the discount to perform the swap for free, and the remaining 50% will be carried forward to future swaps.
-If you do not have an active wallet extension connected to your web browser, then scaffold eth will automatically connect to a "burner wallet" that is randomly generated on the frontend and saved to the browser's local storage. When using the burner wallet, transactions will be instantly signed, which is convenient for quick iterative development.
+4. Discount Limits and Controls:
-To force the use of burner wallet, disable your browsers wallet extensions and refresh the page. Note that the burner wallet comes with 0 ETH to pay for gas so you will need to click the faucet button in top right corner. Also the mock tokens for the pool are minted to your deployer account set in `.env` so you will want to navigate to the "Debug Contracts" page to mint your burner wallet some mock tokens to use with the pool.
+The smart contract ensures that:
+A user can only use a referral code once when performing their first swap.
+The final swap fee for a user can never go below 0%.
+The referrerβs discount is applied with a cap of 100%, ensuring that the referrer cannot receive more than a full swap fee reduction on a single swap.
-
+5. Swap Fee Output in Percentage:
-
+The swap fee after applying discounts (both user and referrer) is calculated and returned as a percentage.
+This makes the hook compatible with other contracts that calculate swap fees based on percentages, ensuring that it integrates seamlessly into a broader DeFi protocol.
-π Browser Extension Wallet
-
-- To use your preferred browser extension wallet, ensure that the account you are using matches the PK you previously provided in the `foundry/.env` file
-- You may need to add a local development network with rpc url `http://127.0.0.1:8545/` and chain id `31337`. Also, you may need to reset the nonce data for your wallet exension if it gets out of sync.
+**onBeforeSwap**
+- Calculate the user discount
+- Generate the Referral code for a new user
+- Calculate the referrer discount
+- Store the final discount in variable
-π Debug Contracts Page
+**onAfterSwap**
+- Update the final swap fee to zero for a new swap
-The [Debug Contracts Page](http://localhost:3000/debug) can be useful for viewing and interacting with all of the externally avaiable read and write functions of a contract. The page will automatically hot reload with contracts that are deployed via the `01_DeployConstantSumFactory.s.sol` script. We use this handy setup to mint `mockERC20` tokens to any connected wallet
+### Advantages and Applications
-π Changing The Frontend Network Connection
+**Referrer Incentive:**
+Referrers benefit from long-term rewards as their discounts accumulate over time. This encourages liquidity providers and active participants to invite more users to the platform.
-- The network the frontend points at is set via `targetNetworks` in the `scaffold.config.ts` file using `chains` from viem.
-- By default, the frontend runs on a local node at `http://127.0.0.1:8545`
-
-```typescript
-const scaffoldConfig = {
- targetNetworks: [chains.foundry],
-```
-
-π΄ Changing The Forked Network
-
-- By default, the `yarn fork` command points at sepolia, but any of the network aliases from the `[rpc_endpoints]` of `foundry.toml` can be used to modify the `"fork"` alias in the `packages/foundry/package.json` file
-
-```json
- "fork": "anvil --fork-url ${0:-sepolia} --chain-id 31337 --config-out localhost.json",
-```
-
-- To point the frontend at a different forked network, change the `targetFork` in `scaffold.config.ts`
-
-```typescript
-const scaffoldConfig = {
- // The networks the frontend can connect to
- targetNetworks: [chains.foundry],
-
- // If using chains.foundry as your targetNetwork, you must specify a network to fork
- targetFork: chains.sepolia,
-```
-
-