thirdweb 5.84.0-nightly-0fdfb8aa778a344aa847503f668e48feb5f72548-20250115000312 → 5.84.0

package/dist/esm/wallets/engine/index.js

@@ -0,0 +1,140 @@
+import { toHex } from "../../utils/encoding/hex.js";
+/**
+ * Creates an account that uses your engine backend wallet for sending transactions and signing messages.
+ *
+ * @param options - The options for the engine account.
+ * @returns An account that uses your engine backend wallet.
+ *
+ * @beta
+ * @wallet
+ *
+ * @example
+ * ```ts
+ * import { engineAccount } from "thirdweb/wallets/engine";
+ *
+ * const engineAcc = engineAccount({
+ *   engineUrl: "https://engine.thirdweb.com",
+ *   authToken: "your-auth-token",
+ *   walletAddress: "0x...",
+ * });
+ *
+ * // then use the account as you would any other account
+ * const transaction = claimTo({
+ *   contract,
+ *   to: "0x...",
+ *   quantity: 1n,
+ * });
+ * const result = await sendTransaction({ transaction, account: engineAcc });
+ * console.log("Transaction sent:", result.transactionHash);
+ * ```
+ */
+export function engineAccount(options) {
+    const { engineUrl, authToken, walletAddress, chain } = options;
+    // these are shared across all methods
+    const headers = {
+        "x-backend-wallet-address": walletAddress,
+        Authorization: `Bearer ${authToken}`,
+        "Content-Type": "application/json",
+    };
+    return {
+        address: walletAddress,
+        sendTransaction: async (transaction) => {
+            const ENGINE_URL = new URL(engineUrl);
+            ENGINE_URL.pathname = `/backend-wallet/${transaction.chainId}/send-transaction`;
+            const engineData = {
+                // add to address if we have it (is optional to pass to engine)
+                toAddress: transaction.to || undefined,
+                // engine wants a hex string here so we serialize it
+                data: transaction.data || "0x",
+                // value is always required
+                value: toHex(transaction.value ?? 0n),
+            };
+            // TODO: gas overrides etc?
+            const engineRes = await fetch(ENGINE_URL, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(engineData),
+            });
+            if (!engineRes.ok) {
+                const body = await engineRes.text();
+                throw new Error(`Engine request failed with status ${engineRes.status} - ${body}`);
+            }
+            const engineJson = (await engineRes.json());
+            // wait for the queueId to be processed
+            ENGINE_URL.pathname = `/transaction/status/${engineJson.result.queueId}`;
+            const startTime = Date.now();
+            const TIMEOUT_IN_MS = 5 * 60 * 1000; // 5 minutes in milliseconds
+            while (Date.now() - startTime < TIMEOUT_IN_MS) {
+                const queueRes = await fetch(ENGINE_URL, {
+                    method: "GET",
+                    headers,
+                });
+                if (!queueRes.ok) {
+                    const body = await queueRes.text();
+                    throw new Error(`Engine request failed with status ${queueRes.status} - ${body}`);
+                }
+                const queueJSON = (await queueRes.json());
+                if (queueJSON.result.status === "errored" &&
+                    queueJSON.result.errorMessage) {
+                    throw new Error(queueJSON.result.errorMessage);
+                }
+                if (queueJSON.result.transactionHash) {
+                    return {
+                        transactionHash: queueJSON.result.transactionHash,
+                    };
+                }
+                // wait 1s before checking again
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+            }
+            throw new Error("Transaction timed out after 5 minutes");
+        },
+        signMessage: async ({ message }) => {
+            let engineMessage;
+            let isBytes = false;
+            if (typeof message === "string") {
+                engineMessage = message;
+            }
+            else {
+                engineMessage = toHex(message.raw);
+                isBytes = true;
+            }
+            const ENGINE_URL = new URL(engineUrl);
+            ENGINE_URL.pathname = "/backend-wallet/sign-message";
+            const engineRes = await fetch(ENGINE_URL, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    message: engineMessage,
+                    isBytes,
+                    chainId: chain?.id,
+                }),
+            });
+            if (!engineRes.ok) {
+                const body = await engineRes.text();
+                throw new Error(`Engine request failed with status ${engineRes.status} - ${body}`);
+            }
+            const engineJson = (await engineRes.json());
+            return engineJson.result;
+        },
+        signTypedData: async (_typedData) => {
+            const ENGINE_URL = new URL(engineUrl);
+            ENGINE_URL.pathname = "/backend-wallet/sign-typed-data";
+            const engineRes = await fetch(ENGINE_URL, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    domain: _typedData.domain,
+                    types: _typedData.types,
+                    value: _typedData.message,
+                }),
+            });
+            if (!engineRes.ok) {
+                engineRes.body?.cancel();
+                throw new Error(`Engine request failed with status ${engineRes.status}`);
+            }
+            const engineJson = (await engineRes.json());
+            return engineJson.result;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/wallets/engine/index.js.map

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

