@clawnch/clawncher-sdk 0.1.0

package/dist/portfolio.d.ts

@@ -0,0 +1,129 @@
+/**
+ * ClawnchPortfolio - Portfolio tracking for Clawncher token deployers
+ *
+ * Aggregates token holdings, fee balances, and vault allocations
+ * for a wallet across all their deployed/participated tokens.
+ *
+ * Since Clanker's FeeLocker doesn't have efficient enumeration,
+ * this class uses two approaches:
+ * 1. Accept a known token list (fast, no event scanning)
+ * 2. Scan factory TokenCreated events for a wallet (comprehensive but slower)
+ */
+import { type PublicClient, type Address } from 'viem';
+import { type NetworkName } from './addresses.js';
+/**
+ * Token info within a portfolio
+ */
+export interface PortfolioToken {
+    /** Token contract address */
+    address: Address;
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Reward BPS this wallet receives (out of 10000) */
+    bps: number;
+    /** Claimable WETH fees */
+    claimableWeth: bigint;
+    /** Claimable token fees */
+    claimableToken: bigint;
+    /** Formatted claimable WETH */
+    formattedWeth: string;
+    /** Formatted claimable token */
+    formattedToken: string;
+}
+/**
+ * Aggregated claimable amounts
+ */
+export interface TotalClaimable {
+    /** Total claimable WETH across all tokens */
+    weth: bigint;
+    /** Formatted total WETH */
+    formattedWeth: string;
+    /** Per-token claimable amounts */
+    tokens: Array<{
+        address: Address;
+        symbol: string;
+        amount: bigint;
+        formatted: string;
+    }>;
+}
+/**
+ * Portfolio configuration
+ */
+export interface PortfolioConfig {
+    /** Public client for reading chain data */
+    publicClient: PublicClient;
+    /** Network to read from */
+    network: NetworkName;
+}
+/**
+ * ClawnchPortfolio - Track tokens and fees for a wallet
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchPortfolio } from '@clawnch/clawncher-sdk';
+ * import { createPublicClient, http } from 'viem';
+ * import { base } from 'viem/chains';
+ *
+ * const publicClient = createPublicClient({
+ *   chain: base,
+ *   transport: http(),
+ * });
+ *
+ * const portfolio = new ClawnchPortfolio({
+ *   publicClient,
+ *   network: 'mainnet',
+ * });
+ *
+ * // Get portfolio for known tokens
+ * const tokens = await portfolio.getTokensForWallet(
+ *   walletAddress,
+ *   [token1, token2, token3],
+ * );
+ *
+ * // Get total claimable
+ * const claimable = await portfolio.getTotalClaimable(
+ *   walletAddress,
+ *   [token1, token2],
+ * );
+ * console.log(`Total WETH: ${claimable.formattedWeth}`);
+ * ```
+ */
+export declare class ClawnchPortfolio {
+    readonly publicClient: PublicClient;
+    readonly network: NetworkName;
+    constructor(config: PortfolioConfig);
+    /**
+     * Get contract addresses for configured network
+     */
+    private getAddresses;
+    /**
+     * Get all tokens where wallet is a reward recipient.
+     *
+     * Checks each provided token to see if the wallet is listed as a
+     * reward recipient in the LP locker, and fetches fee balances.
+     *
+     * @param wallet - The wallet address to check
+     * @param tokens - Known token addresses to check against
+     */
+    getTokensForWallet(wallet: Address, tokens: Address[]): Promise<PortfolioToken[]>;
+    /**
+     * Get total claimable fees across all specified tokens for a wallet.
+     *
+     * @param wallet - The wallet address
+     * @param tokens - Token addresses to aggregate
+     */
+    getTotalClaimable(wallet: Address, tokens: Address[]): Promise<TotalClaimable>;
+    /**
+     * Discover tokens deployed by a wallet by scanning factory events.
+     *
+     * Scans TokenCreated events where tokenAdmin matches the wallet.
+     * This is slower than providing a known list but finds all tokens.
+     *
+     * @param wallet - The deployer wallet address
+     * @param fromBlock - Block to start scanning from (default: last 100k blocks)
+     */
+    discoverTokens(wallet: Address, fromBlock?: bigint): Promise<Address[]>;
+}
+//# sourceMappingURL=portfolio.d.ts.map

