celoclicker-game-sdk 0.1.1

package/dist/provider.js

@@ -0,0 +1,49 @@
+import { getDefaultConfig } from '@rainbow-me/rainbowkit';
+import { QueryClient } from '@tanstack/react-query';
+import { useEffect, useRef } from 'react';
+import { useAccount, useConnect } from 'wagmi';
+import { celo, celoAlfajores } from 'viem/chains';
+import { APP_NAME, CELO_ALFAJORES_CHAIN_ID, CELO_MAINNET_CHAIN_ID } from './constants';
+import { getInjectedConnector, isMiniPayBrowser } from './minipay';
+function mergeQueryClientConfig(config = {}) {
+    return {
+        ...config,
+        defaultOptions: {
+            ...config.defaultOptions,
+            queries: {
+                refetchOnWindowFocus: false,
+                ...config.defaultOptions?.queries,
+            },
+        },
+    };
+}
+export function createCeloClickerQueryClient(config = {}) {
+    return new QueryClient(mergeQueryClientConfig(config));
+}
+export function getCeloClickerChains(chainId = CELO_MAINNET_CHAIN_ID) {
+    return chainId === CELO_ALFAJORES_CHAIN_ID ? [celoAlfajores] : [celo];
+}
+export function createCeloClickerWagmiConfig(options = {}) {
+    return getDefaultConfig({
+        appName: options.appName?.trim() || APP_NAME,
+        projectId: options.projectId?.trim() || '',
+        chains: [...getCeloClickerChains(options.chainId)],
+        ssr: options.ssr ?? true,
+    });
+}
+export function useMiniPayAutoConnect() {
+    const { isConnected } = useAccount();
+    const { connect, connectors } = useConnect();
+    const attemptedAutoConnect = useRef(false);
+    useEffect(() => {
+        if (!isMiniPayBrowser() || isConnected || attemptedAutoConnect.current) {
+            return;
+        }
+        const injectedConnector = getInjectedConnector(connectors);
+        if (!injectedConnector) {
+            return;
+        }
+        attemptedAutoConnect.current = true;
+        connect({ connector: injectedConnector });
+    }, [connect, connectors, isConnected]);
+}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type Address = `0x${string}`;
+export type PlayerStatsTuple = readonly [bigint, bigint, bigint, bigint, bigint, bigint];
+export type UpgradeCostsTuple = readonly [bigint, bigint, bigint];
+export type LeaderboardTuple = readonly [readonly `0x${string}`[], readonly bigint[]];
+export interface PlayerStats {
+    points: bigint;
+    clickPower: bigint;
+    autoClickerLevel: bigint;
+    multiplierLevel: bigint;
+    totalClicks: bigint;
+    gamesPlayed: bigint;
+}
+export interface UpgradeCosts {
+    clickPowerCost: bigint;
+    autoClickerCost: bigint;
+    multiplierCost: bigint;
+}
+export interface LeaderboardEntry {
+    address: Address;
+    points: bigint;
+    rank: number;
+}
+export interface CeloClickerSdkConfig {
+    contractAddress: Address;
+    chainId: number;
+    appName: string;
+    defaultFeeCurrencyId: 'CELO' | 'USDC';
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Ethereum zero address constant used for validation
+ */
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Formats a number with K, M, B suffixes for display
+ * @param num - The number to format (bigint or number)
+ * @returns Formatted string with suffix (e.g., "1.5K", "2.3M", "1B")
+ */
+export declare function formatNumber(num: bigint | number): string;
+/**
+ * Formats an Ethereum address for display by truncating it
+ * @param address - The Ethereum address to format
+ * @returns Truncated address string (e.g., "0x1234...5678")
+ */
+export declare function formatAddress(address: string): string;
+/**
+ * Formats token amounts for display with appropriate decimal places
+ * @param value - The token amount as a string
+ * @param symbol - Optional token symbol to append
+ * @returns Formatted amount string with symbol
+ */
+export declare function formatTokenAmount(value?: string, symbol?: string): string;
+/**
+ * Validates if a string is a valid Ethereum address format
+ * @param address - The address string to validate
+ * @returns True if the address is a valid Ethereum address format
+ */
+export declare function isValidAddress(address: string): boolean;
+/**
+ * Checks if an address is the Ethereum zero address
+ * @param address - The address to check
+ * @returns True if the address is the zero address
+ */
+export declare function isZeroAddress(address: string): boolean;

package/dist/utils.js

@@ -0,0 +1,72 @@
+/**
+ * Ethereum zero address constant used for validation
+ */
+export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/**
+ * Formats a number with K, M, B suffixes for display
+ * @param num - The number to format (bigint or number)
+ * @returns Formatted string with suffix (e.g., "1.5K", "2.3M", "1B")
+ */
+export function formatNumber(num) {
+    const n = typeof num === 'bigint' ? Number(num) : num;
+    if (!Number.isFinite(n)) {
+        return '0';
+    }
+    if (n >= 1_000_000_000) {
+        return (n / 1_000_000_000).toFixed(2) + 'B';
+    }
+    if (n >= 1_000_000) {
+        return (n / 1_000_000).toFixed(2) + 'M';
+    }
+    if (n >= 1_000) {
+        return (n / 1_000).toFixed(2) + 'K';
+    }
+    return n.toLocaleString();
+}
+/**
+ * Formats an Ethereum address for display by truncating it
+ * @param address - The Ethereum address to format
+ * @returns Truncated address string (e.g., "0x1234...5678")
+ */
+export function formatAddress(address) {
+    const normalizedAddress = typeof address === 'string' ? address.trim() : '';
+    if (!normalizedAddress || normalizedAddress.length < 10)
+        return normalizedAddress;
+    return `${normalizedAddress.slice(0, 6)}...${normalizedAddress.slice(-4)}`;
+}
+/**
+ * Formats token amounts for display with appropriate decimal places
+ * @param value - The token amount as a string
+ * @param symbol - Optional token symbol to append
+ * @returns Formatted amount string with symbol
+ */
+export function formatTokenAmount(value, symbol) {
+    if (!value) {
+        return `0 ${symbol ?? ''}`.trim();
+    }
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+        return `0 ${symbol ?? ''}`.trim();
+    }
+    const decimals = numericValue >= 100 ? 2 : numericValue >= 1 ? 3 : 4;
+    const formattedValue = numericValue.toFixed(decimals).replace(/\.?0+$/, '');
+    return `${formattedValue} ${symbol ?? ''}`.trim();
+}
+/**
+ * Validates if a string is a valid Ethereum address format
+ * @param address - The address string to validate
+ * @returns True if the address is a valid Ethereum address format
+ */
+export function isValidAddress(address) {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+/**
+ * Checks if an address is the Ethereum zero address
+ * @param address - The address to check
+ * @returns True if the address is the zero address
+ */
+export function isZeroAddress(address) {
+    if (!address)
+        return false;
+    return address.trim().toLowerCase() === ZERO_ADDRESS;
+}

package/dist/validation.d.ts

@@ -0,0 +1,5 @@
+export declare function validateContractAddress(address: string): boolean;
+export declare function validateEnvironment(env?: Record<string, string | undefined>): {
+    isValid: boolean;
+    errors: string[];
+};

package/dist/validation.js

@@ -0,0 +1,31 @@
+import { CONTRACT_ADDRESS_ENV_KEY } from './constants';
+import { isValidAddress, isZeroAddress } from './utils';
+export function validateContractAddress(address) {
+    const normalizedAddress = typeof address === 'string' ? address.trim() : '';
+    if (!normalizedAddress)
+        return false;
+    if (isZeroAddress(normalizedAddress))
+        return false;
+    return isValidAddress(normalizedAddress);
+}
+export function validateEnvironment(env = process.env) {
+    const errors = [];
+    const contractAddress = env.NEXT_PUBLIC_CELOCLICKER_CONTRACT?.trim();
+    if (!contractAddress) {
+        errors.push(`${CONTRACT_ADDRESS_ENV_KEY} is not set`);
+    }
+    else if (!validateContractAddress(contractAddress)) {
+        errors.push(`${CONTRACT_ADDRESS_ENV_KEY} is not a valid address`);
+    }
+    const walletConnectId = env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID?.trim();
+    if (!walletConnectId) {
+        errors.push('NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID is not set');
+    }
+    else if (walletConnectId === 'your_project_id' || walletConnectId === 'your_project_id_here') {
+        errors.push('NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID is still set to a placeholder value');
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "celoclicker-game-sdk",
+  "version": "0.1.1",
+  "description": "Standalone SDK for CeloClicker contract state, gameplay math, fee currency handling, and MiniPay wallet helpers.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "keywords": [
+    "celo",
+    "celoclicker",
+    "gamefi",
+    "minipay",
+    "wagmi",
+    "viem",
+    "sdk"
+  ],
+  "author": "AK-Bit-Lab",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AK-Bit-Lab/celoclicker-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AK-Bit-Lab/celoclicker-sdk/issues"
+  },
+  "homepage": "https://github.com/AK-Bit-Lab/celoclicker-sdk#readme",
+  "dependencies": {
+    "@rainbow-me/rainbowkit": "^2.0.0",
+    "@tanstack/react-query": "^5.28.0"
+  },
+  "peerDependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "viem": "^2.7.0",
+    "wagmi": "^2.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@types/react": "^18.3.24",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "typescript": "^5.9.2",
+    "viem": "^2.7.0",
+    "vitest": "^4.1.4",
+    "wagmi": "^2.5.0"
+  }
+}