thirdweb 5.99.3 → 5.100.0

package/dist/esm/utils/domains.js

@@ -7,6 +7,7 @@ const DEFAULT_BUNDLER_URL = "bundler.thirdweb.com";
 const DEFAULT_ANALYTICS_URL = "c.thirdweb.com";
 const DEFAULT_INSIGHT_URL = "insight.thirdweb.com";
 const DEFAULT_ENGINE_CLOUD_URL = "engine.thirdweb.com";
+const DEFAULT_BRIDGE_URL = "bridge.thirdweb.com";
 let domains = {
     rpc: DEFAULT_RPC_URL,
     inAppWallet: DEFAULT_IN_APP_WALLET_URL,
@@ -17,6 +18,7 @@ let domains = {
     analytics: DEFAULT_ANALYTICS_URL,
     insight: DEFAULT_INSIGHT_URL,
     engineCloud: DEFAULT_ENGINE_CLOUD_URL,
+    bridge: DEFAULT_BRIDGE_URL,
 };
 export const setThirdwebDomains = (DomainOverrides) => {
     domains = {
@@ -29,6 +31,7 @@ export const setThirdwebDomains = (DomainOverrides) => {
         analytics: DomainOverrides.analytics ?? DEFAULT_ANALYTICS_URL,
         insight: DomainOverrides.insight ?? DEFAULT_INSIGHT_URL,
         engineCloud: DomainOverrides.engineCloud ?? DEFAULT_ENGINE_CLOUD_URL,
+        bridge: DomainOverrides.bridge ?? DEFAULT_BRIDGE_URL,
     };
 };
 /**

package/dist/esm/utils/domains.js.map

@@ -1 +1 @@
-{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/utils/domains.ts"],"names":[],"mappings":"AAgDA,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAClD,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACjD,MAAM,yBAAyB,GAAG,8BAA8B,CAAC;AACjE,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAC3C,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAC/C,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAEvD,IAAI,OAAO,GAA+C;IACxD,GAAG,EAAE,eAAe;IACpB,WAAW,EAAE,yBAAyB;IACtC,MAAM,EAAE,kBAAkB;IAC1B,GAAG,EAAE,eAAe;IACpB,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,WAAW,EAAE,wBAAwB;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,eAAgC,EAAE,EAAE;IACrE,OAAO,GAAG;QACR,GAAG,EAAE,eAAe,CAAC,GAAG,IAAI,eAAe;QAC3C,WAAW,EAAE,eAAe,CAAC,WAAW,IAAI,yBAAyB;QACrE,MAAM,EAAE,eAAe,CAAC,MAAM,IAAI,kBAAkB;QACpD,GAAG,EAAE,eAAe,CAAC,GAAG,IAAI,eAAe;QAC3C,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,mBAAmB;QACvD,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,mBAAmB;QACvD,SAAS,EAAE,eAAe,CAAC,SAAS,IAAI,qBAAqB;QAC7D,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,mBAAmB;QACvD,WAAW,EAAE,eAAe,CAAC,WAAW,IAAI,wBAAwB;KACrE,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAA8B,EAAE,EAAE;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,OAAO,UAAU,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,WAAW,MAAM,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAkB,EAAE,EAAE;IAClD,UAAU,GAAG,GAAG,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE;IAChC,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/utils/domains.ts"],"names":[],"mappings":"AAqDA,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAClD,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACjD,MAAM,yBAAyB,GAAG,8BAA8B,CAAC;AACjE,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAC3C,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAC/C,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AACvD,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEjD,IAAI,OAAO,GAA+C;IACxD,GAAG,EAAE,eAAe;IACpB,WAAW,EAAE,yBAAyB;IACtC,MAAM,EAAE,kBAAkB;IAC1B,GAAG,EAAE,eAAe;IACpB,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,qBAAqB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,WAAW,EAAE,wBAAwB;IACrC,MAAM,EAAE,kBAAkB;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,eAAgC,EAAE,EAAE;IACrE,OAAO,GAAG;QACR,GAAG,EAAE,eAAe,CAAC,GAAG,IAAI,eAAe;QAC3C,WAAW,EAAE,eAAe,CAAC,WAAW,IAAI,yBAAyB;QACrE,MAAM,EAAE,eAAe,CAAC,MAAM,IAAI,kBAAkB;QACpD,GAAG,EAAE,eAAe,CAAC,GAAG,IAAI,eAAe;QAC3C,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,mBAAmB;QACvD,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,mBAAmB;QACvD,SAAS,EAAE,eAAe,CAAC,SAAS,IAAI,qBAAqB;QAC7D,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,mBAAmB;QACvD,WAAW,EAAE,eAAe,CAAC,WAAW,IAAI,wBAAwB;QACpE,MAAM,EAAE,eAAe,CAAC,MAAM,IAAI,kBAAkB;KACrD,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAA8B,EAAE,EAAE;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,OAAO,UAAU,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,WAAW,MAAM,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAkB,EAAE,EAAE;IAClD,UAAU,GAAG,GAAG,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE;IAChC,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const version = "5.99.3";
+export const version = "5.100.0";
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC"}

package/dist/types/bridge/Buy.d.ts

@@ -140,7 +140,7 @@ export declare namespace quote {
  * This will return a quote that might look like:
  * ```typescript
  * {
- *   originAmount: 10000026098875381n,
+ *   originAmount: 2000030000n,
  *   destinationAmount: 1000000000000000000n,
  *   blockNumber: 22026509n,
  *   timestamp: 1741730936680,
@@ -149,11 +149,11 @@ export declare namespace quote {
  *     {
  *       originToken: {
  *         chainId: 1,
- *         address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
- *         symbol: "ETH",
- *         name: "Ethereum",
- *         decimals: 18,
- *         priceUsd: 2000,
+ *         address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+ *         symbol: "USDC",
+ *         name: "USDC",
+ *         decimals: 6,
+ *         priceUsd: 1,
  *         iconUri: "https://..."
  *       },
  *       destinationToken: {
@@ -165,7 +165,7 @@ export declare namespace quote {
  *         priceUsd: 2000,
  *         iconUri: "https://..."
  *       },
- *       originAmount: 10000026098875381n,
+ *       originAmount: 2000030000n,
  *       destinationAmount: 1000000000000000000n,
  *       estimatedExecutionTimeMs: 1000
  *       transactions: [
@@ -191,7 +191,7 @@ export declare namespace quote {
  *   expiration: 1741730936680,
  *   intent: {
  *     originChainId: 1,
- *     originTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *     originTokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  *     destinationChainId: 10,
  *     destinationTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
  *     amount: 1000000000000000000n
@@ -200,7 +200,7 @@ export declare namespace quote {
  * ```
  *
  * ## 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:
+ * The `transactions` array is a series of transactions ready to be executed (with `sendTransaction`) 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 will have the `approval` action specified. You can perform approvals with `sendAndConfirmTransaction`, then proceed to the next transaction.
  *  - 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.
@@ -279,6 +279,8 @@ export declare namespace prepare {
             destinationChainId: number;
             destinationTokenAddress: ox__Address.Address;
             amount: bigint;
+            sender: ox__Address.Address;
+            receiver: ox__Address.Address;
             purchaseData?: unknown;
         };
     };

package/dist/types/bridge/Buy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Buy.d.ts","sourceRoot":"","sources":["../../../src/bridge/Buy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAgDzE;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,cAAc,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,CACA;QACE,YAAY,EAAE,MAAM,CAAC;KACtB,GACD;QACE,MAAM,EAAE,MAAM,CAAC;KAChB,CACJ,CAAC;IAEF,KAAK,MAAM,GAAG,KAAK,GAAG;QACpB,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,YAAY,EAAE,MAAM,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyIG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAiEzB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;QAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,cAAc,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,aAAa,GAAG;QAC5B,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;CACH"}
+{"version":3,"file":"Buy.d.ts","sourceRoot":"","sources":["../../../src/bridge/Buy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAiDzE;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,cAAc,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,CACA;QACE,YAAY,EAAE,MAAM,CAAC;KACtB,GACD;QACE,MAAM,EAAE,MAAM,CAAC;KAChB,CACJ,CAAC;IAEF,KAAK,MAAM,GAAG,KAAK,GAAG;QACpB,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,YAAY,EAAE,MAAM,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyIG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAoEzB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;QAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,cAAc,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,aAAa,GAAG;QAC5B,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;YAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;YAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;CACH"}

package/dist/types/bridge/Onramp.d.ts

@@ -0,0 +1,123 @@
+import type { Address as ox__Address } from "ox";
+import type { ThirdwebClient } from "../client/client.js";
+import type { RouteStep } from "./types/Route.js";
+import type { Token } from "./types/Token.js";
+export { status } from "./OnrampStatus.js";
+type OnrampIntent = {
+    onramp: "stripe" | "coinbase" | "transak";
+    chainId: number;
+    tokenAddress: ox__Address.Address;
+    receiver: ox__Address.Address;
+    amount?: string;
+    purchaseData?: unknown;
+    sender?: ox__Address.Address;
+    onrampTokenAddress?: ox__Address.Address;
+    onrampChainId?: number;
+    currency?: string;
+    maxSteps?: number;
+    excludeChainIds?: string | string[];
+};
+type OnrampPrepareQuoteResponseData = {
+    id: string;
+    link: string;
+    currency: string;
+    currencyAmount: number;
+    destinationAmount: bigint;
+    destinationToken: Token;
+    timestamp?: number;
+    expiration?: number;
+    steps: RouteStep[];
+    intent: OnrampIntent;
+};
+/**
+ * Prepares an onramp transaction, returning a link from the specified provider to onramp to the specified token.
+ *
+ * @example
+ * ```typescript
+ * import { Bridge } from "thirdweb";
+ * import { ethereum } from "thirdweb/chains";
+ * import { NATIVE_TOKEN_ADDRESS, toWei } from "thirdweb/utils";
+ *
+ * const preparedOnramp = await Bridge.Onramp.prepare({
+ *   client: thirdwebClient,
+ *   onramp: "stripe",
+ *   chainId: ethereum.id,
+ *   tokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   receiver: "0x...", // receiver's address
+ *   amount: toWei("10"), // 10 of the destination token
+ *   // Optional params:
+ *   // sender: "0x...", // sender's address
+ *   // onrampTokenAddress: NATIVE_TOKEN_ADDRESS, // token to initially onramp to
+ *   // onrampChainId: 1, // chain to initially onramp to
+ *   // currency: "USD",
+ *   // maxSteps: 2,
+ *   // purchaseData: { customId: "123" }
+ * });
+ *
+ * console.log(preparedOnramp.link); // URL to redirect the user to
+ * console.log(preparedOnramp.currencyAmount); // Amount in fiat the user will pay
+ * ```
+ *
+ * This function returns a quote that might look like:
+ * ```typescript
+ * {
+ *   id: "123e4567-e89b-12d3-a456-426614174000",
+ *   link: "https://onramp.example.com/session?id=...",
+ *   currency: "USD",
+ *   currencyAmount: 10.52,
+ *   destinationAmount: 10000000000000000000n, // 10 ETH if decimals 18
+ *   timestamp: 1689812800,
+ *   expiration: 1689842800,
+ *   steps: [
+ *     // ... further steps if any post-onramp swaps are needed
+ *   ],
+ *   intent: {
+ *     onramp: "stripe",
+ *     chainId: 1,
+ *     tokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *     receiver: "0x...",
+ *     amount: "10000000000000000000"
+ *   }
+ * }
+ * ```
+ *
+ * @param options - The options for preparing the onramp.
+ * @param options.client - Your thirdweb client.
+ * @param options.onramp - The onramp provider to use (e.g., "stripe", "coinbase", "transak").
+ * @param options.chainId - The destination chain ID.
+ * @param options.tokenAddress - The destination token address.
+ * @param options.receiver - The address that will receive the output token.
+ * @param [options.amount] - The desired token amount in wei.
+ * @param [options.purchaseData] - Arbitrary purchase data.
+ * @param [options.sender] - An optional address to associate as the onramp sender.
+ * @param [options.onrampTokenAddress] - The token to initially onramp to if the destination token is not supported by the provider.
+ * @param [options.onrampChainId] - The chain ID to initially onramp to if the destination chain is not supported.
+ * @param [options.currency] - The currency for the onramp (e.g., "USD", "GBP"). Defaults to user's preferred or "USD".
+ * @param [options.maxSteps] - Maximum number of post-onramp steps.
+ * @param [options.excludeChainIds] - Chain IDs to exclude from the route (string or array of strings).
+ *
+ * @returns A promise that resolves to the prepared onramp details, including the link and quote.
+ * @throws Will throw an error if there is an issue preparing the onramp.
+ * @bridge Onramp
+ * @beta
+ */
+export declare function prepare(options: prepare.Options): Promise<prepare.Result>;
+export declare namespace prepare {
+    type Options = {
+        client: ThirdwebClient;
+        onramp: "stripe" | "coinbase" | "transak";
+        chainId: number;
+        tokenAddress: ox__Address.Address;
+        receiver: ox__Address.Address;
+        amount?: bigint;
+        purchaseData?: unknown;
+        sender?: ox__Address.Address;
+        onrampTokenAddress?: ox__Address.Address;
+        onrampChainId?: number;
+        currency?: string;
+        maxSteps?: number;
+        excludeChainIds?: string | string[];
+    };
+    type Result = OnrampPrepareQuoteResponseData;
+}
+//# sourceMappingURL=Onramp.d.ts.map

package/dist/types/bridge/Onramp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Onramp.d.ts","sourceRoot":"","sources":["../../../src/bridge/Onramp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC;IAClC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,KAAK,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAkBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CA8FzB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAY,OAAO,GAAG;QACpB,MAAM,EAAE,cAAc,CAAC;QACvB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;QAC1C,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC;QAClC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7B,kBAAkB,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;QACzC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KACrC,CAAC;IAEF,KAAY,MAAM,GAAG,8BAA8B,CAAC;CACrD"}

package/dist/types/bridge/OnrampStatus.d.ts

@@ -0,0 +1,108 @@
+import type { Hex as ox__Hex } from "ox";
+import type { ThirdwebClient } from "../client/client.js";
+/**
+ * Retrieves the status of an Onramp session created via {@link Bridge.Onramp.prepare}. The
+ * status will include any on-chain transactions that have occurred as a result of the onramp
+ * as well as any arbitrary `purchaseData` that was supplied when the onramp was
+ * prepared.
+ *
+ * @example
+ * ```typescript
+ * import { Bridge } from "thirdweb";
+ *
+ * const onrampStatus = await Bridge.Onramp.status({
+ *   id: "022218cc-96af-4291-b90c-dadcb47571ec",
+ *   client: thirdwebClient,
+ * });
+ *
+ * // Possible results:
+ * // {
+ * //   status: "CREATED",
+ * //   transactions: [],
+ * //   purchaseData: {
+ * //     orderId: "abc-123",
+ * //   },
+ * // }
+ * //
+ * // or
+ * // {
+ * //   status: "PENDING",
+ * //   transactions: [],
+ * //   purchaseData: {
+ * //     orderId: "abc-123",
+ * //   },
+ * // }
+ * //
+ * // or
+ * // {
+ * //   status: "COMPLETED",
+ * //   transactions: [
+ * //     {
+ * //       chainId: 1,
+ * //       transactionHash:
+ * //         "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+ * //     },
+ * //   ],
+ * //   purchaseData: {
+ * //     orderId: "abc-123",
+ * //   },
+ * // }
+ * ```
+ *
+ * @param options - The options for fetching the onramp status.
+ * @param options.id - The UUID returned from {@link Bridge.Onramp.prepare}.
+ * @param options.client - Your thirdweb client instance.
+ *
+ * @returns A promise that resolves to the status of the onramp session.
+ *
+ * @throws Will throw an error if there is an issue fetching the status.
+ * @bridge Onramp
+ * @beta
+ */
+export declare function status(options: status.Options): Promise<status.Result>;
+export declare namespace status {
+    /**
+     * Input parameters for {@link Bridge.Onramp.status}.
+     */
+    type Options = {
+        /**
+         * The Onramp session ID returned by {@link Bridge.Onramp.prepare}.
+         */
+        id: string;
+        /** Your {@link ThirdwebClient} instance. */
+        client: ThirdwebClient;
+    };
+    /**
+     * The result returned from {@link Bridge.Onramp.status}.
+     */
+    type Result = {
+        status: "COMPLETED";
+        transactions: Array<{
+            chainId: number;
+            transactionHash: ox__Hex.Hex;
+        }>;
+        purchaseData?: unknown;
+    } | {
+        status: "PENDING";
+        transactions: Array<{
+            chainId: number;
+            transactionHash: ox__Hex.Hex;
+        }>;
+        purchaseData?: unknown;
+    } | {
+        status: "CREATED";
+        transactions: Array<{
+            chainId: number;
+            transactionHash: ox__Hex.Hex;
+        }>;
+        purchaseData?: unknown;
+    } | {
+        status: "FAILED";
+        transactions: Array<{
+            chainId: number;
+            transactionHash: ox__Hex.Hex;
+        }>;
+        purchaseData?: unknown;
+    };
+}
+//# sourceMappingURL=OnrampStatus.d.ts.map

package/dist/types/bridge/OnrampStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnrampStatus.d.ts","sourceRoot":"","sources":["../../../src/bridge/OnrampStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,IAAI,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAiB5E;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B;;OAEG;IACH,KAAY,OAAO,GAAG;QACpB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QACX,4CAA4C;QAC5C,MAAM,EAAE,cAAc,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,KAAY,MAAM,GACd;QACE,MAAM,EAAE,WAAW,CAAC;QACpB,YAAY,EAAE,KAAK,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;SAC9B,CAAC,CAAC;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GACD;QACE,MAAM,EAAE,SAAS,CAAC;QAClB,YAAY,EAAE,KAAK,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;SAC9B,CAAC,CAAC;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GACD;QACE,MAAM,EAAE,SAAS,CAAC;QAClB,YAAY,EAAE,KAAK,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;SAC9B,CAAC,CAAC;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GACD;QACE,MAAM,EAAE,QAAQ,CAAC;QACjB,YAAY,EAAE,KAAK,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;SAC9B,CAAC,CAAC;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACP"}

package/dist/types/bridge/Sell.d.ts

@@ -136,7 +136,7 @@ export declare namespace quote {
  * This will return a quote that might look like:
  * ```typescript
  * {
- *   originAmount: 1000000000000000000n,
+ *   originAmount: 2000000000n,
  *   destinationAmount:  9980000000000000000n,
  *   blockNumber: 22026509n,
  *   timestamp: 1741730936680,
@@ -145,11 +145,11 @@ export declare namespace quote {
  *     {
  *       originToken: {
  *         chainId: 1,
- *         address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
- *         symbol: "ETH",
- *         name: "Ethereum",
- *         decimals: 18,
- *         priceUsd: 2000,
+ *         address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+ *         symbol: "USDC",
+ *         name: "USDC",
+ *         decimals: 6,
+ *         priceUsd: 1,
  *         iconUri: "https://..."
  *       },
  *       destinationToken: {
@@ -161,7 +161,7 @@ export declare namespace quote {
  *         priceUsd: 2000,
  *         iconUri: "https://..."
  *       },
- *       originAmount: 1000000000000000000n,
+ *       originAmount: 2000000000n,
  *       destinationAmount:  9980000000000000000n,
  *       estimatedExecutionTimeMs: 1000
  *     }
@@ -187,16 +187,16 @@ export declare namespace quote {
  *   expiration: 1741730936680,
  *   intent: {
  *     originChainId: 1,
- *     originTokenAddress: NATIVE_TOKEN_ADDRESS,
+ *     originTokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  *     destinationChainId: 10,
- *     destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
- *     amount: 1000000000000000000n
+ *     destinationTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *     amount: 2000000000n
  *   }
  * }
  * ```
  *
  * ## 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:
+ * The `transactions` array is a series of transactions ready to be executed (with `sendTransaction`) 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 will have the `approval` action specified. You can perform approvals with `sendAndConfirmTransaction`, then proceed to the next transaction.
  *  - 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.
@@ -275,6 +275,8 @@ export declare namespace prepare {
             destinationChainId: number;
             destinationTokenAddress: ox__Address.Address;
             amount: bigint;
+            sender: ox__Address.Address;
+            receiver: ox__Address.Address;
             purchaseData?: unknown;
         };
     };

package/dist/types/bridge/Sell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sell.d.ts","sourceRoot":"","sources":["../../../src/bridge/Sell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CA8CzE;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,cAAc,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,KAAK,GAAG;QACpB,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyIG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAmEzB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;QAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,cAAc,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,aAAa,GAAG;QAC5B,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;CACH"}
+{"version":3,"file":"Sell.d.ts","sourceRoot":"","sources":["../../../src/bridge/Sell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CA+CzE;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,cAAc,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,KAAK,GAAG;QACpB,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyIG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAsEzB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;QAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,cAAc,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,aAAa,GAAG;QAC5B,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;YACxC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,uBAAuB,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;YAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;YAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;CACH"}

package/dist/types/bridge/Status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Status.d.ts","sourceRoot":"","sources":["../../../src/bridge/Status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,IAAI,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAuD5E;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,OAAO,GACR;QACE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,cAAc,CAAC;KACxB,GACD;QACE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;QAC7B,KAAK,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,cAAc,CAAC;KACxB,CAAC;IAEN,KAAK,MAAM,GAAG,MAAM,CAAC;CACtB"}
+{"version":3,"file":"Status.d.ts","sourceRoot":"","sources":["../../../src/bridge/Status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,IAAI,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAoE5E;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,OAAO,GACR;QACE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,cAAc,CAAC;KACxB,GACD;QACE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;QAC7B,KAAK,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,cAAc,CAAC;KACxB,CAAC;IAEN,KAAK,MAAM,GAAG,MAAM,CAAC;CACtB"}

package/dist/types/bridge/Transfer.d.ts

@@ -0,0 +1,199 @@
+import type { Address as ox__Address } from "ox";
+import type { ThirdwebClient } from "../client/client.js";
+import type { PreparedQuote } from "./types/Quote.js";
+/**
+ * Prepares a **finalized** Universal Bridge quote for the provided transfer request with transaction data.
+ *
+ * @example
+ * ```typescript
+ * import { Bridge, NATIVE_TOKEN_ADDRESS } from "thirdweb";
+ *
+ * const quote = await Bridge.Transfer.prepare({
+ *   chainId: 1,
+ *   tokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   amount: toWei("0.01"),
+ *   sender: "0x...",
+ *   receiver: "0x...",
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * This will return a quote that might look like:
+ * ```typescript
+ * {
+ *   originAmount: 10000026098875381n,
+ *   destinationAmount: 10000000000000000n,
+ *   blockNumber: 22026509n,
+ *   timestamp: 1741730936680,
+ *   estimatedExecutionTimeMs: 1000
+ *   steps: [
+ *     {
+ *       originToken: {
+ *         chainId: 1,
+ *         address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *         symbol: "ETH",
+ *         name: "Ethereum",
+ *         decimals: 18,
+ *         priceUsd: 2000,
+ *         iconUri: "https://..."
+ *       },
+ *       destinationToken: {
+ *         chainId: 1,
+ *         address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *         symbol: "ETH",
+ *         name: "Ethereum",
+ *         decimals: 18,
+ *         priceUsd: 2000,
+ *         iconUri: "https://..."
+ *       },
+ *       originAmount: 10000026098875381n,
+ *       destinationAmount: 10000000000000000n,
+ *       estimatedExecutionTimeMs: 1000
+ *       transactions: [
+ *         {
+ *           action: "approval",
+ *           id: "0x",
+ *           to: "0x...",
+ *           data: "0x...",
+ *           chainId: 1,
+ *           type: "eip1559"
+ *         },
+ *         {
+ *           action: "transfer",
+ *           to: "0x...",
+ *           value: 10000026098875381n,
+ *           data: "0x...",
+ *           chainId: 1,
+ *           type: "eip1559"
+ *         }
+ *       ]
+ *     }
+ *   ],
+ *   expiration: 1741730936680,
+ *   intent: {
+ *     chainId: 1,
+ *     tokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+ *     amount: 10000000000000000n,
+ *     sender: "0x...",
+ *     receiver: "0x..."
+ *   }
+ * }
+ * ```
+ *
+ * ## 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 will have the `approval` action specified. You can perform approvals with `sendAndConfirmTransaction`, then proceed to the next transaction.
+ *  - 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 non-approval transaction, use `Bridge.status` rather than checking for transaction inclusion. This function will ensure full completion of the transfer.
+ *
+ * You can access this functions input and output types with `Transfer.prepare.Options` and `Transfer.prepare.Result`, respectively.
+ *
+ * You can include arbitrary data to be included on any webhooks and status responses with the `purchaseData` option.
+ *
+ * ```ts
+ * const quote = await Bridge.Transfer.prepare({
+ *   chainId: 1,
+ *   tokenAddress: NATIVE_TOKEN_ADDRESS,
+ *   amount: toWei("0.01"),
+ *   sender: "0x...",
+ *   receiver: "0x...",
+ *   purchaseData: {
+ *     reference: "payment-123",
+ *     metadata: {
+ *       note: "Transfer to Alice"
+ *     }
+ *   },
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * ## Fees
+ * There may be fees associated with the transfer. These fees are paid by the `feePayer` address, which defaults to the `sender` address. You can specify a different address with the `feePayer` option. If you do not specify an option or explicitly specify `sender`, the fees will be added to the input amount. If you specify the `receiver` as the fee payer the fees will be subtracted from the destination amount.
+ *
+ * For example, if you were to request a transfer with `feePayer` set to `receiver`:
+ * ```typescript
+ * const quote = await Bridge.Transfer.prepare({
+ *   chainId: 1,
+ *   tokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
+ *   amount: 100_000_000n, // 100 USDC
+ *   sender: "0x...",
+ *   receiver: "0x...",
+ *   feePayer: "receiver",
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * The returned quote might look like:
+ * ```typescript
+ * {
+ *   originAmount: 100_000_000n, // 100 USDC
+ *   destinationAmount: 99_970_000n, // 99.97 USDC
+ *   ...
+ * }
+ * ```
+ *
+ * If you were to request a transfer with `feePayer` set to `sender`:
+ * ```typescript
+ * const quote = await Bridge.Transfer.prepare({
+ *   chainId: 1,
+ *   tokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
+ *   amount: 100_000_000n, // 100 USDC
+ *   sender: "0x...",
+ *   receiver: "0x...",
+ *   feePayer: "sender",
+ *   client: thirdwebClient,
+ * });
+ * ```
+ *
+ * The returned quote might look like:
+ * ```typescript
+ * {
+ *   originAmount: 100_030_000n, // 100.03 USDC
+ *   destinationAmount: 100_000_000n, // 100 USDC
+ *   ...
+ * }
+ * ```
+ *
+ * @param options - The options for the quote.
+ * @param options.chainId - The chain ID of the token.
+ * @param options.tokenAddress - The address of the token.
+ * @param options.amount - The amount of the token to transfer.
+ * @param options.sender - The address of the sender.
+ * @param options.receiver - The address of the recipient.
+ * @param options.purchaseData - Arbitrary data to be passed to the transfer function and included with any webhooks or status calls.
+ * @param options.client - Your thirdweb client.
+ * @param [options.feePayer] - The address that will pay the fees for the transfer. If not specified, the sender will be used. Values can be "sender" or "receiver".
+ *
+ * @returns A promise that resolves to a finalized quote and transactions for the requested transfer.
+ *
+ * @throws Will throw an error if there is an issue fetching the quote.
+ * @bridge Transfer
+ * @beta
+ */
+export declare function prepare(options: prepare.Options): Promise<prepare.Result>;
+export declare namespace prepare {
+    type Options = {
+        chainId: number;
+        tokenAddress: ox__Address.Address;
+        sender: ox__Address.Address;
+        receiver: ox__Address.Address;
+        amount: bigint;
+        client: ThirdwebClient;
+        purchaseData?: unknown;
+        feePayer?: "sender" | "receiver";
+    };
+    type Result = PreparedQuote & {
+        intent: {
+            chainId: number;
+            tokenAddress: ox__Address.Address;
+            amount: bigint;
+            sender: ox__Address.Address;
+            receiver: ox__Address.Address;
+            purchaseData?: unknown;
+            feePayer?: "sender" | "receiver";
+        };
+    };
+}
+//# sourceMappingURL=Transfer.d.ts.map

package/dist/types/bridge/Transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transfer.d.ts","sourceRoot":"","sources":["../../../src/bridge/Transfer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0KG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CA+DzB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC;QAClC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;QAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,cAAc,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;IAEF,KAAK,MAAM,GAAG,aAAa,GAAG;QAC5B,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC;YAClC,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;YAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;YAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;YACvB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;SAClC,CAAC;KACH,CAAC;CACH"}