@agentxv2/sdk 0.5.1 → 0.5.3

package/README.md

@@ -1,6 +1,6 @@
-# @agentxv2/sdk v0.2.0
+# @agentxv2/sdk v0.5.1
 
-**Decentralized AI Agent Platform SDK** — E2E encryption, on-chain subscriptions, MCP tool execution.
+**Decentralized AI Agent Platform SDK** — E2E encryption, on-chain subscriptions, MCP tool execution, A2A delegation.
 
 ```
 Agent = Prompt + Skills[] + MCP
@@ -82,17 +82,21 @@ const packResult = packAgentForPublish(agentPayload, publicKey, aesKey)
 ## Architecture
 
 ```
-┌────────────────────────────────────────────────────┐
-│                    @agentxv2/sdk                      │
-├──────────┬──────────┬──────────┬──────────────────┤
-│  Core    │  Agent   │  MCP     │  React           │
-│ crypto   │ Runner   │ Connector│  useAgentRunner  │
-│ types    │ useAgent │ callTool │                  │
-├──────────┼──────────┼──────────┼──────────────────┤
-│ Registry │ Subscrip │ A2A      │ Reputation       │
-│ register │ subscribe│ protocol │ giveFeedback     │
-│ query    │ verify   │          │                  │
-└──────────┴──────────┴──────────┴──────────────────┘
+┌──────────────────────────────────────────────────────────────────┐
+│                        @agentxv2/sdk                               │
+├──────────┬──────────┬──────────┬──────────┬──────────────────────┤
+│  Core    │  Agent   │  MCP     │  React   │ A2A                  │
+│ crypto   │ Runner   │ Connector│ hooks    │ Agent-to-Agent       │
+│ types    │ useAgent │ callTool │          │ createTask/complete   │
+├──────────┼──────────┼──────────┼──────────┼──────────────────────┤
+│ Registry │ Subscrip │ A2A-X402 │ Reputation│ Endpoint            │
+│ register │ subscribe│ auto-pay │ feedback  │ MultiEndpoint       │
+│ query    │ verify   │ gate     │ stats     │ pickBestEndpoint    │
+├──────────┼──────────┼──────────┼──────────┼──────────────────────┤
+│ Config   │ Config-  │          │          │                      │
+│ store    │ uration  │          │          │                      │
+│ (kv)     │ Client   │          │          │                      │
+└──────────┴──────────┴──────────┴──────────┴──────────────────────┘
 ```
 
 ## API Reference
@@ -111,6 +115,10 @@ const packResult = packAgentForPublish(agentPayload, publicKey, aesKey)
 | `SubscriptionManager` | Subscribe (ETH/ERC20), verify, cancel, trial refund, releaseFunds |
 | `AgentX402` | Auto-subscription gate + X402 payment bridge |
 | `A2AProtocol` | Agent-to-Agent task protocol |
+| `ReputationRegistry` | Give feedback + query reputation |
+| `MultiEndpointClient` | Read/select agent endpoints (HTTP, WebSocket, gRPC) |
+| `ConfigurationClient` | Agent on-chain key-value config store |
+| `ConfigurationRegistry` | Platform-wide config registry (KV store) |
 
 ### Agent Composition (A2A Skills)
 
@@ -128,9 +136,10 @@ An Agent's Skill can delegate to **another Agent**. Set `execution.type = "a2a"`
 }
 ```
 
-When executed, the SDK loads Agent #42's prompt + skills, decrypts them,
-and returns the full sub-Agent context to the calling LLM.
-| `ReputationRegistry` | Give feedback + query reputation |
+When executed, the SDK:
+1. Loads Agent #42's metadata from IPFS
+2. Decrypts with ECIES+AES-256-GCM
+3. Returns the sub-Agent's prompt + skills to the calling LLM
 
 ### `@agentxv2/sdk/react`
 
@@ -194,10 +203,44 @@ Auto-detected via `KNOWN_CHAINS[chainId]`. Pass `chainId` in AgentX constructor
 
 ## On-Chain Contracts
 
