Merge branch 'master' into dependabot/github_actions/actions/checkout-6

Author: ns212

.github/workflows/sdk-npm.yml

@@ -3,7 +3,7 @@ name: SDK NPM Publish
 on:
   push:
     tags:
-      - "*"
+      - '*'
 jobs:
   publish:
     runs-on: ubuntu-latest
@@ -15,9 +15,12 @@ jobs:
       - name: setup node
         uses: actions/setup-node@v6
         with:
-          node-version: "20"
-          registry-url: "https://registry.npmjs.org"
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
           always-auth: true
+      - name: install tokenlist dependencies
+        working-directory: ./tokenlist
+        run: npm ci
       - run: npm ci
       - run: npm run build
       - run: npm publish --access public

README.md

@@ -2,6 +2,22 @@
 
 BOB is a Bitcoin-augmented rollup bringing experimentation and freedom of choice to builders to make a real-world impact. BOBs vision is to onboard the next billion users to Bitcoin.
 
+## BOB Token
+
+- **Name:** BOB
+- **Symbol:** `BOB`
+- **Decimals:** `18`
+- **Standard:** ERC-20 (OpenZeppelin implementation, no transfer fees or hooks)
+- **Bridging:** Chainlink CCIP (lock/unlock on BOB, burn/mint on other chains)
+
+### Deployments
+
+| Network | Chain ID | Contract |
+| --- | --- | --- |
+| BOB Mainnet | `60808` (`0xED88`) | [`0xb0bd54846a92b214c04a63b26ad7dc5e19a60808`](https://explorer.gobob.xyz/address/0xb0bd54846a92b214c04a63b26ad7dc5e19a60808) |
+| Ethereum Mainnet | `1` (`0x1`) | [`0xC9746F73cC33a36c2cD55b8aEFD732586946Cedd`](https://etherscan.io/address/0xC9746F73cC33a36c2cD55b8aEFD732586946Cedd) |
+| BNB Smart Chain (BSC) | `56` (`0x38`) | [`0x52B5fB4B0F6572B8C44d0251Cc224513ac5eB7E7`](https://bscscan.com/address/0x52B5fB4B0F6572B8C44d0251Cc224513ac5eB7E7) |
+
 ## Learn more
 
 - [Website](https://www.gobob.xyz/)

docs/docs/docs/bob-chain/full-node.md

@@ -18,16 +18,16 @@ This is a **readiness upgrade** to make BOB protocol compatible with Ethereum's
 
 If you or your partners are running external nodes, please ensure the following steps are completed:
 
-- **op-node**: Update to version [v1.14.1](https://github.com/ethereum-optimism/optimism/releases/tag/op-node%2Fv1.14.1)
-- **op-geth**: Update to version [v1.101603.1](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101603.1)
+- **op-node**: Update to version [v1.16.2](https://github.com/ethereum-optimism/optimism/releases/tag/op-node%2Fv1.16.2)
+- **op-geth**: Update to version [v1.101603.5](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101603.5)
 - **L1 Beacon Node**: Ensure your L1 beacon node endpoint can serve all blobs and is configured with the appropriate Fusaka flags before the fork
 
 **Required Actions for Chain Operators**
 
-- **op-batcher**: Update to [v1.16.0](https://github.com/ethereum-optimism/optimism/releases/tag/op-batcher%2Fv1.16.0) with `OP_BATCHER_TXMGR_ENABLE_CELL_PROOFS: true` and restart just after Fusaka activates on L1
+- **op-batcher**: Update to [v1.16.2](https://github.com/ethereum-optimism/optimism/releases/tag/op-batcher%2Fv1.16.2) with `OP_BATCHER_TXMGR_ENABLE_CELL_PROOFS: true` and restart just after Fusaka activates on L1
 
-- **proxyd**: Update to [v4.19.0](https://github.com/ethereum-optimism/infra/releases/tag/proxyd%2Fv4.19.0) or greater (requires whitelisting `eth_blobBaseFee` RPC)
-- **op-challenger**: Update to [v1.6.0](https://github.com/ethereum-optimism/optimism/releases/tag/op-challenger%2Fv1.6.0) if using permissionless fault proofs
+- **proxyd**: Update to [v4.23.0](https://github.com/ethereum-optimism/infra/releases/tag/proxyd%2Fv4.23.0) or greater (requires whitelisting `eth_blobBaseFee` RPC)
+- **op-challenger**: Update to [v1.7.0](https://github.com/ethereum-optimism/optimism/releases/tag/op-challenger%2Fv1.7.0) if using permissionless fault proofs
 
 **Previous Upgrades**
 
@@ -107,14 +107,14 @@ OP_NODE_METRICS_ENABLED=true
 ```yml title="docker-compose.yml"
 services:
   opgeth:
-    image: us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101603.1
+    image: us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101603.5
     env_file: op-geth.env
     volumes:
       - ./op-geth-data:/opt/op-geth/
     network_mode: host
 
   opnode:
-    image: us-docker.pkg.dev/oplabs-tools-artifacts/images/op-node:v1.14.1
+    image: us-docker.pkg.dev/oplabs-tools-artifacts/images/op-node:v1.16.2
     env_file: op-node.env
     command:
       - op-node

docs/docs/docs/gateway/integration.md

@@ -68,6 +68,41 @@ const quote = await gatewaySDK.getQuote({
 });
 ```
 
+### Monetization
+Gateway supports optional affiliate fees, allowing integrators to earn revenue every time users execute Bitcoin onramp or offramp flows through their app.
+You may pass the following two optional fields in your `getQuote` call:
+
+```ts
+/** @description Affiliate-related fee */
+affiliateFeeSats?: bigint;
+
+/** @description The EVM address of the affiliate who will receive the affiliate fee */
+affiliateFeeRecipient?: Address;
+```
+
+Example With Affiliate Fee: 
+
+```ts
+import { parseEther } from 'viem';
+import { parseBtc } from '@gobob/bob-sdk';
+
+const quote = await gatewaySDK.getQuote({
+  fromChain: 'bitcoin',
+  fromToken: 'BTC',
+  fromUserAddress: 'bc1qafk4yhqvj4wep57m62dgrmutldusqde8adh20d',
+  toChain: 'bob',
+  toUserAddress: '0x2D2E86236a5bC1c8a5e5499C517E17Fb88Dbc18c',
+  toToken: 'wBTC',
+  amount: parseBtc("0.1"), // BTC
+  // The amount of ETH to receive (this is subtracted from the amount)
+  gasRefill: parseEther("0.00001"), // ETH
+  // Monetization (optional)
+  affiliateFeeSats: 500n,                  // 500 sats affiliate fee
+  affiliateFeeRecipient: '0xDeaDDEaDDeAdDeAdDEAdDEaddeAddEAdDEAd0001',    // Affiliate / partner EVM address
+});
+```
+
+
 ### Execute the Quote
 
 This locks in the quote, placing a hold on the LP's funds. Internally, this creates a Bitcoin transaction that sends the quoted `amount` of BTC to the LP. This also publishes a hash of the order's parameters in the `OP_RETURN` of the transaction so the Gateway can trustlessly verify the order on BOB. Gateway will broadcast the Bitcoin transaction to the mempool; you can pass the transaction to the SDK without broadcasting from the user's wallet.

docs/docs/docs/reference/token-registry/index.mdx

@@ -2,7 +2,7 @@
 hide_table_of_contents: true
 ---
 
-import tokenListData from '@gobob/tokenlist/token-list.json';
+import tokenListData from '@gobob/tokenlist/tokenlist.json';
 
 # Token Registry
 
@@ -136,7 +136,7 @@ Cross-chain interoperability protocol for select tokens like SolvBTC, xSolvBTC,
 
 ## TokenList Integration
 
-This token registry is automatically generated from our **[token-list.json](https://raw.githubusercontent.com/bob-collective/bob/master/tokenlist/token-list.json)** which follows the [Uniswap Token List Standard](https://tokenlists.org/) with bridge extensions.
+This token registry is automatically generated from our **[tokenlist.json](https://raw.githubusercontent.com/bob-collective/bob/master/tokenlist/tokenlist.json)** which follows the [Uniswap Token List Standard](https://tokenlists.org/) with bridge extensions.
 
 **Total Tokens:** {tokenListData.tokens.length}
 
@@ -165,7 +165,7 @@ Each bridged token includes bridge information in its `extensions.bridge` field:
 ```javascript
 // Fetch the tokenlist
 const response = await fetch(
-  'https://raw.githubusercontent.com/bob-collective/bob/master/tokenlist/token-list.json',
+  'https://raw.githubusercontent.com/bob-collective/bob/master/tokenlist/tokenlist.json',
 );
 const tokenList = await response.json();
 

sdk/.prettierignore

@@ -1,2 +1,3 @@
 dist
 node_modules
+src/assets/