@agnt-id/agent0 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,127 @@
+# @agnt-id/agent0
+
+Bridge between `.agnt` names and [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) agent identities.
+
+`.agnt` and ERC-8004 (Agent0) are complementary — Agent0 is an identity registry (like a tax ID), `.agnt` is a naming system (like a domain name). This package converts between the two formats in both directions.
+
+## Install
+
+```bash
+npm i @agnt-id/agent0
+```
+
+Or install everything at once:
+
+```bash
+npm i @agnt-id/sdk
+```
+
+## Quick Start
+
+### .agnt → ERC-8004 Registration File
+
+```typescript
+import { AgntClient } from "@agnt-id/resolve";
+import { toRegistrationFile } from "@agnt-id/agent0";
+
+const agnt = new AgntClient();
+const resolved = await agnt.resolve("alice.agnt");
+
+const file = toRegistrationFile(resolved, {
+  agentURI: "https://alice.example.com/.well-known/agent.json",
+});
+
+console.log(JSON.stringify(file, null, 2));
+// {
+//   "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+//   "agentURI": "https://alice.example.com/.well-known/agent.json",
+//   "services": [{ "name": "a2a", "endpoint": "...", ... }],
+//   "registrations": [{ "agentId": "42", "agentRegistry": "eip155:1:0x..." }],
+//   ...
+// }
+```
+
+### ERC-8004 → .agnt Records
+
+```typescript
+import { fromRegistrationFile } from "@agnt-id/agent0";
+
+const agntFields = fromRegistrationFile(registrationFile);
+console.log(agntFields.a2a);      // endpoint from services
+console.log(agntFields.identity); // "eip155:1:0xRegistry:42"
+console.log(agntFields.skills);   // ["defi", "trading"]
+```
+
+### One-step resolve + convert
+
+```typescript
+import { fromAgnt } from "@agnt-id/agent0";
+
+// Requires @agnt-id/resolve as a peer dependency
+const file = await fromAgnt("alice.agnt", {
+  agentURI: "https://alice.example.com/.well-known/agent.json",
+});
+```
+
+### Parse Identity Links
+
+```typescript
+import { parseIdentityLink, formatIdentityLink } from "@agnt-id/agent0";
+
+const link = parseIdentityLink("eip155:1:0x275ceA...9cd2:42");
+// { chainId: "1", registry: "0x275ceA...9cd2", agentId: "42" }
+
+formatIdentityLink(link);
+// "eip155:1:0x275ceA...9cd2:42"
+```
+
+## API
+
+### `toRegistrationFile(agnt, options?): Agent0RegistrationFile`
+
+Convert a resolved `.agnt` name to an ERC-8004 registration file.
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `agentURI` | `string` | The agent's canonical URI |
+| `chainId` | `string` | Chain ID override (default: from identity link or `"1"`) |
+
+### `fromRegistrationFile(file): Partial<AgntRecord>`
+
+Convert an ERC-8004 registration file to `.agnt` record fields.
+
+### `fromAgnt(name, options?): Promise<Agent0RegistrationFile>`
+
+Resolve + convert in one call. Requires `@agnt-id/resolve` as a peer dependency.
+
+### `parseIdentityLink(identity): AgntIdentityLink`
+
+Parse an identity string like `eip155:1:0xAddr:42` into `{ chainId, registry, agentId }`.
+
+### `formatIdentityLink(link): string`
+
+Format an identity link back to its string representation.
+
+## Types
+
+```typescript
+import type {
+  Agent0RegistrationFile,
+  Agent0Service,
+  Agent0Registration,
+  Agent0FeedbackFile,
+  AgntIdentityLink,
+  ToRegistrationFileOptions,
+} from "@agnt-id/agent0";
+```
+
+## Links
+
+- [ERC-8004 Spec](https://eips.ethereum.org/EIPS/eip-8004)
+- [8004.org](https://www.8004.org)
+- [Website](https://www.agnt.id)
+- [GitHub](https://github.com/txc0ld/agnt.id)
+
+## License
+
+MIT

package/dist/bridge.js

@@ -91,7 +91,7 @@ export function toRegistrationFile(agnt, options = {}) {
         services,
         registrations,
         active: options.active ?? true,
-        x402Support: rec.x402Support,
+        x402Support: rec.x402Config?.enabled,
     };
     if (image)
         file.image = image;
@@ -137,8 +137,14 @@ export function fromRegistrationFile(file) {
     if (file.supportedTrust?.length) {
         rec.trustModels = [...file.supportedTrust];
     }
-    if (file.x402Support != null)
-        rec.x402Support = file.x402Support;
+    if (file.x402Support != null) {
+        rec.x402Config = {
+            paymentAddress: "",
+            pricePerCall: "0",
+            chainId: 8453,
+            enabled: file.x402Support,
+        };
+    }
     if (file.image)
         rec.texts = { avatar: file.image };
     if (file.description) {

package/dist/types.d.ts

@@ -81,7 +81,12 @@ export type AgntRecordLike = {
     a2aVersion?: string;
     mcpVersion?: string;
     profileURI?: string;
-    x402Support?: boolean;
+    x402Config?: {
+        paymentAddress: string;
+        pricePerCall: string;
+        chainId: number;
+        enabled: boolean;
+    };
     trustModels?: string[];
 };
 /** Minimal resolved .agnt name. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agnt-id/agent0",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Bridge between .agnt names and ERC-8004 agent identities",
   "type": "module",
   "main": "dist/index.js",