[TOOL-3687] Add Universal Buy/Sell bridge functions

This adds a new Universal module to the SDK for bridging assets between chains with automatic routing.

🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <[email protected]>

Author: gregfromstl

packages/thirdweb/package.json

@@ -40,6 +40,11 @@
       "import": "./dist/esm/exports/chains.js",
       "default": "./dist/cjs/exports/chains.js"
     },
+    "./universal": {
+      "types": "./dist/types/exports/universal.d.ts",
+      "import": "./dist/esm/exports/universal.js",
+      "default": "./dist/cjs/exports/universal.js"
+    },
     "./contract": {
       "types": "./dist/types/exports/contract.d.ts",
       "import": "./dist/esm/exports/contract.js",
@@ -132,63 +137,25 @@
   },
   "typesVersions": {
     "*": {
-      "adapters/*": [
-        "./dist/types/exports/adapters/*.d.ts"
-      ],
-      "auth": [
-        "./dist/types/exports/auth.d.ts"
-      ],
-      "chains": [
-        "./dist/types/exports/chains.d.ts"
-      ],
-      "contract": [
-        "./dist/types/exports/contract.d.ts"
-      ],
-      "deploys": [
-        "./dist/types/exports/deploys.d.ts"
-      ],
-      "event": [
-        "./dist/types/exports/event.d.ts"
-      ],
-      "extensions/*": [
-        "./dist/types/exports/extensions/*.d.ts"
-      ],
-      "pay": [
-        "./dist/types/exports/pay.d.ts"
-      ],
-      "react": [
-        "./dist/types/exports/react.d.ts"
-      ],
-      "react-native": [
-        "./dist/types/exports/react-native.d.ts"
-      ],
-      "rpc": [
-        "./dist/types/exports/rpc.d.ts"
-      ],
-      "storage": [
-        "./dist/types/exports/storage.d.ts"
-      ],
-      "transaction": [
-        "./dist/types/exports/transaction.d.ts"
-      ],
-      "utils": [
-        "./dist/types/exports/utils.d.ts"
-      ],
-      "wallets": [
-        "./dist/types/exports/wallets.d.ts"
-      ],
-      "wallets/*": [
-        "./dist/types/exports/wallets/*.d.ts"
-      ],
-      "modules": [
-        "./dist/types/exports/modules.d.ts"
-      ],
-      "social": [
-        "./dist/types/exports/social.d.ts"
-      ],
-      "ai": [
-        "./dist/types/exports/ai.d.ts"
-      ]
+      "adapters/*": ["./dist/types/exports/adapters/*.d.ts"],
+      "auth": ["./dist/types/exports/auth.d.ts"],
+      "chains": ["./dist/types/exports/chains.d.ts"],
+      "contract": ["./dist/types/exports/contract.d.ts"],
+      "deploys": ["./dist/types/exports/deploys.d.ts"],
+      "event": ["./dist/types/exports/event.d.ts"],
+      "extensions/*": ["./dist/types/exports/extensions/*.d.ts"],
+      "pay": ["./dist/types/exports/pay.d.ts"],
+      "react": ["./dist/types/exports/react.d.ts"],
+      "react-native": ["./dist/types/exports/react-native.d.ts"],
+      "rpc": ["./dist/types/exports/rpc.d.ts"],
+      "storage": ["./dist/types/exports/storage.d.ts"],
+      "transaction": ["./dist/types/exports/transaction.d.ts"],
+      "utils": ["./dist/types/exports/utils.d.ts"],
+      "wallets": ["./dist/types/exports/wallets.d.ts"],
+      "wallets/*": ["./dist/types/exports/wallets/*.d.ts"],
+      "modules": ["./dist/types/exports/modules.d.ts"],
+      "social": ["./dist/types/exports/social.d.ts"],
+      "ai": ["./dist/types/exports/ai.d.ts"]
     }
   },
   "browser": {

packages/thirdweb/src/exports/thirdweb.ts

@@ -71,6 +71,11 @@ export {
   type ThirdwebContract,
 } from "../contract/contract.js";
 
+/**
+ * UNIVERSAL BRIDGE
+ */
+export * as Universal from "../universal/index.js";
+
 /**
  * WALLETS
  */

packages/thirdweb/src/exports/universal.ts

@@ -0,0 +1,2 @@
+export * as Buy from "../universal/Buy.js";
+export * as Sell from "../universal/Sell.js";

packages/thirdweb/src/universal/Buy.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import * as Buy from "./Buy.js";
+import { TEST_CLIENT } from "~test/test-clients.js";
+import { toWei } from "src/utils/units.js";
+
+describe("Universal.Buy.quote", () => {
+  it("should get a valid quote", async () => {
+    const quote = await Buy.quote({
+      originChainId: 1,
+      originTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+      destinationChainId: 10,
+      destinationTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+      buyAmountWei: toWei("0.01"),
+      client: TEST_CLIENT,
+    });
+
+    expect(quote).toBeDefined();
+    expect(quote.destinationAmount).toEqual(toWei("0.01"));
+    expect(quote.intent).toBeDefined();
+  });
+});
+
+describe("Universal.Buy.prepare", () => {
+  it("should get a valid prepared quote", async () => {
+    const quote = await Buy.prepare({
+      originChainId: 1,
+      originTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+      destinationChainId: 10,
+      destinationTokenAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+      buyAmountWei: toWei("0.01"),
+      sender: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+      receiver: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
+      client: TEST_CLIENT,
+    });
+
+    expect(quote).toBeDefined();
+    expect(quote.destinationAmount).toEqual(toWei("0.01"));
+    expect(quote.transactions).toBeDefined();
+    expect(quote.transactions.length).toBeGreaterThan(0);
+    expect(quote.intent).toBeDefined();
+  });
+});