@clawnch/clawncher-sdk 0.1.0

package/dist/watcher.js

@@ -0,0 +1,132 @@
+/**
+ * ClawnchWatcher - Live event watching for Clawncher tokens
+ *
+ * Watches for new token deployments and swap events in real-time
+ * using viem's event subscription (WebSocket recommended).
+ *
+ * Uses `publicClient.watchContractEvent()` which works with both
+ * polling (HTTP) and subscription (WebSocket) transports.
+ */
+import { ClawnchFactoryABI } from './abis.js';
+import { getAddresses } from './addresses.js';
+/**
+ * ClawnchWatcher - Watch live events from Clawncher contracts
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchWatcher } from '@clawnch/clawncher-sdk';
+ * import { createPublicClient, webSocket } from 'viem';
+ * import { base } from 'viem/chains';
+ *
+ * // WebSocket recommended for live watching
+ * const publicClient = createPublicClient({
+ *   chain: base,
+ *   transport: webSocket('wss://base-mainnet.g.alchemy.com/v2/YOUR_KEY'),
+ * });
+ *
+ * const watcher = new ClawnchWatcher({
+ *   publicClient,
+ *   network: 'mainnet',
+ * });
+ *
+ * // Watch for new token deployments
+ * const unwatch = watcher.watchDeployments((event) => {
+ *   console.log(`New token: ${event.tokenSymbol} at ${event.tokenAddress}`);
+ * });
+ *
+ * // Stop watching later
+ * unwatch();
+ * ```
+ */
+export class ClawnchWatcher {
+    publicClient;
+    network;
+    constructor(config) {
+        this.publicClient = config.publicClient;
+        this.network = config.network;
+    }
+    /**
+     * Get contract addresses for configured network
+     */
+    getAddresses() {
+        return getAddresses(this.network);
+    }
+    /**
+     * Watch for new token deployments from the factory.
+     *
+     * Subscribes to TokenCreated events on the factory contract.
+     * Returns an unsubscribe function to stop watching.
+     *
+     * @param callback - Called for each new token deployment
+     * @param options - Optional filter by token admin
+     * @returns Unsubscribe function
+     */
+    watchDeployments(callback, options) {
+        const addresses = this.getAddresses();
+        const unwatch = this.publicClient.watchContractEvent({
+            address: addresses.clawnch.factory,
+            abi: ClawnchFactoryABI,
+            eventName: 'TokenCreated',
+            args: options?.tokenAdmin ? { tokenAdmin: options.tokenAdmin } : undefined,
+            onLogs: (logs) => {
+                for (const log of logs) {
+                    const args = log.args;
+                    if (!args.tokenAddress)
+                        continue;
+                    callback({
+                        tokenAddress: args.tokenAddress,
+                        tokenAdmin: args.tokenAdmin ?? '0x0000000000000000000000000000000000000000',
+                        tokenName: args.tokenName ?? '',
+                        tokenSymbol: args.tokenSymbol ?? '',
+                        tokenImage: args.tokenImage ?? '',
+                        deployer: args.msgSender ?? '0x0000000000000000000000000000000000000000',
+                        poolHook: args.poolHook ?? '0x0000000000000000000000000000000000000000',
+                        locker: args.locker ?? '0x0000000000000000000000000000000000000000',
+                        poolId: args.poolId ?? '0x0000000000000000000000000000000000000000000000000000000000000000',
+                        blockNumber: log.blockNumber ?? 0n,
+                        txHash: log.transactionHash ?? '0x0000000000000000000000000000000000000000000000000000000000000000',
+                    });
+                }
+            },
+        });
+        return unwatch;
+    }
+    /**
+     * Get historical token deployments (past events).
+     *
+     * Fetches TokenCreated events from the factory within a block range.
+     * Useful for building initial state before starting live watching.
+     *
+     * @param options - Block range and optional filter
+     */
+    async getHistoricalDeployments(options) {
+        const addresses = this.getAddresses();
+        const fromBlock = options?.fromBlock ?? await this.publicClient.getBlockNumber()
+            .then(n => n > 10000n ? n - 10000n : 0n);
+        const logs = await this.publicClient.getContractEvents({
+            address: addresses.clawnch.factory,
+            abi: ClawnchFactoryABI,
+            eventName: 'TokenCreated',
+            args: options?.tokenAdmin ? { tokenAdmin: options.tokenAdmin } : undefined,
+            fromBlock,
+            toBlock: options?.toBlock,
+        });
+        return logs.map(log => {
+            const args = log.args;
+            return {
+                tokenAddress: args.tokenAddress ?? '0x0000000000000000000000000000000000000000',
+                tokenAdmin: args.tokenAdmin ?? '0x0000000000000000000000000000000000000000',
+                tokenName: args.tokenName ?? '',
+                tokenSymbol: args.tokenSymbol ?? '',
+                tokenImage: args.tokenImage ?? '',
+                deployer: args.msgSender ?? '0x0000000000000000000000000000000000000000',
+                poolHook: args.poolHook ?? '0x0000000000000000000000000000000000000000',
+                locker: args.locker ?? '0x0000000000000000000000000000000000000000',
+                poolId: args.poolId ?? '0x0000000000000000000000000000000000000000000000000000000000000000',
+                blockNumber: log.blockNumber ?? 0n,
+                txHash: log.transactionHash ?? '0x0000000000000000000000000000000000000000000000000000000000000000',
+            };
+        });
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@clawnch/clawncher-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Clawncher - token launch toolkit for Base, optimized for agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "test": "vitest"
+  },
+  "keywords": [
+    "clawncher",
+    "clawnch",
+    "base",
+    "memecoin",
+    "uniswap",
+    "v4",
+    "token",
+    "deploy",
+    "sdk"
+  ],
+  "author": "Clawncher",
+  "license": "MIT",
+  "homepage": "https://clawn.ch/er",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "clanker-sdk": "^4.2.10",
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "viem": {
+      "optional": true
+    }
+  }
+}