@panal/sdk 0.18.0 → 0.18.2

package/dist/client.d.ts

@@ -129,6 +129,30 @@ export declare class PanalClient {
     constructor(options?: PanalClientOptions);
     /** El wallet client, o un error que dice exactamente qué falta. */
     private wallet;
+    /**
+     * Comprueba ANTES de firmar que la wallet cubre lo que Monad va a reservar.
+     *
+     * Monad bloquea `gas_limit × maxFeePerGas` antes de ejecutar, aunque luego
+     * cobre bastante menos: darse de alta estima ~264.000 de gas, que a 122 gwei
+     * son 0,032 MON de reserva (medido el 2026-09-14). Con menos, el nodo
+     * rechaza la transacción con «Signer had insufficient balance» y viem lo
+     * presenta como un revert del contrato, que no llegó a ejecutarse. Y hay una
+     * segunda trampa: reintentar tras recargar con el mismo nonce y las mismas
+     * comisiones firma una transacción idéntica, y el nodo repite el rechazo sin
+     * volver a mirar el saldo.
+     *
+     * Si no se puede estimar —RPC caído, o una llamada que el contrato rechazaría
+     * por otro motivo— no se bloquea nada: que hable el error de verdad.
+     */
+    private comprobarReserva;
+    /**
+     * Espera el recibo y comprueba que la transacción SALIÓ BIEN.
+     *
+     * Esperar el recibo no basta: un revert también llega con recibo. Sin mirar
+     * `status`, una transacción que gastó gas y no cambió nada volvía como si
+     * todo hubiera ido bien.
+     */
+    private esperarExito;
     /** Todos los agentes del registry, activos e inactivos. */
     listAgents(): Promise<Agent[]>;
     /**
@@ -412,7 +436,18 @@ export declare class PanalClient {
      * ya están desplegados sin obligarles a actualizarse.
      */
     private x402Endpoint;
-    /** Retira lo acreditado en una moneda (patrón pull payment). */
+    /**
+     * Retira lo acreditado en una moneda (patrón pull payment).
+     *
+     * EL GAS VA FIJADO A MANO, y no es un detalle. viem no estima: le pide al nodo
+     * que rellene la transacción (`eth_fillTransaction`), y el de Monad devuelve
+     * un gas disparatado para retirar MON —1,05 M para una wallet, 10,7 M para
+     * otra— cuando lo necesario son 55.157. Monad cobra el LÍMITE entero, no lo
+     * usado: una retirada de 1,092 MON pagó 1,096 MON de gas (2026-09-14, tx
+     * 0xa960cb7e…). El gas sale de `eth_estimateGas`, que da el número bueno, con
+     * un 10 % de margen; y si la estimación vuelve por encima de `TOPE_GAS_RETIRADA`
+     * no se firma nada.
+     */
     withdraw(currency?: Address): Promise<Hex>;
     /** Comprueba el saldo antes de firmar, para fallar con un mensaje legible. */
     private assertFunds;

package/dist/client.js

@@ -24,6 +24,11 @@ import { descend, newEnvelope, remainingBudget } from './envelope.js';
 import { NATIVE_CURRENCY, addressesFor, chainFor } from './chains.js';
 import { BUZON_URL, TABLON, VENTANA_FIRMA_S, encargoSignMessage, entregaSignMessage, ofertaSignMessage, } from './tablon.js';
 import { TaskStatus, formatAgentMetadata, parseAgentMetadata, } from './types.js';
+/**
+ * Por encima de esto una retirada no se firma: retirar MON son 55.157 de gas y
+ * $PANAL 103.511. Ver `withdraw()` para lo que pasó sin este tope.
+ */
+const TOPE_GAS_RETIRADA = 300000n;
 /** Cuántos agentes se leen por llamada al registry. */
 const REGISTRY_PAGE = 50n;
 /** Tope duro de agentes recorridos, por si el registro crece mucho. */
@@ -126,6 +131,55 @@ export class PanalClient {
         }
         return this.walletClient;
     }
+    /**
+     * Comprueba ANTES de firmar que la wallet cubre lo que Monad va a reservar.
+     *
+     * Monad bloquea `gas_limit × maxFeePerGas` antes de ejecutar, aunque luego
+     * cobre bastante menos: darse de alta estima ~264.000 de gas, que a 122 gwei
+     * son 0,032 MON de reserva (medido el 2026-09-14). Con menos, el nodo
+     * rechaza la transacción con «Signer had insufficient balance» y viem lo
+     * presenta como un revert del contrato, que no llegó a ejecutarse. Y hay una
+     * segunda trampa: reintentar tras recargar con el mismo nonce y las mismas
+     * comisiones firma una transacción idéntica, y el nodo repite el rechazo sin
+     * volver a mirar el saldo.
+     *
+     * Si no se puede estimar —RPC caído, o una llamada que el contrato rechazaría
+     * por otro motivo— no se bloquea nada: que hable el error de verdad.
+     */
+    async comprobarReserva(que, llamada) {
+        let gas;
+        let maxFeePerGas;
+        let saldo;
+        try {
+            [gas, { maxFeePerGas }, saldo] = await Promise.all([
+                this.publicClient.estimateContractGas({ ...llamada, account: this.account }),
+                this.publicClient.estimateFeesPerGas(),
+                this.publicClient.getBalance({ address: this.account.address }),
+            ]);
+        }
+        catch {
+            return;
+        }
+        const reserva = gas * maxFeePerGas + (llamada.value ?? 0n);
+        if (saldo < reserva) {
+            throw new Error(`${que}: Monad reserva ${formatEther(reserva)} MON por adelantado (límite de gas × precio máximo), ` +
+                `aunque luego cobre menos. ${this.account.address} tiene ${formatEther(saldo)} MON: ` +
+                `faltan ${formatEther(reserva - saldo)} MON. No se ha enviado nada.`);
+        }
+    }
+    /**
+     * Espera el recibo y comprueba que la transacción SALIÓ BIEN.
+     *
+     * Esperar el recibo no basta: un revert también llega con recibo. Sin mirar
+     * `status`, una transacción que gastó gas y no cambió nada volvía como si
+     * todo hubiera ido bien.
+     */
+    async esperarExito(hash, que) {
+        const recibo = await this.publicClient.waitForTransactionReceipt({ hash });
+        if (recibo.status !== 'success') {
+            throw new Error(`${que} revirtió (tx ${hash}): se cobró el gas y no cambió nada.`);
+        }
+    }
     // -------------------------------------------------------------------------
     // Lectura
     // -------------------------------------------------------------------------
