@clawnch/clawncher-sdk 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Clawncher SDK - Structured Error Codes
+ *
+ * Provides machine-readable error codes for programmatic error handling.
+ * All SDK errors use ClawnchDeployError with a specific ClawnchErrorCode,
+ * making it easy to handle different failure modes in automation.
+ */
+/**
+ * Error codes for all SDK operations
+ */
+export declare enum ClawnchErrorCode {
+    INVALID_BPS = "INVALID_BPS",
+    INVALID_NAME = "INVALID_NAME",
+    INVALID_SYMBOL = "INVALID_SYMBOL",
+    INVALID_ADDRESS = "INVALID_ADDRESS",
+    WALLET_NOT_CONFIGURED = "WALLET_NOT_CONFIGURED",
+    PUBLIC_CLIENT_NOT_CONFIGURED = "PUBLIC_CLIENT_NOT_CONFIGURED",
+    DEPLOY_FAILED = "DEPLOY_FAILED",
+    TX_REVERTED = "TX_REVERTED",
+    INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
+    CLAIM_FAILED = "CLAIM_FAILED",
+    NO_FEES_AVAILABLE = "NO_FEES_AVAILABLE",
+    FEATURE_NOT_AVAILABLE = "FEATURE_NOT_AVAILABLE",
+    RPC_ERROR = "RPC_ERROR",
+    TIMEOUT = "TIMEOUT"
+}
+/**
+ * Structured error class for Clawncher SDK operations
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await deployer.deploy(options);
+ * } catch (err) {
+ *   if (err instanceof ClawnchDeployError) {
+ *     switch (err.code) {
+ *       case ClawnchErrorCode.WALLET_NOT_CONFIGURED:
+ *         console.log('Please configure a wallet');
+ *         break;
+ *       case ClawnchErrorCode.INVALID_BPS:
+ *         console.log('Fix your reward BPS:', err.message);
+ *         break;
+ *       case ClawnchErrorCode.DEPLOY_FAILED:
+ *         console.log('Deployment failed:', err.message);
+ *         if (err.cause) console.log('Caused by:', err.cause);
+ *         break;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class ClawnchDeployError extends Error {
+    readonly code: ClawnchErrorCode;
+    readonly cause?: Error | undefined;
+    readonly name = "ClawnchDeployError";
+    constructor(code: ClawnchErrorCode, message: string, cause?: Error | undefined);
+}
+/**
+ * Type guard to check if an error is a ClawnchDeployError
+ */
+export declare function isClawnchError(err: unknown): err is ClawnchDeployError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,oBAAY,gBAAgB;IAE1B,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IAGnC,qBAAqB,0BAA0B;IAC/C,4BAA4B,iCAAiC;IAG7D,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IAGzC,YAAY,iBAAiB;IAC7B,iBAAiB,sBAAsB;IAGvC,qBAAqB,0BAA0B;IAG/C,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAIzB,IAAI,EAAE,gBAAgB;aAEtB,KAAK,CAAC,EAAE,KAAK;IAL/B,QAAQ,CAAC,IAAI,wBAAwB;gBAGnB,IAAI,EAAE,gBAAgB,EACtC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAIhC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,kBAAkB,CAEtE"}

package/dist/errors.js