-| Contract | Sepolia | OxaChain L1 |
-|----------|---------|-------------|
-| IdentityRegistry | `0xe94a...96e5F` | `0x0292...3902` |
-| SubscriptionManager v3 | `0xC15f...7E63` | `0x37BA...E249` |
+| # | Contract | Sepolia | OxaChain L1 |
+|---|----------|---------|-------------|
+| 1 | IdentityRegistry | `0xe94a...96e5F` | `0xbf5F...E212` |
+| 2 | SubscriptionManager v3 | `0xC15f...7E63` | `0x019A...0E6B` |
+| 3 | ReputationRegistry | `0xeb6B...3DC9` | `0x6a18...843F` |
+| 4 | A2AProtocolRegistry | `0xEdb0...6092` | `0x61b7...5169` |
+| 5 | ConfigurationRegistry | `0x68Dc...EA6c` | `0x0728...D2F8` |
+| 6 | MultiEndpointRegistry | `0xEB5e...21Cb7` | `0xB361...f64c` |
+
+Full addresses in `KNOWN_CHAINS` inside `config.ts`.
+
+## Changelog
+
+### v0.5.1 (2026-07-14)
+- New: `MultiEndpointClient` — getActiveEndpoints, pickBestEndpoint, getBestMCPUrl
+- New: `ConfigurationClient` — get, getAll, getKeys, exists
+- `ChainConfig.contracts` added `multiEndpointRegistry`
+- OxaChain L1 all 6 core contracts deployed
+
+### v0.5.0 (2026-07-14)
+- OxaChain L1 full deployment: `KNOWN_CHAINS[19505]` 6 contract addresses
+
+### v0.4.0 (2026-07-13)
+- Integration test fixes
+- OxaChain L1 added to `KNOWN_CHAINS`
+- IdentityRegistry + SubscriptionManager v3 deployed to OxaChain L1
+
+### v0.3.1 (2026-07-13)
+- Fixed ESM directory import error on Node.js 22 (tsup single-file bundling)
+
+### v0.3.0 (2026-07-12)
+- AgentX402 auto-subscription gate
+- SubscriptionManager v3 (ReentrancyGuard, platformFee=250bps, trial escrow)
+
+### v0.2.0 (2026-07-11)
+- Initial public release
+- AgentRunner, MCPConnector, AgentRegistry, SubscriptionManager, ReputationRegistry
+- ECIES + AES-256-GCM encryption pipeline
 
 ## License
 

package/dist/configuration/index.d.mts

@@ -0,0 +1,31 @@
+import { Address, PublicClient } from 'viem';
+
+/**
+ * ConfigurationRegistry SDK
+ * On-chain key-value config store for AI Agents
+ */
+
+interface ConfigEntry {
+    agentId: bigint;
+    key: string;
+    value: string;
+    dataType: string;
+    updatedAt: bigint;
+    updatedBy: Address;
+}
+interface ConfigurationConfig {
+    address: Address;
+}
+declare class ConfigurationClient {
+    private address;
+    private publicClient;
+    constructor(config: ConfigurationConfig, publicClient?: PublicClient);
+    setPublicClient(client: PublicClient): void;
+    get(agentId: bigint, key: string): Promise<ConfigEntry | null>;
+    getAll(agentId: bigint): Promise<ConfigEntry[]>;
+    getKeys(agentId: bigint): Promise<string[]>;
+    getCount(agentId: bigint): Promise<bigint>;
+    exists(agentId: bigint, key: string): Promise<boolean>;
+}
+
+export { type ConfigEntry, ConfigurationClient, type ConfigurationConfig };

package/dist/configuration/index.d.ts

