envoy-pay 0.1.0

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

@@ -0,0 +1,52 @@
+/**
+ * Helpers around the canonical Celo ERC-8004 Reputation Registry.
+ *
+ * Each `giveFeedback` call attaches a signed value (with explicit decimals),
+ * two free-form tags, an endpoint string, and an optional URI+hash of a richer
+ * feedback document. The canonical contract:
+ *
+ *   - REJECTS self-feedback (where `msg.sender` is the agent's owner or an
+ *     approved operator) — see the source's `isAuthorizedOrOwner` check.
+ *   - Indexes feedback by `(agentId, clientAddress, feedbackIndex)`. The index
+ *     is 1-based per client; the first call returns 1, the second returns 2, etc.
+ *
+ * 8004scan reads these contracts directly, so any feedback attributed to your
+ * agentId here counts toward the Celo hackathon's Track 3 rank.
+ */
+import { type Address, type Hash, type Hex, type PublicClient, type WalletClient } from 'viem';
+import type { AgentId, FeedbackArgs } from './types';
+/**
+ * Submit feedback on an agent. Returns the `feedbackIndex` (1-based per caller)
+ * parsed from the `NewFeedback` event in the receipt.
+ *
+ * The caller (`walletClient.account.address`) must NOT be authorized for the
+ * agent — i.e. an agent cannot rate itself. The contract reverts with
+ * "Self-feedback not allowed" if you try.
+ */
+export declare function giveFeedback(walletClient: WalletClient, publicClient: PublicClient, registryAddress: Address, args: FeedbackArgs): Promise<{
+    feedbackIndex: bigint;
+    txHash: Hash;
+}>;
+/**
+ * Revoke a previously-submitted feedback. Only the original `clientAddress`
+ * (i.e. the same wallet that called `giveFeedback`) can revoke.
+ */
+export declare function revokeFeedback(walletClient: WalletClient, registryAddress: Address, agentId: AgentId, feedbackIndex: bigint): Promise<Hash>;
+/**
+ * Build a `FeedbackArgs` object with the most common shape:
+ *   - a percentage-style score in [0, 100] with one decimal,
+ *   - two tags (category, sub-category),
+ *   - an endpoint string for which deployment the feedback applies to.
+ *
+ * `value=850, valueDecimals=1` means "85.0 / 100".
+ */
+export declare function makeScoreFeedback(args: {
+    agentId: AgentId;
+    scoreOutOf100: number;
+    tag1: string;
+    tag2: string;
+    endpoint: string;
+    feedbackURI?: string;
+    feedbackHash?: Hex;
+}): FeedbackArgs;
+//# sourceMappingURL=reputation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.d.ts","sourceRoot":"","sources":["../../../../src/identity/erc8004/reputation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,GAAG,EACR,KAAK,YAAY,EACjB,KAAK,YAAY,EAGlB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC,CAuClD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB,GAAG,YAAY,CAYf"}

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

