agentwallet-sdk 5.1.1 → 5.2.0

package/dist/identity/agent-identity.js

@@ -1,300 +0,0 @@
-/**
- * MIT License
- *
- * Copyright (c) 2026 AgentNexus / agentwallet-sdk contributors
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-import { ERC8004Client, } from './erc8004.js';
-import { ERC6551Client, DEFAULT_SALT, } from './erc6551.js';
-// ─── AgentIdentity ────────────────────────────────────────────────────────────
-/**
- * AgentIdentity — unified ERC-8004 + ERC-6551 identity manager.
- *
- * Provides a single interface to manage an agent's complete on-chain identity:
- * - ERC-8004: NFT registration with metadata and service endpoints
- * - ERC-6551: Token Bound Account (TBA) — the agent's autonomous wallet
- *
- * @example
- * ```typescript
- * import { AgentIdentity } from 'agentwallet-sdk';
- * import { createWalletClient, http } from 'viem';
- * import { privateKeyToAccount } from 'viem/accounts';
- * import { base } from 'viem/chains';
- *
- * const wallet = createWalletClient({
- *   account: privateKeyToAccount('0xYOUR_PRIVATE_KEY'),
- *   chain: base,
- *   transport: http(),
- * });
- *
- * const identity = new AgentIdentity({
- *   wallet,
- *   chain: 'base',
- *   registryAddress: '0xYOUR_ERC8004_REGISTRY',
- * });
- *
- * // 1. Register agent NFT (ERC-8004)
- * const { agentId } = await identity.register({
- *   name: 'MyTradingAgent',
- *   description: 'Autonomous DeFi trading agent',
- *   x402Support: true,
- * });
- *
- * // 2. Deploy TBA (ERC-6551) — NFT now owns an autonomous wallet
- * await identity.deployTBA();
- * console.log('Agent TBA:', identity.tbaAddress);
- *
- * // 3. Execute from TBA (agent acts on-chain)
- * await identity.execute({
- *   to: TASKBRIDGE_CONTRACT,
- *   value: parseEther('0.01'),
- *   data: encodedCalldata,
- * });
- * ```
- */
-export class AgentIdentity {
-    constructor(config) {
-        this._agentId = null;
-        this._nftContract = null;
-        this._tbaAccount = null;
-        this.wallet = config.wallet;
-        this.chain = config.chain ?? 'base';
-        this.tbaSalt = config.tbaSalt ?? DEFAULT_SALT;
-        // ERC-8004 client — optional (some agents may only use ERC-6551)
-        if (config.registryAddress) {
-            this.erc8004 = new ERC8004Client({
-                registryAddress: config.registryAddress,
-                chain: this.chain,
-                rpcUrl: config.rpcUrl,
-            });
-            this._nftContract = config.registryAddress;
-        }
-        else {
-            this.erc8004 = null;
-        }
-        // ERC-6551 client — always initialized
-        this.erc6551 = new ERC6551Client({
-            chain: this.chain,
-            registryAddress: config.tbaRegistryAddress,
-            implementationAddress: config.tbaImplementationAddress,
-            rpcUrl: config.rpcUrl,
-        });
-    }
-    // ─── ERC-8004: Registration ───────────────────────────────────────────────
-    /**
-     * Register this agent as an ERC-8004 identity NFT on-chain.
-     *
-     * Builds a spec-compliant agent registration file and mints an ERC-721 NFT
-     * via the ERC-8004 Identity Registry. After registration, the NFT represents
-     * the agent's permanent, portable on-chain identity.
-     *
-     * Non-custodial: the wallet signs the registration transaction locally.
-     *
-     * @param metadata - Agent metadata for the registration file
-     * @param agentURI - Optional external URI (IPFS/HTTPS). Auto-builds data URI if omitted.
-     * @returns Registration result with txHash and agentId
-     * @throws Error if no registryAddress was provided in config
-     */
-    async register(metadata, agentURI) {
-        if (!this.erc8004) {
-            throw new Error('AgentIdentity: registryAddress is required for ERC-8004 registration. ' +
-                'Provide it in the constructor config.');
-        }
-        const result = await this.erc8004.registerAgent(this.wallet, metadata, agentURI);
-        if (result.agentId !== null) {
-            this._agentId = result.agentId;
-        }
-        return result;
-    }
-    /**
-     * Restore a previously registered agent identity.
-     *
-     * Use this when you already have an agentId from a prior session.
-     * Sets the internal agentId so deployTBA() and execute() work correctly.
-     *
-     * @param agentId - Previously registered ERC-8004 token ID
-     * @param nftContract - The ERC-8004 registry contract (= registryAddress in config)
-     */
-    setAgentId(agentId, nftContract) {
-        this._agentId = agentId;
-        if (nftContract)
-            this._nftContract = nftContract;
-    }
-    // ─── ERC-6551: TBA Deployment ─────────────────────────────────────────────
-    /**
-     * Deploy the Token Bound Account for this agent's NFT.
-     *
-     * The TBA address is deterministic — you can compute it before deployment
-     * via `computeTBAAddress()`. This call deploys the actual smart contract at
-     * that address, enabling the agent to act autonomously on-chain.
-     *
-     * Idempotent: calling deployTBA() on an already-deployed TBA is safe.
-     *
-     * @param nftContract - Override: NFT contract to bind the TBA to.
-     *   Defaults to the registryAddress (ERC-8004 registry is also the NFT contract).
-     * @param tokenId - Override: token ID. Defaults to the registered agentId.
-     * @returns Deployed TBAAccount
-     * @throws Error if agentId not set (call register() first or use setAgentId())
-     */
-    async deployTBA(nftContract, tokenId) {
-        const resolvedContract = nftContract ?? this._nftContract;
-        const resolvedTokenId = tokenId ?? this._agentId;
-        if (!resolvedContract) {
-            throw new Error('AgentIdentity: NFT contract address unknown. ' +
-                'Provide registryAddress in config or pass nftContract to deployTBA().');
-        }
-        if (resolvedTokenId === null) {
-            throw new Error('AgentIdentity: agentId not set. ' +
-                'Call register() first or use setAgentId() to restore a prior identity.');
-        }
-        const tbaAccount = await this.erc6551.createTBA(this.wallet, resolvedContract, resolvedTokenId, this.tbaSalt);
-        this._tbaAccount = tbaAccount;
-        return tbaAccount;
-    }
-    /**
-     * Compute the deterministic TBA address without deploying.
-     *
-     * Useful for pre-computing the address to fund it before deployment,
-     * or to check if a TBA already exists.
-     *
-     * @param nftContract - NFT contract (defaults to registryAddress)
-     * @param tokenId - Token ID (defaults to agentId)
-     * @returns Deterministic TBA address
-     */
-    computeTBAAddress(nftContract, tokenId) {
-        const resolvedContract = nftContract ?? this._nftContract;
-        const resolvedTokenId = tokenId ?? this._agentId;
-        if (!resolvedContract || resolvedTokenId === null) {
-            throw new Error('AgentIdentity: nftContract and tokenId required to compute TBA address.');
-        }
-        return this.erc6551.computeTBAAddress(resolvedContract, resolvedTokenId, this.tbaSalt);
-    }
-    /**
-     * Load TBA state without deploying — useful for resuming a session.
-     * Sets internal TBA state so execute() works without re-deploying.
-     *
-     * @param nftContract - NFT contract (defaults to registryAddress)
-     * @param tokenId - Token ID (defaults to agentId)
-     */
-    async loadTBA(nftContract, tokenId) {
-        const resolvedContract = nftContract ?? this._nftContract;
-        const resolvedTokenId = tokenId ?? this._agentId;
-        if (!resolvedContract || resolvedTokenId === null) {
-            throw new Error('AgentIdentity: nftContract and tokenId required to load TBA.');
-        }
-        const tbaAccount = await this.erc6551.getTBAAccount(resolvedContract, resolvedTokenId, this.tbaSalt);
-        this._tbaAccount = tbaAccount;
-        return tbaAccount;
-    }
-    // ─── ERC-6551: Execution ──────────────────────────────────────────────────
-    /**
-     * Execute a call from the agent's TBA (the agent acts autonomously).
-     *
-     * Routes the call through the TBA's `execute()` function, which verifies
-     * the caller owns the NFT before dispatching to the target contract.
-     *
-     * @param params - Call parameters (to, value, data, operation)
-     * @returns Transaction hash and return data
-     * @throws Error if TBA not deployed (call deployTBA() first)
-     *
-     * @example
-     * ```typescript
-     * // Agent bids on a TaskBridge task
-     * await identity.execute({
-     *   to: TASKBRIDGE_ADDRESS,
-     *   value: 0n,
-     *   data: encodeFunctionData({
-     *     abi: TaskBridgeAbi,
-     *     functionName: 'bid',
-     *     args: [taskId, bidAmount],
-     *   }),
-     * });
-     * ```
-     */
-    async execute(params) {
-        const tbaAddress = this.tbaAddress;
-        if (!tbaAddress) {
-            throw new Error('AgentIdentity: TBA not deployed. Call deployTBA() first or loadTBA() to restore.');
-        }
-        return this.erc6551.executeTBA(this.wallet, tbaAddress, params);
-    }
-    // ─── State accessors ──────────────────────────────────────────────────────
-    /**
-     * The agent's ERC-8004 token ID (null before registration).
-     */
-    get agentId() {
-        return this._agentId;
-    }
-    /**
-     * The agent's TBA address (null before deployTBA() or loadTBA()).
-     */
-    get tbaAddress() {
-        return this._tbaAccount?.address ?? null;
-    }
-    /**
-     * Full TBA account details (null before deployTBA() or loadTBA()).
-     */
-    get tbaAccount() {
-        return this._tbaAccount;
-    }
-    /**
-     * Whether the agent's ERC-8004 NFT is registered.
-     */
-    get isRegistered() {
-        return this._agentId !== null;
-    }
-    /**
-     * Whether the agent's TBA is deployed on-chain.
-     */
-    get isTBADeployed() {
-        return this._tbaAccount?.isDeployed === true;
-    }
-    /**
-     * The wallet account address (human principal / NFT owner).
-     */
-    get ownerAddress() {
-        return this.wallet.account?.address ?? null;
-    }
-    /**
-     * Full identity state snapshot.
-     */
-    get state() {
-        return {
-            agentId: this._agentId,
-            tbaAddress: this.tbaAddress,
-            isRegistered: this.isRegistered,
-            isTBADeployed: this.isTBADeployed,
-            owner: this.ownerAddress,
-        };
-    }
-    /**
-     * Direct access to the underlying ERC6551Client for advanced usage.
-     */
-    get erc6551Client() {
-        return this.erc6551;
-    }
-    /**
-     * Direct access to the underlying ERC8004Client (null if no registryAddress provided).
-     */
-    get erc8004Client() {
-        return this.erc8004;
-    }
-}
-//# sourceMappingURL=agent-identity.js.map

