thirdweb 5.92.3 → 5.93.0

package/dist/esm/bridge/Buy.js

@@ -0,0 +1,195 @@
+import { getClientFetch } from "../utils/fetch.js";
+import { UNIVERSAL_BRIDGE_URL } from "./constants.js";
+/**
+ * Retrieves a Universal Bridge quote for the provided buy intent. The quote will specify the necessary `originAmount` to receive the desired `destinationAmount`, which is specified with the `buyAmountWei` option.
+ *
+ * @example
+ * ```typescript
+ * import { Bridge, NATIVE_TOKEN_ADDRESS } from "thirdweb";
+ *
+ * const quote = await Bridge.Buy.quote({
+ *   originChainId: 1,
+ *   originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   destinationChainId: 10,
+ *   destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   buyAmountWei: toWei("0.01"),
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * This will return a quote that might look like:
+ * ```typescript
+ * {
+ *   originAmount: 10000026098875381n,
+ *   destinationAmount: 1000000000000000000n,
+ *   blockNumber: 22026509n,
+ *   timestamp: 1741730936680,
+ *   estimatedExecutionTimeMs: 1000
+ *   intent: {
+ *     originChainId: 1,
+ *     originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     destinationChainId: 10,
+ *     destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     buyAmountWei: 1000000000000000000n
+ *   }
+ * }
+ * ```
+ *
+ * The quote is an **estimate** for how much you would expect to pay for a specific buy. This quote is not guaranteed and you should use `Buy.prepare` to get a finalized quote with transaction data ready for execution.
+ * So why use `quote`? The quote function is sometimes slightly faster than `prepare`, and can be used before the user connects their wallet.
+ *
+ * You can access this functions input and output types with `Buy.quote.Options` and `Buy.quote.Result`, respectively.
+ *
+ * @param options - The options for the quote.
+ * @param options.originChainId - The chain ID of the origin token.
+ * @param options.originTokenAddress - The address of the origin token.
+ * @param options.destinationChainId - The chain ID of the destination token.
+ * @param options.destinationTokenAddress - The address of the destination token.
+ * @param options.buyAmountWei - The amount of the origin token to buy.
+ * @param options.client - Your thirdweb client.
+ *
+ * @returns A promise that resolves to a non-finalized quote for the requested buy.
+ *
+ * @throws Will throw an error if there is an issue fetching the quote.
+ * @bridge
+ * @beta
+ */
+export async function quote(options) {
+    const { originChainId, originTokenAddress, destinationChainId, destinationTokenAddress, buyAmountWei, client, } = options;
+    const clientFetch = getClientFetch(client);
+    const url = new URL(`${UNIVERSAL_BRIDGE_URL}/buy/quote`);
+    url.searchParams.set("originChainId", originChainId.toString());
+    url.searchParams.set("originTokenAddress", originTokenAddress);
+    url.searchParams.set("destinationChainId", destinationChainId.toString());
+    url.searchParams.set("destinationTokenAddress", destinationTokenAddress);
+    url.searchParams.set("buyAmountWei", buyAmountWei.toString());
+    const response = await clientFetch(url.toString());
+    if (!response.ok) {
+        const errorJson = await response.json();
+        throw new Error(`${errorJson.code} | ${errorJson.message}`);
+    }
+    const { data } = await response.json();
+    return {
+        originAmount: BigInt(data.originAmount),
+        destinationAmount: BigInt(data.destinationAmount),
+        blockNumber: data.blockNumber ? BigInt(data.blockNumber) : undefined,
+        timestamp: data.timestamp,
+        estimatedExecutionTimeMs: data.estimatedExecutionTimeMs,
+        intent: {
+            originChainId,
+            originTokenAddress,
+            destinationChainId,
+            destinationTokenAddress,
+            buyAmountWei,
+        },
+    };
+}
+/**
+ * Prepares a **finalized** Universal Bridge quote for the provided buy request with transaction data. This function will return everything `quote` does, with the addition of a series of prepared transactions and the associated expiration timestamp.
+ *
+ * @example
+ * ```typescript
+ * import { Bridge, NATIVE_TOKEN_ADDRESS } from "thirdweb";
+ *
+ * const quote = await Bridge.Buy.prepare({
+ *   originChainId: 1,
+ *   originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   destinationChainId: 10,
+ *   destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   buyAmountWei: toWei("0.01"),
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * This will return a quote that might look like:
+ * ```typescript
+ * {
+ *   originAmount: 10000026098875381n,
+ *   destinationAmount: 1000000000000000000n,
+ *   blockNumber: 22026509n,
+ *   timestamp: 1741730936680,
+ *   estimatedExecutionTimeMs: 1000
+ *   transactions: [
+ *     {
+ *       to: NATIVE_TOKEN_ADDRESS,
+ *       value: 10000026098875381n,
+ *       data: "0x",
+ *       chainId: 10,
+ *       type: "eip1559"
+ *     }
+ *   ],
+ *   expiration: 1741730936680,
+ *   intent: {
+ *     originChainId: 1,
+ *     originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     destinationChainId: 10,
+ *     destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     buyAmountWei: 1000000000000000000n
+ *   }
+ * }
+ * ```
+ *
+ * ## Sending the transactions
+ * The `transactions` array is a series of [ox](https://oxlib.sh) EIP-1559 transactions that must be executed one after the other in order to fulfill the complete route. There are a few things to keep in mind when executing these transactions:
+ *  - Approvals and other preparation transactions are not included in the transactions array.
+ *  - All transactions are assumed to be executed by the `sender` address, regardless of which chain they are on. The final transaction will use the `receiver` as the recipient address.
+ *  - If an `expiration` timestamp is provided, all transactions must be executed before that time to guarantee successful execution at the specified price.
+ *
+ * NOTE: To get the status of each transaction, use `Bridge.status` rather than checking for transaction inclusion. This function will ensure full bridge completion on the destination chain.
+ *
+ * You can access this functions input and output types with `Buy.prepare.Options` and `Buy.prepare.Result`, respectively.
+ *
+ * @param options - The options for the quote.
+ * @param options.originChainId - The chain ID of the origin token.
+ * @param options.originTokenAddress - The address of the origin token.
+ * @param options.destinationChainId - The chain ID of the destination token.
+ * @param options.destinationTokenAddress - The address of the destination token.
+ * @param options.buyAmountWei - The amount of the origin token to buy.
+ * @param options.sender - The address of the sender.
+ * @param options.receiver - The address of the recipient.
+ * @param options.client - Your thirdweb client.
+ *
+ * @returns A promise that resolves to a non-finalized quote for the requested buy.
+ *
+ * @throws Will throw an error if there is an issue fetching the quote.
+ * @bridge
+ * @beta
+ */
+export async function prepare(options) {
+    const { originChainId, originTokenAddress, destinationChainId, destinationTokenAddress, buyAmountWei, sender, receiver, client, } = options;
+    const clientFetch = getClientFetch(client);
+    const url = new URL(`${UNIVERSAL_BRIDGE_URL}/buy/prepare`);
+    url.searchParams.set("originChainId", originChainId.toString());
+    url.searchParams.set("originTokenAddress", originTokenAddress);
+    url.searchParams.set("destinationChainId", destinationChainId.toString());
+    url.searchParams.set("destinationTokenAddress", destinationTokenAddress);
+    url.searchParams.set("buyAmountWei", buyAmountWei.toString());
+    url.searchParams.set("sender", sender);
+    url.searchParams.set("receiver", receiver);
+    const response = await clientFetch(url.toString());
+    if (!response.ok) {
+        const errorJson = await response.json();
+        throw new Error(`${errorJson.code} | ${errorJson.message}`);
+    }
+    const { data } = await response.json();
+    return {
+        originAmount: BigInt(data.originAmount),
+        destinationAmount: BigInt(data.destinationAmount),
+        blockNumber: data.blockNumber ? BigInt(data.blockNumber) : undefined,
+        timestamp: data.timestamp,
+        estimatedExecutionTimeMs: data.estimatedExecutionTimeMs,
+        transactions: data.transactions.map((transaction) => ({
+            ...transaction,
+            value: transaction.value ? BigInt(transaction.value) : undefined,
+        })),
+        expiration: data.expiration,
+        intent: {
+            originChainId,
+            originTokenAddress,
+            destinationChainId,
+            destinationTokenAddress,
+            buyAmountWei,
+        },
+    };
+}
+//# sourceMappingURL=Buy.js.map

