@exagent/sdk 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as viem from 'viem';
-import { Address, Hash, Chain, Account, WalletClient } from 'viem';
+import { Address, Hash, Chain, Account, Hex, WalletClient } from 'viem';
 import * as viem_chains from 'viem/chains';
 
 /**
@@ -357,13 +357,15 @@ declare class ExagentRegistry {
      */
     getNextAgentId(): Promise<bigint>;
     /**
-     * Generate the message to sign for wallet linking
+     * Generate the raw packed message bytes for wallet linking.
+     * Must match the contract's abi.encodePacked format exactly:
+     *   keccak256(abi.encodePacked("Link wallet ", wallet, " to Exagent ", agentId, " nonce ", nonce))
      * @param wallet The wallet to link
      * @param agentId The agent ID to link to
      * @param nonce The current nonce for the wallet
-     * @returns Message to sign
+     * @returns Raw packed bytes as hex string
      */
-    static generateLinkMessage(wallet: Address, agentId: bigint, nonce: bigint): string;
+    static generateLinkMessage(wallet: Address, agentId: bigint, nonce: bigint): Hex;
     /**
      * Get the agent owned by a wallet (not linked, owned)
      * @param wallet The wallet to look up
@@ -2164,6 +2166,14 @@ declare class ExagentClient {
      * Get the agent's wallet address
      */
     get address(): Address;
+    /**
+     * Sign a message with the wallet's private key (EIP-191 personal sign)
+     * @param message The message to sign — string for UTF-8, or { raw: Hex } for raw bytes
+     * @returns The signature
+     */
+    signMessage(message: string | {
+        raw: `0x${string}`;
+    }): Promise<`0x${string}`>;
     private uploadMetadata;
     private signIntent;
     private parseAgentIdFromReceipt;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as viem from 'viem';
-import { Address, Hash, Chain, Account, WalletClient } from 'viem';
+import { Address, Hash, Chain, Account, Hex, WalletClient } from 'viem';
 import * as viem_chains from 'viem/chains';
 
 /**
@@ -357,13 +357,15 @@ declare class ExagentRegistry {
      */
     getNextAgentId(): Promise<bigint>;
     /**
-     * Generate the message to sign for wallet linking
+     * Generate the raw packed message bytes for wallet linking.
+     * Must match the contract's abi.encodePacked format exactly:
+     *   keccak256(abi.encodePacked("Link wallet ", wallet, " to Exagent ", agentId, " nonce ", nonce))
      * @param wallet The wallet to link
      * @param agentId The agent ID to link to
      * @param nonce The current nonce for the wallet
-     * @returns Message to sign
+     * @returns Raw packed bytes as hex string
      */
-    static generateLinkMessage(wallet: Address, agentId: bigint, nonce: bigint): string;
+    static generateLinkMessage(wallet: Address, agentId: bigint, nonce: bigint): Hex;
     /**
      * Get the agent owned by a wallet (not linked, owned)
      * @param wallet The wallet to look up
@@ -2164,6 +2166,14 @@ declare class ExagentClient {
      * Get the agent's wallet address
      */
     get address(): Address;
+    /**
+     * Sign a message with the wallet's private key (EIP-191 personal sign)
+     * @param message The message to sign — string for UTF-8, or { raw: Hex } for raw bytes
+     * @returns The signature
+     */
+    signMessage(message: string | {
+        raw: `0x${string}`;
+    }): Promise<`0x${string}`>;
     private uploadMetadata;
     private signIntent;
     private parseAgentIdFromReceipt;

package/dist/index.js

@@ -38,10 +38,11 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var import_viem = require("viem");
+var import_viem2 = require("viem");
 var import_accounts = require("viem/accounts");
 
 // src/contracts/registry.ts
