envoy-pay 0.1.0

package/dist/types/identity/agent-identity.d.ts

@@ -0,0 +1,102 @@
+/**
+ * AgentIdentity — Main facade for the identity layer.
+ *
+ * Orchestrates DIDResolver, AgentCard, Reputation, and OwnerRegistry
+ * into a single, cohesive interface. This is the primary object that
+ * agents and the EnvoyClient interact with.
+ *
+ * @example
+ * ```ts
+ * const identity = new AgentIdentity({
+ *   metadata: {
+ *     name: 'Trading Bot Alpha',
+ *     version: '1.0.0',
+ *     capabilities: ['trade', 'analyze'],
+ *     owner: '0xOwner...',
+ *   },
+ *   signerAddress: '0xAgent...',
+ *   signerChainId: 'eip155:8453',
+ * });
+ *
+ * // Other agents can verify:
+ * const score = identity.getReputationScore();
+ * const canTrust = identity.meetsThreshold(70);
+ * ```
+ */
+import { DIDResolver } from './did-resolver';
+import { AgentCard } from './agent-card';
+import { Reputation } from './reputation';
+import { OwnerRegistry } from './owner-registry';
+import { AgentDID, AgentIdentityOptions, AgentCardData, DIDDocument, ReputationProfile, OwnerRecord, CreateAttestationOptions, ReputationAttestation, ResolvedIdentity, ResolveOptions, DelegationLevel } from './types';
+export declare class AgentIdentity {
+    /** The agent's DID. */
+    readonly did: AgentDID;
+    /** The agent's DID Document. */
+    readonly didDocument: DIDDocument;
+    /** The agent's card (capabilities, metadata). */
+    readonly card: AgentCard;
+    /** Shared modules (can be used across multiple agents). */
+    readonly didResolver: DIDResolver;
+    readonly reputation: Reputation;
+    readonly ownerRegistry: OwnerRegistry;
+    private log;
+    constructor(options: AgentIdentityOptions);
+    /**
+     * Get the agent's DID string.
+     */
+    getDID(): AgentDID;
+    /**
+     * Get the agent's card data.
+     */
+    getCard(): Readonly<AgentCardData>;
+    /**
+     * Check if this agent has a specific capability.
+     */
+    hasCapability(capability: string): boolean;
+    /**
+     * Get this agent's reputation score (0-100).
+     */
+    getReputationScore(): number;
+    /**
+     * Get this agent's full reputation profile.
+     */
+    getReputationProfile(): ReputationProfile;
+    /**
+     * Check if this agent meets a minimum trust threshold.
+     */
+    meetsThreshold(minScore: number): boolean;
+    /**
+     * Create a reputation attestation for ANOTHER agent.
+     */
+    attestAgent(options: CreateAttestationOptions): ReputationAttestation;
+    /**
+     * Get this agent's owner.
+     */
+    getOwner(): OwnerRecord | null;
+    /**
+     * Get this agent's delegation level.
+     */
+    getDelegationLevel(): DelegationLevel | null;
+    /**
+     * Check if this agent can transact (not readonly).
+     */
+    canTransact(): boolean;
+    /**
+     * Resolve another agent's identity by DID.
+     */
+    resolveAgent(agentDid: AgentDID, options?: ResolveOptions): ResolvedIdentity | null;
+    /**
+     * Export the full identity as a portable JSON object.
+     */
+    toJSON(): {
+        did: `did:asg:agent:${string}`;
+        didDocument: DIDDocument;
+        card: AgentCardData & {
+            createdAt: string;
+            updatedAt: string;
+        };
+        reputation: ReputationProfile;
+        ownership: OwnerRecord | null;
+    };
+}
+//# sourceMappingURL=agent-identity.d.ts.map

package/dist/types/identity/agent-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.d.ts","sourceRoot":"","sources":["../../../src/identity/agent-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,aAAa;IACxB,uBAAuB;IACvB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAwB;gBAEvB,OAAO,EAAE,oBAAoB;IAkCzC;;OAEG;IACH,MAAM,IAAI,QAAQ;IAIlB;;OAEG;IACH,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC;IAIlC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAM1C;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;IAIzC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,qBAAqB;IAUrE;;OAEG;IACH,QAAQ,IAAI,WAAW,GAAG,IAAI;IAI9B;;OAEG;IACH,kBAAkB,IAAI,eAAe,GAAG,IAAI;IAI5C;;OAEG;IACH,WAAW,IAAI,OAAO;IAMtB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI;IAyBnF;;OAEG;IACH,MAAM;;;;;;;;;;CASP"}

