@clawdvault/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,613 @@
+import { PublicKey, Transaction, VersionedTransaction, Keypair } from '@solana/web3.js';
+export { Keypair, PublicKey } from '@solana/web3.js';
+
+/**
+ * ClawdVault API Types
+ * Generated from OpenAPI spec
+ */
+interface Token {
+    mint: string;
+    name: string;
+    symbol: string;
+    description?: string;
+    image?: string;
+    creator: string;
+    creator_name?: string;
+    price_sol: number;
+    market_cap_sol: number;
+    volume_24h?: number;
+    virtual_sol_reserves: number;
+    virtual_token_reserves: number;
+    real_sol_reserves: number;
+    real_token_reserves: number;
+    graduated: boolean;
+    migrated_to_raydium: boolean;
+    twitter?: string;
+    telegram?: string;
+    website?: string;
+    created_at: string;
+}
+interface Trade {
+    id: string;
+    type: 'buy' | 'sell';
+    sol_amount: number;
+    token_amount: number;
+    price: number;
+    trader: string;
+    signature: string;
+    created_at: string;
+}
+interface ChatMessage {
+    id: string;
+    wallet: string;
+    username?: string;
+    message: string;
+    reply_to?: string;
+    reactions: Record<string, string[]>;
+    created_at: string;
+}
+interface UserProfile {
+    wallet: string;
+    username?: string;
+    avatar?: string;
+    created_at: string;
+}
+interface PrepareCreateRequest {
+    creator: string;
+    name: string;
+    symbol: string;
+    initialBuy?: number;
+}
+interface ExecuteCreateRequest {
+    signedTransaction: string;
+    mint: string;
+    creator: string;
+    name: string;
+    symbol: string;
+    description?: string;
+    image?: string;
+    twitter?: string;
+    telegram?: string;
+    website?: string;
+}
+interface PrepareTradeRequest {
+    mint: string;
+    type: 'buy' | 'sell';
+    amount: number;
+    wallet: string;
+    slippage?: number;
+}
+interface ExecuteTradeRequest {
+    signedTransaction: string;
+    mint: string;
+    type: 'buy' | 'sell';
+    wallet: string;
+}
+interface JupiterSwapRequest {
+    mint: string;
+    action: 'buy' | 'sell';
+    amount: string;
+    userPublicKey: string;
+    slippageBps?: number;
+}
+interface JupiterExecuteRequest {
+    mint: string;
+    signedTransaction: string;
+    type: 'buy' | 'sell';
+    wallet: string;
+    solAmount?: number;
+    tokenAmount?: number;
+}
+interface SendChatRequest {
+    mint: string;
+    message: string;
+    replyTo?: string;
+}
+interface UpdateProfileRequest {
+    username?: string;
+    avatar?: string;
+}
+interface PrepareCreateResponse {
+    success: boolean;
+    transaction: string;
+    mint: string;
+    programId: string;
+    network: string;
+    initialBuy?: {
+        sol: number;
+        estimatedTokens: number;
+    };
+}
+interface ExecuteCreateResponse {
+    success: boolean;
+    signature: string;
+    mint: string;
+    token: Token;
+    explorer: string;
+}
+interface TokenListResponse {
+    tokens: Token[];
+    total: number;
+    page: number;
+    per_page: number;
+}
+interface TokenDetailResponse {
+    token: Token;
+    trades: Trade[];
+}
+interface QuoteResponse {
+    input: number;
+    output: number;
+    price_impact: number;
+    fee: number;
+    current_price: number;
+}
+interface PrepareTradeResponse {
+    success: boolean;
+    transaction: string;
+    type: string;
+    input: {
+        sol?: number;
+        fee?: number;
+        tokens?: number;
+    };
+    output: {
+        tokens?: number;
+        minTokens?: number;
+        sol?: number;
+        minSol?: number;
+    };
+    priceImpact: number;
+    currentPrice: number;
+    onChain: boolean;
+}
+interface ExecuteTradeResponse {
+    success: boolean;
+    signature: string;
+    explorer: string;
+    slot: number;
+    blockTime: number;
+    trade: {
+        id: string;
+        mint: string;
+        trader: string;
+        type: string;
+        solAmount: number;
+        tokenAmount: number;
+        protocolFee: number;
+        creatorFee: number;
+    };
+}
+interface TradeHistoryResponse {
+    trades: Trade[];
+}
+interface CandleData {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+interface CandlesResponse {
+    mint: string;
+    interval: string;
+    candles: CandleData[];
+}
+interface StatsResponse {
+    success: boolean;
+    mint: string;
+    onChain: {
+        totalSupply: number;
+        bondingCurveBalance: number;
+        circulatingSupply: number;
+        bondingCurveSol: number;
+        virtualSolReserves: number;
+        virtualTokenReserves: number;
+        price: number;
+        marketCap: number;
+        graduated: boolean;
+    };
+}
+interface HolderInfo {
+    address: string;
+    balance: number;
+    percentage: number;
+    label?: string;
+}
+interface HoldersResponse {
+    holders: HolderInfo[];
+}
+interface BalanceResponse {
+    balance: number;
+    wallet: string;
+    mint: string;
+}
+interface SolPriceResponse {
+    price: number;
+    valid: boolean;
+    cached: boolean;
+    source: string;
+    age: number;
+}
+interface GraduationStatusResponse {
+    success: boolean;
+    data: {
+        mint: string;
+        graduated: boolean;
+        migratedToRaydium: boolean;
+        realSolReserves: string;
+        realTokenReserves: string;
+        canMigrate: boolean;
+    };
+}
+interface JupiterStatusResponse {
+    success: boolean;
+    mint: string;
+    graduated: boolean;
+    tradeEndpoint: string;
+}
+interface JupiterQuoteResponse {
+    success: boolean;
+    graduated: boolean;
+    quote: {
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        outAmount: string;
+        priceImpactPct: string;
+        slippageBps: number;
+    };
+    transaction: string;
+    lastValidBlockHeight: number;
+}
+interface ChatMessagesResponse {
+    messages: ChatMessage[];
+}
+interface SessionResponse {
+    success: boolean;
+    token: string;
+    expiresIn: number;
+    wallet: string;
+}
+interface SessionValidateResponse {
+    valid: boolean;
+    wallet: string;
+}
+interface UploadResponse {
+    success: boolean;
+    url: string;
+    filename: string;
+}
+interface NetworkStatusResponse {
+    network: string;
+    programId: string;
+    rpcUrl: string;
+    configInitialized: boolean;
+}
+interface TokenListParams {
+    sort?: 'created_at' | 'market_cap' | 'volume' | 'price';
+    page?: number;
+    limit?: number;
+    graduated?: boolean;
+}
+interface QuoteParams {
+    mint: string;
+    type: 'buy' | 'sell';
+    amount: number;
+}
+interface TradesParams {
+    mint: string;
+    limit?: number;
+    before?: string;
+}
+interface CandlesParams {
+    mint: string;
+    interval?: '1m' | '5m' | '15m' | '1h' | '1d';
+    limit?: number;
+}
+interface ChatParams {
+    mint: string;
+    limit?: number;
+    before?: string;
+}
+
+/**
+ * Solana Wallet Integration for ClawdVault SDK
+ * Supports both Keypair (CLI/server) and Phantom (browser) signing
+ */
+
+/**
+ * Abstract signer interface for wallet signing
+ */
+interface WalletSigner {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+}
+/**
+ * Keypair-based signer for CLI/server usage
+ */
+declare class KeypairSigner implements WalletSigner {
+    private _keypair;
+    constructor(keypairOrSecretKey: Keypair | Uint8Array | string);
+    get publicKey(): PublicKey;
+    /**
+     * Get the underlying Keypair (use with caution)
+     */
+    get keypair(): Keypair;
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Load keypair from file path (e.g., Solana CLI wallet)
+     */
+    static fromFile(path: string): KeypairSigner;
+    /**
+     * Load from environment variable
+     */
+    static fromEnv(envVar?: string): KeypairSigner;
+}
+/**
+ * Phantom wallet adapter for browser usage
+ * Compatible with @solana/wallet-adapter
+ */
+interface PhantomWallet {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signMessage(message: Uint8Array): Promise<{
+        signature: Uint8Array;
+    }>;
+    connect(): Promise<{
+        publicKey: PublicKey;
+    }>;
+    disconnect(): Promise<void>;
+    isConnected: boolean;
+}
+/**
+ * Adapter to make Phantom wallet work with WalletSigner interface
+ */
+declare class PhantomSigner implements WalletSigner {
+    private phantom;
+    constructor(phantom: PhantomWallet);
+    get publicKey(): PublicKey;
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Get Phantom from window object (browser only)
+     */
+    static fromWindow(): Promise<PhantomSigner>;
+}
+/**
+ * Sign and serialize a transaction for API submission
+ */
+declare function signAndSerialize(transaction: string, // Base64 encoded
+signer: WalletSigner): Promise<string>;
+/**
+ * Create signature for authenticated API requests
+ */
+declare function createAuthSignature(signer: WalletSigner, payload: object): Promise<{
+    signature: string;
+    wallet: string;
+}>;
+/**
+ * Verify a signature (for server-side validation)
+ */
+declare function verifySignature(message: string, signature: string, publicKey: string): boolean;
+
+/**
+ * ClawdVault API Client
+ * Full TypeScript client with wallet integration
+ */
+
+interface ClawdVaultConfig {
+    baseUrl?: string;
+    signer?: WalletSigner;
+    sessionToken?: string;
+    onError?: (error: Error) => void;
+}
+declare class ClawdVaultClient {
+    private baseUrl;
+    private signer?;
+    private sessionToken?;
+    private onError?;
+    constructor(config?: ClawdVaultConfig);
+    /**
+     * Set the wallet signer for authenticated operations
+     */
+    setSigner(signer: WalletSigner): void;
+    /**
+     * Set session token for authenticated operations
+     */
+    setSessionToken(token: string): void;
+    /**
+     * Get wallet address
+     */
+    getWalletAddress(): string | null;
+    private request;
+    /**
+     * List tokens with optional filters
+     */
+    listTokens(params?: TokenListParams): Promise<TokenListResponse>;
+    /**
+     * Get token details
+     */
+    getToken(mint: string): Promise<TokenDetailResponse>;
+    /**
+     * Get token metadata (Metaplex format)
+     */
+    getMetadata(mint: string): Promise<{
+        name: string;
+        symbol: string;
+        description: string;
+        image: string;
+    }>;
+    /**
+     * Prepare token creation (step 1)
+     */
+    prepareCreate(params: PrepareCreateRequest): Promise<PrepareCreateResponse>;
+    /**
+     * Execute token creation (step 2)
+     */
+    executeCreate(params: ExecuteCreateRequest): Promise<ExecuteCreateResponse>;
+    /**
+     * Create token with automatic signing
+     * Combines prepare + sign + execute in one call
+     */
+    createToken(params: {
+        name: string;
+        symbol: string;
+        description?: string;
+        image?: string;
+        initialBuy?: number;
+        twitter?: string;
+        telegram?: string;
+        website?: string;
+    }): Promise<ExecuteCreateResponse>;
+    /**
+     * Get price quote
+     */
+    getQuote(params: QuoteParams): Promise<QuoteResponse>;
+    /**
+     * Prepare trade transaction (step 1)
+     */
+    prepareTrade(params: PrepareTradeRequest): Promise<PrepareTradeResponse>;
+    /**
+     * Execute trade (step 2)
+     */
+    executeTrade(params: ExecuteTradeRequest): Promise<ExecuteTradeResponse>;
+    /**
+     * Buy tokens with automatic signing
+     */
+    buy(mint: string, solAmount: number, slippage?: number): Promise<ExecuteTradeResponse>;
+    /**
+     * Sell tokens with automatic signing
+     */
+    sell(mint: string, tokenAmount: number, slippage?: number): Promise<ExecuteTradeResponse>;
+    /**
+     * Sell percentage of token holdings
+     */
+    sellPercent(mint: string, percent: number, slippage?: number): Promise<ExecuteTradeResponse>;
+    /**
+     * Get trade history
+     */
+    getTrades(params: TradesParams): Promise<TradeHistoryResponse>;
+    /**
+     * Get OHLCV candles
+     */
+    getCandles(params: CandlesParams): Promise<CandlesResponse>;
+    /**
+     * Get on-chain stats
+     */
+    getStats(mint: string): Promise<StatsResponse>;
+    /**
+     * Get top holders
+     */
+    getHolders(mint: string, creator?: string): Promise<HoldersResponse>;
+    /**
+     * Get wallet token balance
+     */
+    getBalance(wallet: string, mint: string): Promise<BalanceResponse>;
+    /**
+     * Get my balance for a token
+     */
+    getMyBalance(mint: string): Promise<BalanceResponse>;
+    /**
+     * Get SOL/USD price
+     */
+    getSolPrice(): Promise<SolPriceResponse>;
+    /**
+     * Check graduation status
+     */
+    getGraduationStatus(mint: string): Promise<GraduationStatusResponse>;
+    /**
+     * Check Jupiter availability
+     */
+    getJupiterStatus(mint: string): Promise<JupiterStatusResponse>;
+    /**
+     * Get Jupiter swap quote
+     */
+    getJupiterQuote(params: JupiterSwapRequest): Promise<JupiterQuoteResponse>;
+    /**
+     * Execute Jupiter swap
+     */
+    executeJupiterSwap(params: JupiterExecuteRequest): Promise<ExecuteTradeResponse>;
+    /**
+     * Buy graduated token via Jupiter
+     */
+    buyJupiter(mint: string, solAmount: number, slippageBps?: number): Promise<ExecuteTradeResponse>;
+    /**
+     * Sell graduated token via Jupiter
+     */
+    sellJupiter(mint: string, tokenAmount: number, slippageBps?: number): Promise<ExecuteTradeResponse>;
+    /**
+     * Smart buy - automatically routes to bonding curve or Jupiter
+     */
+    smartBuy(mint: string, solAmount: number, slippage?: number): Promise<ExecuteTradeResponse>;
+    /**
+     * Smart sell - automatically routes to bonding curve or Jupiter
+     */
+    smartSell(mint: string, tokenAmount: number, slippage?: number): Promise<ExecuteTradeResponse>;
+    /**
+     * Get chat messages
+     */
+    getChat(params: ChatParams): Promise<ChatMessagesResponse>;
+    /**
+     * Send chat message
+     */
+    sendChat(params: SendChatRequest): Promise<{
+        success: boolean;
+        message: ChatMessage;
+    }>;
+    /**
+     * Add reaction
+     */
+    addReaction(messageId: string, emoji: string): Promise<void>;
+    /**
+     * Remove reaction
+     */
+    removeReaction(messageId: string, emoji: string): Promise<void>;
+    /**
+     * Get user profile
+     */
+    getProfile(wallet: string): Promise<UserProfile>;
+    /**
+     * Update profile
+     */
+    updateProfile(params: UpdateProfileRequest): Promise<void>;
+    /**
+     * Create session token
+     */
+    createSession(): Promise<SessionResponse>;
+    /**
+     * Validate session token
+     */
+    validateSession(): Promise<SessionValidateResponse>;
+    /**
+     * Upload image file
+     */
+    uploadImage(file: File | Buffer | Uint8Array, filename?: string): Promise<UploadResponse>;
+    /**
+     * Upload image from file path (Node.js only)
+     */
+    uploadImageFromPath(filePath: string): Promise<UploadResponse>;
+    /**
+     * Get network status
+     */
+    getNetworkStatus(): Promise<NetworkStatusResponse>;
+}
+/**
+ * Create a new ClawdVault client
+ */
+declare function createClient(config?: ClawdVaultConfig): ClawdVaultClient;
+
+/**
+ * ClawdVault SDK
+ * TypeScript client for ClawdVault token launchpad on Solana
+ *
+ * @packageDocumentation
+ */
+
+declare const PROGRAM_ID = "GUyF2TVe32Cid4iGVt2F6wPYDhLSVmTUZBj2974outYM";
+declare const DEFAULT_BASE_URL = "https://clawdvault.com/api";
+
+export { type BalanceResponse, type CandleData, type CandlesParams, type CandlesResponse, type ChatMessage, type ChatMessagesResponse, type ChatParams, ClawdVaultClient, type ClawdVaultConfig, DEFAULT_BASE_URL, type ExecuteCreateRequest, type ExecuteCreateResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type GraduationStatusResponse, type HolderInfo, type HoldersResponse, type JupiterExecuteRequest, type JupiterQuoteResponse, type JupiterStatusResponse, type JupiterSwapRequest, KeypairSigner, type NetworkStatusResponse, PROGRAM_ID, PhantomSigner, type PhantomWallet, type PrepareCreateRequest, type PrepareCreateResponse, type PrepareTradeRequest, type PrepareTradeResponse, type QuoteParams, type QuoteResponse, type SendChatRequest, type SessionResponse, type SessionValidateResponse, type SolPriceResponse, type StatsResponse, type Token, type TokenDetailResponse, type TokenListParams, type TokenListResponse, type Trade, type TradeHistoryResponse, type TradesParams, type UpdateProfileRequest, type UploadResponse, type UserProfile, type WalletSigner, createAuthSignature, createClient, signAndSerialize, verifySignature };