+var import_viem = require("viem");
 var EXAGENT_REGISTRY_ABI = [
   {
     type: "function",
@@ -510,14 +511,19 @@ var ExagentRegistry = class {
     return nextId;
   }
   /**
-   * Generate the message to sign for wallet linking
+   * Generate the raw packed message bytes for wallet linking.
+   * Must match the contract's abi.encodePacked format exactly:
+   *   keccak256(abi.encodePacked("Link wallet ", wallet, " to Exagent ", agentId, " nonce ", nonce))
    * @param wallet The wallet to link
    * @param agentId The agent ID to link to
    * @param nonce The current nonce for the wallet
-   * @returns Message to sign
+   * @returns Raw packed bytes as hex string
    */
   static generateLinkMessage(wallet, agentId, nonce) {
-    return `Link wallet ${wallet} to Exagent ${agentId} nonce ${nonce}`;
+    return (0, import_viem.encodePacked)(
+      ["string", "address", "string", "uint256", "string", "uint256"],
+      ["Link wallet ", wallet, " to Exagent ", agentId, " nonce ", nonce]
+    );
   }
   // ============ V4: One Agent Per Wallet ============
   /**
@@ -649,8 +655,8 @@ var ExagentRegistry = class {
    * @returns keccak256 hash of the config
    */
   static calculateConfigHash(provider, model) {
-    const { keccak256, encodePacked } = require("viem");
-    return keccak256(encodePacked(["string", "string"], [provider, model]));
+    const { keccak256, encodePacked: encodePacked2 } = require("viem");
+    return keccak256(encodePacked2(["string", "string"], [provider, model]));
   }
 };
 
@@ -1847,12 +1853,21 @@ var EXAGENT_API_CONFIG = {
   mainnet: "https://api.exagent.io",
   testnet: "https://api.testnet.exagent.io"
 };
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+function validateContractAddresses(network) {
+  const addresses = CONTRACT_ADDRESSES[network];
+  const zeroEntries = Object.entries(addresses).filter(([, addr]) => addr === ZERO_ADDRESS);
+  if (network === "mainnet" && zeroEntries.length > 0) {
+    const missing = zeroEntries.map(([name]) => name).join(", ");
+    throw new Error(
+      `Mainnet contracts not yet deployed. Missing addresses: ${missing}. Deploy contracts before using the SDK on mainnet.`
+    );
+  }
+}
 
 // src/client.ts
 var ExagentClient = class {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   publicClient;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   walletClient;
   account;
   network;
@@ -1865,20 +1880,21 @@ var ExagentClient = class {
   constructor(config) {
     this.network = config.network ?? "testnet";
     this.apiKey = config.apiKey;
+    validateContractAddresses(this.network);
     const chain = CHAIN_CONFIG[this.network];
-    this.publicClient = (0, import_viem.createPublicClient)({
+    this.publicClient = (0, import_viem2.createPublicClient)({
       chain,
-      transport: (0, import_viem.http)(config.rpcUrl)
+      transport: (0, import_viem2.http)(config.rpcUrl)
     });
     if (config.walletClient) {
       this.walletClient = config.walletClient;
       this.account = config.walletClient.account;
     } else if (config.privateKey) {
       this.account = (0, import_accounts.privateKeyToAccount)(config.privateKey);
-      this.walletClient = (0, import_viem.createWalletClient)({
+      this.walletClient = (0, import_viem2.createWalletClient)({
         account: this.account,
         chain,
-        transport: (0, import_viem.http)(config.rpcUrl)
+        transport: (0, import_viem2.http)(config.rpcUrl)
       });
     } else {
       throw new Error("Either privateKey or walletClient must be provided");
@@ -2427,6 +2443,14 @@ var ExagentClient = class {
   get address() {
     return this.account.address;
   }
+  /**
+   * Sign a message with the wallet's private key (EIP-191 personal sign)
+   * @param message The message to sign — string for UTF-8, or { raw: Hex } for raw bytes
+   * @returns The signature
+   */
+  async signMessage(message) {
+    return this.walletClient.signMessage({ account: this.account, message });
+  }
   async uploadMetadata(metadata) {
     const apiUrl = EXAGENT_API_CONFIG[this.network];
     const response = await fetch(`${apiUrl}/v1/metadata/upload`, {

package/dist/index.mjs

@@ -14,6 +14,9 @@ import {
 import { privateKeyToAccount } from "viem/accounts";
 
 // src/contracts/registry.ts
+import {
+  encodePacked
+} from "viem";
 var EXAGENT_REGISTRY_ABI = [
   {
     type: "function",
@@ -482,14 +485,19 @@ var ExagentRegistry = class {
     return nextId;
   }
   /**
-   * Generate the message to sign for wallet linking
+   * Generate the raw packed message bytes for wallet linking.
+   * Must match the contract's abi.encodePacked format exactly:
+   *   keccak256(abi.encodePacked("Link wallet ", wallet, " to Exagent ", agentId, " nonce ", nonce))
    * @param wallet The wallet to link
    * @param agentId The agent ID to link to
    * @param nonce The current nonce for the wallet
-   * @returns Message to sign
+   * @returns Raw packed bytes as hex string
    */
   static generateLinkMessage(wallet, agentId, nonce) {
-    return `Link wallet ${wallet} to Exagent ${agentId} nonce ${nonce}`;
+    return encodePacked(
+      ["string", "address", "string", "uint256", "string", "uint256"],
+      ["Link wallet ", wallet, " to Exagent ", agentId, " nonce ", nonce]
+    );
   }
   // ============ V4: One Agent Per Wallet ============
   /**
@@ -621,8 +629,8 @@ var ExagentRegistry = class {
    * @returns keccak256 hash of the config
    */
   static calculateConfigHash(provider, model) {
-    const { keccak256, encodePacked } = __require("viem");
-    return keccak256(encodePacked(["string", "string"], [provider, model]));
+    const { keccak256, encodePacked: encodePacked2 } = __require("viem");
+    return keccak256(encodePacked2(["string", "string"], [provider, model]));
   }
 };
 
@@ -1819,12 +1827,21 @@ var EXAGENT_API_CONFIG = {
   mainnet: "https://api.exagent.io",
   testnet: "https://api.testnet.exagent.io"
 };
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+function validateContractAddresses(network) {
+  const addresses = CONTRACT_ADDRESSES[network];
+  const zeroEntries = Object.entries(addresses).filter(([, addr]) => addr === ZERO_ADDRESS);
+  if (network === "mainnet" && zeroEntries.length > 0) {
+    const missing = zeroEntries.map(([name]) => name).join(", ");
+    throw new Error(
+      `Mainnet contracts not yet deployed. Missing addresses: ${missing}. Deploy contracts before using the SDK on mainnet.`
+    );
+  }
+}
 
 // src/client.ts
 var ExagentClient = class {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   publicClient;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   walletClient;
   account;
   network;
@@ -1837,6 +1854,7 @@ var ExagentClient = class {
   constructor(config) {
     this.network = config.network ?? "testnet";
     this.apiKey = config.apiKey;
+    validateContractAddresses(this.network);
     const chain = CHAIN_CONFIG[this.network];
     this.publicClient = createPublicClient({
       chain,
@@ -2399,6 +2417,14 @@ var ExagentClient = class {
   get address() {
     return this.account.address;
   }
+  /**
+   * Sign a message with the wallet's private key (EIP-191 personal sign)
+   * @param message The message to sign — string for UTF-8, or { raw: Hex } for raw bytes
+   * @returns The signature
+   */
+  async signMessage(message) {
+    return this.walletClient.signMessage({ account: this.account, message });
+  }
   async uploadMetadata(metadata) {
     const apiUrl = EXAGENT_API_CONFIG[this.network];
     const response = await fetch(`${apiUrl}/v1/metadata/upload`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exagent/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TypeScript SDK for Exagent",
   "main": "dist/index.js",
   "module": "dist/index.mjs",