package/dist/types/identity/did-resolver.d.ts

@@ -0,0 +1,70 @@
+/**
+ * DIDResolver — W3C Decentralized Identifier resolution for envoy agents.
+ *
+ * Implements a custom DID method `did:asg:agent:<chain>:<address>` that
+ * resolves to a DID Document containing the agent's public keys,
+ * service endpoints, and ownership information.
+ *
+ * Format: did:asg:agent:<caip2-chain>:<address>
+ * @example "did:asg:agent:eip155:8453:0x1234abcd..."
+ * @example "did:asg:agent:stellar:pubnet:GABC..."
+ * @example "did:asg:agent:solana:mainnet:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp..."
+ *
+ * @see https://www.w3.org/TR/did-core/
+ * @see ERC-8004 — Identity Registry
+ */
+import { AgentDID, DIDDocument, ServiceEndpoint, AgentCardData } from './types';
+/**
+ * Parse a DID string into its components.
+ */
+interface ParsedDID {
+    method: string;
+    submethod: string;
+    chain: string;
+    address: string;
+}
+export declare class DIDResolver {
+    /** In-memory registry (production: on-chain or IPFS). */
+    private registry;
+    /**
+     * Create a DID for an agent.
+     *
+     * @param address - The agent's primary address
+     * @param chainId - CAIP-2 chain identifier
+     * @param card - Agent card metadata
+     * @returns The generated DID and DID Document
+     */
+    create(address: string, chainId: string, card: AgentCardData): {
+        did: AgentDID;
+        document: DIDDocument;
+    };
+    /**
+     * Resolve a DID to its DID Document.
+     */
+    resolve(did: AgentDID): DIDDocument | null;
+    /**
+     * Parse a DID string into its components.
+     */
+    parse(did: string): ParsedDID | null;
+    /**
+     * Validate that a DID string is well-formed.
+     */
+    validate(did: string): boolean;
+    /**
+     * Update a DID Document's service endpoints.
+     */
+    updateServices(did: AgentDID, services: ServiceEndpoint[]): boolean;
+    /**
+     * Deactivate (delete) a DID Document.
+     */
+    deactivate(did: AgentDID): boolean;
+    /**
+     * List all registered DIDs.
+     */
+    listAll(): AgentDID[];
+    private buildDID;
+    private getKeyType;
+    private addressToMultibase;
+}
+export {};
+//# sourceMappingURL=did-resolver.d.ts.map

package/dist/types/identity/did-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-resolver.d.ts","sourceRoot":"","sources":["../../../src/identity/did-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,QAAQ,EACR,WAAW,EAEX,eAAe,EACf,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACtB,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;;;;OAOG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,aAAa,GAClB;QAAE,GAAG,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAA;KAAE;IAiD3C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;IAI1C;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAoBpC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAY9B;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO;IASnE;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO;IAIlC;;OAEG;IACH,OAAO,IAAI,QAAQ,EAAE;IAMrB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,kBAAkB;CAI3B"}

package/dist/types/identity/erc8004/abis.d.ts

