@clawnch/clawncher-sdk 0.1.2 → 0.2.0

package/dist/wayfinder-types.d.ts

@@ -0,0 +1,324 @@
+/**
+ * Wayfinder Paths SDK Types
+ *
+ * Types for cross-chain swaps, token resolution, multi-chain balances,
+ * and strategy execution via the Wayfinder Paths integration.
+ */
+export interface WayfinderConfig {
+    /** Wayfinder API key (X-API-KEY header) */
+    apiKey: string;
+    /** Wayfinder API base URL (default: https://strategies.wayfinder.ai/api/v1) */
+    apiUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Path to python3 binary (default: auto-detect) */
+    pythonPath?: string;
+}
+export interface PythonStatus {
+    /** Whether python3 is available on PATH */
+    available: boolean;
+    /** Python version string (e.g. "3.12.4") */
+    version?: string;
+    /** Whether wayfinder-paths pip package is installed */
+    wayfinderInstalled: boolean;
+    /** wayfinder-paths version if installed */
+    wayfinderVersion?: string;
+    /** Path to the python3 binary */
+    pythonPath?: string;
+    /** Path to the wayfinder CLI binary */
+    wayfinderCliPath?: string;
+}
+export interface WayfinderTokenDetail {
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Contract address */
+    address: string;
+    /** Chain ID */
+    chainId: number;
+    /** Decimal places */
+    decimals: number;
+    /** CoinGecko ID (e.g. "usd-coin") */
+    coingeckoId?: string;
+    /** Logo URL */
+    logoUrl?: string;
+    /** Current price in USD */
+    priceUsd?: number;
+    /** 24h price change percentage */
+    priceChange24h?: number;
+    /** Market cap in USD */
+    marketCapUsd?: number;
+}
+export interface WayfinderTokenSearchResult {
+    /** Token ID used in Wayfinder (e.g. "usd-coin-base") */
+    tokenId: string;
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Contract address */
+    address: string;
+    /** Chain code (e.g. "base", "ethereum") */
+    chain: string;
+    /** Chain ID */
+    chainId: number;
+    /** Relevance score */
+    score?: number;
+}
+export interface WayfinderQuoteParams {
+    /** Source token (contract address or token ID like "usd-coin") */
+    fromToken: string;
+    /** Destination token (contract address or token ID) */
+    toToken: string;
+    /** Source chain ID */
+    fromChain: number;
+    /** Destination chain ID */
+    toChain: number;
+    /** Sender wallet address */
+    fromWallet: string;
+    /** Amount in WEI / raw token units */
+    amount: string;
+    /** Slippage tolerance (e.g. 0.005 for 0.5%) */
+    slippage?: number;
+}
+export interface WayfinderFeeBreakdownItem {
+    name: string;
+    amount: string;
+    amountUsd: number;
+    token: string;
+    tokenChain: string;
+}
+export interface WayfinderFeeEstimate {
+    feeTotalUsd: number;
+    feeBreakdown: WayfinderFeeBreakdownItem[];
+}
+export interface WayfinderQuoteEntry {
+    /** Aggregator provider (e.g. "lifi", "squid") */
+    provider: string;
+    /** Output amount in raw units */
+    outputAmount: string;
+    /** Input amount in raw units */
+    inputAmount: string;
+    /** Gas estimate */
+    gasEstimate: number | null;
+    /** Error message if this provider failed */
+    error: string | null;
+    /** Input value in USD */
+    inputAmountUsd: number;
+    /** Output value in USD */
+    outputAmountUsd: number;
+    /** Fee breakdown */
+    feeEstimate: WayfinderFeeEstimate;
+    /** Transaction calldata (to, data, value, chainId) */
+    calldata: WayfinderCalldata | null;
+    /** Whether a wrap transaction is needed (native -> WETH) */
+    wrapTransaction: Record<string, unknown> | null;
+    /** Whether an unwrap transaction is needed (WETH -> native) */
+    unwrapTransaction: Record<string, unknown> | null;
+    /** Whether input is native token */
+    nativeInput: boolean;
+    /** Whether output is native token */
+    nativeOutput: boolean;
+}
+export interface WayfinderCalldata {
+    to: string;
+    data: string;
+    value: string;
+    chainId: number;
+}
+export interface WayfinderQuoteResponse {
+    /** All quote entries from different providers */
+    quotes: WayfinderQuoteEntry[];
+    /** Best quote selected by the aggregator */
+    bestQuote: WayfinderQuoteEntry | null;
+    /** Number of providers queried */
+    quoteCount: number;
+}
+export interface WayfinderTokenBalance {
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Contract address */
+    address: string;
+    /** Chain ID */
+    chainId: number;
+    /** Chain name (e.g. "Base", "Ethereum") */
+    chainName: string;
+    /** Balance in raw units */
+    balance: string;
+    /** Balance formatted with decimals */
+    balanceFormatted: string;
+    /** Balance value in USD */
+    balanceUsd: number;
+    /** Token decimals */
+    decimals: number;
+    /** Logo URL */
+    logoUrl?: string;
+    /** Whether this is a spam token */
+    isSpam?: boolean;
+}
+export interface WayfinderBalancesResponse {
+    /** Wallet address */
+    address: string;
+    /** Total portfolio value in USD */
+    totalValueUsd: number;
+    /** Token balances across all chains */
+    tokens: WayfinderTokenBalance[];
+}
+export interface WayfinderActivityEntry {
+    /** Transaction hash */
+    txHash: string;
+    /** Chain ID */
+    chainId: number;
+    /** Block number */
+    blockNumber: number;
+    /** Timestamp (ISO string) */
+    timestamp: string;
+    /** Transaction type (e.g. "swap", "transfer", "approve") */
+    type: string;
+    /** From address */
+    from: string;
+    /** To address */
+    to: string;
+    /** Human-readable summary */
+    summary: string;
+    /** Value in USD */
+    valueUsd?: number;
+}
+export interface WayfinderActivityResponse {
+    address: string;
+    activities: WayfinderActivityEntry[];
+    total: number;
+}
+export interface WayfinderPool {
+    /** Pool ID */
+    id: string;
+    /** Protocol (e.g. "moonwell", "aave", "morpho") */
+    protocol: string;
+    /** Chain ID */
+    chainId: number;
+    /** Pool address */
+    address: string;
+    /** Underlying token symbol */
+    tokenSymbol: string;
+    /** Underlying token address */
+    tokenAddress: string;
+    /** Supply APY */
+    supplyApy: number;
+    /** Borrow APY */
+    borrowApy: number;
+    /** Total supplied in USD */
+    totalSupplyUsd: number;
+    /** Total borrowed in USD */
+    totalBorrowedUsd: number;
+    /** Available liquidity in USD */
+    availableLiquidityUsd: number;
+}
+export interface WayfinderFundingEntry {
+    coin: string;
+    fundingRate: number;
+    timestamp: string;
+}
+export interface WayfinderCandle {
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    timestamp: string;
+}
+export interface WayfinderHyperLendMarket {
+    token: string;
+    tokenAddress: string;
+    supplyApy: number;
+    borrowApy: number;
+    totalSupply: string;
+    totalBorrow: string;
+    availableLiquidity: string;
+    ltv: number;
+}
+export interface WayfinderStrategyInfo {
+    name: string;
+    description: string;
+    chains: number[];
+    riskLevel: string;
+    adapters: string[];
+}
+export interface WayfinderStrategyStatus {
+    portfolioValue: number;
+    netDeposit: number;
+    strategyStatus: unknown;
+    gasAvailable: number;
+    gassedUp: boolean;
+}
+export type WayfinderStrategyAction = 'status' | 'deposit' | 'update' | 'exit' | 'withdraw' | 'analyze' | 'quote';
+export interface WayfinderStrategyParams {
+    /** Strategy name (e.g. "basis_trading_strategy") */
+    strategy: string;
+    /** Action to perform */
+    action: WayfinderStrategyAction;
+    /** Main token amount for deposit */
+    mainTokenAmount?: number;
+    /** Gas token amount for deposit */
+    gasTokenAmount?: number;
+    /** Wallet label override */
+    walletLabel?: string;
+    /** Run on Gorlami fork (dry-run mode) */
+    dryRun?: boolean;
+    /** Additional config overrides as JSON string */
+    config?: string;
+}
+export interface WayfinderStrategyResult {
+    success: boolean;
+    action: string;
+    output: unknown;
+    error?: string;
+}
+export type WayfinderExecuteKind = 'swap' | 'send' | 'hyperliquid_deposit';
+export interface WayfinderExecuteParams {
+    /** Operation kind */
+    kind: WayfinderExecuteKind;
+    /** Wallet label (must match a wallet in wayfinder config.json) */
+    walletLabel: string;
+    /** Amount in human-readable format */
+    amount: string;
+    /** Recipient address (for send) */
+    recipient?: string;
+    /** Source token ID (for swap) */
+    fromToken?: string;
+    /** Destination token ID (for swap) */
+    toToken?: string;
+    /** Slippage in bps (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Deadline in seconds (default: 300) */
+    deadlineSeconds?: number;
+    /** Token to send (for send kind) */
+    token?: string;
+    /** Chain ID override */
+    chainId?: number;
+}
+export interface WayfinderExecuteEffect {
+    txnHash: string;
+    chainId: number;
+    explorerUrl: string;
+}
+export interface WayfinderExecuteResult {
+    ok: boolean;
+    result?: {
+        kind: string;
+        sender: string;
+        recipient: string;
+        preview: string;
+        status: string;
+        effects: Record<string, WayfinderExecuteEffect>;
+        raw?: unknown;
+    };
+    error?: string;
+}
+/** Chains supported by the Wayfinder BRAP aggregator */
+export declare const WAYFINDER_CHAINS: Record<string, number>;
+/** Reverse lookup: chain ID to name */
+export declare const WAYFINDER_CHAIN_NAMES: Record<number, string>;
+//# sourceMappingURL=wayfinder-types.d.ts.map

