📖 Recetario Visual Paso a Paso (Guía Anti-Fricción)

Palabras Clave: let, var, const, usar, imprimir, si / sino, mientras, retornar.
Tipos de Datos: numero, texto, ia_var, nube_var, billetera.
Operadores Matemáticos: +, -, *, /, % (evaluados por precedencia formal recursiva).

// Código Fuente Camaleón 6GL (Ejecutable en RAM)
let edad = 25;
let edadFutura = edad + (10 * 2);
imprimir("Edad en dos décadas: " + edadFutura);

// O mediante Síntesis Neuronal Directa:
// "crear variable total con 10 + 15 * 2"

Capacidades: Tipado estricto (declare(strict_types=1);), Prepared Statements obligatorios en PDO, tokens CSRF, passwords en BCrypt/Argon2id y variables de entorno aisladas.

declare(strict_types=1);
// Consulta Segura PDO (Cero Concatenación)
$stmt = $pdo->prepare("SELECT id, usuario, rol FROM usuarios_admin WHERE LOWER(wallet) = LOWER(:w)");
$stmt->execute([':w' => $walletUsuario]);
$usuario = $stmt->fetch(PDO::FETCH_ASSOC);

// Verificación CSRF
if (!hash_equals($_SESSION['csrf_token'] ?? '', $_POST['csrf_token'] ?? '')) {
    http_response_code(403);
    exit('Token CSRF Inválido.');
}

Principio Inquebrantable: La clave privada jamás viaja ni se almacena en el servidor. La firma criptográfica ocurre 100% en el cliente vía MetaMask (EIP-1193).

// Ethers.js v6: Transacción Segura en el Cliente
import { ethers } from "ethers";

const provider = new ethers.BrowserProvider(window.ethereum);
const signer = await provider.getSigner();
const contrato = new ethers.Contract(CONTRACT_ADDRESS, ABI, signer);

try {
    const tx = await contrato.comprarProducto(productoId, {
        value: ethers.parseEther("0.025")
    });
    await tx.wait(1); // Esperar 1 confirmación de bloque
} catch (error) {
    if (error.code === "ACTION_REJECTED") {
        console.warn("Firma rechazada por el usuario en MetaMask.");
    }
}

Reglas de Auditoría: Aplicación estricta de Checks-Effects-Interactions (CEI) y Custom Errors para ahorro de gas.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

error SaldoInsuficiente(uint256 solicitado, uint256 disponible);

contract TiendaSoberana {
    mapping(address => uint256) public balances;

    function retirar(uint256 monto) external {
        // 1. CHECKS: Validación de fondos
        if (monto > balances[msg.sender]) {
            revert SaldoInsuficiente(monto, balances[msg.sender]);
        }
        // 2. EFFECTS: Actualización de estado interno antes de enviar
        balances[msg.sender] -= monto;

        // 3. INTERACTIONS: Transferencia externa segura
        (bool ok, ) = payable(msg.sender).call{value: monto}("");
        require(ok, "Fallo transferencia ETH");
    }
}

Patrón Enterprise: Separación estricta entre Controller, Service, Repository y DTOs, con control de acceso por roles (RBAC).

@RestController
@RequestMapping("/api/v1/contratos")
public class ContratoWeb3Controller {

    private final ContratoService contratoService;

    public ContratoWeb3Controller(ContratoService contratoService) {
        this.contratoService = contratoService;
    }

    @PostMapping("/desplegar")
    @PreAuthorize("hasRole('ADMIN')")
    public ResponseEntity desplegar(@RequestBody DespliegueRequestDTO dto) {
        return ResponseEntity.ok(contratoService.procesarDespliegue(dto));
    }
}