@agether/sdk 2.11.0 → 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 = [
@@ -1763,7 +1764,7 @@ var init_AgetherClient = __esm({
         const signer = new import_ethers2.ethers.Wallet(privateKey, provider);
         return new _AgetherClient({ config, signer, agentId, _privateKey: privateKey });
       }
-      static fromSigner(signer, agentIdOrChain, chainIdOrConfig) {
+      static async fromSigner(signer, agentIdOrChain, chainIdOrConfig) {
         if (!signer.provider) {
           throw new AgetherError("Signer must be connected to a provider", "NO_PROVIDER");
         }
@@ -1775,6 +1776,14 @@ var init_AgetherClient = __esm({
         } else {
           config = typeof agentIdOrChain === "number" ? getDefaultConfig(agentIdOrChain) : agentIdOrChain;
         }
+        const network = await signer.provider.getNetwork();
+        const actualChainId = Number(network.chainId);
+        if (actualChainId !== config.chainId) {
+          throw new AgetherError(
+            `Chain mismatch: signer is on chain ${actualChainId} but config expects chain ${config.chainId}`,
+            "CHAIN_MISMATCH"
+          );
+        }
         return new _AgetherClient({ config, signer, agentId });
       }
       // ════════════════════════════════════════════════════════
@@ -1785,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);
@@ -1809,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);
@@ -1835,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

@@ -195,34 +195,44 @@ declare class AgetherClient {
      * Create an AgetherClient from an **external signer** for a **new** agent (no agentId yet).
      *
      * Accepts any `ethers.AbstractSigner` — Privy, Bankr, Turnkey, MetaMask, etc.
-     * The signer **must** already be connected to a provider.
+     * The signer **must** already be connected to a provider on the correct chain.
+     *
+     * Validates that the signer's provider chain matches the requested chain.
      *
      * Only `register()` and `getBalances()` are available until registration completes.
      *
      * @example
      * ```ts
-     * const client = AgetherClient.fromSigner(privySigner, ChainId.Base);
+     * const client = await AgetherClient.fromSigner(privySigner, ChainId.Base);
      * const result = await client.register();
      * ```
      */
-    static fromSigner(signer: ethers.AbstractSigner, chainIdOrConfig: ChainId | AgetherConfig): AgetherClient;
+    static fromSigner(signer: ethers.AbstractSigner, chainIdOrConfig: ChainId | AgetherConfig): Promise<AgetherClient>;
     /**
      * Create an AgetherClient from an **external signer** for an **existing** agent.
      *
      * @example
      * ```ts
-     * const client = AgetherClient.fromSigner(privySigner, 42n, ChainId.Base);
+     * const client = await AgetherClient.fromSigner(privySigner, 42n, ChainId.Base);
      * ```
      */
-    static fromSigner(signer: ethers.AbstractSigner, agentId: bigint, chainIdOrConfig: ChainId | AgetherConfig): AgetherClient;
+    static fromSigner(signer: ethers.AbstractSigner, agentId: bigint, chainIdOrConfig: ChainId | AgetherConfig): Promise<AgetherClient>;
     /**
      * Register: create ERC-8004 identity + Safe account in one flow.
      * 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

@@ -195,34 +195,44 @@ declare class AgetherClient {
      * Create an AgetherClient from an **external signer** for a **new** agent (no agentId yet).
      *
      * Accepts any `ethers.AbstractSigner` — Privy, Bankr, Turnkey, MetaMask, etc.
-     * The signer **must** already be connected to a provider.
+     * The signer **must** already be connected to a provider on the correct chain.
+     *
+     * Validates that the signer's provider chain matches the requested chain.
      *
      * Only `register()` and `getBalances()` are available until registration completes.
      *
      * @example
      * ```ts
-     * const client = AgetherClient.fromSigner(privySigner, ChainId.Base);
+     * const client = await AgetherClient.fromSigner(privySigner, ChainId.Base);
      * const result = await client.register();
      * ```
      */
-    static fromSigner(signer: ethers.AbstractSigner, chainIdOrConfig: ChainId | AgetherConfig): AgetherClient;
+    static fromSigner(signer: ethers.AbstractSigner, chainIdOrConfig: ChainId | AgetherConfig): Promise<AgetherClient>;
     /**
      * Create an AgetherClient from an **external signer** for an **existing** agent.
      *
      * @example
      * ```ts
-     * const client = AgetherClient.fromSigner(privySigner, 42n, ChainId.Base);
+     * const client = await AgetherClient.fromSigner(privySigner, 42n, ChainId.Base);
      * ```
      */
-    static fromSigner(signer: ethers.AbstractSigner, agentId: bigint, chainIdOrConfig: ChainId | AgetherConfig): AgetherClient;
+    static fromSigner(signer: ethers.AbstractSigner, agentId: bigint, chainIdOrConfig: ChainId | AgetherConfig): Promise<AgetherClient>;
     /**
      * Register: create ERC-8004 identity + Safe account in one flow.
      * 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 = [
@@ -418,7 +419,7 @@ var AgetherClient = class _AgetherClient {
     const signer = new import_ethers.ethers.Wallet(privateKey, provider);
     return new _AgetherClient({ config, signer, agentId, _privateKey: privateKey });
   }
-  static fromSigner(signer, agentIdOrChain, chainIdOrConfig) {
+  static async fromSigner(signer, agentIdOrChain, chainIdOrConfig) {
     if (!signer.provider) {
       throw new AgetherError("Signer must be connected to a provider", "NO_PROVIDER");
     }
@@ -430,6 +431,14 @@ var AgetherClient = class _AgetherClient {
     } else {
       config = typeof agentIdOrChain === "number" ? getDefaultConfig(agentIdOrChain) : agentIdOrChain;
     }
+    const network = await signer.provider.getNetwork();
+    const actualChainId = Number(network.chainId);
+    if (actualChainId !== config.chainId) {
+      throw new AgetherError(
+        `Chain mismatch: signer is on chain ${actualChainId} but config expects chain ${config.chainId}`,
+        "CHAIN_MISMATCH"
+      );
+    }
     return new _AgetherClient({ config, signer, agentId });
   }
   // ════════════════════════════════════════════════════════
@@ -440,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);
@@ -464,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);
@@ -490,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 = [
@@ -343,7 +344,7 @@ var AgetherClient = class _AgetherClient {
     const signer = new ethers.Wallet(privateKey, provider);
     return new _AgetherClient({ config, signer, agentId, _privateKey: privateKey });
   }
-  static fromSigner(signer, agentIdOrChain, chainIdOrConfig) {
+  static async fromSigner(signer, agentIdOrChain, chainIdOrConfig) {
     if (!signer.provider) {
       throw new AgetherError("Signer must be connected to a provider", "NO_PROVIDER");
     }
@@ -355,6 +356,14 @@ var AgetherClient = class _AgetherClient {
     } else {
       config = typeof agentIdOrChain === "number" ? getDefaultConfig(agentIdOrChain) : agentIdOrChain;
     }
+    const network = await signer.provider.getNetwork();
+    const actualChainId = Number(network.chainId);
+    if (actualChainId !== config.chainId) {
+      throw new AgetherError(
+        `Chain mismatch: signer is on chain ${actualChainId} but config expects chain ${config.chainId}`,
+        "CHAIN_MISMATCH"
+      );
+    }
     return new _AgetherClient({ config, signer, agentId });
   }
   // ════════════════════════════════════════════════════════
@@ -365,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);
@@ -389,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);
@@ -415,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.0",
+  "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",