@@ -0,0 +1,31 @@
+import type { Address, Hex } from 'viem';
+/** ERC-8004 agent identifier. Equals the NFT tokenId on the canonical Identity Registry. */
+export type AgentId = bigint;
+/** A single metadata entry stored on the canonical Identity Registry, addressable by key. */
+export interface MetadataEntry {
+    key: string;
+    value: Hex;
+}
+/** Aggregated read of an agent's canonical record. */
+export interface CanonicalAgent {
+    agentId: AgentId;
+    owner: Address;
+    agentWallet: Address;
+    tokenURI: string;
+}
+/** Arguments for `giveFeedback` on the canonical Reputation Registry. */
+export interface FeedbackArgs {
+    agentId: AgentId;
+    /** Signed value, encoded with `valueDecimals` decimals (e.g. 4500 with decimals=2 → 45.00). */
+    value: bigint;
+    valueDecimals: number;
+    tag1: string;
+    tag2: string;
+    /** Origin / endpoint the agent was used through, free-form. */
+    endpoint: string;
+    /** URI to a richer feedback document (IPFS, https, data:). */
+    feedbackURI: string;
+    /** Optional integrity hash of the feedback URI's contents. */
+    feedbackHash: Hex;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/identity/erc8004/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC,4FAA4F;AAC5F,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,6FAA6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;CACZ;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,YAAY,EAAE,GAAG,CAAC;CACnB"}

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

@@ -0,0 +1,10 @@
+export { AgentIdentity } from './agent-identity';
+export { DIDResolver } from './did-resolver';
+export { AgentCard } from './agent-card';
+export { Reputation } from './reputation';
+export { OwnerRegistry } from './owner-registry';
+export type { AgentDID, DIDDocument, VerificationMethod, ServiceEndpoint, AgentCardData, AgentIdentityOptions, ReputationAttestation, ReputationCategory, ReputationProfile, CreateAttestationOptions, OwnerRecord, DelegationLevel, ResolvedIdentity, ResolveOptions, } from './types';
+export * as erc8004 from './erc8004';
+export type { AgentId, CanonicalAgent, MetadataEntry, FeedbackArgs } from './erc8004';
+export { agentWalletRotationTypedData } from './erc8004/identity';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/identity/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,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,YAAY,EACV,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAKtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types/identity/owner-registry.d.ts

@@ -0,0 +1,68 @@
+/**
+ * OwnerRegistry — Agent ↔ Owner binding with delegation levels.
+ *
+ * Implements the Validation Registry concept from ERC-8004,
+ * linking AI agents to their human/organizational owners with
+ * configurable delegation levels.
+ *
+ * Delegation levels:
+ * - `full`        — Agent has full autonomy
+ * - `supervised`  — Owner receives notifications
+ * - `restricted`  — Owner must approve large transactions
+ * - `readonly`    — Agent can only read, not transact
+ *
+ * @see ERC-8004 — Validation Registry
+ */
+import { AgentDID, DelegationLevel, OwnerRecord } from './types';
+export declare class OwnerRegistry {
+    /** In-memory registry (production: on-chain smart contract). */
+    private records;
+    /** Reverse index: owner → agents. */
+    private ownerIndex;
+    /**
+     * Register an agent-owner binding.
+     */
+    register(agentDid: AgentDID, ownerAddress: string, delegationLevel?: DelegationLevel, metadata?: Record<string, string>): OwnerRecord;
+    /**
+     * Get the owner record for an agent.
+     */
+    getOwner(agentDid: AgentDID): OwnerRecord | null;
+    /**
+     * Get all agents owned by a specific address.
+     */
+    getAgentsByOwner(ownerAddress: string): OwnerRecord[];
+    /**
+     * Check if an address owns a specific agent.
+     */
+    isOwner(agentDid: AgentDID, ownerAddress: string): boolean;
+    /**
+     * Get the delegation level for an agent.
+     */
+    getDelegationLevel(agentDid: AgentDID): DelegationLevel | null;
+    /**
+     * Update the delegation level for an agent.
+     * Only the current owner can do this (enforcement is caller's responsibility).
+     */
+    setDelegationLevel(agentDid: AgentDID, level: DelegationLevel): boolean;
+    /**
+     * Transfer ownership of an agent to a new address.
+     */
+    transferOwnership(agentDid: AgentDID, newOwnerAddress: string): boolean;
+    /**
+     * Remove an agent from the registry.
+     */
+    unregister(agentDid: AgentDID): boolean;
+    /**
+     * Check if an agent is allowed to perform an action based on delegation.
+     */
+    canTransact(agentDid: AgentDID): boolean;
+    /**
+     * Check if an action requires owner approval.
+     */
+    requiresApproval(agentDid: AgentDID): boolean;
+    /**
+     * Get the total number of registered agents.
+     */
+    getAgentCount(): number;
+}
+//# sourceMappingURL=owner-registry.d.ts.map

package/dist/types/identity/owner-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-registry.d.ts","sourceRoot":"","sources":["../../../src/identity/owner-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEjE,qBAAa,aAAa;IACxB,gEAAgE;IAChE,OAAO,CAAC,OAAO,CAAuC;IACtD,qCAAqC;IACrC,OAAO,CAAC,UAAU,CAAuC;IAEzD;;OAEG;IACH,QAAQ,CACN,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,EACpB,eAAe,GAAE,eAA8B,EAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,WAAW;IAwBd;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;IAIhD;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,EAAE;IASrD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAK1D;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,GAAG,IAAI;IAK9D;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO;IAQvE;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;IAoBvE;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IASvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAKxC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAK7C;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}

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