package/dist/wayfinder-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayfinder-types.d.ts","sourceRoot":"","sources":["../src/wayfinder-types.ts"],"names":[],"mappings":"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"}

package/dist/wayfinder-types.js

@@ -0,0 +1,30 @@
+/**
+ * Wayfinder Paths SDK Types
+ *
+ * Types for cross-chain swaps, token resolution, multi-chain balances,
+ * and strategy execution via the Wayfinder Paths integration.
+ */
+// ============================================================================
+// Supported chains
+// ============================================================================
+/** Chains supported by the Wayfinder BRAP aggregator */
+export const WAYFINDER_CHAINS = {
+    ethereum: 1,
+    base: 8453,
+    arbitrum: 42161,
+    polygon: 137,
+    bsc: 56,
+    avalanche: 43114,
+    hyperEvm: 999,
+};
+/** Reverse lookup: chain ID to name */
+export const WAYFINDER_CHAIN_NAMES = {
+    1: 'Ethereum',
+    8453: 'Base',
+    42161: 'Arbitrum',
+    137: 'Polygon',
+    56: 'BSC',
+    43114: 'Avalanche',
+    999: 'HyperEVM',
+};
+//# sourceMappingURL=wayfinder-types.js.map

package/dist/wayfinder-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayfinder-types.js","sourceRoot":"","sources":["../src/wayfinder-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyYH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,wDAAwD;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,EAAE;IACP,SAAS,EAAE,KAAK;IAChB,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,CAAC,EAAE,UAAU;IACb,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,SAAS;IACd,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,UAAU;CAChB,CAAC"}

