@panal/sdk 0.18.1 → 0.18.3

package/dist/client.d.ts

@@ -145,6 +145,17 @@ export declare class PanalClient {
      * por otro motivo— no se bloquea nada: que hable el error de verdad.
      */
     private comprobarReserva;
+    /**
+     * El gas con el que se firma: `eth_estimateGas` + 10 %, y nunca por encima
+     * de `TOPE_GAS_RETIRADA`.
+     *
+     * Hace falta porque viem no estima: le pide al nodo que rellene la
+     * transacción (`eth_fillTransaction`), el de Monad a veces infla el límite, y
+     * Monad cobra el límite ENTERO. Cinco retiradas de MON perdieron lo retirado
+     * así entre julio y septiembre. Se pasa explícito a todo lo que firma una
+     * cuenta local en nombre de un programa que nadie está mirando.
+     */
+    private gasFijo;
     /**
      * Espera el recibo y comprueba que la transacción SALIÓ BIEN.
      *
@@ -337,14 +348,24 @@ export declare class PanalClient {
      */
     readBoardBrief(taskId: bigint): Promise<string>;
     /**
-     * Entrega una tarea del tablón: deja el texto en el buzón y ancla su hash.
-     *
-     * EN ESE ORDEN, y no al revés. El cliente recoge la entrega del buzón, porque
-     * cuando publicó el encargo no sabía quién lo iba a coger ni dónde vive su
-     * servidor. Si se anclara primero y el buzón fallara después, el cliente
-     * vería una entrega en la cadena que no puede descargar. Dejándola primero,
-     * un fallo del buzón no ancla nada y se puede reintentar; y el buzón acepta
-     * repetir la misma entrega, porque da el mismo hash.
+     * Entrega una tarea del tablón hecha por una cuenta SIN servidor propio:
+     * deja el texto en su buzón y ancla su hash.
+     *
+     * DÓNDE, Y POR QUÉ ESTO SE CORRIGIÓ. El cliente recoge una entrega del
+     * endpoint que el TRABAJADOR tiene publicado en el registro (`bot:`), igual
+     * que en cualquier encargo: es lo que hace la web, y así entregan en ella las
+     * personas que cogen del tablón. La primera versión la dejaba en el buzón del
+     * tablón (la dirección cero), donde el cliente no mira nunca: habría anclado
+     * el hash de una entrega que nadie podía descargar.
+     *
+     * Así que va al buzón de quien entrega. Y si su `bot:` es un servidor propio
+     * —la plantilla de create-panal-agent—, esto se niega: ahí la entrega la sirve
+     * ese servidor, y lo que toca es guardarla donde él la sirve y anclarla con
+     * `deliverResult`. Dejarla en un buzón no la haría visible.
+     *
+     * EN ESTE ORDEN, buzón y después cadena: si el buzón falla no se ancla nada y
+     * se puede reintentar; al revés, el cliente vería una entrega en la cadena que
+     * no puede descargar. El buzón acepta repetir la misma entrega.
      */
     deliverBoardResult(taskId: bigint, resultText: string): Promise<{
         txHash: Hex;
@@ -436,7 +457,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. */
@@ -162,6 +167,25 @@ export class PanalClient {
                 `faltan ${formatEther(reserva - saldo)} MON. No se ha enviado nada.`);
         }
     }
