arbitrum-plug

Mini starter en TypeScript + ethers v6 para jugar en Arbitrum One.
En corto: conecta a la red y lee balances ERC-20 de una wallet. Ligero, directo y listo para que agregues

Objetivo: que devs nuevos o intermedios puedan arrancar rápido en Arbitrum sin pelearse con ESM/TS.

¿Qué incluye?

• src/connectArbitrum.ts → ping a Arbitrum: último bloque y tarifas (gas).
• src/erc20Balances.ts → lee símbolo, decimales y balance de varios ERC-20 comunes (USDC, USDT, WETH, ARB, DAI).
• Config ESM “moderna” (NodeNext) que sí se lleva bien con ethers v6.
• Uso de dotenv para variables de entorno y tsx para ejecutar TS sin dolor.

Requisitos

• Node 18+
• Yarn
• (Dev) typescript, tsx, ts-node, @types/node
• (Runtime) ethers, dotenv

Instalación rápida

git clone <tu-repo> arbitrum-plug
cd arbitrum-plug

# instala deps
yarn

# (si te falta) instala el runner TS/ESM
yarn add -D tsx

Crea tu .env

# archivo .env (no lo subas a git)
FROM_ADDRESS=0xTuDireccion

Agrega estos scripts a package.json (si no están)

{
  "type": "module",
  "scripts": {
    "dev:connect": "tsx src/connectArbitrum.ts",
    "dev:balances": "tsx src/erc20Balances.ts",
    "typecheck": "tsc --noEmit"
  }
}

Corre

yarn dev:connect    # info de red (bloque / fees)
yarn dev:balances   # balances ERC-20 de FROM_ADDRESS