package/dist/identity/agent-identity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-identity.js","sourceRoot":"","sources":["../../src/identity/agent-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAoBH,OAAO,EACL,aAAa,GAId,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,EACb,YAAY,GAKb,MAAM,cAAc,CAAC;AAsEtB,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,aAAa;IAYxB,YAAY,MAA2B;QAJ/B,aAAQ,GAAkB,IAAI,CAAC;QAC/B,iBAAY,GAAmB,IAAI,CAAC;QACpC,gBAAW,GAAsB,IAAI,CAAC;QAG5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC;QAE9C,iEAAiE;QACjE,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC;gBAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,uCAAuC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,eAAe,EAAE,MAAM,CAAC,kBAAkB;YAC1C,qBAAqB,EAAE,MAAM,CAAC,wBAAwB;YACtD,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAE7E;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,QAAQ,CACZ,QAA6C,EAC7C,QAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACxE,uCAAuC,CACxC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAC7C,IAAI,CAAC,MAAM,EACX,QAAQ,EACR,QAAQ,CACT,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAe,EAAE,WAAqB;QAC/C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,WAAW;YAAE,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IACnD,CAAC;IAED,6EAA6E;IAE7E;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,SAAS,CACb,WAAqB,EACrB,OAAgB;QAEhB,MAAM,gBAAgB,GAAG,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC;QAC1D,MAAM,eAAe,GAAG,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QAEjD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,+CAA+C;gBAC/C,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,kCAAkC;gBAClC,wEAAwE,CACzE,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAC7C,IAAI,CAAC,MAAM,EACX,gBAAgB,EAChB,eAAe,EACf,IAAI,CAAC,OAAO,CACb,CAAC;QAEF,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,WAAqB,EAAE,OAAgB;QACvD,MAAM,gBAAgB,GAAG,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC;QAC1D,MAAM,eAAe,GAAG,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QAEjD,IAAI,CAAC,gBAAgB,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,WAAqB,EAAE,OAAgB;QACnD,MAAM,gBAAgB,GAAG,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC;QAC1D,MAAM,eAAe,GAAG,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QAEjD,IAAI,CAAC,gBAAgB,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CACjD,gBAAgB,EAChB,eAAe,EACf,IAAI,CAAC,OAAO,CACb,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,6EAA6E;IAE7E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,OAAO,CAAC,MAAwB;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,6EAA6E;IAE7E;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,IAAI,CAAC,YAAY;SACzB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/identity/email-resolver.d.ts

