agentwallet-sdk 3.2.1 → 3.4.0

package/dist/gas/sponsor.js

@@ -1,193 +0,0 @@
-// GasSponsor — Alchemy ERC-4337 Gas Manager integration
-// Enables agents to execute transactions without holding native gas tokens.
-//
-// Alchemy API reference:
-//   https://docs.alchemy.com/docs/gas-manager-services
-//   POST https://{network}.g.alchemy.com/v2/{apiKey}
-//   Methods: alchemy_requestGasAndPaymasterAndData, pm_sponsorUserOperation
-import { ALCHEMY_NETWORK_SLUGS } from './types.js';
-/** ERC-4337 entry point — canonical v0.6 address used across all EVM chains */
-const DEFAULT_ENTRY_POINT = '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789';
-/**
- * GasSponsor — wraps transactions as ERC-4337 UserOperations with Alchemy paymaster data.
- *
- * Agents don't need to hold ETH/MATIC/etc. to pay gas. The Alchemy Gas Manager
- * sponsors gas on their behalf, billed to your Alchemy account.
- *
- * Requires:
- *   - An Alchemy API key with Gas Manager enabled
- *   - A Gas Manager policy ID (create at https://dashboard.alchemy.com/gas-manager)
- *   - A smart account (ERC-4337 compatible) for the agent
- *
- * @example
- * const sponsor = new GasSponsor({ alchemyApiKey: 'your-key', policyId: 'your-policy-id' });
- * const sponsored = await sponsor.sponsorTransaction({
- *   chain: 'base',
- *   from: agentSmartAccountAddress,
- *   to: usdcContract,
- *   data: transferCalldata,
- * });
- * // Now submit sponsored.userOperation to an ERC-4337 bundler
- */
-export class GasSponsor {
-    constructor(config) {
-        this.config = {
-            alchemyApiKey: config.alchemyApiKey,
-            policyId: config.policyId ?? process.env.ALCHEMY_GAS_POLICY_ETH ?? '',
-            solanaPolicyId: config.solanaPolicyId ?? process.env.ALCHEMY_GAS_POLICY_SOL ?? '',
-            entryPoint: config.entryPoint ?? DEFAULT_ENTRY_POINT,
-        };
-    }
-    /** Get the Solana gas policy ID */
-    getSolanaPolicyId() {
-        return this.config.solanaPolicyId;
-    }
-    /** Get the EVM gas policy ID */
-    getEvmPolicyId() {
-        return this.config.policyId;
-    }
-    /**
-     * Check if gas sponsorship is available for a given chain.
-     */
-    isSupported(chain) {
-        return chain in ALCHEMY_NETWORK_SLUGS;
-    }
-    /**
-     * Returns the list of chains where Alchemy Gas Manager is available.
-     * Of the SDK's 17 CCTP chains, 6 are supported by Alchemy's Gas Manager.
-     */
-    getSupportedChains() {
-        return Object.keys(ALCHEMY_NETWORK_SLUGS);
-    }
-    /**
-     * Get the Alchemy RPC URL for a given chain.
-     */
-    getAlchemyRpcUrl(chain) {
-        const slug = ALCHEMY_NETWORK_SLUGS[chain];
-        return `https://${slug}.g.alchemy.com/v2/${this.config.alchemyApiKey}`;
-    }
-    /**
-     * Sponsor a transaction — wraps it as a UserOperation with Alchemy paymaster data.
-     *
-     * The resulting UserOperation must be submitted to an ERC-4337 bundler
-     * (e.g. Alchemy's bundler via `eth_sendUserOperation`).
-     *
-     * Note: `from` must be an ERC-4337 smart account, not a plain EOA.
-     * Plain EOA transactions cannot be sponsored via ERC-4337 paymasters.
-     */
-    async sponsorTransaction(params) {
-        if (!this.isSupported(params.chain)) {
-            throw new Error(`Gas sponsorship not supported on chain "${params.chain}". ` +
-                `Supported chains: ${this.getSupportedChains().join(', ')}`);
-        }
-        if (!this.config.policyId) {
-            throw new Error('Gas sponsorship requires a policyId. ' +
-                'Create one at https://dashboard.alchemy.com/gas-manager');
-        }
-        const rpcUrl = this.getAlchemyRpcUrl(params.chain);
-        const valueHex = params.value ? `0x${params.value.toString(16)}` : '0x0';
-        // Build a minimal UserOperation stub — Alchemy fills in gas limits + paymasterAndData
-        const userOpStub = {
-            sender: params.from,
-            nonce: '0x0', // caller should set the correct nonce from the smart account
-            initCode: '0x',
-            callData: this._encodeExecuteCall(params.to, params.value ?? 0n, params.data),
-            callGasLimit: '0x0',
-            verificationGasLimit: '0x0',
-            preVerificationGas: '0x0',
-            maxFeePerGas: '0x0',
-            maxPriorityFeePerGas: '0x0',
-            paymasterAndData: '0x',
-            signature: '0x',
-        };
-        const response = await this._alchemyRpc(rpcUrl, 'alchemy_requestGasAndPaymasterAndData', [
-            {
-                policyId: this.config.policyId,
-                entryPoint: this.config.entryPoint,
-                userOperation: userOpStub,
-                dummySignature: '0x',
-            },
-        ]);
-        const result = response.result;
-        const sponsoredUserOp = {
-            ...userOpStub,
-            paymasterAndData: result.paymasterAndData,
-            preVerificationGas: result.preVerificationGas,
-            verificationGasLimit: result.verificationGasLimit,
-            callGasLimit: result.callGasLimit,
-            maxFeePerGas: result.maxFeePerGas,
-            maxPriorityFeePerGas: result.maxPriorityFeePerGas,
-        };
-        return {
-            userOperation: sponsoredUserOp,
-            paymasterAndData: result.paymasterAndData,
-            preVerificationGas: result.preVerificationGas,
-            verificationGasLimit: result.verificationGasLimit,
-            callGasLimit: result.callGasLimit,
-            maxFeePerGas: result.maxFeePerGas,
-            maxPriorityFeePerGas: result.maxPriorityFeePerGas,
-            chain: params.chain,
-        };
-    }
-    /**
-     * Sponsor a bridge transaction (e.g., from BridgeModule or UnifiedBridge).
-     *
-     * Bridge transactions tend to require significant gas on some chains.
-     * Sponsoring allows agents to bridge USDC without holding native gas tokens.
-     */
-    async sponsorBridge(params) {
-        return this.sponsorTransaction({
-            chain: params.chain,
-            from: params.from,
-            to: params.bridgeTx.to,
-            data: params.bridgeTx.data,
-            value: params.bridgeTx.value,
-        });
-    }
-    /**
-     * Encode the `execute(address,uint256,bytes)` call for ERC-4337 account contracts.
-     * This is the standard call format used by SimpleAccount and many ERC-4337 wallets.
-     *
-     * Selector: keccak256("execute(address,uint256,bytes)")[0:4] = 0xb61d27f6
-     */
-    _encodeExecuteCall(to, value, data) {
-        // ABI-encode: execute(address to, uint256 value, bytes calldata data)
-        // We use a manual encoding approach to avoid adding ethers/viem dependency here
-        const selector = '0xb61d27f6';
-        // Pad address (32 bytes)
-        const paddedTo = to.toLowerCase().replace('0x', '').padStart(64, '0');
-        // Pad value (32 bytes)
-        const paddedValue = value.toString(16).padStart(64, '0');
-        // Data offset (32 bytes) — points to 0x60 = 96 bytes offset
-        const dataOffset = '0000000000000000000000000000000000000000000000000000000000000060';
-        // Data length (32 bytes)
-        const dataBytes = data.replace('0x', '');
-        const dataLength = Math.floor(dataBytes.length / 2).toString(16).padStart(64, '0');
-        // Data padded to 32-byte boundary
-        const paddedDataLen = Math.ceil(dataBytes.length / 64) * 64;
-        const paddedData = dataBytes.padEnd(paddedDataLen, '0');
-        return `${selector}${paddedTo}${paddedValue}${dataOffset}${dataLength}${paddedData}`;
-    }
-    /** Make a JSON-RPC request to Alchemy */
-    async _alchemyRpc(url, method, params) {
-        const response = await fetch(url, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                jsonrpc: '2.0',
-                id: 1,
-                method,
-                params,
-            }),
-        });
-        if (!response.ok) {
-            throw new Error(`Alchemy RPC error: HTTP ${response.status} ${response.statusText}`);
-        }
-        const json = (await response.json());
-        if (json.error) {
-            throw new Error(`Alchemy RPC error [${json.error.code}]: ${json.error.message}`);
-        }
-        return json;
-    }
-}
-//# sourceMappingURL=sponsor.js.map

