@agenticprimitives/agent-naming 0.1.0-alpha.2

package/dist/client.js

@@ -0,0 +1,299 @@
+import { createPublicClient, http } from 'viem';
+import { agentNameAttributeResolverAbi, agentNameRegistryAbi, agentNameUniversalResolverAbi, } from './abis';
+import { PREDICATE_ID, decodeRecords, } from './records';
+import { buildRegisterSubnameCall, buildRecordCalls, buildSetPrimaryNameCall, buildSetSubregistryCall, } from './custody';
+import { namehash, ZERO_NODE } from './namehash';
+/**
+ * Read + write client for the Agent Naming Service.
+ *
+ * Phase 2 lands the read paths (resolveName / reverseResolve /
+ * getRecords) against the live AgentNameUniversalResolver +
+ * AgentNameAttributeResolver. Write methods still throw `NS Phase 4`
+ * — they need ERC-1271 auth + the agent-naming/custody call builders.
+ *
+ * Round-trip discipline (security invariant from spec § 10):
+ *   `reverseResolve(agent)` returns a name ONLY when the on-chain
+ *   `resolveName(name) === agent`. The universal resolver enforces this
+ *   on chain and returns the full dotted name in a single view call.
+ *
+ * NO-FALLBACK DOCTRINE (ADR-0012 + ADR-0013): every read here is one
+ * `readContract`. There is NO `eth_getLogs` walk, no "try fast path then
+ * fall back to log scan." If the resolver has no answer, the read returns
+ * null/empty — it does not reach for an alternative path.
+ */
+export class AgentNamingClient {
+    opts;
+    publicClient;
+    constructor(opts) {
+        this.opts = opts;
+        if (!opts.rpcUrl)
+            throw new Error('[agent-naming] rpcUrl required');
+        if (!opts.registry)
+            throw new Error('[agent-naming] registry address required');
+        if (!opts.universalResolver) {
+            throw new Error('[agent-naming] universalResolver address required');
+        }
+        this.publicClient = createPublicClient({ transport: http(opts.rpcUrl) });
+    }
+    // ─── Reads (Phase 2 — live) ─────────────────────────────────────
+    /**
+     * Resolve an agent name to its forward-record address. Returns
+     * `null` when the name is unregistered OR no `addr` record is set.
+     *
+     * Reads via `UniversalResolver.resolveName(node)` which:
+     *   1. Tries `resolver.getAddress(node, ATL_ADDR)`.
+     *   2. Falls back to `registry.owner(node)` if no resolver-addr set.
+     */
+    async resolveName(name) {
+        const node = namehash(name);
+        if (node === ZERO_NODE)
+            return null;
+        const addr = await this.publicClient.readContract({
+            address: this.opts.universalResolver,
+            abi: agentNameUniversalResolverAbi,
+            functionName: 'resolveName',
+            args: [node],
+        });
+        if (addr === '0x0000000000000000000000000000000000000000')
+            return null;
+        return addr;
+    }
+    /**
+     * Reverse-resolve a Smart Agent address to its primary name string.
+     * Returns `null` when no primary name is set OR the round-trip
+     * check fails on chain (squat protection).
+     *
+     * Single on-chain read: `reverseResolveString` returns the full
+     * dotted name; the resolver concatenates ancestor labels via view
+     * calls. No SDK-side log walk, no fallback path (ADR-0013).
+     */
+    async reverseResolve(agent) {
+        const fullName = (await this.publicClient.readContract({
+            address: this.opts.universalResolver,
+            abi: agentNameUniversalResolverAbi,
+            functionName: 'reverseResolveString',
+            args: [agent],
+        }));
+        return fullName && fullName.length > 0 ? fullName : null;
+    }
+    /**
+     * Read the full typed record bundle for a name. Returns an empty
+     * bundle when the name has no resolver / no records set.
+     */
+    async getRecords(name) {
+        const node = namehash(name);
+        if (node === ZERO_NODE)
+            return {};
+        // Read the resolver address from the registry; if none, return empty.
+        const resolverAddr = await this.publicClient.readContract({
+            address: this.opts.registry,
+            abi: agentNameRegistryAbi,
+            functionName: 'resolver',
+            args: [node],
+        });
+        if (resolverAddr === '0x0000000000000000000000000000000000000000')
+            return {};
+        // String predicates batched through the universal resolver
+        // (single multi-call for everything that's stored as string).
+        const stringPreds = [
+            PREDICATE_ID.displayName,
+            PREDICATE_ID.a2aEndpoint,
+            PREDICATE_ID.mcpEndpoint,
+            PREDICATE_ID.metadataUri,
+            PREDICATE_ID.nativeId,
+        ];
+        const stringValues = await this.publicClient.readContract({
+            address: this.opts.universalResolver,
+            abi: agentNameUniversalResolverAbi,
+            functionName: 'resolveStringBatch',
+            args: [node, stringPreds],
+        });
+        // Address + bytes32 predicates — direct getter calls against the
+        // resolver (no batch path on chain yet; per-call is cheap for the
+        // small constant set we have).
+        const [addr, custodyPolicy] = await Promise.all([
+            this.publicClient.readContract({
+                address: resolverAddr,
+                abi: agentNameAttributeResolverAbi,
+                functionName: 'getAddress',
+                args: [node, PREDICATE_ID.addr],
+            }),
+            this.publicClient.readContract({
+                address: resolverAddr,
+                abi: agentNameAttributeResolverAbi,
+                functionName: 'getAddress',
+                args: [node, PREDICATE_ID.custodyPolicy],
+            }),
+        ]);
+        const [agentKind, metadataHash, passkeyDigest] = await Promise.all([
+            this.publicClient.readContract({
+                address: resolverAddr,
+                abi: agentNameAttributeResolverAbi,
+                functionName: 'getBytes32',
+                args: [node, PREDICATE_ID.agentKind],
+            }),
+            this.publicClient.readContract({
+                address: resolverAddr,
+                abi: agentNameAttributeResolverAbi,
+                functionName: 'getBytes32',
+                args: [node, PREDICATE_ID.metadataHash],
+            }),
+            this.publicClient.readContract({
+                address: resolverAddr,
+                abi: agentNameAttributeResolverAbi,
+                functionName: 'getBytes32',
+                args: [node, PREDICATE_ID.passkeyCredentialDigest],
+            }),
+        ]);
+        const input = { strings: {}, addresses: {}, bytes32s: {} };
+        input.strings[PREDICATE_ID.displayName] = stringValues[0];
+        input.strings[PREDICATE_ID.a2aEndpoint] = stringValues[1];
+        input.strings[PREDICATE_ID.mcpEndpoint] = stringValues[2];
+        input.strings[PREDICATE_ID.metadataUri] = stringValues[3];
+        input.strings[PREDICATE_ID.nativeId] = stringValues[4];
+        if (addr !== '0x0000000000000000000000000000000000000000') {
+            input.addresses[PREDICATE_ID.addr] = addr;
+        }
+        if (custodyPolicy !== '0x0000000000000000000000000000000000000000') {
+            input.addresses[PREDICATE_ID.custodyPolicy] = custodyPolicy;
+        }
+        if (agentKind !== ZERO_NODE)
+            input.bytes32s[PREDICATE_ID.agentKind] = agentKind;
+        if (metadataHash !== ZERO_NODE)
+            input.bytes32s[PREDICATE_ID.metadataHash] = metadataHash;
+        if (passkeyDigest !== ZERO_NODE)
+            input.bytes32s[PREDICATE_ID.passkeyCredentialDigest] = passkeyDigest;
+        return decodeRecords(input);
+    }
+    // ─── Writes (Phase 4 — live) ─────────────────────────────────────
+    /**
+     * Register `<label>.<parent>` under the parent namespace. The
+     * provided `walletClient`'s account MUST be authorized to register
+     * children under `parent` (either direct owner OR subregistry
+     * delegate). Returns the registration tx hash; the new child node
+     * can be computed off-chain as
+     * `keccak256(parentNode || keccak256(label))` — equal to
+     * `namehash(label + '.' + parentName)`.
+     *
+     * For PSA-controlled registrations (where the parent's owner is a
+     * Smart Agent gated by CustodyPolicy), use the builders in
+     * `./custody` directly and compose them into the appropriate
+     * AgentAccount.execute / CustodyPolicy ceremony instead.
+     */
+    async registerSubname(input, ctx) {
+        const parentNode = namehash(input.parent);
+        const call = buildRegisterSubnameCall({
+            registry: this.opts.registry,
+            parentNode,
+            label: input.label,
+            newOwner: input.owner,
+            resolver: input.resolver,
+        });
+        const hash = await this._submit(ctx, call);
+        if (input.initialRecords) {
+            // Compute the new child node off-chain so we don't have to
+            // re-read against a possibly-lagging RPC.
+            const childNode = namehash(`${input.label}.${input.parent}`);
+            const resolver = input.resolver ?? this.opts.universalResolver; // best-effort default
+            const calls = buildRecordCalls({ resolver, node: childNode, records: input.initialRecords });
+            for (const c of calls)
+                await this._submit(ctx, c);
+        }
+        return hash;
+    }
+    /**
+     * Set the caller's primary name (reverse record). The wallet
+     * client's account MUST equal `input.agent` — the contract enforces
+     * `msg.sender == agent` (i.e. an agent sets its OWN primary name;
+     * authority over reverse records is per-account by construction).
+     */
+    async setPrimaryName(input, ctx) {
+        const node = namehash(input.name);
+        const call = buildSetPrimaryNameCall({ registry: this.opts.registry, node });
+        return await this._submit(ctx, call);
+    }
+    /**
+     * Write the typed record bundle for `input.name`. The
+     * `walletClient`'s account MUST be the current name owner
+     * (`REGISTRY.owner(node) == msg.sender`). Returns one tx hash per
+     * record set — the caller may parallelize submission via a multi-call
+     * upstream if/when one becomes available.
+     */
+    async setAgentRecords(input, ctx) {
+        const node = namehash(input.name);
+        // Resolve the resolver address for this name via the registry.
+        const resolverAddr = await this.publicClient.readContract({
+            address: this.opts.registry,
+            abi: agentNameRegistryAbi,
+            functionName: 'resolver',
+            args: [node],
+        });
+        if (resolverAddr === '0x0000000000000000000000000000000000000000') {
+            throw new Error(`[agent-naming] no resolver set for "${input.name}"; install one via setResolver first`);
+        }
+        const calls = buildRecordCalls({
+            resolver: resolverAddr,
+            node,
+            records: input.records,
+        });
+        const hashes = [];
+        for (const c of calls)
+            hashes.push(await this._submit(ctx, c));
+        return hashes;
+    }
+    /**
+     * Delegate child-name issuance authority for the subtree at
+     * `input.name` to a subregistry contract. The wallet client's
+     * account MUST be the current name owner.
+     */
+    async setSubregistry(input, ctx) {
+        const node = namehash(input.name);
+        const call = buildSetSubregistryCall({
+            registry: this.opts.registry,
+            node,
+            subregistry: input.subregistry,
+        });
+        return await this._submit(ctx, call);
+    }
+    /**
+     * Submit a single ContractCall via the bound walletClient. Uses
+     * explicit nonce fetch + retry on "replacement underpriced" to
+     * tolerate Base Sepolia's read-after-write lag.
+     */
+    async _submit(ctx, call) {
+        const { walletClient } = ctx;
+        const account = walletClient.account;
+        if (!account)
+            throw new Error('[agent-naming] walletClient has no account; cannot sign tx');
+        let lastErr;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const nonce = await this.publicClient.getTransactionCount({
+                    address: account.address,
+                    blockTag: 'pending',
+                });
+                const hash = await walletClient.sendTransaction({
+                    to: call.to,
+                    value: call.value,
+                    data: call.data,
+                    nonce,
+                    account: walletClient.account,
+                    chain: walletClient.chain ?? null,
+                });
+                await this.publicClient.waitForTransactionReceipt({ hash });
+                return hash;
+            }
+            catch (err) {
+                lastErr = err;
+                const msg = err.message ?? '';
+                if (msg.includes('replacement') || msg.includes('underpriced')) {
+                    await new Promise((r) => setTimeout(r, 2000));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastErr instanceof Error ? lastErr : new Error('[agent-naming] _submit: exceeded retries');
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The TLD for Smart Agent names. Phase 1 ships `.agent` only; the
+ * underlying registry contract is multi-root, but the package surface
+ * restricts to `.agent` until additional TLDs are spec'd.
+ */
+export declare const AGENT_TLD: "agent";
+export type AgentTld = typeof AGENT_TLD;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAG,OAAgB,CAAC;AAC1C,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC"}

package/dist/constants.js

@@ -0,0 +1,7 @@
+/**
+ * The TLD for Smart Agent names. Phase 1 ships `.agent` only; the
+ * underlying registry contract is multi-root, but the package surface
+ * restricts to `.agent` until additional TLDs are spec'd.
+ */
+export const AGENT_TLD = 'agent';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAgB,CAAC"}

package/dist/custody.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Subpath `@agenticprimitives/agent-naming/custody`.
+ *
+ * Pure encoded call builders for name-registry + resolver writes.
+ * Compose these into a custody ceremony, a direct EOA tx, an
+ * ERC-4337 UserOp, or anything else that submits a transaction.
+ * The package boundary (spec 215 § 3) prohibits importing
+ * `@agenticprimitives/account-custody` from here — these builders MUST stay
+ * pure encode-only.
+ *
+ * Each builder returns a `ContractCall` shape (`{ to, value, data }`)
+ * matching the standard "compose-then-submit" pattern used across
+ * other agenticprimitives packages.
+ *
+ * Phase 4 lands the encoders; the client (`AgentNamingClient`) layers
+ * walletClient submission on top.
+ */
+import type { Address, Hex } from '@agenticprimitives/types';
+import { type EncodedRecord } from './records';
+/** Minimal call-shape: the standard `{ to, value, data }` triple. */
+export interface ContractCall {
+    to: Address;
+    value: bigint;
+    data: Hex;
+}
+/**
+ * Build a call to register `<label>.<parent>` under the parent
+ * namespace. Caller MUST be the parent's owner OR subregistry
+ * delegate (msg.sender check on chain).
+ */
+export declare function buildRegisterSubnameCall(args: {
+    registry: Address;
+    parentNode: Hex;
+    label: string;
+    newOwner: Address;
+    resolver?: Address;
+    expiry?: bigint;
+}): ContractCall;
+/**
+ * Build a call to rotate the owner Smart Agent for a name.
+ * Caller MUST be the current owner.
+ */
+export declare function buildRotateNameOwnerCall(args: {
+    registry: Address;
+    node: Hex;
+    newOwner: Address;
+}): ContractCall;
+/**
+ * Build a call to swap the resolver contract for a name.
+ * Caller MUST be the current owner.
+ */
+export declare function buildRotateNameResolverCall(args: {
+    registry: Address;
+    node: Hex;
+    newResolver: Address;
+}): ContractCall;
+/**
+ * Build a call to delegate child-name issuance authority for a
+ * subtree to a subregistry contract. Setting `subregistry = address(0)`
+ * reverts to "owner-only" issuance.
+ */
+export declare function buildSetSubregistryCall(args: {
+    registry: Address;
+    node: Hex;
+    subregistry: Address;
+}): ContractCall;
+/**
+ * Build a call to set the caller's primary name (reverse record).
+ * Caller MUST be the agent for which the primary name is being set
+ * (msg.sender == agent on chain). Setting `node = bytes32(0)` clears
+ * the primary name.
+ */
+export declare function buildSetPrimaryNameCall(args: {
+    registry: Address;
+    node: Hex;
+}): ContractCall;
+/** Build a typed `setStringAttribute(node, predicate, value)` call. */
+export declare function buildSetStringAttributeCall(args: {
+    resolver: Address;
+    node: Hex;
+    predicate: Hex;
+    value: string;
+}): ContractCall;
+/** Build a typed `setAddressAttribute(node, predicate, value)` call. */
+export declare function buildSetAddressAttributeCall(args: {
+    resolver: Address;
+    node: Hex;
+    predicate: Hex;
+    value: Address;
+}): ContractCall;
+/** Build a typed `setBytes32Attribute(node, predicate, value)` call. */
+export declare function buildSetBytes32AttributeCall(args: {
+    resolver: Address;
+    node: Hex;
+    predicate: Hex;
+    value: Hex;
+}): ContractCall;
+/**
+ * Translate an `AgentNameRecords` bundle into N typed-attribute
+ * calls. Caller submits them via walletClient OR composes them into
+ * a single AgentAccount.execute / CustodyPolicy ceremony.
+ *
+ * Mirrors `encodeRecords` from `agent-naming/records` but produces
+ * full `ContractCall` shapes instead of `EncodedRecord` shapes.
+ */
+export declare function buildRecordCalls(args: {
+    resolver: Address;
+    node: Hex;
+    records: import('./types').AgentNameRecords;
+}): ContractCall[];
+/**
+ * Build a call to claim `<label>.<parent>` through a deployed
+ * PermissionlessSubregistry instance. The caller pays gas; the
+ * registered child name is owned by `newOwner` (typically the
+ * caller's own PSA OR an account they control).
+ *
+ * Anti-spam: one claim per `msg.sender` is enforced on chain; the
+ * call reverts with `AlreadyClaimed(existingNode)` if the caller
+ * has previously claimed a name through this subregistry instance.
+ */
+export declare function buildSubregistryRegisterCall(args: {
+    subregistry: Address;
+    label: string;
+    newOwner: Address;
+}): ContractCall;
+/**
+ * Convenience: re-export the encoded-record shape from records.ts so
+ * downstream callers can pick whichever level of abstraction fits
+ * (EncodedRecord = pre-typed-setter args; ContractCall = full
+ * encoded call).
+ */
+export type { EncodedRecord };
+//# sourceMappingURL=custody.d.ts.map

package/dist/custody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custody.d.ts","sourceRoot":"","sources":["../src/custody.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAM7D,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAG5E,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;CACX;AAID;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,GAAG,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,YAAY,CAgBf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,YAAY,CAUf;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,YAAY,CAUf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,YAAY,CAUf;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;CACX,GAAG,YAAY,CAUf;AAID,uEAAuE;AACvE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,GAAG,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,YAAY,CAUf;AAED,wEAAwE;AACxE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,GAAG,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,YAAY,CAUf;AAED,wEAAwE;AACxE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,GAAG,CAAC;IACf,KAAK,EAAE,GAAG,CAAC;CACZ,GAAG,YAAY,CAUf;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,OAAO,SAAS,EAAE,gBAAgB,CAAC;CAC7C,GAAG,YAAY,EAAE,CAsCjB;AAID;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,YAAY,CAUf;AAED;;;;;GAKG;AACH,YAAY,EAAE,aAAa,EAAE,CAAC"}