Merge branch 'master' into chore-update-readme

README.md

@@ -65,3 +65,30 @@ Proof length is the number of headers needed before and after a retarget to upda
 |-------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------|
 | BOB Sepolia | TestLightRelay | [0x4c51bc419ead57da0d825afae3090f2f76e5892d](https://testnet-explorer.gobob.xyz/address/0x4c51bc419ead57da0d825afae3090f2f76e5892d) |
 | BOB Mainnet | LightRelay     | []() |
+
+## Security
+
+Let's review the calculation given in the [Bitcoin Wiki](https://en.bitcoin.it/wiki/Difficulty) to compute the hashrate: 
+
+```
+hashrate = difficulty * 2**32 / 600 (60 * 10 = 10 minutes)
+hashrate = ~157 (GH/s) = (22012.4941572 * 2**32 / 600) / 10**9 (example)
+hashrate = ~595 (EH/s) (83148355189239.77 * 2**32 / 600) / 10**18 (current)
+```
+
+The `LightRelay` requires that the proof is included at the *current* or *previous* difficulty so we can assume the attacker has 2016 * 2 blocks to brute-force a valid chain of `proofLength`.
+This is possible since due to SPV assumptions we can not verify the transactions references by the block header are valid, only that sufficient PoW has accumulated on the chain.
+
+Let's assume the attacker can generate 6 blocks (with some invalid transactions) within two difficulty adjustment period, 2016 * 2 blocks (four weeks).
+
+```
+hashrate * 6/(2016*2)
+595 * 6/(2016*2) = 0.885 EH/s (~885712 TH/s)
+```
+
+So we need ~0.148% of the current hashrate to build six blocks in two weeks.
+
+If we estimate it would cost $11 per TH/s (excluding electricity and other setup costs) then the total cost of that hashrate would be $9,742,832.
+This excludes the opportunity cost from actually mining on Bitcoin mainnet, receiving fees and block rewards.
+
+Therefore, provided the value protected by the relay is less than $10m protocols secured by the relay are "economically safe".

docs/docs/build/getting-started/networks.md

@@ -9,6 +9,7 @@ sidebar_position: 2
 - Chain ID: 60808
 - Gas Token: ETH
 - RPC URL: https://rpc.gobob.xyz/
+- WS URL: wss://rpc.gobob.xyz
 - Explorer: https://explorer.gobob.xyz/
 - Bridge (BOB - Ethereum): https://app.gobob.xyz/bridge
 

docs/docs/learn/guides/bob-fusion.md

@@ -9,98 +9,107 @@ sidebar_label: BOB Fusion
 
 BOB Fusion is the official points program of BOB, where users can harvest BOB Spice (points) based on their on-chain activity on the BOB mainnet. BOB Spice (points) represent your contribution to the BOB ecosystem - today and in the future.
 
-# Season 1
+## Season 1
 
-Season 1 started on 27 March 2024 and ended with the BOB mainnet launch on 1 May 2024.
-During Season 1, users harvested Spice by locking in whitelisted assets with different multipliers. The on-chain TVL for Season 1 reached USD 300 million TVL in just 4 weeks.
+Season 1 started on 27/03/2024 and ended with the BOB mainnet launch on 1st May 2024.
+During Season 1, users harvested Spice by locking in whitelisted assets with different multipliers. The on-chain TVL for Season 1 reached a whopping 300 Million USD in just 4 weeks.
 
 ## Season 2
 
-Season 2 started on 1st May 2024 with more ways to earn Spice based on-chain activity. Here are the 5 different ways in which you can harvest Spice during Season 2.
+Season 2 started on 1st May 2024 with more ways to harvest Spice based on-chain activity. Here are the 5 different ways in which you can harvest Spice during Season 2.
 
-1. **Bridging assets to BOB**. Bridging whitelisted assets to the BOB network will start accruing a small, daily amount of Spice based on the asset value and asset multipliers. Here’s a [list of all whitelisted assets](https://app.gobob.xyz/fusion?tab=info) that will be eligible for Spice and will be updated from time to time.
+1. **Bridging assets to BOB**
+   Holding whitelisted assets to the BOB network will accrue Spice based on the asset value and asset multipliers. Here’s a [list of all whitelisted assets](https://app.gobob.xyz/fusion?tab=info) that will be eligible for Spice and will be updated from time to time.
 
-   Hint: BTC assets (wBTC and tBTC) will get the highest multiplier of Spice. Bridge more BTC assets to maximize Spice harvest.
+Hint - BTC assets (wBTC and tBTC) will get the highest multiplier of Spice. Bridge more BTC assets to harvest more Spice.
 
-   `Spice harvest meter: Low (depends on bridged TVL per user)`
+`Spice harvest meter: Low (Depends on how many assets user bridges)`
 
-2. **Supplying TVL**. After bridging to the BOB mainnet, when users deploy TVL into whitelisted assets dApps, the dApps will start receiving Spice points (based on TVL). The dApps then distribute the Spice they receive to their users (there is a special process and API for this). Please note that the dApps may have their own rules and eligibility criteria for Spice earned in this manner. You can track all the information about how much Spice each dApp has received and distributed to users, as well as your personal Spice harvest on the [BOB Fusion dashboard](https://app.gobob.xyz/fusion).
+2. **Supplying TVL**
+   After bridging to the BOB mainnet, when users deploy TVL into whitelisted assets dApps, the dApps will start receiving Spice points (based on TVL).
 
-   `Spice harvest meter: Medium to High (dApp distributions may vary)`
+The dApps then distribute the Spice they receive to their users (there is a special process and API for this). Please note that the dApps may have their own rules and eligibility criteria for Spice harvested in this manner. You can track all the information about how much Spice each dApp has received and distributed to users, as well as your personal Spice harvest on the [BOB Fusion dashboard](https://app.gobob.xyz/fusion).
 
-3. **Actively using BOB dApps**. When you use and interact with certain whitelisted dApps, you harvest Spice. This Spice is distributed to you directly and will be reflected on your BOB Fusion Dashboard. More hints and alpha to harvest Spice will be shared by the participating dApps on their BOB Fusion Dashboards, on Discord or project specific social channels.
+`Spice harvest meter: Medium to High (Depends on dApp distributions)`
 
-   `Spice harvest meter:  Medium to High (depends on user activity)`
+3. **Actively using BOB dApps**
+   When you use and interact with certain whitelisted dApps, you harvest Spice. This Spice is distributed to you directly and will be reflected on your BOB Fusion Dashboard. More hints and tips to harvest Spice will be shared by the participating dApps on their BOB Fusion Dashboards, on Discord, or project-specific social channels.
 
-4. **Referring power users**. Users will earn +15% on top of any Spice their invites earn, and +7% on top of any Spice their invite’s invites earn. The more users you invite and the more your invites bridge, the more you earn!
+`Spice harvest meter:  Medium to High (Depends on user activity)`
 
-5. **Being an active community member**/ Users can earn more Spice by participating in community events and solving quests on BOB’s official [GALXE dashboard](https://app.galxe.com/quest/bob), where new quests are added regularly.
+4. **Referring power users**
+   Users will get +15% on top of any Spice their invites get, and +7% on top of any Spice their invite’s invites get. The more users you invite and the more your invites bridge, the more you get!
 
-# FAQs
+5. **Being an active community member**
+   Users can get more Spice by participating in community events and solving quests on BOB’s official [GALXE dashboard](https://app.galxe.com/quest/bob), where new quests are added regularly.
+
+## FAQs
 
 1. **How to participate in BOB Fusion?**
-   BOB Fusion is an invite-only program. If you are an existing member of the program, just log in via the same wallet you used for Season 1 to continue for Season 2. If you’re new to BOB Fusion then follow the steps below:
+   BOB Fusion is an invite-only program. If you are an existing member of the program, just log in via the same wallet you used for Season 1 to continue for Season 2.
+
+If you’re new to BOB Fusion then follow the steps below,
 
-   - Step 1: Get an invite code from our [official discord](https://discord.gg/gobob) server and sign up at http://fusion.gobob.xyz
-   - Step 2: Bridge [whitelisted assets](https://docs.google.com/spreadsheets/d/12wTFxjjqAsmRKHNFeVHCOcZmesyJlrtCjUgIpZ229jc/edit#gid=0) to the BOB network via https://app.gobob.xyz/bridge and generate your own invite code to share with others and earn bonus Spice.
-   - Step 3: Check out the different dApp campaigns on the [BOB Fusion dashboard](http://fusion.gobob.xyz) and harvest Spice.
+- Step 1: Get an invite code from our [official discord server](https://discord.gg/gobob) and sign up at http://fusion.gobob.xyz
+- Step 2: Bridge [whitelisted assets](https://docs.google.com/spreadsheets/d/12wTFxjjqAsmRKHNFeVHCOcZmesyJlrtCjUgIpZ229jc/edit#gid=0) to the BOB network via https://app.gobob.xyz/bridge and generate your own invite code to share with others and get bonus Spice.
+- Step 3: Check out the different dApp campaigns on the [BOB Fusion dashboard](http://fusion.gobob.xyz) and harvest Spice.
 
 2. **Will my Season 1 assets automatically bridge to the BOB mainnet for Season 2?**
 
-   No, you will need to bridge the assets to the BOB mainnet. We have made an easy 1 click feature that allows direct bridging to the BOB mainnet. You can do so by visiting your BOB Fusion Dashboard and choosing “Bridge all locked assets to BOB” as shown in the image below. Sign the transaction & your assets will be bridged to the BOB mainnet.
+No, you will need to bridge the assets to the BOB mainnet. We have made an easy 1 click feature that allows direct bridging to the BOB mainnet. You can do so by visiting your BOB Fusion Dashboard and choosing “Bridge all locked assets to BOB” as shown in the image below. Sign the transaction & your assets will be bridged to the BOB mainnet.
 
-   An exception from this is USDT, see below.
+![Season One Ended](./bob-fusion/season-1-ended.png)
 
-3. **Special case: Bridging USDT from Season 1 to BOB mainnet for Season 2**
+### Special case: USDT
 
-   If you locked USDT during Season 1, then the above 1-click transfer will not work for your locked USDT & you will need to sign 2 transactions:
+If you locked USDT during Season 1, then the above 1-click transfer will not work for your locked USDT & you will need to sign 2 transactions:
 
-   - Once to directly move all your assets except USDT to the BOB mainnet &
-   - And another to withdraw USDT to the Ethereum mainnet.
+- Once to directly move all your assets except USDT to the BOB mainnet
+- And another to withdraw USDT to the Ethereum mainnet.
 
-   You can then bridge your USDT to the BOB mainnet via the BOB bridge. Here’s a guide on how you can do it in simple steps.
+You can then bridge your USDT to the BOB mainnet via the BOB bridge. Here’s a guide on how you can do it in simple steps.
 
-   ![USDT dialogue](./bob-fusion/usdt-withdraw.png)
+![USDT dialogue](./bob-fusion/usdt-withdraw.png)
 
-4. **What happens to my Season 1 points?**
+3. **What happens to my Season 1 points?**
 
-   Your Season 2 points will accrue on top of Season 1 points. For eg. If you harvested 100,000 Spice for Season 1, your Season 2 Spice tally will begin from 100,000 and accrue on top of it. Even if you do not participate in Season 2, you will keep your Season 1 Spice points.
+Your Season 2 points will accrue on top of Season 1 points. For eg. If you harvested 100,000 Spice for Season 1, your Season 2 Spice tally will begin from 100,000 and accrue on top of it. Even if you do not participate in Season 2, you will keep your Season 1 Spice points.
 
-5. **What are the participating dApps for Season 2?**
+4. **Who are the participating dApps for Season 2?**
 
-   All information about the eligible transactions on participating dApps will be shared on the BOB Fusion dashboard. https://app.gobob.xyz/fusion
+All information about the eligible transactions on participating dApps will be shared on the BOB Fusion dashboard. https://app.gobob.xyz/fusion
 
-6. **How can I maximize my Spice harvest for Season 2?**
+5. **How can I maximize my Spice harvest for Season 2?**
 
-   We believe in complete transparency and therefore all Spice distribution from BOB to dApps and from dApp to users will be reflected on the BOB Fusion dashboard. Users are expected to do their own research from the dashboard information and figure out a strategy that works best for them.
+We believe in complete transparency and therefore all Spice distribution from BOB to dApps and from dApp to users will be reflected on the BOB Fusion dashboard. Users are expected to do their own research from the dashboard information and figure out a strategy that works best for them.
 
-   Some tips to maximize Spice harvest: (Not Financial Advice, Always DYOR)
+Some tips for Spice harvest: (Not Financial Advice, Always DYOR)
 
-   1. Bitcoin assets on the BOB mainnet have the highest multiplier of Spice.
-   2. On-chain activity and putting your assets to work in dApps will lead to higher Spice harvest
-   3. Make sure to check the BOB Fusion dashboard regularly for new dApp campaigns.
+(i) Bitcoin assets on the BOB mainnet have the highest multiplier of Spice.
+(ii) On-chain activity and putting your assets to work in dApps will lead to higher Spice harvest
+(iii) Make sure to check the BOB Fusion dashboard regularly for new dApp campaigns.
 
-7. **I participated in Galxe quests during Season 1, what about those points?**
+6. **I participated in Galxe quests during Season 1, what about those points?**
 
-   To be able to redeem your galxe points to Spice in 1:1 ratio,
+To be able to redeem your Galxe points to Spice in 1:1 ratio,
 
-   1. You will need to make sure you’ve registered and logged in for BOB Fusion
-   2. Bridged whitelisted assets to the BOB mainnet. Make sure to use the same wallet address for both Galxe and BOB Fusion. If you fail to do these steps, your galxe points will be invalid.
+(i) You will need to make sure you’ve registered and logged in for BOB Fusion
+(ii) Bridged whitelisted assets to the BOB mainnet. Make sure to use the same wallet address for both Galxe and BOB Fusion. If you fail to do these steps, your Galxe points will be invalid.
 
-   If you follow the above steps correctly then your Spice from Galxe quests will be reflected in the coming months once we make the UI update.
+If you follow the above steps correctly then your Spice from Galxe quests will be reflected in the coming months once we make the UI update.
 
-8. **My assets are on an exchange. How can I contribute?**
+7. **My assets are on an exchange. How can I contribute?**
 
-   Withdraw your assets as well as sufficient ETH for gas fees from a centralized exchange to the Ethereum network or any supported L2 like Arbitrum, Optimism, Base, etc.
+Withdraw your assets as well as sufficient ETH for gas fees from a centralized exchange to the Ethereum network or any supported L2 like Arbitrum, Optimism, Base, etc.
 
-   If you’re a Coinbase user, withdrawing to the base network is free & then you can bridge your assets to BOB for low gas fees.
+If you’re a Coinbase user, withdrawing to the base network is free & then you can bridge your assets to BOB for low gas fees.
 
-   Use the BOB bridge or any other listed bridge providers to bridge your assets to the BOB network. https://app.gobob.xyz/bridge
+Use the BOB bridge or any other listed bridge providers to bridge your assets to the BOB network. https://app.gobob.xyz/bridge
 
-9. **What happens to the referrals I made in Season 1?**
+8. **What happens to the referrals I made in Season 1?**
 
-   Your referral bonus will continue into Season 2 if your Season 1 invites (& their invites) also participate & harvest spice into Season 2. Your invite code will remain the same in Season 2 so you can invite more people as well for bonus spice.
+Your referral bonus will continue into Season 2 if your Season 1 invites (& their invites) also participate & harvest spice into Season 2. Your invite code will remain the same in Season 2 so you can invite more people as well for bonus spice.
 
-10. **What is the gas token on BOB**
+9. **What is the gas token on BOB**
 
-    ETH. BOB fees are low, similar to OP chain fees (see here https://l2fees.info/)
+ETH. BOB fees are low, similar to OP chain fees (see here https://l2fees.info/)