@@ -1,235 +0,0 @@
-/**
- * AgentMail Integration — Email ↔ Wallet Resolver
- *
- * Gives every agent in agentwallet-sdk its own email address via AgentMail,
- * and resolves email addresses back to wallet addresses for payment routing.
- *
- * Architecture:
- *   EmailResolver
- *     ├── AgentMail API  → inbox creation, send/receive, identity
- *     └── ERC-8004       → on-chain agent registration (email stored as metadata)
- *
- * @module identity/email-resolver
- */
-
-/** Config to initialise the EmailResolver */
-export interface EmailResolverConfig {
-  /**
-   * AgentMail API key.
-   * Get one at https://app.agentmail.to
-   */
-  agentMailApiKey: string;
-
-  /**
-   * Base URL override (default: https://api.agentmail.to/v0)
-   */
-  baseUrl?: string;
-
-  /**
-   * Optional local in-memory cache TTL in seconds (default: 300).
-   * Avoids repeated lookups for the same address.
-   */
-  cacheTtlSeconds?: number;
-}
-
-/** A registered agent inbox */
-export interface AgentInbox {
-  /** Fully-qualified email address, e.g. trading-agent@agentmail.to */
-  emailAddress: string;
-  /** AgentMail inbox ID */
-  inboxId: string;
-  /** Display name (usually the agent's ERC-8004 name) */
-  displayName: string;
-  /** ISO timestamp of creation */
-  createdAt: string;
-}
-
-/** Result of resolving an email → wallet */
-export interface WalletResolution {
-  /** The email address that was resolved */
-  emailAddress: string;
-  /** On-chain wallet address (or TBA address) */
-  walletAddress: string;
-  /** Chain the wallet is on (default: 'base') */
-  chain: string;
-  /** Source of the resolution */
-  source: 'agentmail' | 'ens' | 'local-registry';
-  /** Unix timestamp when this resolution was cached */
-  resolvedAt: number;
-}
-
-/** An email message sent to/from an agent inbox */
-export interface AgentEmail {
-  messageId: string;
-  from: string;
-  to: string[];
-  subject: string;
-  body: string;
-  timestamp: string;
-  threadId?: string;
-  /** Parsed x402 payment request if the email contains one */
-  paymentRequest?: {
-    amount: number;
-    currency: string;
-    recipientWallet: string;
-    memo?: string;
-  };
-}
-
-/** Parameters for sending an email from an agent inbox */
-export interface SendEmailParams {
-  inboxId: string;
-  to: string | string[];
-  subject: string;
-  body: string;
-  /** Attach an x402 payment request to the email body */
-  paymentRequest?: {
-    amount: number;
-    currency: string;
-    recipientWallet: string;
-    memo?: string;
-  };
-  replyToMessageId?: string;
-}
-
-/**
- * EmailResolver — AgentMail integration for agentwallet-sdk.
- *
- * Creates and manages per-agent email inboxes, and resolves email addresses
- * to wallet addresses for payment routing.
- *
- * @example
- * ```typescript
- * import { EmailResolver } from 'agentwallet-sdk';
- *
- * const resolver = new EmailResolver({
- *   agentMailApiKey: process.env.AGENTMAIL_API_KEY!,
- * });
- *
- * // Give your agent an email inbox
- * const inbox = await resolver.createInbox({
- *   agentName: 'trading-agent',
- *   displayName: 'Trading Agent',
- *   walletAddress: '0xYourAgentWallet',
- *   chain: 'base',
- * });
- * console.log(inbox.emailAddress); // trading-agent@agentmail.to
- *
- * // Resolve any agent email → wallet address
- * const resolution = await resolver.resolveEmailToWallet('some-agent@agentmail.to');
- * console.log(resolution.walletAddress); // 0x...
- *
- * // Send an email from your agent with a payment request
- * await resolver.sendEmail({
- *   inboxId: inbox.inboxId,
- *   to: 'contractor@agentmail.to',
- *   subject: 'Task payment',
- *   body: 'Here is your payment for the completed task.',
- *   paymentRequest: { amount: 5, currency: 'USDC', recipientWallet: '0x...' },
- * });
- * ```
- */
-export declare class EmailResolver {
-  private readonly apiKey: string;
-  private readonly baseUrl: string;
-  private readonly cacheTtl: number;
-  private readonly cache: Map<string, WalletResolution>;
-
-  constructor(config: EmailResolverConfig);
-
-  /**
-   * Create a new email inbox for an agent.
-   * The wallet address is stored as metadata in AgentMail and linked to the inbox.
-   *
-   * @param params - Agent details for inbox creation
-   * @returns The created inbox (includes the email address)
-   */
-  createInbox(params: {
-    agentName: string;
-    displayName: string;
-    walletAddress: string;
-    chain?: string;
-  }): Promise<AgentInbox>;
-
-  /**
-   * List all inboxes for this API key.
-   */
-  listInboxes(): Promise<AgentInbox[]>;
-
-  /**
-   * Get a specific inbox by ID.
-   */
-  getInbox(inboxId: string): Promise<AgentInbox>;
-
-  /**
-   * Delete an inbox (e.g., when an agent is decommissioned).
-   */
-  deleteInbox(inboxId: string): Promise<void>;
-
-  /**
-   * Resolve an email address to a wallet address.
-   *
-   * Resolution order:
-   * 1. Local cache (fast, TTL-based)
-   * 2. AgentMail API (looks up inbox metadata)
-   * 3. ENS reverse lookup (agent.eth-style names)
-   *
-   * @param emailAddress - The agent email to resolve
-   * @returns Resolved wallet address and chain
-   */
-  resolveEmailToWallet(emailAddress: string): Promise<WalletResolution>;
-
-  /**
-   * Reverse lookup: find the email address for a wallet address.
-   * Queries AgentMail for inboxes with matching wallet metadata.
-   *
-   * @param walletAddress - Onchain wallet address
-   * @returns The agent's email address, or null if not found
-   */
-  resolveWalletToEmail(walletAddress: string): Promise<string | null>;
-
-  /**
-   * Fetch unread messages from an agent inbox.
-   * Automatically parses x402 payment requests embedded in email bodies.
-   *
-   * @param inboxId - The inbox to check
-   * @param options - Filter options
-   */
-  fetchMessages(
-    inboxId: string,
-    options?: {
-      unreadOnly?: boolean;
-      limit?: number;
-      threadId?: string;
-    }
-  ): Promise<AgentEmail[]>;
-
-  /**
-   * Send an email from an agent inbox.
-   * Optionally embeds an x402 payment request in the email body.
-   *
-   * @param params - Send parameters
-   * @returns The sent message ID
-   */
-  sendEmail(params: SendEmailParams): Promise<{ messageId: string }>;
-
-  /**
-   * Reply to an existing email thread.
-   */
-  replyToEmail(params: {
-    inboxId: string;
-    messageId: string;
-    body: string;
-    paymentRequest?: SendEmailParams['paymentRequest'];
-  }): Promise<{ messageId: string }>;
-
-  /**
-   * Mark a message as read.
-   */
-  markAsRead(inboxId: string, messageId: string): Promise<void>;
-
-  /**
-   * Clear the local resolution cache.
-   */
-  clearCache(): void;
-}