alchemy 0.69.1 → 0.70.0

package/lib/coinbase/evm-account.js

@@ -0,0 +1,198 @@
+import { Resource } from "../resource.js";
+import { createCdpClient } from "./client.js";
+import { validateAccountName } from "./utils.js";
+/**
+ * Manages EVM EOA (Externally Owned Accounts) on Coinbase Developer Platform.
+ *
+ * @example
+ * ## Create a new EVM account
+ *
+ * ```ts
+ * const account = await EvmAccount("my-account", {
+ *   name: "my-account"
+ * });
+ *
+ * console.log("Account address:", account.address);
+ * ```
+ *
+ * @example
+ * ## Create account with funding metadata
+ *
+ * Declare what tokens this account needs for development
+ *
+ * ```ts
+ * const account = await EvmAccount("test-account", {
+ *   name: "test-account",
+ *   faucet: {
+ *     "base-sepolia": ["eth", "usdc"],
+ *     "ethereum-sepolia": ["eth"]
+ *   }
+ * });
+ *
+ * // Account automatically requests tokens on creation
+ * // The faucet script can be used for bulk funding operations
+ * ```
+ *
+ * @example
+ * ## Import an existing account
+ *
+ * Import an existing EVM account using a private key
+ *
+ * ```ts
+ * const account = await EvmAccount("imported-account", {
+ *   name: "imported-account",
+ *   privateKey: alchemy.secret(process.env.COINBASE_PRIVATE_KEY)
+ * });
+ * ```
+ *
+ * @example
+ * ## Adopt an existing account
+ *
+ * Use an existing account with the same name if it exists
+ *
+ * ```ts
+ * const account = await EvmAccount("my-account", {
+ *   name: "existing-account",
+ *   adopt: true // Uses existing account if it exists
+ * });
+ * ```
+ */
+export const EvmAccount = Resource("coinbase::evm-account", async function (_id, props) {
+    // Validate account name format
+    validateAccountName(props.name);
+    // Initialize CDP client with credentials from props or environment
+    const cdp = await createCdpClient({
+        apiKeyId: props.apiKeyId,
+        apiKeySecret: props.apiKeySecret,
+        walletSecret: props.walletSecret,
+    });
+    // Handle update phase
+    if (this.phase === "update" && this.output) {
+        // Only name can be updated
+        if (props.name !== this.output.name) {
+            // CDP SDK supports updating account names via updateAccount
+            await cdp.evm.updateAccount({
+                address: this.output.address,
+                update: {
+                    name: props.name,
+                },
+            });
+            return {
+                ...this.output,
+                name: props.name, // Use the requested name
+                faucet: props.faucet,
+            };
+        }
+        // Update faucet configuration if changed
+        if (JSON.stringify(props.faucet) !== JSON.stringify(this.output.faucet)) {
+            // Only fund NEW combinations that weren't in the previous config
+            try {
+                // Get all old combinations
+                const oldCombinations = new Set(Object.entries(this.output.faucet ?? {}).flatMap(([network, tokens]) => tokens.map((token) => `${network}:${token}`)));
+                // Get all new combinations
+                const newCombinations = Object.entries(props.faucet ?? {}).flatMap(([network, tokens]) => tokens.map((token) => ({
+                    network: network,
+                    token: token,
+                    key: `${network}:${token}`,
+                })));
+                // Filter to only combinations that are actually new
+                const toFund = newCombinations.filter(({ key }) => !oldCombinations.has(key));
+                if (toFund.length > 0) {
+                    await Promise.all(toFund.map(({ network, token }) => cdp.evm
+                        .requestFaucet({
+                        address: this.output.address,
+                        network,
+                        token,
+                    })
+                        .catch((err) => {
+                        console.warn(`⚠️ Failed to request ${token} on ${network} for ${this.output.address}: ${err.message}`);
+                        return null;
+                    })));
+                    console.log(`💧 Requested ${toFund.length} new faucet fund${toFund.length === 1 ? "" : "s"} for ${this.output.address}`);
+                }
+            }
+            catch (error) {
+                console.warn(`⚠️ Failed to request additional faucet funds for ${this.output.address}: ${error.message}`);
+                // Continue - don't break the update
+            }
+            return {
+                ...this.output,
+                faucet: props.faucet,
+            };
+        }
+        return this.output;
+    }
+    // Handle delete phase
+    if (this.phase === "delete") {
+        // CDP SDK doesn't support deleting accounts
+        // Accounts remain in CDP but are no longer tracked by Alchemy
+        console.log(`🗑️ Untracking EVM Account: ${this.output.address}`);
+        return this.destroy();
+    }
+    let account;
+    // Handle account creation/retrieval
+    if (props.privateKey) {
+        // Import account with private key
+        // This is idempotent in CDP
+        account = await cdp.evm.importAccount({
+            privateKey: props.privateKey.unencrypted,
+            name: props.name,
+        });
+    }
+    else {
+        // Check for adoption or use getOrCreate pattern
+        const adopt = props.adopt ?? this.scope.adopt;
+        if (adopt) {
+            // With adoption, use getOrCreate which returns existing if it exists
+            account = await cdp.evm.getOrCreateAccount({
+                name: props.name,
+            });
+        }
+        else {
+            // Without adoption, we can attempt to create it.
+            // It will throw if already exist
+            try {
+                account = await cdp.evm.createAccount({ name: props.name });
+            }
+            catch (error) {
+                // Provide helpful error message if account already exists
+                if (error.errorType === "already_exists") {
+                    throw new Error(`Account with name '${props.name}' already exists. Use adopt: true to use the existing account.`);
+                }
+                // Rethrow other errors unchanged
+                throw error;
+            }
+        }
+    }
+    // Fund the account if faucet configuration is provided
+    if (props.faucet) {
+        try {
+            const combinations = Object.entries(props.faucet).flatMap(([network, tokens]) => tokens.map((token) => ({
+                network: network,
+                token: token,
+            })));
+            await Promise.all(combinations.map(({ network, token }) => cdp.evm
+                .requestFaucet({
+                address: account.address,
+                network,
+                token,
+            })
+                .catch((err) => {
+                console.warn(`⚠️ Failed to request ${token} on ${network} for ${account.address}: ${err.message}`);
+                return null;
+            })));
+            console.log(`💧 Requested faucet funds for ${account.address}`);
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to request faucet funds for ${account.address}: ${error.message}`);
+            // Continue - don't break account creation
+        }
+    }
+    // Return account details
+    return {
+        name: props.name, // Always use the name from props for consistency
+        address: account.address,
+        faucet: props.faucet,
+    };
+});
+//# sourceMappingURL=evm-account.js.map

package/lib/coinbase/evm-account.js.map

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

package/lib/coinbase/evm-smart-account.d.ts

@@ -0,0 +1,122 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import { type CoinbaseClientOptions } from "./client.ts";
+import type { EvmAccount } from "./evm-account.ts";
+import type { Address, FaucetConfig } from "./types.ts";
+export interface EvmSmartAccountProps extends CoinbaseClientOptions {
+    /**
+     * Name for the smart account.
+     * If not provided, inherits the name from the owner account.
+     * This allows EOA and Smart Account to have matching names in CDP.
+     * Used for identification in CDP.
+     * Must contain only letters, numbers, and hyphens.
+     * @default Inherits from owner account name
+     */
+    name?: string;
+    /**
+     * The owner account that controls this smart account.
+     * Can be either an EvmAccount resource or an owner address.
+     */
+    owner: EvmAccount | Address;
+    /**
+     * Whether to adopt an existing smart account with the same name if it already exists.
+     * Without adoption, creation will fail if a smart account with the same name exists.
+     * With adoption, the existing smart account will be used.
+     * @default false
+     */
+    adopt?: boolean;
+    /**
+     * Faucet configuration for development funding.
+     * Declares which tokens this smart account should have.
+     * Used by external funding scripts - not processed by the resource.
+     *
+     * @example
+     * ```ts
+     * faucet: {
+     *   "base-sepolia": ["eth", "usdc"],
+     *   "ethereum-sepolia": ["eth"]
+     * }
+     * ```
+     */
+    faucet?: FaucetConfig;
+}
+export interface EvmSmartAccount extends Resource<"coinbase::evm-smart-account"> {
+    /**
+     * The smart account name in CDP
+     */
+    name: string;
+    /**
+     * The smart account address (same across all EVM networks)
+     */
+    address: Address;
+    /**
+     * The owner account address
+     */
+    ownerAddress: Address;
+    /**
+     * Faucet configuration (passed through from props)
+     */
+    faucet?: FaucetConfig;
+}
+/**
+ * Manages ERC-4337 smart accounts on Coinbase Developer Platform.
+ * Smart accounts enable gasless transactions and advanced features like batch operations.
+ *
+ * @example
+ * ## Create a smart account with an EVM account owner
+ *
+ * ```ts
+ * const owner = await EvmAccount("owner", {
+ *   name: "owner-account"
+ * });
+ *
+ * const smartAccount = await EvmSmartAccount("my-smart-account", {
+ *   name: "my-smart-account",
+ *   owner: owner
+ * });
+ *
+ * console.log("Smart account address:", smartAccount.address);
+ * ```
+ *
+ * @example
+ * ## Create a smart account with existing owner
+ *
+ * ```ts
+ * const smartAccount = await EvmSmartAccount("my-smart-account", {
+ *   name: "my-smart-account",
+ *   owner: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb" // Owner address
+ * });
+ * ```
+ *
+ * @example
+ * ## Smart account with inherited name
+ *
+ * When name is omitted, the smart account inherits the owner's name
+ *
+ * ```ts
+ * const owner = await EvmAccount("owner", {
+ *   name: "my-app-wallet"
+ * });
+ *
+ * // Smart account will also be named "my-app-wallet" in CDP
+ * const smartAccount = await EvmSmartAccount("smart", {
+ *   owner: owner
+ *   // name is omitted, inherits "my-app-wallet" from owner
+ * });
+ *
+ * console.log(smartAccount.name); // "my-app-wallet"
+ * ```
+ *
+ * @example
+ * ## Adopt an existing smart account
+ *
+ * ```ts
+ * const smartAccount = await EvmSmartAccount("my-smart-account", {
+ *   name: "existing-smart-account",
+ *   owner: ownerAccount, // or "0x..." address
+ *   adopt: true // Uses existing smart account if it exists
+ * });
+ * ```
+ */
+export declare const EvmSmartAccount: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<EvmSmartAccount>, _id: string, props: EvmSmartAccountProps) => Promise<EvmSmartAccount>);
+//# sourceMappingURL=evm-smart-account.d.ts.map

package/lib/coinbase/evm-smart-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-smart-account.d.ts","sourceRoot":"","sources":["../../src/coinbase/evm-smart-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EAGb,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,eACf,SAAQ,QAAQ,CAAC,6BAA6B,CAAC;IAC/C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,eAAO,MAAM,eAAe,yFAGlB,OAAO,CAAC,eAAe,CAAC,OACzB,MAAM,SACJ,oBAAoB,KAC1B,OAAO,CAAC,eAAe,CAAC,CA0M5B,CAAC"}

package/lib/coinbase/evm-smart-account.js

@@ -0,0 +1,213 @@
+import { Resource } from "../resource.js";
+import { createCdpClient } from "./client.js";
+import { validateAccountName } from "./utils.js";
+/**
+ * Manages ERC-4337 smart accounts on Coinbase Developer Platform.
+ * Smart accounts enable gasless transactions and advanced features like batch operations.
+ *
+ * @example
+ * ## Create a smart account with an EVM account owner
+ *
+ * ```ts
+ * const owner = await EvmAccount("owner", {
+ *   name: "owner-account"
+ * });
+ *
+ * const smartAccount = await EvmSmartAccount("my-smart-account", {
+ *   name: "my-smart-account",
+ *   owner: owner
+ * });
+ *
+ * console.log("Smart account address:", smartAccount.address);
+ * ```
+ *
+ * @example
+ * ## Create a smart account with existing owner
+ *
+ * ```ts
+ * const smartAccount = await EvmSmartAccount("my-smart-account", {
+ *   name: "my-smart-account",
+ *   owner: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb" // Owner address
+ * });
+ * ```
+ *
+ * @example
+ * ## Smart account with inherited name
+ *
+ * When name is omitted, the smart account inherits the owner's name
+ *
+ * ```ts
+ * const owner = await EvmAccount("owner", {
+ *   name: "my-app-wallet"
+ * });
+ *
+ * // Smart account will also be named "my-app-wallet" in CDP
+ * const smartAccount = await EvmSmartAccount("smart", {
+ *   owner: owner
+ *   // name is omitted, inherits "my-app-wallet" from owner
+ * });
+ *
+ * console.log(smartAccount.name); // "my-app-wallet"
+ * ```
+ *
+ * @example
+ * ## Adopt an existing smart account
+ *
+ * ```ts
+ * const smartAccount = await EvmSmartAccount("my-smart-account", {
+ *   name: "existing-smart-account",
+ *   owner: ownerAccount, // or "0x..." address
+ *   adopt: true // Uses existing smart account if it exists
+ * });
+ * ```
+ */
+export const EvmSmartAccount = Resource("coinbase::evm-smart-account", async function (_id, props) {
+    // Initialize CDP client with credentials from props or environment
+    const cdp = await createCdpClient({
+        apiKeyId: props.apiKeyId,
+        apiKeySecret: props.apiKeySecret,
+        walletSecret: props.walletSecret,
+    });
+    // Get owner address
+    const ownerAddress = typeof props.owner === "string" ? props.owner : props.owner.address;
+    // Get owner account for CDP operations
+    // When owner is an address string, we use it to get the account
+    const ownerAccount = typeof props.owner === "string"
+        ? await cdp.evm.getAccount({ address: props.owner })
+        : await cdp.evm.getAccount({ address: props.owner.address });
+    // If no name provided, inherit from owner
+    // this mean that if you pass only { owner } the created smartAccount will be same name as the EOA owner
+    // this to support https://github.com/base/account-sdk/blob/master/packages/account-sdk/src/interface/payment/charge.ts#L120
+    let accountName = props.name ? props.name : ownerAccount.name;
+    if (!accountName) {
+        throw new Error(`Smart account requires a name. Either provide 'name' in props or ensure the owner account has a name. Owner address: ${ownerAddress}`);
+    }
+    // Validate account name format
+    validateAccountName(accountName);
+    // Handle update phase
+    if (this.phase === "update" && this.output) {
+        // Check if owner changed (which would require replacement)
+        if (ownerAddress !== this.output.ownerAddress) {
+            this.replace();
+        }
+        // Check if name changed
+        if (accountName !== this.output.name) {
+            await cdp.evm.updateSmartAccount({
+                address: this.output.address,
+                owner: ownerAccount,
+                update: {
+                    name: accountName,
+                },
+            });
+            return {
+                ...this.output,
+                name: accountName,
+                // faucet: props.faucet, not sure we need this?
+            };
+        }
+        // Update faucet configuration if changed
+        if (JSON.stringify(props.faucet) !== JSON.stringify(this.output.faucet)) {
+            // Only fund NEW combinations that weren't in the previous config
+            try {
+                // Get all old combinations
+                const oldCombinations = new Set(Object.entries(this.output.faucet ?? {}).flatMap(([network, tokens]) => tokens.map((token) => `${network}:${token}`)));
+                // Get all new combinations
+                const newCombinations = Object.entries(props.faucet ?? {}).flatMap(([network, tokens]) => tokens.map((token) => ({
+                    network: network,
+                    token: token,
+                    key: `${network}:${token}`,
+                })));
+                // Filter to only combinations that are actually new
+                const toFund = newCombinations.filter(({ key }) => !oldCombinations.has(key));
+                if (toFund.length > 0) {
+                    await Promise.all(toFund.map(({ network, token }) => cdp.evm
+                        .requestFaucet({
+                        address: this.output.address,
+                        network,
+                        token,
+                    })
+                        .catch((err) => {
+                        console.warn(`⚠️ Failed to request ${token} on ${network} for smart account ${this.output.address}: ${err.message}`);
+                        return null;
+                    })));
+                    console.log(`💧 Requested ${toFund.length} new faucet fund${toFund.length === 1 ? "" : "s"} for smart account ${this.output.address}`);
+                }
+            }
+            catch (error) {
+                console.warn(`⚠️ Failed to request additional faucet funds for smart account ${this.output.address}: ${error.message}`);
+                // Continue - don't break the update
+            }
+            return {
+                ...this.output,
+                faucet: props.faucet,
+            };
+        }
+        return this.output;
+    }
+    // Handle delete phase
+    if (this.phase === "delete") {
+        // CDP SDK doesn't support deleting accounts
+        // Accounts remain in CDP but are no longer tracked by Alchemy
+        console.log(`🗑️ Untracking Smart Account: ${this.output?.address}`);
+        return this.destroy();
+    }
+    let smartAccount;
+    // Check for adoption or use getOrCreate pattern
+    const adopt = props.adopt ?? this.scope.adopt;
+    if (adopt) {
+        // With adoption, use getOrCreateSmartAccount which returns existing if it exists
+        smartAccount = await cdp.evm.getOrCreateSmartAccount({
+            name: accountName,
+            owner: ownerAccount,
+        });
+    }
+    else {
+        // Without adoption, create a new smart account
+        try {
+            smartAccount = await cdp.evm.createSmartAccount({
+                name: accountName,
+                owner: ownerAccount,
+            });
+        }
+        catch (error) {
+            // Provide helpful error message if smart account already exists
+            if (error.errorType === "already_exists") {
+                throw new Error(`Smart account with name '${accountName}' already exists. Use adopt: true to use the existing smart account.`);
+            }
+            // Rethrow other errors unchanged
+            throw error;
+        }
+    }
+    // Fund the smart account if faucet configuration is provided
+    if (props.faucet) {
+        try {
+            const combinations = Object.entries(props.faucet).flatMap(([network, tokens]) => tokens.map((token) => ({
+                network: network,
+                token: token,
+            })));
+            await Promise.all(combinations.map(({ network, token }) => cdp.evm
+                .requestFaucet({
+                address: smartAccount.address,
+                network,
+                token,
+            })
+                .catch((err) => {
+                console.warn(`⚠️ Failed to request ${token} on ${network} for smart account ${smartAccount.address}: ${err.message}`);
+                return null;
+            })));
+            console.log(`💧 Requested faucet funds for smart account ${smartAccount.address}`);
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to request faucet funds for smart account ${smartAccount.address}: ${error.message}`);
+            // Continue - don't break account creation
+        }
+    }
+    // Return smart account details
+    return {
+        name: accountName,
+        address: smartAccount.address,
+        ownerAddress,
+        faucet: props.faucet,
+    };
+});
+//# sourceMappingURL=evm-smart-account.js.map

package/lib/coinbase/evm-smart-account.js.map

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

package/lib/coinbase/faucet.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env bun
+/**
+ * Request testnet tokens from Coinbase faucet for accounts with faucet metadata
+ *
+ * Usage:
+ *   bun node_modules/alchemy/src/coinbase/faucet.ts              # Fund all accounts with faucet config
+ *   bun node_modules/alchemy/src/coinbase/faucet.ts dev          # Fund only accounts in dev scope
+ *   bun node_modules/alchemy/src/coinbase/faucet.ts backend/dev  # Fund specific scope
+ */
+export {};
+//# sourceMappingURL=faucet.d.ts.map

package/lib/coinbase/faucet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faucet.d.ts","sourceRoot":"","sources":["../../src/coinbase/faucet.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}