@agether/sdk 2.11.1 → 2.12.0

package/dist/cli.js

@@ -57,6 +57,7 @@ var init_abis = __esm({
       "function totalSupply() view returns (uint256)",
       "function exists(uint256 agentId) view returns (bool)",
       "function register() returns (uint256 agentId)",
+      "function register(string agentURI) returns (uint256 agentId)",
       "event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)"
     ];
     AGETHER_4337_FACTORY_ABI = [
@@ -1793,8 +1794,11 @@ var init_AgetherClient = __esm({
        * If already registered, returns existing state.
        *
        * Sets `this.agentId` on success so subsequent operations work immediately.
+       *
+       * @param options.name        Agent display name (stored in on-chain metadata URI)
+       * @param options.description Agent description (defaults to 'AI agent registered via @agether/sdk')
        */
-      async register() {
+      async register(options) {
         const eoaAddr = await this._getSignerAddress();
         if (this.agentId !== void 0) {
           const exists = await this.agether4337Factory.accountExists(this.agentId);
@@ -1817,10 +1821,10 @@ var init_AgetherClient = __esm({
           if (balance > 0n) {
             agentId = this.agentId;
           } else {
-            agentId = await this._mintNewIdentity();
+            agentId = await this._mintNewIdentity(options?.name, options?.description);
           }
         } else {
-          agentId = await this._mintNewIdentity();
+          agentId = await this._mintNewIdentity(options?.name, options?.description);
         }
         this.agentId = agentId;
         const acctExists = await this.agether4337Factory.accountExists(agentId);
@@ -1843,9 +1847,22 @@ var init_AgetherClient = __esm({
           tx: txHash
         };
       }
-      /** Mint a new ERC-8004 identity and return the agentId. */
-      async _mintNewIdentity() {
-        const regTx = await this.identityRegistry.register();
+      /** Mint a new ERC-8004 identity and return the agentId.
+       *  Builds a JSON metadata document per ERC-8004 spec and encodes it as a data: URI.
+       */
+      async _mintNewIdentity(name, description) {
+        const registrationFile = JSON.stringify({
+          type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+          name: name || "Unnamed Agent",
+          description: description || "AI agent registered via @agether/sdk",
+          active: true,
+          registrations: [{
+            agentId: 0,
+            agentRegistry: `eip155:${this.config.chainId}:${this.config.contracts.identityRegistry}`
+          }]
+        });
+        const agentURI = `data:application/json;base64,${Buffer.from(registrationFile).toString("base64")}`;
+        const regTx = await this.identityRegistry["register(string)"](agentURI);
         const regReceipt = await regTx.wait();
         this._refreshSigner();
         let agentId = 0n;

package/dist/index.d.mts

@@ -222,9 +222,17 @@ declare class AgetherClient {
      * If already registered, returns existing state.
      *
      * Sets `this.agentId` on success so subsequent operations work immediately.
+     *
+     * @param options.name        Agent display name (stored in on-chain metadata URI)
+     * @param options.description Agent description (defaults to 'AI agent registered via @agether/sdk')
+     */
+    register(options?: {
+        name?: string;
+        description?: string;
+    }): Promise<RegisterResult>;
+    /** Mint a new ERC-8004 identity and return the agentId.
+     *  Builds a JSON metadata document per ERC-8004 spec and encodes it as a data: URI.
      */
-    register(): Promise<RegisterResult>;
-    /** Mint a new ERC-8004 identity and return the agentId. */
     private _mintNewIdentity;
     /**
      * Deploy a Safe account smart wallet for the agent.

package/dist/index.d.ts

@@ -222,9 +222,17 @@ declare class AgetherClient {
      * If already registered, returns existing state.
      *
      * Sets `this.agentId` on success so subsequent operations work immediately.
+     *
+     * @param options.name        Agent display name (stored in on-chain metadata URI)
+     * @param options.description Agent description (defaults to 'AI agent registered via @agether/sdk')
+     */
+    register(options?: {
+        name?: string;
+        description?: string;
+    }): Promise<RegisterResult>;
+    /** Mint a new ERC-8004 identity and return the agentId.
+     *  Builds a JSON metadata document per ERC-8004 spec and encodes it as a data: URI.
      */
-    register(): Promise<RegisterResult>;
-    /** Mint a new ERC-8004 identity and return the agentId. */
     private _mintNewIdentity;
     /**
      * Deploy a Safe account smart wallet for the agent.

package/dist/index.js

@@ -128,6 +128,7 @@ var IDENTITY_REGISTRY_ABI = [
   "function totalSupply() view returns (uint256)",
   "function exists(uint256 agentId) view returns (bool)",
   "function register() returns (uint256 agentId)",
+  "function register(string agentURI) returns (uint256 agentId)",
   "event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)"
 ];
 var AGETHER_4337_FACTORY_ABI = [
@@ -448,8 +449,11 @@ var AgetherClient = class _AgetherClient {
    * If already registered, returns existing state.
    *
    * Sets `this.agentId` on success so subsequent operations work immediately.
+   *
+   * @param options.name        Agent display name (stored in on-chain metadata URI)
+   * @param options.description Agent description (defaults to 'AI agent registered via @agether/sdk')
    */
-  async register() {
+  async register(options) {
     const eoaAddr = await this._getSignerAddress();
     if (this.agentId !== void 0) {
       const exists = await this.agether4337Factory.accountExists(this.agentId);
@@ -472,10 +476,10 @@ var AgetherClient = class _AgetherClient {
       if (balance > 0n) {
         agentId = this.agentId;
       } else {
-        agentId = await this._mintNewIdentity();
+        agentId = await this._mintNewIdentity(options?.name, options?.description);
       }
     } else {
-      agentId = await this._mintNewIdentity();
+      agentId = await this._mintNewIdentity(options?.name, options?.description);
     }
     this.agentId = agentId;
     const acctExists = await this.agether4337Factory.accountExists(agentId);
@@ -498,9 +502,22 @@ var AgetherClient = class _AgetherClient {
       tx: txHash
     };
   }
-  /** Mint a new ERC-8004 identity and return the agentId. */
-  async _mintNewIdentity() {
-    const regTx = await this.identityRegistry.register();
+  /** Mint a new ERC-8004 identity and return the agentId.
+   *  Builds a JSON metadata document per ERC-8004 spec and encodes it as a data: URI.
+   */
+  async _mintNewIdentity(name, description) {
+    const registrationFile = JSON.stringify({
+      type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+      name: name || "Unnamed Agent",
+      description: description || "AI agent registered via @agether/sdk",
+      active: true,
+      registrations: [{
+        agentId: 0,
+        agentRegistry: `eip155:${this.config.chainId}:${this.config.contracts.identityRegistry}`
+      }]
+    });
+    const agentURI = `data:application/json;base64,${Buffer.from(registrationFile).toString("base64")}`;
+    const regTx = await this.identityRegistry["register(string)"](agentURI);
     const regReceipt = await regTx.wait();
     this._refreshSigner();
     let agentId = 0n;

package/dist/index.mjs

@@ -53,6 +53,7 @@ var IDENTITY_REGISTRY_ABI = [
   "function totalSupply() view returns (uint256)",
   "function exists(uint256 agentId) view returns (bool)",
   "function register() returns (uint256 agentId)",
+  "function register(string agentURI) returns (uint256 agentId)",
   "event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)"
 ];
 var AGETHER_4337_FACTORY_ABI = [
@@ -373,8 +374,11 @@ var AgetherClient = class _AgetherClient {
    * If already registered, returns existing state.
    *
    * Sets `this.agentId` on success so subsequent operations work immediately.
+   *
+   * @param options.name        Agent display name (stored in on-chain metadata URI)
+   * @param options.description Agent description (defaults to 'AI agent registered via @agether/sdk')
    */
-  async register() {
+  async register(options) {
     const eoaAddr = await this._getSignerAddress();
     if (this.agentId !== void 0) {
       const exists = await this.agether4337Factory.accountExists(this.agentId);
@@ -397,10 +401,10 @@ var AgetherClient = class _AgetherClient {
       if (balance > 0n) {
         agentId = this.agentId;
       } else {
-        agentId = await this._mintNewIdentity();
+        agentId = await this._mintNewIdentity(options?.name, options?.description);
       }
     } else {
-      agentId = await this._mintNewIdentity();
+      agentId = await this._mintNewIdentity(options?.name, options?.description);
     }
     this.agentId = agentId;
     const acctExists = await this.agether4337Factory.accountExists(agentId);
@@ -423,9 +427,22 @@ var AgetherClient = class _AgetherClient {
       tx: txHash
     };
   }
-  /** Mint a new ERC-8004 identity and return the agentId. */
-  async _mintNewIdentity() {
-    const regTx = await this.identityRegistry.register();
+  /** Mint a new ERC-8004 identity and return the agentId.
+   *  Builds a JSON metadata document per ERC-8004 spec and encodes it as a data: URI.
+   */
+  async _mintNewIdentity(name, description) {
+    const registrationFile = JSON.stringify({
+      type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+      name: name || "Unnamed Agent",
+      description: description || "AI agent registered via @agether/sdk",
+      active: true,
+      registrations: [{
+        agentId: 0,
+        agentRegistry: `eip155:${this.config.chainId}:${this.config.contracts.identityRegistry}`
+      }]
+    });
+    const agentURI = `data:application/json;base64,${Buffer.from(registrationFile).toString("base64")}`;
+    const regTx = await this.identityRegistry["register(string)"](agentURI);
     const regReceipt = await regTx.wait();
     this._refreshSigner();
     let agentId = 0n;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agether/sdk",
-  "version": "2.11.1",
+  "version": "2.12.0",
   "description": "TypeScript SDK for Agether - autonomous credit for AI agents on Ethereum & Base",
   "main": "dist/index.js",
   "module": "dist/index.mjs",