@@ -0,0 +1,66 @@
+/**
+ * Reputation — EAS-compatible reputation scoring for AI agents.
+ *
+ * Implements the Reputation Registry concept from ERC-8004, using
+ * an EAS-compatible schema for creating, storing, and querying
+ * reputation attestations.
+ *
+ * Features:
+ * - Create/revoke attestations
+ * - Aggregate scores by category
+ * - Compute overall trust score
+ * - Track payment reliability, task quality, uptime, etc.
+ *
+ * @see ERC-8004 — Reputation Registry
+ * @see https://attest.org — Ethereum Attestation Service
+ */
+import { ReputationAttestation, ReputationProfile, CreateAttestationOptions, AgentDID } from './types';
+export declare class Reputation {
+    /** In-memory attestation store (production: EAS on-chain or IPFS). */
+    private attestations;
+    /**
+     * Create a reputation attestation for an agent.
+     *
+     * @param attesterAddress - Who is creating the attestation
+     * @param options - Attestation details
+     * @returns The created attestation
+     */
+    attest(attesterAddress: string, options: CreateAttestationOptions): ReputationAttestation;
+    /**
+     * Revoke an attestation by ID.
+     */
+    revoke(subject: string, attestationId: string): boolean;
+    /**
+     * Get the full reputation profile for an agent.
+     */
+    getProfile(agentDid: AgentDID): ReputationProfile;
+    /**
+     * Get the overall score for an agent (0-100).
+     */
+    getScore(agentDid: AgentDID): number;
+    /**
+     * Check if an agent meets a minimum trust threshold.
+     */
+    meetsThreshold(agentDid: AgentDID, minScore: number): boolean;
+    /**
+     * Get all valid (non-expired, non-revoked) attestations for an agent.
+     */
+    getValidAttestations(subject: string): ReputationAttestation[];
+    /**
+     * Get all attestations (including invalid) for an agent.
+     */
+    getAllAttestations(subject: string): ReputationAttestation[];
+    /**
+     * Get the attestation count for an agent.
+     */
+    getAttestationCount(subject: string): number;
+    /**
+     * Calculate average scores per category.
+     */
+    private calculateCategoryScores;
+    /**
+     * Calculate weighted overall score from category scores.
+     */
+    private calculateOverallScore;
+}
+//# sourceMappingURL=reputation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.d.ts","sourceRoot":"","sources":["../../../src/identity/reputation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAEjB,wBAAwB,EACxB,QAAQ,EACT,MAAM,SAAS,CAAC;AAuBjB,qBAAa,UAAU;IACrB,sEAAsE;IACtE,OAAO,CAAC,YAAY,CAAmD;IAEvE;;;;;;OAMG;IACH,MAAM,CACJ,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,wBAAwB,GAChC,qBAAqB;IA0BxB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;IAWvD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB;IAwCjD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAIpC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7D;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAW9D;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAI5D;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAM5C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAe9B"}

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

