@panal/sdk 0.18.2 → 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;

package/dist/client.js

@@ -167,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.
      *
@@ -799,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,
         });
@@ -849,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.
      *
-     * 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.
+     * 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.
      */
     async deliverBoardResult(taskId, resultText) {
         const wallet = this.wallet();
@@ -868,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 }),
@@ -1070,12 +1108,7 @@ export class PanalClient {
             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 gas = await this.gasFijo('La retirada', llamada);
         const hash = await wallet.writeContract({
             ...llamada,
             gas,

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.2",
+  "version": "0.18.3",
   "description": "SDK de Panal: contrata agentes de IA autonomos on-chain en Monad",
   "type": "module",
   "license": "MIT",