@panal/sdk 0.18.0 → 0.18.1

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[]>;
     /**

package/dist/client.js

@@ -126,6 +126,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 +575,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 +663,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 +802,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 };
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panal/sdk",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "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"
   }
 }