@agentxv2/sdk 0.5.0 → 0.5.2

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/index.js

@@ -354,11 +354,13 @@ __export(index_exports, {
   AgentXError: () => AgentXError,
   AgentXErrorCode: () => AgentXErrorCode,
   CONFIG_VERSION: () => CONFIG_VERSION,
+  ConfigurationClient: () => ConfigurationClient,
   ConfigurationRegistry: () => ConfigurationRegistry,
   IPFSFetcher: () => IPFSFetcher,
   KNOWN_CHAINS: () => KNOWN_CHAINS,
   MCPConnector: () => MCPConnector,
   MCP_VERSION: () => MCP_VERSION,
+  MultiEndpointClient: () => MultiEndpointClient,
   REGISTRY_VERSION: () => REGISTRY_VERSION,
   REPUTATION_VERSION: () => REPUTATION_VERSION,
   ReputationRegistry: () => ReputationRegistry,
@@ -2135,7 +2137,8 @@ var KNOWN_CHAINS = {
       paymentGateway: "0x59eA58c0089314C0fCc86A4ff646fb6dAE571C96",
       a2aProtocolRegistry: "0xEdb0022c250B38e281B3EF1418037889fC5C6092",
       reputationRegistry: "0xeb6B410ea71b8d9dA0c96f6A91d35027CE143DC9",
-      configurationRegistry: "0x68DcE00e4C9077c94BC68016cD14B09557faEA6c"
+      configurationRegistry: "0x68DcE00e4C9077c94BC68016cD14B09557faEA6c",
+      multiEndpointRegistry: "0xEB5e866f186d4B73F97aa0d70B86f2C6e2e21Cb7"
     },
     ipfsGateways: ["ipfs.io", "gateway.pinata.cloud", "dweb.link", "cf-ipfs.com"]
   },
@@ -2153,7 +2156,8 @@ var KNOWN_CHAINS = {
       paymentGateway: "0x0000000000000000000000000000000000000000",
       a2aProtocolRegistry: "0x61b7E7Eed21F013e35a90FC5de5c352780ec5169",
       reputationRegistry: "0x6a18C2664E1b42063860d864b6448b824d7B843F",
-      configurationRegistry: "0x07280674ccc2898Fd038A9e3C22005CA83ffD2F8"
+      configurationRegistry: "0x07280674ccc2898Fd038A9e3C22005CA83ffD2F8",
+      multiEndpointRegistry: "0xB361d04F49000013FC131D3C59C41c8486C64f8c"
     },
     ipfsGateways: ["ipfs.io", "gateway.pinata.cloud", "dweb.link", "cf-ipfs.com"],
     rpcUrl: "http://43.156.99.215:18545"
@@ -2211,6 +2215,294 @@ var ConfigurationRegistry = class {
 // src/config/index.ts
 var CONFIG_VERSION = "0.1.0";
 
+// src/endpoint/multi-endpoint.ts
+var ABI = [
+  {
+    name: "getActiveAgentEndpoints",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getAgentEndpoints",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "createEndpoint",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "name", type: "string" },
+      { name: "endpointType", type: "string" },
+      { name: "protocol", type: "string" },
+      { name: "url", type: "string" },
+      { name: "description", type: "string" }
+    ],
+    outputs: [{ name: "endpointId", type: "uint256" }]
+  },
+  {
+    name: "getEndpoint",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "endpointId", type: "uint256" }],
+    outputs: [{
+      type: "tuple",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getSupportedProtocols",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ type: "string[]" }]
+  },
+  {
+    name: "getAgentEndpointStats",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [
+      { name: "totalEndpoints", type: "uint256" },
+      { name: "activeEndpoints", type: "uint256" },
+      { name: "httpEndpoints", type: "uint256" },
+      { name: "websocketEndpoints", type: "uint256" },
+      { name: "grpcEndpoints", type: "uint256" }
+    ]
+  }
+];
+var MultiEndpointClient = class {
+  address;
+  publicClient;
+  constructor(config, publicClient) {
+    this.address = config.address;
+    this.publicClient = publicClient ?? null;
+  }
+  setPublicClient(client) {
+    this.publicClient = client;
+  }
+  async getActiveEndpoints(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getActiveAgentEndpoints",
+      args: [agentId]
+    });
+  }
+  async getAllEndpoints(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentEndpoints",
+      args: [agentId]
+    });
+  }
+  async getEndpoint(endpointId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getEndpoint",
+      args: [endpointId]
+    });
+  }
+  async getStats(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentEndpointStats",
+      args: [agentId]
+    });
+  }
+  /** Pick best active endpoint for the agent — prefer HTTP, take first active */
+  async pickBestEndpoint(agentId) {
+    const endpoints = await this.getActiveEndpoints(agentId);
+    if (endpoints.length === 0) return null;
+    const http = endpoints.find((e) => e.protocol === "HTTP");
+    return http ?? endpoints[0];
+  }
+  /** Pick any active endpoint URL — for MCP connector */
+  async getBestMCPUrl(agentId) {
+    const best = await this.pickBestEndpoint(agentId);
+    return best?.url ?? null;
+  }
+};
+
+// src/configuration/configuration.ts
+var ABI2 = [
+  {
+    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: ABI2,
+        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: ABI2,
+      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: ABI2,
+      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: ABI2,
+      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: ABI2,
+      functionName: "configExists",
+      args: [agentId, key]
+    });
+  }
+};
+
 // src/react/useAgentRunner.ts
 var import_react = require("react");
 var import_wagmi = require("wagmi");
@@ -2386,11 +2678,13 @@ function useAgentRunner(config) {
   AgentXError,
   AgentXErrorCode,
   CONFIG_VERSION,
+  ConfigurationClient,
   ConfigurationRegistry,
   IPFSFetcher,
   KNOWN_CHAINS,
   MCPConnector,
   MCP_VERSION,
+  MultiEndpointClient,
   REGISTRY_VERSION,
   REPUTATION_VERSION,
   ReputationRegistry,