@@ -0,0 +1,31 @@
+import { Address, PublicClient } from 'viem';
+
+/**
+ * ConfigurationRegistry SDK
+ * On-chain key-value config store for AI Agents
+ */
+
+interface ConfigEntry {
+    agentId: bigint;
+    key: string;
+    value: string;
+    dataType: string;
+    updatedAt: bigint;
+    updatedBy: Address;
+}
+interface ConfigurationConfig {
+    address: Address;
+}
+declare class ConfigurationClient {
+    private address;
+    private publicClient;
+    constructor(config: ConfigurationConfig, publicClient?: PublicClient);
+    setPublicClient(client: PublicClient): void;
+    get(agentId: bigint, key: string): Promise<ConfigEntry | null>;
+    getAll(agentId: bigint): Promise<ConfigEntry[]>;
+    getKeys(agentId: bigint): Promise<string[]>;
+    getCount(agentId: bigint): Promise<bigint>;
+    exists(agentId: bigint, key: string): Promise<boolean>;
+}
+
+export { type ConfigEntry, ConfigurationClient, type ConfigurationConfig };

package/dist/configuration/index.js

@@ -0,0 +1,155 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/configuration/index.ts
+var configuration_exports = {};
+__export(configuration_exports, {
+  ConfigurationClient: () => ConfigurationClient
+});
+module.exports = __toCommonJS(configuration_exports);
+
+// src/configuration/configuration.ts
+var ABI = [
+  {
+    name: "getConfig",
+    type: "function",
+    stateMutability: "view",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "configKey", type: "string" }
+    ],
+    outputs: [{
+      type: "tuple",
+      components: [
+        { name: "agentId", type: "uint256" },
+        { name: "key", type: "string" },
+        { name: "value", type: "string" },
+        { name: "dataType", type: "string" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "updatedBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getAgentConfigs",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "agentId", type: "uint256" },
+        { name: "key", type: "string" },
+        { name: "value", type: "string" },
+        { name: "dataType", type: "string" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "updatedBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getConfigKeys",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{ type: "string[]" }]
+  },
+  {
+    name: "getConfigCount",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    name: "configExists",
+    type: "function",
+    stateMutability: "view",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "configKey", type: "string" }
+    ],
+    outputs: [{ type: "bool" }]
+  }
+];
+var ConfigurationClient = class {
+  address;
+  publicClient;
+  constructor(config, publicClient) {
+    this.address = config.address;
+    this.publicClient = publicClient ?? null;
+  }
+  setPublicClient(client) {
+    this.publicClient = client;
+  }
+  async get(agentId, key) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    try {
+      return await this.publicClient.readContract({
+        address: this.address,
+        abi: ABI,
+        functionName: "getConfig",
+        args: [agentId, key]
+      });
+    } catch {
+      return null;
+    }
+  }
+  async getAll(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentConfigs",
+      args: [agentId]
+    });
+  }
+  async getKeys(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getConfigKeys",
+      args: [agentId]
+    });
+  }
+  async getCount(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getConfigCount",
+      args: [agentId]
+    });
+  }
+  async exists(agentId, key) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "configExists",
+      args: [agentId, key]
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigurationClient
+});
+//# sourceMappingURL=index.js.map