package/dist/esm/bridge/Buy.js.map

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

package/dist/esm/bridge/Routes.js

@@ -0,0 +1,131 @@
+import { getClientFetch } from "../utils/fetch.js";
+import { UNIVERSAL_BRIDGE_URL } from "./constants.js";
+/**
+ * Retrieves supported Universal Bridge routes based on the provided filters.
+ *
+ * When multiple filters are specified, a route must satisfy all filters to be included (it acts as an AND operator).
+ *
+ * @example
+ * ```typescript
+ * import { Bridge } from "thirdweb";
+ *
+ * const routes = await Bridge.routes({
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * Returned routes might look something like:
+ * ```typescript
+ * [
+ *    {
+ *     destinationToken: {
+ *       address: "0x12c88a3C30A7AaBC1dd7f2c08a97145F5DCcD830",
+ *       chainId: 1,
+ *       decimals: 18,
+ *       iconUri: "https://assets.coingecko.com/coins/images/37207/standard/G.jpg",
+ *       name: "G7",
+ *       symbol: "G7",
+ *     },
+ *     originToken: {
+ *       address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *       chainId: 480,
+ *       decimals: 18,
+ *       iconUri: "https://assets.relay.link/icons/1/light.png",
+ *       name: "Ether",
+ *       symbol: "ETH",
+ *     }
+ *   },
+ *   {
+ *     destinationToken: {
+ *       address: "0x4d224452801ACEd8B2F0aebE155379bb5D594381",
+ *       chainId: 1,
+ *       decimals: 18,
+ *       iconUri: "https://coin-images.coingecko.com/coins/images/24383/large/apecoin.jpg?1696523566",
+ *       name: "ApeCoin",
+ *       symbol: "APE",
+ *     },
+ *     originToken: {
+ *       address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *       chainId: 480,
+ *       decimals: 18,
+ *       iconUri: "https://assets.relay.link/icons/1/light.png",
+ *       name: "Ether",
+ *       symbol: "ETH",
+ *     }
+ *   }
+ * ]
+ * ```
+ *
+ * You can filter for specific chains or tokens:
+ * ```typescript
+ * import { Bridge } from "thirdweb";
+ *
+ * // Get all routes starting from mainnet ETH
+ * const routes = await Bridge.routes({
+ *   originChainId: 1,
+ *   originTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * The returned routes will be limited based on the API. You can paginate through the results using the `limit` and `offset` parameters:
+ * ```typescript
+ * import { Bridge } from "thirdweb";
+ *
+ * // Get the first 10 routes starting from mainnet ETH
+ * const routes = await Bridge.routes({
+ *   originChainId: 1,
+ *   originTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *   limit: 10,
+ *   offset: 0,
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * @param options - The options for the quote.
+ * @param options.client - Your thirdweb client.
+ * @param options.originChainId - Filter by a specific origin chain ID.
+ * @param options.originTokenAddress - Filter by a specific origin token address.
+ * @param options.destinationChainId - Filter by a specific destination chain ID.
+ * @param options.destinationTokenAddress - Filter by a specific destination token address.
+ * @param options.transactionHash - Filter by a specific transaction hash.
+ * @param options.limit - Limit the number of routes returned.
+ * @param options.offset - Offset the number of routes returned.
+ *
+ * @returns A promise that resolves to an array of routes.
+ *
+ * @throws Will throw an error if there is an issue fetching the routes.
+ * @bridge
+ * @beta
+ */
+export async function routes(options) {
+    const { client, originChainId, originTokenAddress, destinationChainId, destinationTokenAddress, limit, offset, } = options;
+    const clientFetch = getClientFetch(client);
+    const url = new URL(`${UNIVERSAL_BRIDGE_URL}/routes`);
+    if (originChainId) {
+        url.searchParams.set("originChainId", originChainId.toString());
+    }
+    if (originTokenAddress) {
+        url.searchParams.set("originTokenAddress", originTokenAddress);
+    }
+    if (destinationChainId) {
+        url.searchParams.set("destinationChainId", destinationChainId.toString());
+    }
+    if (destinationTokenAddress) {
+        url.searchParams.set("destinationTokenAddress", destinationTokenAddress);
+    }
+    if (limit) {
+        url.searchParams.set("limit", limit.toString());
+    }
+    if (offset) {
+        url.searchParams.set("offset", offset.toString());
+    }
+    const response = await clientFetch(url.toString());
+    if (!response.ok) {
+        const errorJson = await response.json();
+        throw new Error(`${errorJson.code} | ${errorJson.message}`);
+    }
+    const { data } = await response.json();
+    return data;
+}
+//# sourceMappingURL=Routes.js.map

