@agnt-id/resolve 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,144 @@
+# @agnt-id/resolve
+
+Resolve `.agnt` names to wallets, agent endpoints, and identity records.
+
+`.agnt` is an on-chain ENS-style naming system for AI agents deployed on Ethereum, Base, and Arbitrum. This package is the core SDK — it talks to the [gateway API](https://api.agnt.id) and gives you a typed client for forward resolution, reverse lookups, discovery, trust scores, and availability checks.
+
+## Install
+
+```bash
+npm i @agnt-id/resolve
+```
+
+Or install everything at once:
+
+```bash
+npm i @agnt-id/sdk
+```
+
+## Quick Start
+
+```typescript
+import { AgntClient } from "@agnt-id/resolve";
+
+const agnt = new AgntClient();
+
+// Resolve a name
+const result = await agnt.resolve("alice.agnt");
+console.log(result.records.wallets);   // { "eip155:1": "eip155:1:0x..." }
+console.log(result.records.a2a);       // "https://alice.example.com/.well-known/agent.json"
+console.log(result.records.mcp);       // "https://alice.example.com/mcp"
+
+// Reverse lookup
+const reverse = await agnt.reverse("0x1234...abcd");
+console.log(reverse.name);            // "alice.agnt"
+
+// Discover agents
+const agents = await agnt.discover({ q: "trading", skill: "defi" });
+console.log(agents.entries);
+
+// Check availability
+const free = await agnt.available("myagent");
+console.log(free);                    // true
+```
+
+## API
+
+### `new AgntClient(options?)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `gateway` | `string` | `"https://api.agnt.id"` | Gateway API base URL |
+| `chainId` | `string` | `"eip155:1"` | CAIP-2 chain ID |
+| `fetch` | `typeof fetch` | `globalThis.fetch` | Custom fetch implementation |
+
+### Methods
+
+#### `resolve(name: string): Promise<AgntName>`
+
+Forward resolution — returns ownership, expiry, and all records (wallets, endpoints, text records, identity link, skills, domains).
+
+#### `reverse(address: string, options?): Promise<ReverseResult>`
+
+Reverse lookup — address to `.agnt` name.
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `chainId` | `string` | Override chain ID for this call |
+
+#### `discover(options?): Promise<DiscoverResult>`
+
+Search and discover agents.
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `q` | `string` | Search query |
+| `skill` | `string` | Filter by OASF skill slug |
+| `domain` | `string` | Filter by OASF domain slug |
+| `limit` | `number` | Max results |
+| `offset` | `number` | Pagination offset |
+
+#### `owner(address: string, options?): Promise<OwnerResult>`
+
+List all `.agnt` names owned by an address.
+
+#### `trust(name: string): Promise<TrustResult>`
+
+Get trust score, confidence, and signal breakdown for a name.
+
+#### `domains(name: string): Promise<DomainResult>`
+
+Get domain verification records for a name.
+
+#### `available(name: string): Promise<boolean>`
+
+Check if a `.agnt` name is available for registration.
+
+### Error Handling
+
+```typescript
+import { AgntClient, AgntError } from "@agnt-id/resolve";
+
+try {
+  await agnt.resolve("nonexistent.agnt");
+} catch (err) {
+  if (err instanceof AgntError) {
+    console.log(err.status);  // 404
+    console.log(err.message); // "not found"
+  }
+}
+```
+
+## Types
+
+All types are exported:
+
+```typescript
+import type {
+  AgntRecord,
+  AgntName,
+  ResolveResult,
+  ReverseResult,
+  DiscoverResult,
+  DiscoverEntry,
+  OwnerResult,
+  TrustResult,
+  TrustScore,
+  TrustSignal,
+  DomainResult,
+  DomainEntry,
+  AgntClientOptions,
+  DiscoverOptions,
+  OwnerOptions,
+} from "@agnt-id/resolve";
+```
+
+## Links
+
+- [Website](https://www.agnt.id)
+- [API Docs](https://www.agnt.id/docs)
+- [GitHub](https://github.com/txc0ld/agnt.id)
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -42,6 +42,18 @@ export declare class AgntClient {
     domains(name: string, options?: {
         chainId?: string;
     }): Promise<DomainResult>;
+    /**
+     * Get x402 payment config for a name, if enabled.
+     *
+     * @param name - Full name (e.g. "alice.agnt") or label (e.g. "alice")
+     * @returns x402 config if enabled, null otherwise
+     */
+    x402(name: string): Promise<{
+        paymentAddress: string;
+        pricePerCall: string;
+        chainId: number;
+        enabled: boolean;
+    } | null>;
     /**
      * Check if a name is available for registration.
      */

package/dist/client.js

@@ -99,12 +99,26 @@ export class AgntClient {
             throw new AgntError(res.status, await safeText(res));
         return res.json();
     }
+    /**
+     * Get x402 payment config for a name, if enabled.
+     *
+     * @param name - Full name (e.g. "alice.agnt") or label (e.g. "alice")
+     * @returns x402 config if enabled, null otherwise
+     */
+    async x402(name) {
+        const result = await this.resolve(name);
+        if (!result?.records?.x402Config?.enabled)
+            return null;
+        return result.records.x402Config;
+    }
     /**
      * Check if a name is available for registration.
      */
     async available(name) {
         const full = ensureSuffix(name);
-        const res = await this._fetch(`${this.gateway}/v1/agnt/available/${encodeURIComponent(full)}`);
+        const url = new URL(`${this.gateway}/v1/agnt/gateway/available/${encodeURIComponent(full)}`);
+        url.searchParams.set("chain_id", this.chainId);
+        const res = await this._fetch(url.toString());
         if (!res.ok)
             throw new AgntError(res.status, await safeText(res));
         const data = await res.json();

package/dist/types.d.ts

@@ -22,8 +22,13 @@ export type AgntRecord = {
     did?: string;
     /** Trust model tags */
     trustModels?: ("reputation" | "crypto-economic" | "tee-attestation" | "social-graph")[];
-    /** Whether the agent supports x402 payments */
-    x402Support?: boolean;
+    /** x402 payment configuration */
+    x402Config?: {
+        paymentAddress: string;
+        pricePerCall: string;
+        chainId: number;
+        enabled: boolean;
+    };
     /** CAIP-10 address of reputation registry */
     reputationRegistry?: string;
     /** OASF skill slugs */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agnt-id/resolve",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Resolve .agnt names to wallets, agent endpoints, and identity records",
   "type": "module",
   "main": "dist/index.js",
@@ -11,12 +11,24 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "tsc"
   },
-  "keywords": ["agnt", "agent", "naming", "web3", "ethereum", "resolve", "a2a", "mcp"],
+  "keywords": [
+    "agnt",
+    "agent",
+    "naming",
+    "web3",
+    "ethereum",
+    "resolve",
+    "a2a",
+    "mcp"
+  ],
   "license": "MIT",
   "devDependencies": {
     "typescript": "^5.9.3"