@panal/sdk 0.8.0 → 0.9.0

package/dist/abis.d.ts

@@ -240,6 +240,15 @@ export declare const escrowAbi: readonly [{
         readonly type: "uint256";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "openDispute";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "taskId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
 }];
 export declare const erc20Abi: readonly [{
     readonly type: "function";

package/dist/abis.js

@@ -172,6 +172,16 @@ export const escrowAbi = [
         inputs: [{ name: 'taskId', type: 'uint256' }],
         outputs: [],
     },
+    // Lo unico que detiene el autoRelease de 3 dias. Faltaba en este ABI, asi
+    // que desde el SDK no habia forma de disputar una entrega: tocaba ir al
+    // contrato a mano justo cuando corre el reloj.
+    {
+        type: 'function',
+        name: 'openDispute',
+        stateMutability: 'nonpayable',
+        inputs: [{ name: 'taskId', type: 'uint256' }],
+        outputs: [],
+    },
 ];
 export const erc20Abi = [
     {

package/dist/client.d.ts

@@ -130,6 +130,35 @@ export declare class PanalClient {
      * registrada: sin ella el agente no construye reputación.
      */
     approveTask(taskId: bigint, rating: number): Promise<Hex>;
+    /**
+     * Cancela una tarea que nunca arrancó y recupera lo bloqueado.
+     *
+     * El escrow solo lo permite al cliente, con la tarea todavía `Open` —o sea
+     * sin entrega— y además vencido el plazo o sin worker asignado. Con worker
+     * asignado hay que esperar al deadline: si no, el cliente podría retirarle
+     * el encargo a alguien que ya está trabajando.
+     *
+     * Hace falta cuando el encargo no llegó a su destino y el pago sí: el brief
+     * se entrega después de crear la tarea, así que un endpoint caído o un texto
+     * que el agente rechaza dejan dinero parado hasta el plazo. Sin esto, la
+     * única salida era llamar al contrato a mano.
+     *
+     * OJO: el escrow es pull payment. Esto ACREDITA el reembolso, no lo envía.
+     * Para tenerlo en la wallet hay que llamar después a `withdraw()`.
+     */
+    cancelTask(taskId: bigint): Promise<Hex>;
+    /**
+     * Abre una disputa sobre una entrega, y con ello para el reloj.
+     *
+     * Urge más de lo que parece: si no apruebas ni disputas, el escrow libera el
+     * pago solo a los 3 días de la entrega, con un 5/5 implícito. O sea que ante
+     * una entrega mala, no hacer nada NO es neutral: es pagar y además regalar la
+     * mejor valoración. Disputar es lo único que detiene esa cuenta atrás.
+     *
+     * La resuelve el arbitrator repartiendo el importe. Si no lo hace en 14 días,
+     * cualquiera puede llamar a `resolveStuckDispute` y el cliente recupera todo.
+     */
+    openDispute(taskId: bigint): Promise<Hex>;
     /**
      * Registra tu agente en el marketplace. Lo llama la wallet que trabajará y
      * cobrará: en Panal el agente ES una dirección, no una fila en una base de

package/dist/client.js

@@ -341,6 +341,67 @@ export class PanalClient {
         await this.publicClient.waitForTransactionReceipt({ hash });
         return hash;
     }
+    /**
+     * Cancela una tarea que nunca arrancó y recupera lo bloqueado.
+     *
+     * El escrow solo lo permite al cliente, con la tarea todavía `Open` —o sea
+     * sin entrega— y además vencido el plazo o sin worker asignado. Con worker
+     * asignado hay que esperar al deadline: si no, el cliente podría retirarle
+     * el encargo a alguien que ya está trabajando.
+     *
+     * Hace falta cuando el encargo no llegó a su destino y el pago sí: el brief
+     * se entrega después de crear la tarea, así que un endpoint caído o un texto
+     * que el agente rechaza dejan dinero parado hasta el plazo. Sin esto, la
+     * única salida era llamar al contrato a mano.
+     *
+     * OJO: el escrow es pull payment. Esto ACREDITA el reembolso, no lo envía.
+     * Para tenerlo en la wallet hay que llamar después a `withdraw()`.
+     */
+    async cancelTask(taskId) {
+        const wallet = this.wallet();
+        const task = await this.getTask(taskId);
+        if (task.status !== TaskStatus.Open) {
+            throw new Error(`La tarea #${taskId} está "${TaskStatus[task.status]}": solo se cancela lo que sigue abierto.`);
+        }
+        const hash = await wallet.writeContract({
+            address: this.addresses.escrow,
+            abi: escrowAbi,
+            functionName: 'cancelTask',
+            args: [taskId],
+            chain: chainFor(this.network),
+            account: this.account,
+        });
+        await this.publicClient.waitForTransactionReceipt({ hash });
+        return hash;
+    }
+    /**
+     * Abre una disputa sobre una entrega, y con ello para el reloj.
+     *
+     * Urge más de lo que parece: si no apruebas ni disputas, el escrow libera el
+     * pago solo a los 3 días de la entrega, con un 5/5 implícito. O sea que ante
+     * una entrega mala, no hacer nada NO es neutral: es pagar y además regalar la
+     * mejor valoración. Disputar es lo único que detiene esa cuenta atrás.
+     *
+     * La resuelve el arbitrator repartiendo el importe. Si no lo hace en 14 días,
+     * cualquiera puede llamar a `resolveStuckDispute` y el cliente recupera todo.
+     */
+    async openDispute(taskId) {
+        const wallet = this.wallet();
+        const task = await this.getTask(taskId);
+        if (task.status !== TaskStatus.Delivered) {
+            throw new Error(`La tarea #${taskId} está "${TaskStatus[task.status]}": solo se disputa lo entregado.`);
+        }
+        const hash = await wallet.writeContract({
+            address: this.addresses.escrow,
+            abi: escrowAbi,
+            functionName: 'openDispute',
+            args: [taskId],
+            chain: chainFor(this.network),
+            account: this.account,
+        });
+        await this.publicClient.waitForTransactionReceipt({ hash });
+        return hash;
+    }
     // -------------------------------------------------------------------------
     // Lado del AGENTE — darse de alta, trabajar y entregar.
     // -------------------------------------------------------------------------

package/package.json

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