@@ -0,0 +1,336 @@
+/**
+ * Minimal ABI fragments for the canonical ERC-8004 contracts on Celo.
+ *
+ * Sourced from the upstream Solidity at:
+ *   https://github.com/erc-8004/erc-8004-contracts/blob/main/contracts/
+ *
+ * We deliberately do NOT vendor the full ABI — only the function and event
+ * signatures the SDK touches. If you need a method that's not here, add it
+ * (it's an additive change) rather than swapping in the full upstream ABI.
+ *
+ * Marked `as const` so viem can infer return types from the ABI shape.
+ */
+export declare const ERC8004_IDENTITY_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "register";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "register";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "register";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentURI";
+        readonly type: "string";
+    }, {
+        readonly name: "metadata";
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly name: "metadataKey";
+            readonly type: "string";
+        }, {
+            readonly name: "metadataValue";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "setAgentURI";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "newURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setMetadata";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "metadataKey";
+        readonly type: "string";
+    }, {
+        readonly name: "metadataValue";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setAgentWallet";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "newWallet";
+        readonly type: "address";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "unsetAgentWallet";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "getAgentWallet";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getMetadata";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "metadataKey";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "isAuthorizedOrOwner";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "ownerOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "tokenURI";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Registered";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "agentURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "URIUpdated";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "newURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "updatedBy";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "MetadataSet";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "indexedMetadataKey";
+        readonly type: "string";
+        readonly indexed: true;
+    }, {
+        readonly name: "metadataKey";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "metadataValue";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }];
+}];
+export declare const ERC8004_REPUTATION_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "giveFeedback";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "value";
+        readonly type: "int128";
+    }, {
+        readonly name: "valueDecimals";
+        readonly type: "uint8";
+    }, {
+        readonly name: "tag1";
+        readonly type: "string";
+    }, {
+        readonly name: "tag2";
+        readonly type: "string";
+    }, {
+        readonly name: "endpoint";
+        readonly type: "string";
+    }, {
+        readonly name: "feedbackURI";
+        readonly type: "string";
+    }, {
+        readonly name: "feedbackHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "revokeFeedback";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "feedbackIndex";
+        readonly type: "uint64";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "NewFeedback";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "clientAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "feedbackIndex";
+        readonly type: "uint64";
+        readonly indexed: false;
+    }, {
+        readonly name: "value";
+        readonly type: "int128";
+        readonly indexed: false;
+    }, {
+        readonly name: "valueDecimals";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }, {
+        readonly name: "indexedTag1";
+        readonly type: "string";
+        readonly indexed: true;
+    }, {
+        readonly name: "tag1";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "tag2";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "endpoint";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "feedbackURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "feedbackHash";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "FeedbackRevoked";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "clientAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "feedbackIndex";
+        readonly type: "uint64";
+        readonly indexed: true;
+    }];
+}];
+//# sourceMappingURL=abis.d.ts.map

package/dist/types/identity/erc8004/abis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../../../../src/identity/erc8004/abis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiJvB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDzB,CAAC"}

