mppx 0.6.31 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (616) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/README.md +20 -11
  3. package/dist/Challenge.d.ts.map +1 -1
  4. package/dist/Challenge.js +27 -13
  5. package/dist/Challenge.js.map +1 -1
  6. package/dist/Constants.d.ts +46 -0
  7. package/dist/Constants.d.ts.map +1 -0
  8. package/dist/Constants.js +46 -0
  9. package/dist/Constants.js.map +1 -0
  10. package/dist/Credential.d.ts.map +1 -1
  11. package/dist/Credential.js +5 -4
  12. package/dist/Credential.js.map +1 -1
  13. package/dist/Mcp.d.ts +3 -0
  14. package/dist/Mcp.d.ts.map +1 -1
  15. package/dist/Mcp.js +2 -0
  16. package/dist/Mcp.js.map +1 -1
  17. package/dist/Method.d.ts +32 -4
  18. package/dist/Method.d.ts.map +1 -1
  19. package/dist/Method.js +5 -2
  20. package/dist/Method.js.map +1 -1
  21. package/dist/PaymentRequest.d.ts +10 -10
  22. package/dist/PaymentRequest.js +8 -8
  23. package/dist/Receipt.d.ts.map +1 -1
  24. package/dist/Receipt.js +3 -2
  25. package/dist/Receipt.js.map +1 -1
  26. package/dist/cli/cli.d.ts.map +1 -1
  27. package/dist/cli/cli.js +19 -11
  28. package/dist/cli/cli.js.map +1 -1
  29. package/dist/cli/plugins/tempo.d.ts.map +1 -1
  30. package/dist/cli/plugins/tempo.js +17 -6
  31. package/dist/cli/plugins/tempo.js.map +1 -1
  32. package/dist/cli/utils.d.ts +5 -0
  33. package/dist/cli/utils.d.ts.map +1 -1
  34. package/dist/cli/utils.js +10 -0
  35. package/dist/cli/utils.js.map +1 -1
  36. package/dist/client/Methods.d.ts +5 -2
  37. package/dist/client/Methods.d.ts.map +1 -1
  38. package/dist/client/Methods.js +5 -2
  39. package/dist/client/Methods.js.map +1 -1
  40. package/dist/client/Mppx.js +2 -2
  41. package/dist/client/Mppx.js.map +1 -1
  42. package/dist/client/Transport.d.ts +11 -16
  43. package/dist/client/Transport.d.ts.map +1 -1
  44. package/dist/client/Transport.js +55 -76
  45. package/dist/client/Transport.js.map +1 -1
  46. package/dist/client/index.d.ts +5 -1
  47. package/dist/client/index.d.ts.map +1 -1
  48. package/dist/client/index.js +3 -1
  49. package/dist/client/index.js.map +1 -1
  50. package/dist/client/internal/Fetch.d.ts.map +1 -1
  51. package/dist/client/internal/Fetch.js +60 -13
  52. package/dist/client/internal/Fetch.js.map +1 -1
  53. package/dist/client/internal/protocols/Mcp.d.ts +7 -0
  54. package/dist/client/internal/protocols/Mcp.d.ts.map +1 -0
  55. package/dist/client/internal/protocols/Mcp.js +159 -0
  56. package/dist/client/internal/protocols/Mcp.js.map +1 -0
  57. package/dist/client/internal/protocols/Mpp.d.ts +4 -0
  58. package/dist/client/internal/protocols/Mpp.d.ts.map +1 -0
  59. package/dist/client/internal/protocols/Mpp.js +18 -0
  60. package/dist/client/internal/protocols/Mpp.js.map +1 -0
  61. package/dist/client/internal/protocols/Protocol.d.ts +10 -0
  62. package/dist/client/internal/protocols/Protocol.d.ts.map +1 -0
  63. package/dist/client/internal/protocols/Protocol.js +2 -0
  64. package/dist/client/internal/protocols/Protocol.js.map +1 -0
  65. package/dist/client/internal/protocols/Shared.d.ts +5 -0
  66. package/dist/client/internal/protocols/Shared.d.ts.map +1 -0
  67. package/dist/client/internal/protocols/Shared.js +20 -0
  68. package/dist/client/internal/protocols/Shared.js.map +1 -0
  69. package/dist/client/internal/protocols/X402.d.ts +8 -0
  70. package/dist/client/internal/protocols/X402.d.ts.map +1 -0
  71. package/dist/client/internal/protocols/X402.js +39 -0
  72. package/dist/client/internal/protocols/X402.js.map +1 -0
  73. package/dist/evm/client/index.d.ts +1 -0
  74. package/dist/evm/client/index.d.ts.map +1 -1
  75. package/dist/evm/client/index.js +1 -0
  76. package/dist/evm/client/index.js.map +1 -1
  77. package/dist/evm/index.d.ts +2 -0
  78. package/dist/evm/index.d.ts.map +1 -1
  79. package/dist/evm/index.js +2 -0
  80. package/dist/evm/index.js.map +1 -1
  81. package/dist/evm/server/Methods.d.ts +1 -1
  82. package/dist/evm/server/Methods.d.ts.map +1 -1
  83. package/dist/evm/server/index.d.ts +1 -0
  84. package/dist/evm/server/index.d.ts.map +1 -1
  85. package/dist/evm/server/index.js +1 -0
  86. package/dist/evm/server/index.js.map +1 -1
  87. package/dist/index.d.ts +1 -0
  88. package/dist/index.d.ts.map +1 -1
  89. package/dist/index.js +1 -0
  90. package/dist/index.js.map +1 -1
  91. package/dist/internal/AcceptPayment.d.ts +3 -0
  92. package/dist/internal/AcceptPayment.d.ts.map +1 -1
  93. package/dist/internal/AcceptPayment.js +15 -11
  94. package/dist/internal/AcceptPayment.js.map +1 -1
  95. package/dist/mcp/client/McpClient.d.ts +101 -0
  96. package/dist/mcp/client/McpClient.d.ts.map +1 -0
  97. package/dist/mcp/client/McpClient.js +162 -0
  98. package/dist/mcp/client/McpClient.js.map +1 -0
  99. package/dist/mcp/client/index.d.ts.map +1 -0
  100. package/dist/mcp/client/index.js.map +1 -0
  101. package/dist/mcp/server/Transport.d.ts.map +1 -0
  102. package/dist/mcp/server/Transport.js.map +1 -0
  103. package/dist/mcp/server/index.d.ts.map +1 -0
  104. package/dist/mcp/server/index.js.map +1 -0
  105. package/dist/server/Mppx.d.ts +12 -4
  106. package/dist/server/Mppx.d.ts.map +1 -1
  107. package/dist/server/Mppx.js +85 -27
  108. package/dist/server/Mppx.js.map +1 -1
  109. package/dist/server/Response.d.ts.map +1 -1
  110. package/dist/server/Response.js +2 -1
  111. package/dist/server/Response.js.map +1 -1
  112. package/dist/server/Transport.d.ts +1 -1
  113. package/dist/server/Transport.d.ts.map +1 -1
  114. package/dist/server/Transport.js +5 -4
  115. package/dist/server/Transport.js.map +1 -1
  116. package/dist/server/index.d.ts +1 -0
  117. package/dist/server/index.d.ts.map +1 -1
  118. package/dist/server/index.js +1 -0
  119. package/dist/server/index.js.map +1 -1
  120. package/dist/stripe/client/Charge.d.ts +1 -1
  121. package/dist/stripe/client/Charge.d.ts.map +1 -1
  122. package/dist/stripe/client/Charge.js +3 -1
  123. package/dist/stripe/client/Charge.js.map +1 -1
  124. package/dist/stripe/server/Charge.d.ts +1 -1
  125. package/dist/stripe/server/Charge.d.ts.map +1 -1
  126. package/dist/stripe/server/Charge.js +9 -2
  127. package/dist/stripe/server/Charge.js.map +1 -1
  128. package/dist/stripe/server/Methods.d.ts +1 -1
  129. package/dist/stripe/server/Methods.d.ts.map +1 -1
  130. package/dist/stripe/server/internal/html.gen.d.ts +1 -1
  131. package/dist/stripe/server/internal/html.gen.d.ts.map +1 -1
  132. package/dist/stripe/server/internal/html.gen.js +1 -1
  133. package/dist/stripe/server/internal/html.gen.js.map +1 -1
  134. package/dist/tempo/Methods.d.ts +18 -0
  135. package/dist/tempo/Methods.d.ts.map +1 -1
  136. package/dist/tempo/Methods.js +16 -1
  137. package/dist/tempo/Methods.js.map +1 -1
  138. package/dist/tempo/Proof.d.ts +85 -1
  139. package/dist/tempo/Proof.d.ts.map +1 -1
  140. package/dist/tempo/Proof.js +35 -0
  141. package/dist/tempo/Proof.js.map +1 -1
  142. package/dist/tempo/client/Charge.d.ts +19 -1
  143. package/dist/tempo/client/Charge.d.ts.map +1 -1
  144. package/dist/tempo/client/Charge.js +47 -27
  145. package/dist/tempo/client/Charge.js.map +1 -1
  146. package/dist/tempo/client/Methods.d.ts +41 -10
  147. package/dist/tempo/client/Methods.d.ts.map +1 -1
  148. package/dist/tempo/client/Methods.js +16 -7
  149. package/dist/tempo/client/Methods.js.map +1 -1
  150. package/dist/tempo/client/ResolveAccount.d.ts +40 -0
  151. package/dist/tempo/client/ResolveAccount.d.ts.map +1 -0
  152. package/dist/tempo/client/ResolveAccount.js +2 -0
  153. package/dist/tempo/client/ResolveAccount.js.map +1 -0
  154. package/dist/tempo/client/index.d.ts +7 -4
  155. package/dist/tempo/client/index.d.ts.map +1 -1
  156. package/dist/tempo/client/index.js +5 -3
  157. package/dist/tempo/client/index.js.map +1 -1
  158. package/dist/tempo/index.d.ts +1 -0
  159. package/dist/tempo/index.d.ts.map +1 -1
  160. package/dist/tempo/index.js +1 -0
  161. package/dist/tempo/index.js.map +1 -1
  162. package/dist/tempo/internal/fee-payer.d.ts +29 -1
  163. package/dist/tempo/internal/fee-payer.d.ts.map +1 -1
  164. package/dist/tempo/internal/fee-payer.js +138 -4
  165. package/dist/tempo/internal/fee-payer.js.map +1 -1
  166. package/dist/tempo/internal/proof.d.ts +71 -5
  167. package/dist/tempo/internal/proof.d.ts.map +1 -1
  168. package/dist/tempo/internal/proof.js +42 -6
  169. package/dist/tempo/internal/proof.js.map +1 -1
  170. package/dist/tempo/{client → legacy/client}/ChannelOps.d.ts +19 -6
  171. package/dist/tempo/legacy/client/ChannelOps.d.ts.map +1 -0
  172. package/dist/tempo/{client → legacy/client}/ChannelOps.js +9 -3
  173. package/dist/tempo/legacy/client/ChannelOps.js.map +1 -0
  174. package/dist/tempo/{client → legacy/client}/Session.d.ts +23 -4
  175. package/dist/tempo/legacy/client/Session.d.ts.map +1 -0
  176. package/dist/tempo/{client → legacy/client}/Session.js +14 -7
  177. package/dist/tempo/legacy/client/Session.js.map +1 -0
  178. package/dist/tempo/{client → legacy/client}/SessionManager.d.ts +20 -5
  179. package/dist/tempo/legacy/client/SessionManager.d.ts.map +1 -0
  180. package/dist/tempo/{client → legacy/client}/SessionManager.js +30 -19
  181. package/dist/tempo/legacy/client/SessionManager.js.map +1 -0
  182. package/dist/tempo/legacy/client/index.d.ts +7 -0
  183. package/dist/tempo/legacy/client/index.d.ts.map +1 -0
  184. package/dist/tempo/legacy/client/index.js +5 -0
  185. package/dist/tempo/legacy/client/index.js.map +1 -0
  186. package/dist/tempo/legacy/index.d.ts +7 -0
  187. package/dist/tempo/legacy/index.d.ts.map +1 -0
  188. package/dist/tempo/legacy/index.js +7 -0
  189. package/dist/tempo/legacy/index.js.map +1 -0
  190. package/dist/tempo/{server → legacy/server}/Session.d.ts +28 -11
  191. package/dist/tempo/legacy/server/Session.d.ts.map +1 -0
  192. package/dist/tempo/{server → legacy/server}/Session.js +12 -10
  193. package/dist/tempo/legacy/server/Session.js.map +1 -0
  194. package/dist/tempo/legacy/server/index.d.ts +5 -0
  195. package/dist/tempo/legacy/server/index.d.ts.map +1 -0
  196. package/dist/tempo/legacy/server/index.js +5 -0
  197. package/dist/tempo/legacy/server/index.js.map +1 -0
  198. package/dist/tempo/{session → legacy/session}/Chain.d.ts +30 -23
  199. package/dist/tempo/legacy/session/Chain.d.ts.map +1 -0
  200. package/dist/tempo/{session → legacy/session}/Chain.js +12 -11
  201. package/dist/tempo/legacy/session/Chain.js.map +1 -0
  202. package/dist/tempo/{session → legacy/session}/Channel.d.ts +1 -0
  203. package/dist/tempo/legacy/session/Channel.d.ts.map +1 -0
  204. package/dist/tempo/legacy/session/Channel.js.map +1 -0
  205. package/dist/tempo/legacy/session/ChannelStore.d.ts +22 -0
  206. package/dist/tempo/legacy/session/ChannelStore.d.ts.map +1 -0
  207. package/dist/tempo/legacy/session/ChannelStore.js +6 -0
  208. package/dist/tempo/legacy/session/ChannelStore.js.map +1 -0
  209. package/dist/tempo/legacy/session/Types.d.ts +73 -0
  210. package/dist/tempo/legacy/session/Types.d.ts.map +1 -0
  211. package/dist/tempo/legacy/session/Types.js.map +1 -0
  212. package/dist/tempo/{session → legacy/session}/Voucher.d.ts +4 -4
  213. package/dist/tempo/legacy/session/Voucher.d.ts.map +1 -0
  214. package/dist/tempo/{session → legacy/session}/Voucher.js +1 -1
  215. package/dist/tempo/legacy/session/Voucher.js.map +1 -0
  216. package/dist/tempo/{session → legacy/session}/escrow.abi.d.ts +1 -0
  217. package/dist/tempo/{session → legacy/session}/escrow.abi.d.ts.map +1 -1
  218. package/dist/tempo/{session → legacy/session}/escrow.abi.js +1 -0
  219. package/dist/tempo/legacy/session/escrow.abi.js.map +1 -0
  220. package/dist/tempo/legacy/session/index.d.ts +9 -0
  221. package/dist/tempo/legacy/session/index.d.ts.map +1 -0
  222. package/dist/tempo/legacy/session/index.js +9 -0
  223. package/dist/tempo/legacy/session/index.js.map +1 -0
  224. package/dist/tempo/server/Charge.d.ts +1 -1
  225. package/dist/tempo/server/Charge.d.ts.map +1 -1
  226. package/dist/tempo/server/Charge.js +51 -30
  227. package/dist/tempo/server/Charge.js.map +1 -1
  228. package/dist/tempo/server/Methods.d.ts +67 -8
  229. package/dist/tempo/server/Methods.d.ts.map +1 -1
  230. package/dist/tempo/server/Methods.js +40 -10
  231. package/dist/tempo/server/Methods.js.map +1 -1
  232. package/dist/tempo/server/Subscription.d.ts +11 -1
  233. package/dist/tempo/server/Subscription.d.ts.map +1 -1
  234. package/dist/tempo/server/Subscription.js +135 -23
  235. package/dist/tempo/server/Subscription.js.map +1 -1
  236. package/dist/tempo/server/index.d.ts +6 -5
  237. package/dist/tempo/server/index.d.ts.map +1 -1
  238. package/dist/tempo/server/index.js +5 -5
  239. package/dist/tempo/server/index.js.map +1 -1
  240. package/dist/tempo/server/internal/html.gen.d.ts +1 -1
  241. package/dist/tempo/server/internal/html.gen.d.ts.map +1 -1
  242. package/dist/tempo/server/internal/html.gen.js +1 -1
  243. package/dist/tempo/server/internal/html.gen.js.map +1 -1
  244. package/dist/tempo/server/internal/request-body.d.ts +7 -2
  245. package/dist/tempo/server/internal/request-body.d.ts.map +1 -1
  246. package/dist/tempo/server/internal/request-body.js +20 -3
  247. package/dist/tempo/server/internal/request-body.js.map +1 -1
  248. package/dist/tempo/server/internal/transport.d.ts +8 -4
  249. package/dist/tempo/server/internal/transport.d.ts.map +1 -1
  250. package/dist/tempo/server/internal/transport.js +8 -7
  251. package/dist/tempo/server/internal/transport.js.map +1 -1
  252. package/dist/tempo/session/Snapshot.d.ts +32 -0
  253. package/dist/tempo/session/Snapshot.d.ts.map +1 -0
  254. package/dist/tempo/session/Snapshot.js +37 -0
  255. package/dist/tempo/session/Snapshot.js.map +1 -0
  256. package/dist/tempo/session/client/ChannelOps.d.ts +81 -0
  257. package/dist/tempo/session/client/ChannelOps.d.ts.map +1 -0
  258. package/dist/tempo/session/client/ChannelOps.js +201 -0
  259. package/dist/tempo/session/client/ChannelOps.js.map +1 -0
  260. package/dist/tempo/session/client/ChannelStore.d.ts +51 -0
  261. package/dist/tempo/session/client/ChannelStore.d.ts.map +1 -0
  262. package/dist/tempo/session/client/ChannelStore.js +63 -0
  263. package/dist/tempo/session/client/ChannelStore.js.map +1 -0
  264. package/dist/tempo/session/client/CredentialState.d.ts +245 -0
  265. package/dist/tempo/session/client/CredentialState.d.ts.map +1 -0
  266. package/dist/tempo/session/client/CredentialState.js +419 -0
  267. package/dist/tempo/session/client/CredentialState.js.map +1 -0
  268. package/dist/tempo/session/client/ReceiptCoordinator.d.ts +26 -0
  269. package/dist/tempo/session/client/ReceiptCoordinator.d.ts.map +1 -0
  270. package/dist/tempo/session/client/ReceiptCoordinator.js +61 -0
  271. package/dist/tempo/session/client/ReceiptCoordinator.js.map +1 -0
  272. package/dist/tempo/session/client/Runtime.d.ts +464 -0
  273. package/dist/tempo/session/client/Runtime.d.ts.map +1 -0
  274. package/dist/tempo/session/client/Runtime.js +499 -0
  275. package/dist/tempo/session/client/Runtime.js.map +1 -0
  276. package/dist/tempo/session/client/Session.d.ts +138 -0
  277. package/dist/tempo/session/client/Session.d.ts.map +1 -0
  278. package/dist/tempo/session/client/Session.js +69 -0
  279. package/dist/tempo/session/client/Session.js.map +1 -0
  280. package/dist/tempo/session/client/SessionManager.d.ts +84 -0
  281. package/dist/tempo/session/client/SessionManager.d.ts.map +1 -0
  282. package/dist/tempo/session/client/SessionManager.js +577 -0
  283. package/dist/tempo/session/client/SessionManager.js.map +1 -0
  284. package/dist/tempo/session/client/Transports.d.ts +449 -0
  285. package/dist/tempo/session/client/Transports.d.ts.map +1 -0
  286. package/dist/tempo/session/client/Transports.js +721 -0
  287. package/dist/tempo/session/client/Transports.js.map +1 -0
  288. package/dist/tempo/session/client/index.d.ts +11 -0
  289. package/dist/tempo/session/client/index.d.ts.map +1 -0
  290. package/dist/tempo/session/client/index.js +6 -0
  291. package/dist/tempo/session/client/index.js.map +1 -0
  292. package/dist/tempo/session/index.d.ts +7 -8
  293. package/dist/tempo/session/index.d.ts.map +1 -1
  294. package/dist/tempo/session/index.js +7 -8
  295. package/dist/tempo/session/index.js.map +1 -1
  296. package/dist/tempo/session/precompile/Chain.d.ts +319 -0
  297. package/dist/tempo/session/precompile/Chain.d.ts.map +1 -0
  298. package/dist/tempo/session/precompile/Chain.js +492 -0
  299. package/dist/tempo/session/precompile/Chain.js.map +1 -0
  300. package/dist/tempo/session/precompile/Channel.d.ts +46 -0
  301. package/dist/tempo/session/precompile/Channel.d.ts.map +1 -0
  302. package/dist/tempo/session/precompile/Channel.js +56 -0
  303. package/dist/tempo/session/precompile/Channel.js.map +1 -0
  304. package/dist/tempo/session/precompile/Protocol.d.ts +308 -0
  305. package/dist/tempo/session/precompile/Protocol.d.ts.map +1 -0
  306. package/dist/tempo/session/precompile/Protocol.js +264 -0
  307. package/dist/tempo/session/precompile/Protocol.js.map +1 -0
  308. package/dist/tempo/session/precompile/Voucher.d.ts +40 -0
  309. package/dist/tempo/session/precompile/Voucher.d.ts.map +1 -0
  310. package/dist/tempo/session/precompile/Voucher.js +125 -0
  311. package/dist/tempo/session/precompile/Voucher.js.map +1 -0
  312. package/dist/tempo/session/precompile/escrow.abi.d.ts +522 -0
  313. package/dist/tempo/session/precompile/escrow.abi.d.ts.map +1 -0
  314. package/dist/tempo/session/precompile/escrow.abi.js +224 -0
  315. package/dist/tempo/session/precompile/escrow.abi.js.map +1 -0
  316. package/dist/tempo/session/precompile/index.d.ts +24 -0
  317. package/dist/tempo/session/precompile/index.d.ts.map +1 -0
  318. package/dist/tempo/session/precompile/index.js +22 -0
  319. package/dist/tempo/session/precompile/index.js.map +1 -0
  320. package/dist/tempo/session/server/ChannelOps.d.ts +56 -0
  321. package/dist/tempo/session/server/ChannelOps.d.ts.map +1 -0
  322. package/dist/tempo/session/server/ChannelOps.js +91 -0
  323. package/dist/tempo/session/server/ChannelOps.js.map +1 -0
  324. package/dist/tempo/session/server/ChannelStore.d.ts +347 -0
  325. package/dist/tempo/session/server/ChannelStore.d.ts.map +1 -0
  326. package/dist/tempo/session/server/ChannelStore.js +404 -0
  327. package/dist/tempo/session/server/ChannelStore.js.map +1 -0
  328. package/dist/tempo/session/server/CredentialVerification.d.ts +85 -0
  329. package/dist/tempo/session/server/CredentialVerification.d.ts.map +1 -0
  330. package/dist/tempo/session/server/CredentialVerification.js +494 -0
  331. package/dist/tempo/session/server/CredentialVerification.js.map +1 -0
  332. package/dist/tempo/session/server/MeteredStream.d.ts +40 -0
  333. package/dist/tempo/session/server/MeteredStream.d.ts.map +1 -0
  334. package/dist/tempo/session/server/MeteredStream.js +42 -0
  335. package/dist/tempo/session/server/MeteredStream.js.map +1 -0
  336. package/dist/tempo/session/server/RequestState.d.ts +208 -0
  337. package/dist/tempo/session/server/RequestState.d.ts.map +1 -0
  338. package/dist/tempo/session/server/RequestState.js +252 -0
  339. package/dist/tempo/session/server/RequestState.js.map +1 -0
  340. package/dist/tempo/session/server/Session.d.ts +169 -0
  341. package/dist/tempo/session/server/Session.d.ts.map +1 -0
  342. package/dist/tempo/session/server/Session.js +351 -0
  343. package/dist/tempo/session/server/Session.js.map +1 -0
  344. package/dist/tempo/session/server/Settlement.d.ts +185 -0
  345. package/dist/tempo/session/server/Settlement.d.ts.map +1 -0
  346. package/dist/tempo/session/server/Settlement.js +252 -0
  347. package/dist/tempo/session/server/Settlement.js.map +1 -0
  348. package/dist/tempo/session/{Sse.d.ts → server/Sse.d.ts} +9 -56
  349. package/dist/tempo/session/server/Sse.d.ts.map +1 -0
  350. package/dist/tempo/session/server/Sse.js +184 -0
  351. package/dist/tempo/session/server/Sse.js.map +1 -0
  352. package/dist/tempo/session/server/Transports.d.ts +89 -0
  353. package/dist/tempo/session/server/Transports.d.ts.map +1 -0
  354. package/dist/tempo/session/server/Transports.js +149 -0
  355. package/dist/tempo/session/server/Transports.js.map +1 -0
  356. package/dist/tempo/session/server/Ws.d.ts +48 -0
  357. package/dist/tempo/session/server/Ws.d.ts.map +1 -0
  358. package/dist/tempo/session/server/Ws.js +244 -0
  359. package/dist/tempo/session/server/Ws.js.map +1 -0
  360. package/dist/tempo/session/server/index.d.ts +4 -0
  361. package/dist/tempo/session/server/index.d.ts.map +1 -0
  362. package/dist/tempo/session/server/index.js +2 -0
  363. package/dist/tempo/session/server/index.js.map +1 -0
  364. package/dist/tempo/subscription/KeyAuthorization.d.ts +712 -1
  365. package/dist/tempo/subscription/KeyAuthorization.d.ts.map +1 -1
  366. package/dist/tempo/subscription/Store.d.ts +2 -0
  367. package/dist/tempo/subscription/Store.d.ts.map +1 -1
  368. package/dist/tempo/subscription/Store.js +16 -1
  369. package/dist/tempo/subscription/Store.js.map +1 -1
  370. package/dist/x402/index.d.ts +1 -0
  371. package/dist/x402/index.d.ts.map +1 -1
  372. package/dist/x402/index.js +1 -0
  373. package/dist/x402/index.js.map +1 -1
  374. package/package.json +25 -9
  375. package/src/Challenge.test.ts +40 -0
  376. package/src/Challenge.ts +28 -13
  377. package/src/Constants.ts +58 -0
  378. package/src/Credential.ts +5 -4
  379. package/src/Mcp.ts +4 -0
  380. package/src/Method.ts +46 -5
  381. package/src/PaymentRequest.ts +10 -10
  382. package/src/Receipt.ts +3 -2
  383. package/src/cli/cli.test.ts +38 -43
  384. package/src/cli/cli.ts +23 -10
  385. package/src/cli/mcp.test.ts +21 -7
  386. package/src/cli/plugins/tempo.ts +21 -8
  387. package/src/cli/utils.test.ts +25 -1
  388. package/src/cli/utils.ts +10 -0
  389. package/src/client/Methods.ts +5 -2
  390. package/src/client/Mppx.test-d.ts +31 -1
  391. package/src/client/Mppx.test.ts +76 -1
  392. package/src/client/Mppx.ts +2 -2
  393. package/src/client/Transport.test.ts +225 -178
  394. package/src/client/Transport.ts +77 -84
  395. package/src/client/index.ts +25 -1
  396. package/src/client/internal/Fetch.test.ts +236 -6
  397. package/src/client/internal/Fetch.ts +69 -11
  398. package/src/client/internal/protocols/Mcp.test.ts +220 -0
  399. package/src/client/internal/protocols/Mcp.ts +162 -0
  400. package/src/client/internal/protocols/Mpp.ts +21 -0
  401. package/src/client/internal/protocols/Protocol.ts +10 -0
  402. package/src/client/internal/protocols/Shared.ts +25 -0
  403. package/src/client/internal/protocols/X402.ts +42 -0
  404. package/src/discovery/OpenApi.test.ts +1 -1
  405. package/src/env.d.ts +1 -1
  406. package/src/evm/PublicInterface.test-d.ts +1 -1
  407. package/src/evm/client/index.ts +1 -0
  408. package/src/evm/index.ts +2 -0
  409. package/src/evm/server/Charge.test.ts +1 -1
  410. package/src/evm/server/index.ts +1 -0
  411. package/src/index.ts +1 -0
  412. package/src/internal/AcceptPayment.test.ts +61 -0
  413. package/src/internal/AcceptPayment.ts +21 -14
  414. package/src/{mcp-sdk → mcp}/client/McpClient.integration.test.ts +18 -11
  415. package/src/{mcp-sdk → mcp}/client/McpClient.test-d.ts +45 -11
  416. package/src/{mcp-sdk → mcp}/client/McpClient.test.ts +211 -5
  417. package/src/mcp/client/McpClient.ts +307 -0
  418. package/src/mcp/client/McpClient.unit.test.ts +135 -0
  419. package/src/middlewares/elysia.test.ts +9 -5
  420. package/src/middlewares/express.test.ts +9 -5
  421. package/src/middlewares/hono.test.ts +5 -5
  422. package/src/middlewares/internal/mppx.test.ts +1 -1
  423. package/src/middlewares/nextjs.test.ts +9 -5
  424. package/src/proxy/Proxy.test.ts +9 -9
  425. package/src/proxy/services/anthropic.test.ts +1 -1
  426. package/src/proxy/services/openai.test.ts +1 -1
  427. package/src/proxy/services/stripe.test.ts +1 -1
  428. package/src/server/Mppx.authorize.test.ts +1 -1
  429. package/src/server/Mppx.test-d.ts +55 -1
  430. package/src/server/Mppx.test.ts +220 -9
  431. package/src/server/Mppx.ts +501 -407
  432. package/src/server/Response.ts +2 -1
  433. package/src/server/Transport.test.ts +6 -6
  434. package/src/server/Transport.ts +5 -4
  435. package/src/server/index.ts +1 -0
  436. package/src/stripe/Charge.integration.test.ts +1 -1
  437. package/src/stripe/client/Charge.test.ts +21 -6
  438. package/src/stripe/client/Charge.ts +6 -2
  439. package/src/stripe/server/Charge.test.ts +115 -2
  440. package/src/stripe/server/Charge.ts +13 -2
  441. package/src/stripe/server/internal/html/package.json +1 -1
  442. package/src/stripe/server/internal/html.gen.ts +1 -1
  443. package/src/tempo/AccessKeyAuthorization.test.ts +4 -94
  444. package/src/tempo/Methods.test.ts +45 -17
  445. package/src/tempo/Methods.ts +22 -0
  446. package/src/tempo/Proof.conformance.test.ts +146 -0
  447. package/src/tempo/Proof.test-d.ts +15 -0
  448. package/src/tempo/Proof.ts +52 -1
  449. package/src/tempo/PublicExports.test-d.ts +105 -0
  450. package/src/tempo/Subscription.integration.test.ts +1 -1
  451. package/src/tempo/client/Charge.test.ts +258 -0
  452. package/src/tempo/client/Charge.ts +84 -38
  453. package/src/tempo/client/Methods.ts +22 -8
  454. package/src/tempo/client/ResolveAccount.ts +46 -0
  455. package/src/tempo/client/index.ts +15 -4
  456. package/src/tempo/index.ts +1 -0
  457. package/src/tempo/internal/fee-payer.test.ts +296 -17
  458. package/src/tempo/internal/fee-payer.ts +186 -4
  459. package/src/tempo/internal/fee-token.test.ts +14 -9
  460. package/src/tempo/internal/proof.test.ts +12 -4
  461. package/src/tempo/internal/proof.ts +55 -6
  462. package/src/tempo/legacy/AccessKeyAuthorization.test.ts +162 -0
  463. package/src/tempo/legacy/README.md +9 -0
  464. package/src/tempo/{client → legacy/client}/ChannelOps.test.ts +6 -7
  465. package/src/tempo/{client → legacy/client}/ChannelOps.ts +22 -9
  466. package/src/tempo/{client → legacy/client}/Session.test.ts +51 -9
  467. package/src/tempo/{client → legacy/client}/Session.ts +25 -11
  468. package/src/tempo/{client → legacy/client}/SessionManager.test.ts +81 -9
  469. package/src/tempo/{client → legacy/client}/SessionManager.ts +52 -23
  470. package/src/tempo/legacy/client/index.ts +6 -0
  471. package/src/tempo/legacy/index.ts +6 -0
  472. package/src/tempo/{server → legacy/server}/Session.test.ts +136 -71
  473. package/src/tempo/{server → legacy/server}/Session.ts +32 -23
  474. package/src/tempo/legacy/server/index.ts +4 -0
  475. package/src/tempo/{session → legacy/session}/Chain.test.ts +3 -4
  476. package/src/tempo/{session → legacy/session}/Chain.ts +94 -63
  477. package/src/tempo/{session → legacy/session}/Channel.ts +1 -0
  478. package/src/tempo/legacy/session/ChannelStore.test.ts +58 -0
  479. package/src/tempo/legacy/session/ChannelStore.ts +39 -0
  480. package/src/tempo/legacy/session/Types.ts +91 -0
  481. package/src/tempo/{session → legacy/session}/Voucher.ts +12 -8
  482. package/src/tempo/{session → legacy/session}/escrow.abi.ts +1 -0
  483. package/src/tempo/legacy/session/index.ts +8 -0
  484. package/src/tempo/server/AtomicStore.test-d.ts +16 -11
  485. package/src/tempo/server/Charge.test.ts +480 -31
  486. package/src/tempo/server/Charge.ts +54 -30
  487. package/src/tempo/server/Methods.ts +58 -10
  488. package/src/tempo/server/Sse.test.ts +2 -2
  489. package/src/tempo/server/Subscription.test.ts +465 -3
  490. package/src/tempo/server/Subscription.ts +174 -19
  491. package/src/tempo/server/index.ts +6 -5
  492. package/src/tempo/server/internal/html/package.json +2 -2
  493. package/src/tempo/server/internal/html.gen.ts +1 -1
  494. package/src/tempo/server/internal/request-body.test.ts +37 -4
  495. package/src/tempo/server/internal/request-body.ts +25 -6
  496. package/src/tempo/server/internal/transport.test.ts +4 -4
  497. package/src/tempo/server/internal/transport.ts +19 -10
  498. package/src/tempo/session/Snapshot.test.ts +41 -0
  499. package/src/tempo/session/Snapshot.ts +74 -0
  500. package/src/tempo/session/client/ChannelOps.test.ts +163 -0
  501. package/src/tempo/session/client/ChannelOps.ts +330 -0
  502. package/src/tempo/session/client/ChannelStore.ts +111 -0
  503. package/src/tempo/session/client/CredentialState.test.ts +789 -0
  504. package/src/tempo/session/client/CredentialState.ts +799 -0
  505. package/src/tempo/session/client/ReceiptCoordinator.ts +95 -0
  506. package/src/tempo/session/client/Runtime.test.ts +1092 -0
  507. package/src/tempo/session/client/Runtime.ts +986 -0
  508. package/src/tempo/session/client/Session.test.ts +774 -0
  509. package/src/tempo/session/client/Session.ts +123 -0
  510. package/src/tempo/session/client/SessionManager.test.ts +1397 -0
  511. package/src/tempo/session/client/SessionManager.ts +751 -0
  512. package/src/tempo/session/client/Transports.test.ts +837 -0
  513. package/src/tempo/session/client/Transports.ts +1292 -0
  514. package/src/tempo/session/client/index.ts +40 -0
  515. package/src/tempo/session/index.ts +7 -8
  516. package/src/tempo/session/precompile/Chain.integration.test.ts +321 -0
  517. package/src/tempo/session/precompile/Chain.test.ts +1258 -0
  518. package/src/tempo/session/precompile/Chain.ts +979 -0
  519. package/src/tempo/session/precompile/Channel.test.ts +138 -0
  520. package/src/tempo/session/precompile/Channel.ts +103 -0
  521. package/src/tempo/session/precompile/Protocol.test.ts +358 -0
  522. package/src/tempo/session/precompile/Protocol.ts +520 -0
  523. package/src/tempo/session/precompile/Voucher.test.ts +354 -0
  524. package/src/tempo/session/precompile/Voucher.ts +162 -0
  525. package/src/tempo/session/precompile/escrow.abi.ts +226 -0
  526. package/src/tempo/session/precompile/index.ts +33 -0
  527. package/src/tempo/session/server/ChannelOps.test.ts +129 -0
  528. package/src/tempo/session/server/ChannelOps.ts +157 -0
  529. package/src/tempo/session/{ChannelStore.test.ts → server/ChannelStore.test.ts} +536 -29
  530. package/src/tempo/session/server/ChannelStore.ts +835 -0
  531. package/src/tempo/session/server/CredentialVerification.test.ts +146 -0
  532. package/src/tempo/session/server/CredentialVerification.ts +710 -0
  533. package/src/tempo/session/server/MeteredStream.ts +88 -0
  534. package/src/tempo/session/server/RequestState.test.ts +531 -0
  535. package/src/tempo/session/server/RequestState.ts +499 -0
  536. package/src/tempo/session/server/Session.integration.test.ts +444 -0
  537. package/src/tempo/session/server/Session.test.ts +3253 -0
  538. package/src/tempo/session/server/Session.ts +543 -0
  539. package/src/tempo/session/server/Settlement.test.ts +329 -0
  540. package/src/tempo/session/server/Settlement.ts +471 -0
  541. package/src/tempo/session/{Sse.test.ts → server/Sse.test.ts} +37 -3
  542. package/src/tempo/session/server/Sse.ts +254 -0
  543. package/src/tempo/session/server/Transports.test.ts +346 -0
  544. package/src/tempo/session/server/Transports.ts +255 -0
  545. package/src/tempo/session/{Ws.test.ts → server/Ws.test.ts} +4 -4
  546. package/src/tempo/session/server/Ws.ts +380 -0
  547. package/src/tempo/session/server/index.ts +8 -0
  548. package/src/tempo/subscription/Store.ts +27 -9
  549. package/src/x402/Exact.e2e.test.ts +1 -1
  550. package/src/x402/PublicInterface.test-d.ts +1 -1
  551. package/src/x402/index.ts +1 -0
  552. package/dist/mcp-sdk/client/McpClient.d.ts +0 -78
  553. package/dist/mcp-sdk/client/McpClient.d.ts.map +0 -1
  554. package/dist/mcp-sdk/client/McpClient.js +0 -105
  555. package/dist/mcp-sdk/client/McpClient.js.map +0 -1
  556. package/dist/mcp-sdk/client/index.d.ts.map +0 -1
  557. package/dist/mcp-sdk/client/index.js.map +0 -1
  558. package/dist/mcp-sdk/server/Transport.d.ts.map +0 -1
  559. package/dist/mcp-sdk/server/Transport.js.map +0 -1
  560. package/dist/mcp-sdk/server/index.d.ts.map +0 -1
  561. package/dist/mcp-sdk/server/index.js.map +0 -1
  562. package/dist/tempo/client/ChannelOps.d.ts.map +0 -1
  563. package/dist/tempo/client/ChannelOps.js.map +0 -1
  564. package/dist/tempo/client/Session.d.ts.map +0 -1
  565. package/dist/tempo/client/Session.js.map +0 -1
  566. package/dist/tempo/client/SessionManager.d.ts.map +0 -1
  567. package/dist/tempo/client/SessionManager.js.map +0 -1
  568. package/dist/tempo/server/Session.d.ts.map +0 -1
  569. package/dist/tempo/server/Session.js.map +0 -1
  570. package/dist/tempo/session/Chain.d.ts.map +0 -1
  571. package/dist/tempo/session/Chain.js.map +0 -1
  572. package/dist/tempo/session/Channel.d.ts.map +0 -1
  573. package/dist/tempo/session/Channel.js.map +0 -1
  574. package/dist/tempo/session/ChannelStore.d.ts +0 -117
  575. package/dist/tempo/session/ChannelStore.d.ts.map +0 -1
  576. package/dist/tempo/session/ChannelStore.js +0 -172
  577. package/dist/tempo/session/ChannelStore.js.map +0 -1
  578. package/dist/tempo/session/Receipt.d.ts +0 -22
  579. package/dist/tempo/session/Receipt.d.ts.map +0 -1
  580. package/dist/tempo/session/Receipt.js +0 -34
  581. package/dist/tempo/session/Receipt.js.map +0 -1
  582. package/dist/tempo/session/Sse.d.ts.map +0 -1
  583. package/dist/tempo/session/Sse.js +0 -363
  584. package/dist/tempo/session/Sse.js.map +0 -1
  585. package/dist/tempo/session/Types.d.ts +0 -78
  586. package/dist/tempo/session/Types.d.ts.map +0 -1
  587. package/dist/tempo/session/Types.js.map +0 -1
  588. package/dist/tempo/session/Voucher.d.ts.map +0 -1
  589. package/dist/tempo/session/Voucher.js.map +0 -1
  590. package/dist/tempo/session/Ws.d.ts +0 -87
  591. package/dist/tempo/session/Ws.d.ts.map +0 -1
  592. package/dist/tempo/session/Ws.js +0 -443
  593. package/dist/tempo/session/Ws.js.map +0 -1
  594. package/dist/tempo/session/escrow.abi.js.map +0 -1
  595. package/src/mcp-sdk/client/McpClient.ts +0 -196
  596. package/src/tempo/session/ChannelStore.ts +0 -308
  597. package/src/tempo/session/Receipt.test.ts +0 -89
  598. package/src/tempo/session/Receipt.ts +0 -46
  599. package/src/tempo/session/Sse.ts +0 -462
  600. package/src/tempo/session/Types.ts +0 -86
  601. package/src/tempo/session/Ws.ts +0 -576
  602. /package/dist/{mcp-sdk → mcp}/client/index.d.ts +0 -0
  603. /package/dist/{mcp-sdk → mcp}/client/index.js +0 -0
  604. /package/dist/{mcp-sdk → mcp}/server/Transport.d.ts +0 -0
  605. /package/dist/{mcp-sdk → mcp}/server/Transport.js +0 -0
  606. /package/dist/{mcp-sdk → mcp}/server/index.d.ts +0 -0
  607. /package/dist/{mcp-sdk → mcp}/server/index.js +0 -0
  608. /package/dist/tempo/{session → legacy/session}/Channel.js +0 -0
  609. /package/dist/tempo/{session → legacy/session}/Types.js +0 -0
  610. /package/src/{mcp-sdk → mcp}/client/index.ts +0 -0
  611. /package/src/{mcp-sdk → mcp}/server/Transport.test.ts +0 -0
  612. /package/src/{mcp-sdk → mcp}/server/Transport.ts +0 -0
  613. /package/src/{mcp-sdk → mcp}/server/index.ts +0 -0
  614. /package/src/tempo/{session → legacy/session}/Channel.test.ts +0 -0
  615. /package/src/tempo/{session → legacy/session}/Voucher.test.ts +0 -0
  616. /package/src/tempo/session/{Sse.fuzz.test.ts → server/Sse.fuzz.test.ts} +0 -0
