@clawnch/clawncher-sdk 2.0.0

package/dist/erc8004-types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * ERC-8004 Types
+ *
+ * ERC-8004 is a protocol for discovering and trusting AI agents across organizational boundaries.
+ * https://eips.ethereum.org/EIPS/eip-8004
+ */
+export type ERC8004TrustModels = 'reputation' | 'crypto-economic' | 'tee-attestation';
+export type ERC8004ChainId = 'eip155:1' | 'eip155:11155111' | 'eip155:8453' | 'eip155:84532' | 'eip155:59144' | 'eip155:11155420' | 'eip155:80002' | 'solana:101' | 'solana:102';
+export interface ERC8004Endpoint {
+    name: string;
+    endpoint: string;
+    version?: string;
+    description?: string;
+}
+export interface ERC8004Wallet {
+    chain: ERC8004ChainId;
+    address: string;
+    description?: string;
+}
+export interface ERC8004Registration {
+    agentId: number;
+    agentRegistry: ERC8004ChainId;
+    timestamp: string;
+    blockNumber?: number;
+    transactionHash?: string;
+}
+export interface ERC8004Skill {
+    namespace: string;
+    skill: string;
+    domain?: string;
+}
+export interface ERC8004Domain {
+    category: string;
+    subcategory?: string;
+}
+export interface ERC8004ReputationScore {
+    overall: number;
+    totalRatings: number;
+    breakdown?: {
+        reliability?: number;
+        quality?: number;
+        responsiveness?: number;
+    };
+}
+export interface ERC8004Agent {
+    id: string;
+    name: string;
+    description: string;
+    image: string;
+    active: boolean;
+    endpoints: ERC8004Endpoint[];
+    wallets: ERC8004Wallet[];
+    registrations: ERC8004Registration[];
+    supportedTrust: ERC8004TrustModels[];
+    skills?: ERC8004Skill[];
+    domains?: ERC8004Domain[];
+    reputation?: ERC8004ReputationScore;
+    metadata?: Record<string, unknown>;
+}
+export interface ERC8004AgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    capabilities?: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+    };
+    defaultApiVersion?: string;
+    skills?: string[];
+}
+export interface ERC8004SearchFilters {
+    name?: string;
+    active?: boolean;
+    trustModel?: ERC8004TrustModels;
+    chainId?: ERC8004ChainId;
+    skills?: string[];
+    domains?: string[];
+    limit?: number;
+    offset?: number;
+}
+export interface ERC8004SearchResult {
+    agents: ERC8004Agent[];
+    total: number;
+    hasMore: boolean;
+}
+export interface ERC8004RegistryConfig {
+    chainId: ERC8004ChainId;
+    identityRegistryAddress: string;
+    reputationRegistryAddress?: string;
+    validationRegistryAddress?: string;
+    blockNumber?: number;
+}
+//# sourceMappingURL=erc8004-types.d.ts.map

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

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

package/dist/erc8004-types.js

@@ -0,0 +1,8 @@
+/**
+ * ERC-8004 Types
+ *
+ * ERC-8004 is a protocol for discovering and trusting AI agents across organizational boundaries.
+ * https://eips.ethereum.org/EIPS/eip-8004
+ */
+export {};
+//# sourceMappingURL=erc8004-types.js.map

package/dist/erc8004-types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Clawncher SDK
+ *
+ * TypeScript SDK for deploying tokens on Base with Uniswap V4 pools.
+ *
+ * ## Deploying Tokens (Contract-based)
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchDeployer } from '@clawnch/clawncher-sdk';
+ * import { createWalletClient, createPublicClient, http } from 'viem';
+ * import { privateKeyToAccount } from 'viem/accounts';
+ * import { baseSepolia } from 'viem/chains';
+ *
+ * const account = privateKeyToAccount('0x...');
+ * const wallet = createWalletClient({
+ *   account,
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ * const publicClient = createPublicClient({
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ *
+ * const deployer = new ClawnchDeployer({
+ *   wallet,
+ *   publicClient,
+ *   network: 'sepolia',
+ * });
+ *
+ * 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 './deployer.js';
+export * from './addresses.js';
+export * from './abis.js';
+export * from './reader.js';
+export * from './vanity.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 Clawncher 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,OAAO,KAAK,EACV,KAAK,EAEL,MAAM,EACN,aAAa,EACb,gBAAgB,EAChB,KAAK,EAEL,eAAe,EACf,aAAa,EAEb,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EAIZ,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAG5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAG1B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,oBAAyB;IAW9C;;OAEG;YACW,OAAO;IA6DrB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKnC;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAO7D;;OAEG;IACG,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAazE;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKxD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;IAQhC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAWxD;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAO/E;;;;;;;OAOG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmB3D;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMjE;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAM9D;;;;;OAKG;IACG,cAAc,CAClB,IAAI,GAAE,YAAY,GAAG,QAAQ,GAAG,UAAyB,EACzD,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,WAAW,CAAC;IAUvB;;;;;;OAMG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAWjC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAGxC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,MAAM,EAAE,MAAM;aACd,MAAM,CAAC,EAAE,MAAM,EAAE;gBAFjC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EAAE,YAAA;CAKpC;AAGD,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,340 @@
+/**
+ * Clawncher SDK
+ *
+ * TypeScript SDK for deploying tokens on Base with Uniswap V4 pools.
+ *
+ * ## Deploying Tokens (Contract-based)
+ *
+ * @example
+ * ```typescript
+ * import { ClawnchDeployer } from '@clawnch/clawncher-sdk';
+ * import { createWalletClient, createPublicClient, http } from 'viem';
+ * import { privateKeyToAccount } from 'viem/accounts';
+ * import { baseSepolia } from 'viem/chains';
+ *
+ * const account = privateKeyToAccount('0x...');
+ * const wallet = createWalletClient({
+ *   account,
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ * const publicClient = createPublicClient({
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ *
+ * const deployer = new ClawnchDeployer({
+ *   wallet,
+ *   publicClient,
+ *   network: 'sepolia',
+ * });
+ *
+ * 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';
+// Contract deployment
+export * from './deployer.js';
+export * from './addresses.js';
+export * from './abis.js';
+// Contract reading
+export * from './reader.js';
+// Vanity address mining
+export * from './vanity.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 Clawncher 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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"}