package/dist/configuration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/configuration/index.ts","../../src/configuration/configuration.ts"],"sourcesContent":["export * from './configuration'\n","/**\n * ConfigurationRegistry SDK\n * On-chain key-value config store for AI Agents\n */\nimport { type PublicClient, type WalletClient, type Address, type Hash } from 'viem'\n\nexport interface ConfigEntry {\n  agentId: bigint\n  key: string\n  value: string\n  dataType: string\n  updatedAt: bigint\n  updatedBy: Address\n}\n\nexport interface ConfigurationConfig {\n  address: Address\n}\n\nconst ABI = [\n  {\n    name: 'getConfig',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [\n      { name: 'agentId', type: 'uint256' },\n      { name: 'configKey', type: 'string' },\n    ],\n    outputs: [{\n      type: 'tuple',\n      components: [\n        { name: 'agentId', type: 'uint256' },\n        { name: 'key', type: 'string' },\n        { name: 'value', type: 'string' },\n        { name: 'dataType', type: 'string' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'updatedBy', type: 'address' },\n      ],\n    }],\n  },\n  {\n    name: 'getAgentConfigs',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple[]',\n      components: [\n        { name: 'agentId', type: 'uint256' },\n        { name: 'key', type: 'string' },\n        { name: 'value', type: 'string' },\n        { name: 'dataType', type: 'string' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'updatedBy', type: 'address' },\n      ],\n    }],\n  },\n  {\n    name: 'getConfigKeys',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{ type: 'string[]' }],\n  },\n  {\n    name: 'getConfigCount',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{ type: 'uint256' }],\n  },\n  {\n    name: 'configExists',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [\n      { name: 'agentId', type: 'uint256' },\n      { name: 'configKey', type: 'string' },\n    ],\n    outputs: [{ type: 'bool' }],\n  },\n] as const\n\nexport class ConfigurationClient {\n  private address: Address\n  private publicClient: PublicClient | null\n\n  constructor(config: ConfigurationConfig, publicClient?: PublicClient) {\n    this.address = config.address\n    this.publicClient = publicClient ?? null\n  }\n\n  setPublicClient(client: PublicClient) {\n    this.publicClient = client\n  }\n\n  async get(agentId: bigint, key: string): Promise<ConfigEntry | null> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    try {\n      return (await this.publicClient.readContract({\n        address: this.address,\n        abi: ABI,\n        functionName: 'getConfig',\n        args: [agentId, key],\n      })) as ConfigEntry\n    } catch {\n      return null\n    }\n  }\n\n  async getAll(agentId: bigint): Promise<ConfigEntry[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getAgentConfigs',\n      args: [agentId],\n    })) as ConfigEntry[]\n  }\n\n  async getKeys(agentId: bigint): Promise<string[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getConfigKeys',\n      args: [agentId],\n    })) as string[]\n  }\n\n  async getCount(agentId: bigint): Promise<bigint> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getConfigCount',\n      args: [agentId],\n    })) as bigint\n  }\n\n  async exists(agentId: bigint, key: string): Promise<boolean> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'configExists',\n      args: [agentId, key],\n    })) as boolean\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/configuration/index.mjs