package/dist/esm/wallets/smart/lib/signing.js

@@ -214,7 +214,7 @@ async function checkFor712Factory({ factoryContract, accountContract, originalMs
  * });
  * ```
  *
- * @wallets
+ * @wallet
  */
 export async function deploySmartAccount(args) {
     const { chain, client, smartAccount, accountContract } = args;

package/dist/types/ai/chat.d.ts

@@ -0,0 +1,24 @@
+import { type Input, type Output } from "./common.js";
+/**
+ * Chat with Nebula.
+ *
+ * @param input - The input for the chat.
+ * @returns The chat response.
+ * @beta
+ * @nebula
+ *
+ * @example
+ * ```ts
+ * import { Nebula } from "thirdweb/ai";
+ *
+ * const response = await Nebula.chat({
+ *   client: TEST_CLIENT,
+ *   prompt: "What's the symbol of this contract: 0xe2cb0eb5147b42095c2FfA6F7ec953bb0bE347D8",
+ *   context: {
+ *     chains: [sepolia],
+ *   },
+ * });
+ * ```
+ */
+export declare function chat(input: Input): Promise<Output>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/types/ai/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/ai/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAExD"}

package/dist/types/ai/common.d.ts

@@ -0,0 +1,22 @@
+import type { Chain } from "../chains/types.js";
+import type { ThirdwebClient } from "../client/client.js";
+import { type PreparedTransaction } from "../transaction/prepare-transaction.js";
+import type { Account } from "../wallets/interfaces/wallet.js";
+export type Input = {
+    client: ThirdwebClient;
+    prompt: string | string[];
+    account?: Account;
+    context?: {
+        chains?: Chain[];
+        walletAddresses?: string[];
+        contractAddresses?: string[];
+    };
+    sessionId?: string;
+};
+export type Output = {
+    message: string;
+    sessionId: string;
+    transactions: PreparedTransaction[];
+};
+export declare function nebulaFetch(mode: "execute" | "chat", input: Input): Promise<Output>;
+//# sourceMappingURL=common.d.ts.map

package/dist/types/ai/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/ai/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAI/D,MAAM,MAAM,KAAK,GAAG;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,mBAAmB,EAAE,CAAC;CACrC,CAAC;AAYF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,SAAS,GAAG,MAAM,EACxB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,MAAM,CAAC,CAmEjB"}

package/dist/types/ai/execute.d.ts

@@ -0,0 +1,29 @@
+import type { SendTransactionResult } from "../transaction/types.js";
+import type { Account } from "../wallets/interfaces/wallet.js";
+import { type Input } from "./common.js";
+/**
+ * Execute a transaction based on a prompt.
+ *
+ * @param input - The input for the transaction.
+ * @returns The transaction hash.
+ * @beta
+ * @nebula
+ *
+ * @example
+ * ```ts
+ * import { Nebula } from "thirdweb/ai";
+ *
+ * const result = await Nebula.execute({
+ *   client: TEST_CLIENT,
+ *   prompt: "send 0.0001 ETH to vitalik.eth",
+ *   account: TEST_ACCOUNT_A,
+ *   context: {
+ *     chains: [sepolia],
+ *   },
+ * });
+ * ```
+ */
+export declare function execute(input: Input & {
+    account: Account;
+}): Promise<SendTransactionResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/types/ai/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/ai/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,KAAK,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAchC"}

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

@@ -0,0 +1,4 @@
+export { chat } from "./chat.js";
+export { execute } from "./execute.js";
+export type { Input, Output } from "./common.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/exports/ai.d.ts

@@ -0,0 +1,2 @@
+export * as Nebula from "../ai/index.js";
+//# sourceMappingURL=ai.d.ts.map

package/dist/types/exports/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/exports/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC"}

package/dist/types/exports/wallets/engine.d.ts

@@ -0,0 +1,2 @@
+export { type EngineAccountOptions, engineAccount, } from "../../wallets/engine/index.js";
+//# sourceMappingURL=engine.d.ts.map

package/dist/types/exports/wallets/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/exports/wallets/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,aAAa,GACd,MAAM,+BAA+B,CAAC"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "5.84.0-nightly-0fdfb8aa778a344aa847503f668e48feb5f72548-20250115000312";
+export declare const version = "5.84.0";
 //# sourceMappingURL=version.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,2EAA2E,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/dist/types/wallets/engine/index.d.ts

@@ -0,0 +1,54 @@
+import type { Chain } from "../../chains/types.js";
+import type { Account } from "../interfaces/wallet.js";
+/**
+ * Options for creating an engine account.
+ */
+export type EngineAccountOptions = {
+    /**
+     * The URL of your engine instance.
+     */
+    engineUrl: string;
+    /**
+     * The auth token to use with the engine instance.
+     */
+    authToken: string;
+    /**
+     * The backend wallet to use for sending transactions inside engine.
+     */
+    walletAddress: string;
+    /**
+     * The chain to use for signing messages and typed data (smart backend wallet only).
+     */
+    chain?: Chain;
+};
+/**
+ * Creates an account that uses your engine backend wallet for sending transactions and signing messages.
+ *
+ * @param options - The options for the engine account.
+ * @returns An account that uses your engine backend wallet.
+ *
+ * @beta
+ * @wallet
+ *
+ * @example
+ * ```ts
+ * import { engineAccount } from "thirdweb/wallets/engine";
+ *
+ * const engineAcc = engineAccount({
+ *   engineUrl: "https://engine.thirdweb.com",
+ *   authToken: "your-auth-token",
+ *   walletAddress: "0x...",
+ * });
+ *
+ * // then use the account as you would any other account
+ * const transaction = claimTo({
+ *   contract,
+ *   to: "0x...",
+ *   quantity: 1n,
+ * });
+ * const result = await sendTransaction({ transaction, account: engineAcc });
+ * console.log("Transaction sent:", result.transactionHash);
+ * ```
+ */
+export declare function engineAccount(options: EngineAccountOptions): Account;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/wallets/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,KAAK,EAAE,OAAO,EAAyB,MAAM,yBAAyB,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CA6IpE"}

package/dist/types/wallets/smart/lib/signing.d.ts

@@ -48,7 +48,7 @@ export declare function confirmContractDeployment(args: {
  * });
  * ```
  *
