{"_id":"crypto-checkout-api","name":"crypto-checkout-api","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"crypto-checkout-api","version":"1.0.0","description":"TypeScript SDK for crypto chechout and integration payment.","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["react","helper","svg"],"author":{"name":"copperadev"},"license":"ISC","dependencies":{"@primno/dpapi":"^2.0.1","axios":"^1.11.0","better-sqlite3":"^12.2.0","express":"^4.21.2","module-to-cdn":"^3.1.5","node-machine-id":"^1.1.12","request":"^2.88.2","sqlite3":"^5.1.7","socket.io-client":"^4.8.1"},"_id":"crypto-checkout-api@1.0.0","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-m5Sn+KDxzI68C2i1WduQ4OzLQbXTH6KWCoE/nFDQt4NRDzx8VpqkTrxeHVU2/KJDzTd8zNpm0LyDErdHtD/SBA==","shasum":"8a9acebc0fda128c86f9e84190924161439df90e","tarball":"https://registry.npmjs.org/crypto-checkout-api/-/crypto-checkout-api-1.0.0.tgz","fileCount":3,"unpackedSize":11921,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGz3sXJt8JVcslfJBdKDN7tiIPeanRYKm0q2FRXQmKi2AiEA0vwEZKJtaFot/G6rDbi32eSrmdTR9QWkrwqe0w94ROg="}]},"_npmUser":{"name":"ahmad318","email":"ahmad.firdaus0325@gmail.com"},"directories":{},"maintainers":[{"name":"ahmad318","email":"ahmad.firdaus0325@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/crypto-checkout-api_1.0.0_1784688271632_0.8227788256512691"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-22T02:44:31.580Z","1.0.0":"2026-07-22T02:44:31.773Z","modified":"2026-07-22T02:44:32.028Z"},"maintainers":[{"name":"ahmad318","email":"ahmad.firdaus0325@gmail.com"}],"description":"TypeScript SDK for crypto chechout and integration payment.","keywords":["react","helper","svg"],"author":{"name":"copperadev"},"license":"ISC","readme":"# Crypto Shopping Checkout API\r\n\r\nA production-ready TypeScript library for building blockchain analytics platforms.\r\n\r\nCrypto Shopping Checkout API is a **token-first blockchain analytics engine** that automatically indexes blockchain events, discovers token holders, tracks important wallets, detects whale activity, and provides real-time analytics for EVM-compatible blockchains.\r\n\r\nInstead of manually registering wallet addresses, simply provide a blockchain network and a token contract address. The library automatically builds holder analytics and whale monitoring from on-chain transfer events.\r\n\r\n---\r\n\r\n## ✨ Features\r\n\r\n- 📊 Crypto Shopping Checkout API\r\n- 👥 Holder Analytics\r\n- 🐋 Whale Monitoring\r\n- ⚡ Real-time blockchain indexing\r\n- 📈 Historical balance snapshots\r\n- 🔔 Configurable alert engine\r\n- 🏷 Wallet labeling\r\n- 💰 Treasury monitoring\r\n- 🏦 Exchange wallet monitoring\r\n- 🌊 Liquidity monitoring\r\n- 🤖 Smart-money detection\r\n- 🌐 Multi-chain support\r\n- ⚙️ TypeScript support\r\n\r\n---\r\n\r\n# Philosophy\r\n\r\nCrypto Shopping Checkout API follows a **token-first** approach.\r\n\r\nAdministrators only need to configure:\r\n\r\n- Blockchain Network\r\n- Token Contract Address\r\n\r\nThe library automatically:\r\n\r\n- Discovers all token holders\r\n- Maintains holder balances\r\n- Calculates holder growth\r\n- Tracks historical snapshots\r\n- Detects whale wallets\r\n- Monitors important labeled wallets\r\n- Generates real-time analytics\r\n\r\nNo manual holder import is required.\r\n\r\n---\r\n\r\n# Architecture\r\n\r\n```\r\n                Blockchain\r\n\r\n                     │\r\n\r\n                     ▼\r\n\r\n          Blockchain Indexer\r\n\r\n                     │\r\n\r\n                     ▼\r\n\r\n         Token Transfer Events\r\n\r\n                     │\r\n\r\n                     ▼\r\n\r\n        Analytics Processing Engine\r\n\r\n        ┌──────────┬──────────┬──────────┐\r\n        │          │          │\r\n        ▼          ▼          ▼\r\n\r\n   Wallet      Holder      Whale\r\n  Analytics   Analytics   Monitoring\r\n\r\n        └──────────┬──────────┘\r\n                   ▼\r\n\r\n             Alert Engine\r\n\r\n                   ▼\r\n\r\n           Realtime Events\r\n```\r\n\r\n---\r\n\r\n# Crypto Shopping Checkout API\r\n\r\nCrypto Shopping Checkout API focuses on a **small set of important wallets**.\r\n\r\nExamples:\r\n\r\n- Treasury\r\n- Team\r\n- Marketing\r\n- Exchange\r\n- Liquidity Pool\r\n- Burn\r\n- Bridge\r\n- Smart Money\r\n- Custom\r\n\r\nFor every tracked wallet, the library records:\r\n\r\n- Current balance\r\n- Historical balance\r\n- Transaction history\r\n- Inflow / Outflow\r\n- Asset allocation\r\n- Counterparties\r\n- Transaction types\r\n- Activity statistics\r\n\r\n---\r\n\r\n# Holder Analytics\r\n\r\nHolder Analytics automatically indexes **every token holder**.\r\n\r\nNo wallet registration is required.\r\n\r\nThe library continuously calculates:\r\n\r\n- Total holders\r\n- New holders\r\n- Lost holders\r\n- Holder growth\r\n- Holder retention\r\n- Holder distribution\r\n- Top holders\r\n- Historical snapshots\r\n- Concentration metrics\r\n\r\n---\r\n\r\n# Whale Monitoring\r\n\r\nWhale Monitoring uses Holder Analytics to identify significant wallets.\r\n\r\nWhales can be defined by:\r\n\r\n- Top holders\r\n- Percentage of total supply\r\n- USD balance\r\n- Custom rules\r\n- Manually labeled wallets\r\n\r\nThe library detects:\r\n\r\n- Large buys\r\n- Large sells\r\n- Treasury movements\r\n- Exchange deposits\r\n- Exchange withdrawals\r\n- Liquidity events\r\n- Smart-money activity\r\n\r\n---\r\n\r\n# Installation\r\n\r\n```bash\r\nnpm install wallet-analytics\r\n```\r\n\r\n---\r\n\r\n# Quick Start\r\n\r\n```ts\r\nimport { WalletAnalytics } from \"wallet-analytics\";\r\n\r\nconst analytics = new WalletAnalytics({\r\n  chain: \"base\",\r\n  token: \"0x1234567890abcdef...\"\r\n});\r\n\r\nawait analytics.start();\r\n```\r\n\r\n---\r\n\r\n# Example Events\r\n\r\n```ts\r\nanalytics.on(\"holder:new\", (holder) => {\r\n  console.log(holder);\r\n});\r\n\r\nanalytics.on(\"holder:lost\", (holder) => {\r\n  console.log(holder);\r\n});\r\n\r\nanalytics.on(\"wallet:update\", (wallet) => {\r\n  console.log(wallet);\r\n});\r\n\r\nanalytics.on(\"whale:buy\", (event) => {\r\n  console.log(event);\r\n});\r\n\r\nanalytics.on(\"alert\", (alert) => {\r\n  console.log(alert);\r\n});\r\n```\r\n\r\n---\r\n\r\n# Supported Blockchains\r\n\r\n- Ethereum\r\n- Base\r\n- Arbitrum\r\n- Optimism\r\n- Polygon\r\n- BNB Chain\r\n- Avalanche\r\n\r\nFuture support:\r\n\r\n- Solana\r\n- Sui\r\n- Aptos\r\n\r\n---\r\n\r\n# Core Concepts\r\n\r\n### Holder Analytics\r\n\r\nTracks **every holder** automatically by indexing token Transfer events.\r\n\r\n### Crypto Shopping Checkout API\r\n\r\nTracks **only labeled wallets** such as Treasury, Team, Liquidity, Exchange, and Marketing wallets.\r\n\r\n### Whale Monitoring\r\n\r\nUses holder analytics to identify whale wallets and monitor significant on-chain activity.\r\n\r\n---\r\n\r\n# Use Cases\r\n\r\n- Token project dashboards\r\n- DAO analytics\r\n- Treasury monitoring\r\n- Community management\r\n- Whale tracking\r\n- Market intelligence\r\n- Blockchain research\r\n- Risk monitoring\r\n\r\n---\r\n\r\n# Roadmap\r\n\r\n- Cross-chain analytics\r\n- AI anomaly detection\r\n- Portfolio intelligence\r\n- Community analytics\r\n- Governance analytics\r\n- REST API\r\n- GraphQL API\r\n- WebSocket streaming\r\n- ClickHouse support\r\n- Kafka integration\r\n\r\n---\r\n\r\n# License\r\n\r\nMIT","readmeFilename":"README.md","_rev":"1-15997736e452730c7ad0a3919da88049"}