@@ -526,15 +580,21 @@ export class PanalClient {
      */
     async registerAgent(params) {
         const wallet = this.wallet();
-        const hash = await wallet.writeContract({
+        const llamada = {
             address: this.addresses.registry,
             abi: registryAbi,
             functionName: 'registerAgent',
             args: [formatAgentMetadata(params.metadata), params.pricePerTask, params.currency ?? NATIVE_CURRENCY],
+        };
+        await this.comprobarReserva('No se puede dar de alta', llamada);
+        const hash = await wallet.writeContract({
+            ...llamada,
+            abi: registryAbi,
+            functionName: 'registerAgent',
             chain: chainFor(this.network),
             account: this.account,
         });
-        await this.publicClient.waitForTransactionReceipt({ hash });
+        await this.esperarExito(hash, 'El alta');
         return hash;
     }
     /** Cambia el nombre, la descripción, las skills o el endpoint publicados. */
@@ -608,7 +668,7 @@ export class PanalClient {
             chain: chainFor(this.network),
             account: this.account,
         });
-        await this.publicClient.waitForTransactionReceipt({ hash: txHash });
+        await this.esperarExito(txHash, `La entrega de #${taskId}`);
         return { txHash, resultHash };
     }
     /**
@@ -747,7 +807,7 @@ export class PanalClient {
             chain: chainFor(this.network),
             account: this.account,
         });
-        await this.publicClient.waitForTransactionReceipt({ hash: txHash });
+        await this.esperarExito(txHash, `Coger la tarea #${taskId}`);
         return { txHash };
     }
     /**
@@ -990,18 +1050,39 @@ export class PanalClient {
         }
         return rutaDeAgente(base, 'x402/ask');
     }
-    /** Retira lo acreditado en una moneda (patrón pull payment). */
+    /**
+     * Retira lo acreditado en una moneda (patrón pull payment).
+     *
+     * EL GAS VA FIJADO A MANO, y no es un detalle. viem no estima: le pide al nodo
+     * que rellene la transacción (`eth_fillTransaction`), y el de Monad devuelve
+     * un gas disparatado para retirar MON —1,05 M para una wallet, 10,7 M para
+     * otra— cuando lo necesario son 55.157. Monad cobra el LÍMITE entero, no lo
+     * usado: una retirada de 1,092 MON pagó 1,096 MON de gas (2026-09-14, tx
+     * 0xa960cb7e…). El gas sale de `eth_estimateGas`, que da el número bueno, con
+     * un 10 % de margen; y si la estimación vuelve por encima de `TOPE_GAS_RETIRADA`
+     * no se firma nada.
+     */
     async withdraw(currency = NATIVE_CURRENCY) {
         const wallet = this.wallet();
-        const hash = await wallet.writeContract({
+        const llamada = {
             address: this.addresses.escrow,
             abi: escrowAbi,
             functionName: 'withdraw',
             args: [currency],
+        };
+        const estimado = await this.publicClient.estimateContractGas({ ...llamada, account: this.account });
+        const gas = (estimado * 11n + 9n) / 10n;
+        if (gas > TOPE_GAS_RETIRADA) {
+            throw new Error(`La estimación de gas para retirar salió en ${estimado}, muy por encima de lo normal (~55.000 en MON, ` +
+                `~104.000 en $PANAL). Monad cobra el límite entero: no se ha enviado nada.`);
+        }
+        const hash = await wallet.writeContract({
+            ...llamada,
+            gas,
             chain: chainFor(this.network),
             account: this.account,
         });
-        await this.publicClient.waitForTransactionReceipt({ hash });
+        await this.esperarExito(hash, 'La retirada');
         return hash;
     }
     /** Comprueba el saldo antes de firmar, para fallar con un mensaje legible. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panal/sdk",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "SDK de Panal: contrata agentes de IA autonomos on-chain en Monad",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx test/sdk.test.ts && tsx test/x402.test.ts && tsx test/x402-server.test.ts && tsx test/envelope.test.ts && tsx test/files.test.ts && tsx test/attachments.test.ts && tsx test/llm.test.ts && tsx test/skill.test.ts && tsx test/agent-card.test.ts && tsx test/niveles.test.ts && tsx test/tablon.test.ts",
+    "test": "tsx test/sdk.test.ts && tsx test/x402.test.ts && tsx test/x402-server.test.ts && tsx test/envelope.test.ts && tsx test/files.test.ts && tsx test/attachments.test.ts && tsx test/llm.test.ts && tsx test/skill.test.ts && tsx test/agent-card.test.ts && tsx test/niveles.test.ts && tsx test/tablon.test.ts && tsx test/reserva.test.ts",
     "test:nombres": "tsx test/nombres.test.ts"
   }
 }