agent0-sdk 0.31.0 → 1.0.2

package/README.md

@@ -4,7 +4,7 @@ Agent0 is the TypeScript SDK for agentic economies. It enables agents to registe
 
 ## What Does Agent0 SDK Do?
 
-Agent0 SDK v0.31 enables you to:
+Agent0 SDK v1.0.2 enables you to:
 
 - **Create and manage agent identities** - Register your AI agent on-chain with a unique identity, configure presentation fields (name, description, image), set wallet addresses, and manage trust models with x402 support
 - **Advertise agent capabilities** - Publish MCP and A2A endpoints, with automated extraction of MCP tools and A2A skills from endpoints
@@ -16,15 +16,17 @@ Agent0 SDK v0.31 enables you to:
 
 ## ⚠️ Alpha Release
 
-Agent0 SDK v0.31 is in **alpha** with bugs and is not production ready. We're actively testing and improving it.
+Agent0 SDK v1.0.2 is in **alpha** with bugs and is not production ready. We're actively testing and improving it.
 
-**Bug reports & feedback:** GitHub: [Report issues](https://github.com/agent0lab/agent0-ts/issues) | Telegram: [@marcoderossi](https://t.me/marcoderossi) | Email: marco.derossi@consensys.net
+For breaking changes and migration notes, see `release_notes/RELEASE_NOTES_1.0.2.md`.
+
+**Bug reports & feedback:** GitHub: [Report issues](https://github.com/agent0lab/agent0-ts/issues) | Telegram: [Agent0 channel](https://t.me/agent0kitchen) | Email: team@ag0.xyz
 
 ## Installation
 
 ### Prerequisites
 
-- Node.js 18 or higher
+- Node.js 22 or higher
 - npm or yarn package manager
 - Private key for signing transactions (or run in read-only mode)
 - Access to an Ethereum RPC endpoint (e.g., Alchemy, Infura)
@@ -64,7 +66,7 @@ import { SDK } from 'agent0-sdk';
 const sdk = new SDK({
   chainId: 11155111, // Ethereum Sepolia testnet
   rpcUrl: process.env.RPC_URL!,
-  signer: process.env.PRIVATE_KEY, // Optional: for write operations
+  signer: process.env.PRIVATE_KEY ?? process.env.AGENT_PRIVATE_KEY, // Optional: for write operations
   ipfs: 'pinata', // Options: 'pinata', 'filecoinPin', 'node'
   pinataJwt: process.env.PINATA_JWT // For Pinata
   // Subgraph URL auto-defaults from DEFAULT_SUBGRAPH_URLS
@@ -88,12 +90,13 @@ agent.setENS('myagent.eth');
 
 // Add OASF skills and domains (standardized taxonomies)
 agent.addSkill('data_engineering/data_transformation_pipeline', true);
-agent.addSkill('natural_language_processing/summarization', true);
+agent.addSkill('natural_language_processing/natural_language_generation/summarization', true);
 agent.addDomain('finance_and_business/investment_services', true);
-agent.addDomain('technology/data_science', true);
+agent.addDomain('technology/data_science/data_science', true);
 
-// Configure wallet and trust
-agent.setAgentWallet('0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb', 11155111);
+// Optionally set a dedicated agent wallet on-chain (requires new wallet signature).
+// If you want agentWallet = owner wallet, you can skip this (contract sets initial value to owner).
+// await agent.setAgentWallet('0x...', { newWalletSigner: process.env.NEW_WALLET_PRIVATE_KEY });
 agent.setTrust(true, true, false); // reputation, cryptoEconomic, teeAttestation
 
 // Add metadata and set status
@@ -174,26 +177,15 @@ const allResults = await sdk.searchAgents({
 
 // Search agents by reputation across chains
 const reputationResults = await sdk.searchAgentsByReputation(
-  undefined, // agents
-  undefined, // tags
-  undefined, // reviewers
-  undefined, // capabilities
-  undefined, // skills
-  undefined, // tasks
-  undefined, // names
-  80, // minAverageScore
-  false, // includeRevoked
-  20, // pageSize
-  undefined, // cursor
-  undefined, // sort
-  [11155111, 84532] // chains
+  { minAverageScore: 80 },
+  { includeRevoked: false, pageSize: 20, chains: [11155111, 84532] }
 );
 
 // Get agent from specific chain
 const agent = await sdk.getAgent('84532:123'); // Base Sepolia
 
 // Search feedback for agent on specific chain
-const feedbacks = await sdk.searchFeedback('84532:123'); // Base Sepolia
+const feedbacks = await sdk.searchFeedback({ agentId: '84532:123' }); // Base Sepolia
 
 // Get reputation summary for agent on specific chain
 const summary = await sdk.getReputationSummary('84532:123'); // Base Sepolia
@@ -202,28 +194,28 @@ const summary = await sdk.getReputationSummary('84532:123'); // Base Sepolia
 ### 5. Give and Retrieve Feedback
 
 ```typescript
-// Prepare feedback (only score is mandatory)
-const feedbackFile = sdk.prepareFeedback(
+// Optional: prepare an OFF-CHAIN feedback file (only needed for rich fields)
+const feedbackFile = sdk.prepareFeedbackFile({
+  capability: 'tools',
+  name: 'code_generation',
+  skill: 'python',
+  context: { sessionId: 'abc' },
+});
+
+// Give feedback (on-chain fields are passed directly)
+const feedback = await sdk.giveFeedback(
   '11155111:123',
-  85, // 0-100 (mandatory)
-  ['data_analyst', 'finance'], // Optional: tags
-  undefined, // Optional: text
-  'tools', // Optional: capability (MCP capability)
-  'code_generation', // Optional: name (MCP tool name)
-  'python' // Optional: skill (A2A skill)
+  85, // score (0-100)
+  'data_analyst', // tag1 (optional)
+  'finance', // tag2 (optional)
+  'https://api.example.com/feedback', // endpoint (optional on-chain)
+  feedbackFile // optional off-chain file
 );
 
-// Give feedback
-const feedback = await sdk.giveFeedback('11155111:123', feedbackFile);
-
 // Search feedback
 const feedbackResults = await sdk.searchFeedback(
-  '11155111:123',
-  undefined, // tags
-  ['tools'], // capabilities
-  undefined, // skills
-  80, // minScore
-  100 // maxScore
+  { agentId: '11155111:123', capabilities: ['tools'] },
+  { minScore: 80, maxScore: 100 }
 );
 
 // Get reputation summary
@@ -283,8 +275,8 @@ Use `chainId:agentId` format to specify which chain an agent is on:
 const agent = await sdk.getAgent('84532:1234');  // Base Sepolia
 
 // Search feedback for agent on specific chain
-const feedbacks = await sdk.searchFeedback('84532:1234');  // Base Sepolia
-const feedbacksDefault = await sdk.searchFeedback('1234');  // Uses default chain
+const feedbacks = await sdk.searchFeedback({ agentId: '84532:1234' });  // Base Sepolia
+const feedbacksDefault = await sdk.searchFeedback({ agentId: '11155111:1234' });  // Default chain
 
 // Get reputation summary for agent on specific chain
 const summary = await sdk.getReputationSummary('84532:1234');  // Base Sepolia
@@ -310,26 +302,14 @@ const allChainsResult = await sdk.searchAgents({
 
 // Multi-chain reputation search
 const reputationResult = await sdk.searchAgentsByReputation(
-  undefined, // agents
-  undefined, // tags
-  undefined, // reviewers
-  undefined, // capabilities
-  undefined, // skills
-  undefined, // tasks
-  undefined, // names
-  80, // minAverageScore
-  false, // includeRevoked
-  20, // pageSize
-  undefined, // cursor
-  undefined, // sort
-  [11155111, 84532]  // Multiple chains
+  { minAverageScore: 80 },
+  { includeRevoked: false, pageSize: 20, chains: [11155111, 84532] }
 );
 
 // Search all chains for agents with reputation
 const allChainsReputation = await sdk.searchAgentsByReputation(
-  undefined, undefined, undefined, undefined, undefined, undefined, undefined,
-  80, false, 20, undefined, undefined,
-  'all'  // All configured chains
+  { minAverageScore: 80 },
+  { includeRevoked: false, pageSize: 20, chains: 'all' }
 );
 
 // Access metadata about queried chains
@@ -396,7 +376,7 @@ OASF skills and domains appear in your agent's registration file:
       ],
       "domains": [
         "finance_and_business/investment_services",
-        "technology/data_science"
+        "technology/data_science/data_science"
       ]
     }
   ]
@@ -409,7 +389,7 @@ The SDK includes complete OASF v0.8.0 taxonomy files:
 - **Skills**: `src/taxonomies/all_skills.json` (136 skills)
 - **Domains**: `src/taxonomies/all_domains.json` (204 domains)
 
-Browse these files to find appropriate skill and domain slugs. For more information, see the [OASF specification](https://github.com/agntcy/oasf) and [Release Notes v0.31](RELEASE_NOTES_0.31.md).
+Browse these files to find appropriate skill and domain slugs. For more information, see the [OASF specification](https://github.com/agntcy/oasf) and `release_notes/RELEASE_NOTES_0.31.md`.
 
 ## 🚀 Coming Soon
 

package/dist/core/agent.d.ts

@@ -1,8 +1,10 @@
 /**
  * Agent class for managing individual agents
  */
+import { ethers } from 'ethers';
 import type { RegistrationFile } from '../models/interfaces.js';
 import type { AgentId, Address, URI } from '../models/types.js';
+import { EndpointType } from '../models/enums.js';
 import type { SDK } from './sdk.js';
 /**
  * Agent class for managing individual agents
@@ -31,12 +33,40 @@ export declare class Agent {
     setMCP(endpoint: string, version?: string, autoFetch?: boolean): Promise<this>;
     setA2A(agentcard: string, version?: string, autoFetch?: boolean): Promise<this>;
     setENS(name: string, version?: string): this;
+    /**
+     * Remove endpoint(s) with wildcard semantics (parity with Python SDK).
+     *
+     * - If no args are provided, removes all endpoints.
+     * - If only `type` is provided, removes all endpoints of that type.
+     * - If only `value` is provided, removes all endpoints with that value.
+     * - If both are provided, removes endpoints that match both.
+     */
+    removeEndpoint(): this;
+    removeEndpoint(opts: {
+        type?: EndpointType;
+        value?: string;
+    }): this;
+    removeEndpoint(type?: EndpointType, value?: string): this;
+    /**
+     * Remove all endpoints.
+     */
+    removeEndpoints(): this;
     private _getOrCreateOasfEndpoint;
     addSkill(slug: string, validateOASF?: boolean): this;
     removeSkill(slug: string): this;
     addDomain(slug: string, validateOASF?: boolean): this;
     removeDomain(slug: string): this;
-    setAgentWallet(address: Address, chainId: number): this;
+    /**
+     * Set agent wallet on-chain with EIP-712 signature verification (ERC-8004 Jan 2026).
+     *
+     * This is a clean breaking API: it is on-chain only.
+     * If the agent is not registered yet, this throws.
+     */
+    setAgentWallet(newWallet: Address, opts?: {
+        deadline?: number;
+        newWalletSigner?: string | ethers.Signer;
+        signature?: string | Uint8Array;
+    }): Promise<string>;
     setActive(active: boolean): this;
     setX402Support(x402Support: boolean): this;
     setTrust(reputation?: boolean, cryptoEconomic?: boolean, teeAttestation?: boolean): this;
@@ -59,7 +89,7 @@ export declare class Agent {
     /**
      * Set agent URI (for updates)
      */
-    setAgentUri(agentUri: string): Promise<void>;
+    setAgentURI(agentURI: string): Promise<void>;
     /**
      * Transfer agent ownership
      */

package/dist/core/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"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"}

package/dist/core/agent.js

@@ -139,6 +139,31 @@ export class Agent {
         this.registrationFile.updatedAt = Math.floor(Date.now() / 1000);
         return this;
     }
+    removeEndpoint(arg1, arg2) {
+        const { type, value } = arg1 && typeof arg1 === 'object'
+            ? { type: arg1.type, value: arg1.value }
+            : { type: arg1, value: arg2 };
+        if (type === undefined && value === undefined) {
+            // Remove all endpoints
+            this.registrationFile.endpoints = [];
+        }
+        else {
+            // Remove matching endpoints (wildcard semantics)
+            this.registrationFile.endpoints = this.registrationFile.endpoints.filter((ep) => {
+                const typeMatches = type === undefined || ep.type === type;
+                const valueMatches = value === undefined || ep.value === value;
+                return !(typeMatches && valueMatches);
+            });
+        }
+        this.registrationFile.updatedAt = Math.floor(Date.now() / 1000);
+        return this;
+    }
+    /**
+     * Remove all endpoints.
+     */
+    removeEndpoints() {
+        return this.removeEndpoint();
+    }
     // OASF endpoint management
     _getOrCreateOasfEndpoint() {
         // Find existing OASF endpoint
@@ -255,15 +280,212 @@ export class Agent {
         }
         return this;
     }
-    setAgentWallet(address, chainId) {
-        this.registrationFile.walletAddress = address;
-        this.registrationFile.walletChainId = chainId;
-        // Check if wallet changed
-        if (address !== this._lastRegisteredWallet) {
-            this._dirtyMetadata.add('agentWallet');
+    /**
+     * Set agent wallet on-chain with EIP-712 signature verification (ERC-8004 Jan 2026).
+     *
+     * This is a clean breaking API: it is on-chain only.
+     * If the agent is not registered yet, this throws.
+     */
+    async setAgentWallet(newWallet, opts) {
+        if (!this.registrationFile.agentId) {
+            throw new Error('Agent must be registered before setting agentWallet on-chain. ' +
+                'Register the agent first, then call setAgentWallet().');
+        }
+        if (!this.sdk.web3Client.signer) {
+            throw new Error('No SDK signer available to submit setAgentWallet transaction');
+        }
+        // Validate newWallet address
+        if (!this.sdk.web3Client.isAddress(newWallet)) {
+            throw new Error(`Invalid newWallet address: ${newWallet}`);
+        }
+        const { tokenId } = parseAgentId(this.registrationFile.agentId);
+        const identityRegistry = this.sdk.getIdentityRegistry();
+        // Optional short-circuit if already set
+        try {
+            const currentWallet = await this.sdk.web3Client.callContract(identityRegistry, 'getAgentWallet', BigInt(tokenId));
+            if (typeof currentWallet === 'string' &&
+                currentWallet.toLowerCase() === newWallet.toLowerCase()) {
+                const chainId = await this.sdk.chainId();
+                this.registrationFile.walletAddress = newWallet;
+                this.registrationFile.walletChainId = chainId;
+                this.registrationFile.updatedAt = Math.floor(Date.now() / 1000);
+                return '';
+            }
+        }
+        catch {
+            // ignore and proceed
+        }
+        // Deadline: contract enforces a short window. Use chain time (latest block timestamp)
+        // rather than local system time to avoid clock skew causing reverts.
+        const latestBlock = await this.sdk.web3Client.provider.getBlock('latest');
+        const chainNow = latestBlock?.timestamp ?? Math.floor(Date.now() / 1000);
+        const deadlineValue = opts?.deadline ?? chainNow + 60;
+        if (deadlineValue < chainNow) {
+            throw new Error(`Invalid deadline: ${deadlineValue} is in the past (chain time: ${chainNow})`);
+        }
+        if (deadlineValue > chainNow + 300) {
+            throw new Error(`Invalid deadline: ${deadlineValue} is too far in the future. ` +
+                `ERC-8004 setAgentWallet requires a short deadline (<= chainTime + 300s). ` +
+                `(chain time: ${chainNow})`);
+        }
+        const chainId = await this.sdk.chainId();
+        const verifyingContract = await identityRegistry.getAddress();
+        const owner = await this.sdk.web3Client.callContract(identityRegistry, 'ownerOf', BigInt(tokenId));
+        // Prefer reading the actual EIP-712 domain from the contract (if supported)
+        // to avoid any future divergence in name/version.
+        let domainName;
+        let domainVersion;
+        try {
+            const domainInfo = await this.sdk.web3Client.callContract(identityRegistry, 'eip712Domain');
+            // eip712Domain() returns: (fields, name, version, chainId, verifyingContract, salt, extensions)
+            // In ethers v6 this is typically a Result array-like object.
+            domainName = domainInfo?.name ?? domainInfo?.[1];
+            domainVersion = domainInfo?.version ?? domainInfo?.[2];
+        }
+        catch {
+            // ignore and use defaults
+        }
+        // If the contract exposes a domain separator, try to select a matching (name, version)
+        // deterministically from common candidates.
+        let domainSeparatorOnChain;
+        try {
+            domainSeparatorOnChain = await this.sdk.web3Client.callContract(identityRegistry, 'DOMAIN_SEPARATOR');
+        }
+        catch {
+            // ignore
+        }
+        // Preflight estimateGas to catch signature/domain/type mismatches early.
+        const estimateSetAgentWallet = async (sig) => {
+            const fn = identityRegistry.getFunction
+                ? identityRegistry.getFunction('setAgentWallet')
+                : null;
+            if (fn?.estimateGas) {
+                await fn.estimateGas(BigInt(tokenId), newWallet, BigInt(deadlineValue), sig);
+            }
+            else if (identityRegistry.estimateGas?.setAgentWallet) {
+                await identityRegistry.estimateGas.setAgentWallet(BigInt(tokenId), newWallet, BigInt(deadlineValue), sig);
+            }
+        };
+        // Determine signature
+        let signature;
+        if (opts?.signature) {
+            signature =
+                typeof opts.signature === 'string' ? opts.signature : ethers.hexlify(opts.signature);
+            if (!signature.startsWith('0x')) {
+                signature = `0x${signature}`;
+            }
         }
+        else {
+            // The new wallet MUST sign (EOA path). Support a few domain/type variants to match deployed registries.
+            const signerForNewWallet = opts?.newWalletSigner;
+            const sdkSignerAddress = await this.sdk.web3Client.getAddress();
+            // If no explicit signer was provided, allow the one-wallet case (SDK signer == newWallet)
+            if (!signerForNewWallet) {
+                if (!sdkSignerAddress || sdkSignerAddress.toLowerCase() !== newWallet.toLowerCase()) {
+                    throw new Error(`The new wallet must sign the EIP-712 message. ` +
+                        `Pass opts.newWalletSigner (private key or Signer) or opts.signature. ` +
+                        `SDK signer is ${sdkSignerAddress || 'unknown'}, newWallet is ${newWallet}.`);
+                }
+            }
+            else {
+                const signerAddress = await this.sdk.web3Client.addressOf(signerForNewWallet);
+                if (signerAddress.toLowerCase() !== newWallet.toLowerCase()) {
+                    throw new Error(`newWalletSigner address (${signerAddress}) does not match newWallet (${newWallet}).`);
+                }
+            }
+            const domainNames = [];
+            if (domainName)
+                domainNames.push(domainName);
+            // Common known names across deployments/spec revisions
+            domainNames.push('ERC8004IdentityRegistry', 'IdentityRegistry', 'ERC8004IdentityRegistryUpgradeable', 'IdentityRegistryUpgradeable');
+            const domainVersions = [domainVersion || '1', '1'];
+            // If we have a domain separator, prefer the (name, version) that matches it.
+            if (domainSeparatorOnChain) {
+                const match = domainNames.flatMap((dn) => domainVersions.map((dv) => ({ dn, dv }))).find(({ dn, dv }) => {
+                    try {
+                        const computed = ethers.TypedDataEncoder.hashDomain({
+                            name: dn,
+                            version: dv,
+                            chainId,
+                            verifyingContract,
+                        });
+                        return computed.toLowerCase() === String(domainSeparatorOnChain).toLowerCase();
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                if (match) {
+                    domainNames.unshift(match.dn);
+                    domainVersions.unshift(match.dv);
+                }
+            }
+            // Try (with owner) first, then (no owner) legacy; and try each domain name.
+            const variants = [];
+            for (const dn of domainNames) {
+                for (const dv of domainVersions) {
+                    variants.push(this.sdk.web3Client.buildAgentWalletSetTypedData({
+                        agentId: BigInt(tokenId),
+                        newWallet,
+                        owner,
+                        deadline: BigInt(deadlineValue),
+                        chainId,
+                        verifyingContract,
+                        domainName: dn,
+                        domainVersion: dv,
+                    }));
+                    variants.push(this.sdk.web3Client.buildAgentWalletSetTypedDataNoOwner({
+                        agentId: BigInt(tokenId),
+                        newWallet,
+                        deadline: BigInt(deadlineValue),
+                        chainId,
+                        verifyingContract,
+                        domainName: dn,
+                        domainVersion: dv,
+                    }));
+                }
+            }
+            let lastError;
+            const trySignAndEstimate = async (signerMode) => {
+                for (const v of variants) {
+                    try {
+                        const sig = signerMode === 'newWallet'
+                            ? signerForNewWallet
+                                ? await this.sdk.web3Client.signTypedDataWith(signerForNewWallet, v.domain, v.types, v.message)
+                                : await this.sdk.web3Client.signTypedData(v.domain, v.types, v.message)
+                            : await this.sdk.web3Client.signTypedData(v.domain, v.types, v.message);
+                        const recovered = this.sdk.web3Client.recoverTypedDataSigner(v.domain, v.types, v.message, sig);
+                        const expected = signerMode === 'newWallet' ? newWallet.toLowerCase() : (sdkSignerAddress || '').toLowerCase();
+                        if (!expected || recovered.toLowerCase() !== expected) {
+                            throw new Error(`EIP-712 signature recovery mismatch (${signerMode} signing): recovered ${recovered} but expected ${expected || 'unknown'}`);
+                        }
+                        await estimateSetAgentWallet(sig);
+                        signature = sig;
+                        return;
+                    }
+                    catch (e) {
+                        lastError = e;
+                    }
+                }
+            };
+            // Preferred: newWallet signs (spec-aligned)
+            await trySignAndEstimate('newWallet');
+            // Fallback: some legacy deployments may require the agent owner (tx sender) to sign instead.
+            if (!signature && sdkSignerAddress) {
+                await trySignAndEstimate('owner');
+            }
+            if (!signature) {
+                const msg = lastError instanceof Error ? lastError.message : String(lastError);
+                throw new Error(`Failed to produce a valid setAgentWallet signature for this registry: ${msg}`);
+            }
+        }
+        // Call contract function (tx sender is SDK signer: owner/operator)
+        const txHash = await this.sdk.web3Client.transactContract(identityRegistry, 'setAgentWallet', {}, BigInt(tokenId), newWallet, BigInt(deadlineValue), signature);
+        // Update local registration file
+        this.registrationFile.walletAddress = newWallet;
+        this.registrationFile.walletChainId = chainId;
         this.registrationFile.updatedAt = Math.floor(Date.now() / 1000);
-        return this;
+        return txHash;
     }
     setActive(active) {
         this.registrationFile.active = active;
@@ -352,13 +574,13 @@ export class Agent {
             }
             // Update agent URI on-chain
             const { tokenId } = parseAgentId(this.registrationFile.agentId);
-            const txHash = await this.sdk.web3Client.transactContract(this.sdk.getIdentityRegistry(), 'setAgentUri', {}, BigInt(tokenId), `ipfs://${ipfsCid}`);
+            const txHash = await this.sdk.web3Client.transactContract(this.sdk.getIdentityRegistry(), 'setAgentURI', {}, BigInt(tokenId), `ipfs://${ipfsCid}`);
             // Wait for transaction to be confirmed (30 second timeout like Python)
             // If timeout, continue - transaction was sent and will eventually confirm
             try {
                 await this.sdk.web3Client.waitForTransaction(txHash, TIMEOUTS.TRANSACTION_WAIT);
             }
-            catch (error) {
+            catch {
                 // Transaction was sent and will eventually confirm - continue silently
             }
             // Clear dirty flags
@@ -378,7 +600,7 @@ export class Agent {
             const ipfsCid = await this.sdk.ipfsClient.addRegistrationFile(this.registrationFile, chainId, identityRegistryAddress);
             // Step 3: Set agent URI on-chain
             const { tokenId } = parseAgentId(this.registrationFile.agentId);
-            const txHash = await this.sdk.web3Client.transactContract(this.sdk.getIdentityRegistry(), 'setAgentUri', {}, BigInt(tokenId), `ipfs://${ipfsCid}`);
+            const txHash = await this.sdk.web3Client.transactContract(this.sdk.getIdentityRegistry(), 'setAgentURI', {}, BigInt(tokenId), `ipfs://${ipfsCid}`);
             // Wait for transaction to be confirmed
             await this.sdk.web3Client.waitForTransaction(txHash);
             // Clear dirty flags
@@ -399,7 +621,7 @@ export class Agent {
         }
         if (this.registrationFile.agentId) {
             // Agent already registered - update agent URI
-            await this.setAgentUri(agentUri);
+            await this.setAgentURI(agentUri);
             return this.registrationFile;
         }
         else {
@@ -410,13 +632,13 @@ export class Agent {
     /**
      * Set agent URI (for updates)
      */
-    async setAgentUri(agentUri) {
+    async setAgentURI(agentURI) {
         if (!this.registrationFile.agentId) {
             throw new Error('Agent must be registered before setting URI');
         }
         const { tokenId } = parseAgentId(this.registrationFile.agentId);
-        await this.sdk.web3Client.transactContract(this.sdk.getIdentityRegistry(), 'setAgentUri', {}, BigInt(tokenId), agentUri);
-        this.registrationFile.agentURI = agentUri;
+        await this.sdk.web3Client.transactContract(this.sdk.getIdentityRegistry(), 'setAgentURI', {}, BigInt(tokenId), agentURI);
+        this.registrationFile.agentURI = agentURI;
         this.registrationFile.updatedAt = Math.floor(Date.now() / 1000);
     }
     /**
@@ -509,8 +731,8 @@ export class Agent {
         // Update metadata one by one (like Python SDK)
         // Only send transactions for dirty (changed) metadata keys
         for (const entry of metadataEntries) {
-            if (this._dirtyMetadata.has(entry.key)) {
-                const txHash = await this.sdk.web3Client.transactContract(identityRegistry, 'setMetadata', {}, BigInt(tokenId), entry.key, entry.value);
+            if (this._dirtyMetadata.has(entry.metadataKey)) {
+                const txHash = await this.sdk.web3Client.transactContract(identityRegistry, 'setMetadata', {}, BigInt(tokenId), entry.metadataKey, entry.metadataValue);
                 // Wait with 30 second timeout (like Python SDK)
                 // If timeout, log warning but continue - transaction was sent and will eventually confirm
                 try {
@@ -524,16 +746,15 @@ export class Agent {
     }
     _collectMetadataForRegistration() {
         const entries = [];
-        // Collect wallet address if set
-        if (this.registrationFile.walletAddress && this.registrationFile.walletChainId) {
-            const walletValue = `eip155:${this.registrationFile.walletChainId}:${this.registrationFile.walletAddress}`;
-            entries.push({
-                key: 'agentWallet',
-                value: new TextEncoder().encode(walletValue),
-            });
-        }
+        // Note: agentWallet is now a reserved metadata key that cannot be set via setMetadata()
+        // It must be set using setAgentWallet() with EIP-712 signature verification
+        // We do not include it in metadata entries here
         // Collect custom metadata
         for (const [key, value] of Object.entries(this.registrationFile.metadata)) {
+            // Skip agentWallet if it somehow got into metadata
+            if (key === 'agentWallet') {
+                continue;
+            }
             let valueBytes;
             if (typeof value === 'string') {
                 valueBytes = new TextEncoder().encode(value);
@@ -544,7 +765,7 @@ export class Agent {
             else {
                 valueBytes = new TextEncoder().encode(JSON.stringify(value));
             }
-            entries.push({ key, value: valueBytes });
+            entries.push({ metadataKey: key, metadataValue: valueBytes });
         }
         return entries;
     }