package/dist/esm/bridge/Routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Routes.js","sourceRoot":"","sources":["../../../src/bridge/Routes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAuB;IAClD,MAAM,EACJ,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,EACL,MAAM,GACP,GAAG,OAAO,CAAC;IAEZ,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,oBAAoB,SAAS,CAAC,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QAClB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,uBAAuB,EAAE,CAAC;QAC5B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,yBAAyB,EAAE,uBAAuB,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,CAAC,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAsB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/bridge/Sell.js

@@ -0,0 +1,195 @@
+import { getClientFetch } from "../utils/fetch.js";
+import { UNIVERSAL_BRIDGE_URL } from "./constants.js";
+/**
+ * Retrieves a Universal Bridge quote for the provided sell intent. The quote will specify the expected `destinationAmount` that will be received in exchange for the specified `originAmount`, which is specified with the `sellAmountWei` option.
+ *
+ * @example
+ * ```typescript
+ * import { Bridge, NATIVE_TOKEN_ADDRESS } from "thirdweb";
+ *
+ * const quote = await Bridge.Sell.quote({
+ *   originChainId: 1,
+ *   originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   destinationChainId: 10,
+ *   destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   sellAmountWei: toWei("0.01"),
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * This will return a quote that might look like:
+ * ```typescript
+ * {
+ *   originAmount: 1000000000000000000n,
+ *   destinationAmount: 9999979011973735n,
+ *   blockNumber: 22026509n,
+ *   timestamp: 1741730936680,
+ *   estimatedExecutionTimeMs: 1000
+ *   intent: {
+ *     originChainId: 1,
+ *     originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     destinationChainId: 10,
+ *     destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     sellAmountWei: 1000000000000000000n
+ *   }
+ * }
+ * ```
+ *
+ * The quote is an **estimate** for how much you would expect to receive for a specific sell. This quote is not guaranteed and you should use `Sell.prepare` to get a finalized quote with transaction data ready for execution.
+ * So why use `quote`? The quote function is sometimes slightly faster than `prepare`, and can be used before the user connects their wallet.
+ *
+ * You can access this functions input and output types with `Sell.quote.Options` and `Sell.quote.Result`, respectively.
+ *
+ * @param options - The options for the quote.
+ * @param options.originChainId - The chain ID of the origin token.
+ * @param options.originTokenAddress - The address of the origin token.
+ * @param options.destinationChainId - The chain ID of the destination token.
+ * @param options.destinationTokenAddress - The address of the destination token.
+ * @param options.sellAmountWei - The amount of the origin token to sell.
+ * @param options.client - Your thirdweb client.
+ *
+ * @returns A promise that resolves to a non-finalized quote for the requested sell.
+ *
+ * @throws Will throw an error if there is an issue fetching the quote.
+ * @bridge
+ * @beta
+ */
+export async function quote(options) {
+    const { originChainId, originTokenAddress, destinationChainId, destinationTokenAddress, sellAmountWei, client, } = options;
+    const clientFetch = getClientFetch(client);
+    const url = new URL(`${UNIVERSAL_BRIDGE_URL}/sell/quote`);
+    url.searchParams.set("originChainId", originChainId.toString());
+    url.searchParams.set("originTokenAddress", originTokenAddress);
+    url.searchParams.set("destinationChainId", destinationChainId.toString());
+    url.searchParams.set("destinationTokenAddress", destinationTokenAddress);
+    url.searchParams.set("sellAmountWei", sellAmountWei.toString());
+    const response = await clientFetch(url.toString());
+    if (!response.ok) {
+        const errorJson = await response.json();
+        throw new Error(`${errorJson.code} | ${errorJson.message}`);
+    }
+    const { data } = await response.json();
+    return {
+        originAmount: BigInt(data.originAmount),
+        destinationAmount: BigInt(data.destinationAmount),
+        blockNumber: data.blockNumber ? BigInt(data.blockNumber) : undefined,
+        timestamp: data.timestamp,
+        estimatedExecutionTimeMs: data.estimatedExecutionTimeMs,
+        intent: {
+            originChainId,
+            originTokenAddress,
+            destinationChainId,
+            destinationTokenAddress,
+            sellAmountWei,
+        },
+    };
+}
+/**
+ * Prepares a **finalized** Universal Bridge quote for the provided sell request with transaction data. This function will return everything `quote` does, with the addition of a series of prepared transactions and the associated expiration timestamp.
+ *
+ * @example
+ * ```typescript
+ * import { Bridge, NATIVE_TOKEN_ADDRESS } from "thirdweb";
+ *
+ * const quote = await Bridge.Sell.prepare({
+ *   originChainId: 1,
+ *   originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   destinationChainId: 10,
+ *   destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   sellAmountWei: toWei("0.01"),
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * This will return a quote that might look like:
+ * ```typescript
+ * {
+ *   originAmount: 1000000000000000000n,
+ *   destinationAmount:  9980000000000000000n,
+ *   blockNumber: 22026509n,
+ *   timestamp: 1741730936680,
+ *   estimatedExecutionTimeMs: 1000
+ *   transactions: [
+ *     {
+ *       to: NATIVE_TOKEN_ADDRESS,
+ *       value: 9980000000000000000n,
+ *       data: "0x",
+ *       chainId: 10,
+ *       type: "eip1559"
+ *     }
+ *   ],
+ *   expiration: 1741730936680,
+ *   intent: {
+ *     originChainId: 1,
+ *     originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     destinationChainId: 10,
+ *     destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     sellAmountWei: 1000000000000000000n
+ *   }
+ * }
+ * ```
+ *
+ * ## Sending the transactions
+ * The `transactions` array is a series of [ox](https://oxlib.sh) EIP-1559 transactions that must be executed one after the other in order to fulfill the complete route. There are a few things to keep in mind when executing these transactions:
+ *  - Approvals and other preparation transactions are not included in the transactions array.
+ *  - All transactions are assumed to be executed by the `sender` address, regardless of which chain they are on. The final transaction will use the `receiver` as the recipient address.
+ *  - If an `expiration` timestamp is provided, all transactions must be executed before that time to guarantee successful execution at the specified price.
+ *
+ * NOTE: To get the status of each transaction, use `Bridge.status` rather than checking for transaction inclusion. This function will ensure full bridge completion on the destination chain.
+ *
+ * You can access this functions input and output types with `Sell.prepare.Options` and `Sell.prepare.Result`, respectively.
+ *
+ * @param options - The options for the quote.
+ * @param options.originChainId - The chain ID of the origin token.
+ * @param options.originTokenAddress - The address of the origin token.
+ * @param options.destinationChainId - The chain ID of the destination token.
+ * @param options.destinationTokenAddress - The address of the destination token.
+ * @param options.sellAmountWei - The amount of the origin token to sell.
+ * @param options.sender - The address of the sender.
+ * @param options.receiver - The address of the recipient.
+ * @param options.client - Your thirdweb client.
+ *
+ * @returns A promise that resolves to a non-finalized quote for the requested buy.
+ *
+ * @throws Will throw an error if there is an issue fetching the quote.
+ * @bridge
+ * @beta
+ */
+export async function prepare(options) {
+    const { originChainId, originTokenAddress, destinationChainId, destinationTokenAddress, sellAmountWei, sender, receiver, client, } = options;
+    const clientFetch = getClientFetch(client);
+    const url = new URL(`${UNIVERSAL_BRIDGE_URL}/sell/prepare`);
+    url.searchParams.set("originChainId", originChainId.toString());
+    url.searchParams.set("originTokenAddress", originTokenAddress);
+    url.searchParams.set("destinationChainId", destinationChainId.toString());
+    url.searchParams.set("destinationTokenAddress", destinationTokenAddress);
+    url.searchParams.set("sellAmountWei", sellAmountWei.toString());
+    url.searchParams.set("sender", sender);
+    url.searchParams.set("receiver", receiver);
+    const response = await clientFetch(url.toString());
+    if (!response.ok) {
+        const errorJson = await response.json();
+        throw new Error(`${errorJson.code} | ${errorJson.message}`);
+    }
+    const { data } = await response.json();
+    return {
+        originAmount: BigInt(data.originAmount),
+        destinationAmount: BigInt(data.destinationAmount),
+        blockNumber: data.blockNumber ? BigInt(data.blockNumber) : undefined,
+        timestamp: data.timestamp,
+        estimatedExecutionTimeMs: data.estimatedExecutionTimeMs,
+        transactions: data.transactions.map((transaction) => ({
+            ...transaction,
+            value: transaction.value ? BigInt(transaction.value) : undefined,
+        })),
+        expiration: data.expiration,
+        intent: {
+            originChainId,
+            originTokenAddress,
+            destinationChainId,
+            destinationTokenAddress,
+            sellAmountWei,
+        },
+    };
+}
+//# sourceMappingURL=Sell.js.map

package/dist/esm/bridge/Sell.js.map

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