- * @wallets
+ * @wallet
  */
 export declare function deploySmartAccount(args: {
     smartAccount: Account;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thirdweb",
-  "version": "5.84.0-nightly-0fdfb8aa778a344aa847503f668e48feb5f72548-20250115000312",
+  "version": "5.84.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/thirdweb-dev/js.git#main"
@@ -123,6 +123,11 @@
       "import": "./dist/esm/exports/social.js",
       "default": "./dist/cjs/exports/social.js"
     },
+    "./ai": {
+      "types": "./dist/types/exports/ai.d.ts",
+      "import": "./dist/esm/exports/ai.js",
+      "default": "./dist/cjs/exports/ai.js"
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {
@@ -180,6 +185,9 @@
       ],
       "social": [
         "./dist/types/exports/social.d.ts"
+      ],
+      "ai": [
+        "./dist/types/exports/ai.d.ts"
       ]
     }
   },

package/src/ai/chat.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import { TEST_CLIENT } from "../../test/src/test-clients.js";
+import { TEST_ACCOUNT_A, TEST_ACCOUNT_B } from "../../test/src/test-wallets.js";
+import { sepolia } from "../chains/chain-definitions/sepolia.js";
+import * as Nebula from "./index.js";
+
+describe.runIf(process.env.TW_SECRET_KEY)("chat", () => {
+  it("should respond with a message", async () => {
+    const response = await Nebula.chat({
+      client: TEST_CLIENT,
+      prompt: `What's the symbol of this contract: 0xe2cb0eb5147b42095c2FfA6F7ec953bb0bE347D8`,
+      context: {
+        chains: [sepolia],
+      },
+    });
+    expect(response.message).toContain("CAT");
+  });
+
+  it("should respond with a transaction", async () => {
+    const response = await Nebula.chat({
+      client: TEST_CLIENT,
+      prompt: `send 0.0001 ETH on sepolia to ${TEST_ACCOUNT_B.address}`,
+      account: TEST_ACCOUNT_A,
+      context: {
+        chains: [sepolia],
+        walletAddresses: [TEST_ACCOUNT_A.address],
+      },
+    });
+    expect(response.transactions.length).toBe(1);
+  });
+});