package/dist/types/identity/erc8004/identity.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Helpers around the canonical Celo ERC-8004 Identity Registry.
+ *
+ * The Identity Registry is the source of truth for who an agent is:
+ *
+ *   - Registration mints an ERC-721 NFT to `msg.sender`. The tokenId is the
+ *     agentId we use everywhere else.
+ *   - `getAgentWallet(agentId)` returns the address authorized to *sign on the
+ *     agent's behalf* — separate from `ownerOf(agentId)` which holds the NFT.
+ *   - On NFT transfer the canonical contract clears `agentWallet`, so the new
+ *     holder must re-register their signing wallet (via `setAgentWallet`).
+ *
+ * All helpers take a viem `Client` and the canonical Identity Registry
+ * `address` for the chain you're targeting. Pull the address from
+ * `getEnvoyAddresses(chainId).identityRegistry`.
+ */
+import { type Address, type Hash, type Hex, type PublicClient, type WalletClient, encodePacked, hexToBytes } from 'viem';
+import type { AgentId, CanonicalAgent, MetadataEntry } from './types';
+export interface RegisterAgentArgs {
+    /** Optional URI of the agent card JSON (name, capabilities, endpoints, ...). */
+    agentURI?: string;
+    /** Optional additional key/value metadata. Reserved key `"agentWallet"` is rejected on-chain. */
+    metadata?: MetadataEntry[];
+}
+/**
+ * Register a new agent on the canonical Identity Registry. The caller's address
+ * becomes the NFT owner AND the initial `agentWallet`. Returns the minted
+ * `agentId` (parsed from the `Registered` event in the receipt).
+ *
+ * Three overloads are exposed on the contract; this helper picks the one whose
+ * input shape matches the arguments you pass (no URI / URI only / URI + metadata).
+ */
+export declare function registerAgent(walletClient: WalletClient, publicClient: PublicClient, registryAddress: Address, args?: RegisterAgentArgs): Promise<{
+    agentId: AgentId;
+    txHash: Hash;
+}>;
+/**
+ * Rotate the agent's operational signing wallet. The new wallet (or its owner, in
+ * the ERC-1271 case) must produce a signature over the EIP-712 `AgentWalletSet`
+ * struct: `(uint256 agentId, address newWallet, address owner, uint256 deadline)`.
+ *
+ * The canonical contract verifies both ECDSA (EOA / 7702) and ERC-1271 paths.
+ * Build the signature off-chain with `signAgentWalletRotation` below.
+ */
+export declare function setAgentWallet(walletClient: WalletClient, registryAddress: Address, args: {
+    agentId: AgentId;
+    newWallet: Address;
+    deadline: bigint;
+    signature: Hex;
+}): Promise<Hash>;
+/** Clear the agent's operational signing wallet. Effectively pauses on-chain payments. */
+export declare function unsetAgentWallet(walletClient: WalletClient, registryAddress: Address, agentId: AgentId): Promise<Hash>;
+/** Update the agent's URI (e.g. when the agent card moves IPFS gateways). */
+export declare function setAgentURI(walletClient: WalletClient, registryAddress: Address, agentId: AgentId, newURI: string): Promise<Hash>;
+/** Set a single metadata key/value pair. Reserved key `"agentWallet"` is rejected on-chain. */
+export declare function setMetadata(walletClient: WalletClient, registryAddress: Address, agentId: AgentId, key: string, value: Hex): Promise<Hash>;
+export declare function getAgentWallet(publicClient: PublicClient, registryAddress: Address, agentId: AgentId): Promise<Address>;
+export declare function getAgentOwner(publicClient: PublicClient, registryAddress: Address, agentId: AgentId): Promise<Address>;
+export declare function getAgentURI(publicClient: PublicClient, registryAddress: Address, agentId: AgentId): Promise<string>;
+export declare function getMetadata(publicClient: PublicClient, registryAddress: Address, agentId: AgentId, key: string): Promise<Hex>;
+export declare function isAuthorizedOrOwner(publicClient: PublicClient, registryAddress: Address, spender: Address, agentId: AgentId): Promise<boolean>;
+/** Aggregate read — one round-trip per field. Convenience wrapper. */
+export declare function getAgent(publicClient: PublicClient, registryAddress: Address, agentId: AgentId): Promise<CanonicalAgent>;
+/**
+ * EIP-712 typed-data payload the new wallet must sign before `setAgentWallet`
+ * can be called. The canonical contract's domain is
+ * `EIP712Domain("ERC8004IdentityRegistry","1",chainId,verifyingContract)`.
+ *
+ * Pass the result to `walletClient.signTypedData(...)` from the *new* wallet (or
+ * its ERC-1271 owner), then pass the signature into `setAgentWallet`.
+ */
+export declare function agentWalletRotationTypedData(args: {
+    chainId: number;
+    registryAddress: Address;
+    agentId: AgentId;
+    newWallet: Address;
+    /** Current ERC-721 owner of the agent NFT. */
+    owner: Address;
+    deadline: bigint;
+}): {
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+    types: {
+        AgentWalletSet: {
+            name: string;
+            type: string;
+        }[];
+    };
+    primaryType: "AgentWalletSet";
+    message: {
+        agentId: bigint;
+        newWallet: `0x${string}`;
+        owner: `0x${string}`;
+        deadline: bigint;
+    };
+};
+/** Encode a UTF-8 string as a metadata value. Use for `setMetadata(...)`. */
+export declare const encodeStringMetadata: (s: string) => Hex;
+/** Encode raw bytes as a metadata value. */
+export declare const encodeBytesMetadata: (b: Uint8Array) => Hex;
+/** Compute the keccak256 hash an agent card URI's contents would have. Useful for `feedbackHash` etc. */
+export declare function contentHash(bytes: Uint8Array): Hex;
+/** Re-export viem encoder so callers don't have to import viem directly for trivial work. */
+export { encodePacked, hexToBytes };
+//# sourceMappingURL=identity.d.ts.map

package/dist/types/identity/erc8004/identity.d.ts.map

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

package/dist/types/identity/erc8004/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Canonical Celo ERC-8004 helpers — Identity + Reputation registries.
+ *
+ * These wrap the read/write surface envoy needs from the canonical contracts
+ * deployed on Celo (mainnet + Sepolia). All helpers are pure functions taking
+ * a viem client; no global state, no hidden singletons.
+ *
+ * Pull the registry addresses from `getEnvoyAddresses(chainId)`.
+ */
+export { registerAgent, setAgentWallet, unsetAgentWallet, setAgentURI, setMetadata, getAgentWallet, getAgentOwner, getAgentURI, getMetadata, isAuthorizedOrOwner, getAgent, agentWalletRotationTypedData, encodeStringMetadata, encodeBytesMetadata, contentHash, } from './identity';
+export type { RegisterAgentArgs } from './identity';
+export { giveFeedback, revokeFeedback, makeScoreFeedback } from './reputation';
+export { ERC8004_IDENTITY_ABI, ERC8004_REPUTATION_ABI } from './abis';
+export type { AgentId, CanonicalAgent, MetadataEntry, FeedbackArgs } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/identity/erc8004/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/identity/erc8004/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,QAAQ,EACR,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE/E,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AACtE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}