agent0-sdk 1.2.0 → 1.3.0

package/dist/core/web3-client.d.ts

@@ -1,191 +0,0 @@
-/**
- * Web3 integration layer for smart contract interactions using ethers.js
- */
-import { ethers, type Contract, type Wallet, type Signer, type JsonRpcProvider, type InterfaceAbi } from 'ethers';
-export interface TransactionOptions {
-    gasLimit?: bigint;
-    gasPrice?: bigint;
-    maxFeePerGas?: bigint;
-    maxPriorityFeePerGas?: bigint;
-}
-/**
- * Web3 client for interacting with ERC-8004 smart contracts
- */
-export declare class Web3Client {
-    readonly provider: JsonRpcProvider;
-    readonly signer?: Wallet | Signer;
-    chainId: bigint;
-    /**
-     * Initialize Web3 client
-     * @param rpcUrl - RPC endpoint URL
-     * @param signerOrKey - Optional private key string OR ethers Wallet/Signer for signing transactions
-     */
-    constructor(rpcUrl: string, signerOrKey?: string | Wallet | Signer);
-    /**
-     * Initialize the client (fetch chain ID)
-     */
-    initialize(): Promise<void>;
-    /**
-     * Get contract instance
-     */
-    getContract(address: string, abi: InterfaceAbi): Contract;
-    /**
-     * Call a contract method (view/pure function)
-     */
-    callContract(contract: Contract, methodName: string, ...args: any[]): Promise<any>;
-    /**
-     * Execute a contract transaction
-     * For overloaded functions like register(), use registerAgent() wrapper instead
-     */
-    transactContract(contract: Contract, methodName: string, options?: TransactionOptions, ...args: any[]): Promise<string>;
-    /**
-     * Router wrapper for register() function overloads
-     * Intelligently selects the correct overload based on arguments:
-     * - register() - no arguments
-     * - register(string agentURI) - just agentURI
-     * - register(string agentURI, tuple[] metadata) - agentURI + metadata
-     */
-    private registerAgent;
-    /**
-     * Wait for transaction to be mined
-     */
-    waitForTransaction(txHash: string, timeout?: number): Promise<ethers.ContractTransactionReceipt>;
-    /**
-     * Get contract events
-     */
-    getEvents(contract: Contract, eventName: string, fromBlock?: number, toBlock?: number): Promise<ethers.Log[]>;
-    /**
-     * Sign a message with the account's private key
-     */
-    signMessage(message: string | Uint8Array): Promise<string>;
-    /**
-     * Sign typed data (EIP-712) with the account's private key
-     */
-    signTypedData(domain: {
-        name?: string;
-        version?: string;
-        chainId?: number | bigint;
-        verifyingContract?: string;
-        salt?: string;
-    }, types: Record<string, any>, value: Record<string, any>): Promise<string>;
-    /**
-     * Build canonical EIP-712 typed data for IdentityRegistry.setAgentWallet (ERC-8004 Jan 2026).
-     *
-     * Contract expects:
-     * - domain: name="ERC8004IdentityRegistry", version="1"
-     * - primary type: AgentWalletSet(uint256 agentId,address newWallet,address owner,uint256 deadline)
-     */
-    buildAgentWalletSetTypedData(params: {
-        agentId: bigint;
-        newWallet: string;
-        owner: string;
-        deadline: bigint;
-        chainId: number | bigint;
-        verifyingContract: string;
-        domainName?: string;
-        domainVersion?: string;
-    }): {
-        domain: {
-            name: string;
-            version: string;
-            chainId: number | bigint;
-            verifyingContract: string;
-        };
-        types: {
-            AgentWalletSet: Array<{
-                name: string;
-                type: string;
-            }>;
-        };
-        message: {
-            agentId: bigint;
-            newWallet: string;
-            owner: string;
-            deadline: bigint;
-        };
-    };
-    /**
-     * Legacy typed-data variant (without owner field).
-     * Some deployments may use AgentWalletSet(uint256 agentId,address newWallet,uint256 deadline).
-     */
-    buildAgentWalletSetTypedDataNoOwner(params: {
-        agentId: bigint;
-        newWallet: string;
-        deadline: bigint;
-        chainId: number | bigint;
-        verifyingContract: string;
-        domainName?: string;
-        domainVersion?: string;
-    }): {
-        domain: {
-            name: string;
-            version: string;
-            chainId: number | bigint;
-            verifyingContract: string;
-        };
-        types: {
-            AgentWalletSet: Array<{
-                name: string;
-                type: string;
-            }>;
-        };
-        message: {
-            agentId: bigint;
-            newWallet: string;
-            deadline: bigint;
-        };
-    };
-    /**
-     * Sign EIP-712 typed data with either:
-     * - a private key string (EOA), or
-     * - an ethers Signer (EOA / smart account with a signer abstraction).
-     */
-    signTypedDataWith(signerOrKey: string | Wallet | Signer, domain: Record<string, any>, types: Record<string, any>, message: Record<string, any>): Promise<string>;
-    /**
-     * Normalize ECDSA signatures to use v = 27/28 (some contracts/libraries expect this).
-     * ethers may produce signatures with v in {0,1}.
-     */
-    normalizeEcdsaSignature(signature: string): string;
-    /**
-     * Recover the signer address for EIP-712 typed data (EOA path).
-     */
-    recoverTypedDataSigner(domain: Record<string, any>, types: Record<string, any>, message: Record<string, any>, signature: string): string;
-    /**
-     * Resolve an address for a provided signer or private key string.
-     */
-    addressOf(signerOrKey: string | Wallet | Signer): Promise<string>;
-    /**
-     * Recover address from message and signature
-     */
-    recoverAddress(message: string | Uint8Array, signature: string): string;
-    /**
-     * Compute Keccak-256 hash
-     */
-    keccak256(data: string | Uint8Array): string;
-    /**
-     * Convert address to checksum format
-     */
-    toChecksumAddress(address: string): string;
-    /**
-     * Check if string is a valid Ethereum address
-     */
-    isAddress(address: string): boolean;
-    /**
-     * Get ETH balance of an address
-     */
-    getBalance(address: string): Promise<bigint>;
-    /**
-     * Get transaction count (nonce) of an address
-     */
-    getTransactionCount(address: string): Promise<number>;
-    /**
-     * Get the account address (if signer is available)
-     */
-    get address(): string | undefined;
-    /**
-     * Get the account address asynchronously (if signer is available)
-     * Use this method when you need the address from a generic Signer
-     */
-    getAddress(): Promise<string | undefined>;
-}
-//# sourceMappingURL=web3-client.d.ts.map

