thirdweb 5.43.2 → 5.43.3-nightly-baefa5e9c7d72fd8645b0e33452a83fc0ef229d4-20240804000345

package/src/transaction/actions/send-transaction.ts

@@ -14,18 +14,89 @@ export type SendTransactionOptions = {
 };
 
 /**
- * Sends a transaction using the provided wallet.
+ * Sends a transaction using the provided account.
+ *
+ * You can send a transaction with a [prepared contract call](https://portal.thirdweb.com/references/typescript/v5/prepareContractCall), a [prepared transaction](https://portal.thirdweb.com/references/typescript/v5/prepareTransaction), or using a write [Extension](https://portal.thirdweb.com/typescript/v5/extensions/use).
  * @param options - The options for sending the transaction.
- * @returns A promise that resolves to the transaction hash.
- * @throws An error if the wallet is not connected.
+ * @returns A promise that resolves to the transaction result.
+ * @throws An error if the transaction reverts.
  * @transaction
  * @example
+ *
+ * ### Using a prepared contract call
+ *
+ * ```ts
+ * import { sendTransaction, getContract, prepareContractCall } from "thirdweb";
+ * import { sepolia } from "thirdweb/chains";
+ *
+ * const contract = getContract({
+ *   address: "0x...",
+ *   chain: sepolia,
+ *   client,
+ * });
+ *
+ * const transaction = prepareContractCall({
+ *   contract,
+ *   method: "function transfer(address to, uint256 value)",
+ *   params: [to, value],
+ * });
+ *
+ * const { transactionHash } = await sendTransaction({
+ *  account,
+ *  transaction,
+ * });
+ * ```
+ *
+ * ### Using a write extension
+ *
  * ```ts
- * import { sendTransaction } from "thirdweb";
+ * import { sendTransaction, getContract } from "thirdweb";
+ * import { sepolia } from "thirdweb/chains";
+ * import { mintTo } from "thirdweb/extensions/erc721";
+ *
+ * const contract = getContract({
+ *   address: "0x...",
+ *   chain: sepolia,
+ *   client,
+ * });
+ *
+ * const transaction = mintTo({
+ *   contract,
+ *   to: "0x...",
+ *   nft: {
+ *     name: "NFT Name",
+ *     description: "NFT Description",
+ *     image: "https://example.com/image.png",
+ *   },
+ * });
+ *
+ * const { transactionHash } = await sendTransaction({
+ *  account,
+ *  transaction,
+ * });
+ * ```
+ *
+ * ### Using a prepared transaction
+ *
+ * ```ts
+ * import { sendTransaction, getContract, prepareTransaction } from "thirdweb";
+ * import { sepolia } from "thirdweb/chains";
+ *
+ * const contract = getContract({
+ *   address: "0x...",
+ *   chain: sepolia,
+ *   client,
+ * });
+ *
+ * const transaction = prepareTransaction({
+ *   contract,
+ *   to: "0x...",
+ *   value: toWei("0.1"),
+ * });
  *
  * const { transactionHash } = await sendTransaction({
  *  account,
- *  transaction
+ *  transaction,
  * });
  * ```
  */

package/src/transaction/prepare-contract-call.ts

@@ -63,36 +63,41 @@ export type PrepareContractCallOptions<
  * @returns A promise that resolves to the prepared transaction.
  * @transaction
  * @example
- * Usage with a human-readable method signature:
+ *
+ * ### Usage with a human-readable method signature:
+ *
  * ```ts
  * import { prepareContractCall } from "thirdweb";
  *
- * const transaction = await prepareContractCall({
+ * const transaction = prepareContractCall({
  *  contract,
  *  method: "function transfer(address to, uint256 value)",
  *  params: [to, value],
  * });
  * ```
