{"_id":"@0xward/cultos-utils","_rev":"13-9c1707d5a3d3433bbb312d488a5f4cbb","name":"@0xward/cultos-utils","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@0xward/cultos-utils","version":"1.0.0","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.0.0","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"dist":{"shasum":"90fcd962b731f0b2426fb75dfa2c650bbf876e68","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.0.0.tgz","fileCount":3,"integrity":"sha512-SKTuatoh5FBnlq29NIRhgNv2/YCI2D4bgyADKtKceRgtem1tUGQ6SbNhBk7dSEHpDWVtJu9jJ6fWlsbtJp2NFQ==","signatures":[{"sig":"MEYCIQCWeclZXxwq3B8NbUREfZKAqBF4AXtk0MEqrpsOK5iimAIhANJNfhapTseNcy2FedISngIOOtIh1OI9ad6W4c2N1/sW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":515},"main":"index.js","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"_npmVersion":"11.17.0","description":"Utility and identity generator for CultOS ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.0.0_1781356557619_0.27203973443518126","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@0xward/cultos-utils","version":"1.0.1","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.0.1","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"dist":{"shasum":"e82dca8b7e20a33f97130d757e521a020ff9d1eb","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.0.1.tgz","fileCount":3,"integrity":"sha512-GzPElgclaegF4ER6oiu5OL22SbBca323QFV3JoNe7QhEjvD1hG2lF+WEQk8XWWn7g5VVImQ5PRk7oFXyamVaFA==","signatures":[{"sig":"MEUCIBGczLhjR9aluuLG6y4UTI4nrDBXgjHX4r5adJk7IETEAiEAhnm+WUB1L9hEHHBu1+jeFwK2ARm0Oa6EXzyFoVvnLNI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":965},"main":"index.js","gitHead":"49e4d83c5a423924f7109c0b517489c88eead207","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"_npmVersion":"11.17.0","description":"Utility and identity generator for CultOS ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.0.1_1781358871761_0.6878387627519291","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@0xward/cultos-utils","version":"1.0.2","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.0.2","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://github.com/0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"c9f0108e7880ced27611248c76567b459a6f4c06","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.0.2.tgz","fileCount":3,"integrity":"sha512-m1JgDw8SnaX0quG/Un/MirRbWZm9thgLrJhGQmOrtrud5q5zzvmQ5LKtcsDTylvE5yPKcRegUumLYfgLB4Tstg==","signatures":[{"sig":"MEUCIQDElH6umd56Awwu0yJZwDiooW3issBNFK/czFolDDRDHAIgC9JTqkhiHzASKo/PDPCWhePJIWWvwag0RwykPaT1j+Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1206},"main":"index.js","gitHead":"49e4d83c5a423924f7109c0b517489c88eead207","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"11.17.0","description":"Utility and identity generator for CultOS ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.0.2_1781359000189_0.6179335762299119","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@0xward/cultos-utils","version":"1.0.5","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.0.5","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"6a0149cfdfbc9f6d79b05c4a97595bdb978c1666","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.0.5.tgz","fileCount":7,"integrity":"sha512-edqdo4Ny6s0GwEpH5/V0Q73JDdVp1jNoiI1eQMIwPBOGW50sZ9xsYAApS52FfRZb1U3ZMOXj4LmEsiUGV6COhQ==","signatures":[{"sig":"MEUCIQDsTAuHr5CpTmAsAqfg1gCoMti9OhWJiNlxgT2HoiEajwIgK1SephrQpC/QRmNOXUku4P/GRaBil1WRqkGG+ns+X1I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7612},"main":"index.js","gitHead":"e22590d45076d1cd407a50981321bee1aec734ac","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"11.17.0","description":"Futuristic AI-powered generator framework for viral internet-style cult meme coins in the Stacks ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.0.5_1781375273055_0.03723949711477981","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@0xward/cultos-utils","version":"1.0.6","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.0.6","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"6ddadef78feb75b6c787ecf50726dadaf2779a15","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.0.6.tgz","fileCount":7,"integrity":"sha512-56sKJ74Zr9BEs98At2Xr7whGg8LdEAZkScrzdCtT6i7mgx+B40JXNELGicsbDAzsZPnAzM6gnPpCoUvVaW6ShA==","signatures":[{"sig":"MEUCIEPcrfgfjhtD+6+T+gwaeKQWHPY1iO6kKthxAXX+TBC8AiEA1180TYN2vLVRylV0EU9ZcM3MZGEPMAO80hKk1NXEyno=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13267},"main":"index.js","gitHead":"14f5c151e0baab5916ed58502b346cd6fab49a3f","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"11.17.0","description":"Futuristic AI-powered generator framework for viral internet-style cult meme coins in the Stacks ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.0.6_1781447506797_0.30242008602799353","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@0xward/cultos-utils","version":"1.0.7","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.0.7","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"071551b3fc071d3323500adc4040b69c7bf524a6","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.0.7.tgz","fileCount":4,"integrity":"sha512-6pGP6Z4iTpNXT5J2BSw0UwrkhBw5BGsqYHRHOwyIGAD3jrTcYZiEvun5VUfH29bVgBMxltKqu3sZ8VgqPv1PmA==","signatures":[{"sig":"MEUCIDLaWCnpZKH1iXDDIeuqGZm/EkAo25mbOAl5MBKUwskpAiEAjRFQGHn4h08IuHkjsbyo0OVfyQAjIZUhtp18kXh0b30=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10536},"main":"index.js","gitHead":"ac8bb60bc45c32c8c3e3733b79a54713bad20622","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"11.17.0","description":"Futuristic AI-powered generator framework for viral internet-style cult meme coins in the Stacks ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.0.7_1781448445123_0.5982054173506415","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@0xward/cultos-utils","version":"1.1.1","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.1.1","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"d523cd21c38861d541b2455c2466ac65612a74de","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.1.1.tgz","fileCount":4,"integrity":"sha512-fvkr+yrPpARfqyWvDnqMoyrZd9j8+gnHgIrEPN/NnQYnuTIpWOc4RixWXCrPAVs6I6Wb4jwOmagOdSZc16lwVA==","signatures":[{"sig":"MEUCIQC2Km8B1v0sp0mjHt5VbrHXNvQJYqTbFzumSTAuPG7XkgIgHpS0iWe5tyWCVXDTIblFddXHzFhZ3J44Ic3xAb+QS3k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10536},"main":"index.js","gitHead":"ef839f69f69ed08c42c6b182e7fb0c6fa8d8e747","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"11.17.0","description":"Futuristic AI-powered generator framework for viral internet-style cult meme coins in the Stacks ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.1.1_1781451119376_0.22242474414816038","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@0xward/cultos-utils","version":"1.1.2","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.1.2","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"1e3ebf0726ec2b32d8d29e2627ed13c81fe1d1fc","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.1.2.tgz","fileCount":4,"integrity":"sha512-znjbfWtDqEU0A4UEvKQx3msv84srOvEyMA9Iv9G3El5GH0C5liyqRQ8Rdc0Nh6AtHI0Snl7blsIDVufyLj5qIA==","signatures":[{"sig":"MEQCIHIdgX7Ty5Hiy40DJvsQDZckaN8DS9Y3omEr5Hs9vfEoAiAvTEUJCiFU9dp8UffLwihLMBWXoI6IgksTvK4e49M4SQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9924},"main":"index.js","gitHead":"2ced4608fab6a04dc53354d6c8623772525b359f","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"11.17.0","description":"Futuristic AI-powered generator framework for viral internet-style cult meme coins in the Stacks ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.1.2_1781451520591_0.7051183877326164","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"@0xward/cultos-utils","version":"1.1.3","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.1.3","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"e454a8a006c619add82a2bfe5f360bd850a71e5c","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.1.3.tgz","fileCount":4,"integrity":"sha512-Fuvv5wnQWLUn91yhDV2BWS1OXu96OrJF7hZOZgOG7V/4tuTAe7NoWyGb7bhHXltOZkb+1OY3miTGOLy1wqvZMQ==","signatures":[{"sig":"MEUCIFZ0Oa6Yw5NkWwVe84WEVXWJJuSpZa3qW3+ukaLM2iMsAiEA1wb90LVyw6OuiXXFBwjDe+dsOeQSZE0L7RgPKbOOgm0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10424},"main":"index.js","gitHead":"4f93d1142d7e746e647ee21208b61a484329a290","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"11.17.0","description":"Futuristic AI-powered generator framework for viral internet-style cult meme coins in the Stacks ecosystem.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.1.3_1781452319100_0.8874955135418725","host":"s3://npm-registry-packages-npm-production"}},"1.1.4":{"name":"@0xward/cultos-utils","version":"1.1.4","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/cultos-utils@1.1.4","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"dist":{"shasum":"b4087e443ff2e824eb88691602f35fb5df852535","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.1.4.tgz","fileCount":4,"integrity":"sha512-XiP88VrMuicb4ycDnsxuE1XlHoYOq//UnVnv1h74b8bvhlVezu6ee+Ga0xwGFNdvP/cLPq/LI7/apfw8CD4EAQ==","signatures":[{"sig":"MEYCIQDtE2dpn1Gx++TmuG9OJqQcWR5lEHhEIHCHjhagWPBojAIhALPX0MF0MS+Ct8VYa3aZRsc4q5rPtEV2ciKJVzgUqLdL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10424},"main":"index.js","gitHead":"73081e4436bee2e358c17cc68c60f2a171396eec","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/cultos-utils.git","type":"git"},"_npmVersion":"10.8.2","description":"Futuristic AI-powered generator framework for viral internet-style cult meme coins in the Stacks ecosystem.","directories":{},"_nodeVersion":"18.20.8","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cultos-utils_1.1.4_1781492189069_0.05290672397103369","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@0xward/cultos-utils","version":"1.2.0","description":"Fee calculation, field sanitization, viral score rating, and SIP-010 metadata generation for CultOS — the AI-powered memetic identity engine on Stacks (Bitcoin L2).","main":"index.js","keywords":["0xward","cultos","stacks","bitcoin","web3","sip010","utility"],"author":{"name":"0xward"},"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/0xward/cultos-utils.git"},"bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","_id":"@0xward/cultos-utils@1.2.0","gitHead":"ee7d1d5ce74277526e75adfc98533bc25e546b4b","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-yZImEyE6XTVG9Akdn2NY0NYwNqgKN7lOxJFFMSk6hANrIhNLIGdhwdh4HTt2Hb62xgi9Qx6AEgtw5nXh0BtGfQ==","shasum":"f9ece166e66c39025d6639fb7d82dfae0d7d92bf","tarball":"https://registry.npmjs.org/@0xward/cultos-utils/-/cultos-utils-1.2.0.tgz","fileCount":4,"unpackedSize":18236,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCk1hMDvTgMc3xfdrWZjIdce86vM67ZrZQpwZwAUAx++gIgAa/1OS9i809NQpo0pigL7IaU8rWvEPNGd5dXkxOj18s="}]},"_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"directories":{},"maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cultos-utils_1.2.0_1782567806180_0.3831749274490792"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-13T13:15:57.405Z","modified":"2026-06-27T13:43:26.438Z","1.0.0":"2026-06-13T13:15:57.790Z","1.0.1":"2026-06-13T13:54:31.920Z","1.0.2":"2026-06-13T13:56:40.362Z","1.0.5":"2026-06-13T18:27:53.236Z","1.0.6":"2026-06-14T14:31:46.926Z","1.0.7":"2026-06-14T14:47:25.278Z","1.1.0":"2026-06-14T15:25:14.486Z","1.1.1":"2026-06-14T15:31:59.562Z","1.1.2":"2026-06-14T15:38:40.734Z","1.1.3":"2026-06-14T15:51:59.246Z","1.1.4":"2026-06-15T02:56:29.195Z","1.2.0":"2026-06-27T13:43:26.310Z"},"bugs":{"url":"https://github.com/0xward/cultos-utils/issues"},"author":{"name":"0xward"},"license":"MIT","homepage":"https://www.npmjs.com/package/@0xward/cultos-utils#readme","keywords":["0xward","cultos","stacks","bitcoin","web3","sip010","utility"],"repository":{"type":"git","url":"git+https://github.com/0xward/cultos-utils.git"},"description":"Fee calculation, field sanitization, viral score rating, and SIP-010 metadata generation for CultOS — the AI-powered memetic identity engine on Stacks (Bitcoin L2).","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"readme":"<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/0xward/CultOS-V2/main/public/CultOS_Logo.png\" width=\"96\" alt=\"CultOS logo\" />\n</p>\n\n# @0xward/cultos-utils\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@0xward/cultos-utils\"><img src=\"https://img.shields.io/npm/v/@0xward/cultos-utils?style=flat-square\" alt=\"NPM Version\" /></a>\n  <a href=\"https://www.npmjs.com/package/@0xward/cultos-utils\"><img src=\"https://img.shields.io/npm/dm/@0xward/cultos-utils?style=flat-square\" alt=\"NPM Downloads\" /></a>\n  <a href=\"https://www.npmjs.com/package/@0xward/cultos-utils\"><img src=\"https://img.shields.io/npm/l/@0xward/cultos-utils?style=flat-square\" alt=\"License\" /></a>\n</p>\n\nShared utility layer for **[CultOS](https://github.com/0xward/CultOS-V2)** — an AI-powered memetic identity engine that permanently inscribes cultural identity vectors onto Bitcoin via Stacks L2. This package provides the fee calculation, token field sanitization, viral score rating, and SIP-010 metadata generation that the CultOS V2 web app runs before every on-chain deployment.\n\n> **Note:** this package does **not** sign or broadcast transactions. It handles the client-side logic layer — computing fees, sanitizing Oracle output, and shaping token metadata — before the user's wallet (Leather / Xverse) signs the actual contract call via `@stacks/connect`.\n\n---\n\n## Installation\n\n```bash\n# npm\nnpm install @0xward/cultos-utils\n\n# yarn\nyarn add @0xward/cultos-utils\n\n# pnpm\npnpm add @0xward/cultos-utils\n```\n\n**Prerequisites:** Node.js >= 18.0.0\n\n**Peer context:** If you're integrating into a Stacks app, you'll typically also use `@stacks/connect` for wallet connection and `@stacks/transactions` for constructing contract call arguments.\n\n---\n\n## What this package actually does\n\n- **Fee calculation** — `calcDeployFee(viralScore)` computes the STX deployment fee using the same formula as CultOS V2's `handleDeploy()`: `0.05 + (viralScore / 100) * 0.1`. Returns `feeSTX`, `microSTX`, and the clamped score, ready to pass directly to `openContractCall()`.\n\n- **Field sanitization** — `sanitizeField(str, field)` strips non-ASCII characters and enforces character limits (name: 64, ticker: 8, lore: 490), identical to the guard in CultOS V2 before every on-chain call. `sanitizeOracleResult(oracleResult)` sanitizes all three fields at once and returns `{ safeName, safeTicker, safeLore }`.\n\n- **Viral score rating** — `getViralRating(viralScore)` maps a numeric Oracle score to the display label and color used throughout CultOS V2: `>= 80` → Viral (green), `>= 50` → Growing (amber), `< 50` → Niche (red).\n\n- **SIP-010 metadata generation** — `generateMemeMetadata(name, ticker, options)` shapes a complete token metadata object — including ecosystem, network, archetype, tokenomics, fee estimate, and viral rating — for previewing a sub-cult before the user confirms deployment.\n\n### What this package does **not** do\n- It does not call the Groq API or the CultOS Oracle. Oracle invocation happens server-side in CultOS V2's Vercel function (`/api/oracle`).\n- It does not sign or broadcast Stacks transactions.\n- It does not interact with Firebase or any real-time database.\n\n---\n\n## Quick Start\n\n```javascript\nconst { CultOSUtils } = require(\"@0xward/cultos-utils\");\n\nconst utils = new CultOSUtils({ network: \"mainnet\" });\n\n// 1. Sanitize Oracle output before passing to openContractCall()\nconst { safeName, safeTicker, safeLore } = utils.sanitizeOracleResult({\n  upgradedName: \"ENTROPIC VEIL\",\n  ticker:       \"XVRL\",\n  lore:         \"A sovereign signal cast across the memetic substrate...\",\n});\n\n// 2. Calculate the deployment fee from the Oracle's viralScore\nconst { feeSTX, microSTX } = utils.calcDeployFee(78);\nconsole.log(`Fee: ${feeSTX} STX (${microSTX} microSTX)`);\n// → Fee: 0.128 STX (128000 microSTX)\n\n// 3. Get the display rating for the viralScore\nconst { rating, color } = utils.getViralRating(78);\nconsole.log(`${rating}`); // → Growing\n\n// 4. Generate a full SIP-010 metadata preview\nconst metadata = utils.generateMemeMetadata(\"ENTROPIC VEIL\", \"XVRL\", {\n  archetype:  \"oracle\",\n  tokenomics: \"fair\",\n});\nconsole.log(metadata);\n```\n\n---\n\n## API Reference\n\n### `new CultOSUtils(options?)`\n\n| Option | Type | Default | Description |\n| :--- | :--- | :--- | :--- |\n| `network` | `\"mainnet\" \\| \"testnet\" \\| \"devnet\"` | `\"mainnet\"` | Stacks network context. Throws if unsupported. |\n| `ecosystem` | `string` | `\"Stacks Bitcoin L2\"` | Ecosystem label included in metadata output. |\n| `standard` | `string` | `\"SIP-010\"` | Token standard label included in metadata output. |\n\n### Methods\n\n| Method | Parameters | Returns | Description |\n| :--- | :--- | :--- | :--- |\n| `sanitizeField` | `str: string`, `field: \"name\"\\|\"ticker\"\\|\"lore\"` | `string` | Strips non-ASCII, enforces field character limit. Mirrors CultOS V2's pre-deploy guard. |\n| `sanitizeOracleResult` | `oracleResult: { upgradedName, ticker, lore }` | `{ safeName, safeTicker, safeLore }` | Sanitizes all three required fields at once. |\n| `calcDeployFee` | `viralScore: number` | `{ feeSTX, microSTX, viralScore }` | Computes STX fee from viralScore using the CultOS V2 formula. |\n| `getViralRating` | `viralScore: number` | `{ rating, color }` | Returns the display label and hex color for a viralScore. |\n| `generateMemeMetadata` | `name: string`, `ticker: string`, `options?: Object` | `Object` | Returns a full SIP-010 token metadata object with fee estimate and viral rating. |\n| `getCultArchetypes` | — | `Array` | Lists all supported cult archetypes with their viral multipliers. |\n| `getTokenomicsPresets` | — | `Array` | Lists all tokenomics distribution presets. |\n| `getSupportedNetworks` | — | `Array` | Lists mainnet, testnet, and devnet config (chainId, apiUrl, currency). |\n| `getVersion` | — | `string` | Returns the package version string. |\n\n---\n\n## Used by\n\nThis package is the shared utility layer behind **[CultOS V2](https://github.com/0xward/CultOS-V2)** — the AI-powered cult identity engine on Stacks. CultOS V2 uses `sanitizeOracleResult()`, `calcDeployFee()`, and `getViralRating()` from this package in its deployment flow before every on-chain `register-cult` contract call.\n\n---\n\n## License\n\nThis project is licensed under the terms of the MIT License.\n","readmeFilename":"README.md"}