@@ -0,0 +1,789 @@
1
+ import { createClient, custom, type Address, type Client, type Hex } from 'viem'
2
+ import { privateKeyToAccount } from 'viem/accounts'
3
+ import { describe, expect, test } from 'vp/test'
4
+
5
+ import * as Challenge from '../../../Challenge.js'
6
+ import * as Constants from '../../../Constants.js'
7
+ import type * as z from '../../../zod.js'
8
+ import * as Channel from '../precompile/Channel.js'
9
+ import { tip20ChannelEscrow, type SessionCredentialPayload } from '../precompile/Protocol.js'
10
+ import type { SessionSnapshot } from '../Snapshot.js'
11
+ import type { ChannelEntry } from './ChannelOps.js'
12
+ import {
13
+ channelKey,
14
+ createChannelStore,
15
+ createJsonChannelStore,
16
+ deserializeEntry,
17
+ entryKey,
18
+ serializeEntry,
19
+ type ChannelSink,
20
+ } from './ChannelStore.js'
21
+ import {
22
+ canSignDescriptor,
23
+ executeCredentialPlan,
24
+ hasCredentialCumulativeAmount,
25
+ hasManualSessionDescriptor,
26
+ hasSessionAction,
27
+ hasSessionDescriptor,
28
+ parseOptionalContextAmount,
29
+ planCredential,
30
+ readCredentialCumulativeAmount,
31
+ requireContextAmount,
32
+ resolveChallengeContext,
33
+ resolveRecoveredCumulative,
34
+ resolveRecoverContext,
35
+ resolveReusableChannel,
36
+ sessionContextSchema,
37
+ type ChallengeContext,
38
+ type SessionContext,
39
+ } from './CredentialState.js'
40
+
41
+ /** Builds a credential sink backed by a fresh in-memory store. */
42
+ function sink(): ChannelSink {
43
+ return { store: createChannelStore(), notifyUpdate: () => {} }
44
+ }
45
+
46
+ describe('ChannelCache', () => {
47
+ const channelId = `0x${'11'.repeat(32)}` as Hex
48
+
49
+ function channel(overrides: Partial<ChannelEntry> = {}): ChannelEntry {
50
+ return {
51
+ channelId,
52
+ cumulativeAmount: 10n,
53
+ deposit: 20n,
54
+ descriptor: {
55
+ payer: '0x0000000000000000000000000000000000000001',
56
+ payee: '0x0000000000000000000000000000000000000002',
57
+ operator: '0x0000000000000000000000000000000000000000',
58
+ token: '0x20c0000000000000000000000000000000000001',
59
+ salt: `0x${'22'.repeat(32)}`,
60
+ authorizedSigner: '0x0000000000000000000000000000000000000001',
61
+ expiringNonceHash: `0x${'33'.repeat(32)}`,
62
+ },
63
+ escrow: '0x4D50500000000000000000000000000000000000',
64
+ chainId: 4217,
65
+ opened: true,
66
+ ...overrides,
67
+ }
68
+ }
69
+
70
+ function voucher(cumulativeAmount: string): SessionCredentialPayload {
71
+ return {
72
+ action: 'voucher',
73
+ channelId,
74
+ descriptor: channel().descriptor,
75
+ cumulativeAmount,
76
+ signature: '0x1234',
77
+ }
78
+ }
79
+
80
+ function topUp(additionalDeposit: string): SessionCredentialPayload {
81
+ return {
82
+ action: 'topUp',
83
+ type: 'transaction',
84
+ channelId,
85
+ descriptor: channel().descriptor,
86
+ transaction: '0x1234',
87
+ additionalDeposit,
88
+ }
89
+ }
90
+
91
+ describe('precompile client ChannelStore', () => {
92
+ test('creates stable case-insensitive reusable channel keys scoped by chain', () => {
93
+ expect(
94
+ channelKey({
95
+ payee: '0x00000000000000000000000000000000000000AA' as Address,
96
+ token: '0x20C0000000000000000000000000000000000001' as Address,
97
+ escrow: '0x4D50500000000000000000000000000000000000' as Address,
98
+ chainId: 4217,
99
+ }),
100
+ ).toBe(
101
+ '0x00000000000000000000000000000000000000aa:0x20c0000000000000000000000000000000000001:0x4d50500000000000000000000000000000000000:4217',
102
+ )
103
+ })
104
+
105
+ test('derives a stored entry key from its descriptor, escrow, and chain', () => {
106
+ const entry = channel()
107
+ expect(entryKey(entry)).toBe(
108
+ channelKey({
109
+ payee: entry.descriptor.payee,
110
+ token: entry.descriptor.token,
111
+ escrow: entry.escrow,
112
+ chainId: entry.chainId,
113
+ }),
114
+ )
115
+ })
116
+
117
+ test('stores, gets, and deletes entries by derived key', () => {
118
+ const store = createChannelStore()
119
+ const entry = channel()
120
+ store.set(entry)
121
+
122
+ expect(store.get(entryKey(entry))).toBe(entry)
123
+
124
+ store.delete(entryKey(entry))
125
+ expect(store.get(entryKey(entry))).toBeUndefined()
126
+ })
127
+
128
+ test('replaces entries that share a scope key', () => {
129
+ const store = createChannelStore()
130
+ const first = channel({ cumulativeAmount: 10n })
131
+ const second = channel({ cumulativeAmount: 12n })
132
+ store.set(first)
133
+ store.set(second)
134
+
135
+ expect(store.get(entryKey(second))).toBe(second)
136
+ })
137
+
138
+ test('reads cumulative amounts only from cumulative credential payloads', () => {
139
+ expect(hasCredentialCumulativeAmount(voucher('12'))).toBe(true)
140
+ expect(readCredentialCumulativeAmount(voucher('12'))).toBe(12n)
141
+ expect(hasCredentialCumulativeAmount(topUp('12'))).toBe(false)
142
+ expect(readCredentialCumulativeAmount(topUp('12'))).toBeUndefined()
143
+ })
144
+ })
145
+
146
+ describe('serialization', () => {
147
+ test('serializes bigint amounts to decimal strings', () => {
148
+ const entry = channel({ cumulativeAmount: 2n ** 70n, deposit: 0n })
149
+ const stored = serializeEntry(entry)
150
+ expect(stored.cumulativeAmount).toBe((2n ** 70n).toString())
151
+ expect(stored.deposit).toBe('0')
152
+ })
153
+
154
+ test('round-trips a channel entry through JSON', () => {
155
+ const entry = channel({ cumulativeAmount: 2n ** 100n + 7n, deposit: 999n })
156
+ const roundtrip = deserializeEntry(
157
+ JSON.parse(JSON.stringify(serializeEntry(entry))) as ReturnType<typeof serializeEntry>,
158
+ )
159
+ expect(roundtrip).toEqual(entry)
160
+ })
161
+ })
162
+
163
+ describe('createJsonChannelStore', () => {
164
+ function jsonStore() {
165
+ const backend = new Map<string, string>()
166
+ const store = createJsonChannelStore({
167
+ get: (key) => backend.get(key),
168
+ set: (key, value) => {
169
+ backend.set(key, value)
170
+ },
171
+ delete: (key) => {
172
+ backend.delete(key)
173
+ },
174
+ })
175
+ return { backend, store }
176
+ }
177
+
178
+ test('persists, gets, and deletes via a string KV backend', async () => {
179
+ const { backend, store } = jsonStore()
180
+ const entry = channel({ cumulativeAmount: 2n ** 64n, deposit: 5n })
181
+ await store.set(entry)
182
+
183
+ expect(backend.size).toBe(1)
184
+ expect(await store.get(entryKey(entry))).toEqual(entry)
185
+
186
+ await store.delete(entryKey(entry))
187
+ expect(await store.get(entryKey(entry))).toBeUndefined()
188
+ })
189
+ })
190
+ })
191
+
192
+ describe('Context', () => {
193
+ const descriptor = {
194
+ payer: '0x0000000000000000000000000000000000000001' as Address,
195
+ payee: '0x0000000000000000000000000000000000000002' as Address,
196
+ operator: '0x0000000000000000000000000000000000000000' as Address,
197
+ token: '0x0000000000000000000000000000000000000003' as Address,
198
+ salt: `0x${'11'.repeat(32)}` as const,
199
+ authorizedSigner: '0x0000000000000000000000000000000000000001' as Address,
200
+ expiringNonceHash: `0x${'22'.repeat(32)}` as const,
201
+ }
202
+
203
+ describe('precompile session client context helpers', () => {
204
+ test('keeps runtime schema aligned with documented context type', () => {
205
+ type SchemaContext = z.infer<typeof sessionContextSchema>
206
+ expectTypeOf<SchemaContext>().toEqualTypeOf<SessionContext>()
207
+ })
208
+
209
+ test('narrows manual action context', () => {
210
+ expect(hasSessionAction({ action: 'voucher' })).toBe(true)
211
+ expect(hasSessionAction({})).toBe(false)
212
+ expect(hasSessionAction(undefined)).toBe(false)
213
+ })
214
+
215
+ test('narrows descriptor recovery context', () => {
216
+ expect(hasSessionDescriptor({ descriptor })).toBe(true)
217
+ expect(hasSessionDescriptor({})).toBe(false)
218
+ expect(hasSessionDescriptor(undefined)).toBe(false)
219
+ })
220
+
221
+ test('narrows manual action context with descriptor', () => {
222
+ expect(hasManualSessionDescriptor({ action: 'voucher', descriptor })).toBe(true)
223
+ expect(hasManualSessionDescriptor({ action: 'voucher' })).toBe(false)
224
+ expect(hasManualSessionDescriptor({ descriptor })).toBe(false)
225
+ })
226
+
227
+ test('prefers raw amount fields over human-readable amount fields', () => {
228
+ expect(
229
+ parseOptionalContextAmount(
230
+ {
231
+ cumulativeAmount: '100',
232
+ cumulativeAmountRaw: '42',
233
+ },
234
+ 6,
235
+ 'cumulativeAmount',
236
+ ),
237
+ ).toBe(42n)
238
+ })
239
+
240
+ test('parses human-readable amount fields with caller decimals', () => {
241
+ expect(parseOptionalContextAmount({ additionalDeposit: '1.5' }, 6, 'additionalDeposit')).toBe(
242
+ 1_500_000n,
243
+ )
244
+ })
245
+
246
+ test('returns undefined for absent optional amounts', () => {
247
+ expect(parseOptionalContextAmount({}, 6, 'cumulativeAmount')).toBeUndefined()
248
+ })
249
+
250
+ test('throws action-specific errors for absent required amounts', () => {
251
+ expect(() => requireContextAmount({}, 6, 'cumulativeAmount', 'voucher')).toThrow(
252
+ 'cumulativeAmount required for voucher action',
253
+ )
254
+ })
255
+ })
256
+ })
257
+
258
+ describe('CredentialPlan', () => {
259
+ const account = privateKeyToAccount(
260
+ '0x1000000000000000000000000000000000000000000000000000000000000000',
261
+ )
262
+ const channelId = `0x${'11'.repeat(32)}` as Hex
263
+ const snapshotChannelId = `0x${'12'.repeat(32)}` as Hex
264
+ const escrow = '0x4D50500000000000000000000000000000000000' as Address
265
+ const payee = '0x0000000000000000000000000000000000000002' as Address
266
+ const token = '0x20c0000000000000000000000000000000000001' as Address
267
+
268
+ const descriptor = {
269
+ payer: account.address,
270
+ payee,
271
+ operator: '0x0000000000000000000000000000000000000000' as Address,
272
+ token,
273
+ salt: `0x${'22'.repeat(32)}` as Hex,
274
+ authorizedSigner: account.address,
275
+ expiringNonceHash: `0x${'33'.repeat(32)}` as Hex,
276
+ }
277
+
278
+ const snapshotDescriptor = {
279
+ ...descriptor,
280
+ salt: `0x${'44'.repeat(32)}` as Hex,
281
+ }
282
+
283
+ const client = createClient({
284
+ transport: custom({
285
+ async request() {
286
+ return null
287
+ },
288
+ }),
289
+ })
290
+
291
+ function challengeContext(overrides: Partial<ChallengeContext> = {}): ChallengeContext {
292
+ return {
293
+ amount: 5n,
294
+ challenge: Challenge.from({
295
+ id: 'challenge-1',
296
+ realm: 'example.test',
297
+ method: 'tempo',
298
+ intent: 'session',
299
+ request: {},
300
+ }),
301
+ chainId: 4217,
302
+ client,
303
+ escrow,
304
+ key: 'payee:token:escrow',
305
+ payee,
306
+ token,
307
+ ...overrides,
308
+ }
309
+ }
310
+
311
+ function channel(overrides: Partial<ChannelEntry> = {}): ChannelEntry {
312
+ return {
313
+ channelId,
314
+ cumulativeAmount: 10n,
315
+ deposit: 20n,
316
+ descriptor,
317
+ escrow,
318
+ chainId: 4217,
319
+ opened: true,
320
+ ...overrides,
321
+ }
322
+ }
323
+
324
+ function snapshot(overrides: Partial<SessionSnapshot> = {}): SessionSnapshot {
325
+ return {
326
+ acceptedCumulative: '10',
327
+ chainId: 42431,
328
+ channelId: snapshotChannelId,
329
+ deposit: '20',
330
+ descriptor: snapshotDescriptor,
331
+ escrow,
332
+ requiredCumulative: '10',
333
+ settled: '0',
334
+ spent: '0',
335
+ ...overrides,
336
+ }
337
+ }
338
+
339
+ function paymentChallenge(
340
+ overrides: Partial<Challenge.Challenge['request']> = {},
341
+ ): Challenge.Challenge {
342
+ return {
343
+ id: 'challenge-1',
344
+ realm: 'test',
345
+ method: 'tempo',
346
+ intent: 'session',
347
+ request: {
348
+ amount: '10',
349
+ currency: token,
350
+ methodDetails: {
351
+ chainId: 42431,
352
+ escrowContract: escrow,
353
+ feePayer: true,
354
+ [Constants.MethodDetailKeys.sessionSnapshot]: snapshot(),
355
+ },
356
+ recipient: payee,
357
+ suggestedDeposit: '100',
358
+ unitType: 'request',
359
+ ...overrides,
360
+ },
361
+ }
362
+ }
363
+
364
+ describe('precompile client CredentialPlan', () => {
365
+ test('resolves typed credential-planning fields from challenge details', async () => {
366
+ const client = { chain: { id: 42431 } } as Client
367
+ const resolved = await resolveChallengeContext({
368
+ challenge: paymentChallenge(),
369
+ getClient: async () => client,
370
+ })
371
+
372
+ expect(resolved).toMatchObject({
373
+ amount: 10n,
374
+ chainId: 42431,
375
+ client,
376
+ escrow,
377
+ feePayer: true,
378
+ payee,
379
+ snapshot: snapshot(),
380
+ suggestedDepositRaw: '100',
381
+ token,
382
+ })
383
+ expect(resolved.key).toBe(
384
+ `${payee.toLowerCase()}:${token.toLowerCase()}:${escrow.toLowerCase()}:42431`,
385
+ )
386
+ })
387
+
388
+ test('uses client chain ID when the challenge omits one', async () => {
389
+ const resolved = await resolveChallengeContext({
390
+ challenge: paymentChallenge({ methodDetails: { escrowContract: escrow } }),
391
+ getClient: async () => ({ chain: { id: 4217 } }) as Client,
392
+ })
393
+
394
+ expect(resolved.chainId).toBe(4217)
395
+ })
396
+
397
+ test('rejects challenges without required payment fields', async () => {
398
+ await expect(
399
+ resolveChallengeContext({
400
+ challenge: paymentChallenge({ recipient: undefined }),
401
+ getClient: async () => ({ chain: { id: 4217 } }) as Client,
402
+ }),
403
+ ).rejects.toThrow('tempo session challenge missing recipient')
404
+
405
+ await expect(
406
+ resolveChallengeContext({
407
+ challenge: paymentChallenge({ currency: 'pathUSD' }),
408
+ getClient: async () => ({ chain: { id: 4217 } }) as Client,
409
+ }),
410
+ ).rejects.toThrow('tempo session challenge missing currency')
411
+ })
412
+
413
+ test('ignores invalid optional escrow hints', async () => {
414
+ const resolved = await resolveChallengeContext({
415
+ challenge: paymentChallenge({
416
+ methodDetails: {
417
+ chainId: 42431,
418
+ escrowContract: 'not-an-address',
419
+ },
420
+ }),
421
+ getClient: async () => ({ chain: { id: 42431 } }) as Client,
422
+ })
423
+
424
+ expect(resolved.escrow).toBe(tip20ChannelEscrow)
425
+ })
426
+
427
+ test('recover context prefers caller descriptor and channel ID over server snapshot', () => {
428
+ expect(
429
+ resolveRecoverContext({
430
+ context: { channelId, descriptor },
431
+ snapshot: snapshot(),
432
+ }),
433
+ ).toMatchObject({
434
+ channelId,
435
+ descriptor,
436
+ })
437
+ })
438
+
439
+ test('recover context can be bootstrapped entirely from server snapshot', () => {
440
+ expect(resolveRecoverContext({ snapshot: snapshot() })).toMatchObject({
441
+ channelId: snapshotChannelId,
442
+ descriptor: snapshotDescriptor,
443
+ })
444
+ })
445
+
446
+ test('recovery cumulative ignores server-advertised unused voucher headroom', () => {
447
+ expect(
448
+ resolveRecoveredCumulative({
449
+ context: { descriptor, channelId },
450
+ decimals: 6,
451
+ requestAmount: 5n,
452
+ settled: 0n,
453
+ snapshot: snapshot({
454
+ acceptedCumulative: '1000000',
455
+ requiredCumulative: '1000000',
456
+ spent: '10',
457
+ }),
458
+ }),
459
+ ).toBe(15n)
460
+ })
461
+
462
+ test('plans manual credentials only when an explicit action includes descriptor', () => {
463
+ const plan = planCredential({
464
+ account,
465
+ entry: undefined,
466
+ context: { action: 'voucher', descriptor, cumulativeAmountRaw: '10' },
467
+ decimals: 6,
468
+ resolved: challengeContext(),
469
+ })
470
+
471
+ expect(plan.type).toBe('manual')
472
+ if (plan.type !== 'manual') throw new Error('expected manual plan')
473
+ expect(plan.context.descriptor).toBe(descriptor)
474
+ })
475
+
476
+ test('rejects manual actions without a descriptor', () => {
477
+ expect(() =>
478
+ planCredential({
479
+ account,
480
+ entry: undefined,
481
+ context: { action: 'voucher', cumulativeAmountRaw: '10' },
482
+ decimals: 6,
483
+ resolved: challengeContext(),
484
+ }),
485
+ ).toThrow('descriptor required for TIP-1034 session action')
486
+ })
487
+
488
+ test('rejects manual descriptors that do not match the active challenge', async () => {
489
+ const plan = planCredential({
490
+ account,
491
+ entry: undefined,
492
+ context: {
493
+ action: 'voucher',
494
+ cumulativeAmountRaw: '10',
495
+ descriptor: {
496
+ ...descriptor,
497
+ payee: '0x0000000000000000000000000000000000000003' as Address,
498
+ },
499
+ },
500
+ decimals: 6,
501
+ resolved: challengeContext(),
502
+ })
503
+
504
+ await expect(executeCredentialPlan(plan, sink())).rejects.toThrow(
505
+ 'context descriptor payee does not match challenge',
506
+ )
507
+ })
508
+
509
+ test('leaves stored scope entry unchanged when a manual credential targets another channel', async () => {
510
+ const entry = channel()
511
+ const originalCumulative = entry.cumulativeAmount
512
+ const notifications: ChannelEntry[] = []
513
+ const store = createChannelStore()
514
+ const manualDescriptor = { ...descriptor, salt: `0x${'55'.repeat(32)}` as Hex }
515
+ await store.set(entry)
516
+
517
+ await executeCredentialPlan(
518
+ planCredential({
519
+ account,
520
+ entry,
521
+ context: {
522
+ action: 'voucher',
523
+ descriptor: manualDescriptor,
524
+ cumulativeAmountRaw: '25',
525
+ },
526
+ decimals: 6,
527
+ resolved: challengeContext(),
528
+ }),
529
+ { store, notifyUpdate: (updated) => notifications.push(updated) },
530
+ )
531
+
532
+ const stored = await store.get(entryKey(entry))
533
+ expect(stored?.channelId).toBe(entry.channelId)
534
+ expect(stored?.cumulativeAmount).toBe(originalCumulative)
535
+ expect(notifications).toEqual([])
536
+ })
537
+
538
+ test('plans recovery from server snapshot when no reusable cache entry exists', () => {
539
+ const plan = planCredential({
540
+ account,
541
+ entry: undefined,
542
+ decimals: 6,
543
+ resolved: challengeContext({ snapshot: snapshot() }),
544
+ })
545
+
546
+ expect(plan.type).toBe('recover')
547
+ if (plan.type !== 'recover') throw new Error('expected recover plan')
548
+ expect(plan.context.channelId).toBe(snapshotChannelId)
549
+ expect(plan.context.descriptor).toBe(snapshotDescriptor)
550
+ })
551
+
552
+ test('plans voucher reuse before snapshot recovery when cache entry is open', () => {
553
+ const entry = channel()
554
+
555
+ const plan = planCredential({
556
+ account,
557
+ entry,
558
+ decimals: 6,
559
+ resolved: challengeContext({ snapshot: snapshot() }),
560
+ })
561
+
562
+ expect(plan).toMatchObject({ type: 'voucher', entry })
563
+ })
564
+
565
+ test('opens fresh instead of vouchering when the account cannot sign the cached entry', () => {
566
+ const entry = channel({
567
+ descriptor: {
568
+ ...descriptor,
569
+ authorizedSigner: '0x00000000000000000000000000000000000000aa' as Address,
570
+ },
571
+ })
572
+
573
+ const plan = planCredential({
574
+ account,
575
+ entry,
576
+ decimals: 6,
577
+ resolved: challengeContext(),
578
+ })
579
+
580
+ expect(plan.type).toBe('open')
581
+ })
582
+
583
+ test('opens fresh instead of recovering when the account cannot sign the snapshot', () => {
584
+ const plan = planCredential({
585
+ account,
586
+ entry: undefined,
587
+ decimals: 6,
588
+ resolved: challengeContext({
589
+ snapshot: snapshot({
590
+ descriptor: {
591
+ ...snapshotDescriptor,
592
+ authorizedSigner: '0x00000000000000000000000000000000000000aa' as Address,
593
+ },
594
+ }),
595
+ }),
596
+ })
597
+
598
+ expect(plan.type).toBe('open')
599
+ })
600
+
601
+ test('vouchers when the account can satisfy the cached voucher authority', () => {
602
+ const delegatedAccount = privateKeyToAccount(
603
+ '0x2000000000000000000000000000000000000000000000000000000000000000',
604
+ )
605
+ const entry = channel({
606
+ descriptor: { ...descriptor, authorizedSigner: delegatedAccount.address },
607
+ })
608
+
609
+ const plan = planCredential({
610
+ account: Object.assign({}, account, { accessKeyAddress: delegatedAccount.address }),
611
+ entry,
612
+ decimals: 6,
613
+ resolved: challengeContext(),
614
+ })
615
+
616
+ expect(plan).toMatchObject({ type: 'voucher', entry })
617
+ })
618
+
619
+ test('canSignDescriptor matches root, zero, and delegated authorities', () => {
620
+ const delegatedAuthority = '0x00000000000000000000000000000000000000aa' as Address
621
+ expect(canSignDescriptor(account, descriptor)).toBe(true)
622
+ expect(
623
+ canSignDescriptor(account, {
624
+ ...descriptor,
625
+ authorizedSigner: '0x0000000000000000000000000000000000000000' as Address,
626
+ }),
627
+ ).toBe(true)
628
+ expect(
629
+ canSignDescriptor(account, { ...descriptor, authorizedSigner: delegatedAuthority }),
630
+ ).toBe(false)
631
+ expect(
632
+ canSignDescriptor(Object.assign({}, account, { accessKeyAddress: delegatedAuthority }), {
633
+ ...descriptor,
634
+ authorizedSigner: delegatedAuthority,
635
+ }),
636
+ ).toBe(true)
637
+ const otherPayer = '0x00000000000000000000000000000000000000bb' as Address
638
+ expect(canSignDescriptor(account, { ...descriptor, payer: otherPayer })).toBe(false)
639
+ expect(
640
+ canSignDescriptor(Object.assign({}, account, { accessKeyAddress: delegatedAuthority }), {
641
+ ...descriptor,
642
+ payer: otherPayer,
643
+ authorizedSigner: delegatedAuthority,
644
+ }),
645
+ ).toBe(false)
646
+ })
647
+
648
+ test('rejects channel ID reuse without descriptor or cache entry', () => {
649
+ expect(() =>
650
+ planCredential({
651
+ account,
652
+ entry: undefined,
653
+ context: { channelId },
654
+ decimals: 6,
655
+ resolved: challengeContext(),
656
+ }),
657
+ ).toThrow('descriptor required to reuse TIP-1034 channel')
658
+ })
659
+
660
+ test('returns descriptor-derived channel ID and reusable on-chain state', async () => {
661
+ const state = { deposit: 1_000n, settled: 250n, closeRequestedAt: 0 }
662
+ const reusableChannelId = Channel.computeId({ ...descriptor, chainId: 42431, escrow })
663
+
664
+ await expect(
665
+ resolveReusableChannel({
666
+ channelId: reusableChannelId,
667
+ client,
668
+ descriptor,
669
+ expected: {
670
+ chainId: 42431,
671
+ escrow,
672
+ payee,
673
+ payer: account.address,
674
+ authorizedSigner: account.address,
675
+ token,
676
+ },
677
+ readChannelState: async () => state,
678
+ }),
679
+ ).resolves.toEqual({ channelId: reusableChannelId, state })
680
+ })
681
+
682
+ test('rejects reusable channel descriptor mismatches before reading chain state', async () => {
683
+ const cases = [
684
+ {
685
+ name: 'channel ID',
686
+ parameters: { channelId: `0x${'ff'.repeat(32)}` },
687
+ message: 'context channelId does not match descriptor',
688
+ },
689
+ {
690
+ name: 'payee',
691
+ parameters: {
692
+ descriptor: {
693
+ ...descriptor,
694
+ payee: '0x0000000000000000000000000000000000000003' as Address,
695
+ },
696
+ },
697
+ message: 'context descriptor payee does not match challenge',
698
+ },
699
+ {
700
+ name: 'token',
701
+ parameters: {
702
+ descriptor: {
703
+ ...descriptor,
704
+ token: '0x0000000000000000000000000000000000000004' as Address,
705
+ },
706
+ },
707
+ message: 'context descriptor token does not match challenge',
708
+ },
709
+ {
710
+ name: 'payer',
711
+ parameters: {
712
+ descriptor: {
713
+ ...descriptor,
714
+ payer: '0x0000000000000000000000000000000000000005' as Address,
715
+ },
716
+ },
717
+ message: 'context descriptor payer does not match account',
718
+ },
719
+ {
720
+ name: 'authorizedSigner',
721
+ parameters: {
722
+ descriptor: {
723
+ ...descriptor,
724
+ authorizedSigner: '0x0000000000000000000000000000000000000006' as Address,
725
+ },
726
+ },
727
+ message: 'context descriptor authorizedSigner does not match account',
728
+ },
729
+ ] as const
730
+
731
+ for (const item of cases) {
732
+ let reads = 0
733
+ await expect(
734
+ resolveReusableChannel({
735
+ client,
736
+ descriptor,
737
+ expected: {
738
+ chainId: 42431,
739
+ escrow,
740
+ payee,
741
+ payer: account.address,
742
+ authorizedSigner: account.address,
743
+ token,
744
+ },
745
+ readChannelState: async () => {
746
+ reads += 1
747
+ return { deposit: 1n, settled: 0n, closeRequestedAt: 0 }
748
+ },
749
+ ...item.parameters,
750
+ }),
751
+ ).rejects.toThrow(item.message)
752
+ expect(reads, item.name).toBe(0)
753
+ }
754
+ })
755
+
756
+ test('rejects non-reusable on-chain state', async () => {
757
+ const reusableChannelId = Channel.computeId({ ...descriptor, chainId: 42431, escrow })
758
+ const cases = [
759
+ {
760
+ state: { deposit: 0n, settled: 0n, closeRequestedAt: 0 },
761
+ message: /cannot be reused \(closed or not found on-chain\)/,
762
+ },
763
+ {
764
+ state: { deposit: 1_000n, settled: 0n, closeRequestedAt: 123 },
765
+ message: /cannot be reused \(pending close request\)/,
766
+ },
767
+ ] as const
768
+
769
+ for (const item of cases) {
770
+ await expect(
771
+ resolveReusableChannel({
772
+ channelId: reusableChannelId,
773
+ client,
774
+ descriptor,
775
+ expected: {
776
+ chainId: 42431,
777
+ escrow,
778
+ payee,
779
+ payer: account.address,
780
+ authorizedSigner: account.address,
781
+ token,
782
+ },
783
+ readChannelState: async () => item.state,
784
+ }),
785
+ ).rejects.toThrow(item.message)
786
+ }
787
+ })
788
+ })
789
+ })