{"_id":"@0xward/twinpayai-client","_rev":"14-f0b178f64970e2c8518906ba55e23164","name":"@0xward/twinpayai-client","dist-tags":{"latest":"1.1.6"},"versions":{"1.0.0":{"name":"@0xward/twinpayai-client","version":"1.0.0","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.0.0","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"dist":{"shasum":"f1ffe6c810c41a0b36a871257931f003606b2a46","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.0.0.tgz","fileCount":3,"integrity":"sha512-sk6w9PVvIPa0VgjyDsaS4OnGg2L6wOg7Z82Z3z+c4yfN/kAHmvivYeqzBILALplhMUUxePi7kXwBIWIXdsjQDQ==","signatures":[{"sig":"MEUCIFL7cxU3kOd93zsbkUXxo/c9Yncl01XeKNGsu+RZTD1pAiEA6r00Kd2GXS0gHcThs7/Jh07z4wYVLmvKxoFTXtXCrTU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":543},"main":"index.js","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"_npmVersion":"11.17.0","description":"Governance poll and soulbound token helper for TwinPayAI.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.0.0_1781356751977_0.8287351085738139","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@0xward/twinpayai-client","version":"1.0.1","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.0.1","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"dist":{"shasum":"bb83ddc1a6b320b7b0fb76f153d10ce02f3fbe7a","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.0.1.tgz","fileCount":3,"integrity":"sha512-omHIfHzNSA7QPGNo0cqz9T2qSQhcEDdVNzlr7JCf7/FNcc2SvkiNSoZXos5kCnJPFY7RkOdRbgjUr6AI7GTtyA==","signatures":[{"sig":"MEYCIQDT5tR3t0jvrfZ/CKGv4eqeImnHOOKYllMIQFWs417c2gIhANveNiTCgL7i+vIMLPiDcQXmSpTX039bqpVFGR/tu+1g","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1060},"main":"index.js","gitHead":"f1b899270dec8bf76c0766cc2217e260c8787668","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"_npmVersion":"11.17.0","description":"Governance poll and soulbound token helper for TwinPayAI.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.0.1_1781358866993_0.45781825821633015","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@0xward/twinpayai-client","version":"1.0.2","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.0.2","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://github.com/0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"9a4db3040471d46ff8f88799a398da11f42e9cc2","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.0.2.tgz","fileCount":3,"integrity":"sha512-HaKn/Rm+ABjb7u03seNf2pk+o2poaxk4gtXIgghS9TI+B3TulQ1qXJkFFvdXrzcDr7jzeg2Wm9atp0ig8CXwdw==","signatures":[{"sig":"MEUCIQDuSQIHV1VTpo3pO0+g9i+uAdS3sHxiXLodhqOcCUA5AQIgCaoN//Ot2V6/ZlCaQs1Z1/sx7hiHO3Z/l3lRa+RkiA4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1313},"main":"index.js","gitHead":"f1b899270dec8bf76c0766cc2217e260c8787668","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"11.17.0","description":"Governance poll and soulbound token helper for TwinPayAI.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.0.2_1781358995503_0.7198274147630335","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@0xward/twinpayai-client","version":"1.0.5","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.0.5","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"19a24eb906462e7d347f981733e732cb17e600f8","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.0.5.tgz","fileCount":7,"integrity":"sha512-0SGQfDOvIxMoBAbwWQcXv3AQ5c2ZJWxqLajV9sSRjiq3V8Z0tu2bBJCgjkeAhZpSDu7PR8hnClX68PLlCIXMOQ==","signatures":[{"sig":"MEUCIQDEMmlYcDDO2I9Z72u+QcpNII+6Yj5iq0JNZpsd8X9XIQIgcrWkG/HH2/kOmVwY/iA20UVOYuUz77FOqVcC8HezZck=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7787},"main":"index.js","gitHead":"56766be921a0929e0440d29b6ae6dfb107a9aefb","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"11.17.0","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.0.5_1781375265658_0.1955782892153246","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@0xward/twinpayai-client","version":"1.0.6","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.0.6","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"afe87990f0b5920aa07792206c5d9076b9a60634","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.0.6.tgz","fileCount":7,"integrity":"sha512-3kmhZ1D9YRgLeZzyaoepNC5IW4D53kozwSDCgC3HmgHR4q390e1ab73RGORBaKtba5eczQ04x8j3hkm7GYstPQ==","signatures":[{"sig":"MEUCIQC6PrPSkPXz8SbQoDVbI/m+YU2DJYiVspw3WKgZZCOV+QIgInZ3YjxeguS56pDRFgHysVtXMkhMcimlRpE2li1LR3Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13346},"main":"index.js","gitHead":"48532004206acce0841ac83c6e2f793091ab9d89","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"11.17.0","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.0.6_1781447498853_0.1308282760758861","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@0xward/twinpayai-client","version":"1.0.7","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.0.7","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"a2fb2f0eddb86f92c13d753eea5865315b249d6f","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.0.7.tgz","fileCount":4,"integrity":"sha512-gWtlChJ5bwBACd9i2VoF8oVRZ6Z/5EIXv3WHMYfL6ypIrevZhBkZWj8x+t7/c1uTxI2rLFk9ahrGcrz5/tCG8A==","signatures":[{"sig":"MEQCIEPNOwbd6rVy2A44f8hLuC4y9YbVJLv4dnjvF9NJ6ZCuAiAhvQiev02h0a6TRhy/h0cPcjT4zKYQr6unW6/paf2bMA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10583},"main":"index.js","gitHead":"7b8f9823de45b68888c42651fdf70fe8ee4094f9","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"11.17.0","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.0.7_1781448437193_0.09667736406500316","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@0xward/twinpayai-client","version":"1.1.1","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.1.1","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"b0a14079085d7db038e8be1d8fae341768f8d7ea","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.1.1.tgz","fileCount":4,"integrity":"sha512-N9d5XUX3qaLwo8suivewEi4CrP+GJaaO5VDh8+POL5rAvay7FAueCWEzKPpKDk6XThQzGpj+aYcPrXHk12XxYg==","signatures":[{"sig":"MEQCIE4Fn4ay6gZejONRCoMFQfVGTYkkLVy0eVtn9DtAJ44GAiBst7INjIaiXBaU2FrnG5yuzxXZADhUHwTTg4jfWZ6E1Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10838},"main":"index.js","gitHead":"39301d13a091a5d5ded287e5a14940e505a63300","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"11.17.0","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.1.1_1781451105630_0.7631802227658744","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@0xward/twinpayai-client","version":"1.1.2","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.1.2","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"2c2af64854db06c84a7fba5d343e41dd85ad0514","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.1.2.tgz","fileCount":4,"integrity":"sha512-/k3QF1kMavX8tlSGCZErAWIpfaxyNfJCmo1r5jabV6ybn5IQgp02UUfP6DIA7rXhRQHy83nso/C0TM7dOPYzMQ==","signatures":[{"sig":"MEQCICds1QviYfp4JX2Cfm6/KSUvadQui+6pQ6r7+s2DbfgZAiAC43j58DkJtaAz4Bbc/S6Wg3aWNAdHztw8X9/X2w4xKQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10202},"main":"index.js","gitHead":"0a4708fe9e5c658e3de5c7cd01ef10967d9c1c18","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"11.17.0","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.1.2_1781451507547_0.8424695937723643","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"@0xward/twinpayai-client","version":"1.1.3","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.1.3","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"0e20abb9d9f1e311a0a7f3060ccec26383b7997c","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.1.3.tgz","fileCount":4,"integrity":"sha512-/gYqfUWrDkP7PldjCNyziDviz4pKJ+s31aVKe8BH7E6/PnEblAWuXOhszWDTB6RRV+j/mA/tbVU3fdK3feWKkw==","signatures":[{"sig":"MEUCIQDYRfox35Lhc3qdE829pLFvh4hyb64GL+1B1PwqHkpTOwIgFSQf1MIoLHcwrzlT1OqBbLRxHm4Qo62VaIFlHR9qMqs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10726},"main":"index.js","gitHead":"f425cb624993db88b4bf3e4b140daf9c69abc2c3","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"11.17.0","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"26.3.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.1.3_1781452305697_0.3211651562518938","host":"s3://npm-registry-packages-npm-production"}},"1.1.4":{"name":"@0xward/twinpayai-client","version":"1.1.4","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.1.4","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"93c8d4076d7681b05be0f22c732aa7184a99db5d","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.1.4.tgz","fileCount":4,"integrity":"sha512-9FwyCfqPkDdyn92KNjsB6CR2+zBKSGvH5rbPEE/d2jL2zoVL89iG3PxvDlAqH+4Qr3cpxJdnemN5hN3NJQ2rqw==","signatures":[{"sig":"MEUCIGPRxLSQE84q1jUqz3mMyFpzq1ZIP63lYlKQL/iuyHJnAiEA9kc/mIg7wWt1AULWMEq4aq+KtAekh7u9VoUi93dV154=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10198},"main":"index.js","gitHead":"ceed309895d0a1307f78c16c448afb98090faa43","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"10.8.2","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"18.20.8","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.1.4_1781492183524_0.4594254870282084","host":"s3://npm-registry-packages-npm-production"}},"1.1.5":{"name":"@0xward/twinpayai-client","version":"1.1.5","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","_id":"@0xward/twinpayai-client@1.1.5","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"dist":{"shasum":"1a28d214fe82b2cefc8cf28ecf9f2034fa35deb1","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.1.5.tgz","fileCount":4,"integrity":"sha512-zNS1h4yQzdqP+N9uG0SYZI+jqKzj6RKFH5UlJwKnF8h25y0zMF5i/M7skrpKUY9M9pKidYv5cQdZ1bRN/16gtA==","signatures":[{"sig":"MEYCIQDVhhwnpm8FsH1+u+EsuDX1brfjaTQs9eJdOuhiTbUoJAIhAKiMlxhrQBGCUEnVNyda/o1tiCbg+leTTplxLrP30nKx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10553},"main":"index.js","gitHead":"ee0047db04113a9b70d22b6da337046cc3119044","_npmUser":{"name":"0xward","email":"0xward.dev@gmail.com"},"repository":{"url":"git+https://github.com/0xward/twinpayai-client.git","type":"git"},"_npmVersion":"10.8.2","description":"AI-powered transaction payment agent built on the Stacks blockchain secured by Bitcoin.","directories":{},"_nodeVersion":"18.20.8","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/twinpayai-client_1.1.5_1782566114720_0.8560148279806741","host":"s3://npm-registry-packages-npm-production"}},"1.1.6":{"name":"@0xward/twinpayai-client","version":"1.1.6","description":"Validation, fee estimation, and request-shaping client for TwinPay AI — an AI-powered payments agent on the Stacks blockchain (Bitcoin L2).","main":"index.js","keywords":["0xward","web3","utility"],"author":{"name":"0xward"},"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/0xward/twinpayai-client.git"},"bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","_id":"@0xward/twinpayai-client@1.1.6","gitHead":"1073be807f9e89e423805484f6b306add3e997b0","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-82Z8epD7oEqGB5v/b7BvzHZSYT2chts/l3hVJmU/i4lKF+x06cZaouolGFDvyUQTn4sESIoWnFYmGqFtgTrTug==","shasum":"85de20895362fc5cef2b0d4d328f19d85584c455","tarball":"https://registry.npmjs.org/@0xward/twinpayai-client/-/twinpayai-client-1.1.6.tgz","fileCount":4,"unpackedSize":13173,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC9WNcZ27aSuKPlterSEtjzSqkGm7J+FiN97veCiaO+EgIgJ4qopQJi94II8nptVFbLp/FLrm/7RceHiaVSw2zdBfs="}]},"_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/twinpayai-client_1.1.6_1782566627783_0.2129097266416744"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-13T13:19:11.785Z","modified":"2026-06-27T13:23:48.061Z","1.0.0":"2026-06-13T13:19:12.135Z","1.0.1":"2026-06-13T13:54:27.140Z","1.0.2":"2026-06-13T13:56:35.636Z","1.0.5":"2026-06-13T18:27:45.888Z","1.0.6":"2026-06-14T14:31:39.016Z","1.0.7":"2026-06-14T14:47:17.353Z","1.1.0":"2026-06-14T15:25:01.028Z","1.1.1":"2026-06-14T15:31:45.760Z","1.1.2":"2026-06-14T15:38:27.689Z","1.1.3":"2026-06-14T15:51:45.855Z","1.1.4":"2026-06-15T02:56:23.646Z","1.1.5":"2026-06-27T13:15:14.843Z","1.1.6":"2026-06-27T13:23:47.947Z"},"bugs":{"url":"https://github.com/0xward/twinpayai-client/issues"},"author":{"name":"0xward"},"license":"MIT","homepage":"https://www.npmjs.com/package/@0xward/twinpayai-client#readme","keywords":["0xward","web3","utility"],"repository":{"type":"git","url":"git+https://github.com/0xward/twinpayai-client.git"},"description":"Validation, fee estimation, and request-shaping client for TwinPay AI — an AI-powered payments agent on the Stacks blockchain (Bitcoin L2).","maintainers":[{"name":"0xward","email":"0xward.dev@gmail.com"}],"readme":"<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/0xward/TwinPayAI/main/TwinPayAI_Logo.png\" width=\"96\" alt=\"TwinPay AI logo\" />\n</p>\n\n# @0xward/twinpayai-client\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@0xward/twinpayai-client\"><img src=\"https://img.shields.io/npm/v/@0xward/twinpayai-client?style=flat-square\" alt=\"NPM Version\" /></a>\n  <a href=\"https://www.npmjs.com/package/@0xward/twinpayai-client\"><img src=\"https://img.shields.io/npm/dm/@0xward/twinpayai-client?style=flat-square\" alt=\"NPM Downloads\" /></a>\n  <a href=\"https://www.npmjs.com/package/@0xward/twinpayai-client\"><img src=\"https://img.shields.io/npm/l/@0xward/twinpayai-client?style=flat-square\" alt=\"License\" /></a>\n</p>\n\nA lightweight helper client for **[TwinPay AI](https://github.com/0xward/TwinPayAI)** — an AI-powered payments agent built on **Stacks**, the Bitcoin Layer 2 network. This package provides the address/amount validation, fee estimation, and request-shaping logic that TwinPay AI's decision engine uses before a payment is ever signed by the user's wallet.\n\n> **Note:** this client does **not** sign or broadcast transactions itself. It validates inputs, estimates fees, and builds structured request/response objects. Actual signing and broadcasting happen in the host app via `@stacks/connect`, with the user's own wallet (Leather / Xverse).\n\n---\n\n## Installation\n\n### Prerequisites\n- Node.js >= 18.0.0\n- npm >= 9.0.0 (or yarn >= 1.22.0 / pnpm >= 8.0.0)\n\n### Install\n\n```bash\n# npm\nnpm install @0xward/twinpayai-client\n\n# yarn\nyarn add @0xward/twinpayai-client\n\n# pnpm\npnpm add @0xward/twinpayai-client\n```\n\n### Peer context\nThis client is network-agnostic on its own — it does not make any HTTP/RPC calls. If you're integrating it into a Stacks app, you'll typically also use:\n- `@stacks/connect` (>= 7.x) for wallet connection and transaction signing.\n- `@stacks/transactions` / `@stacks/network` (>= 6.x) if you need to construct or broadcast the actual signed transaction.\n\n---\n\n## What this package actually does\n\n* **Input validation** — checks that a recipient is a valid Stacks address (`SP...`) or BNS name (`name.btc` / `name.stx`), and that an amount is a sane positive number within configured min/max bounds.\n* **Fee estimation** — `estimateFee()` returns a deterministic fee estimate (in microSTX/STX/USD) for a given USD amount, based on a configurable fee rate. This is what TwinPay AI's decision engine (`groqService.ts`) calls before asking the AI to approve, modify, or reject a payment — so the AI reasons over a real fee number instead of a hardcoded guess.\n* **Request/response shaping** — `initiateAiPayment()` and `getTransactionStatus()` return realistic, consistently-shaped objects (txId, status, explorer URL, etc.) for prototyping and testing flows that depend on TwinPay AI's payment lifecycle, without needing a live wallet connection.\n\n### What this package does **not** do\n- It does not sign transactions or hold private keys.\n- It does not broadcast anything to the Stacks network.\n- `initiateAiPayment()` and `getTransactionStatus()` are **simulated** — they generate plausible-looking transaction IDs and statuses for local development/testing, not live on-chain data. For live transaction status, query the Hiro API or Stacks Explorer directly.\n\n---\n\n## Quick Start\n\n```javascript\nconst { TwinPayClient } = require(\"@0xward/twinpayai-client\");\nconst client = new TwinPayClient({ network: \"mainnet\" });\n\n// Estimate the fee for a $50 payment before deciding to send it\nconst fee = client.estimateFee(50.00);\nconsole.log(\"Estimated fee:\", fee);\n\n// Simulate building a payment request (does not sign/broadcast)\nasync function previewPayment() {\n  const result = await client.initiateAiPayment(\"0xward.btc\", 50.00);\n  console.log(\"Simulated payment request:\", result);\n}\npreviewPayment();\n```\n\n---\n\n## API Reference\n\n### `new TwinPayClient(config?)`\n| Option | Type | Default | Description |\n| :--- | :--- | :--- | :--- |\n| `network` | `\"mainnet\" \\| \"testnet\" \\| \"devnet\"` | `\"mainnet\"` | Stacks network context. Throws if unsupported. |\n| `feeRate` | `number` (microSTX) | `2000` | Base fee rate used by `estimateFee()` and `initiateAiPayment()`. |\n\n### Methods\n\n| Method | Parameters | Return Type | Description |\n| :--- | :--- | :--- | :--- |\n| `estimateFee` | `amountUsd: number` | `Object` | Returns `{ amountUsd, amountMicroStx, estimatedFeeMicroStx, estimatedFeeStx, estimatedFeeUsd, network }`. |\n| `initiateAiPayment` | `recipient: string`, `amountUsd: number` | `Promise<Object>` | Validates inputs and returns a simulated payment request object (txId, status, explorer URL, etc.). |\n| `getTransactionStatus` | `txId: string` | `Promise<Object>` | Returns a simulated status object for a given txId (deterministic based on the txId, not a live chain query). |\n| `getSupportedNetworks` | — | `Array<Object>` | Lists configured networks (`mainnet`, `testnet`, `devnet`) with their chain ID, API URL, and currency. |\n| `getVersion` | — | `string` | Returns the client's internal version string. |\n\n---\n\n## Used by\n\nThis client is the validation/fee-estimation layer behind [**TwinPay AI**](https://github.com/0xward/TwinPayAI), an agentic payments app on Stacks. See the main repo for the full product: AI decision engine, on-chain spending vault, multisig vault, and more.\n\n---\n\n## License\n\nThis project is licensed under the terms of the MIT License.\n","readmeFilename":"README.md"}