@agentxv2/sdk 0.5.1 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +63 -20
  2. package/dist/index.js.map +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
- # @agentxv2/sdk v0.2.0
1
+ # @agentxv2/sdk v0.5.1
2
2
 
3
- **Decentralized AI Agent Platform SDK** — E2E encryption, on-chain subscriptions, MCP tool execution.
3
+ **Decentralized AI Agent Platform SDK** — E2E encryption, on-chain subscriptions, MCP tool execution, A2A delegation.
4
4
 
5
5
  ```
6
6
  Agent = Prompt + Skills[] + MCP
@@ -82,17 +82,21 @@ const packResult = packAgentForPublish(agentPayload, publicKey, aesKey)
82
82
  ## Architecture
83
83
 
84
84
  ```
85
- ┌────────────────────────────────────────────────────┐
86
- │ @agentxv2/sdk │
87
- ├──────────┬──────────┬──────────┬──────────────────┤
88
- │ Core │ Agent │ MCP │ React │
89
- │ crypto │ Runner │ Connector│ useAgentRunner │
90
- │ types │ useAgent │ callTool │ │
91
- ├──────────┼──────────┼──────────┼──────────────────┤
92
- │ Registry │ Subscrip │ A2A │ Reputation │
93
- │ register │ subscribe│ protocol │ giveFeedback │
94
- │ query │ verify │ │ │
95
- └──────────┴──────────┴──────────┴──────────────────┘
85
+ ┌──────────────────────────────────────────────────────────────────┐
86
+ │ @agentxv2/sdk │
87
+ ├──────────┬──────────┬──────────┬──────────┬──────────────────────┤
88
+ │ Core │ Agent │ MCP │ React │ A2A │
89
+ │ crypto │ Runner │ Connector│ hooks │ Agent-to-Agent │
90
+ │ types │ useAgent │ callTool │ │ createTask/complete │
91
+ ├──────────┼──────────┼──────────┼──────────┼──────────────────────┤
92
+ │ Registry │ Subscrip │ A2A-X402 │ Reputation│ Endpoint │
93
+ │ register │ subscribe│ auto-pay │ feedback │ MultiEndpoint │
94
+ │ query │ verify │ gate │ stats │ pickBestEndpoint │
95
+ ├──────────┼──────────┼──────────┼──────────┼──────────────────────┤
96
+ │ Config │ Config- │ │ │ │
97
+ │ store │ uration │ │ │ │
98
+ │ (kv) │ Client │ │ │ │
99
+ └──────────┴──────────┴──────────┴──────────┴──────────────────────┘
96
100
  ```
97
101
 
98
102
  ## API Reference
@@ -111,6 +115,10 @@ const packResult = packAgentForPublish(agentPayload, publicKey, aesKey)
111
115
  | `SubscriptionManager` | Subscribe (ETH/ERC20), verify, cancel, trial refund, releaseFunds |
112
116
  | `AgentX402` | Auto-subscription gate + X402 payment bridge |
113
117
  | `A2AProtocol` | Agent-to-Agent task protocol |
118
+ | `ReputationRegistry` | Give feedback + query reputation |
119
+ | `MultiEndpointClient` | Read/select agent endpoints (HTTP, WebSocket, gRPC) |
120
+ | `ConfigurationClient` | Agent on-chain key-value config store |
121
+ | `ConfigurationRegistry` | Platform-wide config registry (KV store) |
114
122
 
115
123
  ### Agent Composition (A2A Skills)
116
124
 
@@ -128,9 +136,10 @@ An Agent's Skill can delegate to **another Agent**. Set `execution.type = "a2a"`
128
136
  }
129
137
  ```
130
138
 
131
- When executed, the SDK loads Agent #42's prompt + skills, decrypts them,
132
- and returns the full sub-Agent context to the calling LLM.
133
- | `ReputationRegistry` | Give feedback + query reputation |
139
+ When executed, the SDK:
140
+ 1. Loads Agent #42's metadata from IPFS
141
+ 2. Decrypts with ECIES+AES-256-GCM
142
+ 3. Returns the sub-Agent's prompt + skills to the calling LLM
134
143
 
135
144
  ### `@agentxv2/sdk/react`
136
145
 
@@ -194,10 +203,44 @@ Auto-detected via `KNOWN_CHAINS[chainId]`. Pass `chainId` in AgentX constructor
194
203
 
195
204
  ## On-Chain Contracts
196
205
 
197
- | Contract | Sepolia | OxaChain L1 |
198
- |----------|---------|-------------|
199
- | IdentityRegistry | `0xe94a...96e5F` | `0x0292...3902` |
200
- | SubscriptionManager v3 | `0xC15f...7E63` | `0x37BA...E249` |
206
+ | # | Contract | Sepolia | OxaChain L1 |
207
+ |---|----------|---------|-------------|
208
+ | 1 | IdentityRegistry | `0xe94a...96e5F` | `0xbf5F...E212` |
209
+ | 2 | SubscriptionManager v3 | `0xC15f...7E63` | `0x019A...0E6B` |
210
+ | 3 | ReputationRegistry | `0xeb6B...3DC9` | `0x6a18...843F` |
211
+ | 4 | A2AProtocolRegistry | `0xEdb0...6092` | `0x61b7...5169` |
212
+ | 5 | ConfigurationRegistry | `0x68Dc...EA6c` | `0x0728...D2F8` |
213
+ | 6 | MultiEndpointRegistry | `0xEB5e...21Cb7` | `0xB361...f64c` |
214
+
215
+ Full addresses in `KNOWN_CHAINS` inside `config.ts`.
216
+
217
+ ## Changelog
218
+
219
+ ### v0.5.1 (2026-07-14)
220
+ - New: `MultiEndpointClient` — getActiveEndpoints, pickBestEndpoint, getBestMCPUrl
221
+ - New: `ConfigurationClient` — get, getAll, getKeys, exists
222
+ - `ChainConfig.contracts` added `multiEndpointRegistry`
223
+ - OxaChain L1 all 6 core contracts deployed
224
+
225
+ ### v0.5.0 (2026-07-14)
226
+ - OxaChain L1 full deployment: `KNOWN_CHAINS[19505]` 6 contract addresses
227
+
228
+ ### v0.4.0 (2026-07-13)
229
+ - Integration test fixes
230
+ - OxaChain L1 added to `KNOWN_CHAINS`
231
+ - IdentityRegistry + SubscriptionManager v3 deployed to OxaChain L1
232
+
233
+ ### v0.3.1 (2026-07-13)
234
+ - Fixed ESM directory import error on Node.js 22 (tsup single-file bundling)
235
+
236
+ ### v0.3.0 (2026-07-12)
237
+ - AgentX402 auto-subscription gate
238
+ - SubscriptionManager v3 (ReentrancyGuard, platformFee=250bps, trial escrow)
239
+
240
+ ### v0.2.0 (2026-07-11)
241
+ - Initial public release
242
+ - AgentRunner, MCPConnector, AgentRegistry, SubscriptionManager, ReputationRegistry
243
+ - ECIES + AES-256-GCM encryption pipeline
201
244
 
202
245
  ## License
203
246