chore: separate blockchain api to a package

packages/appkit/src/client/appkit-base-client.ts

@@ -222,6 +222,7 @@ export abstract class AppKitBaseClient {
     OptionsController.setDisableAppend(options.disableAppend)
     OptionsController.setEnableEmbedded(options.enableEmbedded)
     OptionsController.setSIWX(options.siwx)
+    BlockchainApiController.initializeClient()
 
     if (!options.projectId) {
       AlertController.open(ErrorUtil.ALERT_ERRORS.PROJECT_ID_NOT_CONFIGURED, 'error')
@@ -358,7 +359,7 @@ export abstract class AppKitBaseClient {
         const result = await adapter.connectWalletConnect(chainId)
 
         this.close()
-        this.setClientId(result?.clientId || null)
+        this.setClientId(result?.clientId)
         StorageUtil.setConnectedNamespaces([...ChainController.state.chains.keys()])
         this.chainNamespaces.forEach(namespace => {
           ConnectorController.setConnectorId(

packages/blockchain-api/README.md

@@ -0,0 +1,205 @@
+# @reown/blockchain-api
+
+A client library for interacting with the WalletConnect Blockchain API.
+
+## Installation
+
+```bash
+npm install @reown/blockchain-api
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { BlockchainApiClient } from '@reown/blockchain-api'
+
+// Create a client
+const client = new BlockchainApiClient({
+  projectId: 'YOUR_PROJECT_ID',
+  sdkType: 'web-app',
+  sdkVersion: '1.0.0'
+})
+
+// Get supported networks
+const supportedNetworks = await client.getSupportedNetworks()
+
+// Get account balance
+const balance = await client.getBalance('0x123...', '1') // address, chainId
+```
+
+### Advanced Configuration
+
+You can configure the client with additional options:
+
+```typescript
+import { BLOCKCHAIN_API_URL, BlockchainApiClient } from '@reown/blockchain-api'
+
+const client = new BlockchainApiClient({
+  baseUrl: BLOCKCHAIN_API_URL, // Defaults to 'https://rpc.walletconnect.org'
+  projectId: 'YOUR_PROJECT_ID',
+  clientId: 'YOUR_CLIENT_ID', // Optional
+  sdkType: 'web-app',
+  sdkVersion: '1.0.0'
+})
+
+// Update configuration later
+client.setProjectId('NEW_PROJECT_ID')
+client.setClientId('NEW_CLIENT_ID')
+client.setSdkType('mobile-app')
+client.setSdkVersion('1.1.0')
+```
+
+## Features
+
+### Account Information
+
+```typescript
+// Get account identity
+const identity = await client.fetchIdentity({
+  address: '0x123...',
+  caipNetworkId: 'eip155:1',
+  sender: '0x456...' // Optional
+})
+
+// Get account transactions
+const transactions = await client.fetchTransactions({
+  account: '0x123...',
+  chainId: '1',
+  cursor: 'next_page_cursor' // Optional, for pagination
+})
+
+// Get account balance
+const balance = await client.getBalance('0x123...', '1')
+```
+
+### Token Swaps
+
+```typescript
+// Get available tokens for swapping
+const tokens = await client.fetchSwapTokens({ chainId: '1' })
+
+// Get token prices
+const prices = await client.fetchTokenPrice({
+  addresses: ['0x123...', '0x456...']
+})
+
+// Get swap quote
+const quote = await client.fetchSwapQuote({
+  amount: '1000000000000000000', // 1 ETH in wei
+  userAddress: '0x123...',
+  from: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee', // ETH
+  to: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' // USDC
+})
+
+// Check token allowance
+const allowance = await client.fetchSwapAllowance({
+  tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+  userAddress: '0x123...'
+})
+
+// Generate approve calldata
+const approveCalldata = await client.generateApproveCalldata({
+  userAddress: '0x123...',
+  from: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+  to: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'
+})
+
+// Generate swap calldata
+const swapCalldata = await client.generateSwapCalldata({
+  amount: '1000000000000000000',
+  userAddress: '0x123...',
+  from: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee',
+  to: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
+})
+```
+
+### ENS
+
+```typescript
+// Lookup ENS name
+const ensInfo = await client.lookupEnsName('vitalik.eth')
+
+// Reverse lookup ENS name
+const ensNames = await client.reverseLookupEnsName({
+  address: '0x123...',
+  sender: '0x456...' // Optional
+})
+
+// Get name suggestions
+const suggestions = await client.getEnsNameSuggestions('vitalik')
+
+// Register ENS name
+const registration = await client.registerEnsName({
+  coinType: 60, // ETH
+  address: '0x123...',
+  message: 'Message to sign',
+  signature: '0x456...'
+})
+```
+
+### On-ramp
+
+```typescript
+// Get on-ramp options
+const options = await client.getOnrampOptions()
+
+// Get on-ramp quote
+const quote = await client.getOnrampQuote({
+  purchaseCurrency: { id: 'ETH', symbol: 'ETH' },
+  paymentCurrency: { id: 'USD' },
+  amount: '100',
+  network: 'ethereum'
+})
+
+// Generate on-ramp URL
+const url = await client.generateOnRampURL({
+  destinationWallets: [{ address: '0x123...', blockchains: ['ethereum'] }],
+  partnerUserId: 'user123',
+  defaultNetwork: 'ethereum',
+  purchaseAmount: '0.1', // Optional
+  paymentAmount: '100' // Optional
+})
+```
+
+### Smart Sessions
+
+```typescript
+// Get smart sessions
+const sessions = await client.getSmartSessions('eip155:1:0x123...')
+
+// Revoke smart session
+const revocation = await client.revokeSmartSession('0x123...', 'pci_value', 'signature_value')
+```
+
+## Utility Functions
+
+```typescript
+import {
+  formatAddress,
+  formatCaipAddress,
+  getChainIdFromCaipAddress,
+  getPlainAddress
+} from '@reown/blockchain-api'
+
+// Extract plain address from CAIP format
+const address = getPlainAddress('eip155:1:0x123...')
+// Result: '0x123...'
+
+// Get chain ID from CAIP address
+const chainId = getChainIdFromCaipAddress('eip155:1:0x123...')
+// Result: '1'
+
+// Format CAIP address
+const caipAddress = formatCaipAddress('0x123...', 'eip155', '1')
+// Result: 'eip155:1:0x123...'
+
+// Format address for display
+const displayAddress = formatAddress('0x1234567890abcdef1234567890abcdef12345678')
+// Result: '0x1234...5678'
+```
+
+## License
+
+MIT

packages/blockchain-api/exports/index.ts

@@ -0,0 +1,51 @@
+// Export main client
+export { BlockchainApiClient } from '../src/api/BlockchainApiClient.js'
+
+// Export utils
+export { FetchUtil } from '../src/utils/FetchUtil.js'
+
+// Export constants
+export { BLOCKCHAIN_API_URL, CACHE_EXPIRY } from '../src/utils/constants.js'
+
+// Export types
+export type {
+  // Client types
+  BlockchainApiClientConfig,
+  RequestArgs,
+  PostRequestArgs,
+
+  // API Request/Response types
+  BlockchainApiIdentityRequest,
+  BlockchainApiIdentityResponse,
+  BlockchainApiTransactionsRequest,
+  BlockchainApiTransactionsResponse,
+  BlockchainApiSwapQuoteRequest,
+  BlockchainApiSwapQuoteResponse,
+  BlockchainApiSwapTokensRequest,
+  BlockchainApiSwapTokensResponse,
+  BlockchainApiTokenPriceRequest,
+  BlockchainApiTokenPriceResponse,
+  BlockchainApiSwapAllowanceRequest,
+  BlockchainApiSwapAllowanceResponse,
+  BlockchainApiGasPriceRequest,
+  BlockchainApiGasPriceResponse,
+  BlockchainApiGenerateSwapCalldataRequest,
+  BlockchainApiGenerateSwapCalldataResponse,
+  BlockchainApiGenerateApproveCalldataRequest,
+  BlockchainApiGenerateApproveCalldataResponse,
+  BlockchainApiBalanceResponse,
+  BlockchainApiLookupEnsName,
+  BlockchainApiRegisterNameParams,
+  BlockchainApiSuggestionResponse,
+  BaseError,
+  BlockchainApiEnsError,
+  GenerateOnRampUrlArgs,
+  GetQuoteArgs,
+  OnrampQuote,
+  PaymentCurrency,
+  PurchaseCurrency,
+  ReownName,
+  SmartSessionResponse,
+  SwapToken,
+  SwapTokenWithBalance
+} from '../src/types/index.js'

packages/blockchain-api/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@reown/appkit-blockchain-api",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/esm/exports/index.js",
+  "types": "./dist/types/exports/index.d.ts",
+  "files": [
+    "dist",
+    "!tsconfig.tsbuildinfo"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "watch": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix",
+    "test": "vitest run --dir tests --coverage.enabled=true --coverage.reporter=json --coverage.reporter=json-summary --coverage.reportOnFailure=true"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types/exports/index.d.ts",
+      "import": "./dist/esm/exports/index.js",
+      "default": "./dist/esm/exports/index.js"
+    }
+  },
+  "dependencies": {
+    "@reown/appkit-common": "*"
+  },
+  "devDependencies": {
+    "vitest": "2.1.9"
+  },
+  "author": "Reown <[email protected]> (https://reown.com)",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/reown-com/appkit",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reown-com/appkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/reown-com/appkit/issues"
+  },
+  "keywords": [
+    "appkit",
+    "wallet",
+    "onboarding",
+    "reown",
+    "dapps",
+    "web3",
+    "wagmi",
+    "ethereum",
+    "solana",
+    "bitcoin"
+  ]
+}