- * @example
- * Usage with explicit gas price and/or value:
+ *
+ * ### Usage with explicit gas price and/or value:
+ *
  * ```ts
  * import { prepareContractCall } from "thirdweb";
+ * import { toWei } from "thirdweb/utils";
  *
- * const transaction = await prepareContractCall({
+ * const transaction = prepareContractCall({
  *  contract,
  *  method: "function transfer(address to, uint256 value)",
  *  params: [to, value],
  *  maxFeePerGas: 30n,
  *  maxPriorityFeePerGas: 1n,
- *  value: 100000n,
+ *  value: toWei("0.01"),
  * });
  * ```
- * @example
- * Usage with a JSON ABI function object:
+ *
+ * ### Usage with a JSON ABI function object:
+ *
  * ```ts
  * import { prepareContractCall } from "thirdweb";
  *
- * const transaction = await prepareContractCall({
+ * const transaction = prepareContractCall({
  *  contract,
  *  method: {
  *    name: "transfer",
@@ -107,8 +112,9 @@ export type PrepareContractCallOptions<
  *  params: [to, value],
  * });
  * ```
- * @example
- * Usage with a the ABI defined on the contract:
+ *
+ * ### Usage with a the ABI defined on the contract:
+ *
  * ```ts
  * import { getContract, prepareContractCall } from "thirdweb";
  * const contract = getContract({
@@ -122,8 +128,7 @@ export type PrepareContractCallOptions<
  * });
  * ```
  *
- * @example
- * Passing extra call data to the transaction
+ * ### Passing extra call data to the transaction
  * ```ts
  * import { getContract, prepareContractCall } from "thirdweb";
  * const contract = getContract({

package/src/transaction/read-contract.ts

@@ -70,16 +70,49 @@ export type ReadContractOptions<
 >;
 
 /**
- * Reads data from a smart contract.
+ * Reads state from a deployed smart contract.
+ *
+ * You can use raw read calls or read [extensions](https://portal.thirdweb.com/typescript/v5/extensions/use) to read from a contract.
+ *
  * @param options - The transaction options.
- * @returns A promise that resolves with the result of the read transaction.
+ * @returns A promise that resolves with the result of the read call.
  * @transaction
  * @example
+ *
+ * ### Using a contract read extension
+ *
  * ```ts
- * import { readContract } from "thirdweb";
- * const result = await readContract({
- *  contract,
- *  method: "function totalSupply() view returns (uint256)",
+ * import { getContract } from "thirdweb";
+ * import { sepolia } from "thirdweb/chains";
+ * import { useReadContract } from "thirdweb/react";
+ * import { getOwnedNFTs } form "thirdweb/extensions/erc721";
+ *
+ * const contract = getContract({
+ *   client,
+ *   address: "0x...",
+ *   chain: sepolia,
+ * });
+ *
+ * const { data, isLoading } = useReadContract(getOwnedNFTs, { contract, owner: address });
+ * ```
+ *
+ * ### Using a raw contract call
+ *
+ * ```ts
+ * import { getContract } from "thirdweb";
+ * import { sepolia } from "thirdweb/chains";
+ * import { useReadContract } from "thirdweb/react";
+ *
+ * const contract = getContract({
+ *   client,
+ *   address: "0x...",
+ *   chain: sepolia,
+ * });
+ *
+ * const { data, isLoading } = useReadContract({
+ *   contract,
+ *   method: "function tokenURI(uint256 tokenId) returns (string)"});
+ *   params: [1n],
  * });
  * ```
  */

package/src/utils/encoding/hex.test.ts

@@ -0,0 +1,11 @@
+import { describe, expect, it } from "vitest";
+import { numberToHex } from "./hex.js";
+
+describe("hex.ts", () => {
+  it("should convert", () => {
+    const result = numberToHex(100n, { size: 32, signed: false });
+    expect(result).toBe(
+      "0x0000000000000000000000000000000000000000000000000000000000000064",
+    );
+  });
+});

package/src/utils/fetch.ts

@@ -43,7 +43,8 @@ export function getClientFetch(client: ThirdwebClient, ecosystem?: Ecosystem) {
       }
       const authToken = getTWAuthToken();
       // if we have an auth token set, use that (thirdweb.com/dashboard sets this for the user)
-      if (authToken) {
+      // pay urls should never send the auth token, because we always want the "developer" to be the one making the request, not the "end user"
+      if (authToken && !isPayUrl(url)) {
         headers.set("authorization", `Bearer ${authToken}`);
       } else if (client.secretKey) {
         headers.set("x-secret-key", client.secretKey);
@@ -127,6 +128,16 @@ export function isThirdwebUrl(url: string): boolean {
   }
 }
 
+function isPayUrl(url: string): boolean {
+  try {
+    const { hostname } = new URL(url);
+    // pay service hostname always starts with "pay."
+    return hostname.startsWith("pay.");
+  } catch {
+    return false;
+  }
+}
+
 const SDK_NAME = "unified-sdk";
 
 let previousPlatform: [string, string][] | undefined;

package/src/version.ts

@@ -1 +1 @@
-export const version = "5.43.2";
+export const version = "5.43.3-nightly-baefa5e9c7d72fd8645b0e33452a83fc0ef229d4-20240804000345";

package/src/wallets/in-app/web/in-app.ts

@@ -39,7 +39,7 @@ import { createInAppWallet } from "../core/wallet/in-app-core.js";
  *
  * [View all available social auth methods](https://portal.thirdweb.com/references/typescript/v5/InAppWalletSocialAuth)
  *
- * * ### Login with email
+ * ### Login with email
  *
  * ```ts
  * import { inAppWallet, preAuthenticate } from "thirdweb/wallets/in-app";