@@ -0,0 +1,128 @@
+// src/configuration/configuration.ts
+var ABI = [
+  {
+    name: "getConfig",
+    type: "function",
+    stateMutability: "view",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "configKey", type: "string" }
+    ],
+    outputs: [{
+      type: "tuple",
+      components: [
+        { name: "agentId", type: "uint256" },
+        { name: "key", type: "string" },
+        { name: "value", type: "string" },
+        { name: "dataType", type: "string" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "updatedBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getAgentConfigs",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "agentId", type: "uint256" },
+        { name: "key", type: "string" },
+        { name: "value", type: "string" },
+        { name: "dataType", type: "string" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "updatedBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getConfigKeys",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{ type: "string[]" }]
+  },
+  {
+    name: "getConfigCount",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{ type: "uint256" }]
+  },
+  {
+    name: "configExists",
+    type: "function",
+    stateMutability: "view",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "configKey", type: "string" }
+    ],
+    outputs: [{ type: "bool" }]
+  }
+];
+var ConfigurationClient = class {
+  address;
+  publicClient;
+  constructor(config, publicClient) {
+    this.address = config.address;
+    this.publicClient = publicClient ?? null;
+  }
+  setPublicClient(client) {
+    this.publicClient = client;
+  }
+  async get(agentId, key) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    try {
+      return await this.publicClient.readContract({
+        address: this.address,
+        abi: ABI,
+        functionName: "getConfig",
+        args: [agentId, key]
+      });
+    } catch {
+      return null;
+    }
+  }
+  async getAll(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentConfigs",
+      args: [agentId]
+    });
+  }
+  async getKeys(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getConfigKeys",
+      args: [agentId]
+    });
+  }
+  async getCount(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getConfigCount",
+      args: [agentId]
+    });
+  }
+  async exists(agentId, key) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "configExists",
+      args: [agentId, key]
+    });
+  }
+};
+export {
+  ConfigurationClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/configuration/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/configuration/configuration.ts"],"sourcesContent":["/**\n * ConfigurationRegistry SDK\n * On-chain key-value config store for AI Agents\n */\nimport { type PublicClient, type WalletClient, type Address, type Hash } from 'viem'\n\nexport interface ConfigEntry {\n  agentId: bigint\n  key: string\n  value: string\n  dataType: string\n  updatedAt: bigint\n  updatedBy: Address\n}\n\nexport interface ConfigurationConfig {\n  address: Address\n}\n\nconst ABI = [\n  {\n    name: 'getConfig',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [\n      { name: 'agentId', type: 'uint256' },\n      { name: 'configKey', type: 'string' },\n    ],\n    outputs: [{\n      type: 'tuple',\n      components: [\n        { name: 'agentId', type: 'uint256' },\n        { name: 'key', type: 'string' },\n        { name: 'value', type: 'string' },\n        { name: 'dataType', type: 'string' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'updatedBy', type: 'address' },\n      ],\n    }],\n  },\n  {\n    name: 'getAgentConfigs',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple[]',\n      components: [\n        { name: 'agentId', type: 'uint256' },\n        { name: 'key', type: 'string' },\n        { name: 'value', type: 'string' },\n        { name: 'dataType', type: 'string' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'updatedBy', type: 'address' },\n      ],\n    }],\n  },\n  {\n    name: 'getConfigKeys',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{ type: 'string[]' }],\n  },\n  {\n    name: 'getConfigCount',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{ type: 'uint256' }],\n  },\n  {\n    name: 'configExists',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [\n      { name: 'agentId', type: 'uint256' },\n      { name: 'configKey', type: 'string' },\n    ],\n    outputs: [{ type: 'bool' }],\n  },\n] as const\n\nexport class ConfigurationClient {\n  private address: Address\n  private publicClient: PublicClient | null\n\n  constructor(config: ConfigurationConfig, publicClient?: PublicClient) {\n    this.address = config.address\n    this.publicClient = publicClient ?? null\n  }\n\n  setPublicClient(client: PublicClient) {\n    this.publicClient = client\n  }\n\n  async get(agentId: bigint, key: string): Promise<ConfigEntry | null> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    try {\n      return (await this.publicClient.readContract({\n        address: this.address,\n        abi: ABI,\n        functionName: 'getConfig',\n        args: [agentId, key],\n      })) as ConfigEntry\n    } catch {\n      return null\n    }\n  }\n\n  async getAll(agentId: bigint): Promise<ConfigEntry[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getAgentConfigs',\n      args: [agentId],\n    })) as ConfigEntry[]\n  }\n\n  async getKeys(agentId: bigint): Promise<string[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getConfigKeys',\n      args: [agentId],\n    })) as string[]\n  }\n\n  async getCount(agentId: bigint): Promise<bigint> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getConfigCount',\n      args: [agentId],\n    })) as bigint\n  }\n\n  async exists(agentId: bigint, key: string): Promise<boolean> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'configExists',\n      args: [agentId, key],\n    })) as boolean\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core.d.mts