package/dist/core/web3-client.d.ts.map

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

package/dist/core/web3-client.js

@@ -1,350 +0,0 @@
-/**
- * Web3 integration layer for smart contract interactions using ethers.js
- */
-import { ethers, } from 'ethers';
-/**
- * Web3 client for interacting with ERC-8004 smart contracts
- */
-export class Web3Client {
-    /**
-     * Initialize Web3 client
-     * @param rpcUrl - RPC endpoint URL
-     * @param signerOrKey - Optional private key string OR ethers Wallet/Signer for signing transactions
-     */
-    constructor(rpcUrl, signerOrKey) {
-        this.provider = new ethers.JsonRpcProvider(rpcUrl);
-        if (signerOrKey) {
-            if (typeof signerOrKey === 'string') {
-                // Private key string - create a new Wallet
-                // Validate that it's not an empty string
-                if (signerOrKey.trim() === '') {
-                    throw new Error('Private key cannot be empty');
-                }
-                this.signer = new ethers.Wallet(signerOrKey, this.provider);
-            }
-            else {
-                // Already a Wallet or Signer - connect to provider if needed
-                const currentProvider = signerOrKey.provider;
-                if (currentProvider && currentProvider === this.provider) {
-                    // Already connected to the same provider
-                    this.signer = signerOrKey;
-                }
-                else if (typeof signerOrKey.connect === 'function') {
-                    // Connect to provider
-                    try {
-                        this.signer = signerOrKey.connect(this.provider);
-                    }
-                    catch (error) {
-                        throw new Error(`Failed to connect signer to provider: ${error instanceof Error ? error.message : String(error)}`);
-                    }
-                }
-                else {
-                    // Signer without connect method - use as-is
-                    this.signer = signerOrKey;
-                }
-            }
-        }
-        // Get chain ID asynchronously (will be set in async initialization)
-        // For now, we'll fetch it when needed
-        this.chainId = 0n;
-    }
-    /**
-     * Initialize the client (fetch chain ID)
-     */
-    async initialize() {
-        const network = await this.provider.getNetwork();
-        this.chainId = network.chainId;
-    }
-    /**
-     * Get contract instance
-     */
-    getContract(address, abi) {
-        const signerOrProvider = this.signer || this.provider;
-        return new ethers.Contract(address, abi, signerOrProvider);
-    }
-    /**
-     * Call a contract method (view/pure function)
-     */
-    async callContract(contract, methodName, ...args) {
-        const method = contract[methodName];
-        if (!method || typeof method !== 'function') {
-            throw new Error(`Method ${methodName} not found on contract`);
-        }
-        return await method(...args);
-    }
-    /**
-     * Execute a contract transaction
-     * For overloaded functions like register(), use registerAgent() wrapper instead
-     */
-    async transactContract(contract, methodName, options = {}, ...args) {
-        if (!this.signer) {
-            throw new Error('Cannot execute transaction: SDK is in read-only mode. Provide a private key to enable write operations.');
-        }
-        // Special handling for register() function with multiple overloads
-        if (methodName === 'register') {
-            return this.registerAgent(contract, options, ...args);
-        }
-        const method = contract[methodName];
-        if (!method || typeof method !== 'function') {
-            throw new Error(`Method ${methodName} not found on contract`);
-        }
-        // Build transaction options - filter out undefined values
-        const txOptions = Object.fromEntries(Object.entries(options).filter(([_, value]) => value !== undefined));
-        // Send transaction
-        const tx = await method(...args);
-        const txResponse = await tx;
-        return txResponse.hash;
-    }
-    /**
-     * Router wrapper for register() function overloads
-     * Intelligently selects the correct overload based on arguments:
-     * - register() - no arguments
-     * - register(string agentURI) - just agentURI
-     * - register(string agentURI, tuple[] metadata) - agentURI + metadata
-     */
-    async registerAgent(contract, options, ...args) {
-        if (!this.signer) {
-            throw new Error('No signer available for transaction');
-        }
-        const contractInterface = contract.interface;
-        // Determine which overload to use based on arguments
-        let functionName;
-        let callArgs;
-        if (args.length === 0) {
-            // register() - no arguments
-            functionName = 'register()';
-            callArgs = [];
-        }
-        else if (args.length === 1 && typeof args[0] === 'string') {
-            // register(string agentURI) - just agentURI
-            functionName = 'register(string)';
-            callArgs = [args[0]];
-        }
-        else if (args.length === 2 && typeof args[0] === 'string' && Array.isArray(args[1])) {
-            // register(string agentURI, tuple[] metadata) - agentURI + metadata
-            functionName = 'register(string,(string,bytes)[])';
-            callArgs = [args[0], args[1]];
-        }
-        else {
-            throw new Error(`Invalid arguments for register(). Expected: () | (string) | (string, tuple[]), got ${args.length} arguments`);
-        }
-        // Get the specific function fragment using the signature
-        const functionFragment = contractInterface.getFunction(functionName);
-        if (!functionFragment) {
-            throw new Error(`Function ${functionName} not found in contract ABI`);
-        }
-        // Encode function data to avoid ambiguity - this bypasses function resolution
-        const data = contractInterface.encodeFunctionData(functionFragment, callArgs);
-        // Send transaction directly with encoded data (no function call resolution needed)
-        const txResponse = await this.signer.sendTransaction({
-            to: contract.target,
-            data: data,
-        });
-        return txResponse.hash;
-    }
-    /**
-     * Wait for transaction to be mined
-     */
-    async waitForTransaction(txHash, timeout = 180000) {
-        return (await this.provider.waitForTransaction(txHash, undefined, timeout));
-    }
-    /**
-     * Get contract events
-     */
-    async getEvents(contract, eventName, fromBlock = 0, toBlock) {
-        const filter = contract.filters[eventName]();
-        return await contract.queryFilter(filter, fromBlock, toBlock);
-    }
-    /**
-     * Sign a message with the account's private key
-     */
-    async signMessage(message) {
-        if (!this.signer) {
-            throw new Error('No signer available');
-        }
-        return await this.signer.signMessage(message);
-    }
-    /**
-     * Sign typed data (EIP-712) with the account's private key
-     */
-    async signTypedData(domain, types, value) {
-        if (!this.signer) {
-            throw new Error('No signer available');
-        }
-        // ethers.js v6 signTypedData signature
-        const sig = await this.signer.signTypedData(domain, types, value);
-        return this.normalizeEcdsaSignature(sig);
-    }
-    /**
-     * Build canonical EIP-712 typed data for IdentityRegistry.setAgentWallet (ERC-8004 Jan 2026).
-     *
-     * Contract expects:
-     * - domain: name="ERC8004IdentityRegistry", version="1"
-     * - primary type: AgentWalletSet(uint256 agentId,address newWallet,address owner,uint256 deadline)
-     */
-    buildAgentWalletSetTypedData(params) {
-        const domain = {
-            name: params.domainName || 'ERC8004IdentityRegistry',
-            version: params.domainVersion || '1',
-            chainId: params.chainId,
-            verifyingContract: params.verifyingContract,
-        };
-        const types = {
-            AgentWalletSet: [
-                { name: 'agentId', type: 'uint256' },
-                { name: 'newWallet', type: 'address' },
-                { name: 'owner', type: 'address' },
-                { name: 'deadline', type: 'uint256' },
-            ],
-        };
-        const message = {
-            agentId: params.agentId,
-            newWallet: params.newWallet,
-            owner: params.owner,
-            deadline: params.deadline,
-        };
-        return { domain, types, message };
-    }
-    /**
-     * Legacy typed-data variant (without owner field).
-     * Some deployments may use AgentWalletSet(uint256 agentId,address newWallet,uint256 deadline).
-     */
-    buildAgentWalletSetTypedDataNoOwner(params) {
-        const domain = {
-            name: params.domainName || 'ERC8004IdentityRegistry',
-            version: params.domainVersion || '1',
-            chainId: params.chainId,
-            verifyingContract: params.verifyingContract,
-        };
-        const types = {
-            AgentWalletSet: [
-                { name: 'agentId', type: 'uint256' },
-                { name: 'newWallet', type: 'address' },
-                { name: 'deadline', type: 'uint256' },
-            ],
-        };
-        const message = {
-            agentId: params.agentId,
-            newWallet: params.newWallet,
-            deadline: params.deadline,
-        };
-        return { domain, types, message };
-    }
-    /**
-     * Sign EIP-712 typed data with either:
-     * - a private key string (EOA), or
-     * - an ethers Signer (EOA / smart account with a signer abstraction).
-     */
-    async signTypedDataWith(signerOrKey, domain, types, message) {
-        if (typeof signerOrKey === 'string') {
-            const key = signerOrKey.startsWith('0x') ? signerOrKey : `0x${signerOrKey}`;
-            const wallet = new ethers.Wallet(key);
-            const sig = await wallet.signTypedData(domain, types, message);
-            return this.normalizeEcdsaSignature(sig);
-        }
-        const sig = await signerOrKey.signTypedData(domain, types, message);
-        return this.normalizeEcdsaSignature(sig);
-    }
-    /**
-     * Normalize ECDSA signatures to use v = 27/28 (some contracts/libraries expect this).
-     * ethers may produce signatures with v in {0,1}.
-     */
-    normalizeEcdsaSignature(signature) {
-        const sig = signature.startsWith('0x') ? signature : `0x${signature}`;
-        const bytes = ethers.getBytes(sig);
-        if (bytes.length !== 65) {
-            return sig;
-        }
-        const v = bytes[64];
-        if (v === 0 || v === 1) {
-            bytes[64] = v + 27;
-            return ethers.hexlify(bytes);
-        }
-        return sig;
-    }
-    /**
-     * Recover the signer address for EIP-712 typed data (EOA path).
-     */
-    recoverTypedDataSigner(domain, types, message, signature) {
-        return ethers.verifyTypedData(domain, types, message, signature);
-    }
-    /**
-     * Resolve an address for a provided signer or private key string.
-     */
-    async addressOf(signerOrKey) {
-        if (typeof signerOrKey === 'string') {
-            const key = signerOrKey.startsWith('0x') ? signerOrKey : `0x${signerOrKey}`;
-            return new ethers.Wallet(key).address;
-        }
-        return await signerOrKey.getAddress();
-    }
-    /**
-     * Recover address from message and signature
-     */
-    recoverAddress(message, signature) {
-        return ethers.verifyMessage(message, signature);
-    }
-    /**
-     * Compute Keccak-256 hash
-     */
-    keccak256(data) {
-        if (typeof data === 'string') {
-            return ethers.keccak256(ethers.toUtf8Bytes(data));
-        }
-        // For Uint8Array, convert to hex string first
-        return ethers.keccak256(ethers.hexlify(data));
-    }
-    /**
-     * Convert address to checksum format
-     */
-    toChecksumAddress(address) {
-        return ethers.getAddress(address);
-    }
-    /**
-     * Check if string is a valid Ethereum address
-     */
-    isAddress(address) {
-        try {
-            return ethers.isAddress(address);
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Get ETH balance of an address
-     */
-    async getBalance(address) {
-        return await this.provider.getBalance(address);
-    }
-    /**
-     * Get transaction count (nonce) of an address
-     */
-    async getTransactionCount(address) {
-        return await this.provider.getTransactionCount(address, 'pending');
-    }
-    /**
-     * Get the account address (if signer is available)
-     */
-    get address() {
-        if (!this.signer)
-            return undefined;
-        // Wallet has address property, Signer might need getAddress()
-        if ('address' in this.signer) {
-            return this.signer.address;
-        }
-        // For generic Signer, we can't get address synchronously
-        // This is a limitation of the Signer interface
-        return undefined;
-    }
-    /**
-     * Get the account address asynchronously (if signer is available)
-     * Use this method when you need the address from a generic Signer
-     */
-    async getAddress() {
-        if (!this.signer)
-            return undefined;
-        return await this.signer.getAddress();
-    }
-}
-//# sourceMappingURL=web3-client.js.map

package/dist/core/web3-client.js.map

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