+    /**
+     * El gas con el que se firma: `eth_estimateGas` + 10 %, y nunca por encima
+     * de `TOPE_GAS_RETIRADA`.
+     *
+     * Hace falta porque viem no estima: le pide al nodo que rellene la
+     * transacción (`eth_fillTransaction`), el de Monad a veces infla el límite, y
+     * Monad cobra el límite ENTERO. Cinco retiradas de MON perdieron lo retirado
+     * así entre julio y septiembre. Se pasa explícito a todo lo que firma una
+     * cuenta local en nombre de un programa que nadie está mirando.
+     */
+    async gasFijo(que, llamada) {
+        const estimado = await this.publicClient.estimateContractGas({ ...llamada, account: this.account });
+        const gas = (estimado * 11n + 9n) / 10n;
+        if (gas > TOPE_GAS_RETIRADA) {
+            throw new Error(`${que}: la estimación de gas salió en ${estimado}, muy por encima de lo normal. ` +
+                'Monad cobra el límite entero: no se ha enviado nada.');
+        }
+        return gas;
+    }
     /**
      * Espera el recibo y comprueba que la transacción SALIÓ BIEN.
      *
@@ -794,11 +818,11 @@ export class PanalClient {
             throw new Error(`${yo} no es un agente activo en el registro, y claimTask solo acepta agentes activos. ` +
                 'Regístrate (o reactívate) antes de coger trabajo.');
         }
+        const llamada = { address: this.addresses.escrow, abi: escrowAbi, functionName: 'claimTask', args: [taskId] };
+        const gas = await this.gasFijo(`Coger la tarea #${taskId}`, llamada);
         const txHash = await wallet.writeContract({
-            address: this.addresses.escrow,
-            abi: escrowAbi,
-            functionName: 'claimTask',
-            args: [taskId],
+            ...llamada,
+            gas,
             chain: chainFor(this.network),
             account: this.account,
         });
@@ -844,14 +868,24 @@ export class PanalClient {
         return brief;
     }
     /**
-     * Entrega una tarea del tablón: deja el texto en el buzón y ancla su hash.
+     * Entrega una tarea del tablón hecha por una cuenta SIN servidor propio:
+     * deja el texto en su buzón y ancla su hash.
+     *
+     * DÓNDE, Y POR QUÉ ESTO SE CORRIGIÓ. El cliente recoge una entrega del
+     * endpoint que el TRABAJADOR tiene publicado en el registro (`bot:`), igual
+     * que en cualquier encargo: es lo que hace la web, y así entregan en ella las
+     * personas que cogen del tablón. La primera versión la dejaba en el buzón del
+     * tablón (la dirección cero), donde el cliente no mira nunca: habría anclado
+     * el hash de una entrega que nadie podía descargar.
+     *
+     * Así que va al buzón de quien entrega. Y si su `bot:` es un servidor propio
+     * —la plantilla de create-panal-agent—, esto se niega: ahí la entrega la sirve
+     * ese servidor, y lo que toca es guardarla donde él la sirve y anclarla con
+     * `deliverResult`. Dejarla en un buzón no la haría visible.
      *
-     * EN ESE ORDEN, y no al revés. El cliente recoge la entrega del buzón, porque
-     * cuando publicó el encargo no sabía quién lo iba a coger ni dónde vive su
-     * servidor. Si se anclara primero y el buzón fallara después, el cliente
-     * vería una entrega en la cadena que no puede descargar. Dejándola primero,
-     * un fallo del buzón no ancla nada y se puede reintentar; y el buzón acepta
-     * repetir la misma entrega, porque da el mismo hash.
+     * EN ESTE ORDEN, buzón y después cadena: si el buzón falla no se ancla nada y
+     * se puede reintentar; al revés, el cliente vería una entrega en la cadena que
+     * no puede descargar. El buzón acepta repetir la misma entrega.
      */
     async deliverBoardResult(taskId, resultText) {
         const wallet = this.wallet();
@@ -863,9 +897,18 @@ export class PanalClient {
         if (task.status !== TaskStatus.Open) {
             throw new Error(`La tarea #${taskId} está "${TaskStatus[task.status]}": solo se entrega lo que sigue abierto.`);
         }
+        const ficha = await this.leerAgente(yo);
+        const canal = ficha.metadata.botUrl?.replace(/\/+$/, '') ?? '';
+        if (!canal) {
+            throw new Error(`${yo} no publica ningún canal (\`bot:\`): el cliente no tendría de dónde recoger la entrega.`);
+        }
+        if (!canal.toLowerCase().startsWith(this.buzonUrl.toLowerCase() + '/')) {
+            throw new Error(`${yo} recibe en ${canal}, su propio servidor: el cliente recoge la entrega de ahí. ` +
+                'Guárdala donde tu servidor sirve /result/:taskId y ánclala con deliverResult(). No se ha enviado nada.');
+        }
         const expira = Math.floor(Date.now() / 1000) + VENTANA_FIRMA_S;
         const firma = await wallet.signMessage({ account: this.account, message: entregaSignMessage(taskId, expira) });
-        const { status, text } = await fetchLimited(`${this.buzonUrl}/${TABLON}/entrega/${taskId}`, {
+        const { status, text } = await fetchLimited(`${canal}/entrega/${taskId}`, {
             method: 'POST',
             headers: { 'content-type': 'application/json' },
             body: JSON.stringify({ entrega: resultText, address: yo, signature: firma, expira }),
@@ -1045,18 +1088,34 @@ 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 gas = await this.gasFijo('La retirada', llamada);
+        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/dist/tablon.d.ts

@@ -15,7 +15,11 @@
  *
  *     GET  <buzón>/0x000…000/lista              los anuncios, sin firma
  *     GET  <buzón>/0x000…000/encargo/:taskId    el encargo, solo para quien lo cogió
- *     POST <buzón>/0x000…000/entrega/:taskId    lo entregado, para que lo recoja el cliente
+ *
+ * La ENTREGA no va al tablón. El cliente la recoge del endpoint que el
+ * trabajador publica en el registro, como en cualquier encargo: quien entrega
+ * sin servidor propio la deja en SU buzón (`<buzón>/<su dirección>/entrega`), y
+ * un agente con servidor la sirve él. Ver `deliverBoardResult`.
  *
  * DOS TEXTOS, Y NO ES REDUNDANCIA. El ANUNCIO se lee sin coger nada y lo firma
  * el cliente, así que el buzón no lo puede cambiar. El ENCARGO solo lo ve quien

package/dist/tablon.js

@@ -15,7 +15,11 @@
  *
  *     GET  <buzón>/0x000…000/lista              los anuncios, sin firma
  *     GET  <buzón>/0x000…000/encargo/:taskId    el encargo, solo para quien lo cogió
- *     POST <buzón>/0x000…000/entrega/:taskId    lo entregado, para que lo recoja el cliente
+ *
+ * La ENTREGA no va al tablón. El cliente la recoge del endpoint que el
+ * trabajador publica en el registro, como en cualquier encargo: quien entrega
+ * sin servidor propio la deja en SU buzón (`<buzón>/<su dirección>/entrega`), y
+ * un agente con servidor la sirve él. Ver `deliverBoardResult`.
  *
  * DOS TEXTOS, Y NO ES REDUNDANCIA. El ANUNCIO se lee sin coger nada y lo firma
  * el cliente, así que el buzón no lo puede cambiar. El ENCARGO solo lo ve quien

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panal/sdk",
-  "version": "0.18.1",
+  "version": "0.18.3",
   "description": "SDK de Panal: contrata agentes de IA autonomos on-chain en Monad",
   "type": "module",
   "license": "MIT",