package/src/ai/chat.ts

@@ -0,0 +1,26 @@
+import { type Input, type Output, nebulaFetch } from "./common.js";
+
+/**
+ * Chat with Nebula.
+ *
+ * @param input - The input for the chat.
+ * @returns The chat response.
+ * @beta
+ * @nebula
+ *
+ * @example
+ * ```ts
+ * import { Nebula } from "thirdweb/ai";
+ *
+ * const response = await Nebula.chat({
+ *   client: TEST_CLIENT,
+ *   prompt: "What's the symbol of this contract: 0xe2cb0eb5147b42095c2FfA6F7ec953bb0bE347D8",
+ *   context: {
+ *     chains: [sepolia],
+ *   },
+ * });
+ * ```
+ */
+export async function chat(input: Input): Promise<Output> {
+  return nebulaFetch("chat", input);
+}

package/src/ai/common.ts

@@ -0,0 +1,114 @@
+import type { Chain } from "../chains/types.js";
+import { getCachedChain } from "../chains/utils.js";
+import type { ThirdwebClient } from "../client/client.js";
+import {
+  type PreparedTransaction,
+  prepareTransaction,
+} from "../transaction/prepare-transaction.js";
+import type { Address } from "../utils/address.js";
+import { toBigInt } from "../utils/bigint.js";
+import type { Hex } from "../utils/encoding/hex.js";
+import { getClientFetch } from "../utils/fetch.js";
+import type { Account } from "../wallets/interfaces/wallet.js";
+
+const NEBULA_API_URL = "https://nebula-api.thirdweb.com";
+
+export type Input = {
+  client: ThirdwebClient;
+  prompt: string | string[];
+  account?: Account;
+  context?: {
+    chains?: Chain[];
+    walletAddresses?: string[];
+    contractAddresses?: string[];
+  };
+  sessionId?: string;
+};
+
+export type Output = {
+  message: string;
+  sessionId: string;
+  transactions: PreparedTransaction[];
+};
+
+type ApiResponse = {
+  message: string;
+  session_id: string;
+  actions?: {
+    type: "init" | "presence" | "sign_transaction";
+    source: string;
+    data: string;
+  }[];
+};
+
+export async function nebulaFetch(
+  mode: "execute" | "chat",
+  input: Input,
+): Promise<Output> {
+  const fetch = getClientFetch(input.client);
+  const response = await fetch(`${NEBULA_API_URL}/${mode}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      message: input.prompt, // TODO: support array of messages
+      session_id: input.sessionId,
+      ...(input.account
+        ? {
+            execute_config: {
+              mode: "client",
+              signer_wallet_address: input.account.address,
+            },
+          }
+        : {}),
+      ...(input.context
+        ? {
+            context_filter: {
+              chain_ids:
+                input.context.chains?.map((c) => c.id.toString()) || [],
+              signer_wallet_address: input.context.walletAddresses || [],
+              contract_addresses: input.context.contractAddresses || [],
+            },
+          }
+        : {}),
+    }),
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`Nebula API error: ${error}`);
+  }
+  const data = (await response.json()) as ApiResponse;
+
+  // parse transactions if present
+  let transactions: PreparedTransaction[] = [];
+  if (data.actions) {
+    transactions = data.actions
+      .map((action) => {
+        // only parse sign_transaction actions
+        if (action.type === "sign_transaction") {
+          const tx = JSON.parse(action.data) as {
+            chainId: number;
+            to: Address | undefined;
+            value: Hex;
+            data: Hex;
+          };
+          return prepareTransaction({
+            chain: getCachedChain(tx.chainId),
+            client: input.client,
+            to: tx.to,
+            value: tx.value ? toBigInt(tx.value) : undefined,
+            data: tx.data,
+          });
+        }
+        return undefined;
+      })
+      .filter((tx) => tx !== undefined);
+  }
+
+  return {
+    message: data.message,
+    sessionId: data.session_id,
+    transactions,
+  };
+}

package/src/ai/execute.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it } from "vitest";
+import { TEST_CLIENT } from "../../test/src/test-clients.js";
+import { TEST_ACCOUNT_A, TEST_ACCOUNT_B } from "../../test/src/test-wallets.js";
+import { sepolia } from "../chains/chain-definitions/sepolia.js";
+import { getContract } from "../contract/contract.js";
+import * as Nebula from "./index.js";
+
+describe("execute", () => {
+  it("should execute a tx", async () => {
+    await expect(
+      Nebula.execute({
+        client: TEST_CLIENT,
+        prompt: `send 0.0001 ETH to ${TEST_ACCOUNT_B.address}`,
+        account: TEST_ACCOUNT_A,
+        context: {
+          chains: [sepolia],
+          walletAddresses: [TEST_ACCOUNT_A.address],
+        },
+      }),
+    ).rejects.toThrow(/insufficient funds for gas/); // shows that the tx was sent
+  });
+
+  // TODO make this work reliably
+  it.skip("should execute a contract call", async () => {
+    const nftContract = getContract({
+      client: TEST_CLIENT,
+      chain: sepolia,
+      address: "0xe2cb0eb5147b42095c2FfA6F7ec953bb0bE347D8",
+    });
+
+    const response = await Nebula.execute({
+      client: TEST_CLIENT,
+      prompt: `approve 1 token of token id 0 to ${TEST_ACCOUNT_B.address} using the approve function`,
+      account: TEST_ACCOUNT_A,
+      context: {
+        chains: [nftContract.chain],
+        walletAddresses: [TEST_ACCOUNT_A.address],
+        contractAddresses: [nftContract.address],
+      },
+    });
+    expect(response.transactionHash).toBeDefined();
+  });
+});

package/src/ai/execute.ts

@@ -0,0 +1,44 @@
+import { sendTransaction } from "../transaction/actions/send-transaction.js";
+import type { SendTransactionResult } from "../transaction/types.js";
+import type { Account } from "../wallets/interfaces/wallet.js";
+import { type Input, nebulaFetch } from "./common.js";
+
+/**
+ * Execute a transaction based on a prompt.
+ *
+ * @param input - The input for the transaction.
+ * @returns The transaction hash.
+ * @beta
+ * @nebula
+ *
+ * @example
+ * ```ts
+ * import { Nebula } from "thirdweb/ai";
+ *
+ * const result = await Nebula.execute({
+ *   client: TEST_CLIENT,
+ *   prompt: "send 0.0001 ETH to vitalik.eth",
+ *   account: TEST_ACCOUNT_A,
+ *   context: {
+ *     chains: [sepolia],
+ *   },
+ * });
+ * ```
+ */
+export async function execute(
+  input: Input & { account: Account },
+): Promise<SendTransactionResult> {
+  const result = await nebulaFetch("execute", input);
+  // TODO: optionally only return the transaction without executing it?
+  if (result.transactions.length === 0) {
+    throw new Error(result.message);
+  }
+  const tx = result.transactions[0];
+  if (!tx) {
+    throw new Error(result.message);
+  }
+  return sendTransaction({
+    transaction: tx,
+    account: input.account,
+  });
+}

package/src/ai/index.ts

@@ -0,0 +1,3 @@
+export { chat } from "./chat.js";
+export { execute } from "./execute.js";
+export type { Input, Output } from "./common.js";

package/src/exports/ai.ts

@@ -0,0 +1 @@
+export * as Nebula from "../ai/index.js";

package/src/exports/wallets/engine.ts

@@ -0,0 +1,4 @@
+export {
+  type EngineAccountOptions,
+  engineAccount,
+} from "../../wallets/engine/index.js";

package/src/version.ts

@@ -1 +1 @@
-export const version = "5.84.0-nightly-0fdfb8aa778a344aa847503f668e48feb5f72548-20250115000312";
+export const version = "5.84.0";