@contractjs/erc20/README.md

A TypeScript utility library for ERC20 contracts.

@contractjs/erc20   

A lightweight library for reading and writing to ERC20 tokens, with multi-chain read support.

## Installation

```bash
npm install @contractjs/erc20
# or
yarn add @contractjs/erc20
# or
pnpm add @contractjs/erc20
```

## Usage

```typescript
import { balanceOfMultichain, addressOf } from '@contractjs/erc20'
import { arbitrum, polygon } from 'viem/chains'

const accountAddress = '0x...'
const chains = [arbitrum, polygon]
const USDC_ADDRESSES = [addressOf('USDC').onChain(arbitrum), addressOf('USDC').onChain(polygon)]
const crossChainBalance = await balanceOfMultichain(accountAddress, USDC_ADDRESSES, chains)
...
 const balanceInUSD = await getBalanceValueInUSD(addressOf('USDC').onChain(arbitrum), 6, crossChainBalance, publicClient)
```