package/dist/wayfinder.d.ts

@@ -0,0 +1,175 @@
+/**
+ * WayfinderClient - Cross-chain DeFi via Wayfinder Paths
+ *
+ * Two-tier integration:
+ * - Tier 1 (REST): Swap quotes, token resolution, balances, pool data.
+ *   Always available — calls the Wayfinder API directly.
+ * - Tier 2 (CLI bridge): Execute swaps, run strategies, Hyperliquid trading.
+ *   Requires Python 3.12+ and the wayfinder-paths pip package installed locally.
+ *   Shells out to the `wayfinder` CLI for operations that need local tx signing.
+ *
+ * @example
+ * ```typescript
+ * import { WayfinderClient } from '@clawnch/clawncher-sdk';
+ *
+ * const wf = new WayfinderClient({
+ *   apiKey: 'wk_...',
+ * });
+ *
+ * // Tier 1: Get a cross-chain swap quote (no Python needed)
+ * const quote = await wf.quoteSwap({
+ *   fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC on Ethereum
+ *   toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',   // USDC on Base
+ *   fromChain: 1,
+ *   toChain: 8453,
+ *   fromWallet: '0x...',
+ *   amount: '5000000', // 5 USDC in raw units (6 decimals)
+ * });
+ * console.log('Best route:', quote.bestQuote?.provider);
+ *
+ * // Tier 1: Get multi-chain balances
+ * const balances = await wf.getBalances('0x...');
+ * console.log('Total value:', balances.totalValueUsd);
+ *
+ * // Tier 2: Execute a swap (requires Python + wayfinder-paths)
+ * const status = await wf.checkPython();
+ * if (status.wayfinderInstalled) {
+ *   const result = await wf.executeSwap({
+ *     kind: 'swap',
+ *     walletLabel: 'main',
+ *     amount: '5',
+ *     fromToken: 'usd-coin',
+ *     toToken: 'ethereum',
+ *   });
+ *   console.log('Tx:', result.result?.effects);
+ * }
+ * ```
+ */
+import type { WayfinderConfig, PythonStatus, WayfinderTokenDetail, WayfinderTokenSearchResult, WayfinderQuoteParams, WayfinderQuoteResponse, WayfinderBalancesResponse, WayfinderActivityResponse, WayfinderPool, WayfinderFundingEntry, WayfinderCandle, WayfinderHyperLendMarket, WayfinderStrategyInfo, WayfinderStrategyStatus, WayfinderStrategyParams, WayfinderStrategyResult, WayfinderExecuteParams, WayfinderExecuteResult } from './wayfinder-types.js';
+export declare class WayfinderError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+export declare class WayfinderClient {
+    private readonly apiKey;
+    private readonly apiUrl;
+    private readonly timeout;
+    private readonly pythonPathOverride?;
+    private pythonStatusCache;
+    constructor(config: WayfinderConfig);
+    /**
+     * Check whether Python 3 and wayfinder-paths are available.
+     * Results are cached after the first call.
+     */
+    checkPython(): Promise<PythonStatus>;
+    /**
+     * Clear the cached Python status (e.g. after installing wayfinder-paths).
+     */
+    clearPythonCache(): void;
+    /**
+     * Resolve a token by name, symbol, address, or CoinGecko ID.
+     *
+     * @param query - Token identifier (e.g. "USDC", "0xA0b8...", "usd-coin")
+     * @param chainId - Optional chain ID filter
+     * @param marketData - Include market data (price, market cap)
+     */
+    resolveToken(query: string, chainId?: number, marketData?: boolean): Promise<WayfinderTokenDetail>;
+    /**
+     * Fuzzy search for tokens across chains.
+     *
+     * @param query - Search term
+     * @param chain - Chain code (e.g. "base", "ethereum")
+     */
+    searchTokens(query: string, chain: string): Promise<WayfinderTokenSearchResult[]>;
+    /**
+     * Get the gas token for a chain.
+     *
+     * @param chain - Chain code (e.g. "base", "ethereum")
+     */
+    getGasToken(chain: string): Promise<WayfinderTokenDetail>;
+    /**
+     * Get a cross-chain swap quote via the BRAP aggregator.
+     * Compares routes from multiple providers (LiFi, Squid, etc.)
+     * and returns the best option.
+     *
+     * @param params - Quote parameters (tokens, chains, amount in WEI)
+     */
+    quoteSwap(params: WayfinderQuoteParams): Promise<WayfinderQuoteResponse>;
+    /**
+     * Get enriched multi-chain wallet balances.
+     *
+     * @param walletAddress - Ethereum wallet address
+     * @param excludeSpam - Exclude spam tokens (default: true)
+     */
+    getBalances(walletAddress: string, excludeSpam?: boolean): Promise<WayfinderBalancesResponse>;
+    /**
+     * Get wallet transaction activity.
+     *
+     * @param walletAddress - Ethereum wallet address
+     * @param limit - Max results (default: 20)
+     * @param offset - Pagination offset
+     */
+    getWalletActivity(walletAddress: string, limit?: number, offset?: number): Promise<WayfinderActivityResponse>;
+    /**
+     * Get DeFi pool data (Moonwell, Aave, Morpho, etc.)
+     *
+     * @param chainId - Optional chain ID filter
+     * @param protocol - Optional protocol filter (e.g. "moonwell", "aave")
+     */
+    getPools(chainId?: number, protocol?: string): Promise<WayfinderPool[]>;
+    /**
+     * Get Hyperliquid funding rate history.
+     *
+     * @param coin - Coin symbol (e.g. "BTC", "ETH")
+     * @param startMs - Start timestamp in milliseconds
+     * @param endMs - End timestamp in milliseconds
+     */
+    getHyperliquidFunding(coin: string, startMs?: number, endMs?: number): Promise<WayfinderFundingEntry[]>;
+    /**
+     * Get Hyperliquid OHLCV candle data.
+     *
+     * @param coin - Coin symbol
+     * @param interval - Candle interval (e.g. "1h", "4h", "1d")
+     * @param startMs - Start timestamp in milliseconds
+     * @param endMs - End timestamp in milliseconds
+     */
+    getHyperliquidCandles(coin: string, interval: string, startMs?: number, endMs?: number): Promise<WayfinderCandle[]>;
+    /**
+     * Get HyperLend stable market data.
+     */
+    getHyperLendMarkets(): Promise<WayfinderHyperLendMarket[]>;
+    /**
+     * Execute a swap, send, or Hyperliquid deposit via the Wayfinder CLI.
+     * Signs transactions locally using wallets from wayfinder config.json.
+     *
+     * Requires Python 3.12+ and wayfinder-paths installed.
+     */
+    executeSwap(params: WayfinderExecuteParams): Promise<WayfinderExecuteResult>;
+    /**
+     * Run a Wayfinder strategy action (status, deposit, update, exit, etc.)
+     *
+     * Requires Python 3.12+ and wayfinder-paths installed.
+     */
+    runStrategy(params: WayfinderStrategyParams): Promise<WayfinderStrategyResult>;
+    /**
+     * List available Wayfinder strategies.
+     *
+     * Requires Python 3.12+ and wayfinder-paths installed.
+     */
+    listStrategies(): Promise<WayfinderStrategyInfo[]>;
+    /**
+     * Get the status of a specific strategy.
+     *
+     * Requires Python 3.12+ and wayfinder-paths installed.
+     */
+    getStrategyStatus(name: string): Promise<WayfinderStrategyStatus>;
+    private restRequest;
+    private cliExec;
+    private parseTokenDetail;
+    private parseFuzzySearchResults;
+    private parseBRAPQuoteResponse;
+    private parseBalancesResponse;
+    private parseStrategyList;
+}
+//# sourceMappingURL=wayfinder.d.ts.map

package/dist/wayfinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayfinder.d.ts","sourceRoot":"","sources":["../src/wayfinder.ts"],"names":[],"mappings":"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"}