package/dist/gas/sponsor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sponsor.js","sourceRoot":"","sources":["../../src/gas/sponsor.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,4EAA4E;AAC5E,EAAE;AACF,yBAAyB;AACzB,uDAAuD;AACvD,qDAAqD;AACrD,4EAA4E;AAU5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,mBAAmB,GAAG,4CAA4C,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,UAAU;IAGrB,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG;YACZ,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE;YACrE,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE;YACjF,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,mBAAmB;SACrD,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,iBAAiB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED,gCAAgC;IAChC,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAa;QACvB,OAAO,KAAK,IAAI,qBAAqB,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAwB,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAwB;QACvC,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,WAAW,IAAI,qBAAqB,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACzE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAuB;QAC9C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,2CAA2C,MAAM,CAAC,KAAK,KAAK;gBAC5D,qBAAqB,IAAI,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,uCAAuC;gBACvC,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAEzE,sFAAsF;QACtF,MAAM,UAAU,GAA2B;YACzC,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,KAAK,EAAE,KAAK,EAAE,6DAA6D;YAC3E,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC;YAC7E,YAAY,EAAE,KAAK;YACnB,oBAAoB,EAAE,KAAK;YAC3B,kBAAkB,EAAE,KAAK;YACzB,YAAY,EAAE,KAAK;YACnB,oBAAoB,EAAE,KAAK;YAC3B,gBAAgB,EAAE,IAAI;YACtB,SAAS,EAAE,IAAI;SAChB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,uCAAuC,EAAE;YACvF;gBACE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,aAAa,EAAE,UAAU;gBACzB,cAAc,EAAE,IAAI;aACrB;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAOvB,CAAC;QAEF,MAAM,eAAe,GAAkB;YACrC,GAAI,UAA4B;YAChC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;SAClD,CAAC;QAEF,OAAO;YACL,aAAa,EAAE,eAAe;YAC9B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,OAAO,IAAI,CAAC,kBAAkB,CAAC;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;YACtB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YAC1B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,kBAAkB,CAAC,EAAU,EAAE,KAAa,EAAE,IAAY;QAChE,sEAAsE;QACtE,gFAAgF;QAChF,MAAM,QAAQ,GAAG,YAAY,CAAC;QAE9B,yBAAyB;QACzB,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACtE,uBAAuB;QACvB,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,4DAA4D;QAC5D,MAAM,UAAU,GAAG,kEAAkE,CAAC;QACtF,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACnF,kCAAkC;QAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAExD,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;IACvF,CAAC;IAED,yCAAyC;IACjC,KAAK,CAAC,WAAW,CACvB,GAAW,EACX,MAAc,EACd,MAAiB;QAEjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,CAAC;gBACL,MAAM;gBACN,MAAM;aACP,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGlC,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAChE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/gas/types.d.ts