@@ -0,0 +1,182 @@
+/**
+ * Identity Layer Types — Agent identity, reputation, and ownership.
+ *
+ * Implements concepts from:
+ * - ERC-8004 "Trustless Agents" (Identity + Reputation + Validation registries)
+ * - W3C DID (Decentralized Identifiers)
+ * - EAS (Ethereum Attestation Service)
+ * - Stellar Protocol 25 (ZK-KYC selective disclosure)
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-8004
+ * @see https://www.w3.org/TR/did-core/
+ * @see https://attest.org
+ */
+/**
+ * envoy DID format: did:asg:agent:<chain>:<address>
+ * @example "did:asg:agent:eip155:8453:0x1234..."
+ * @example "did:asg:agent:stellar:pubnet:GABC..."
+ */
+export type AgentDID = `did:asg:agent:${string}`;
+/** W3C DID Document — simplified for agent use. */
+export interface DIDDocument {
+    /** The DID subject. */
+    id: AgentDID;
+    /** DID controller (owner). */
+    controller: string;
+    /** Verification methods (public keys). */
+    verificationMethod: VerificationMethod[];
+    /** Service endpoints (A2A, MCP, etc.). */
+    service: ServiceEndpoint[];
+    /** When the document was created. */
+    created: Date;
+    /** When the document was last updated. */
+    updated: Date;
+}
+export interface VerificationMethod {
+    id: string;
+    type: 'Ed25519VerificationKey2020' | 'EcdsaSecp256k1VerificationKey2019' | 'JsonWebKey2020';
+    controller: string;
+    /** Public key in multibase encoding. */
+    publicKeyMultibase?: string;
+}
+export interface ServiceEndpoint {
+    id: string;
+    type: 'AgentService' | 'A2AEndpoint' | 'MCPEndpoint' | 'PaymentEndpoint';
+    serviceEndpoint: string;
+}
+/**
+ * AgentCard — On-chain identity metadata for an AI agent.
+ * Implements the Identity Registry concept from ERC-8004.
+ */
+export interface AgentCardData {
+    /** Agent's human-readable name. */
+    name: string;
+    /** Semantic version. */
+    version: string;
+    /** Short description. */
+    description?: string;
+    /** Capabilities this agent offers. */
+    capabilities: string[];
+    /** Owner/controller address. */
+    owner: string;
+    /** Service endpoints. */
+    endpoints?: {
+        a2a?: string;
+        mcp?: string;
+        payment?: string;
+        webhook?: string;
+    };
+    /** Chain addresses this agent controls. */
+    addresses?: Array<{
+        chain: string;
+        caip2Id: string;
+        address: string;
+    }>;
+    /** Agent icon URL. */
+    iconUrl?: string;
+    /** Agent categories/tags. */
+    tags?: string[];
+}
+/** A single reputation attestation. */
+export interface ReputationAttestation {
+    /** Unique attestation ID. */
+    id: string;
+    /** Who attested (address). */
+    attester: string;
+    /** The agent being attested (DID or address). */
+    subject: string;
+    /** Score (0-100). */
+    score: number;
+    /** Category of the attestation. */
+    category: ReputationCategory;
+    /** Optional textual feedback. */
+    comment?: string;
+    /** Transaction hash of the attestation (if on-chain). */
+    transactionHash?: string;
+    /** When the attestation was created. */
+    timestamp: Date;
+    /** When the attestation expires (if applicable). */
+    expiresAt?: Date;
+    /** Is this attestation still valid? */
+    isValid: boolean;
+}
+/** Categories for reputation scoring. */
+export type ReputationCategory = 'payment-reliability' | 'task-quality' | 'response-time' | 'uptime' | 'security' | 'general';
+/** Aggregated reputation profile. */
+export interface ReputationProfile {
+    /** Agent DID. */
+    agentDid: AgentDID;
+    /** Overall score (0-100). */
+    overallScore: number;
+    /** Number of attestations received. */
+    totalAttestations: number;
+    /** Success rate (0-1). */
+    successRate: number;
+    /** Total transactions processed. */
+    totalTransactions: number;
+    /** Score breakdown by category. */
+    categoryScores: Partial<Record<ReputationCategory, number>>;
+    /** Recent attestations (last N). */
+    recentAttestations: ReputationAttestation[];
+    /** When this profile was last updated. */
+    lastUpdated: Date;
+}
+/** Ownership record linking an agent to its owner. */
+export interface OwnerRecord {
+    /** Agent DID. */
+    agentDid: AgentDID;
+    /** Owner address. */
+    ownerAddress: string;
+    /** When ownership was established. */
+    since: Date;
+    /** Delegation level. */
+    delegationLevel: DelegationLevel;
+    /** Additional metadata. */
+    metadata?: Record<string, string>;
+}
+/** How much authority the agent has. */
+export type DelegationLevel = 'full' | 'supervised' | 'restricted' | 'readonly';
+/** Options for creating a new attestation. */
+export interface CreateAttestationOptions {
+    /** Agent being attested. */
+    subject: string;
+    /** Score (0-100). */
+    score: number;
+    /** Category. */
+    category: ReputationCategory;
+    /** Optional comment. */
+    comment?: string;
+    /** How long the attestation is valid (ms). */
+    validFor?: number;
+}
+/** Options for resolving an agent identity. */
+export interface ResolveOptions {
+    /** Include reputation profile? Default: true */
+    includeReputation?: boolean;
+    /** Include ownership info? Default: true */
+    includeOwnership?: boolean;
+    /** Maximum attestations to fetch. Default: 10 */
+    maxAttestations?: number;
+}
+/** Full resolved agent identity. */
+export interface ResolvedIdentity {
+    /** DID Document. */
+    did: DIDDocument;
+    /** Agent Card metadata. */
+    card: AgentCardData;
+    /** Reputation profile (if requested). */
+    reputation?: ReputationProfile;
+    /** Ownership info (if requested). */
+    ownership?: OwnerRecord;
+}
+export interface AgentIdentityOptions {
+    /** Agent card metadata. */
+    metadata: AgentCardData;
+    /** Signing address (from wallet or adapter). */
+    signerAddress: string;
+    /** CAIP-2 chain ID of the signer. */
+    signerChainId: string;
+    /** Optional logger. */
+    logger?: (msg: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+export { EnvoyClient, EnvoyClientOptions } from './client';
+export { PolicyEngine, BudgetPolicy } from './policy';
+export type { Logger } from './logger';
+export { parseMppChallenge, parseMppChallenges, decodeChallengeRequest, buildMppCredential, buildAuthorizationHeader, parseMppReceipt, detectProtocol, extractMppChallenges, base64urlEncode, base64urlDecode, } from './mpp';
+export type { MppChallenge, MppCredential, MppRequestObject, MppStripePayload, MppTempoPayload, MppReceipt, MppMethod, MppIntent, } from './mpp';
+export { EvmPaymentAdapter, listEvmChains } from './adapters/evm';
+export type { EvmAdapterOptions, EvmChainName } from './adapters/evm';
+export type { PaymentAdapter, WatchOptions, IncomingPayment, PaymentRequestOptions, PaymentRequest, Unsubscribe, } from './adapters/types';
+export { createEvmWatcher } from './monitor/evm-watcher';
+export type { EvmWatcherConfig } from './monitor/evm-watcher';
+export { buildEip681Uri } from './requests/eip681';
+export type { Eip681Options } from './requests/eip681';
+export { AgentIdentity, DIDResolver, AgentCard, Reputation, OwnerRegistry, erc8004, } from './identity';
+export type { AgentDID, DIDDocument, VerificationMethod, ServiceEndpoint, AgentCardData, AgentIdentityOptions, ReputationAttestation, ReputationCategory, ReputationProfile, CreateAttestationOptions, OwnerRecord, DelegationLevel, ResolvedIdentity, ResolveOptions, AgentId, CanonicalAgent, MetadataEntry, FeedbackArgs, } from './identity';
+export { ENVOY_CONTRACT_ADDRESSES, getEnvoyAddresses, CELO_MAINNET, CELO_SEPOLIA, createEnvoyFacilitator, signPaymentAuth, paymentAuthDomain, paymentAuthTypedData, PAYMENT_AUTH_TYPES, ENVOY_FACILITATOR_ABI, } from './contracts';
+export type { EnvoyContractAddresses, PaymentAuth, LimitView, SettledEvent, EnvoyFacilitatorClient, EnvoyFacilitatorClientOptions, } from './contracts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,OAAO,CAAC;AACf,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGtE,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EACL,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,sBAAsB,EACtB,WAAW,EACX,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,aAAa,CAAC"}

package/dist/types/logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Logger type for envoy-pay SDK.
+ *
+ * Pass `console.log` for verbose output, or provide a custom logger.
+ * If omitted, the SDK is silent — no stdout pollution.
+ */
+export type Logger = (message: string, ...args: any[]) => void;
+/** No-op logger — used when no logger is provided. */
+export declare const noopLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/types/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAE/D,sDAAsD;AACtD,eAAO,MAAM,UAAU,EAAE,MAAiB,CAAC"}

package/dist/types/monitor/evm-watcher.d.ts

@@ -0,0 +1,40 @@
+import type { IncomingPayment, Unsubscribe } from '../adapters/types';
+import { Logger } from '../logger';
+/**
+ * EVM Watcher — monitors incoming ERC-20 (USDC) and native ETH transfers.
+ *
+ * Uses polling-based approach compatible with any JSON-RPC provider.
+ * For WebSocket-capable providers, set `pollIntervalMs` to 0 and provide
+ * a WebSocket URL to enable real-time event subscription.
+ */
+export interface EvmWatcherConfig {
+    /** Wallet address to monitor for incoming payments. */
+    address: string;
+    /** JSON-RPC URL for the EVM chain. */
+    rpcUrl: string;
+    /** CAIP-2 chain identifier (e.g., 'eip155:8453'). */
+    chainId?: string;
+    /** Human-readable chain name. Default: 'EVM'. */
+    chainName?: string;
+    /** USDC contract address on this chain. If omitted, only native ETH transfers are watched. */
+    usdcContractAddress?: string;
+    /** Poll interval in milliseconds. Default: 12000 (one block on Base). */
+    pollIntervalMs?: number;
+    /** Callback for detected incoming payments. */
+    onPayment: (event: IncomingPayment) => void;
+    /** Callback for errors. */
+    onError?: (error: Error) => void;
+    /** Logger function. */
+    logger?: Logger;
+}
+/**
+ * Creates an EVM payment watcher using JSON-RPC polling.
+ *
+ * Monitors:
+ * 1. ERC-20 Transfer events TO the target address (USDC)
+ * 2. Native ETH transfers TO the target address (via block scanning)
+ *
+ * @returns Unsubscribe function to stop watching.
+ */
+export declare function createEvmWatcher(config: EvmWatcherConfig): Unsubscribe;
+//# sourceMappingURL=evm-watcher.d.ts.map

package/dist/types/monitor/evm-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-watcher.d.ts","sourceRoot":"","sources":["../../../src/monitor/evm-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CA0JtE"}

package/dist/types/monitor/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * envoy — Real-Time Payment Monitoring
+ *
+ * Chain-specific watchers that detect incoming payments
+ * and invoke callbacks in real-time.
+ *
+ * @example
+ * ```ts
+ * import { createEvmWatcher, createStellarWatcher } from 'envoy-pay/monitor';
+ *
+ * const unsub = createEvmWatcher({
+ *   address: '0xYOUR_WALLET',
+ *   rpcUrl: 'https://mainnet.base.org',
+ *   onPayment: (event) => console.log('Received:', event),
+ * });
+ *
+ * // Stop watching
+ * unsub();
+ * ```
+ */
+export { createEvmWatcher, type EvmWatcherConfig } from './evm-watcher';
+export { createStellarWatcher, type StellarWatcherConfig } from './stellar-watcher';
+export { createSolanaWatcher, type SolanaWatcherConfig } from './solana-watcher';
+export { createMultiChainWatcher, type MultiChainWatcherConfig } from './multi-watcher';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/monitor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/monitor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/monitor/multi-watcher.d.ts

@@ -0,0 +1,48 @@
+import type { IncomingPayment, Unsubscribe } from '../adapters/types';
+import { type EvmWatcherConfig } from './evm-watcher';
+import { type StellarWatcherConfig } from './stellar-watcher';
+import { type SolanaWatcherConfig } from './solana-watcher';
+import { Logger } from '../logger';
+/**
+ * Multi-Chain Watcher — monitors multiple chains simultaneously.
+ *
+ * Aggregates incoming payment events from all configured chains
+ * into a single callback, enabling unified cross-chain monitoring.
+ */
+export interface MultiChainWatcherConfig {
+    /** EVM chain configurations. */
+    evm?: EvmWatcherConfig[];
+    /** Stellar configuration. */
+    stellar?: StellarWatcherConfig;
+    /** Solana configuration. */
+    solana?: SolanaWatcherConfig;
+    /** Unified callback for all incoming payments. */
+    onPayment: (event: IncomingPayment) => void;
+    /** Unified error callback. */
+    onError?: (error: Error) => void;
+    /** Logger function. */
+    logger?: Logger;
+}
+/**
+ * Creates a multi-chain payment watcher.
+ *
+ * @returns Unsubscribe function that stops ALL chain watchers.
+ *
+ * @example
+ * ```ts
+ * const unsub = createMultiChainWatcher({
+ *   evm: [
+ *     { address: '0x...', rpcUrl: 'https://mainnet.base.org', chainName: 'Base', usdcContractAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' },
+ *     { address: '0x...', rpcUrl: 'https://arb1.arbitrum.io/rpc', chainName: 'Arbitrum' },
+ *   ],
+ *   stellar: { accountId: 'GABCD...' },
+ *   solana: { address: '7abc...' },
+ *   onPayment: (event) => console.log(`${event.chain}: ${event.amountFormatted} ${event.asset}`),
+ * });
+ *
+ * // Stop all watchers
+ * unsub();
+ * ```
+ */
+export declare function createMultiChainWatcher(config: MultiChainWatcherConfig): Unsubscribe;
+//# sourceMappingURL=multi-watcher.d.ts.map

package/dist/types/monitor/multi-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-watcher.d.ts","sourceRoot":"","sources":["../../../src/monitor/multi-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,GAAG,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACzB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,kDAAkD;IAClD,SAAS,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW,CAsEpF"}

package/dist/types/monitor/solana-watcher.d.ts

@@ -0,0 +1,36 @@
+import type { IncomingPayment, Unsubscribe } from '../adapters/types';
+import { Logger } from '../logger';
+/**
+ * Solana Watcher — monitors incoming SOL and SPL token transfers.
+ *
+ * Uses `getSignaturesForAddress` polling to detect new transactions
+ * involving the target account.
+ */
+export interface SolanaWatcherConfig {
+    /** Solana wallet address to monitor (base58). */
+    address: string;
+    /** Solana JSON-RPC URL. Default: 'https://api.mainnet-beta.solana.com'. */
+    rpcUrl?: string;
+    /** USDC mint address. Default: mainnet USDC mint. */
+    usdcMint?: string;
+    /** Poll interval in milliseconds. Default: 5000. */
+    pollIntervalMs?: number;
+    /** Callback for detected incoming payments. */
+    onPayment: (event: IncomingPayment) => void;
+    /** Callback for errors. */
+    onError?: (error: Error) => void;
+    /** Logger function. */
+    logger?: Logger;
+}
+/**
+ * Creates a Solana payment watcher using JSON-RPC polling.
+ *
+ * Polls `getSignaturesForAddress` for new transactions, then
+ * inspects each transaction to detect:
+ * 1. Native SOL transfers TO the target address
+ * 2. SPL USDC transfers TO the target's Associated Token Account
+ *
+ * @returns Unsubscribe function to stop watching.
+ */
+export declare function createSolanaWatcher(config: SolanaWatcherConfig): Unsubscribe;
+//# sourceMappingURL=solana-watcher.d.ts.map

package/dist/types/monitor/solana-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-watcher.d.ts","sourceRoot":"","sources":["../../../src/monitor/solana-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,WAAW,CAgK5E"}