@@ -0,0 +1,64 @@
+import { E as EncryptedPayload, i as AgentPrivatePayload, g as AgentPayload, P as PackResult } from '../types-2aHUvS4M.mjs';
+export { a as A2AAgentCard, e as A2ASkillExecution, b as A2ATask, f as A2ATaskStatus, h as AgentPricing, j as AgentPublicPayload, d as AgentReputation, c as AgentReview, k as AgentSearchQuery, l as AgentSearchResult, A as AgentSubscription, m as AgentXConfig, n as AgentXContracts, o as AgentXError, p as AgentXErrorCode, J as JSONSchema, q as JSONSchemaProperty, M as McpConnection, r as McpTransport, O as OnChainAgentMetadata, s as PricingType, R as RegisteredAgent, S as SkillDef, t as SkillExecutionMode, u as SkillExecutionRemote, v as SubscriptionRequired, w as SubscriptionStatus, U as UnpackResult } from '../types-2aHUvS4M.mjs';
+export { bytesToHex, hexToBytes } from '@noble/ciphers/utils.js';
+
+declare function randomBytes(length: number): Uint8Array;
+
+/**
+ * Encrypt with AES-256-GCM.
+ * Wire format (same as aihunter-saas): base64( IV[12] || ciphertext || authTag[16] )
+ */
+declare function aesEncrypt(plaintext: string, keyHex: string): string;
+/**
+ * Decrypt AES-256-GCM (same wire format as aihunter-saas).
+ */
+declare function aesDecrypt(encryptedBase64: string, keyHex: string): string;
+/**
+ * Generate a cryptographically random AES-256 key (hex, 64 chars).
+ */
+declare function generateAesKey(): string;
+/**
+ * Encrypt data with recipient's secp256k1 public key (ECIES).
+ *
+ * @param dataHex    The data to encrypt (hex, e.g. AES key)
+ * @param publicKey  Recipient's public key (hex, 04-prefixed uncompressed or 02/03 compressed)
+ */
+declare function eciesEncrypt(dataHex: string, publicKey: string): string;
+/**
+ * Decrypt ECIES ciphertext with recipient's secp256k1 private key.
+ */
+declare function eciesDecrypt(dataHex: string, privateKey: string): string;
+/**
+ * Encrypt an Agent's private payload with AES-256-GCM.
+ */
+declare function encryptPayload(payload: AgentPrivatePayload, keyHex?: string): EncryptedPayload;
+/**
+ * Decrypt an EncryptedPayload.
+ */
+declare function decryptPayload(encrypted: EncryptedPayload, keyHex: string): AgentPrivatePayload;
+/**
+ * Pack an AgentPayload for publishing.
+ *   1. Split public/private
+ *   2. AES-256-GCM encrypt private part
+ *   3. ECIES wrap AES key with creator's public key
+ */
+declare function packAgentForPublish(agent: AgentPayload, publicKey: string, aesKeyHex?: string): PackResult;
+/**
+ * Unpack an Agent:
+ *   1. ECIES decrypt the AES key (private key)
+ *   2. AES-256-GCM decrypt the payload
+ */
+declare function unpackAgent(encryptedPayload: EncryptedPayload, eciesEncryptedKey: string, privateKey: string): AgentPrivatePayload;
+/**
+ * Generate a secp256k1 keypair compatible with Ethereum wallets.
+ */
+declare function generateKeyPair(): {
+    privateKey: string;
+    publicKey: string;
+};
+/**
+ * Derive public key from private key (hex).
+ */
+declare function getPublicKey(privateKey: string): string;
+
+export { AgentPayload, AgentPrivatePayload, EncryptedPayload, PackResult, aesDecrypt, aesEncrypt, decryptPayload, eciesDecrypt, eciesEncrypt, encryptPayload, generateAesKey, generateKeyPair, getPublicKey, packAgentForPublish, randomBytes, unpackAgent };

package/dist/core.d.ts