@@ -1,76 +0,0 @@
-export interface GasSponsorConfig {
-    /** Alchemy API key */
-    alchemyApiKey: string;
-    /** Alchemy Gas Manager policy ID for EVM chains — required for EVM gas sponsorship */
-    policyId?: string;
-    /** Alchemy Gas Manager policy ID for Solana — required for Solana gas sponsorship */
-    solanaPolicyId?: string;
-    /** ERC-4337 entry point address (default: v0.6 canonical) */
-    entryPoint?: string;
-}
-/**
- * Default Gas Policy IDs from Alchemy AgentNexus2 app.
- * These are loaded from environment variables at runtime.
- * ENV: ALCHEMY_GAS_POLICY_ETH, ALCHEMY_GAS_POLICY_SOL
- */
-export declare const DEFAULT_GAS_POLICIES: {
-    readonly evm: string;
-    readonly solana: string;
-};
-/**
- * Chains supported by Alchemy Gas Manager.
- * Source: https://www.alchemy.com/docs/wallets/reference/gas-manager-faqs
- * Of our 17 CCTP chains, Alchemy supports: ethereum, base, arbitrum, optimism, polygon, worldchain
- */
-export type GasSupportedChain = 'ethereum' | 'base' | 'arbitrum' | 'optimism' | 'polygon' | 'worldchain';
-/** Alchemy network slug for each supported chain */
-export declare const ALCHEMY_NETWORK_SLUGS: Record<GasSupportedChain, string>;
-/** A UserOperation ready for submission to an ERC-4337 bundler */
-export interface UserOperation {
-    sender: string;
-    nonce: string;
-    initCode: string;
-    callData: string;
-    callGasLimit: string;
-    verificationGasLimit: string;
-    preVerificationGas: string;
-    maxFeePerGas: string;
-    maxPriorityFeePerGas: string;
-    paymasterAndData: string;
-    signature: string;
-}
-/** Result of a sponsored transaction request */
-export interface SponsoredTx {
-    /** The UserOperation with paymaster data filled in */
-    userOperation: UserOperation;
-    /** Gas and paymaster data from Alchemy */
-    paymasterAndData: string;
-    preVerificationGas: string;
-    verificationGasLimit: string;
-    callGasLimit: string;
-    maxFeePerGas: string;
-    maxPriorityFeePerGas: string;
-    /** Chain this was sponsored on */
-    chain: GasSupportedChain;
-}
-/** Parameters for sponsoring a raw transaction */
-export interface SponsorTxParams {
-    chain: GasSupportedChain;
-    /** EOA or smart account sending the tx */
-    from: string;
-    to: string;
-    data: string;
-    value?: bigint;
-}
-/** Parameters for sponsoring a bridge transaction */
-export interface SponsorBridgeParams {
-    chain: GasSupportedChain;
-    /** Raw bridge transaction (from BridgeModule) */
-    bridgeTx: {
-        to: string;
-        data: string;
-        value?: bigint;
-    };
-    from: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/gas/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,YAAY,CAAC;AAEjB,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAOnE,CAAC;AAEF,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,aAAa,EAAE,aAAa,CAAC;IAC7B,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,iBAAiB,CAAC;IACzB,iDAAiD;IACjD,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/gas/types.js

@@ -1,21 +0,0 @@
-// Gas Sponsorship — Types
-// Uses Alchemy's ERC-4337 paymaster API to sponsor gas for agents that don't hold native tokens.
-/**
- * Default Gas Policy IDs from Alchemy AgentNexus2 app.
- * These are loaded from environment variables at runtime.
- * ENV: ALCHEMY_GAS_POLICY_ETH, ALCHEMY_GAS_POLICY_SOL
- */
-export const DEFAULT_GAS_POLICIES = {
-    evm: process.env.ALCHEMY_GAS_POLICY_ETH || '',
-    solana: process.env.ALCHEMY_GAS_POLICY_SOL || '',
-};
-/** Alchemy network slug for each supported chain */
-export const ALCHEMY_NETWORK_SLUGS = {
-    ethereum: 'eth-mainnet',
-    base: 'base-mainnet',
-    arbitrum: 'arb-mainnet',
-    optimism: 'opt-mainnet',
-    polygon: 'polygon-mainnet',
-    worldchain: 'worldchain-mainnet',
-};
-//# sourceMappingURL=types.js.map

package/dist/gas/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gas/types.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,iGAAiG;AAajG;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE;IAC7C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE;CACxC,CAAC;AAeX,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAsC;IACtE,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,iBAAiB;IAC1B,UAAU,EAAE,oBAAoB;CACjC,CAAC"}

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

@@ -1,276 +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.
- */
-/**
- * AgentIdentity — Unified ERC-8004 + ERC-6551 Identity Facade
- *
- * Combines the ERC-8004 Identity Registry (on-chain agent registration / NFT)
- * with the ERC-6551 Token Bound Account (TBA) system into a single, ergonomic
- * class. One call to register your agent, one call to deploy its autonomous wallet,
- * and a single execute() for on-chain actions.
- *
- * Architecture:
- *   AgentIdentity
- *     ├── ERC8004Client  → registers agent NFT, manages off-chain metadata
- *     └── ERC6551Client  → deploys TBA, executes calls from NFT-owned wallet
- *
- * @module identity/agent-identity
- */
-import type { WalletClient, Address, Hex } from 'viem';
-import { ERC8004Client, type AgentRegistrationFile, type RegistrationResult } from './erc8004.js';
-import { ERC6551Client, type TBAAccount, type TBAExecuteParams, type TBAExecuteResult } from './erc6551.js';
-/**
- * Supported chain names for AgentIdentity.
- */
-export type AgentIdentityChain = 'base' | 'base-sepolia' | 'ethereum' | 'arbitrum' | 'polygon';
-/**
- * Configuration for AgentIdentity.
- */
-export interface AgentIdentityConfig {
-    /**
-     * The agent's signing WalletClient (controls the NFT and TBA).
-     * Keys never leave the device — all signing is local.
-     */
-    wallet: WalletClient;
-    /**
-     * Target chain. Defaults to 'base' (Base mainnet).
-     */
-    chain?: AgentIdentityChain;
-    /**
-     * ERC-8004 Identity Registry contract address.
-     * Required for ERC-8004 registration. Omit if only using ERC-6551.
-     */
-    registryAddress?: Address;
-    /**
-     * ERC-6551 registry override. Defaults to canonical registry.
-     * You almost never need to change this.
-     */
-    tbaRegistryAddress?: Address;
-    /**
-     * ERC-6551 account implementation override.
-     * Defaults to Tokenbound reference implementation on Base.
-     */
-    tbaImplementationAddress?: Address;
-    /**
-     * RPC URL override for both ERC-8004 and ERC-6551 clients.
-     */
-    rpcUrl?: string;
-    /**
-     * Salt for TBA derivation. Defaults to 0x000...0.
-     * Change this to create multiple TBAs for the same NFT.
-     */
-    tbaSalt?: Hex;
-}
-/**
- * Full resolved agent identity state.
- */
-export interface AgentIdentityState {
-    /** On-chain ERC-721 agent token ID (null before registration). */
-    agentId: bigint | null;
-    /** TBA address (null before deployTBA()). */
-    tbaAddress: Address | null;
-    /** Whether the ERC-8004 NFT is registered on-chain. */
-    isRegistered: boolean;
-    /** Whether the ERC-6551 TBA is deployed on-chain. */
-    isTBADeployed: boolean;
-    /** NFT owner address (= wallet account address). */
-    owner: Address | null;
-}
-/**
- * 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 declare class AgentIdentity {
-    private readonly wallet;
-    private readonly chain;
-    private readonly tbaSalt;
-    private readonly erc8004;
-    private readonly erc6551;
-    private _agentId;
-    private _nftContract;
-    private _tbaAccount;
-    constructor(config: AgentIdentityConfig);
-    /**
-     * 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
-     */
-    register(metadata: Omit<AgentRegistrationFile, 'type'>, agentURI?: string): Promise<RegistrationResult>;
-    /**
-     * 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: bigint, nftContract?: Address): void;
-    /**
-     * 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())
-     */
-    deployTBA(nftContract?: Address, tokenId?: bigint): Promise<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?: Address, tokenId?: bigint): Address;
-    /**
-     * 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)
-     */
-    loadTBA(nftContract?: Address, tokenId?: bigint): Promise<TBAAccount>;
-    /**
-     * 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],
-     *   }),
-     * });
-     * ```
-     */
-    execute(params: TBAExecuteParams): Promise<TBAExecuteResult>;
-    /**
-     * The agent's ERC-8004 token ID (null before registration).
-     */
-    get agentId(): bigint | null;
-    /**
-     * The agent's TBA address (null before deployTBA() or loadTBA()).
-     */
-    get tbaAddress(): Address | null;
-    /**
-     * Full TBA account details (null before deployTBA() or loadTBA()).
-     */
-    get tbaAccount(): TBAAccount | null;
-    /**
-     * Whether the agent's ERC-8004 NFT is registered.
-     */
-    get isRegistered(): boolean;
-    /**
-     * Whether the agent's TBA is deployed on-chain.
-     */
-    get isTBADeployed(): boolean;
-    /**
-     * The wallet account address (human principal / NFT owner).
-     */
-    get ownerAddress(): Address | null;
-    /**
-     * Full identity state snapshot.
-     */
-    get state(): AgentIdentityState;
-    /**
-     * Direct access to the underlying ERC6551Client for advanced usage.
-     */
-    get erc6551Client(): ERC6551Client;
-    /**
-     * Direct access to the underlying ERC8004Client (null if no registryAddress provided).
-     */
-    get erc8004Client(): ERC8004Client | null;
-}
-//# sourceMappingURL=agent-identity.d.ts.map

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

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