feat(base-sepolia): add support for Base Sepolia network

- Introduced Base Sepolia network definitions across multiple modules, including EVM chains, ERC20 token support, and payment detection.
- Updated contract artifacts to include deployment addresses for Base Sepolia, ensuring compatibility with the new network.
- Enhanced type definitions to recognize Base Sepolia as a valid EVM chain name.

Author: rodrigopavezi

BASE_SEPOLIA_README.md

@@ -0,0 +1,198 @@
+# Base Sepolia Support for Request Network
+
+This directory contains all the changes needed to deploy and use ERC20FeeProxy and ERC20CommerceEscrowWrapper contracts on Base Sepolia testnet.
+
+## Quick Start
+
+### 1. Set up your environment
+
+```bash
+# Set your private key (without 0x prefix)
+export DEPLOYMENT_PRIVATE_KEY=your_private_key_here
+
+# Get Base Sepolia ETH from faucet
+# https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet
+```
+
+### 2. Deploy contracts
+
+```bash
+cd packages/smart-contracts
+
+# Build contracts
+yarn build:sol
+
+# Deploy using helper script
+./scripts/deploy-base-sepolia.sh
+
+# OR deploy directly
+yarn hardhat deploy-erc20-commerce-escrow-wrapper --network base-sepolia
+```
+
+### 3. Update deployed addresses
+
+After deployment, update the contract addresses in:
+
+- `packages/smart-contracts/src/lib/artifacts/ERC20FeeProxy/index.ts`
+- `packages/smart-contracts/src/lib/artifacts/ERC20CommerceEscrowWrapper/index.ts`
+
+### 4. Rebuild packages
+
+```bash
+cd packages/smart-contracts
+yarn build
+```
+
+## Network Details
+
+| Property     | Value                         |
+| ------------ | ----------------------------- |
+| Network Name | Base Sepolia                  |
+| Chain ID     | 84532                         |
+| RPC URL      | https://sepolia.base.org      |
+| Explorer     | https://sepolia.basescan.org/ |
+| Type         | Testnet                       |
+
+## Deployed Contracts
+
+### Official Coinbase Contracts
+
+- **AuthCaptureEscrow**: `0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff`
+
+### Request Network Contracts (to be deployed)
+
+- **ERC20FeeProxy**: Pending deployment
+- **ERC20CommerceEscrowWrapper**: Pending deployment
+
+## Supported Tokens
+
+| Token | Address                                      | Decimals |
+| ----- | -------------------------------------------- | -------- |
+| USDC  | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` | 6        |
+
+## SDK Usage Example
+
+```typescript
+import { RequestNetwork, Types } from '@requestnetwork/request-client.js';
+
+const requestNetwork = new RequestNetwork({
+  nodeConnectionConfig: {
+    baseURL: 'https://sepolia.gateway.request.network/',
+  },
+});
+
+// Create a request on Base Sepolia
+const request = await requestNetwork.createRequest({
+  requestInfo: {
+    currency: {
+      type: Types.RequestLogic.CURRENCY.ERC20,
+      value: '0x036CbD53842c5426634e7929541eC2318f3dCF7e', // USDC
+      network: 'base-sepolia',
+    },
+    expectedAmount: '1000000', // 1 USDC
+    payee: {
+      type: Types.Identity.TYPE.ETHEREUM_ADDRESS,
+      value: '0xPayeeAddress',
+    },
+  },
+  paymentNetwork: {
+    id: Types.Extension.PAYMENT_NETWORK_ID.ERC20_FEE_PROXY_CONTRACT,
+    parameters: {
+      paymentNetworkName: 'base-sepolia',
+      paymentAddress: '0xPayeeAddress',
+    },
+  },
+  signer: yourSigner,
+});
+```
+
+## Files Changed
+
+### Type System
+
+- ✅ `packages/types/src/currency-types.ts` - Added `'base-sepolia'` to EvmChainName
+
+### Currency Package
+
+- ✅ `packages/currency/src/chains/evm/data/base-sepolia.ts` - New chain definition
+- ✅ `packages/currency/src/erc20/chains/base-sepolia.ts` - New token list
+- ✅ `packages/currency/src/chains/evm/index.ts` - Export chain
+- ✅ `packages/currency/src/erc20/chains/index.ts` - Export tokens
+
+### Smart Contracts
+
+- ✅ `packages/smart-contracts/src/lib/artifacts/ERC20FeeProxy/index.ts` - Added deployment config
+- ✅ `packages/smart-contracts/src/lib/artifacts/AuthCaptureEscrow/index.ts` - Added official address
+- ✅ `packages/smart-contracts/src/lib/artifacts/ERC20CommerceEscrowWrapper/index.ts` - Added deployment config
+- ✅ `packages/smart-contracts/hardhat.config.ts` - Already configured ✓
+
+### Payment Detection
+
+- ✅ `packages/payment-detection/src/eth/multichainExplorerApiProvider.ts` - Added network
+
+## Documentation Files
+
+- 📖 **BASE_SEPOLIA_DEPLOYMENT_GUIDE.md** - Complete deployment guide
+- 📖 **BASE_SEPOLIA_CHANGES_SUMMARY.md** - Detailed list of all changes
+- 📖 **BASE_SEPOLIA_README.md** - This file (quick reference)
+
+## Helper Scripts
+
+- 🛠️ **packages/smart-contracts/scripts/deploy-base-sepolia.sh** - Interactive deployment script
+- 🛠️ **packages/smart-contracts/scripts/deploy-erc20-commerce-escrow-wrapper.ts** - Core deployment logic
+- 🛠️ **packages/smart-contracts/scripts/test-base-sepolia-deployment.ts** - Test connection script
+
+## Testing Checklist
+
+- [ ] Fund deployment wallet with Base Sepolia ETH
+- [ ] Deploy ERC20FeeProxy to Base Sepolia
+- [ ] Deploy ERC20CommerceEscrowWrapper to Base Sepolia
+- [ ] Update artifact files with deployed addresses
+- [ ] Rebuild all packages
+- [ ] Create a test request using Base Sepolia USDC
+- [ ] Pay the test request
+- [ ] Verify payment is detected correctly
+- [ ] Test commerce escrow flow
+
+## Troubleshooting
+
+### Insufficient funds
+
+Get Base Sepolia ETH from: https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet
+
+### RPC connection issues
+
+Try alternative RPC: `https://base-sepolia-rpc.publicnode.com`
+
+### Contract verification failed
+
+Manually verify on Basescan:
+
+```bash
+yarn hardhat verify --network base-sepolia <CONTRACT_ADDRESS> <CONSTRUCTOR_ARGS>
+```
+
+### Linting errors
+
+Run linter:
+
+```bash
+yarn lint
+```
+
+## Resources
+
+- [Base Documentation](https://docs.base.org/)
+- [Request Network Documentation](https://docs.request.network/)
+- [Coinbase Commerce Payments](https://github.com/base/commerce-payments)
+- [Base Sepolia Faucet](https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet)
+- [Base Sepolia Explorer](https://sepolia.basescan.org/)
+
+## Support
+
+- Request Network Discord: https://discord.gg/requestnetwork
+- GitHub Issues: https://github.com/RequestNetwork/requestNetwork/issues
+
+## License
+
+MIT

packages/currency/src/chains/evm/data/base-sepolia.ts

@@ -0,0 +1,8 @@
+import { CurrencyTypes } from '@requestnetwork/types';
+import { supportedBaseSepoliaERC20 } from '../../../erc20/chains/base-sepolia';
+
+export const chainId = 84532;
+export const testnet = true;
+export const currencies: CurrencyTypes.TokenMap = {
+  ...supportedBaseSepoliaERC20,
+};

packages/currency/src/chains/evm/index.ts

@@ -28,6 +28,7 @@ import * as SepoliaDefinition from './data/sepolia';
 import * as ZkSyncEraTestnetDefinition from './data/zksync-era-testnet';
 import * as ZkSyncEraDefinition from './data/zksync-era';
 import * as BaseDefinition from './data/base';
+import * as BaseSepoliaDefinition from './data/base-sepolia';
 import * as SonicDefinition from './data/sonic';
 
 export type EvmChain = CurrencyTypes.Chain & {
@@ -63,5 +64,6 @@ export const chains: Record<CurrencyTypes.EvmChainName, EvmChain> = {
   zksynceratestnet: ZkSyncEraTestnetDefinition,
   zksyncera: ZkSyncEraDefinition,
   base: BaseDefinition,
+  'base-sepolia': BaseSepoliaDefinition,
   sonic: SonicDefinition,
 };

packages/currency/src/erc20/chains/base-sepolia.ts

@@ -0,0 +1,12 @@
+import { CurrencyTypes } from '@requestnetwork/types';
+
+// List of the supported base sepolia testnet tokens
+export const supportedBaseSepoliaERC20: CurrencyTypes.TokenMap = {
+  // USDC on Base Sepolia
+  '0x036CbD53842c5426634e7929541eC2318f3dCF7e': {
+    name: 'USD Coin',
+    symbol: 'USDC',
+    decimals: 6,
+  },
+  // Add more tokens as needed for testing on Base Sepolia
+};

packages/currency/src/erc20/chains/index.ts

@@ -13,6 +13,7 @@ import { supportedOptimismERC20 } from './optimism';
 import { supportedRinkebyERC20 } from './rinkeby';
 import { supportedXDAIERC20 } from './xdai';
 import { supportedSepoliaERC20 } from './sepolia';
+import { supportedBaseSepoliaERC20 } from './base-sepolia';
 
 export const supportedNetworks: Partial<
   Record<CurrencyTypes.EvmChainName, CurrencyTypes.TokenMap>
@@ -31,4 +32,5 @@ export const supportedNetworks: Partial<
   optimism: supportedOptimismERC20,
   moonbeam: supportedMoonbeamERC20,
   sepolia: supportedSepoliaERC20,
+  'base-sepolia': supportedBaseSepoliaERC20,
 };

packages/payment-detection/src/eth/multichainExplorerApiProvider.ts

@@ -17,6 +17,7 @@ const networks: Record<string, ethers.providers.Network> = {
   core: { chainId: 1116, name: 'core' },
   zksynceratestnet: { chainId: 280, name: 'zksynceratestnet' },
   zksyncera: { chainId: 324, name: 'zksyncera' },
+  'base-sepolia': { chainId: 84532, name: 'base-sepolia' },
   sonic: { chainId: 146, name: 'sonic' },
 };
 

packages/smart-contracts/scripts/deploy-base-sepolia.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+
+# Base Sepolia Deployment Script
+# This script helps deploy ERC20FeeProxy and ERC20CommerceEscrowWrapper to Base Sepolia
+
+set -e  # Exit on error
+
+echo "╔═══════════════════════════════════════════════════════════╗"
+echo "║   Base Sepolia Deployment Helper Script                  ║"
+echo "║   Request Network - ERC20 Commerce Escrow Wrapper        ║"
+echo "╚═══════════════════════════════════════════════════════════╝"
+echo ""
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Load .env file if it exists
+if [ -f .env ]; then
+    echo -e "${BLUE}Loading .env file...${NC}"
+    export $(cat .env | grep -v '^#' | grep -v '^$' | xargs)
+    echo ""
+fi
+
+# Check if private key is set
+if [ -z "$DEPLOYMENT_PRIVATE_KEY" ] && [ -z "$ADMIN_PRIVATE_KEY" ]; then
+    echo -e "${RED}❌ Error: No private key found!${NC}"
+    echo ""
+    echo "Please set either DEPLOYMENT_PRIVATE_KEY or ADMIN_PRIVATE_KEY environment variable:"
+    echo ""
+    echo -e "${YELLOW}export DEPLOYMENT_PRIVATE_KEY=your_private_key_here${NC}"
+    echo ""
+    echo "OR"
+    echo ""
+    echo -e "${YELLOW}export ADMIN_PRIVATE_KEY=your_private_key_here${NC}"
+    echo ""
+    echo "⚠️  Make sure to fund your wallet with Base Sepolia ETH:"
+    echo "   https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet"
+    exit 1
+fi
+
+echo -e "${GREEN}✓${NC} Private key found"
+echo ""
+
+# Network information
+echo -e "${BLUE}Network Information:${NC}"
+echo "  Name:      Base Sepolia"
+echo "  Chain ID:  84532"
+echo "  RPC URL:   https://sepolia.base.org"
+echo "  Explorer:  https://sepolia.basescan.org/"
+echo ""
+
+# Check if contracts are built
+if [ ! -d "build" ]; then
+    echo -e "${YELLOW}⚠️  Contracts not built. Building now...${NC}"
+    yarn build:sol
+    echo ""
+fi
+
+echo -e "${BLUE}Deployment Plan:${NC}"
+echo "  1. Deploy ERC20FeeProxy"
+echo "  2. Use official AuthCaptureEscrow: 0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff"
+echo "  3. Deploy ERC20CommerceEscrowWrapper"
+echo ""
+
+# Ask for confirmation
+read -p "Do you want to proceed with deployment? (y/n) " -n 1 -r
+echo ""
+
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo -e "${YELLOW}Deployment cancelled.${NC}"
+    exit 0
+fi
+
+echo ""
+echo -e "${GREEN}Starting deployment...${NC}"
+echo ""
+
+# Run deployment
+yarn hardhat deploy-erc20-commerce-escrow-wrapper --network base-sepolia
+
+echo ""
+echo -e "${GREEN}╔═══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║   Deployment Complete!                                    ║${NC}"
+echo -e "${GREEN}╚═══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+echo -e "${YELLOW}📝 Next Steps:${NC}"
+echo ""
+echo "1. Update the deployed addresses in these files:"
+echo "   - packages/smart-contracts/src/lib/artifacts/ERC20FeeProxy/index.ts"
+echo "   - packages/smart-contracts/src/lib/artifacts/ERC20CommerceEscrowWrapper/index.ts"
+echo ""
+echo "2. Rebuild the packages:"
+echo "   cd packages/smart-contracts && yarn build"
+echo ""
+echo "3. Verify contracts were verified on Basescan:"
+echo "   https://sepolia.basescan.org/"
+echo ""
+echo -e "${BLUE}ℹ️  For more information, see BASE_SEPOLIA_DEPLOYMENT_GUIDE.md${NC}"
+echo ""
+