@@ -0,0 +1,64 @@
+import { E as EncryptedPayload, i as AgentPrivatePayload, g as AgentPayload, P as PackResult } from '../types-2aHUvS4M.js';
+export { a as A2AAgentCard, e as A2ASkillExecution, b as A2ATask, f as A2ATaskStatus, h as AgentPricing, j as AgentPublicPayload, d as AgentReputation, c as AgentReview, k as AgentSearchQuery, l as AgentSearchResult, A as AgentSubscription, m as AgentXConfig, n as AgentXContracts, o as AgentXError, p as AgentXErrorCode, J as JSONSchema, q as JSONSchemaProperty, M as McpConnection, r as McpTransport, O as OnChainAgentMetadata, s as PricingType, R as RegisteredAgent, S as SkillDef, t as SkillExecutionMode, u as SkillExecutionRemote, v as SubscriptionRequired, w as SubscriptionStatus, U as UnpackResult } from '../types-2aHUvS4M.js';
+export { bytesToHex, hexToBytes } from '@noble/ciphers/utils.js';
+
+declare function randomBytes(length: number): Uint8Array;
+
+/**
+ * Encrypt with AES-256-GCM.
+ * Wire format (same as aihunter-saas): base64( IV[12] || ciphertext || authTag[16] )
+ */
+declare function aesEncrypt(plaintext: string, keyHex: string): string;
+/**
+ * Decrypt AES-256-GCM (same wire format as aihunter-saas).
+ */
+declare function aesDecrypt(encryptedBase64: string, keyHex: string): string;
+/**
+ * Generate a cryptographically random AES-256 key (hex, 64 chars).
+ */
+declare function generateAesKey(): string;
+/**
+ * Encrypt data with recipient's secp256k1 public key (ECIES).
+ *
+ * @param dataHex    The data to encrypt (hex, e.g. AES key)
+ * @param publicKey  Recipient's public key (hex, 04-prefixed uncompressed or 02/03 compressed)
+ */
+declare function eciesEncrypt(dataHex: string, publicKey: string): string;
+/**
+ * Decrypt ECIES ciphertext with recipient's secp256k1 private key.
+ */
+declare function eciesDecrypt(dataHex: string, privateKey: string): string;
+/**
+ * Encrypt an Agent's private payload with AES-256-GCM.
+ */
+declare function encryptPayload(payload: AgentPrivatePayload, keyHex?: string): EncryptedPayload;
+/**
+ * Decrypt an EncryptedPayload.
+ */
+declare function decryptPayload(encrypted: EncryptedPayload, keyHex: string): AgentPrivatePayload;
+/**
+ * Pack an AgentPayload for publishing.
+ *   1. Split public/private
+ *   2. AES-256-GCM encrypt private part
+ *   3. ECIES wrap AES key with creator's public key
+ */
+declare function packAgentForPublish(agent: AgentPayload, publicKey: string, aesKeyHex?: string): PackResult;
+/**
+ * Unpack an Agent:
+ *   1. ECIES decrypt the AES key (private key)
+ *   2. AES-256-GCM decrypt the payload
+ */
+declare function unpackAgent(encryptedPayload: EncryptedPayload, eciesEncryptedKey: string, privateKey: string): AgentPrivatePayload;
+/**
+ * Generate a secp256k1 keypair compatible with Ethereum wallets.
+ */
+declare function generateKeyPair(): {
+    privateKey: string;
+    publicKey: string;
+};
+/**
+ * Derive public key from private key (hex).
+ */
+declare function getPublicKey(privateKey: string): string;
+
+export { AgentPayload, AgentPrivatePayload, EncryptedPayload, PackResult, aesDecrypt, aesEncrypt, decryptPayload, eciesDecrypt, eciesEncrypt, encryptPayload, generateAesKey, generateKeyPair, getPublicKey, packAgentForPublish, randomBytes, unpackAgent };

package/dist/endpoint/index.d.mts

@@ -0,0 +1,39 @@
+import { Address, PublicClient } from 'viem';
+
+/**
+ * MultiEndpointRegistry SDK
+ * OxaChain L1 + Sepolia — multi-endpoint management for AI Agents
+ */
+
+interface EndpointRecord {
+    endpointId: bigint;
+    agentId: bigint;
+    name: string;
+    endpointType: string;
+    protocol: string;
+    url: string;
+    description: string;
+    isActive: boolean;
+    createdAt: bigint;
+    updatedAt: bigint;
+    createdBy: Address;
+}
+interface MultiEndpointConfig {
+    address: Address;
+}
+declare class MultiEndpointClient {
+    private address;
+    private publicClient;
+    constructor(config: MultiEndpointConfig, publicClient?: PublicClient);
+    setPublicClient(client: PublicClient): void;
+    getActiveEndpoints(agentId: bigint): Promise<EndpointRecord[]>;
+    getAllEndpoints(agentId: bigint): Promise<EndpointRecord[]>;
+    getEndpoint(endpointId: bigint): Promise<EndpointRecord>;
+    getStats(agentId: bigint): Promise<[bigint, bigint, bigint, bigint, bigint]>;
+    /** Pick best active endpoint for the agent — prefer HTTP, take first active */
+    pickBestEndpoint(agentId: bigint): Promise<EndpointRecord | null>;
+    /** Pick any active endpoint URL — for MCP connector */
+    getBestMCPUrl(agentId: bigint): Promise<string | null>;
+}
+
+export { type EndpointRecord, MultiEndpointClient, type MultiEndpointConfig };