alchemy-upgrade-migration

# Alchemy Upgrade & Migration ## Overview Migration guide for Alchemy SDK upgrades and deprecated package transitions. The `alchemy-web3` package is deprecated — migrate to `alchemy-sdk`. ## Migration Paths | From | To | Complexity | |------|----|-----------| | `alchemy-web3` | `alchemy-sdk` | High (different API surface) | | `alchemy-sdk` v2 → v3 | `alchemy-sdk` v3 | Medium (some breaking changes) | | Direct JSON-RPC | `alchemy-sdk` | Low (SDK wraps same methods) | ## Instructions ### Step 1: Migrate from alchemy-web3 to alchemy-sdk ```typescript // BEFORE: alchemy-web3 (DEPRECATED) // import { createAlchemyWeb3 } from '@alch/alchemy-web3'; // const web3 = createAlchemyWeb3(`https://eth-mainnet.g.alchemy.com/v2/${apiKey}`); // const balance = await web3.eth.getBalance(address); // const nfts = await web3.alchemy.getNfts({ owner }); // AFTER: alchemy-sdk import { Alchemy, Network } from 'alchemy-sdk'; const alchemy = new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.ETH_MAINNET, }); // Core methods — same JSON-RPC, different API const balance = await alchemy.core.getBalance(address); // Enhanced APIs — reorganized under namespaces const nfts = await alchemy.nft.getNftsForOwner(owner); // WebSockets — now under alchemy.ws alchemy.ws.on({ method: 'eth_subscribe', params: ['newHeads'] }, (block) => { console.log('New block:', block); }); ``` ### Step 2: API Surface Changes ```typescript // Key namespace changes in alchemy-sdk: // Core (JSON...