@b3dotfun/sdk 0.0.40-alpha.2 → 0.0.40-alpha.21

package/dist/esm/anyspend/react/components/common/PanelOnramp.js

@@ -7,9 +7,12 @@ import { formatAddress } from "../../../../shared/utils/formatAddress.js";
 import { ChevronRight, Wallet } from "lucide-react";
 import { useRef } from "react";
 import { toast } from "sonner";
+import { useFeatureFlags } from "../../contexts/FeatureFlagsContext.js";
 import { FiatPaymentMethod } from "./FiatPaymentMethod.js";
 import { OrderTokenAmountFiat } from "./OrderTokenAmountFiat.js";
-export function PanelOnramp({ srcAmountOnRamp, setSrcAmountOnRamp, selectedPaymentMethod, setActivePanel, _recipientAddress, destinationToken, destinationChainId, destinationAmount, onDestinationTokenChange, onDestinationChainChange, fiatPaymentMethodIndex, recipientSelectionPanelIndex, dstTokenSymbol, hideDstToken = false, }) {
+import { PointsBadge } from "./PointsBadge.js";
+export function PanelOnramp({ srcAmountOnRamp, setSrcAmountOnRamp, selectedPaymentMethod, setActivePanel, _recipientAddress, destinationToken, destinationChainId, destinationAmount, onDestinationTokenChange, onDestinationChainChange, fiatPaymentMethodIndex, recipientSelectionPanelIndex, dstTokenSymbol, hideDstToken = false, anyspendQuote, onShowPointsDetail, }) {
+    const featureFlags = useFeatureFlags();
     // Get geo-based onramp options to access fee information
     const { stripeWeb2Support } = useGeoOnrampOptions(srcAmountOnRamp);
     // Helper function to get fees from API data
@@ -70,9 +73,10 @@ export function PanelOnramp({ srcAmountOnRamp, setSrcAmountOnRamp, selectedPayme
                                         width: `${Math.max(50, srcAmountOnRamp.length * 34)}px`,
                                     } })] }) }), _jsx("div", { className: cn("mx-auto mb-6 inline-grid grid-cols-4 gap-2", hideDstToken && "mb-0"), children: ["5", "10", "20", "25"].map(value => (_jsxs("button", { onClick: () => handleQuickAmount(value), className: `bg-as-surface-secondary border-as-border-secondary hover:border-as-border-secondary h-7 w-14 rounded-lg border text-sm font-medium transition-all duration-200 ${srcAmountOnRamp === value
                                 ? "border-as-border-secondary bg-as-surface-secondary"
-                                : "bg-as-surface-secondary hover:bg-as-surface-secondary"}`, children: ["$", value] }, value))) }), destinationToken && destinationChainId && !hideDstToken && (_jsx(OrderTokenAmountFiat, { address: _recipientAddress, context: "to", inputValue: destinationAmount || "0", onChangeInput: () => { }, chainId: destinationChainId, setChainId: onDestinationChainChange || (() => { }), token: destinationToken, setToken: onDestinationTokenChange || (() => { }) }))] }), _jsxs("div", { className: "border-as-border-secondary bg-as-surface-secondary mt-4 flex w-full flex-col gap-3 rounded-xl border p-4", children: [_jsxs("div", { className: "flex w-full items-center justify-between gap-2", children: [_jsx("span", { className: "text-as-tertiarry flex items-center text-sm", children: "Recipient" }), _recipientAddress ? (_jsxs("button", { className: "text-as-tertiarry flex h-7 items-center gap-1 text-sm transition-colors hover:text-blue-700", onClick: () => setActivePanel(recipientSelectionPanelIndex), children: [_jsx("span", { className: "text-sm", children: recipientName ? formatUsername(recipientName) : formatAddress(_recipientAddress) }), _jsx(ChevronRight, { size: 16 })] })) : (_jsxs("button", { className: "text-as-tertiarry flex h-7 items-center gap-1 text-sm transition-colors hover:text-blue-700", onClick: () => setActivePanel(5), children: [_jsx(Wallet, { className: "text-as-brand", size: 16 }), "Select recipient", _jsx(ChevronRight, { size: 16 })] }))] }), _jsx("div", { className: "divider w-full" }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-as-tertiarry text-sm", children: "Expected to receive" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsxs("span", { className: "text-as-primary font-semibold", children: [destinationAmount || "0", " ", dstTokenSymbol || destinationToken?.symbol || ""] }), _jsxs("span", { className: "text-as-tertiarry text-sm", children: ["on ", destinationChainId ? ALL_CHAINS[destinationChainId]?.name : ""] }), destinationToken && destinationChainId && destinationToken.metadata?.logoURI && (_jsx("img", { src: ALL_CHAINS[destinationChainId]?.logoUrl, alt: "Chain", className: "h-4 w-4 rounded-full" }))] })] }), _jsx("div", { className: "divider w-full" }), _jsx("div", { className: "", children: _jsx("div", { className: "flex items-center justify-between", children: (() => {
-                                const currentPaymentMethod = selectedPaymentMethod || FiatPaymentMethod.NONE;
-                                const fee = getFeeFromApi(currentPaymentMethod);
-                                return (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-as-tertiarry text-sm", children: fee !== null ? `Total (included $${fee.toFixed(2)} fee)` : "Total" }), _jsxs("span", { className: "text-as-primary font-semibold", children: ["$", getTotalAmount(currentPaymentMethod).toFixed(2)] })] }));
-                            })() }) })] })] }));
+                                : "bg-as-surface-secondary hover:bg-as-surface-secondary"}`, children: ["$", value] }, value))) }), destinationToken && destinationChainId && !hideDstToken && (_jsx(OrderTokenAmountFiat, { address: _recipientAddress, context: "to", inputValue: destinationAmount || "0", onChangeInput: () => { }, chainId: destinationChainId, setChainId: onDestinationChainChange || (() => { }), token: destinationToken, setToken: onDestinationTokenChange || (() => { }) }))] }), _jsxs("div", { className: "border-as-border-secondary bg-as-surface-secondary mt-4 flex w-full flex-col gap-3 rounded-xl border p-4", children: [_jsxs("div", { className: "flex w-full items-center justify-between gap-2", children: [_jsx("span", { className: "text-as-tertiarry flex items-center text-sm", children: "Recipient" }), _recipientAddress ? (_jsxs("button", { className: "text-as-tertiarry flex h-7 items-center gap-1 text-sm transition-colors hover:text-blue-700", onClick: () => setActivePanel(recipientSelectionPanelIndex), children: [_jsx("span", { className: "text-sm", children: recipientName ? formatUsername(recipientName) : formatAddress(_recipientAddress) }), _jsx(ChevronRight, { size: 16 })] })) : (_jsxs("button", { className: "text-as-tertiarry flex h-7 items-center gap-1 text-sm transition-colors hover:text-blue-700", onClick: () => setActivePanel(5), children: [_jsx(Wallet, { className: "text-as-brand", size: 16 }), "Select recipient", _jsx(ChevronRight, { size: 16 })] }))] }), _jsx("div", { className: "divider w-full" }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-as-tertiarry text-sm", children: "Expected to receive" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsxs("span", { className: "text-as-primary font-semibold", children: [destinationAmount || "0", " ", dstTokenSymbol || destinationToken?.symbol || ""] }), _jsxs("span", { className: "text-as-tertiarry text-sm", children: ["on ", destinationChainId ? ALL_CHAINS[destinationChainId]?.name : ""] }), destinationToken && destinationChainId && destinationToken.metadata?.logoURI && (_jsx("img", { src: ALL_CHAINS[destinationChainId]?.logoUrl, alt: "Chain", className: "h-4 w-4 rounded-full" }))] })] }), _jsx("div", { className: "divider w-full" }), _jsx("div", { className: "", children: _jsxs("div", { className: "flex items-center justify-between", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-as-tertiarry text-sm", children: (() => {
+                                                const fee = getFeeFromApi(selectedPaymentMethod || FiatPaymentMethod.NONE);
+                                                return fee !== null ? `Total (included $${fee.toFixed(2)} fee)` : "Total";
+                                            })() }), featureFlags.showPoints &&
+                                            anyspendQuote?.data?.pointsAmount &&
+                                            anyspendQuote?.data?.pointsAmount > 0 && (_jsx(PointsBadge, { pointsAmount: anyspendQuote.data.pointsAmount, pointsMultiplier: anyspendQuote.data.pointsMultiplier, onClick: () => onShowPointsDetail?.() }))] }), _jsxs("span", { className: "text-as-primary font-semibold", children: ["$", getTotalAmount(selectedPaymentMethod || FiatPaymentMethod.NONE).toFixed(2)] })] }) })] })] }));
 }

package/dist/esm/anyspend/react/components/common/PointsBadge.d.ts

@@ -0,0 +1,7 @@
+interface PointsBadgeProps {
+    pointsAmount: number;
+    pointsMultiplier?: number;
+    onClick?: () => void;
+}
+export declare function PointsBadge({ pointsAmount, pointsMultiplier, onClick }: PointsBadgeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/esm/anyspend/react/components/common/PointsBadge.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function PointsBadge({ pointsAmount, pointsMultiplier, onClick }) {
+    return (_jsxs("button", { className: "bg-as-brand hover:scale-102 active:scale-98 relative flex cursor-pointer items-center gap-1 rounded-lg px-2 py-1 transition-all", onClick: onClick, children: [_jsx("div", { className: "pointer-events-none absolute inset-0 h-full w-full rounded-lg border border-white/10 border-t-white/20 bg-gradient-to-b from-white/10 to-white/0" }), _jsxs("span", { className: "relative text-xs text-white", children: ["+", pointsAmount.toLocaleString(), " pts", pointsMultiplier && pointsMultiplier > 1 && _jsxs("span", { className: "ml-1 opacity-80", children: ["(", pointsMultiplier, "x)"] })] })] }));
+}

package/dist/esm/anyspend/react/components/common/PointsDetailPanel.d.ts

@@ -0,0 +1,6 @@
+interface PointsDetailPanelProps {
+    pointsAmount?: number;
+    onBack: () => void;
+}
+export declare function PointsDetailPanel({ pointsAmount, onBack }: PointsDetailPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/esm/anyspend/react/components/common/PointsDetailPanel.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, ShinyButton } from "../../../../global-account/react/index.js";
+import { cn } from "../../../../shared/utils/cn.js";
+import { ArrowDown } from "lucide-react";
+import Link from "next/link";
+export function PointsDetailPanel({ pointsAmount = 0, onBack }) {
+    return (_jsxs("div", { className: "mx-auto flex w-[460px] max-w-full flex-col items-center gap-4", children: [_jsx("div", { className: "flex w-full items-center justify-between", children: _jsxs(Button, { variant: "ghost", onClick: onBack, className: "text-as-primary/70 hover:text-as-primary flex items-center gap-2", children: [_jsx(ArrowDown, { className: "h-4 w-4 rotate-90" }), "Back"] }) }), _jsxs("div", { className: "flex flex-col items-center gap-4 text-center", children: [_jsx("h3", { className: "text-as-primary text-xl font-bold", children: "Earn Points with Every Swap" }), _jsxs("p", { className: "text-as-primary/70 text-balance text-sm leading-relaxed", children: ["You'll earn ", _jsxs("span", { className: "text-as-brand font-semibold", children: ["+", pointsAmount.toLocaleString(), " points"] }), " ", "towards the", " ", _jsx(Link, { href: "https://anyspend.com/points", target: "_blank", className: "text-as-brand underline", children: "next AnySpend airdrop" }), " ", "when you complete this transaction."] }), _jsxs("div", { className: "bg-as-surface-primary border-as-border-secondary mt-2 w-full rounded-lg border p-4 text-left", children: [_jsx("h4", { className: "text-as-primary mb-2 font-semibold", children: "How it works:" }), _jsxs("ul", { className: "text-as-primary/70 space-y-1 text-sm", children: [_jsx("li", { children: "\u2022 Points are earned based on transaction volume" }), _jsx("li", { children: "\u2022 Higher volume = more points" }), _jsx("li", { children: "\u2022 Points contribute to future airdrops" }), _jsx("li", { children: "\u2022 Keep swapping to maximize your rewards" })] })] }), _jsx(ShinyButton, { accentColor: "hsl(var(--as-brand))", onClick: onBack, className: cn("as-main-button !bg-as-brand relative w-full"), textClassName: cn("text-white"), children: "Back to Swap" })] })] }));
+}

package/dist/esm/anyspend/react/contexts/FeatureFlagsContext.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from "react";
+export interface FeatureFlags {
+    showPoints?: boolean;
+}
+interface FeatureFlagsProviderProps {
+    children: ReactNode;
+    featureFlags?: FeatureFlags;
+}
+export declare function FeatureFlagsProvider({ children, featureFlags }: FeatureFlagsProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useFeatureFlags(): FeatureFlags;
+export {};

package/dist/esm/anyspend/react/contexts/FeatureFlagsContext.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const FeatureFlagsContext = createContext(undefined);
+const defaultFeatureFlags = {
+    showPoints: false,
+};
+export function FeatureFlagsProvider({ children, featureFlags = defaultFeatureFlags }) {
+    return _jsx(FeatureFlagsContext.Provider, { value: { featureFlags }, children: children });
+}
+export function useFeatureFlags() {
+    const context = useContext(FeatureFlagsContext);
+    if (!context) {
+        return defaultFeatureFlags;
+    }
+    return context.featureFlags;
+}

package/dist/esm/anyspend/react/hooks/useAnyspendFlow.d.ts

@@ -7,7 +7,8 @@ export declare enum PanelView {
     FIAT_PAYMENT_METHOD = 2,
     RECIPIENT_SELECTION = 3,
     ORDER_DETAILS = 4,
-    LOADING = 5
+    LOADING = 5,
+    POINTS_DETAIL = 6
 }
 interface UseAnyspendFlowProps {
     paymentType?: "crypto" | "fiat";
@@ -140,6 +141,8 @@ export declare function useAnyspendFlow({ paymentType, recipientAddress, loadOrd
             };
             timeEstimate?: number;
             userBalance?: string;
+            pointsAmount?: number;
+            pointsMultiplier?: number;
         };
         statusCode: number;
     } | undefined;

package/dist/esm/anyspend/react/hooks/useAnyspendFlow.js

@@ -18,6 +18,7 @@ export var PanelView;
     PanelView[PanelView["RECIPIENT_SELECTION"] = 3] = "RECIPIENT_SELECTION";
     PanelView[PanelView["ORDER_DETAILS"] = 4] = "ORDER_DETAILS";
     PanelView[PanelView["LOADING"] = 5] = "LOADING";
+    PanelView[PanelView["POINTS_DETAIL"] = 6] = "POINTS_DETAIL";
 })(PanelView || (PanelView = {}));
 export function useAnyspendFlow({ paymentType = "crypto", recipientAddress, loadOrder, isDepositMode = false, onOrderSuccess, onTransactionSuccess, sourceTokenAddress, sourceTokenChainId, slippage = 0, disableUrlParamManagement = false, }) {
     const searchParams = useSearchParamsSSR();

package/dist/esm/anyspend/react/providers/AnyspendProvider.d.ts

@@ -1,6 +1,8 @@
 import { ReactNode } from "react";
+import { FeatureFlags } from "../contexts/FeatureFlagsContext";
 interface AnyspendProviderProps {
     children: ReactNode;
+    featureFlags?: FeatureFlags;
 }
 /**
  * AnyspendProvider is a top-level provider that wraps your application to provide
@@ -12,17 +14,18 @@ interface AnyspendProviderProps {
  * - Safe to use at the application root
  * - Configures sensible defaults for query caching
  * - Handles Stripe payment redirects and modal state
+ * - Provides feature flags configuration
  *
  * @example
  * ```tsx
  * function App() {
  *   return (
- *     <AnyspendProvider>
+ *     <AnyspendProvider featureFlags={{ showPoints: true }}>
  *       <YourApp />
  *     </AnyspendProvider>
  *   );
  * }
  * ```
  */
-export declare const AnyspendProvider: ({ children }: AnyspendProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const AnyspendProvider: ({ children, featureFlags }: AnyspendProviderProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/esm/anyspend/react/providers/AnyspendProvider.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { TooltipProvider } from "../../../global-account/react/index.js";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { useState } from "react";
+import { FeatureFlagsProvider } from "../contexts/FeatureFlagsContext.js";
 import { StripeRedirectHandler } from "./StripeRedirectHandler.js";
 const defaultQueryClientConfig = {
     defaultOptions: {
@@ -23,19 +24,20 @@ const defaultQueryClientConfig = {
  * - Safe to use at the application root
  * - Configures sensible defaults for query caching
  * - Handles Stripe payment redirects and modal state
+ * - Provides feature flags configuration
  *
  * @example
  * ```tsx
  * function App() {
  *   return (
- *     <AnyspendProvider>
+ *     <AnyspendProvider featureFlags={{ showPoints: true }}>
  *       <YourApp />
  *     </AnyspendProvider>
  *   );
  * }
  * ```
  */
-export const AnyspendProvider = function AnyspendProvider({ children }) {
+export const AnyspendProvider = function AnyspendProvider({ children, featureFlags }) {
     const [queryClient] = useState(() => new QueryClient(defaultQueryClientConfig));
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsxs(TooltipProvider, { children: [_jsx(StripeRedirectHandler, {}), children] }) }));
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(FeatureFlagsProvider, { featureFlags: featureFlags, children: _jsxs(TooltipProvider, { children: [_jsx(StripeRedirectHandler, {}), children] }) }) }));
 };

package/dist/esm/anyspend/react/providers/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./AnyspendProvider";
 export * from "./StripeRedirectHandler";
+export { useFeatureFlags, type FeatureFlags } from "../contexts/FeatureFlagsContext";

package/dist/esm/anyspend/react/providers/index.js

@@ -1,2 +1,3 @@
 export * from "./AnyspendProvider.js";
 export * from "./StripeRedirectHandler.js";
+export { useFeatureFlags } from "../contexts/FeatureFlagsContext.js";

package/dist/esm/anyspend/types/api.d.ts

@@ -507,7 +507,7 @@ export interface paths {
                          * @description Type of trade execution
                          * @enum {string}
                          */
-                        tradeType: "EXACT_INPUT" | "EXPECTED_OUTPUT" | "EXACT_OUTPUT";
+                        tradeType: "EXACT_INPUT" | "EXACT_OUTPUT";
                         /**
                          * @description Amount to quote
                          * @example 1000000000000000000
@@ -798,6 +798,16 @@ export interface paths {
                                  * @example 0
                                  */
                                 userBalance?: string;
+                                /**
+                                 * @description Anyspend points that will be awarded for the order
+                                 * @example 100
+                                 */
+                                pointsAmount?: number;
+                                /**
+                                 * @description Multiplier applied to points that will be awarded for the order
+                                 * @example 1.5
+                                 */
+                                pointsMultiplier?: number;
                             };
                             /** @example 200 */
                             statusCode: number;

package/dist/esm/anyspend/utils/orderPayload.js

@@ -20,6 +20,7 @@ export const buildPayload = (orderType, params) => {
                 return {
                     contractAddress: normalizeAddress(nft.contractAddress),
                     nftPrice: nft?.price || "",
+                    tokenId: null,
                     contractType: nft?.type,
                 };
             }

package/dist/esm/bondkit/bondkitToken.d.ts

@@ -1,6 +1,7 @@
 import type { Address, EIP1193Provider, GetContractReturnType, Hex, PublicClient, WalletClient } from "viem";
 import { BondkitTokenABI } from "./abis";
-import type { BondkitTokenInitializationConfig, GetTransactionHistoryOptions, TokenDetails, TokenStatus, TransactionResponse } from "./types";
+import type { BondkitTokenInitializationConfig, GetTransactionHistoryOptions, SwapQuote, TokenDetails, TransactionResponse } from "./types";
+import { TokenStatus } from "./types";
 type ExecuteWriteOptions = {
     value?: bigint;
     gas?: bigint;
@@ -18,7 +19,8 @@ export declare class BondkitToken {
     private walletClientInstance;
     private connectedProvider?;
     private tradingToken?;
-    constructor(contractAddress: string, walletKey?: string);
+    private swapService?;
+    constructor(contractAddress: string, walletKey?: string, rpcUrl?: string);
     connect(provider?: EIP1193Provider): boolean;
     /**
      * Connects using an EIP-1193 provider and requests accounts, selecting the first one.
@@ -69,5 +71,38 @@ export declare class BondkitToken {
     migrateToDex(options?: ExecuteWriteOptions): Promise<Hex | undefined>;
     transferTokenOwnership(newOwner: Address, options?: ExecuteWriteOptions): Promise<Hex | undefined>;
     renounceTokenOwnership(options?: ExecuteWriteOptions): Promise<Hex | undefined>;
+    /**
+     * Get the swap service instance (lazy initialization)
+     */
+    private getSwapService;
+    /**
+     * Check if DEX swapping is available (token must be in Dex phase)
+     */
+    isSwapAvailable(): Promise<boolean | undefined>;
+    /**
+     * Get swap quote for trading token → bondkit token
+     */
+    getSwapQuoteForBondkitToken(amountTradingTokenIn: string, slippageTolerance?: number): Promise<SwapQuote | undefined>;
+    /**
+     * Get swap quote for bondkit token → trading token
+     */
+    getSwapQuoteForTradingToken(amountBondkitTokenIn: string, slippageTolerance?: number): Promise<SwapQuote | undefined>;
+    /**
+     * Swap trading token for bondkit token
+     */
+    swapTradingTokenForBondkitToken(amountTradingTokenIn: string, slippageTolerance?: number, options?: ExecuteWriteOptions): Promise<Hex | undefined>;
+    /**
+     * Swap bondkit token for trading token
+     */
+    swapBondkitTokenForTradingToken(amountBondkitTokenIn: string, slippageTolerance?: number, options?: ExecuteWriteOptions): Promise<Hex | undefined>;
+    /**
+     * Helper method to get trading token decimals
+     */
+    private getTradingTokenDecimals;
+    /**
+     * Get trading token symbol
+     * @param tradingTokenAddress Optional trading token address to avoid fetching it again
+     */
+    getTradingTokenSymbol(tradingTokenAddress?: Address): Promise<string | undefined>;
 }
 export {};

package/dist/esm/bondkit/bondkitToken.js

@@ -3,6 +3,8 @@ import { privateKeyToAccount } from "viem/accounts";
 import { base } from "viem/chains";
 import { BondkitTokenABI } from "./abis/index.js";
 import { getConfig } from "./config.js";
+import { BondkitSwapService } from "./swapService.js";
+import { TokenStatus } from "./types.js";
 // Event ABI snippets for decoding
 const boughtEventAbi = BondkitTokenABI.find(item => item.type === "event" && item.name === "BondingCurveBuy");
 const soldEventAbi = BondkitTokenABI.find(item => item.type === "event" && item.name === "BondingCurveSell");
@@ -11,8 +13,8 @@ const dexMigrationEventAbi = BondkitTokenABI.find(item => item.type === "event"
 const OKX_POLLING_MAX_RETRIES = 60; // 5 minutes with 5 second intervals
 const OKX_POLLING_INTERVAL_MS = 5000; // 5 seconds
 export class BondkitToken {
-    constructor(contractAddress, walletKey) {
-        const sdkConfig = getConfig(base.id);
+    constructor(contractAddress, walletKey, rpcUrl) {
+        const sdkConfig = getConfig(base.id, rpcUrl);
         this.chain = sdkConfig.chain;
         this.rpcUrl = sdkConfig.rpcUrl;
         this.apiEndpoint = sdkConfig.apiEndpoint;
@@ -555,4 +557,268 @@ export class BondkitToken {
     async renounceTokenOwnership(options) {
         return this.executeWrite("renounceOwnership", [], options);
     }
+    // --- DEX Swap Methods ---
+    /**
+     * Get the swap service instance (lazy initialization)
+     */
+    getSwapService() {
+        if (!this.swapService) {
+            this.swapService = new BondkitSwapService(this.contractAddress);
+        }
+        return this.swapService;
+    }
+    /**
+     * Check if DEX swapping is available (token must be in Dex phase)
+     */
+    async isSwapAvailable() {
+        try {
+            const status = await this.currentStatus();
+            return status === TokenStatus.Dex;
+        }
+        catch (error) {
+            console.warn("Error checking swap availability:", error);
+            return undefined;
+        }
+    }
+    /**
+     * Get swap quote for trading token → bondkit token
+     */
+    async getSwapQuoteForBondkitToken(amountTradingTokenIn, slippageTolerance = 0.5) {
+        try {
+            // Check if swapping is available
+            const swapAvailable = await this.isSwapAvailable();
+            if (!swapAvailable) {
+                console.warn("DEX swapping not available - token must be in Dex phase");
+                return undefined;
+            }
+            const tradingTokenAddress = await this.getTradingTokenAddress();
+            if (!tradingTokenAddress) {
+                console.warn("Trading token address not available");
+                return undefined;
+            }
+            // Get token details for decimals
+            const [tradingTokenDecimals, bondkitTokenDecimals] = await Promise.all([
+                this.getTradingTokenDecimals(tradingTokenAddress),
+                this.decimals(),
+            ]);
+            if (tradingTokenDecimals === undefined || bondkitTokenDecimals === undefined) {
+                console.warn("Unable to fetch token decimals");
+                return undefined;
+            }
+            const swapService = this.getSwapService();
+            const quote = await swapService.getSwapQuote({
+                tokenIn: tradingTokenAddress,
+                tokenOut: this.contractAddress,
+                amountIn: amountTradingTokenIn,
+                tokenInDecimals: tradingTokenDecimals,
+                tokenOutDecimals: bondkitTokenDecimals,
+                slippageTolerance,
+                recipient: this.walletClientInstance.account?.address || "0x0000000000000000000000000000000000000000",
+            });
+            return quote || undefined;
+        }
+        catch (error) {
+            console.warn("Error getting swap quote for bondkit token:", error);
+            return undefined;
+        }
+    }
+    /**
+     * Get swap quote for bondkit token → trading token
+     */
+    async getSwapQuoteForTradingToken(amountBondkitTokenIn, slippageTolerance = 0.5) {
+        try {
+            // Check if swapping is available
+            const swapAvailable = await this.isSwapAvailable();
+            if (!swapAvailable) {
+                console.warn("DEX swapping not available - token must be in Dex phase");
+                return undefined;
+            }
+            const tradingTokenAddress = await this.getTradingTokenAddress();
+            if (!tradingTokenAddress) {
+                console.warn("Trading token address not available");
+                return undefined;
+            }
+            // Get token details for decimals
+            const [bondkitTokenDecimals, tradingTokenDecimals] = await Promise.all([
+                this.decimals(),
+                this.getTradingTokenDecimals(tradingTokenAddress),
+            ]);
+            if (bondkitTokenDecimals === undefined || tradingTokenDecimals === undefined) {
+                console.warn("Unable to fetch token decimals");
+                return undefined;
+            }
+            const swapService = this.getSwapService();
+            const quote = await swapService.getSwapQuote({
+                tokenIn: this.contractAddress,
+                tokenOut: tradingTokenAddress,
+                amountIn: amountBondkitTokenIn,
+                tokenInDecimals: bondkitTokenDecimals,
+                tokenOutDecimals: tradingTokenDecimals,
+                slippageTolerance,
+                recipient: this.walletClientInstance.account?.address || "0x0000000000000000000000000000000000000000",
+            });
+            return quote || undefined;
+        }
+        catch (error) {
+            console.warn("Error getting swap quote for trading token:", error);
+            return undefined;
+        }
+    }
+    /**
+     * Swap trading token for bondkit token
+     */
+    async swapTradingTokenForBondkitToken(amountTradingTokenIn, slippageTolerance = 0.5, options) {
+        try {
+            // Check if swapping is available
+            const swapAvailable = await this.isSwapAvailable();
+            if (!swapAvailable) {
+                console.warn("DEX swapping not available - token must be in Dex phase");
+                return undefined;
+            }
+            if (!this.walletClientInstance.account && !this.walletKey) {
+                console.warn("Wallet key not set or client not connected for swap operation");
+                return undefined;
+            }
+            const tradingTokenAddress = await this.getTradingTokenAddress();
+            if (!tradingTokenAddress) {
+                console.warn("Trading token address not available");
+                return undefined;
+            }
+            // Get token details for decimals
+            const [tradingTokenDecimals, bondkitTokenDecimals] = await Promise.all([
+                this.getTradingTokenDecimals(tradingTokenAddress),
+                this.decimals(),
+            ]);
+            if (tradingTokenDecimals === undefined || bondkitTokenDecimals === undefined) {
+                console.warn("Unable to fetch token decimals");
+                return undefined;
+            }
+            const recipient = this.walletClientInstance.account?.address ||
+                (this.walletKey ? privateKeyToAccount(this.walletKey).address : undefined);
+            if (!recipient) {
+                console.warn("Unable to determine recipient address");
+                return undefined;
+            }
+            const swapService = this.getSwapService();
+            const txHash = await swapService.executeSwap({
+                tokenIn: tradingTokenAddress,
+                tokenOut: this.contractAddress,
+                amountIn: amountTradingTokenIn,
+                tokenInDecimals: tradingTokenDecimals,
+                tokenOutDecimals: bondkitTokenDecimals,
+                slippageTolerance,
+                recipient,
+                deadline: (options?.value ? Math.floor(Date.now() / 1000) : 0) + 3600,
+            }, this.walletClientInstance);
+            return txHash ? txHash : undefined;
+        }
+        catch (error) {
+            console.warn("Error swapping trading token for bondkit token:", error);
+            return undefined;
+        }
+    }
+    /**
+     * Swap bondkit token for trading token
+     */
+    async swapBondkitTokenForTradingToken(amountBondkitTokenIn, slippageTolerance = 0.5, options) {
+        try {
+            // Check if swapping is available
+            const swapAvailable = await this.isSwapAvailable();
+            if (!swapAvailable) {
+                console.warn("DEX swapping not available - token must be in Dex phase");
+                return undefined;
+            }
+            if (!this.walletClientInstance.account && !this.walletKey) {
+                console.warn("Wallet key not set or client not connected for swap operation");
+                return undefined;
+            }
+            const tradingTokenAddress = await this.getTradingTokenAddress();
+            if (!tradingTokenAddress) {
+                console.warn("Trading token address not available");
+                return undefined;
+            }
+            // Get token details for decimals
+            const [bondkitTokenDecimals, tradingTokenDecimals] = await Promise.all([
+                this.decimals(),
+                this.getTradingTokenDecimals(tradingTokenAddress),
+            ]);
+            if (bondkitTokenDecimals === undefined || tradingTokenDecimals === undefined) {
+                console.warn("Unable to fetch token decimals");
+                return undefined;
+            }
+            const recipient = this.walletClientInstance.account?.address ||
+                (this.walletKey ? privateKeyToAccount(this.walletKey).address : undefined);
+            if (!recipient) {
+                console.warn("Unable to determine recipient address");
+                return undefined;
+            }
+            const swapService = this.getSwapService();
+            const txHash = await swapService.executeSwap({
+                tokenIn: this.contractAddress,
+                tokenOut: tradingTokenAddress,
+                amountIn: amountBondkitTokenIn,
+                tokenInDecimals: bondkitTokenDecimals,
+                tokenOutDecimals: tradingTokenDecimals,
+                slippageTolerance,
+                recipient,
+                deadline: (options?.value ? Math.floor(Date.now() / 1000) : 0) + 3600,
+            }, this.walletClientInstance);
+            return txHash ? txHash : undefined;
+        }
+        catch (error) {
+            console.warn("Error swapping bondkit token for trading token:", error);
+            return undefined;
+        }
+    }
+    /**
+     * Helper method to get trading token decimals
+     */
+    async getTradingTokenDecimals(tradingTokenAddress) {
+        try {
+            // ETH has 18 decimals
+            if (tradingTokenAddress === "0x0000000000000000000000000000000000000000") {
+                return 18;
+            }
+            // For ERC20 tokens, read decimals from contract
+            const tradingTokenContract = getContract({
+                address: tradingTokenAddress,
+                abi: erc20Abi,
+                client: this.publicClient,
+            });
+            const decimals = await tradingTokenContract.read.decimals();
+            return Number(decimals);
+        }
+        catch (error) {
+            console.warn("Error fetching trading token decimals:", error);
+            return undefined;
+        }
+    }
+    /**
+     * Get trading token symbol
+     * @param tradingTokenAddress Optional trading token address to avoid fetching it again
+     */
+    async getTradingTokenSymbol(tradingTokenAddress) {
+        try {
+            const tokenAddress = tradingTokenAddress || (await this.getTradingTokenAddress());
+            if (!tokenAddress) {
+                return undefined;
+            }
+            // ETH symbol
+            if (tokenAddress === "0x0000000000000000000000000000000000000000") {
+                return "ETH";
+            }
+            // For ERC20 tokens, read symbol from contract
+            const tradingTokenContract = getContract({
+                address: tokenAddress,
+                abi: erc20Abi,
+                client: this.publicClient,
+            });
+            const symbol = await tradingTokenContract.read.symbol();
+            return symbol;
+        }
+        catch (error) {
+            console.warn("Error fetching trading token symbol:", error);
+            return undefined;
+        }
+    }
 }

package/dist/esm/bondkit/bondkitTokenFactory.d.ts

@@ -10,7 +10,7 @@ export declare class BondkitTokenFactory {
     private rpcUrl;
     private walletClientInstance;
     private connectedProvider?;
-    constructor(chainId: SupportedChainId, walletKey?: string);
+    constructor(chainId: SupportedChainId, walletKey?: string, rpcUrl?: string);
     connect(provider?: EIP1193Provider): boolean;
     /**
      * Connects using an EIP-1193 provider and requests accounts, selecting the first one.

package/dist/esm/bondkit/bondkitTokenFactory.js

@@ -5,14 +5,14 @@ import { getConfig } from "./config.js";
 // Define the event ABI snippet for BondkitTokenCreated specifically for decoding
 const bondkitTokenCreatedEventAbi = BondkitTokenFactoryABI.find(item => item.type === "event" && item.name === "BondkitTokenCreated");
 export class BondkitTokenFactory {
-    constructor(chainId, walletKey) {
+    constructor(chainId, walletKey, rpcUrl) {
         if (walletKey && !walletKey.startsWith("0x")) {
             this.walletKey = `0x${walletKey}`;
         }
         else if (walletKey) {
             this.walletKey = walletKey;
         }
-        const config = getConfig(chainId);
+        const config = getConfig(chainId, rpcUrl);
         this.chain = config.chain;
         this.contractAddress = config.factoryAddress;
         this.rpcUrl = config.rpcUrl;

package/dist/esm/bondkit/config.d.ts

@@ -7,4 +7,4 @@ export interface Config {
     apiEndpoint: string;
 }
 export type SupportedChainId = typeof base.id;
-export declare const getConfig: (chainId: number) => Config;
+export declare const getConfig: (chainId: number, rpcUrl?: string) => Config;

package/dist/esm/bondkit/config.js

@@ -6,9 +6,12 @@ const baseMainnetConfig = {
     factoryAddress: BaseBondkitTokenFactoryContractAddress,
     apiEndpoint: "https://api.b3.fun/bondkit-tokens",
 };
-export const getConfig = (chainId) => {
+export const getConfig = (chainId, rpcUrl) => {
     if (chainId === base.id) {
-        return baseMainnetConfig;
+        return {
+            ...baseMainnetConfig,
+            rpcUrl: rpcUrl || BaseMainnetRpcUrl,
+        };
     }
     throw new Error(`Unsupported chainId: ${chainId}. This SDK is configured for Base (Chain ID: ${base.id}) only.`);
 };