@clawnch/clawncher-sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,358 @@
+/**
+ * Clawncher SDK
+ *
+ * TypeScript SDK for deploying tokens on Base with Uniswap V4 pools.
+ * Deploys through Clanker's approved infrastructure for immediate tradability.
+ *
+ * ## Deploying Tokens
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchDeployer } from '@clawnch/clawncher-sdk';
+ * import { createWalletClient, createPublicClient, http } from 'viem';
+ * import { privateKeyToAccount } from 'viem/accounts';
+ * import { base } from 'viem/chains';
+ *
+ * const account = privateKeyToAccount('0x...');
+ * const wallet = createWalletClient({
+ *   account,
+ *   chain: base,
+ *   transport: http(),
+ * });
+ * const publicClient = createPublicClient({
+ *   chain: base,
+ *   transport: http(),
+ * });
+ *
+ * const deployer = new ClawnchDeployer({
+ *   wallet,
+ *   publicClient,
+ *   network: 'mainnet',
+ * });
+ *
+ * const result = await deployer.deploy({
+ *   name: 'My Token',
+ *   symbol: 'MYTKN',
+ *   tokenAdmin: account.address,
+ *   rewards: {
+ *     recipients: [{
+ *       recipient: account.address,
+ *       admin: account.address,
+ *       bps: 10000, // 100%
+ *       feePreference: 'Paired', // Receive fees in WETH
+ *     }],
+ *   },
+ * });
+ *
+ * const { address } = await result.waitForTransaction();
+ * console.log('Token deployed:', address);
+ * ```
+ *
+ * ## API Client (Optional)
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchClient } from '@clawnch/clawncher-sdk';
+ *
+ * const client = new ClawnchClient();
+ *
+ * // Get all tokens
+ * const tokens = await client.getTokens();
+ *
+ * // Check available fees
+ * const fees = await client.getAvailableFees('0x...');
+ * ```
+ */
+export * from './types.js';
+export * from './molten.js';
+// Structured error codes
+export * from './errors.js';
+// Token deployment (via Clanker infrastructure)
+export * from './deployer.js';
+export * from './addresses.js';
+export * from './abis.js';
+// On-chain reading
+export * from './reader.js';
+// Fee/vault claiming
+export * from './claimer.js';
+// Portfolio tracking
+export * from './portfolio.js';
+// Live event watching
+export * from './watcher.js';
+// Token swaps (0x API)
+export * from './swap.js';
+export * from './swap-types.js';
+// Uniswap V3/V4 liquidity management
+export * from './liquidity.js';
+export * from './liquidity-types.js';
+export * from './uniswap-addresses.js';
+export * from './uniswap-abis.js';
+// Verified agent launches (via Clawnch API)
+export * from './api-deployer.js';
+export * from './api-deployer-types.js';
+// Simple validation helpers
+const isValidAddress = (addr) => /^0x[a-fA-F0-9]{40}$/.test(addr);
+const isValidUrl = (url) => {
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'https:' || parsed.protocol === 'http:';
+    }
+    catch {
+        return false;
+    }
+};
+export class ClawnchClient {
+    baseUrl;
+    moltbookKey;
+    timeout;
+    constructor(options = {}) {
+        // Validate baseUrl if provided
+        const baseUrl = options.baseUrl || 'https://clawn.ch';
+        if (!isValidUrl(baseUrl)) {
+            throw new Error('Invalid baseUrl: must be a valid HTTP(S) URL');
+        }
+        this.baseUrl = baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.moltbookKey = options.moltbookKey;
+        this.timeout = options.timeout || 30000;
+    }
+    /**
+     * Make an API request
+     */
+    async request(path, options = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            ...options.headers,
+        };
+        if (this.moltbookKey) {
+            headers['X-Moltbook-Key'] = this.moltbookKey;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                let errorData;
+                try {
+                    errorData = await response.json();
+                }
+                catch {
+                    errorData = { error: `HTTP ${response.status}: ${response.statusText}` };
+                }
+                throw new ClawnchError(errorData.error, response.status, errorData.errors);
+            }
+            return response.json();
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err instanceof ClawnchError) {
+                throw err;
+            }
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new ClawnchError('Request timeout', 408);
+            }
+            throw new ClawnchError(err instanceof Error ? err.message : 'Unknown error', 0);
+        }
+    }
+    // =========================================================================
+    // Token Operations (Read)
+    // =========================================================================
+    /**
+     * Get all tokens launched via Clawncher
+     */
+    async getTokens() {
+        const response = await this.request('/api/tokens');
+        return response.tokens;
+    }
+    /**
+     * Get a single token by symbol
+     */
+    async getTokenBySymbol(symbol) {
+        const response = await this.request(`/api/tokens?symbol=${encodeURIComponent(symbol)}`);
+        return response.tokens[0] || null;
+    }
+    /**
+     * Get launch history with optional filters
+     */
+    async getLaunches(filters = {}) {
+        const params = new URLSearchParams();
+        if (filters.limit)
+            params.set('limit', filters.limit.toString());
+        if (filters.offset)
+            params.set('offset', filters.offset.toString());
+        if (filters.agent)
+            params.set('agent', filters.agent);
+        if (filters.source)
+            params.set('source', filters.source);
+        if (filters.address)
+            params.set('address', filters.address);
+        const query = params.toString();
+        return this.request(`/api/launches${query ? `?${query}` : ''}`);
+    }
+    /**
+     * Get a single launch by contract address
+     */
+    async getLaunch(address) {
+        const response = await this.getLaunches({ address });
+        return response.launches[0] || null;
+    }
+    /**
+     * Get market statistics
+     */
+    async getStats() {
+        return this.request('/api/stats');
+    }
+    // =========================================================================
+    // Preview / Validation
+    // =========================================================================
+    /**
+     * Validate a launch post before publishing
+     *
+     * @param content - The full post content including !clawnch trigger
+     * @returns Validation result with parsed data, errors, and warnings
+     *
+     * @example
+     * ```typescript
+     * const result = await client.preview(`
+     * !clawnch
+     * name: My Token
+     * symbol: MYTKN
+     * wallet: 0x1234...
+     * description: A test token
+     * image: https://iili.io/example.jpg
+     * `);
+     *
+     * if (result.valid) {
+     *   console.log('Ready to post!', result.parsed);
+     * } else {
+     *   console.log('Errors:', result.errors);
+     * }
+     * ```
+     */
+    async preview(content) {
+        return this.request('/api/preview', {
+            method: 'POST',
+            body: JSON.stringify({ content }),
+        });
+    }
+    // =========================================================================
+    // Fee Operations
+    // =========================================================================
+    /**
+     * Check available fees for a wallet
+     *
+     * @param wallet - Ethereum wallet address
+     * @param tokens - Optional comma-separated list of token addresses to check
+     */
+    async getAvailableFees(wallet, tokens) {
+        const params = new URLSearchParams({ wallet });
+        if (tokens)
+            params.set('tokens', tokens);
+        return this.request(`/api/fees/available?${params.toString()}`);
+    }
+    /**
+     * Claim fees for a token
+     *
+     * Requires Moltbook API key (set in constructor) or the wallet must be
+     * the deployer of the token.
+     *
+     * @param tokenAddress - Token contract address
+     */
+    async claimFees(tokenAddress) {
+        const body = {
+            token_address: tokenAddress,
+        };
+        if (this.moltbookKey) {
+            body.moltbook_key = this.moltbookKey;
+        }
+        return this.request('/api/fees/claim', {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    // =========================================================================
+    // Analytics
+    // =========================================================================
+    /**
+     * Get detailed analytics for a token
+     */
+    async getTokenAnalytics(address) {
+        return this.request(`/api/analytics/token?address=${encodeURIComponent(address)}`);
+    }
+    /**
+     * Get analytics for an agent (all their tokens)
+     */
+    async getAgentAnalytics(name) {
+        return this.request(`/api/analytics/agent?name=${encodeURIComponent(name)}`);
+    }
+    /**
+     * Get the agent leaderboard
+     *
+     * @param sort - Sort metric: 'market_cap' | 'volume' | 'launches'
+     * @param limit - Number of results (default 20, max 100)
+     */
+    async getLeaderboard(sort = 'market_cap', limit = 20) {
+        return this.request(`/api/analytics/leaderboard?sort=${sort}&limit=${limit}`);
+    }
+    // =========================================================================
+    // Utilities
+    // =========================================================================
+    /**
+     * Upload an image for use as a token logo
+     *
+     * @param image - Base64-encoded image data OR URL to re-host
+     * @param name - Optional filename
+     * @returns Direct image URL (iili.io)
+     */
+    async uploadImage(image, name) {
+        const body = { image };
+        if (name)
+            body.name = name;
+        const response = await this.request('/api/upload', {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+        return response.url;
+    }
+    /**
+     * Get the skill documentation
+     */
+    async getSkill() {
+        const response = await fetch(`${this.baseUrl}/skill.md`, {
+            method: 'GET',
+            headers: { 'Accept': 'text/markdown' }
+        });
+        if (!response.ok) {
+            throw new ClawnchError('Failed to fetch skill documentation', response.status);
+        }
+        return response.text();
+    }
+    /**
+     * Get the OpenAPI specification
+     */
+    async getOpenAPISpec() {
+        return this.request('/api/openapi');
+    }
+}
+/**
+ * Custom error class for Clawnch API errors
+ */
+export class ClawnchError extends Error {
+    status;
+    errors;
+    constructor(message, status, errors) {
+        super(message);
+        this.status = status;
+        this.errors = errors;
+        this.name = 'ClawnchError';
+    }
+}
+// Default export for convenience
+export default ClawnchClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/liquidity-types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Uniswap V3 & V4 Liquidity Management Types
+ *
+ * Types for the ClawnchLiquidity class which manages liquidity
+ * positions on both Uniswap V3 and V4 pools on Base.
+ */
+import type { Address, Hash, Hex, TransactionReceipt } from 'viem';
+import type { WalletClient, PublicClient, Chain, Account, Transport } from 'viem';
+import type { NetworkName } from './addresses.js';
+export interface LiquidityConfig {
+    /** Wallet client for signing and sending transactions */
+    wallet: WalletClient<Transport, Chain, Account>;
+    /** Public client for reading chain state */
+    publicClient: PublicClient;
+    /** Network: 'mainnet' (Base) or 'sepolia' (Base Sepolia) */
+    network?: NetworkName;
+}
+export interface V4PoolKey {
+    currency0: Address;
+    currency1: Address;
+    fee: number;
+    tickSpacing: number;
+    hooks: Address;
+}
+export interface V4PoolState {
+    sqrtPriceX96: bigint;
+    tick: number;
+    liquidity: bigint;
+    poolId: Hex;
+}
+export interface V4MintParams {
+    /** Token 0 address (lower address) */
+    token0: Address;
+    /** Token 1 address (higher address) */
+    token1: Address;
+    /** Fee tier in hundredths of a bps (e.g. 500 = 0.05%, 3000 = 0.3%, 10000 = 1%) */
+    fee: number;
+    /** Tick spacing for the pool */
+    tickSpacing: number;
+    /** Hook contract address (zero address if no hook) */
+    hookAddress?: Address;
+    /** Lower tick boundary */
+    tickLower: number;
+    /** Upper tick boundary */
+    tickUpper: number;
+    /** Desired amount of token0 to deposit */
+    amount0Desired: bigint;
+    /** Desired amount of token1 to deposit */
+    amount1Desired: bigint;
+    /** Max slippage in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Transaction deadline in seconds from now (default: 1200 = 20 min) */
+    deadline?: number;
+    /** Recipient of the position NFT (defaults to wallet address) */
+    recipient?: Address;
+    /** Whether to use native ETH (if one of the tokens is WETH) */
+    useNativeEth?: boolean;
+}
+export interface V4AddLiquidityParams {
+    /** Desired amount of token0 to add */
+    amount0Desired: bigint;
+    /** Desired amount of token1 to add */
+    amount1Desired: bigint;
+    /** Max slippage in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Transaction deadline in seconds from now (default: 1200 = 20 min) */
+    deadline?: number;
+    /** Whether to use native ETH (if one of the tokens is WETH) */
+    useNativeEth?: boolean;
+}
+export interface V4RemoveLiquidityParams {
+    /** Fraction to remove: 0.0 - 1.0 (1.0 = remove all) */
+    percentageToRemove: number;
+    /** Max slippage in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Transaction deadline in seconds from now (default: 1200 = 20 min) */
+    deadline?: number;
+    /** Burn the position NFT if removing 100% */
+    burnToken?: boolean;
+}
+export interface V4CollectFeesParams {
+    /** Recipient of the collected fees (defaults to wallet address) */
+    recipient?: Address;
+    /** Max slippage in basis points (default: 0 for fee collection) */
+    slippageBps?: number;
+    /** Transaction deadline in seconds from now (default: 1200 = 20 min) */
+    deadline?: number;
+}
+export interface V3MintParams {
+    /** Token 0 address (lower address) */
+    token0: Address;
+    /** Token 1 address (higher address) */
+    token1: Address;
+    /** Fee tier (500, 3000, or 10000) */
+    fee: number;
+    /** Lower tick boundary */
+    tickLower: number;
+    /** Upper tick boundary */
+    tickUpper: number;
+    /** Desired amount of token0 to deposit */
+    amount0Desired: bigint;
+    /** Desired amount of token1 to deposit */
+    amount1Desired: bigint;
+    /** Minimum amount of token0 (slippage protection) */
+    amount0Min?: bigint;
+    /** Minimum amount of token1 (slippage protection) */
+    amount1Min?: bigint;
+    /** Recipient of the position NFT (defaults to wallet address) */
+    recipient?: Address;
+    /** Transaction deadline in seconds from now (default: 1200 = 20 min) */
+    deadline?: number;
+}
+export interface V3AddLiquidityParams {
+    /** Desired amount of token0 to add */
+    amount0Desired: bigint;
+    /** Desired amount of token1 to add */
+    amount1Desired: bigint;
+    /** Minimum amount of token0 (slippage protection) */
+    amount0Min?: bigint;
+    /** Minimum amount of token1 (slippage protection) */
+    amount1Min?: bigint;
+    /** Transaction deadline in seconds from now (default: 1200 = 20 min) */
+    deadline?: number;
+}
+export interface V3RemoveLiquidityParams {
+    /** Fraction to remove: 0.0 - 1.0 (1.0 = remove all) */
+    percentageToRemove: number;
+    /** Minimum amount of token0 to receive (slippage protection) */
+    amount0Min?: bigint;
+    /** Minimum amount of token1 to receive (slippage protection) */
+    amount1Min?: bigint;
+    /** Transaction deadline in seconds from now (default: 1200 = 20 min) */
+    deadline?: number;
+    /** Burn the position NFT if removing 100% and collecting all tokens */
+    burnToken?: boolean;
+}
+export interface V3CollectFeesParams {
+    /** Recipient of the collected fees (defaults to wallet address) */
+    recipient?: Address;
+}
+export interface PositionInfo {
+    /** NFT token ID */
+    tokenId: bigint;
+    /** Uniswap version */
+    version: 'v3' | 'v4';
+    /** Token 0 address */
+    token0: Address;
+    /** Token 1 address */
+    token1: Address;
+    /** Fee tier */
+    fee: number;
+    /** Lower tick */
+    tickLower: number;
+    /** Upper tick */
+    tickUpper: number;
+    /** Current liquidity */
+    liquidity: bigint;
+    /** Unclaimed fees */
+    unclaimedFees: {
+        token0: bigint;
+        token1: bigint;
+    };
+}
+export interface MintResult {
+    /** Transaction hash */
+    txHash: Hash;
+    /** NFT token ID of the new position */
+    tokenId: bigint;
+    /** Actual token0 amount deposited */
+    amount0: bigint;
+    /** Actual token1 amount deposited */
+    amount1: bigint;
+    /** Liquidity minted */
+    liquidity: bigint;
+    /** Transaction receipt */
+    receipt: TransactionReceipt;
+}
+export interface ModifyLiquidityResult {
+    /** Transaction hash */
+    txHash: Hash;
+    /** Token0 amount added or removed */
+    amount0: bigint;
+    /** Token1 amount added or removed */
+    amount1: bigint;
+    /** Transaction receipt */
+    receipt: TransactionReceipt;
+}
+export interface CollectFeesResult {
+    /** Transaction hash */
+    txHash: Hash;
+    /** Token0 fees collected */
+    amount0: bigint;
+    /** Token1 fees collected */
+    amount1: bigint;
+    /** Transaction receipt */
+    receipt: TransactionReceipt;
+}
+//# sourceMappingURL=liquidity-types.d.ts.map

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

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

package/dist/liquidity-types.js

@@ -0,0 +1,8 @@
+/**
+ * Uniswap V3 & V4 Liquidity Management Types
+ *
+ * Types for the ClawnchLiquidity class which manages liquidity
+ * positions on both Uniswap V3 and V4 pools on Base.
+ */
+export {};
+//# sourceMappingURL=liquidity-types.js.map

package/dist/liquidity-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidity-types.js","sourceRoot":"","sources":["../src/liquidity-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}