{"_id":"@degencoinflip/sdk","_rev":"3-a569461b93d18d205ad5a6a60886b2f6","name":"@degencoinflip/sdk","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@degencoinflip/sdk","version":"0.1.0","keywords":["solana","sdk","coin-flip","defi","anchor","ai-agents"],"license":"MIT","_id":"@degencoinflip/sdk@0.1.0","maintainers":[{"name":"degencoinflip","email":"degencoinflip@gmail.com"}],"homepage":"https://github.com/degencoinflip/degencoinflip#readme","bugs":{"url":"https://github.com/degencoinflip/degencoinflip/issues"},"dist":{"shasum":"8c0b6cc0d1f710a331042108de2a2e340be23520","tarball":"https://registry.npmjs.org/@degencoinflip/sdk/-/sdk-0.1.0.tgz","fileCount":32,"integrity":"sha512-wZ1tnvK6g+CerooOBj+RKcXbsnT9XV9h+5Y9d/WsdsXqsLAkusfeOjvJE/RCcMht2FS2aRz9qKWy48voPZ6bZg==","signatures":[{"sig":"MEYCIQDaXbhY4pyZm2Xrg9vVNOI/V7gTA2KYm9/BKjgf1T995QIhAOIgohZsV0KJcLtcr0ubCa7i+5wNEOq/o30SCBN5ap48","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":80483},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"346b66d4da5c9872c28e49c6ce76d46f9e54acbd","scripts":{"test":"tsx --test test/*.test.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"degencoinflip","email":"degencoinflip@gmail.com"},"repository":{"url":"git+https://github.com/degencoinflip/degencoinflip.git","type":"git"},"_npmVersion":"11.6.0","description":"JavaScript SDK for Degen Coin Flip","directories":{},"_nodeVersion":"24.9.0","dependencies":{"bs58":"^5.0.0","tweetnacl":"^1.0.3","@solana/web3.js":"^1.95.0","@coral-xyz/anchor":"^0.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.0_1775011432208_0.5135035752396855","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@degencoinflip/sdk","version":"0.1.1","keywords":["solana","sdk","coin-flip","defi","anchor","ai-agents"],"license":"MIT","_id":"@degencoinflip/sdk@0.1.1","maintainers":[{"name":"degencoinflip","email":"degencoinflip@gmail.com"}],"homepage":"https://github.com/degencoinflip/degencoinflip#readme","bugs":{"url":"https://github.com/degencoinflip/degencoinflip/issues"},"dist":{"shasum":"2122cc6d04965f0d707d9c91f7f924866163f83b","tarball":"https://registry.npmjs.org/@degencoinflip/sdk/-/sdk-0.1.1.tgz","fileCount":32,"integrity":"sha512-IVnHsvhzKu/cqsr7yAsyV6tfYxO3qwLJdy4tUC9CqZcn9zZaZ7/ugXCQ7kWU0p+qFsdPkOG0uhiKHWa1Hrbvhg==","signatures":[{"sig":"MEQCIGL8nUjler3HsRrYDbMn33CJ05fQhEqyvrwjWF5iSVWPAiA/m7vi0iEBd6higynywRf/6TgNV3BAGRkfLhfN+IX++A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":87265},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"071ed46463d64f5ea2dd71a783deebc18d190072","scripts":{"test":"tsx --test test/*.test.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"degencoinflip","email":"degencoinflip@gmail.com"},"repository":{"url":"git+https://github.com/degencoinflip/degencoinflip.git","type":"git"},"_npmVersion":"11.6.0","description":"JavaScript SDK for Degen Coin Flip","directories":{},"_nodeVersion":"24.9.0","dependencies":{"bs58":"^5.0.0","tweetnacl":"^1.0.3","@solana/web3.js":"^1.95.0","@coral-xyz/anchor":"^0.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.1_1775020157163_0.12204191380450546","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@degencoinflip/sdk","version":"0.1.2","description":"JavaScript SDK for Degen Coin Flip","license":"MIT","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","test":"tsx --test test/*.test.ts","prepublishOnly":"npm run build"},"dependencies":{"@coral-xyz/anchor":"^0.29.0","@solana/web3.js":"^1.95.0","bs58":"^5.0.0","tweetnacl":"^1.0.3"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.21.0","typescript":"^5.6.0"},"keywords":["solana","sdk","coin-flip","defi","anchor","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/degencoinflip/degencoinflip.git"},"engines":{"node":">=18"},"_id":"@degencoinflip/sdk@0.1.2","gitHead":"6cd570dce848c4ce11841fb164ba8a0e7e018f66","bugs":{"url":"https://github.com/degencoinflip/degencoinflip/issues"},"homepage":"https://github.com/degencoinflip/degencoinflip#readme","_nodeVersion":"24.9.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-o1ibUelFpu3vW3gQI8wI0/TpTiRJvge6leT/qAv0+/ht1+jiHwPjuce4Z4GD0QYsq773i8ZoJLWjTKSGUB4RaA==","shasum":"b9363b75f45d5907077484ce589439a7f2cdd661","tarball":"https://registry.npmjs.org/@degencoinflip/sdk/-/sdk-0.1.2.tgz","fileCount":32,"unpackedSize":87871,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC3bOfuuNkGUmDz0gpk1bm/XN5Xz9t3cXM49moFrmD/hQIgRRN+QsrJyPgTHRfp4O5AoIAPSBFERIO1KIWsUTIYNyQ="}]},"_npmUser":{"name":"degencoinflip","email":"degencoinflip@gmail.com"},"directories":{},"maintainers":[{"name":"degencoinflip","email":"degencoinflip@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.1.2_1775020913667_0.7395540748564238"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T02:43:52.149Z","modified":"2026-04-01T05:21:53.919Z","0.1.0":"2026-04-01T02:43:52.435Z","0.1.1":"2026-04-01T05:09:17.314Z","0.1.2":"2026-04-01T05:21:53.815Z"},"bugs":{"url":"https://github.com/degencoinflip/degencoinflip/issues"},"license":"MIT","homepage":"https://github.com/degencoinflip/degencoinflip#readme","keywords":["solana","sdk","coin-flip","defi","anchor","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/degencoinflip/degencoinflip.git"},"description":"JavaScript SDK for Degen Coin Flip","maintainers":[{"name":"degencoinflip","email":"degencoinflip@gmail.com"}],"readme":"# @degencoinflip/sdk\n\nSolana coin flip SDK. Play from Node.js scripts, AI agents, or browser wallets.\n\n## Install\n\n```bash\nnpm install @degencoinflip/sdk\n```\n\n## Quick start\n\n### Keypair (Node.js / AI agents)\n\n```typescript\nimport { DegenCoinFlip } from '@degencoinflip/sdk';\n\nconst dcf = new DegenCoinFlip({ keypair: loadKeypair('~/.config/solana/id.json') });\nconst result = await dcf.play('H', 1.0);\nconsole.log(result.result); // 'WIN' or 'LOSS'\n```\n\n### Browser wallet\n\n```typescript\nimport { DegenCoinFlip } from '@degencoinflip/sdk';\n\nconst dcf = new DegenCoinFlip({\n  wallet: {\n    publicKey: walletAdapter.publicKey,\n    signTransaction: (tx) => walletAdapter.signTransaction(tx),\n    signAllTransactions: (txs) => walletAdapter.signAllTransactions(txs),\n    signMessage: (msg) => walletAdapter.signMessage(msg),\n  },\n});\n\nconst result = await dcf.play('H', 0.5);\n```\n\n## API\n\n| Method | Description |\n|--------|-------------|\n| `play(side, amount, opts?)` | Flip a coin. Handles auth, deposit, result, and claim. |\n| `dryRun(side, amount, priorityFee?)` | Preview costs without playing. |\n| `balance()` | Check wallet SOL balance and game state. |\n| `history(opts?)` | Get recent flip results with win/loss summary. |\n| `resume()` | Recover from stuck game state (unclaimed win, pending flip). |\n\n### Play options\n\n```typescript\nawait dcf.play('H', 1.0, {\n  noClaim: false,       // Skip auto-claim on win\n  priorityFee: 0.0001,  // Priority fee in SOL\n  timeout: 120000,       // Max wait for result (ms)\n  affiliateId: 'your-id' // Affiliate tracking\n});\n```\n\n## Environment variables\n\n| Variable | Purpose |\n|----------|---------|\n| `DCF_KEYPAIR` | Path to Solana keypair file (default: `~/.config/solana/id.json`) |\n| `DCF_RPC_URL` | Solana RPC endpoint |\n| `DCF_API_URL` | Backend API URL (default: production) |\n\n## Game rules\n\n- Bet range: 0.001 - 32 SOL\n- Platform fee: 3.5%\n- 50/50 coin flip, 2x payout on win\n- On-chain escrow via Anchor program\n\n## License\n\nMIT\n","readmeFilename":"README.md"}