@azeth/sdk 0.2.0

package/dist/registry/discover.d.ts

@@ -0,0 +1,43 @@
+import type { PublicClient, Transport, Chain } from 'viem';
+import { type RegistryEntry, type DiscoveryParams, type SupportedChainName } from '@azeth/common';
+/** Discover services from the Azeth server's trust registry index.
+ *
+ *  MEDIUM-8 (Audit): Results are fetched from the server's in-memory index, NOT verified
+ *  on-chain. The server could return stale, incomplete, or manipulated entries. For security-
+ *  critical decisions (e.g., routing payments or trusting a service endpoint), callers SHOULD
+ *  verify the returned entries against the on-chain ERC-8004 Identity Registry before trusting
+ *  them. Use the contract's `ownerOf(tokenId)` and metadata to confirm authenticity.
+ */
+export declare function discoverServices(serverUrl: string, params: DiscoveryParams): Promise<RegistryEntry[]>;
+/** Get a specific registry entry by token ID */
+export declare function getRegistryEntry(serverUrl: string, tokenId: bigint): Promise<RegistryEntry | null>;
+/** Result from discovery with fallback — includes source indicator */
+export interface DiscoveryWithFallbackResult {
+    entries: RegistryEntry[];
+    /** 'server' if results came from the API, 'on-chain' if from direct contract reads */
+    source: 'server' | 'on-chain';
+    /** True when minReputation was requested but ignored in on-chain mode */
+    minReputationIgnored?: boolean;
+}
+/** Options for discoverServicesWithFallback */
+export interface DiscoveryFallbackOptions {
+    /** Cache query results in-memory for 60s (default: false) */
+    cacheResults?: boolean;
+}
+/** Discover services with automatic on-chain fallback when the server is unavailable.
+ *
+ *  First tries the Azeth server API (fast, indexed, supports reputation sorting).
+ *  If the server is unreachable (`SERVER_UNAVAILABLE`), retries once after 2s delay,
+ *  then falls back to reading the ERC-8004 Identity Registry via the AzethOracle's
+ *  `discoverRegistry()` view function.
+ *
+ *  On-chain fallback limitations:
+ *  - Does NOT support minReputation or sortByReputation (requires the server's index)
+ *  - Filters by capability and entityType are applied client-side
+ *  - Reads up to 1000 entries per RPC call via the AzethOracle batch view function
+ *  - Oracle uses early termination after 5 consecutive non-existent token IDs
+ *
+ *  @param options.cacheResults - Cache results in-memory for 60s (default: false)
+ */
+export declare function discoverServicesWithFallback(serverUrl: string, params: DiscoveryParams, publicClient: PublicClient<Transport, Chain>, chainName: SupportedChainName, options?: DiscoveryFallbackOptions): Promise<DiscoveryWithFallbackResult>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/registry/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/registry/discover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3D,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAIvB;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CAiC1B;AAED,gDAAgD;AAChD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuB/B;AAuCD,sEAAsE;AACtE,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,sFAAsF;IACtF,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA8CD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,SAAS,EAAE,kBAAkB,EAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,2BAA2B,CAAC,CAyBtC"}

package/dist/registry/discover.js