package/dist/portfolio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.d.ts","sourceRoot":"","sources":["../src/portfolio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,OAAO,EAGb,MAAM,MAAM,CAAC;AASd,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,2BAA2B;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;gBAElB,MAAM,EAAE,eAAe;IAKnC;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;OAQG;IACG,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAqEvF;;;;;OAKG;IACG,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAuDpF;;;;;;;;OAQG;IACG,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAyB9E"}

package/dist/portfolio.js

@@ -0,0 +1,218 @@
+/**
+ * ClawnchPortfolio - Portfolio tracking for Clawncher token deployers
+ *
+ * Aggregates token holdings, fee balances, and vault allocations
+ * for a wallet across all their deployed/participated tokens.
+ *
+ * Since Clanker's FeeLocker doesn't have efficient enumeration,
+ * this class uses two approaches:
+ * 1. Accept a known token list (fast, no event scanning)
+ * 2. Scan factory TokenCreated events for a wallet (comprehensive but slower)
+ */
+import { formatEther, } from 'viem';
+import { ClawnchFactoryABI, ClawnchFeeLockerABI, ClawnchLpLockerABI, ERC20ABI, } from './abis.js';
+import { getAddresses } from './addresses.js';
+/**
+ * ClawnchPortfolio - Track tokens and fees for a wallet
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchPortfolio } from '@clawnch/clawncher-sdk';
+ * import { createPublicClient, http } from 'viem';
+ * import { base } from 'viem/chains';
+ *
+ * const publicClient = createPublicClient({
+ *   chain: base,
+ *   transport: http(),
+ * });
+ *
+ * const portfolio = new ClawnchPortfolio({
+ *   publicClient,
+ *   network: 'mainnet',
+ * });
+ *
+ * // Get portfolio for known tokens
+ * const tokens = await portfolio.getTokensForWallet(
+ *   walletAddress,
+ *   [token1, token2, token3],
+ * );
+ *
+ * // Get total claimable
+ * const claimable = await portfolio.getTotalClaimable(
+ *   walletAddress,
+ *   [token1, token2],
+ * );
+ * console.log(`Total WETH: ${claimable.formattedWeth}`);
+ * ```
+ */
+export class ClawnchPortfolio {
+    publicClient;
+    network;
+    constructor(config) {
+        this.publicClient = config.publicClient;
+        this.network = config.network;
+    }
+    /**
+     * Get contract addresses for configured network
+     */
+    getAddresses() {
+        return getAddresses(this.network);
+    }
+    /**
+     * Get all tokens where wallet is a reward recipient.
+     *
+     * Checks each provided token to see if the wallet is listed as a
+     * reward recipient in the LP locker, and fetches fee balances.
+     *
+     * @param wallet - The wallet address to check
+     * @param tokens - Known token addresses to check against
+     */
+    async getTokensForWallet(wallet, tokens) {
+        const addresses = this.getAddresses();
+        const results = [];
+        for (const token of tokens) {
+            try {
+                // Get reward info from LP locker
+                const rewards = await this.publicClient.readContract({
+                    address: addresses.clawnch.locker,
+                    abi: ClawnchLpLockerABI,
+                    functionName: 'tokenRewards',
+                    args: [token],
+                });
+                // Find this wallet in the reward recipients
+                const recipientIndex = rewards.rewardRecipients.findIndex((r) => r.toLowerCase() === wallet.toLowerCase());
+                if (recipientIndex === -1)
+                    continue;
+                // Get token info and fee balances in parallel
+                const [name, symbol, claimableWeth, claimableToken] = await Promise.all([
+                    this.publicClient.readContract({
+                        address: token,
+                        abi: ERC20ABI,
+                        functionName: 'name',
+                    }).catch(() => 'Unknown'),
+                    this.publicClient.readContract({
+                        address: token,
+                        abi: ERC20ABI,
+                        functionName: 'symbol',
+                    }).catch(() => '???'),
+                    this.publicClient.readContract({
+                        address: addresses.clawnch.feeLocker,
+                        abi: ClawnchFeeLockerABI,
+                        functionName: 'availableFees',
+                        args: [wallet, addresses.infrastructure.weth],
+                    }).catch(() => 0n),
+                    this.publicClient.readContract({
+                        address: addresses.clawnch.feeLocker,
+                        abi: ClawnchFeeLockerABI,
+                        functionName: 'availableFees',
+                        args: [wallet, token],
+                    }).catch(() => 0n),
+                ]);
+                results.push({
+                    address: token,
+                    name: name,
+                    symbol: symbol,
+                    bps: rewards.rewardBps[recipientIndex],
+                    claimableWeth,
+                    claimableToken,
+                    formattedWeth: formatEther(claimableWeth),
+                    formattedToken: formatEther(claimableToken),
+                });
+            }
+            catch {
+                // Skip tokens that fail (may not be Clawncher tokens)
+            }
+        }
+        return results;
+    }
+    /**
+     * Get total claimable fees across all specified tokens for a wallet.
+     *
+     * @param wallet - The wallet address
+     * @param tokens - Token addresses to aggregate
+     */
+    async getTotalClaimable(wallet, tokens) {
+        const addresses = this.getAddresses();
+        let totalWeth = 0n;
+        const tokenAmounts = [];
+        // Check WETH fees (these are per-feeOwner, not per-token, but we check anyway)
+        try {
+            totalWeth = await this.publicClient.readContract({
+                address: addresses.clawnch.feeLocker,
+                abi: ClawnchFeeLockerABI,
+                functionName: 'availableFees',
+                args: [wallet, addresses.infrastructure.weth],
+            });
+        }
+        catch {
+            // No WETH fees
+        }
+        // Check each token's fees
+        for (const token of tokens) {
+            try {
+                const [symbol, amount] = await Promise.all([
+                    this.publicClient.readContract({
+                        address: token,
+                        abi: ERC20ABI,
+                        functionName: 'symbol',
+                    }).catch(() => '???'),
+                    this.publicClient.readContract({
+                        address: addresses.clawnch.feeLocker,
+                        abi: ClawnchFeeLockerABI,
+                        functionName: 'availableFees',
+                        args: [wallet, token],
+                    }).catch(() => 0n),
+                ]);
+                if (amount > 0n) {
+                    tokenAmounts.push({
+                        address: token,
+                        symbol,
+                        amount,
+                        formatted: formatEther(amount),
+                    });
+                }
+            }
+            catch {
+                // Skip tokens that fail
+            }
+        }
+        return {
+            weth: totalWeth,
+            formattedWeth: formatEther(totalWeth),
+            tokens: tokenAmounts,
+        };
+    }
+    /**
+     * Discover tokens deployed by a wallet by scanning factory events.
+     *
+     * Scans TokenCreated events where tokenAdmin matches the wallet.
+     * This is slower than providing a known list but finds all tokens.
+     *
+     * @param wallet - The deployer wallet address
+     * @param fromBlock - Block to start scanning from (default: last 100k blocks)
+     */
+    async discoverTokens(wallet, fromBlock) {
+        const addresses = this.getAddresses();
+        const startBlock = fromBlock ?? await this.publicClient.getBlockNumber()
+            .then(n => n > 100000n ? n - 100000n : 0n);
+        try {
+            const logs = await this.publicClient.getContractEvents({
+                address: addresses.clawnch.factory,
+                abi: ClawnchFactoryABI,
+                eventName: 'TokenCreated',
+                args: {
+                    tokenAdmin: wallet,
+                },
+                fromBlock: startBlock,
+            });
+            return logs.map(log => {
+                const args = log.args;
+                return args.tokenAddress;
+            }).filter((addr) => !!addr);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/portfolio.js.map

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

package/dist/reader.d.ts

@@ -0,0 +1,249 @@
+/**
+ * ClawnchReader - Read on-chain token data from Clanker's contracts
+ *
+ * v3: Reads from Clanker's approved infrastructure (same ABI, different addresses).
+ * Provides read-only access to token deployment info, vault allocations,
+ * fee configurations, and reward info.
+ *
+ * Used by frontends to display token detail pages and admin functionality.
+ */
+import { type PublicClient, type Address, type Chain } from 'viem';
+import { type NetworkName } from './addresses.js';
+/**
+ * Vault allocation info
+ */
+export interface VaultAllocation {
+    token: Address;
+    amountTotal: bigint;
+    amountClaimed: bigint;
+    lockupEndTime: bigint;
+    vestingEndTime: bigint;
+    admin: Address;
+    /** Amount currently available to claim */
+    amountAvailable: bigint;
+    /** Whether lockup has ended */
+    isUnlocked: boolean;
+    /** Whether fully vested */
+    isFullyVested: boolean;
+    /** Percentage vested (0-100) */
+    percentVested: number;
+}
+/**
+ * Vested dev buy allocation info
+ */
+export interface VestedDevBuyAllocation {
+    token: Address;
+    amountTotal: bigint;
+    amountClaimed: bigint;
+    lockupEndTime: bigint;
+    vestingEndTime: bigint;
+    admin: Address;
+    /** Amount currently available to claim */
+    amountAvailable: bigint;
+    /** Whether lockup has ended */
+    isUnlocked: boolean;
+    /** Whether fully vested */
+    isFullyVested: boolean;
+    /** Percentage vested (0-100) */
+    percentVested: number;
+}
+/**
+ * Reward recipient info from LP locker (read result)
+ */
+export interface RewardRecipientInfo {
+    recipient: Address;
+    admin: Address;
+    bps: number;
+}
+/**
+ * Token deployment info
+ */
+export interface TokenDeploymentInfo {
+    token: Address;
+    hook: Address;
+    locker: Address;
+    extensions: Address[];
+}
+/**
+ * Token reward info from LP locker
+ */
+export interface TokenRewardInfo {
+    token: Address;
+    poolKey: {
+        currency0: Address;
+        currency1: Address;
+        fee: number;
+        tickSpacing: number;
+        hooks: Address;
+    };
+    positionId: bigint;
+    numPositions: bigint;
+    rewardBps: number[];
+    rewardAdmins: Address[];
+    rewardRecipients: Address[];
+}
+/**
+ * MEV protection config (read result)
+ */
+export interface MevConfigInfo {
+    startingFee: number;
+    endingFee: number;
+    secondsToDecay: bigint;
+    poolStartTime: bigint;
+    /** Computed: poolStartTime + secondsToDecay */
+    decayEndTime: bigint;
+    currentFee: number;
+    isDecayComplete: boolean;
+}
+/**
+ * Full token details for UI
+ */
+export interface TokenDetails {
+    address: Address;
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: bigint;
+    tokenAdmin: Address;
+    originalAdmin: Address;
+    image: string;
+    metadata: string;
+    context: string;
+    deployment: TokenDeploymentInfo;
+    rewards: TokenRewardInfo | null;
+    vault: VaultAllocation | null;
+    vestedDevBuy: VestedDevBuyAllocation | null;
+    mev: MevConfigInfo | null;
+}
+/**
+ * Fee info for a wallet across tokens
+ */
+export interface WalletFeeInfo {
+    wallet: Address;
+    tokens: Array<{
+        token: Address;
+        symbol: string;
+        availableFees: bigint;
+        formattedFees: string;
+    }>;
+    totalWeth: bigint;
+    formattedTotalWeth: string;
+}
+/**
+ * Reader configuration
+ */
+export interface ReaderConfig {
+    /** Public client for reading chain data */
+    publicClient: PublicClient;
+    /** Network to read from */
+    network: NetworkName;
+}
+/**
+ * ClawnchReader - Read on-chain token data
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchReader } from '@clawnch/clawncher-sdk';
+ * import { createPublicClient, http } from 'viem';
+ * import { baseSepolia } from 'viem/chains';
+ *
+ * const publicClient = createPublicClient({
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ *
+ * const reader = new ClawnchReader({
+ *   publicClient,
+ *   network: 'sepolia',
+ * });
+ *
+ * // Get full token details
+ * const details = await reader.getTokenDetails('0x...');
+ *
+ * // Get vault allocation
+ * const vault = await reader.getVaultAllocation('0x...');
+ *
+ * // Get vested dev buy allocation
+ * const vested = await reader.getVestedDevBuyAllocation('0x...');
+ * ```
+ */
+export declare class ClawnchReader {
+    readonly publicClient: PublicClient;
+    readonly network: NetworkName;
+    constructor(config: ReaderConfig);
+    /**
+     * Get contract addresses for configured network
+     */
+    getAddresses(): import("./addresses.js").NetworkAddresses;
+    /**
+     * Get the chain for the configured network
+     */
+    getChain(): Chain;
+    /**
+     * Get basic ERC20 token info
+     */
+    getTokenInfo(token: Address): Promise<{
+        name: string;
+        symbol: string;
+        decimals: number;
+        totalSupply: bigint;
+    }>;
+    /**
+     * Get Clawncher token metadata using allData() single call
+     *
+     * Returns originalAdmin, admin, imageUrl, metadata, context in one RPC call.
+     */
+    getTokenMetadata(token: Address): Promise<{
+        tokenAdmin: Address;
+        originalAdmin: Address;
+        image: string;
+        metadata: string;
+        context: string;
+    }>;
+    /**
+     * Get token deployment info from factory
+     */
+    getDeploymentInfo(token: Address): Promise<TokenDeploymentInfo | null>;
+    /**
+     * Get vault allocation for a token
+     */
+    getVaultAllocation(token: Address): Promise<VaultAllocation | null>;
+    /**
+     * Get vested dev buy allocation for a token
+     */
+    getVestedDevBuyAllocation(token: Address): Promise<VestedDevBuyAllocation | null>;
+    /**
+     * Get token reward info (recipients, positions) from LP locker
+     */
+    getTokenRewards(token: Address): Promise<TokenRewardInfo | null>;
+    /**
+     * Get available fees for a wallet on a specific token
+     */
+    getAvailableFees(wallet: Address, token: Address): Promise<bigint>;
+    /**
+     * Get all available fees for a wallet across multiple tokens
+     */
+    getWalletFees(wallet: Address, tokens: Address[]): Promise<WalletFeeInfo>;
+    /**
+     * Get MEV protection config for a pool by its poolId (bytes32)
+     *
+     * Use `getMevConfigForToken()` if you have a token address instead of poolId.
+     */
+    getMevConfig(poolId: `0x${string}`): Promise<MevConfigInfo | null>;
+    /**
+     * Get MEV protection config for a token (resolves poolId via LP locker first)
+     */
+    getMevConfigForToken(token: Address): Promise<MevConfigInfo | null>;
+    /**
+     * Get complete token details for UI display
+     *
+     * Combines basic token info, deployment info, vault, vested dev buy,
+     * reward recipients, and MEV config into a single response.
+     */
+    getTokenDetails(token: Address): Promise<TokenDetails | null>;
+    /**
+     * Check if a token was deployed via Clawncher
+     */
+    isClawnchToken(token: Address): Promise<boolean>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/reader.d.ts.map

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