@cedros/trade-react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,600 @@
+import { default as default_2 } from 'react';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+
+export declare function ActionNotificationBadge({ walletAddress, onClick, className }: ActionNotificationBadgeProps): JSX_2.Element | null;
+
+export declare interface ActionNotificationBadgeProps {
+    walletAddress?: string;
+    onClick?: () => void;
+    className?: string;
+}
+
+export declare function ActionQueue({ walletAddress, onSign, className }: ActionQueueProps): JSX_2.Element | null;
+
+export declare interface ActionQueueProps {
+    walletAddress?: string;
+    onSign?: (transaction: string) => Promise<string>;
+    className?: string;
+}
+
+export declare interface CedrosTradeConfig {
+    /** Base URL of the cedros-trade server (e.g. "/api/trade" or "https://trade.example.com") */
+    serverUrl: string;
+    /** Function to get the auth token (from cedros-login or custom auth) */
+    getAccessToken?: () => string | null;
+    /** Optional API key for rate-limited access */
+    apiKey?: string;
+    /** Default slippage in bps */
+    defaultSlippageBps?: number;
+    /** Chart type: 'tradingview' | 'lightweight' */
+    chartType?: 'tradingview' | 'lightweight';
+}
+
+export declare function CedrosTradeProvider({ config, children }: CedrosTradeProviderProps): JSX_2.Element;
+
+export declare interface CedrosTradeProviderProps {
+    config: CedrosTradeConfig;
+    children: default_2.ReactNode;
+}
+
+export declare function ChartContainer({ chartType, symbol, theme, chartData, className }: ChartContainerProps): JSX_2.Element;
+
+export declare interface ChartContainerProps {
+    chartType: 'tradingview' | 'lightweight';
+    symbol: string;
+    theme?: 'light' | 'dark';
+    chartData?: {
+        time: string;
+        open: number;
+        high: number;
+        low: number;
+        close: number;
+    }[];
+    className?: string;
+}
+
+export declare interface DcaOrder {
+    dcaAccountId: string;
+    inputMint: string;
+    outputMint: string;
+    totalInAmount: string;
+    perCycleAmount: string;
+    cycleInterval: number;
+    completedCycles: number;
+    totalCycles: number;
+    totalOutReceived: string;
+    status: string;
+    nextCycleAt?: string;
+}
+
+export declare function ErrorMessage({ message, className, onDismiss }: ErrorMessageProps): JSX_2.Element | null;
+
+export declare interface ErrorMessageProps {
+    message: string | null;
+    className?: string;
+    onDismiss?: () => void;
+}
+
+export declare interface ExecuteResult {
+    signature: string;
+    status: 'confirmed' | 'submitted' | 'failed';
+}
+
+export declare interface Holding {
+    mint: string;
+    symbol?: string;
+    balance: string;
+    decimals: number;
+    uiBalance: string;
+    currentPrice?: string;
+    currentValue?: string;
+}
+
+export declare function LightweightChart({ data, theme, className }: LightweightChartProps): JSX_2.Element;
+
+export declare interface LightweightChartProps {
+    data?: {
+        time: string;
+        open: number;
+        high: number;
+        low: number;
+        close: number;
+    }[];
+    theme?: 'light' | 'dark';
+    className?: string;
+}
+
+export declare function LoadingSpinner({ className }: {
+    className?: string;
+}): JSX_2.Element;
+
+export declare interface OpenOrder {
+    orderId: string;
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    filled: string;
+    status: string;
+    orderType: 'limit' | 'stop-loss' | 'take-profit';
+    triggerPrice?: string;
+    createdAt?: string;
+    expiry?: string;
+}
+
+export declare function OpenOrdersTable({ limitOrders, dcaOrders, isLoading, onCancel, className }: OpenOrdersTableProps): JSX_2.Element;
+
+export declare interface OpenOrdersTableProps {
+    limitOrders: OpenOrder[];
+    dcaOrders: DcaOrder[];
+    isLoading: boolean;
+    onCancel?: (orderId: string) => void;
+    className?: string;
+}
+
+export declare function OrderForm({ walletAddress, inputMint, outputMint, inputSymbol, outputSymbol, currentPrice, onSign, onSuccess, className, }: OrderFormProps): JSX_2.Element;
+
+export declare interface OrderFormProps {
+    walletAddress?: string;
+    inputMint: string;
+    outputMint: string;
+    inputSymbol?: string;
+    outputSymbol?: string;
+    currentPrice?: number;
+    onSign?: (transaction: string) => Promise<string>;
+    onSuccess?: (orderId: string) => void;
+    className?: string;
+}
+
+export declare interface PendingAction {
+    id: string;
+    walletAddress: string;
+    orderId: string;
+    actionType: string;
+    transaction: string;
+    reason: string;
+    status: string;
+    createdAt: string;
+    expiresAt: string;
+    txSignature?: string;
+}
+
+export declare function PortfolioPage({ walletAddress, className }: PortfolioPageProps): JSX_2.Element;
+
+export declare interface PortfolioPageProps {
+    walletAddress?: string;
+    className?: string;
+}
+
+export declare interface PositionsResponse {
+    holdings: Holding[];
+    openOrders: number;
+    totalValue: string;
+}
+
+export declare function PositionsTable({ holdings, isLoading, totalValue, className }: PositionsTableProps): JSX_2.Element;
+
+export declare interface PositionsTableProps {
+    holdings: Holding[];
+    isLoading: boolean;
+    totalValue?: string;
+    className?: string;
+}
+
+export declare interface PriceSnapshot {
+    mint: string;
+    priceUsd: number;
+    sources: {
+        name: string;
+        priceUsd: number;
+        stale: boolean;
+    }[];
+    degraded: boolean;
+    marketCap?: number;
+    volume24h?: number;
+    priceChange24hPct?: number;
+}
+
+export declare interface ProviderInfo {
+    name: string;
+    enabled: boolean;
+    capabilities: {
+        name: string;
+        gasless: boolean;
+        mevProtected: boolean;
+        supportsExactOut: boolean;
+    };
+    health: {
+        name: string;
+        healthy: boolean;
+        latencyMs?: number;
+        error?: string;
+    };
+}
+
+export declare function SlippageControl({ value, onChange, className }: SlippageControlProps): JSX_2.Element;
+
+export declare interface SlippageControlProps {
+    value: number;
+    onChange: (bps: number) => void;
+    className?: string;
+}
+
+export declare function SwapForm({ walletAddress, onSign, onSuccess, onError, defaultInputMint, defaultOutputMint, className, }: SwapFormProps): JSX_2.Element;
+
+export declare interface SwapFormProps {
+    /** User's wallet public key */
+    walletAddress?: string;
+    /** Called with the unsigned transaction for signing */
+    onSign?: (transaction: string, provider: string, requestId?: string) => Promise<string>;
+    /** Called after successful execution */
+    onSuccess?: (signature: string) => void;
+    onError?: (error: string) => void;
+    defaultInputMint?: string;
+    defaultOutputMint?: string;
+    className?: string;
+}
+
+export declare function SwapPage({ title, ...formProps }: SwapPageProps): JSX_2.Element;
+
+export declare interface SwapPageProps extends SwapFormProps {
+    title?: string;
+}
+
+export declare interface SwapQuote {
+    provider: string;
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    otherAmountThreshold?: string;
+    priceImpactPct: number;
+    slippageBps: number;
+    routeData?: unknown;
+    gasless: boolean;
+}
+
+export declare interface SwapTransaction {
+    transaction: string;
+    gasless: boolean;
+    lastValidBlockHeight?: number;
+    requestId?: string;
+}
+
+export declare interface TokenRecord {
+    mint: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    logoUrl?: string;
+    coingeckoId?: string;
+    tradingviewSymbol?: string;
+    categories: string[];
+}
+
+export declare function TokenSelector({ isOpen, onClose, onSelect, excludeMints, className }: TokenSelectorProps): JSX_2.Element | null;
+
+export declare interface TokenSelectorProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSelect: (token: TokenRecord) => void;
+    /** Mints to exclude from the list (e.g. the other side of the pair) */
+    excludeMints?: string[];
+    className?: string;
+}
+
+export declare class TradeApiClient {
+    private baseUrl;
+    private tokenFn?;
+    private apiKey?;
+    constructor(baseUrl: string, tokenFn?: (() => string | null) | undefined, apiKey?: string | undefined);
+    private request;
+    private get;
+    private post;
+    private del;
+    getTokens(category?: string): Promise<{
+        tokens: TokenRecord[];
+        count: number;
+    }>;
+    getToken(mint: string): Promise<TokenRecord>;
+    getQuote(params: {
+        inputMint: string;
+        outputMint: string;
+        amount: string;
+        slippageBps?: number;
+        provider?: string;
+    }): Promise<SwapQuote>;
+    buildSwap(quote: SwapQuote, userPublicKey: string): Promise<SwapTransaction>;
+    compareQuotes(inputMint: string, outputMint: string, amount: string): Promise<SwapQuote[]>;
+    executeSwap(signedTransaction: string, provider: string, requestId?: string): Promise<ExecuteResult>;
+    getProviders(): Promise<ProviderInfo[]>;
+    getPrice(mint: string): Promise<PriceSnapshot>;
+    getBatchPrices(mints: string[]): Promise<{
+        prices: PriceSnapshot[];
+    }>;
+    buildTransfer(params: {
+        sender: string;
+        recipient: string;
+        mint: string;
+        amount: string;
+        memo?: string;
+    }): Promise<TransferBuildResponse>;
+    executeTransfer(signedTransaction: string): Promise<ExecuteResult>;
+    resolveAddress(address: string): Promise<{
+        input: string;
+        resolved: string;
+        type: string;
+    }>;
+    createLimitOrder(params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        outAmount: string;
+        expiry?: string;
+    }): Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+    createStopLoss(params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        triggerPrice: string;
+        slippageBps?: number;
+    }): Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+    createTakeProfit(params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        triggerPrice: string;
+        slippageBps?: number;
+    }): Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+    createDca(params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        totalInAmount: string;
+        perCycleAmount: string;
+        cycleInterval: number;
+    }): Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+    cancelOrder(orderId: string, maker: string): Promise<{
+        transaction: string;
+    }>;
+    getOpenOrders(wallet: string): Promise<{
+        limitOrders: OpenOrder[];
+        dcaOrders: DcaOrder[];
+    }>;
+    getPositions(wallet: string): Promise<PositionsResponse>;
+    getPendingActions(wallet: string): Promise<PendingAction[]>;
+    completeAction(actionId: string, signedTransaction: string): Promise<{
+        actionId: string;
+        status: string;
+        signature: string;
+    }>;
+    dismissAction(actionId: string): Promise<{
+        actionId: string;
+        status: string;
+    }>;
+    getHealth(): Promise<{
+        status: string;
+        version: string;
+    }>;
+}
+
+export declare class TradeApiError extends Error {
+    status: number;
+    code: string;
+    constructor(status: number, code: string, message: string);
+}
+
+declare interface TradeContextValue {
+    api: TradeApiClient;
+    config: CedrosTradeConfig;
+}
+
+export declare function TradingPage({ walletAddress, inputMint, outputMint, inputSymbol, outputSymbol, tradingViewSymbol, chartType, manifestMarket, theme, onSign, onOrderSuccess, className, }: TradingPageProps): JSX_2.Element;
+
+export declare interface TradingPageProps {
+    walletAddress?: string;
+    inputMint?: string;
+    outputMint?: string;
+    inputSymbol?: string;
+    outputSymbol?: string;
+    tradingViewSymbol?: string;
+    chartType?: 'tradingview' | 'lightweight';
+    /** Manifest market address for orderbook (optional — hides orderbook if not set) */
+    manifestMarket?: string;
+    theme?: 'light' | 'dark';
+    onSign?: (transaction: string) => Promise<string>;
+    onOrderSuccess?: (orderId: string) => void;
+    className?: string;
+}
+
+export declare function TradingViewChart({ symbol, interval, theme, className, }: TradingViewChartProps): JSX_2.Element;
+
+export declare interface TradingViewChartProps {
+    symbol: string;
+    interval?: string;
+    theme?: 'light' | 'dark';
+    className?: string;
+}
+
+export declare interface TransferBuildResponse {
+    transaction: string;
+    recipientResolved: string;
+    recipientType: 'address' | 'domain';
+    lastValidBlockHeight: number;
+    createsAta: boolean;
+}
+
+export declare function TransferForm({ walletAddress, onSign, onSuccess, onError, className }: TransferFormProps): JSX_2.Element;
+
+export declare interface TransferFormProps {
+    walletAddress?: string;
+    onSign?: (transaction: string) => Promise<string>;
+    onSuccess?: (signature: string) => void;
+    onError?: (error: string) => void;
+    className?: string;
+}
+
+export declare function TransferPage(props: TransferPageProps): JSX_2.Element;
+
+export declare interface TransferPageProps extends TransferFormProps {
+}
+
+export declare function useActionQueue(walletAddress: string | null): UseActionQueueReturn;
+
+export declare interface UseActionQueueReturn {
+    actions: PendingAction[];
+    count: number;
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    complete: (actionId: string, signedTransaction: string) => Promise<void>;
+    dismiss: (actionId: string) => Promise<void>;
+}
+
+export declare function useLimitOrder(): UseLimitOrderReturn;
+
+export declare interface UseLimitOrderReturn {
+    isLoading: boolean;
+    error: string | null;
+    createLimit: (params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        outAmount: string;
+        expiry?: string;
+    }) => Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+    createStopLoss: (params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        triggerPrice: string;
+        slippageBps?: number;
+    }) => Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+    createTakeProfit: (params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        triggerPrice: string;
+        slippageBps?: number;
+    }) => Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+    createDca: (params: {
+        maker: string;
+        inputMint: string;
+        outputMint: string;
+        totalInAmount: string;
+        perCycleAmount: string;
+        cycleInterval: number;
+    }) => Promise<{
+        transaction: string;
+        orderId: string;
+    }>;
+}
+
+export declare function useOpenOrders(walletAddress: string | null): UseOpenOrdersReturn;
+
+export declare interface UseOpenOrdersReturn {
+    limitOrders: OpenOrder[];
+    dcaOrders: DcaOrder[];
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    cancelOrder: (orderId: string, maker: string) => Promise<{
+        transaction: string;
+    }>;
+}
+
+export declare function usePositions(walletAddress: string | null): UsePositionsReturn;
+
+export declare interface UsePositionsReturn {
+    positions: PositionsResponse | null;
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+}
+
+export declare function usePrices(): UsePricesReturn;
+
+export declare interface UsePricesReturn {
+    prices: Record<string, PriceSnapshot>;
+    isLoading: boolean;
+    error: string | null;
+    getPrice: (mint: string) => Promise<PriceSnapshot>;
+    subscribe: (mints: string[]) => void;
+    unsubscribe: (mints: string[]) => void;
+}
+
+export declare function useSwap(): UseSwapReturn;
+
+export declare interface UseSwapReturn {
+    quote: SwapQuote | null;
+    transaction: SwapTransaction | null;
+    result: ExecuteResult | null;
+    isLoading: boolean;
+    error: string | null;
+    getQuote: (inputMint: string, outputMint: string, amount: string, slippageBps?: number) => Promise<SwapQuote>;
+    buildTransaction: (quote: SwapQuote, userPublicKey: string) => Promise<SwapTransaction>;
+    execute: (signedTransaction: string, provider: string, requestId?: string) => Promise<ExecuteResult>;
+    compareProviders: (inputMint: string, outputMint: string, amount: string) => Promise<SwapQuote[]>;
+    reset: () => void;
+}
+
+export declare function useTokens(): UseTokensReturn;
+
+export declare interface UseTokensReturn {
+    tokens: TokenRecord[];
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    getByMint: (mint: string) => TokenRecord | undefined;
+    getBySymbol: (symbol: string) => TokenRecord | undefined;
+}
+
+export declare function useTradeApi(): TradeApiClient;
+
+export declare function useTradeContext(): TradeContextValue;
+
+export declare function useTransfer(): UseTransferReturn;
+
+export declare interface UseTransferReturn {
+    buildResult: TransferBuildResponse | null;
+    executeResult: ExecuteResult | null;
+    isLoading: boolean;
+    error: string | null;
+    build: (sender: string, recipient: string, mint: string, amount: string, memo?: string) => Promise<TransferBuildResponse>;
+    execute: (signedTransaction: string) => Promise<ExecuteResult>;
+    resolveAddress: (address: string) => Promise<{
+        input: string;
+        resolved: string;
+        type: string;
+    }>;
+    reset: () => void;
+}
+
+export { }