@@ -58,6 +58,7 @@ import { createInAppWallet } from "../core/wallet/in-app-core.js";
  *   client,
  *   chain,
  *   strategy: "email",
+ *   email: "example@example.com",
  *   verificationCode: "123456",
  * });
  * ```
@@ -80,8 +81,10 @@ import { createInAppWallet } from "../core/wallet/in-app-core.js";
  *   client,
  *   chain,
  *   strategy: "phone",
+ *   honeNumber: "+1234567890",
  *   verificationCode: "123456",
  * });
+ * ```
  *
  * ### Login with passkey
  *

package/src/wallets/in-app/web/lib/auth/index.ts

@@ -106,6 +106,7 @@ export async function getUserPhoneNumber(options: GetAuthenticatedUserParams) {
 
 /**
  * Pre-authenticates the user based on the provided authentication strategy.
+ * Use this function to send a verification code to the user's email or phone number.
  * @param args - The arguments required for pre-authentication.
  * @returns A promise that resolves to the pre-authentication result.
  * @throws An error if the provided authentication strategy doesn't require pre-authentication.

package/src/wallets/smart/smart-wallet-integration.test.ts

@@ -18,6 +18,7 @@ import { setContractURI } from "../../extensions/marketplace/__generated__/IMark
 import { estimateGasCost } from "../../transaction/actions/estimate-gas-cost.js";
 import { sendAndConfirmTransaction } from "../../transaction/actions/send-and-confirm-transaction.js";
 import { sendBatchTransaction } from "../../transaction/actions/send-batch-transaction.js";
+import { waitForReceipt } from "../../transaction/actions/wait-for-tx-receipt.js";
 import { isContractDeployed } from "../../utils/bytecode/is-contract-deployed.js";
 import type { Account, Wallet } from "../interfaces/wallet.js";
 import { generateAccount } from "../utils/generateAccount.js";
@@ -139,6 +140,11 @@ describe.runIf(process.env.TW_SECRET_KEY)(
         ],
       });
       expect(tx.transactionHash).toHaveLength(66);
+      await waitForReceipt({
+        client,
+        transactionHash: tx.transactionHash,
+        chain,
+      });
       const balance = await balanceOf({
         contract,
         owner: smartWalletAddress,