@@ -0,0 +1,272 @@
+import { AzethError, AZETH_CONTRACTS, ERC8004_REGISTRY, } from '@azeth/common';
+import { AzethOracleAbi } from '@azeth/common/abis';
+import { withRetry } from '../utils/retry.js';
+/** Discover services from the Azeth server's trust registry index.
+ *
+ *  MEDIUM-8 (Audit): Results are fetched from the server's in-memory index, NOT verified
+ *  on-chain. The server could return stale, incomplete, or manipulated entries. For security-
+ *  critical decisions (e.g., routing payments or trusting a service endpoint), callers SHOULD
+ *  verify the returned entries against the on-chain ERC-8004 Identity Registry before trusting
+ *  them. Use the contract's `ownerOf(tokenId)` and metadata to confirm authenticity.
+ */
+export async function discoverServices(serverUrl, params) {
+    // H-7 fix: Default limit 20, max 100 to prevent unbounded API reads
+    const limit = Math.min(params.limit ?? 20, 100);
+    const queryParams = new URLSearchParams();
+    if (params.capability)
+        queryParams.set('capability', params.capability);
+    if (params.entityType)
+        queryParams.set('entityType', params.entityType);
+    if (params.minReputation !== undefined)
+        queryParams.set('minReputation', params.minReputation.toString());
+    if (params.sortByReputation)
+        queryParams.set('sortByReputation', 'true');
+    queryParams.set('limit', limit.toString());
+    if (params.offset !== undefined)
+        queryParams.set('offset', params.offset.toString());
+    let response;
+    try {
+        response = await withRetry(() => fetch(`${serverUrl}/api/v1/registry/discover?${queryParams}`));
+    }
+    catch (err) {
+        if (err instanceof AzethError)
+            throw err;
+        throw new AzethError(err instanceof Error ? err.message : 'Failed to discover services', 'SERVER_UNAVAILABLE', { originalError: err instanceof Error ? err.name : undefined });
+    }
+    if (!response.ok) {
+        throw new AzethError(`Discovery API error: ${response.status}`, response.status === 404 ? 'SERVICE_NOT_FOUND' : 'REGISTRY_ERROR', { status: response.status });
+    }
+    const body = await response.json();
+    return body.data ?? [];
+}
+/** Get a specific registry entry by token ID */
+export async function getRegistryEntry(serverUrl, tokenId) {
+    let response;
+    try {
+        response = await withRetry(() => fetch(`${serverUrl}/api/v1/registry/${tokenId}`));
+    }
+    catch (err) {
+        if (err instanceof AzethError)
+            throw err;
+        throw new AzethError(err instanceof Error ? err.message : 'Failed to get registry entry', 'SERVER_UNAVAILABLE', { originalError: err instanceof Error ? err.name : undefined });
+    }
+    if (response.status === 404)
+        return null;
+    if (!response.ok) {
+        throw new AzethError(`Registry API error: ${response.status}`, 'REGISTRY_ERROR', { status: response.status, tokenId: tokenId.toString() });
+    }
+    const body = await response.json();
+    return body.data ?? null;
+}
+// ── On-chain fallback via AzethOracle ────────────────────────────────────────
+/** Batch size for oracle discovery — entries per RPC call (oracle caps at 1000) */
+const ORACLE_BATCH_SIZE = 1000;
+/** Parse a data:application/json, URI into metadata fields */
+function parseDataURI(uri) {
+    try {
+        if (!uri.startsWith('data:application/json,'))
+            return null;
+        const jsonStr = decodeURIComponent(uri.slice('data:application/json,'.length));
+        const meta = JSON.parse(jsonStr);
+        const name = typeof meta.name === 'string' ? meta.name : '';
+        const description = typeof meta.description === 'string' ? meta.description : '';
+        const entityType = typeof meta.entityType === 'string' && ['agent', 'service', 'infrastructure'].includes(meta.entityType)
+            ? meta.entityType
+            : 'agent';
+        const capabilities = Array.isArray(meta.capabilities)
+            ? meta.capabilities.filter((c) => typeof c === 'string')
+            : [];
+        const endpoint = typeof meta.endpoint === 'string' ? meta.endpoint : undefined;
+        return { name, description, entityType, capabilities, endpoint };
+    }
+    catch {
+        return null;
+    }
+}
+// ── SDK-side discovery cache ─────────────────────────────────────────────────
+const SDK_CACHE_TTL_MS = 60_000;
+const SDK_CACHE_MAX = 100;
+const sdkDiscoveryCache = new Map();
+/** Serialize params into a stable cache key */
+function makeCacheKey(serverUrl, params, chainName) {
+    return JSON.stringify({
+        u: serverUrl,
+        p: {
+            c: params.capability,
+            e: params.entityType,
+            n: params.name,
+            mr: params.minReputation,
+            sr: params.sortByReputation,
+            l: params.limit,
+            o: params.offset,
+        },
+        ch: chainName,
+    });
+}
+/** Evict the least-recently-accessed entry from the SDK cache */
+function evictLRU() {
+    if (sdkDiscoveryCache.size < SDK_CACHE_MAX)
+        return;
+    let lruKey;
+    let lruTime = Infinity;
+    for (const [k, v] of sdkDiscoveryCache) {
+        if (v.lastAccessed < lruTime) {
+            lruTime = v.lastAccessed;
+            lruKey = k;
+        }
+    }
+    if (lruKey !== undefined)
+        sdkDiscoveryCache.delete(lruKey);
+}
+/** Discover services with automatic on-chain fallback when the server is unavailable.
+ *
+ *  First tries the Azeth server API (fast, indexed, supports reputation sorting).
+ *  If the server is unreachable (`SERVER_UNAVAILABLE`), retries once after 2s delay,
+ *  then falls back to reading the ERC-8004 Identity Registry via the AzethOracle's
+ *  `discoverRegistry()` view function.
+ *
+ *  On-chain fallback limitations:
+ *  - Does NOT support minReputation or sortByReputation (requires the server's index)
+ *  - Filters by capability and entityType are applied client-side
+ *  - Reads up to 1000 entries per RPC call via the AzethOracle batch view function
+ *  - Oracle uses early termination after 5 consecutive non-existent token IDs
+ *
+ *  @param options.cacheResults - Cache results in-memory for 60s (default: false)
+ */
+export async function discoverServicesWithFallback(serverUrl, params, publicClient, chainName, options) {
+    // Check SDK-side cache if enabled
+    if (options?.cacheResults) {
+        const cacheKey = makeCacheKey(serverUrl, params, chainName);
+        const cached = sdkDiscoveryCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < SDK_CACHE_TTL_MS) {
+            cached.lastAccessed = Date.now();
+            return cached.result;
+        }
+    }
+    const result = await discoverServicesWithFallbackInner(serverUrl, params, publicClient, chainName);
+    // Store in SDK cache if enabled
+    if (options?.cacheResults) {
+        const cacheKey = makeCacheKey(serverUrl, params, chainName);
+        evictLRU();
+        sdkDiscoveryCache.set(cacheKey, {
+            result,
+            timestamp: Date.now(),
+            lastAccessed: Date.now(),
+        });
+    }
+    return result;
+}
+/** Internal implementation — performs server attempt with retry then on-chain fallback */
+async function discoverServicesWithFallbackInner(serverUrl, params, publicClient, chainName) {
+    // Try the server first
+    try {
+        const entries = await discoverServices(serverUrl, params);
+        // Fall back to on-chain when server returns empty results — the server index may be
+        // stale or incomplete, but the on-chain registry is the source of truth.
+        if (entries.length > 0) {
+            return { entries, source: 'server' };
+        }
+    }
+    catch (err) {
+        // Fall back to on-chain for server connectivity issues AND 404/registry errors
+        const fallbackCodes = new Set(['SERVER_UNAVAILABLE', 'SERVICE_NOT_FOUND', 'REGISTRY_ERROR']);
+        if (!(err instanceof AzethError) || !fallbackCodes.has(err.code)) {
+            throw err;
+        }
+        // Retry once with 2s delay before falling back to on-chain
+        try {
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            const entries = await discoverServices(serverUrl, params);
+            if (entries.length > 0) {
+                return { entries, source: 'server' };
+            }
+        }
+        catch (retryErr) {
+            if (!(retryErr instanceof AzethError) || !fallbackCodes.has(retryErr.code)) {
+                throw retryErr;
+            }
+            // Fall through to on-chain
+        }
+    }
+    // On-chain fallback via AzethOracle.discoverRegistry()
+    const registryAddress = ERC8004_REGISTRY[chainName];
+    if (!registryAddress) {
+        throw new AzethError(`No ERC-8004 Identity Registry configured for ${chainName}`, 'REGISTRY_ERROR');
+    }
+    const oracleAddress = AZETH_CONTRACTS[chainName]?.priceOracle;
+    if (!oracleAddress) {
+        throw new AzethError(`No AzethOracle configured for ${chainName}`, 'REGISTRY_ERROR');
+    }
+    const limit = Math.min(params.limit ?? 20, 100);
+    const offset = params.offset ?? 0;
+    const collectTarget = offset + limit; // collect enough to slice for offset
+    const entries = [];
+    let startId = 0;
+    let reachedEnd = false;
+    while (!reachedEnd && entries.length < collectTarget) {
+        let snapshots;
+        let scannedCount;
+        try {
+            [snapshots, scannedCount] = await publicClient.readContract({
+                address: oracleAddress,
+                abi: AzethOracleAbi,
+                functionName: 'discoverRegistry',
+                args: [registryAddress, BigInt(startId), BigInt(ORACLE_BATCH_SIZE)],
+            });
+        }
+        catch {
+            throw new AzethError('Failed to query AzethOracle discoverRegistry', 'NETWORK_ERROR');
+        }
+        for (const snap of snapshots) {
+            if (entries.length >= collectTarget)
+                break;
+            if (!snap.exists)
+                continue;
+            const meta = parseDataURI(snap.uri);
+            if (!meta)
+                continue;
+            // Apply filters client-side
+            if (params.capability && !meta.capabilities.some((c) => c.toLowerCase() === params.capability.toLowerCase())) {
+                continue;
+            }
+            if (params.entityType && meta.entityType !== params.entityType) {
+                continue;
+            }
+            if (params.name && meta.name.trim().toLowerCase() !== params.name.trim().toLowerCase()) {
+                continue;
+            }
+            entries.push({
+                tokenId: snap.tokenId,
+                owner: snap.owner,
+                entityType: meta.entityType,
+                name: meta.name,
+                description: meta.description,
+                capabilities: meta.capabilities,
+                endpoint: meta.endpoint,
+                active: true,
+            });
+        }
+        // If scannedCount < ORACLE_BATCH_SIZE, oracle hit early termination (end of registry)
+        if (scannedCount < BigInt(ORACLE_BATCH_SIZE)) {
+            reachedEnd = true;
+        }
+        else {
+            startId += ORACLE_BATCH_SIZE;
+        }
+    }
+    // Sort: entries with endpoints first, then newest tokenId (most likely to be live)
+    entries.sort((a, b) => {
+        const aHas = a.endpoint ? 1 : 0;
+        const bHas = b.endpoint ? 1 : 0;
+        if (aHas !== bHas)
+            return bHas - aHas;
+        return Number(b.tokenId - a.tokenId);
+    });
+    return {
+        entries: entries.slice(offset, offset + limit),
+        source: 'on-chain',
+        // minReputation is not supported in on-chain mode (requires server index)
+        ...(params.minReputation !== undefined ? { minReputationIgnored: true } : {}),
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/registry/discover.js.map

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

package/dist/registry/register.d.ts

@@ -0,0 +1,44 @@
+import { type PublicClient, type Chain, type Transport } from 'viem';
+import { type AzethContractAddresses, type CatalogEntry } from '@azeth/common';
+import type { AzethSmartAccountClient } from '../utils/userop.js';
+export interface RegisterParams {
+    name: string;
+    description: string;
+    entityType: 'agent' | 'service' | 'infrastructure';
+    capabilities: string[];
+    endpoint?: string;
+    pricing?: string;
+    catalog?: CatalogEntry[];
+}
+export interface RegisterResult {
+    tokenId: bigint;
+    txHash: `0x${string}`;
+}
+/** Build a data: URI from registration parameters */
+export declare function buildAgentURI(params: RegisterParams): string;
+/** Register on the ERC-8004 trust registry via the TrustRegistryModule.
+ *
+ *  Routes the call through the smart account so msg.sender = smart account address.
+ *  The TrustRegistryModule checks _initialized[msg.sender], which is only true for
+ *  the smart account — NOT the EOA. Using the smart account client ensures the
+ *  module recognizes the caller.
+ */
+export declare function registerOnRegistry(publicClient: PublicClient<Transport, Chain>, smartAccountClient: AzethSmartAccountClient, addresses: AzethContractAddresses, account: `0x${string}`, params: RegisterParams): Promise<RegisterResult>;
+/** Update metadata for a registered account.
+ *
+ *  Routes the call through the smart account so msg.sender = smart account address.
+ *  The contract expects `value` as bytes. This function accepts a string
+ *  for convenience and encodes it as hex-encoded UTF-8 bytes.
+ */
+export declare function updateMetadata(publicClient: PublicClient<Transport, Chain>, smartAccountClient: AzethSmartAccountClient, addresses: AzethContractAddresses, account: `0x${string}`, key: string, value: string): Promise<`0x${string}`>;
+export interface MetadataUpdate {
+    key: string;
+    value: string;
+}
+/** Update multiple metadata fields in a single batch transaction.
+ *
+ *  Encodes each key-value pair as a separate updateMetadata() call and sends them
+ *  as a batch UserOp via the smart account's execute() with CALLTYPE_BATCH.
+ */
+export declare function updateMetadataBatch(publicClient: PublicClient<Transport, Chain>, smartAccountClient: AzethSmartAccountClient, addresses: AzethContractAddresses, account: `0x${string}`, updates: MetadataUpdate[]): Promise<`0x${string}`>;
+//# sourceMappingURL=register.d.ts.map

package/dist/registry/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/registry/register.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,SAAS,EAMf,MAAM,MAAM,CAAC;AAEd,OAAO,EAAc,KAAK,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAG3F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,gBAAgB,CAAC;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;CACvB;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAY5D;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,kBAAkB,EAAE,uBAAuB,EAC3C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAyCzB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,kBAAkB,EAAE,uBAAuB,EAC3C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAqBxB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,kBAAkB,EAAE,uBAAuB,EAC3C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAiCxB"}

package/dist/registry/register.js

@@ -0,0 +1,126 @@
+import { stringToHex, keccak256, toBytes, encodeFunctionData, } from 'viem';
+import { TrustRegistryModuleAbi } from '@azeth/common/abis';
+import { AzethError } from '@azeth/common';
+import { requireAddress } from '../utils/addresses.js';
+import { wrapContractError } from '../utils/errors.js';
+/** Build a data: URI from registration parameters */
+export function buildAgentURI(params) {
+    const metadata = {
+        name: params.name,
+        description: params.description,
+        entityType: params.entityType,
+        capabilities: params.capabilities,
+        endpoint: params.endpoint ?? '',
+        ...(params.pricing ? { pricing: params.pricing } : {}),
+        ...(params.catalog?.length ? { catalog: params.catalog } : {}),
+        version: '0.1.0',
+    };
+    return `data:application/json,${encodeURIComponent(JSON.stringify(metadata))}`;
+}
+/** Register on the ERC-8004 trust registry via the TrustRegistryModule.
+ *
+ *  Routes the call through the smart account so msg.sender = smart account address.
+ *  The TrustRegistryModule checks _initialized[msg.sender], which is only true for
+ *  the smart account — NOT the EOA. Using the smart account client ensures the
+ *  module recognizes the caller.
+ */
+export async function registerOnRegistry(publicClient, smartAccountClient, addresses, account, params) {
+    const moduleAddress = requireAddress(addresses, 'trustRegistryModule');
+    const agentURI = buildAgentURI(params);
+    let txHash;
+    try {
+        const data = encodeFunctionData({
+            abi: TrustRegistryModuleAbi,
+            functionName: 'registerOnRegistry',
+            args: [agentURI],
+        });
+        txHash = await smartAccountClient.sendTransaction({
+            to: moduleAddress,
+            value: 0n,
+            data,
+        });
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash, timeout: 120_000 });
+    // M-4: Parse the Registered event log for tokenId with proper validation.
+    // Check event signature and contract address to avoid matching unrelated logs.
+    // Event: Registered(address indexed account, uint256 indexed tokenId, string agentURI)
+    const REGISTERED_EVENT_TOPIC = keccak256(toBytes('Registered(address,uint256,string)'));
+    let tokenId = 0n;
+    for (const log of receipt.logs) {
+        if (log.address.toLowerCase() === moduleAddress.toLowerCase()
+            && log.topics[0] === REGISTERED_EVENT_TOPIC
+            && log.topics.length >= 3) {
+            // tokenId is the second indexed topic
+            tokenId = BigInt(log.topics[2] ?? '0x0');
+            break;
+        }
+    }
+    return { tokenId, txHash };
+}
+/** Update metadata for a registered account.
+ *
+ *  Routes the call through the smart account so msg.sender = smart account address.
+ *  The contract expects `value` as bytes. This function accepts a string
+ *  for convenience and encodes it as hex-encoded UTF-8 bytes.
+ */
+export async function updateMetadata(publicClient, smartAccountClient, addresses, account, key, value) {
+    const moduleAddress = requireAddress(addresses, 'trustRegistryModule');
+    let txHash;
+    try {
+        const data = encodeFunctionData({
+            abi: TrustRegistryModuleAbi,
+            functionName: 'updateMetadata',
+            args: [key, stringToHex(value)],
+        });
+        txHash = await smartAccountClient.sendTransaction({
+            to: moduleAddress,
+            value: 0n,
+            data,
+        });
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+    await publicClient.waitForTransactionReceipt({ hash: txHash, timeout: 120_000 });
+    return txHash;
+}
+/** Update multiple metadata fields in a single batch transaction.
+ *
+ *  Encodes each key-value pair as a separate updateMetadata() call and sends them
+ *  as a batch UserOp via the smart account's execute() with CALLTYPE_BATCH.
+ */
+export async function updateMetadataBatch(publicClient, smartAccountClient, addresses, account, updates) {
+    if (updates.length === 0) {
+        throw new AzethError('At least one metadata update is required', 'INVALID_INPUT');
+    }
+    if (updates.length === 1) {
+        // Optimize: single update uses the simpler single-call path
+        return updateMetadata(publicClient, smartAccountClient, addresses, account, updates[0].key, updates[0].value);
+    }
+    const moduleAddress = requireAddress(addresses, 'trustRegistryModule');
+    // Encode each updateMetadata call as a separate transaction in the batch
+    const calls = updates.map(({ key, value }) => ({
+        to: moduleAddress,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: TrustRegistryModuleAbi,
+            functionName: 'updateMetadata',
+            args: [key, stringToHex(value)],
+        }),
+    }));
+    let txHash;
+    try {
+        txHash = await smartAccountClient.sendTransaction({
+            calls,
+        });
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+    await publicClient.waitForTransactionReceipt({ hash: txHash, timeout: 120_000 });
+    return txHash;
+}
+//# sourceMappingURL=register.js.map

package/dist/registry/register.js.map

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

package/dist/reputation/opinion.d.ts

@@ -0,0 +1,52 @@
+import { type PublicClient, type Chain, type Transport } from 'viem';
+import { type SupportedChainName, type AzethContractAddresses, type OnChainOpinion, type OpinionEntry, type WeightedReputation, type ActiveOpinion } from '@azeth/common';
+import type { AzethSmartAccountClient } from '../utils/userop.js';
+/** Submit an opinion for an agent on the ERC-8004 Reputation Registry via the ReputationModule.
+ *
+ *  Routes the call through the smart account via ERC-4337 UserOperation so that
+ *  msg.sender in the ReputationModule context is the smart account (not the EOA).
+ *
+ *  The contract requires a positive net USD payment from the caller to the target agent
+ *  (aggregated on-chain via Chainlink). Value is int128 with configurable decimal precision.
+ *  If an opinion already exists for this rater→agent pair, it is updated (old entry revoked, new one created).
+ */
+export declare function submitOpinion(publicClient: PublicClient<Transport, Chain>, smartAccountClient: AzethSmartAccountClient, addresses: AzethContractAddresses, _account: `0x${string}`, opinion: OnChainOpinion): Promise<`0x${string}`>;
+/** Get payment-weighted reputation for an agent from the ReputationModule.
+ *
+ *  Calls ReputationModule.getWeightedReputation(agentId, raters[]).
+ *  Only raters with positive net USD payment to the agent contribute
+ *  to the weighted average.
+ */
+export declare function getWeightedReputation(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, agentId: bigint, raters: `0x${string}`[]): Promise<WeightedReputation>;
+/** Get payment-weighted reputation for an agent across ALL raters.
+ *
+ *  WARNING: This calls the unbounded getWeightedReputationAll() on-chain function.
+ *  Gas cost grows linearly with the number of raters. Use getWeightedReputation()
+ *  with an explicit rater list for production workloads.
+ */
+export declare function getWeightedReputationAll(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, agentId: bigint): Promise<WeightedReputation>;
+/** Get the net payment delta between two accounts for a specific token.
+ *
+ *  Returns a signed int256: positive means `from` has paid `to` more than `to` has paid `from`.
+ *  Negative means `to` has paid `from` more.
+ */
+export declare function getNetPaid(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, from: `0x${string}`, to: `0x${string}`, token: `0x${string}`): Promise<bigint>;
+/** Get the total net payment from `from` to `to` across all supported tokens, in 18-decimal USD.
+ *
+ *  Aggregates positive net deltas across all tokens tracked by the oracle (ETH, USDC, etc.)
+ *  and converts to a single USD value. Always returns >= 0 (only sums directions where
+ *  `from` has paid `to` more).
+ *
+ *  This is the same value the contract uses to gate opinion submissions ($1 minimum).
+ */
+export declare function getTotalNetPaidUSD(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, from: `0x${string}`, to: `0x${string}`): Promise<bigint>;
+/** Get active opinion state for a rater→agent relationship.
+ *
+ *  Returns the current opinion index and whether an active opinion exists.
+ */
+export declare function getActiveOpinion(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`, agentId: bigint): Promise<ActiveOpinion>;
+/** Read a single opinion entry from the ERC-8004 Reputation Registry. */
+export declare function readOpinion(publicClient: PublicClient<Transport, Chain>, chainName: SupportedChainName, agentId: bigint, clientAddress: `0x${string}`, opinionIndex: bigint): Promise<OpinionEntry>;
+/** Get the Azeth ReputationModule address for a chain */
+export declare function getReputationModuleAddress(chainName: SupportedChainName): `0x${string}`;
+//# sourceMappingURL=opinion.d.ts.map

package/dist/reputation/opinion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opinion.d.ts","sourceRoot":"","sources":["../../src/reputation/opinion.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,SAAS,EAEf,MAAM,MAAM,CAAC;AAEd,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,kBAAkB,EAAE,uBAAuB,EAC3C,SAAS,EAAE,sBAAsB,EACjC,QAAQ,EAAE,KAAK,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAsDxB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,KAAK,MAAM,EAAE,EAAE,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,SAAS,EAAE,sBAAsB,EACjC,IAAI,EAAE,KAAK,MAAM,EAAE,EACnB,EAAE,EAAE,KAAK,MAAM,EAAE,EACjB,KAAK,EAAE,KAAK,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,SAAS,EAAE,sBAAsB,EACjC,IAAI,EAAE,KAAK,MAAM,EAAE,EACnB,EAAE,EAAE,KAAK,MAAM,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,yEAAyE;AACzE,wBAAsB,WAAW,CAC/B,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,KAAK,MAAM,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAsBvB;AAED,yDAAyD;AACzD,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,kBAAkB,GAAG,KAAK,MAAM,EAAE,CAUvF"}