@panal/sdk 0.1.0 → 0.2.0

package/dist/abis.d.ts

@@ -64,6 +64,51 @@ export declare const registryAbi: readonly [{
             readonly type: "address";
         }];
     }];
+}, {
+    readonly type: "function";
+    readonly name: "registerAgent";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "metadataURI";
+        readonly type: "string";
+    }, {
+        readonly name: "pricePerTask";
+        readonly type: "uint256";
+    }, {
+        readonly name: "currency";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "updateMetadata";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "newMetadataURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "updatePrice";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "newPrice";
+        readonly type: "uint256";
+    }, {
+        readonly name: "currency";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setActive";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "active";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [];
 }];
 export declare const escrowAbi: readonly [{
     readonly type: "function";

package/dist/abis.js

@@ -47,6 +47,42 @@ export const registryAbi = [
             },
         ],
     },
+    // --- Lado del agente: darse de alta y administrarse a sí mismo ---
+    {
+        type: 'function',
+        name: 'registerAgent',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'metadataURI', type: 'string' },
+            { name: 'pricePerTask', type: 'uint256' },
+            { name: 'currency', type: 'address' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'updateMetadata',
+        stateMutability: 'nonpayable',
+        inputs: [{ name: 'newMetadataURI', type: 'string' }],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'updatePrice',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'newPrice', type: 'uint256' },
+            { name: 'currency', type: 'address' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'setActive',
+        stateMutability: 'nonpayable',
+        inputs: [{ name: 'active', type: 'bool' }],
+        outputs: [],
+    },
 ];
 export const escrowAbi = [
     {

package/dist/client.d.ts

@@ -17,7 +17,7 @@
  */
 import type { Account, Address, Hex, PublicClient } from 'viem';
 import { type PanalAddresses, type PanalNetwork } from './chains.js';
-import { type Agent, type Task } from './types.js';
+import { TaskStatus, type Agent, type AgentMetadata, type Task } from './types.js';
 export interface PanalClientOptions {
     /** `mainnet` por defecto. */
     network?: PanalNetwork;
@@ -97,6 +97,49 @@ export declare class PanalClient {
      * registrada: sin ella el agente no construye reputación.
      */
     approveTask(taskId: bigint, rating: number): 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
+     * datos de alguien.
+     */
+    registerAgent(params: {
+        metadata: AgentMetadata;
+        pricePerTask: bigint;
+        /** `NATIVE_CURRENCY` (MON) o la dirección de $PANAL. */
+        currency?: Address;
+    }): Promise<Hex>;
+    /** Cambia el nombre, la descripción, las skills o el endpoint publicados. */
+    updateMetadata(metadata: AgentMetadata): Promise<Hex>;
+    /** Cambia el precio por tarea, y opcionalmente la moneda en la que cobras. */
+    updatePrice(pricePerTask: bigint, currency?: Address): Promise<Hex>;
+    /**
+     * Enciende o apaga tu agente. Apagado deja de aparecer en el marketplace y no
+     * acepta encargos nuevos; los que ya tenga siguen su curso. Úsalo antes de
+     * irte de vacaciones: mejor invisible que incumpliendo plazos.
+     */
+    setActive(active: boolean): Promise<Hex>;
+    /**
+     * Entrega el resultado de una tarea. Ancla su keccak256 on-chain; el texto se
+     * queda contigo y se lo sirves al cliente por tu endpoint.
+     *
+     * Devuelve también el hash calculado: guárdalo junto al texto. Si más adelante
+     * sirves algo que no case con él, el cliente lo detectará y con razón.
+     */
+    deliverResult(taskId: bigint, resultText: string): Promise<{
+        txHash: Hex;
+        resultHash: Hex;
+    }>;
+    /**
+     * Las tareas asignadas a una dirección, de la más reciente hacia atrás.
+     *
+     * Recorre el escrow leyendo tarea a tarea en vez de usar `eth_getLogs`: el RPC
+     * público limita los rangos de bloques a ~100, así que un filtro de eventos
+     * solo ve lo de hace un rato. `limit` acota cuántas se revisan.
+     */
+    getTasksFor(worker: Address, options?: {
+        limit?: number;
+        status?: TaskStatus;
+    }): Promise<Task[]>;
     /** Retira lo acreditado en una moneda (patrón pull payment). */
     withdraw(currency?: Address): Promise<Hex>;
     /** Comprueba el saldo antes de firmar, para fallar con un mensaje legible. */

package/dist/client.js

@@ -18,7 +18,7 @@
 import { createPublicClient, createWalletClient, formatEther, getAddress, http, keccak256, toBytes } from 'viem';
 import { erc20Abi, escrowAbi, registryAbi } from './abis.js';
 import { NATIVE_CURRENCY, addressesFor, chainFor } from './chains.js';
-import { TaskStatus, parseAgentMetadata } from './types.js';
+import { TaskStatus, formatAgentMetadata, parseAgentMetadata, } from './types.js';
 /** Cuántos agentes se leen por llamada al registry. */
 const REGISTRY_PAGE = 50n;
 /** Tope duro de agentes recorridos, por si el registro crece mucho. */
@@ -228,6 +228,125 @@ export class PanalClient {
         await this.publicClient.waitForTransactionReceipt({ hash });
         return hash;
     }
+    // -------------------------------------------------------------------------
+    // Lado del AGENTE — darse de alta, trabajar y entregar.
+    // -------------------------------------------------------------------------
+    /**
+     * 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
+     * datos de alguien.
+     */
+    async registerAgent(params) {
+        const wallet = this.wallet();
+        const hash = await wallet.writeContract({
+            address: this.addresses.registry,
+            abi: registryAbi,
+            functionName: 'registerAgent',
+            args: [formatAgentMetadata(params.metadata), params.pricePerTask, params.currency ?? NATIVE_CURRENCY],
+            chain: chainFor(this.network),
+            account: this.account,
+        });
+        await this.publicClient.waitForTransactionReceipt({ hash });
+        return hash;
+    }
+    /** Cambia el nombre, la descripción, las skills o el endpoint publicados. */
+    async updateMetadata(metadata) {
+        const wallet = this.wallet();
+        const hash = await wallet.writeContract({
+            address: this.addresses.registry,
+            abi: registryAbi,
+            functionName: 'updateMetadata',
+            args: [formatAgentMetadata(metadata)],
+            chain: chainFor(this.network),
+            account: this.account,
+        });
+        await this.publicClient.waitForTransactionReceipt({ hash });
+        return hash;
+    }
+    /** Cambia el precio por tarea, y opcionalmente la moneda en la que cobras. */
+    async updatePrice(pricePerTask, currency = NATIVE_CURRENCY) {
+        const wallet = this.wallet();
+        const hash = await wallet.writeContract({
+            address: this.addresses.registry,
+            abi: registryAbi,
+            functionName: 'updatePrice',
+            args: [pricePerTask, currency],
+            chain: chainFor(this.network),
+            account: this.account,
+        });
+        await this.publicClient.waitForTransactionReceipt({ hash });
+        return hash;
+    }
+    /**
+     * Enciende o apaga tu agente. Apagado deja de aparecer en el marketplace y no
+     * acepta encargos nuevos; los que ya tenga siguen su curso. Úsalo antes de
+     * irte de vacaciones: mejor invisible que incumpliendo plazos.
+     */
+    async setActive(active) {
+        const wallet = this.wallet();
+        const hash = await wallet.writeContract({
+            address: this.addresses.registry,
+            abi: registryAbi,
+            functionName: 'setActive',
+            args: [active],
+            chain: chainFor(this.network),
+            account: this.account,
+        });
+        await this.publicClient.waitForTransactionReceipt({ hash });
+        return hash;
+    }
+    /**
+     * Entrega el resultado de una tarea. Ancla su keccak256 on-chain; el texto se
+     * queda contigo y se lo sirves al cliente por tu endpoint.
+     *
+     * Devuelve también el hash calculado: guárdalo junto al texto. Si más adelante
+     * sirves algo que no case con él, el cliente lo detectará y con razón.
+     */
+    async deliverResult(taskId, resultText) {
+        const wallet = this.wallet();
+        const task = await this.getTask(taskId);
+        if (task.worker.toLowerCase() !== this.account.address.toLowerCase()) {
+            throw new Error(`La tarea #${taskId} está asignada a ${task.worker}, no a ti.`);
+        }
+        if (task.status !== TaskStatus.Open) {
+            throw new Error(`La tarea #${taskId} está "${TaskStatus[task.status]}": solo se entrega lo que sigue abierto.`);
+        }
+        const resultHash = keccak256(toBytes(resultText));
+        const txHash = await wallet.writeContract({
+            address: this.addresses.escrow,
+            abi: escrowAbi,
+            functionName: 'deliverResult',
+            args: [taskId, resultHash],
+            chain: chainFor(this.network),
+            account: this.account,
+        });
+        await this.publicClient.waitForTransactionReceipt({ hash: txHash });
+        return { txHash, resultHash };
+    }
+    /**
+     * Las tareas asignadas a una dirección, de la más reciente hacia atrás.
+     *
+     * Recorre el escrow leyendo tarea a tarea en vez de usar `eth_getLogs`: el RPC
+     * público limita los rangos de bloques a ~100, así que un filtro de eventos
+     * solo ve lo de hace un rato. `limit` acota cuántas se revisan.
+     */
+    async getTasksFor(worker, options = {}) {
+        const count = await this.getTaskCount();
+        const limit = options.limit ?? 50;
+        const target = getAddress(worker).toLowerCase();
+        const found = [];
+        for (let id = count - 1n; id >= 0n && found.length < limit; id--) {
+            const task = await this.getTask(id);
+            if (task.worker.toLowerCase() !== target)
+                continue;
+            if (options.status !== undefined && task.status !== options.status)
+                continue;
+            found.push(task);
+            if (id === 0n)
+                break;
+        }
+        return found;
+    }
     /** Retira lo acreditado en una moneda (patrón pull payment). */
     async withdraw(currency = NATIVE_CURRENCY) {
         const wallet = this.wallet();

package/package.json

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