@@ -0,0 +1,75 @@
+/**
+ * Clawncher SDK - Structured Error Codes
+ *
+ * Provides machine-readable error codes for programmatic error handling.
+ * All SDK errors use ClawnchDeployError with a specific ClawnchErrorCode,
+ * making it easy to handle different failure modes in automation.
+ */
+/**
+ * Error codes for all SDK operations
+ */
+export var ClawnchErrorCode;
+(function (ClawnchErrorCode) {
+    // Validation errors
+    ClawnchErrorCode["INVALID_BPS"] = "INVALID_BPS";
+    ClawnchErrorCode["INVALID_NAME"] = "INVALID_NAME";
+    ClawnchErrorCode["INVALID_SYMBOL"] = "INVALID_SYMBOL";
+    ClawnchErrorCode["INVALID_ADDRESS"] = "INVALID_ADDRESS";
+    // Configuration errors
+    ClawnchErrorCode["WALLET_NOT_CONFIGURED"] = "WALLET_NOT_CONFIGURED";
+    ClawnchErrorCode["PUBLIC_CLIENT_NOT_CONFIGURED"] = "PUBLIC_CLIENT_NOT_CONFIGURED";
+    // Deployment errors
+    ClawnchErrorCode["DEPLOY_FAILED"] = "DEPLOY_FAILED";
+    ClawnchErrorCode["TX_REVERTED"] = "TX_REVERTED";
+    ClawnchErrorCode["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+    // Claiming errors
+    ClawnchErrorCode["CLAIM_FAILED"] = "CLAIM_FAILED";
+    ClawnchErrorCode["NO_FEES_AVAILABLE"] = "NO_FEES_AVAILABLE";
+    // Feature not available
+    ClawnchErrorCode["FEATURE_NOT_AVAILABLE"] = "FEATURE_NOT_AVAILABLE";
+    // Network errors
+    ClawnchErrorCode["RPC_ERROR"] = "RPC_ERROR";
+    ClawnchErrorCode["TIMEOUT"] = "TIMEOUT";
+})(ClawnchErrorCode || (ClawnchErrorCode = {}));
+/**
+ * Structured error class for Clawncher SDK operations
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await deployer.deploy(options);
+ * } catch (err) {
+ *   if (err instanceof ClawnchDeployError) {
+ *     switch (err.code) {
+ *       case ClawnchErrorCode.WALLET_NOT_CONFIGURED:
+ *         console.log('Please configure a wallet');
+ *         break;
+ *       case ClawnchErrorCode.INVALID_BPS:
+ *         console.log('Fix your reward BPS:', err.message);
+ *         break;
+ *       case ClawnchErrorCode.DEPLOY_FAILED:
+ *         console.log('Deployment failed:', err.message);
+ *         if (err.cause) console.log('Caused by:', err.cause);
+ *         break;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class ClawnchDeployError extends Error {
+    code;
+    cause;
+    name = 'ClawnchDeployError';
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+    }
+}
+/**
+ * Type guard to check if an error is a ClawnchDeployError
+ */
+export function isClawnchError(err) {
+    return err instanceof ClawnchDeployError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,gBA0BX;AA1BD,WAAY,gBAAgB;IAC1B,oBAAoB;IACpB,+CAA2B,CAAA;IAC3B,iDAA6B,CAAA;IAC7B,qDAAiC,CAAA;IACjC,uDAAmC,CAAA;IAEnC,uBAAuB;IACvB,mEAA+C,CAAA;IAC/C,iFAA6D,CAAA;IAE7D,oBAAoB;IACpB,mDAA+B,CAAA;IAC/B,+CAA2B,CAAA;IAC3B,6DAAyC,CAAA;IAEzC,kBAAkB;IAClB,iDAA6B,CAAA;IAC7B,2DAAuC,CAAA;IAEvC,wBAAwB;IACxB,mEAA+C,CAAA;IAE/C,iBAAiB;IACjB,2CAAuB,CAAA;IACvB,uCAAmB,CAAA;AACrB,CAAC,EA1BW,gBAAgB,KAAhB,gBAAgB,QA0B3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAIzB;IAEA;IALT,IAAI,GAAG,oBAAoB,CAAC;IAErC,YACkB,IAAsB,EACtC,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAkB;QAEtB,UAAK,GAAL,KAAK,CAAQ;IAG/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,GAAG,YAAY,kBAAkB,CAAC;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,204 @@
+/**
+ * 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...');
+ * ```
+ */
+import type { Token, Launch, LaunchFilters, LaunchesResponse, Stats, PreviewResponse, FeesAvailable, ClaimResult, TokenAnalytics, AgentAnalytics, Leaderboard } from './types.js';
+export * from './types.js';
+export * from './molten.js';
+export * from './errors.js';
+export * from './deployer.js';
+export * from './addresses.js';
+export * from './abis.js';
+export * from './reader.js';
+export * from './claimer.js';
+export * from './portfolio.js';
+export * from './watcher.js';
+export * from './swap.js';
+export * from './swap-types.js';
+export * from './liquidity.js';
+export * from './liquidity-types.js';
+export * from './uniswap-addresses.js';
+export * from './uniswap-abis.js';
+export * from './api-deployer.js';
+export * from './api-deployer-types.js';
+export interface ClawnchClientOptions {
+    /** Base URL for the API (default: https://clawn.ch) */
+    baseUrl?: string;
+    /** Moltbook API key for authenticated operations (keep secret, never log) */
+    moltbookKey?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+export declare class ClawnchClient {
+    private baseUrl;
+    private moltbookKey?;
+    private timeout;
+    constructor(options?: ClawnchClientOptions);
+    /**
+     * Make an API request
+     */
+    private request;
+    /**
+     * Get all tokens launched via Clawncher
+     */
+    getTokens(): Promise<Token[]>;
+    /**
+     * Get a single token by symbol
+     */
+    getTokenBySymbol(symbol: string): Promise<Token | null>;
+    /**
+     * Get launch history with optional filters
+     */
+    getLaunches(filters?: LaunchFilters): Promise<LaunchesResponse>;
+    /**
+     * Get a single launch by contract address
+     */
+    getLaunch(address: string): Promise<Launch | null>;
+    /**
+     * Get market statistics
+     */
+    getStats(): Promise<Stats>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    preview(content: string): Promise<PreviewResponse>;
+    /**
+     * Check available fees for a wallet
+     *
+     * @param wallet - Ethereum wallet address
+     * @param tokens - Optional comma-separated list of token addresses to check
+     */
+    getAvailableFees(wallet: string, tokens?: string): Promise<FeesAvailable>;
+    /**
+     * 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
+     */
+    claimFees(tokenAddress: string): Promise<ClaimResult>;
+    /**
+     * Get detailed analytics for a token
+     */
+    getTokenAnalytics(address: string): Promise<TokenAnalytics>;
+    /**
+     * Get analytics for an agent (all their tokens)
+     */
+    getAgentAnalytics(name: string): Promise<AgentAnalytics>;
+    /**
+     * Get the agent leaderboard
+     *
+     * @param sort - Sort metric: 'market_cap' | 'volume' | 'launches'
+     * @param limit - Number of results (default 20, max 100)
+     */
+    getLeaderboard(sort?: 'market_cap' | 'volume' | 'launches', limit?: number): Promise<Leaderboard>;
+    /**
+     * 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)
+     */
+    uploadImage(image: string, name?: string): Promise<string>;
+    /**
+     * Get the skill documentation
+     */
+    getSkill(): Promise<string>;
+    /**
+     * Get the OpenAPI specification
+     */
+    getOpenAPISpec(): Promise<object>;
+}
+/**
+ * Custom error class for Clawnch API errors
+ */
+export declare class ClawnchError extends Error {
+    readonly status: number;
+    readonly errors?: string[] | undefined;
+    constructor(message: string, status: number, errors?: string[] | undefined);
+}
+export default ClawnchClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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