thirdweb 5.84.0-nightly-0fdfb8aa778a344aa847503f668e48feb5f72548-20250115000312 → 5.85.0

package/dist/types/react/web/ui/prebuilt/NFT/media.d.ts

@@ -113,10 +113,11 @@ export declare function NFTMedia({ loadingComponent, fallbackComponent, queryOpt
  * @internal
  */
 export declare function getQueryKey(props: {
+    contractAddress: string;
     chainId: number;
     tokenId: bigint;
     mediaResolver?: NFTMediaInfo | (() => NFTMediaInfo) | (() => Promise<NFTMediaInfo>);
-}): readonly ["_internal_nft_media_", number, string, {
+}): readonly ["_internal_nft_media_", number, string, string, {
     readonly resolver: string | NFTMediaInfo | undefined;
 }];
 /**

package/dist/types/react/web/ui/prebuilt/NFT/media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../../../../src/react/web/ui/prebuilt/NFT/media.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAIvE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,kBAAkB,EAClB,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAC5B,GAAG;IACF,gBAAgB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IAC3E;;;;OAIG;IACH,aAAa,CAAC,EACV,YAAY,GACZ,CAAC,MAAM,YAAY,CAAC,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,wBAAgB,QAAQ,CAAC,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,GAAG,kBAAkB,EACtB,EAAE,aAAa,qDA6Bf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EACV,YAAY,GACZ,CAAC,MAAM,YAAY,CAAC,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;CACnC;;GAeA;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,aAAa,CAAC,EACV,YAAY,GACZ,CAAC,MAAM,YAAY,CAAC,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CA2BvD"}
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../../../../src/react/web/ui/prebuilt/NFT/media.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAIvE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,kBAAkB,EAClB,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAC5B,GAAG;IACF,gBAAgB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IAC3E;;;;OAIG;IACH,aAAa,CAAC,EACV,YAAY,GACZ,CAAC,MAAM,YAAY,CAAC,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,wBAAgB,QAAQ,CAAC,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,GAAG,kBAAkB,EACtB,EAAE,aAAa,qDA8Bf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EACV,YAAY,GACZ,CAAC,MAAM,YAAY,CAAC,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;CACnC;;GAgBA;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,aAAa,CAAC,EACV,YAAY,GACZ,CAAC,MAAM,YAAY,CAAC,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CA2BvD"}

package/dist/types/react/web/ui/prebuilt/NFT/name.d.ts

@@ -81,10 +81,11 @@ export declare function NFTName({ loadingComponent, fallbackComponent, queryOpti
  * @internal
  */
 export declare function getQueryKey(props: {
+    contractAddress: string;
     chainId: number;
     tokenId: bigint;
     nameResolver?: string | (() => string) | (() => Promise<string>);
-}): readonly ["_internal_nft_name_", number, string, {
+}): readonly ["_internal_nft_name_", number, string, string, {
     readonly resolver: string | undefined;
 }];
 /**

package/dist/types/react/web/ui/prebuilt/NFT/name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../../../../../../src/react/web/ui/prebuilt/NFT/name.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAK5E,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IAC/D,gBAAgB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IACrE;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAClE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,OAAO,CAAC,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,GAAG,SAAS,EACb,EAAE,YAAY,qDAsBd;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAClE;;GAeA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlB"}
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../../../../../../src/react/web/ui/prebuilt/NFT/name.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAK5E,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IAC/D,gBAAgB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IACrE;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAClE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,OAAO,CAAC,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,GAAG,SAAS,EACb,EAAE,YAAY,qDAuBd;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAClE;;GAgBA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlB"}

package/dist/types/utils/extensions/drops/get-claim-params.d.ts

@@ -20,7 +20,6 @@ export type GetClaimParamsOptions = {
  * Get the claim parameters for a given drop
  * @param options - The options for getting the claim parameters
  * @returns The claim parameters
- * @extension ERC1155
  * @example
  * ```ts
  * import { getClaimParams } from "thirdweb/utils";
@@ -33,7 +32,7 @@ export type GetClaimParamsOptions = {
  *  tokenId: 0n,
  * });
  * ```
- * @extension COMMON
+ * @utils
  */
 export declare function getClaimParams(options: GetClaimParamsOptions): Promise<{
     receiver: string;

package/dist/types/utils/extensions/drops/get-claim-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-claim-params.d.ts","sourceRoot":"","sources":["../../../../../src/utils/extensions/drops/get-claim-params.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,CACA;IACE,IAAI,EAAE,QAAQ,CAAC;CAChB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CACJ,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB;;;;;;;UA8IjD,GAAG;;;;;;;;GAMpB"}
+{"version":3,"file":"get-claim-params.d.ts","sourceRoot":"","sources":["../../../../../src/utils/extensions/drops/get-claim-params.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,CACA;IACE,IAAI,EAAE,QAAQ,CAAC;CAChB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CACJ,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB;;;;;;;UA8IjD,GAAG;;;;;;;;GAMpB"}

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.85.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/connection/autoConnect.d.ts

@@ -20,6 +20,7 @@ import type { AutoConnectProps } from "./types.js";
  * @param props - The auto-connect configuration properties
  * @param props.wallets - Array of wallet instances to consider for auto-connection
  * @returns {boolean} a promise resolving to true or false depending on whether the auto connect function connected to a wallet or not
+ * @walletConnection
  */
 export declare const autoConnect: (props: AutoConnectProps & {
     wallets?: Wallet[];

package/dist/types/wallets/connection/autoConnect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoConnect.d.ts","sourceRoot":"","sources":["../../../../src/wallets/connection/autoConnect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW,UACf,gBAAgB,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,qBAwBF,CAAC"}
+{"version":3,"file":"autoConnect.d.ts","sourceRoot":"","sources":["../../../../src/wallets/connection/autoConnect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,UACf,gBAAgB,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,qBAwBF,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.85.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"
       ]
     }
   },
@@ -330,7 +338,7 @@
     "prettier": "3.3.3",
     "react": "19.0.0",
     "react-dom": "19.0.0",
-    "react-native": "0.76.5",
+    "react-native": "0.76.6",
     "react-native-aes-gcm-crypto": "0.2.2",
     "react-native-passkey": "3.0.0",
     "react-native-quick-crypto": "0.7.8",

package/src/ai/chat.test.ts

@@ -0,0 +1,42 @@
+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";
+
+// reenable manually for nebula testing
+describe.runIf(process.env.TW_SECRET_KEY).skip("chat", () => {
+  it("should respond with a message", async () => {
+    const response = await Nebula.chat({
+      client: TEST_CLIENT,
+      messages: [
+        {
+          role: "user",
+          content: `What's the symbol of this contract: 0xe2cb0eb5147b42095c2FfA6F7ec953bb0bE347D8`,
+        },
+      ],
+      contextFilter: {
+        chains: [sepolia],
+      },
+    });
+    expect(response.message).toContain("CAT");
+  });
+
+  it("should respond with a transaction", async () => {
+    const response = await Nebula.chat({
+      client: TEST_CLIENT,
+      messages: [
+        {
+          role: "user",
+          content: `send 0.0001 ETH on sepolia to ${TEST_ACCOUNT_B.address}`,
+        },
+      ],
+      account: TEST_ACCOUNT_A,
+      contextFilter: {
+        chains: [sepolia],
+        walletAddresses: [TEST_ACCOUNT_A.address],
+      },
+    });
+    expect(response.transactions.length).toBe(1);
+  });
+});

package/src/ai/chat.ts

@@ -0,0 +1,52 @@
+import { type Input, type Output, nebulaFetch } from "./common.js";
+
+/**
+ * Chat with Nebula.
+ *
+ * @param input - The input for the chat.
+ * @returns The chat response.
+ * @beta This API is in early access and might change in the future.
+ * @nebula
+ *
+ * @example
+ * ```ts
+ * import { Nebula } from "thirdweb/ai";
+ *
+ * const response = await Nebula.chat({
+ *   client: TEST_CLIENT,
+ *   message: "What's the symbol of this contract: 0xe2cb0eb5147b42095c2FfA6F7ec953bb0bE347D8",
+ *   contextFilter: {
+ *     chains: [sepolia],
+ *   },
+ * });
+ * ```
+ *
+ * Multi message prompt:
+ *
+ * ```ts
+ * const response = await Nebula.chat({
+ *   client,
+ *   messages: [
+ *     { role: "user", content: "What's my balance?" },
+ *     { role: "assistant", content: "Your balance is 0.023 ETH" },
+ *     { role: "user", content: "What about my NFTs?" },
+ *   ],
+ *   contextFilter: {
+ *     chains: [sepolia],
+ *   },
+ * });
+ * ```
+ *
+ * Extracting and sending transactions from a chat response:
+ *
+ * ```ts
+ * const response = await Nebula.chat({ ... });
+ * const transactions = response.transactions;
+ * for (const transaction of transactions) {
+ *   await sendTransaction({ transaction, account });
+ * }
+ * ```
+ */
+export async function chat(input: Input): Promise<Output> {
+  return nebulaFetch("chat", input);
+}

package/src/ai/common.ts

@@ -0,0 +1,131 @@
+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;
+  account?: Account;
+  contextFilter?: {
+    chains?: Chain[];
+    walletAddresses?: string[];
+    contractAddresses?: string[];
+  };
+  sessionId?: string;
+} & (
+  | {
+      messages: {
+        role: "user" | "assistant";
+        content: string;
+      }[];
+    }
+  | {
+      message: 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({
+      ...("messages" in input
+        ? {
+            messages: input.messages,
+          }
+        : {
+            message: input.message,
+          }),
+      session_id: input.sessionId,
+      ...(input.account
+        ? {
+            execute_config: {
+              mode: "client",
+              signer_wallet_address: input.account.address,
+            },
+          }
+        : {}),
+      ...(input.contextFilter
+        ? {
+            context_filter: {
+              chain_ids:
+                input.contextFilter.chains?.map((c) => c.id.toString()) || [],
+              wallet_addresses:
+                input.contextFilter.walletAddresses ||
+                (input.account ? [input.account.address] : []),
+              contract_addresses: input.contextFilter.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,48 @@
+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";
+
+// reenable manually for nebula testing
+describe.runIf(process.env.TW_SECRET_KEY).skip("execute", () => {
+  it("should execute a tx", async () => {
+    await expect(
+      Nebula.execute({
+        client: TEST_CLIENT,
+        message: `send 0.0001 ETH to ${TEST_ACCOUNT_B.address}`,
+        account: TEST_ACCOUNT_A,
+        contextFilter: {
+          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("should execute a contract call", async () => {
+    const nftContract = getContract({
+      client: TEST_CLIENT,
+      chain: sepolia,
+      address: "0xe2cb0eb5147b42095c2FfA6F7ec953bb0bE347D8",
+    });
+
+    const response = await Nebula.execute({
+      client: TEST_CLIENT,
+      messages: [
+        {
+          role: "user",
+          content: `approve 1 token of token id 0 to ${TEST_ACCOUNT_B.address} using the approve function`,
+        },
+      ],
+      account: TEST_ACCOUNT_A,
+      contextFilter: {
+        chains: [nftContract.chain],
+        contractAddresses: [nftContract.address],
+      },
+    });
+    expect(response.transactionHash).toBeDefined();
+  });
+});

package/src/ai/execute.ts

@@ -0,0 +1,68 @@
+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 This API is in early access and might change in the future.
+ * @nebula
+ *
+ * @example
+ * ```ts
+ * import { Nebula } from "thirdweb/ai";
+ *
+ * const wallet = createWallet("io.metamask");
+ * const account = wallet.connect({ client });
+ *
+ * const result = await Nebula.execute({
+ *   client,
+ *   account, // transactions will be sent from this account
+ *   message: "send 0.0001 ETH to vitalik.eth",
+ *   contextFilter: {
+ *     chains: [sepolia],
+ *   },
+ * });
+ * ```
+ *
+ * Multi message prompt:
+ *
+ * ```ts
+ * Nebula.execute({
+ *  client,
+ *  account,
+ *  messages: [
+ *    { role: "user", content: "What's the address of vitalik.eth" },
+ *    {
+ *      role: "assistant",
+ *      content:
+ *        "The address of vitalik.eth is 0xd8dA6BF26964aF8E437eEa5e3616511D7G3a3298",
+ *    },
+ *    { role: "user", content: "Send them 0.0001 ETH" },
+ *  ],
+ *  contextFilter: {
+ *    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/analytics/track/pay.ts

@@ -17,6 +17,7 @@ export async function trackPayEvent(args: {
   toAmount?: string;
   chainId?: number;
   dstChainId?: number;
+  error?: string;
 }) {
   return track({
     client: args.client,
@@ -32,6 +33,7 @@ export async function trackPayEvent(args: {
       amountWei: args.fromAmount,
       dstTokenAddress: args.toToken,
       dstChainId: args.chainId,
+      errorCode: args.error,
     },
   });
 }

package/src/auth/verify-signature.test.ts

@@ -1,10 +1,11 @@
 import * as ox__Bytes from "ox/Bytes";
-import { describe, expect, it, test } from "vitest";
+import { beforeAll, describe, expect, it, test } from "vitest";
 import { FORKED_ETHEREUM_CHAIN } from "../../test/src/chains.js";
 import { TEST_CLIENT } from "../../test/src/test-clients.js";
 import { TEST_ACCOUNT_A } from "../../test/src/test-wallets.js";
 import { ethereum, mainnet } from "../chains/chain-definitions/ethereum.js";
 import { sepolia } from "../chains/chain-definitions/sepolia.js";
+import type { Account } from "../wallets/interfaces/wallet.js";
 import { smartWallet } from "../wallets/smart/smart-wallet.js";
 import {
   verifyContractWalletSignature,
@@ -64,7 +65,7 @@ describe("verifyEOASignature", () => {
 
 describe.runIf(process.env.TW_SECRET_KEY)(
   "verifyContractWalletSignature",
-  async () => {
+  () => {
     it("should verify a valid signature", async () => {
       expect(
         await verifySignature({
@@ -107,15 +108,19 @@ describe.runIf(process.env.TW_SECRET_KEY)(
 
 describe.runIf(process.env.TW_SECRET_KEY)(
   "verifyContractWalletSignature",
-  async () => {
+  () => {
     const message = "Hakuna matata";
     const wallet = smartWallet({
       chain: ethereum,
       gasless: true,
     });
-    const smartAccount = await wallet.connect({
-      client: TEST_CLIENT,
-      personalAccount: TEST_ACCOUNT_A,
+    let smartAccount: Account;
+
+    beforeAll(async () => {
+      smartAccount = await wallet.connect({
+        client: TEST_CLIENT,
+        personalAccount: TEST_ACCOUNT_A,
+      });
     });
 
     test("should verify a smart account signature", async () => {

package/src/chains/chain-definitions/mode.ts

@@ -0,0 +1,16 @@
+import { defineChain } from "../utils.js";
+
+/**
+ * @chain
+ */
+export const mode = /* @__PURE__ */ defineChain({
+  id: 919,
+  name: "Mode",
+  nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+  blockExplorers: [
+    {
+      name: "Modescout",
+      url: "https://explorer.mode.network/",
+    },
+  ],
+});

package/src/contract/deployment/zksync/implementations.ts

@@ -14,6 +14,9 @@ export const ZKSYNC_IMPLEMENTATIONS: Record<number, Record<string, string>> = {
   [37111]: {
     MarketplaceV3: "0x56Abb6a3f25DCcdaDa106191053b1CC54C196DEE",
   },
+  [555271]: {
+    MarketplaceV3: "0x9EB0830B0b10010F2a53383517A7D0B75531Bb1b",
+  },
 };
 
 export const ZKSYNC_WETH: Record<number, string> = {
@@ -21,4 +24,5 @@ export const ZKSYNC_WETH: Record<number, string> = {
   [324]: "0x5AEa5775959fBC2557Cc8789bC1bf90A239D9a91",
   [11124]: "0x9EDCde0257F2386Ce177C3a7FCdd97787F0D841d",
   [37111]: "0xaA91D645D7a6C1aeaa5988e0547267B77d33fe16",
+  [555271]: "0xb0b8b267d44c64BA6dD1Daf442949887c85199f6",
 };

package/src/exports/ai.ts

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

package/src/exports/chains.ts

@@ -77,4 +77,5 @@ export { celoAlfajoresTestnet } from "../chains/chain-definitions/celo-alfajores
 export { fraxtalTestnet } from "../chains/chain-definitions/fraxtal-testnet.js";
 export { metalL2Testnet } from "../chains/chain-definitions/metal-l2-testnet.js";
 export { modeTestnet } from "../chains/chain-definitions/mode-testnet.js";
+export { mode } from "../chains/chain-definitions/mode.js";
 export { soneiumMinato } from "../chains/chain-definitions/soneium-minato.js";

package/src/exports/wallets/engine.ts

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