Wallet local con Anvil

# Lab: Ethereum local con Anvil, wallet y primera transacción

SemVer: `1.0.51-alpha.1`

Este archivo acompaña la página pública `/labs/ethereum-local-anvil-wallet`. La regla del lab es simple: mirar una transición de estado local antes/después y guardar evidencia verificable.

## Límite de seguridad

- Red local con Anvil.
- Sin private keys reales.
- Sin RPC de mainnet.
- Sin testnets con fondos.
- Sin seed phrases personales.

## Preflight

```bash
node tools/labs/ethereum-local-anvil-wallet/preflight.mjs
```

Debe confirmar:

- `anvil` disponible;
- `cast` disponible;
- puerto `8545` libre;
- no hay variables obvias con secretos reales.

## Terminal A: cadena local

```bash
anvil --host 127.0.0.1 --port 8545 --chain-id 31337
```

## Terminal B: lectura inicial

PowerShell:

```powershell
$env:RPC_URL="http://127.0.0.1:8545"
$env:FROM="0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266"
$env:TO="0x70997970c51812dc3a010c7d01b50e0d17dc79c8"

cast chain-id --rpc-url $env:RPC_URL
cast block-number --rpc-url $env:RPC_URL
cast balance $env:FROM --ether --rpc-url $env:RPC_URL
cast balance $env:TO --ether --rpc-url $env:RPC_URL
cast nonce $env:FROM --rpc-url $env:RPC_URL
```

Bash:

```bash
export RPC_URL="http://127.0.0.1:8545"
export FROM="0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266"
export TO="0x70997970c51812dc3a010c7d01b50e0d17dc79c8"

cast chain-id --rpc-url $RPC_URL
cast block-number --rpc-url $RPC_URL
cast balance $FROM --ether --rpc-url $RPC_URL
cast balance $TO --ether --rpc-url $RPC_URL
cast nonce $FROM --rpc-url $RPC_URL
```

## Enviar transferencia

```powershell
cast send $env:TO --value 1ether --from $env:FROM --unlocked --rpc-url $env:RPC_URL
```

En Bash el comando es el mismo con `$TO`, `$FROM` y `$RPC_URL`. Guarda el `transactionHash`.

## Validar

```powershell
cast receipt <TX_HASH> status --rpc-url $env:RPC_URL
cast receipt <TX_HASH> gasUsed --rpc-url $env:RPC_URL
cast balance $env:FROM --ether --rpc-url $env:RPC_URL
cast balance $env:TO --ether --rpc-url $env:RPC_URL
cast nonce $env:FROM --rpc-url $env:RPC_URL
```

## Reporte mínimo

```markdown
# Lab: Anvil wallet

- chainId:
- from:
- to:
- nonce antes/después:
- balance antes/después:
- tx hash:
- receipt status:
- observación:
- cleanup realizado:
```

## Cleanup

PowerShell:

```powershell
Remove-Item Env:RPC_URL, Env:FROM, Env:TO -ErrorAction SilentlyContinue
```

Bash:

```bash
unset RPC_URL FROM TO
```

Detén Anvil con `Ctrl+C`.

#!/usr/bin/env node
import { spawnSync } from 'node:child_process';
import { createServer } from 'node:net';

const checks = [];

function commandExists(command, args = ['--version']) {
  const result = spawnSync(command, args, {
    encoding: 'utf8',
    shell: process.platform === 'win32',
  });

  return {
    ok: result.status === 0,
    output: `${result.stdout ?? ''}${result.stderr ?? ''}`.trim().split(/\r?\n/)[0] ?? '',
  };
}

function checkPort(port) {
  return new Promise((resolve) => {
    const server = createServer();
    server.once('error', () => resolve(false));
    server.once('listening', () => {
      server.close(() => resolve(true));
    });
    server.listen(port, '127.0.0.1');
  });
}

const anvil = commandExists('anvil');
checks.push({
  label: 'anvil disponible',
  ok: anvil.ok,
  detail: anvil.output || 'No se pudo ejecutar anvil --version',
});

const cast = commandExists('cast');
checks.push({
  label: 'cast disponible',
  ok: cast.ok,
  detail: cast.output || 'No se pudo ejecutar cast --version',
});

const portFree = await checkPort(8545);
checks.push({
  label: 'puerto 8545 libre',
  ok: portFree,
  detail: portFree ? '127.0.0.1:8545 está libre' : '127.0.0.1:8545 ya está ocupado',
});

const suspiciousEnv = ['PRIVATE_KEY', 'MNEMONIC', 'SEED_PHRASE'].filter((key) => process.env[key]);
checks.push({
  label: 'sin secretos reales obvios en entorno',
  ok: suspiciousEnv.length === 0,
  detail:
    suspiciousEnv.length === 0
      ? 'No se detectaron variables PRIVATE_KEY, MNEMONIC o SEED_PHRASE'
      : `Revisa estas variables antes del lab: ${suspiciousEnv.join(', ')}`,
});

console.log('TrautsLab Ethereum local lab preflight\n');
for (const check of checks) {
  console.log(`${check.ok ? '✓' : '✗'} ${check.label}`);
  console.log(`  ${check.detail}`);
}

const failures = checks.filter((check) => !check.ok);
if (failures.length > 0) {
  console.log('\nPreflight con bloqueantes. Corrige lo marcado antes de iniciar Anvil.');
  process.exit(1);
}

console.log('\nPreflight OK. Puedes iniciar: anvil --host 127.0.0.1 --port 8545 --chain-id 31337');

unset RPC_URL FROM TO