tenjin-cli 0.1.0-alpha.33 → 0.1.0-alpha.35
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.
- package/NOTICE.md +110 -0
- package/README.md +87 -81
- package/dist/{_esm-BIN7VY2L.js → _esm-2KST7HQ7.js} +7 -7
- package/dist/alive-5TV22PNF.js +51 -0
- package/dist/auth-XI7BJFLW.js +47 -0
- package/dist/{auto-update-Y24UL56V.js → auto-update-7L24KDWA.js} +4 -5
- package/dist/balance-DFHC6XEU.js +71 -0
- package/dist/{ccip-DHDFKTQV.js → ccip-HOW3DZYF.js} +4 -4
- package/dist/chunk-24XKUN2S.js +202 -0
- package/dist/chunk-24XKUN2S.js.map +1 -0
- package/dist/chunk-2L7TDGLV.js +56 -0
- package/dist/chunk-2L7TDGLV.js.map +1 -0
- package/dist/{chunk-C2Q76BVM.js → chunk-2U7H35IP.js} +29 -7
- package/dist/chunk-2U7H35IP.js.map +1 -0
- package/dist/chunk-2W4DQQUU.js +176 -0
- package/dist/chunk-2W4DQQUU.js.map +1 -0
- package/dist/{chunk-LRW6S53P.js → chunk-34SAECKZ.js} +35 -11
- package/dist/chunk-34SAECKZ.js.map +1 -0
- package/dist/{chunk-2I4QTOLB.js → chunk-3MZ7DYRO.js} +1 -1
- package/dist/chunk-3MZ7DYRO.js.map +1 -0
- package/dist/{chunk-RVPYTUP4.js → chunk-3Y2EHT4F.js} +13 -9
- package/dist/chunk-3Y2EHT4F.js.map +1 -0
- package/dist/chunk-3Y6BHIN6.js +169 -0
- package/dist/chunk-3Y6BHIN6.js.map +1 -0
- package/dist/{chunk-4K7TQHNP.js → chunk-3YPL6T3P.js} +17 -33
- package/dist/chunk-3YPL6T3P.js.map +1 -0
- package/dist/{chunk-E7SW44LM.js → chunk-44MVIRZH.js} +121 -6
- package/dist/chunk-44MVIRZH.js.map +1 -0
- package/dist/chunk-45MMSBHA.js +321 -0
- package/dist/chunk-45MMSBHA.js.map +1 -0
- package/dist/{chunk-3FMZGI7I.js → chunk-4CE6TMI5.js} +1 -1
- package/dist/chunk-4CE6TMI5.js.map +1 -0
- package/dist/{chunk-QXP3Z3JN.js → chunk-4MBCJFY4.js} +35 -3
- package/dist/chunk-4MBCJFY4.js.map +1 -0
- package/dist/chunk-4TPL54KW.js +227 -0
- package/dist/chunk-4TPL54KW.js.map +1 -0
- package/dist/chunk-54ELBTKE.js +1615 -0
- package/dist/chunk-54ELBTKE.js.map +1 -0
- package/dist/{chunk-NDGZDTSJ.js → chunk-5F4OB5B3.js} +115 -57
- package/dist/chunk-5F4OB5B3.js.map +1 -0
- package/dist/chunk-5HN4KVQU.js +3348 -0
- package/dist/chunk-5HN4KVQU.js.map +1 -0
- package/dist/{chunk-ZDZERB6L.js → chunk-5J4E5GYI.js} +572 -407
- package/dist/chunk-5J4E5GYI.js.map +1 -0
- package/dist/{chunk-ZNNXRNFD.js → chunk-5N4GGUBN.js} +48 -6
- package/dist/chunk-5N4GGUBN.js.map +1 -0
- package/dist/chunk-5USBZ2MU.js +58 -0
- package/dist/chunk-5USBZ2MU.js.map +1 -0
- package/dist/chunk-64WOMNYR.js +183 -0
- package/dist/chunk-64WOMNYR.js.map +1 -0
- package/dist/{chunk-ILNIZ5I2.js → chunk-65RS4LQS.js} +1825 -1715
- package/dist/chunk-65RS4LQS.js.map +1 -0
- package/dist/{chunk-IE7P2BZE.js → chunk-6QMDUDF2.js} +3 -3
- package/dist/{chunk-IADZOXKN.js → chunk-7SLOTLO7.js} +19 -697
- package/dist/chunk-7SLOTLO7.js.map +1 -0
- package/dist/{chunk-WFSPCCVW.js → chunk-7V25UAQO.js} +99 -99
- package/dist/{chunk-WFSPCCVW.js.map → chunk-7V25UAQO.js.map} +1 -1
- package/dist/chunk-BGA4DO5M.js +719 -0
- package/dist/chunk-BGA4DO5M.js.map +1 -0
- package/dist/chunk-BVP7YK2J.js +706 -0
- package/dist/chunk-BVP7YK2J.js.map +1 -0
- package/dist/chunk-C265QIMJ.js +83 -0
- package/dist/chunk-C265QIMJ.js.map +1 -0
- package/dist/{chunk-XQJXNMSB.js → chunk-CRG54LEB.js} +1 -1
- package/dist/chunk-CRG54LEB.js.map +1 -0
- package/dist/{chunk-KG3D7FIF.js → chunk-CZJOMUBP.js} +2 -2
- package/dist/{chunk-36RVGZNY.js → chunk-D6M3ZK66.js} +22 -39
- package/dist/chunk-D6M3ZK66.js.map +1 -0
- package/dist/{chunk-3UCIG4TG.js → chunk-DI4QAGRZ.js} +1 -11
- package/dist/chunk-DI4QAGRZ.js.map +1 -0
- package/dist/{chunk-JKKAIPTU.js → chunk-DIH2G3YG.js} +47 -10
- package/dist/chunk-DIH2G3YG.js.map +1 -0
- package/dist/chunk-DJ36BM62.js +78 -0
- package/dist/chunk-DJ36BM62.js.map +1 -0
- package/dist/chunk-DTEWAVNE.js +114 -0
- package/dist/chunk-DTEWAVNE.js.map +1 -0
- package/dist/chunk-F2KJAJ7T.js +13 -0
- package/dist/chunk-F2KJAJ7T.js.map +1 -0
- package/dist/{chunk-BF4XHEQK.js → chunk-F3QPGYOY.js} +6 -6
- package/dist/chunk-F3QPGYOY.js.map +1 -0
- package/dist/{chunk-3GNJXKIT.js → chunk-F43CV6UC.js} +2 -2
- package/dist/{chunk-J57UC3DD.js → chunk-FKVJKLPI.js} +3 -3
- package/dist/{chunk-V2LQLN5H.js → chunk-FYFHH7V5.js} +59 -8
- package/dist/{chunk-V2LQLN5H.js.map → chunk-FYFHH7V5.js.map} +1 -1
- package/dist/chunk-GAJC4BQZ.js +1096 -0
- package/dist/chunk-GAJC4BQZ.js.map +1 -0
- package/dist/{chunk-DOQGNFHM.js → chunk-GH5UKMZD.js} +2 -12
- package/dist/{chunk-DOQGNFHM.js.map → chunk-GH5UKMZD.js.map} +1 -1
- package/dist/{chunk-WYXUQGOL.js → chunk-HAZAN4UM.js} +7 -6
- package/dist/chunk-HAZAN4UM.js.map +1 -0
- package/dist/chunk-HI5XQOX2.js +393 -0
- package/dist/chunk-HI5XQOX2.js.map +1 -0
- package/dist/chunk-HKGUKAQW.js +488 -0
- package/dist/chunk-HKGUKAQW.js.map +1 -0
- package/dist/{chunk-SO3XRZPX.js → chunk-HPRVFJPM.js} +6 -6
- package/dist/{chunk-L6JEXB3E.js → chunk-HQR4BWKX.js} +3 -131
- package/dist/chunk-HQR4BWKX.js.map +1 -0
- package/dist/chunk-HZKANST2.js +177 -0
- package/dist/chunk-HZKANST2.js.map +1 -0
- package/dist/{chunk-UUGOUOVT.js → chunk-I557SAOM.js} +8 -2
- package/dist/chunk-I557SAOM.js.map +1 -0
- package/dist/{chunk-TC2WZLSC.js → chunk-IGLWLH73.js} +8 -7
- package/dist/chunk-IGLWLH73.js.map +1 -0
- package/dist/chunk-ILWCKCOI.js +58 -0
- package/dist/chunk-ILWCKCOI.js.map +1 -0
- package/dist/{chunk-2GP3HRYK.js → chunk-INSIW65E.js} +182 -182
- package/dist/{chunk-MPZUYCAP.js → chunk-IULCDMVG.js} +12 -1
- package/dist/chunk-IULCDMVG.js.map +1 -0
- package/dist/{chunk-INTFHMU4.js → chunk-IVNSUAVC.js} +25 -26
- package/dist/chunk-IVNSUAVC.js.map +1 -0
- package/dist/chunk-JDQZCREI.js +87 -0
- package/dist/chunk-JDQZCREI.js.map +1 -0
- package/dist/chunk-JHFFUVON.js +1050 -0
- package/dist/chunk-JHFFUVON.js.map +1 -0
- package/dist/{chunk-RL5UUDT4.js → chunk-JNUKLSMZ.js} +3 -3
- package/dist/chunk-JTILUN4W.js +2933 -0
- package/dist/chunk-JTILUN4W.js.map +1 -0
- package/dist/{chunk-OJNTCYQQ.js → chunk-JTX3BUDK.js} +37 -53
- package/dist/chunk-JTX3BUDK.js.map +1 -0
- package/dist/{chunk-X5ZBP3IY.js → chunk-JUUBBBY5.js} +2 -2
- package/dist/chunk-JUUBBBY5.js.map +1 -0
- package/dist/chunk-JWAK7JQB.js +15 -0
- package/dist/chunk-JWAK7JQB.js.map +1 -0
- package/dist/{chunk-UXZONNEQ.js → chunk-K5KNGC4I.js} +34 -31
- package/dist/chunk-K5KNGC4I.js.map +1 -0
- package/dist/chunk-KAQ4Q3TO.js +135 -0
- package/dist/chunk-KAQ4Q3TO.js.map +1 -0
- package/dist/chunk-KFVJYLVL.js +125 -0
- package/dist/chunk-KFVJYLVL.js.map +1 -0
- package/dist/chunk-KGUE5AVX.js +69 -0
- package/dist/chunk-KGUE5AVX.js.map +1 -0
- package/dist/{chunk-FVIGCDSV.js → chunk-KLDMLWXT.js} +11 -85
- package/dist/chunk-KLDMLWXT.js.map +1 -0
- package/dist/chunk-KNKDMTHU.js +453 -0
- package/dist/chunk-KNKDMTHU.js.map +1 -0
- package/dist/chunk-LDA6TAYQ.js +95 -0
- package/dist/chunk-LDA6TAYQ.js.map +1 -0
- package/dist/chunk-LWSSIZOY.js +347 -0
- package/dist/chunk-LWSSIZOY.js.map +1 -0
- package/dist/{chunk-ZURZHELF.js → chunk-MAHNZA6C.js} +158 -41
- package/dist/chunk-MAHNZA6C.js.map +1 -0
- package/dist/chunk-MEWZCIA6.js +220 -0
- package/dist/chunk-MEWZCIA6.js.map +1 -0
- package/dist/{chunk-2SNUOHAT.js → chunk-MEZJ3I63.js} +49 -1
- package/dist/chunk-MEZJ3I63.js.map +1 -0
- package/dist/chunk-MJDO4EXD.js +353 -0
- package/dist/chunk-MJDO4EXD.js.map +1 -0
- package/dist/chunk-NJA6NT3A.js +6595 -0
- package/dist/chunk-NJA6NT3A.js.map +1 -0
- package/dist/{chunk-LHHMV4GU.js → chunk-NVSKJPRC.js} +1 -1
- package/dist/{chunk-LHHMV4GU.js.map → chunk-NVSKJPRC.js.map} +1 -1
- package/dist/{chunk-4YOZGGTZ.js → chunk-OC7K2DVZ.js} +5 -5
- package/dist/chunk-OC7K2DVZ.js.map +1 -0
- package/dist/chunk-ODRPASFP.js +2078 -0
- package/dist/chunk-ODRPASFP.js.map +1 -0
- package/dist/chunk-OJJFANO6.js +133 -0
- package/dist/chunk-OJJFANO6.js.map +1 -0
- package/dist/{chunk-JNJWBTU2.js → chunk-OQWPRFAC.js} +332 -882
- package/dist/chunk-OQWPRFAC.js.map +1 -0
- package/dist/chunk-P4I7BFNJ.js +11 -0
- package/dist/chunk-P4I7BFNJ.js.map +1 -0
- package/dist/{chunk-SNNSAGMT.js → chunk-P6YQWIT2.js} +4058 -4039
- package/dist/chunk-P6YQWIT2.js.map +1 -0
- package/dist/{chunk-JRGFKVAZ.js → chunk-PETQ5WEA.js} +2 -2
- package/dist/{chunk-HMWYAUA6.js → chunk-Q6RSJCXB.js} +29 -69
- package/dist/chunk-Q6RSJCXB.js.map +1 -0
- package/dist/{chunk-U3IKUGRP.js → chunk-QKEUKBRK.js} +17 -23
- package/dist/chunk-QKEUKBRK.js.map +1 -0
- package/dist/{chunk-2RWB7RKE.js → chunk-QKYUCITR.js} +174 -5814
- package/dist/chunk-QKYUCITR.js.map +1 -0
- package/dist/chunk-QQDPRTLP.js +127 -0
- package/dist/chunk-QQDPRTLP.js.map +1 -0
- package/dist/chunk-QQYCYAKI.js +79 -0
- package/dist/chunk-QQYCYAKI.js.map +1 -0
- package/dist/chunk-R4KDH477.js +1064 -0
- package/dist/chunk-R4KDH477.js.map +1 -0
- package/dist/chunk-R5TR2DIK.js +119 -0
- package/dist/chunk-R5TR2DIK.js.map +1 -0
- package/dist/chunk-R62PKTAG.js +66 -0
- package/dist/chunk-R62PKTAG.js.map +1 -0
- package/dist/{chunk-BFDQ4WNW.js → chunk-RFZA7PSM.js} +4 -5
- package/dist/chunk-RFZA7PSM.js.map +1 -0
- package/dist/chunk-RGCPELQN.js +219 -0
- package/dist/chunk-RGCPELQN.js.map +1 -0
- package/dist/chunk-RGVCOG2S.js +910 -0
- package/dist/chunk-RGVCOG2S.js.map +1 -0
- package/dist/chunk-SOLNJ3AZ.js +209 -0
- package/dist/chunk-SOLNJ3AZ.js.map +1 -0
- package/dist/chunk-TFT2X7SH.js +77 -0
- package/dist/chunk-TFT2X7SH.js.map +1 -0
- package/dist/chunk-TUCKEEXE.js +2 -0
- package/dist/chunk-TVWCLUBI.js +293 -0
- package/dist/chunk-TVWCLUBI.js.map +1 -0
- package/dist/chunk-U4TRWSVE.js +78 -0
- package/dist/chunk-U4TRWSVE.js.map +1 -0
- package/dist/chunk-UIB33QQP.js +379 -0
- package/dist/chunk-UIB33QQP.js.map +1 -0
- package/dist/chunk-V6GIVALQ.js +1889 -0
- package/dist/chunk-V6GIVALQ.js.map +1 -0
- package/dist/chunk-VHXCPXUS.js +366 -0
- package/dist/chunk-VHXCPXUS.js.map +1 -0
- package/dist/{chunk-HGZEPQUT.js → chunk-VU6GMWF6.js} +17 -8
- package/dist/chunk-VU6GMWF6.js.map +1 -0
- package/dist/chunk-VWZYE3NC.js +8415 -0
- package/dist/chunk-VWZYE3NC.js.map +1 -0
- package/dist/{chunk-AGMVASXZ.js → chunk-W2GXIARJ.js} +88 -11
- package/dist/chunk-W2GXIARJ.js.map +1 -0
- package/dist/chunk-W4G3K3V7.js +288 -0
- package/dist/chunk-W4G3K3V7.js.map +1 -0
- package/dist/chunk-W74LJ5OT.js +588 -0
- package/dist/chunk-W74LJ5OT.js.map +1 -0
- package/dist/chunk-W7ELYLYK.js +233 -0
- package/dist/chunk-W7ELYLYK.js.map +1 -0
- package/dist/{chunk-BPMWXTFX.js → chunk-WFZX352D.js} +7 -7
- package/dist/chunk-WXA3WTPF.js +20 -0
- package/dist/chunk-WXA3WTPF.js.map +1 -0
- package/dist/chunk-XRGFH7FI.js +454 -0
- package/dist/chunk-XRGFH7FI.js.map +1 -0
- package/dist/chunk-XSCGUO2U.js +330 -0
- package/dist/chunk-XSCGUO2U.js.map +1 -0
- package/dist/chunk-XWROSMI5.js +1039 -0
- package/dist/chunk-XWROSMI5.js.map +1 -0
- package/dist/chunk-Y2EXZ47H.js +40 -0
- package/dist/chunk-Y2EXZ47H.js.map +1 -0
- package/dist/chunk-YJGEVBKZ.js +47 -0
- package/dist/chunk-YJGEVBKZ.js.map +1 -0
- package/dist/{chunk-6CMM6YCB.js → chunk-YWWMISDY.js} +2 -2
- package/dist/{chunk-WXA2BWTE.js → chunk-ZCT5DJ3G.js} +2 -48
- package/dist/chunk-ZCT5DJ3G.js.map +1 -0
- package/dist/chunk-ZEYA2WWX.js +982 -0
- package/dist/chunk-ZEYA2WWX.js.map +1 -0
- package/dist/chunk-ZRC7Z5X3.js +82 -0
- package/dist/chunk-ZRC7Z5X3.js.map +1 -0
- package/dist/{chunk-3AIHRXKO.js → chunk-ZS7JIUJ3.js} +12 -10
- package/dist/chunk-ZS7JIUJ3.js.map +1 -0
- package/dist/{clack-EZ7TDWQU.js → clack-Q4RNC5VE.js} +2 -6
- package/dist/{claude-cli-2YKABJJZ.js → claude-cli-GIIHOBGT.js} +4 -2
- package/dist/claude-install-BAUSJMW3.js +64 -0
- package/dist/{cli-E36SPKBW.js → cli-QY4KKA3D.js} +632 -150
- package/dist/cli-QY4KKA3D.js.map +1 -0
- package/dist/client-3YQKORVK.js +710 -0
- package/dist/client-3YQKORVK.js.map +1 -0
- package/dist/{codex-event-ZO2GEFE6.js → codex-event-EUTCAOTQ.js} +3 -5
- package/dist/{codex-host-KECJVTA2.js → codex-host-ZON3S6HU.js} +7 -7
- package/dist/{codex-install-HQZDGFXW.js → codex-install-HZV2DOAB.js} +242 -88
- package/dist/codex-install-HZV2DOAB.js.map +1 -0
- package/dist/config-QZOBMTEL.js +57 -0
- package/dist/config-names-Z5NZD5R2.js +224 -0
- package/dist/config-names-Z5NZD5R2.js.map +1 -0
- package/dist/config-rules-YOYHS6YL.js +55 -0
- package/dist/config-subagents-WQV2ZAD5.js +362 -0
- package/dist/config-subagents-WQV2ZAD5.js.map +1 -0
- package/dist/connect-YDWTYU4B.js +1020 -0
- package/dist/connect-YDWTYU4B.js.map +1 -0
- package/dist/core-0a66n3e7-TTP554XV.js +127 -0
- package/dist/core-0a66n3e7-TTP554XV.js.map +1 -0
- package/dist/core-0bmnpbz2-C2JIRVZO.js +10790 -0
- package/dist/core-0bmnpbz2-C2JIRVZO.js.map +1 -0
- package/dist/core-9je8ee1j-74DGHWPV.js +30 -0
- package/dist/core-9je8ee1j-74DGHWPV.js.map +1 -0
- package/dist/core-wadgcjfh-TSZFQZGH.js +666 -0
- package/dist/core-wadgcjfh-TSZFQZGH.js.map +1 -0
- package/dist/core-zg882d22-LKV5DZYW.js +37 -0
- package/dist/core-zg882d22-LKV5DZYW.js.map +1 -0
- package/dist/decision-QSKHOGCO.js +145 -0
- package/dist/{doctor-I6XQEKWD.js → doctor-ZWJXRD75.js} +162 -148
- package/dist/doctor-ZWJXRD75.js.map +1 -0
- package/dist/{env-proxy-R6ZMLQTT.js → env-proxy-XLSLHBKQ.js} +2 -2
- package/dist/{ethersCompat-Df4a6QIZ-X6YZWAML.js → ethersCompat-Df4a6QIZ-K3DMHR6Y.js} +5 -5
- package/dist/explicit-ME2NRADQ.js +371 -0
- package/dist/explicit-ME2NRADQ.js.map +1 -0
- package/dist/flush-stdio-NYIJ3QXT.js +18 -0
- package/dist/fund-VF7TLDJH.js +722 -0
- package/dist/fund-VF7TLDJH.js.map +1 -0
- package/dist/hook-command-VZ27MGWO.js +49 -0
- package/dist/hosts/claude/.claude-plugin/marketplace.json +2 -2
- package/dist/hosts/claude/tenjin/.claude-plugin/plugin.json +2 -2
- package/dist/hosts/claude/tenjin/hooks/hook-data.ts +152 -0
- package/dist/hosts/claude/tenjin/hooks/hooks.json +7 -0
- package/dist/hosts/claude/tenjin/hooks/model-viewer.tsx +2987 -0
- package/dist/hosts/claude/tenjin/hooks/register.tsx +527 -56
- package/dist/hosts/claude/tenjin/skills/tenjin-pay/SKILL.md +14 -4
- package/dist/hosts/claude/tenjin/types/index.d.ts +144 -1
- package/dist/{hosts-DVQJ32QC.js → hosts-3EMTVM4H.js} +7 -6
- package/dist/index.js +18 -15
- package/dist/index.js.map +1 -1
- package/dist/install-ZA7L2UF3.js +115 -0
- package/dist/install-funding-JDGYTF72.js +30 -0
- package/dist/install-identity-FFAYEFLX.js +30 -0
- package/dist/{install-wallet-5M4OTYLX.js → install-wallet-2SFOVE3Q.js} +68 -53
- package/dist/install-wallet-2SFOVE3Q.js.map +1 -0
- package/dist/mcp-36S6MK3C.js +67642 -0
- package/dist/mcp-36S6MK3C.js.map +1 -0
- package/dist/new-install-5L4GY3LN.js +51 -0
- package/dist/{package-IJFGMWEV.js → package-BONDXSV3.js} +2 -2
- package/dist/{passphrase-IFTDS3CU.js → passphrase-T4ULBN4M.js} +16 -12
- package/dist/{paths-XCSAKISU.js → paths-O2KDWZ76.js} +18 -28
- package/dist/pay-CMV5KL74.js +74 -0
- package/dist/{payments-HFPPWHTV.js → payments-Z6UBZL4Z.js} +36 -26
- package/dist/payments-Z6UBZL4Z.js.map +1 -0
- package/dist/reclaim-subagent-credit-ABSF67SJ.js +105 -0
- package/dist/reclaim-subagent-credit-ABSF67SJ.js.map +1 -0
- package/dist/{redact-D7ASVWKL.js → redact-LOTHE5TS.js} +2 -8
- package/dist/redact-LOTHE5TS.js.map +1 -0
- package/dist/routing-quote-AHLAREXR.js +40 -0
- package/dist/routing-quote-AHLAREXR.js.map +1 -0
- package/dist/run-JH7ELYAM.js +88 -0
- package/dist/run-JH7ELYAM.js.map +1 -0
- package/dist/runtime-2GX4ALJP.js +410 -0
- package/dist/runtime-2GX4ALJP.js.map +1 -0
- package/dist/runtime-activate-IDQ2NCSP.js +39 -0
- package/dist/runtime-activate-IDQ2NCSP.js.map +1 -0
- package/dist/{runtime-fetch-ZSSSK72Y.js → runtime-fetch-6LOBHBEN.js} +4 -4
- package/dist/runtime-fetch-6LOBHBEN.js.map +1 -0
- package/dist/runtime-launchers-YAPKCBHV.js +31 -0
- package/dist/runtime-launchers-YAPKCBHV.js.map +1 -0
- package/dist/{runtime-layout-WIDILZ6K.js → runtime-layout-QHZQJV7C.js} +5 -4
- package/dist/runtime-layout-QHZQJV7C.js.map +1 -0
- package/dist/runtime-place-4POL4KK4.js +37 -0
- package/dist/runtime-place-4POL4KK4.js.map +1 -0
- package/dist/runtime-provenance-MNJGVBV2.js +12 -0
- package/dist/runtime-provenance-MNJGVBV2.js.map +1 -0
- package/dist/{secp256k1-ZZZT2CAX.js → secp256k1-N5P2GVGF.js} +3 -3
- package/dist/secp256k1-N5P2GVGF.js.map +1 -0
- package/dist/{send-GCVEAQKL.js → send-ELXFKEKY.js} +35 -32
- package/dist/send-ELXFKEKY.js.map +1 -0
- package/dist/status-FXUFWJDM.js +404 -0
- package/dist/status-FXUFWJDM.js.map +1 -0
- package/dist/{status-line-OPCXDHL2.js → status-line-IH5JBWBC.js} +51 -43
- package/dist/status-line-IH5JBWBC.js.map +1 -0
- package/dist/streamableHttp-CP2ZQBIK.js +768 -0
- package/dist/streamableHttp-CP2ZQBIK.js.map +1 -0
- package/dist/{uninstall-BAWRBXXQ.js → uninstall-LJZUKM4D.js} +76 -76
- package/dist/uninstall-LJZUKM4D.js.map +1 -0
- package/dist/update-EUIX72IX.js +68 -0
- package/dist/update-EUIX72IX.js.map +1 -0
- package/dist/usage-EKDC7LUC.js +180 -0
- package/dist/usage-EKDC7LUC.js.map +1 -0
- package/dist/{usdc-VG4CIOUK.js → usdc-YIHK2OMC.js} +8 -12
- package/dist/usdc-YIHK2OMC.js.map +1 -0
- package/dist/{viemAdapter-By13KInL-DOFTEIJV.js → viemAdapter-By13KInL-PRLSIESK.js} +5 -5
- package/dist/viemAdapter-By13KInL-PRLSIESK.js.map +1 -0
- package/dist/wallet-HSW757W6.js +80 -0
- package/dist/wallet-HSW757W6.js.map +1 -0
- package/dist/wallet-kdf-worker.mjs +1433 -818
- package/docs/agent-permissions.md +88 -155
- package/docs/router-reference.md +236 -0
- package/docs/safety-model.md +31 -33
- package/docs/subagents-internals.md +97 -0
- package/docs/subagents.md +348 -0
- package/docs/troubleshooting.md +10 -6
- package/package.json +12 -8
- package/scripts/installers/install.sh +7 -1
- package/dist/alive-GSOWKUOY.js +0 -38
- package/dist/chunk-2I4QTOLB.js.map +0 -1
- package/dist/chunk-2M2VPI2E.js +0 -560
- package/dist/chunk-2M2VPI2E.js.map +0 -1
- package/dist/chunk-2RWB7RKE.js.map +0 -1
- package/dist/chunk-2SNUOHAT.js.map +0 -1
- package/dist/chunk-3623BLPV.js +0 -184
- package/dist/chunk-3623BLPV.js.map +0 -1
- package/dist/chunk-36RVGZNY.js.map +0 -1
- package/dist/chunk-3AIHRXKO.js.map +0 -1
- package/dist/chunk-3FMZGI7I.js.map +0 -1
- package/dist/chunk-3UCIG4TG.js.map +0 -1
- package/dist/chunk-4K7TQHNP.js.map +0 -1
- package/dist/chunk-4LMUQMBH.js +0 -29
- package/dist/chunk-4LMUQMBH.js.map +0 -1
- package/dist/chunk-4USCZ2NI.js +0 -228
- package/dist/chunk-4USCZ2NI.js.map +0 -1
- package/dist/chunk-4YOZGGTZ.js.map +0 -1
- package/dist/chunk-62KNUYWD.js +0 -111
- package/dist/chunk-62KNUYWD.js.map +0 -1
- package/dist/chunk-A5GKIG5O.js +0 -2037
- package/dist/chunk-A5GKIG5O.js.map +0 -1
- package/dist/chunk-AGMVASXZ.js.map +0 -1
- package/dist/chunk-BF4XHEQK.js.map +0 -1
- package/dist/chunk-BFDQ4WNW.js.map +0 -1
- package/dist/chunk-C2Q76BVM.js.map +0 -1
- package/dist/chunk-CEXSOI5R.js +0 -808
- package/dist/chunk-CEXSOI5R.js.map +0 -1
- package/dist/chunk-E7SW44LM.js.map +0 -1
- package/dist/chunk-EDJWHDDL.js +0 -33
- package/dist/chunk-EDJWHDDL.js.map +0 -1
- package/dist/chunk-FVIGCDSV.js.map +0 -1
- package/dist/chunk-GTTUCOPD.js +0 -105
- package/dist/chunk-GTTUCOPD.js.map +0 -1
- package/dist/chunk-HDPUXS3Z.js +0 -122
- package/dist/chunk-HDPUXS3Z.js.map +0 -1
- package/dist/chunk-HGGWCP7W.js +0 -120
- package/dist/chunk-HGGWCP7W.js.map +0 -1
- package/dist/chunk-HGZEPQUT.js.map +0 -1
- package/dist/chunk-HMWYAUA6.js.map +0 -1
- package/dist/chunk-IADZOXKN.js.map +0 -1
- package/dist/chunk-ILNIZ5I2.js.map +0 -1
- package/dist/chunk-INTFHMU4.js.map +0 -1
- package/dist/chunk-JKKAIPTU.js.map +0 -1
- package/dist/chunk-JNJWBTU2.js.map +0 -1
- package/dist/chunk-KM7RY2ZS.js +0 -246
- package/dist/chunk-KM7RY2ZS.js.map +0 -1
- package/dist/chunk-KOGZDMHO.js +0 -21
- package/dist/chunk-KOGZDMHO.js.map +0 -1
- package/dist/chunk-L6JEXB3E.js.map +0 -1
- package/dist/chunk-LRW6S53P.js.map +0 -1
- package/dist/chunk-LXAYUOXI.js +0 -511
- package/dist/chunk-LXAYUOXI.js.map +0 -1
- package/dist/chunk-MEFB5KHA.js +0 -59
- package/dist/chunk-MEFB5KHA.js.map +0 -1
- package/dist/chunk-MPZUYCAP.js.map +0 -1
- package/dist/chunk-NDGZDTSJ.js.map +0 -1
- package/dist/chunk-OJNTCYQQ.js.map +0 -1
- package/dist/chunk-P3LFTKE7.js +0 -58
- package/dist/chunk-P3LFTKE7.js.map +0 -1
- package/dist/chunk-QXP3Z3JN.js.map +0 -1
- package/dist/chunk-RVPYTUP4.js.map +0 -1
- package/dist/chunk-SNNSAGMT.js.map +0 -1
- package/dist/chunk-TC2WZLSC.js.map +0 -1
- package/dist/chunk-TKPF35W6.js +0 -29
- package/dist/chunk-TKPF35W6.js.map +0 -1
- package/dist/chunk-U3IKUGRP.js.map +0 -1
- package/dist/chunk-UUGOUOVT.js.map +0 -1
- package/dist/chunk-UXZONNEQ.js.map +0 -1
- package/dist/chunk-WXA2BWTE.js.map +0 -1
- package/dist/chunk-WYXUQGOL.js.map +0 -1
- package/dist/chunk-X5ZBP3IY.js.map +0 -1
- package/dist/chunk-XKESD27X.js +0 -10
- package/dist/chunk-XKESD27X.js.map +0 -1
- package/dist/chunk-XQJXNMSB.js.map +0 -1
- package/dist/chunk-Y527D4TV.js +0 -56
- package/dist/chunk-Y527D4TV.js.map +0 -1
- package/dist/chunk-ZDZERB6L.js.map +0 -1
- package/dist/chunk-ZNNXRNFD.js.map +0 -1
- package/dist/chunk-ZURZHELF.js.map +0 -1
- package/dist/cli-E36SPKBW.js.map +0 -1
- package/dist/codex-install-HQZDGFXW.js.map +0 -1
- package/dist/config-HY2E4GGW.js +0 -55
- package/dist/doctor-I6XQEKWD.js.map +0 -1
- package/dist/fund-2QRO7OJL.js +0 -378
- package/dist/fund-2QRO7OJL.js.map +0 -1
- package/dist/hook-command-2UBCSZG6.js +0 -43
- package/dist/install-ILUX5C4A.js +0 -107
- package/dist/install-identity-TZKGY6LQ.js +0 -31
- package/dist/install-wallet-5M4OTYLX.js.map +0 -1
- package/dist/mcp-LE4DUS22.js +0 -14127
- package/dist/mcp-LE4DUS22.js.map +0 -1
- package/dist/pay-WCG3IH4R.js +0 -55
- package/dist/payments-HFPPWHTV.js.map +0 -1
- package/dist/plugin-registration-PZFI5GZW.js +0 -68
- package/dist/runtime-UZOKSUZX.js +0 -1321
- package/dist/runtime-UZOKSUZX.js.map +0 -1
- package/dist/send-GCVEAQKL.js.map +0 -1
- package/dist/status-HCVAOCN7.js +0 -150
- package/dist/status-HCVAOCN7.js.map +0 -1
- package/dist/status-line-OPCXDHL2.js.map +0 -1
- package/dist/uninstall-BAWRBXXQ.js.map +0 -1
- package/dist/update-CACXLQLR.js +0 -56
- package/dist/wallet-QL4UUXEZ.js +0 -55
- /package/dist/{_esm-BIN7VY2L.js.map → _esm-2KST7HQ7.js.map} +0 -0
- /package/dist/{alive-GSOWKUOY.js.map → alive-5TV22PNF.js.map} +0 -0
- /package/dist/{auto-update-Y24UL56V.js.map → auth-XI7BJFLW.js.map} +0 -0
- /package/dist/{ccip-DHDFKTQV.js.map → auto-update-7L24KDWA.js.map} +0 -0
- /package/dist/{clack-EZ7TDWQU.js.map → balance-DFHC6XEU.js.map} +0 -0
- /package/dist/{claude-cli-2YKABJJZ.js.map → ccip-HOW3DZYF.js.map} +0 -0
- /package/dist/{chunk-IE7P2BZE.js.map → chunk-6QMDUDF2.js.map} +0 -0
- /package/dist/{chunk-KG3D7FIF.js.map → chunk-CZJOMUBP.js.map} +0 -0
- /package/dist/{chunk-3GNJXKIT.js.map → chunk-F43CV6UC.js.map} +0 -0
- /package/dist/{chunk-J57UC3DD.js.map → chunk-FKVJKLPI.js.map} +0 -0
- /package/dist/{chunk-SO3XRZPX.js.map → chunk-HPRVFJPM.js.map} +0 -0
- /package/dist/{chunk-2GP3HRYK.js.map → chunk-INSIW65E.js.map} +0 -0
- /package/dist/{chunk-RL5UUDT4.js.map → chunk-JNUKLSMZ.js.map} +0 -0
- /package/dist/{chunk-JRGFKVAZ.js.map → chunk-PETQ5WEA.js.map} +0 -0
- /package/dist/{codex-event-ZO2GEFE6.js.map → chunk-TUCKEEXE.js.map} +0 -0
- /package/dist/{chunk-BPMWXTFX.js.map → chunk-WFZX352D.js.map} +0 -0
- /package/dist/{chunk-6CMM6YCB.js.map → chunk-YWWMISDY.js.map} +0 -0
- /package/dist/{codex-host-KECJVTA2.js.map → clack-Q4RNC5VE.js.map} +0 -0
- /package/dist/{config-HY2E4GGW.js.map → claude-cli-GIIHOBGT.js.map} +0 -0
- /package/dist/{env-proxy-R6ZMLQTT.js.map → claude-install-BAUSJMW3.js.map} +0 -0
- /package/dist/{ethersCompat-Df4a6QIZ-X6YZWAML.js.map → codex-event-EUTCAOTQ.js.map} +0 -0
- /package/dist/{hook-command-2UBCSZG6.js.map → codex-host-ZON3S6HU.js.map} +0 -0
- /package/dist/{hosts-DVQJ32QC.js.map → config-QZOBMTEL.js.map} +0 -0
- /package/dist/{install-ILUX5C4A.js.map → config-rules-YOYHS6YL.js.map} +0 -0
- /package/dist/{install-identity-TZKGY6LQ.js.map → decision-QSKHOGCO.js.map} +0 -0
- /package/dist/{package-IJFGMWEV.js.map → env-proxy-XLSLHBKQ.js.map} +0 -0
- /package/dist/{passphrase-IFTDS3CU.js.map → ethersCompat-Df4a6QIZ-K3DMHR6Y.js.map} +0 -0
- /package/dist/{paths-XCSAKISU.js.map → flush-stdio-NYIJ3QXT.js.map} +0 -0
- /package/dist/{pay-WCG3IH4R.js.map → hook-command-VZ27MGWO.js.map} +0 -0
- /package/dist/{plugin-registration-PZFI5GZW.js.map → hosts-3EMTVM4H.js.map} +0 -0
- /package/dist/{redact-D7ASVWKL.js.map → install-ZA7L2UF3.js.map} +0 -0
- /package/dist/{runtime-fetch-ZSSSK72Y.js.map → install-funding-JDGYTF72.js.map} +0 -0
- /package/dist/{runtime-layout-WIDILZ6K.js.map → install-identity-FFAYEFLX.js.map} +0 -0
- /package/dist/{secp256k1-ZZZT2CAX.js.map → new-install-5L4GY3LN.js.map} +0 -0
- /package/dist/{update-CACXLQLR.js.map → package-BONDXSV3.js.map} +0 -0
- /package/dist/{usdc-VG4CIOUK.js.map → passphrase-T4ULBN4M.js.map} +0 -0
- /package/dist/{viemAdapter-By13KInL-DOFTEIJV.js.map → paths-O2KDWZ76.js.map} +0 -0
- /package/dist/{wallet-QL4UUXEZ.js.map → pay-CMV5KL74.js.map} +0 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../node_modules/.pnpm/@x402+core@2.28.0/node_modules/@x402/core/src/client/x402Client.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/constants.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/defaultAssets.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/auth-capture/constants.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/auth-capture/client/scheme.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/auth-capture/nonce.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/encoding.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/abi.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/types.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/shared/extensions/builderCode.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/exact/extensions.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/shared/extensions/gasSponsoring.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/exact/client/eip2612.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/exact/client/erc20approval.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/shared/rpc.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/voucher.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/eip3009.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/storage.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/config.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/channel.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/recovery.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/hooks.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/refund.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/scheme.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/batch-settlement/client/permit2.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/shared/permit2.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/shared/erc20approval.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/upto/facilitator/errors.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/exact/client/permit2.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/exact/client/eip3009.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/exact/client/scheme.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/exact/client/register.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/types.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/assetCache.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/signer.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/shared/erc7702.ts","../node_modules/.pnpm/@x402+evm@2.28.0_typescript@6.0.3/node_modules/@x402/evm/src/auth-capture/types.ts","../node_modules/.pnpm/@x402+extensions@2.28.0_typescript@6.0.3/node_modules/@x402/extensions/src/builder-code/types.ts","../node_modules/.pnpm/@x402+extensions@2.28.0_typescript@6.0.3/node_modules/@x402/extensions/src/builder-code/cbor.ts","../node_modules/.pnpm/@x402+extensions@2.28.0_typescript@6.0.3/node_modules/@x402/extensions/src/builder-code/server.ts","../node_modules/.pnpm/@x402+extensions@2.28.0_typescript@6.0.3/node_modules/@x402/extensions/src/builder-code/client.ts","../node_modules/.pnpm/@x402+extensions@2.28.0_typescript@6.0.3/node_modules/@x402/extensions/src/builder-code/facilitator.ts","../src/lib/x402-pay.ts"],"sourcesContent":["import { x402Version } from \"..\";\nimport { DefaultAsset, SchemeNetworkClient } from \"../types/mechanisms\";\nimport { PaymentPayload, PaymentRequirements } from \"../types/payments\";\nimport {\n Money,\n Network,\n PaymentRequired,\n PaymentRequirementsV1,\n SettleResponse,\n} from \"../types\";\nimport {\n ADDITIVE_ARRAY_INFO_FIELDS,\n convertToTokenAmount,\n deepEqual,\n findByNetworkAndScheme,\n findSchemesByNetwork,\n networkMatchesPattern,\n parseMoney,\n toComparableArray,\n} from \"../utils\";\n\n/**\n * Client Hook Context Interfaces\n */\n\nexport interface PaymentCreationContext {\n paymentRequired: PaymentRequired;\n selectedRequirements: PaymentRequirements;\n}\n\nexport interface PaymentCreatedContext extends PaymentCreationContext {\n paymentPayload: PaymentPayload;\n}\n\nexport interface PaymentCreationFailureContext extends PaymentCreationContext {\n error: Error;\n}\n\n/**\n * Client Hook Type Definitions\n */\n\nexport type BeforePaymentCreationHook = (\n context: PaymentCreationContext,\n) => Promise<void | { abort: true; reason: string }>;\n\nexport type AfterPaymentCreationHook = (context: PaymentCreatedContext) => Promise<void>;\n\nexport type OnPaymentCreationFailureHook = (\n context: PaymentCreationFailureContext,\n) => Promise<void | { recovered: true; payload: PaymentPayload }>;\n\n/**\n * Context provided to payment response hooks after the paid request completes.\n *\n * Discriminate by what's present:\n * - `settleResponse` with `success: true` → settle succeeded\n * - `settleResponse` with `success: false` → settle failed\n * - `paymentRequired` (no `settleResponse`) → verify failed\n * - `error` → transport or parse error\n */\nexport interface PaymentResponseContext {\n paymentPayload: PaymentPayload;\n requirements: PaymentRequirements;\n settleResponse?: SettleResponse;\n paymentRequired?: PaymentRequired;\n error?: Error;\n}\n\n/**\n * Hook fired after a paid request completes.\n * Return `{ recovered: true }` to signal the transport should retry with a fresh payload.\n */\nexport type OnPaymentResponseHook = (\n ctx: PaymentResponseContext,\n) => Promise<void | { recovered: true }>;\n\nexport type SelectPaymentRequirements = (x402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements;\n\ntype ClientHookAdapterHandles = {\n beforePaymentCreation?: BeforePaymentCreationHook;\n afterPaymentCreation?: AfterPaymentCreationHook;\n onPaymentCreationFailure?: OnPaymentCreationFailureHook;\n onPaymentResponse?: OnPaymentResponseHook;\n};\n\ntype ClientHookPhase = keyof ClientHookAdapterHandles;\n\nexport interface ClientExtensionHooks {\n onBeforePaymentCreation?: (\n declaration: unknown,\n context: PaymentCreationContext,\n ) => Promise<void | { abort: true; reason: string }>;\n onAfterPaymentCreation?: (\n declaration: unknown,\n context: PaymentCreatedContext,\n ) => Promise<void>;\n onPaymentCreationFailure?: (\n declaration: unknown,\n context: PaymentCreationFailureContext,\n ) => Promise<void | { recovered: true; payload: PaymentPayload }>;\n onPaymentResponse?: (\n declaration: unknown,\n context: PaymentResponseContext,\n ) => Promise<void | { recovered: true }>;\n}\n\nexport interface ClientTransportExtensionHooks {\n [transport: string]: unknown;\n}\n\n/**\n * Extension that can enrich payment payloads on the client side.\n *\n * Client extensions are invoked after the scheme creates the base payment payload\n * but before it is returned. This allows mechanism-specific logic (e.g., EVM EIP-2612\n * permit signing) to enrich the payload's extensions data.\n */\nexport interface ClientExtension {\n /**\n * Unique key identifying this extension (e.g., \"eip2612GasSponsoring\").\n * Must match the extension key used in PaymentRequired.extensions.\n */\n key: string;\n\n /**\n * Called after payload creation for every registered extension. Allows the\n * extension to enrich the payload with extension-specific data. Extensions\n * that require a server declaration must no-op internally when the server\n * did not advertise them in paymentRequired.extensions.\n *\n * @param paymentPayload - The payment payload to enrich\n * @param paymentRequired - The original PaymentRequired response\n * @returns The enriched payment payload\n */\n enrichPaymentPayload?: (\n paymentPayload: PaymentPayload,\n paymentRequired: PaymentRequired,\n ) => Promise<PaymentPayload>;\n\n hooks?: ClientExtensionHooks;\n transportHooks?: ClientTransportExtensionHooks;\n}\n\n/**\n * A policy function that filters or transforms payment requirements.\n * Policies are applied in order before the selector chooses the final option.\n *\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - Array of payment requirements to filter/transform\n * @returns Filtered array of payment requirements\n */\nexport type PaymentPolicy = (x402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements[];\n\n/** Default USD cap for recognized default assets. Override via {@link SpendControls}. */\nexport const DEFAULT_MAX_AMOUNT_PER_PAYMENT: Money = \"$1\";\n\n/**\n * Opt-in asset for {@link SpendControls.allowedAssets}.\n * Default assets are always allowed; list non-default tokens here (and optional atomic caps).\n */\nexport interface SpendControlAsset {\n network: Network;\n /** On-chain asset id, or a default-asset symbol (e.g. `\"PYUSD\"`). */\n asset: string;\n /** Optional integer atomic per-payment cap (e.g. `\"2000000\"`), not `\"$1\"`. Omit to allow uncapped. */\n maxAmountPerPayment?: string;\n}\n\n/**\n * Client spend controls (enforced before policies).\n * Network scoping is scheme registration, not a control here.\n *\n * By default only assets `findDefaultAsset` recognizes are allowed, capped at\n * {@link DEFAULT_MAX_AMOUNT_PER_PAYMENT}. Pass `spendControls: false` to disable\n * all spend controls (any asset, no caps).\n */\nexport interface SpendControls {\n /**\n * Per-payment USD cap on assets `findDefaultAsset` recognizes.\n * `false` disables. Override per asset with `allowedAssets[].maxAmountPerPayment`.\n *\n * @default \"$1\"\n */\n maxAmountPerPayment?: Money | false;\n /**\n * Opt-in non-default assets.\n * - omit: default assets only\n * - `true`: allow any asset (USD cap still applies to defaults)\n * - list: defaults plus listed entries; optional integer atomic `maxAmountPerPayment` per entry\n */\n allowedAssets?: true | SpendControlAsset[];\n}\n\n/**\n * Returns whether `amount` is an integer atomic string.\n *\n * @param amount - Amount to test\n * @returns True when the value is all digits\n */\nfunction isAtomicAmount(amount: string): boolean {\n return /^\\d+$/.test(amount);\n}\n\n/**\n * Finds the matching `allowedAssets` entry for a requirement.\n *\n * @param controls - Active spend controls\n * @param requirement - Payment requirement\n * @param defaultAsset - Default-asset lookup result\n * @returns Matching entry, if any\n */\nfunction findSpendControlAssetEntry(\n controls: SpendControls,\n requirement: PaymentRequirements,\n defaultAsset: DefaultAsset | undefined,\n): SpendControlAsset | undefined {\n if (controls.allowedAssets === true) {\n return undefined;\n }\n return controls.allowedAssets?.find(entry => {\n if (!networkMatchesPattern(entry.network, requirement.network)) {\n return false;\n }\n if (entry.asset.toLowerCase() === requirement.asset.toLowerCase()) {\n return true;\n }\n return (\n defaultAsset != null && defaultAsset.symbol.toLowerCase() === entry.asset.toLowerCase()\n );\n });\n}\n\n/**\n * Resolves the atomic spend cap for filtering and payload context.\n *\n * @param controls - Client spend controls\n * @param requirement - Payment requirement\n * @param defaultAsset - Default-asset lookup result\n * @returns Atomic cap, or undefined when uncapped\n */\nfunction resolveAtomicSpendCap(\n controls: SpendControls | false,\n requirement: PaymentRequirements,\n defaultAsset: DefaultAsset | undefined,\n): string | undefined {\n if (controls === false) {\n return undefined;\n }\n\n const assetEntry = findSpendControlAssetEntry(controls, requirement, defaultAsset);\n if (assetEntry?.maxAmountPerPayment != null) {\n if (!isAtomicAmount(assetEntry.maxAmountPerPayment)) {\n throw new Error(\n `spendControls.allowedAssets[].maxAmountPerPayment must be an integer atomic amount, not a dollar value; got ${JSON.stringify(assetEntry.maxAmountPerPayment)}`,\n );\n }\n return assetEntry.maxAmountPerPayment;\n }\n\n if (!defaultAsset || controls.maxAmountPerPayment === false) {\n return undefined;\n }\n\n const usdLimit = controls.maxAmountPerPayment ?? DEFAULT_MAX_AMOUNT_PER_PAYMENT;\n return convertToTokenAmount(parseMoney(usdLimit).amount, defaultAsset.decimals);\n}\n\n/**\n * Configuration for registering a payment scheme with a specific network\n */\nexport interface SchemeRegistration {\n /**\n * The network identifier (e.g., 'eip155:8453', 'solana:mainnet')\n */\n network: Network;\n\n /**\n * The scheme client implementation for this network\n */\n client: SchemeNetworkClient;\n\n /**\n * The x402 protocol version to use for this scheme\n *\n * @default 2\n */\n x402Version?: number;\n}\n\n/**\n * Configuration options for the fetch wrapper\n */\nexport interface x402ClientConfig {\n /**\n * Array of scheme registrations defining which payment methods are supported\n */\n schemes: SchemeRegistration[];\n\n /**\n * Policies to apply to the client\n */\n policies?: PaymentPolicy[];\n\n /**\n * Spend controls; default is default assets only + {@link DEFAULT_MAX_AMOUNT_PER_PAYMENT}.\n * Pass `false` to disable all spend controls (any asset, no caps).\n */\n spendControls?: SpendControls | false;\n\n /**\n * Custom payment requirements selector function\n * If not provided, uses the default selector (first available option)\n */\n paymentRequirementsSelector?: SelectPaymentRequirements;\n}\n\n/**\n * Core client for managing x402 payment schemes and creating payment payloads.\n *\n * Handles registration of payment schemes, policy-based filtering of payment requirements,\n * and creation of payment payloads based on server requirements.\n */\nexport class x402Client {\n private readonly paymentRequirementsSelector: SelectPaymentRequirements;\n private readonly registeredClientSchemes: Map<number, Map<string, Map<string, SchemeNetworkClient>>> = new Map();\n private readonly schemeClientHookAdapters: Map<number, Map<string, Map<string, ClientHookAdapterHandles>>> = new Map();\n private readonly policies: PaymentPolicy[] = [];\n private readonly registeredExtensions: Map<string, ClientExtension> = new Map();\n private spendControls: SpendControls | false = {};\n\n private beforePaymentCreationHooks: BeforePaymentCreationHook[] = [];\n private afterPaymentCreationHooks: AfterPaymentCreationHook[] = [];\n private onPaymentCreationFailureHooks: OnPaymentCreationFailureHook[] = [];\n private paymentResponseHooks: OnPaymentResponseHook[] = [];\n\n /**\n * Creates a new x402Client instance.\n *\n * @param paymentRequirementsSelector - Function to select payment requirements from available options\n */\n constructor(paymentRequirementsSelector?: SelectPaymentRequirements) {\n this.paymentRequirementsSelector = paymentRequirementsSelector || ((x402Version, accepts) => accepts[0]);\n }\n\n /**\n * Creates a new x402Client instance from a configuration object.\n *\n * @param config - The client configuration including schemes, policies, and payment requirements selector\n * @returns A configured x402Client instance\n */\n static fromConfig(config: x402ClientConfig): x402Client {\n const client = new x402Client(config.paymentRequirementsSelector);\n config.schemes.forEach(scheme => {\n if (scheme.x402Version === 1) {\n client.registerV1(scheme.network, scheme.client);\n } else {\n client.register(scheme.network, scheme.client);\n }\n });\n config.policies?.forEach(policy => {\n client.registerPolicy(policy);\n });\n if (config.spendControls !== undefined) {\n client.setSpendControls(config.spendControls);\n }\n return client;\n }\n\n /**\n * Registers a scheme client for the current x402 version.\n *\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The x402Client instance for chaining\n */\n register(network: Network, client: SchemeNetworkClient): x402Client {\n return this._registerScheme(x402Version, network, client);\n }\n\n /**\n * Registers a scheme client for x402 version 1.\n *\n * @param network - The v1 network identifier (e.g., 'base-sepolia', 'solana-devnet')\n * @param client - The scheme network client to register\n * @returns The x402Client instance for chaining\n */\n registerV1(network: string, client: SchemeNetworkClient): x402Client {\n return this._registerScheme(1, network as Network, client);\n }\n\n /**\n * Registers a policy to filter or transform payment requirements.\n *\n * Policies are applied in order after filtering by registered schemes\n * and before the selector chooses the final payment requirement.\n *\n * @param policy - Function to filter/transform payment requirements\n * @returns The x402Client instance for chaining\n *\n * @example\n * ```typescript\n * // Prefer cheaper options\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => BigInt(r.value) < BigInt('1000000'))\n * );\n *\n * // Prefer specific networks\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => r.network.startsWith('eip155:'))\n * );\n * ```\n */\n registerPolicy(policy: PaymentPolicy): x402Client {\n this.policies.push(policy);\n return this;\n }\n\n /**\n * Replace spend controls. Pass `false` to disable all spend controls.\n * When an object is passed, omitted `maxAmountPerPayment` still defaults to\n * {@link DEFAULT_MAX_AMOUNT_PER_PAYMENT}.\n *\n * @param controls - Spend control configuration, or `false` to disable\n * @returns This client for chaining\n */\n setSpendControls(controls: SpendControls | false): x402Client {\n this.spendControls = controls;\n return this;\n }\n\n /**\n * Registers a client extension that can enrich payment payloads.\n *\n * Extensions are invoked after the scheme creates the base payload and the\n * payload is wrapped with extensions/resource/accepted data. Every registered\n * extension's `enrichPaymentPayload` hook is called to modify the payload.\n * Server-declared fields are preserved via merge after enrichment.\n *\n * @param extension - The client extension to register\n * @returns The x402Client instance for chaining\n */\n registerExtension(extension: ClientExtension): x402Client {\n this.registeredExtensions.set(extension.key, extension);\n return this;\n }\n\n /**\n * Get all registered client extensions.\n *\n * @returns Array of registered extensions\n */\n getExtensions(): ClientExtension[] {\n return Array.from(this.registeredExtensions.values());\n }\n\n /**\n * Register a hook to execute before payment payload creation.\n * Can abort creation by returning { abort: true, reason: string }\n *\n * @param hook - The hook function to register\n * @returns The x402Client instance for chaining\n */\n onBeforePaymentCreation(hook: BeforePaymentCreationHook): x402Client {\n this.beforePaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute after successful payment payload creation.\n *\n * @param hook - The hook function to register\n * @returns The x402Client instance for chaining\n */\n onAfterPaymentCreation(hook: AfterPaymentCreationHook): x402Client {\n this.afterPaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute when payment payload creation fails.\n * Can recover from failure by returning { recovered: true, payload: PaymentPayload }\n *\n * @param hook - The hook function to register\n * @returns The x402Client instance for chaining\n */\n onPaymentCreationFailure(hook: OnPaymentCreationFailureHook): x402Client {\n this.onPaymentCreationFailureHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute after a paid request completes.\n * Can signal recovery by returning { recovered: true }, causing the transport to retry.\n *\n * @param hook - The hook function to register\n * @returns The x402Client instance for chaining\n */\n onPaymentResponse(hook: OnPaymentResponseHook): x402Client {\n this.paymentResponseHooks.push(hook);\n return this;\n }\n\n /**\n * Fires all registered payment response hooks in order.\n * Returns `{ recovered: true }` if any hook signals recovery (first wins).\n *\n * @param ctx - The payment response context\n * @returns Recovery signal or undefined\n */\n async handlePaymentResponse(\n ctx: PaymentResponseContext,\n ): Promise<{ recovered: true } | undefined> {\n for (const hook of this.getLabeledHooks(\n \"onPaymentResponse\",\n ctx.paymentPayload.x402Version,\n ctx.requirements,\n ctx.paymentRequired?.extensions ?? ctx.paymentPayload.extensions,\n )) {\n const result = await hook(ctx);\n if (result && \"recovered\" in result && result.recovered) {\n return { recovered: true };\n }\n }\n return undefined;\n }\n\n /**\n * Creates a payment payload based on a PaymentRequired response.\n *\n * Automatically extracts x402Version, resource, and extensions from the PaymentRequired\n * response and constructs a complete PaymentPayload with the accepted requirements.\n *\n * @param paymentRequired - The PaymentRequired response from the server\n * @returns Promise resolving to the complete payment payload\n */\n async createPaymentPayload(\n paymentRequired: PaymentRequired,\n ): Promise<PaymentPayload> {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(paymentRequired.x402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for x402 version: ${paymentRequired.x402Version}`);\n }\n\n const requirements = this.selectPaymentRequirements(paymentRequired.x402Version, paymentRequired.accepts);\n\n const context: PaymentCreationContext = {\n paymentRequired,\n selectedRequirements: requirements,\n };\n\n for (const hook of this.getLabeledHooks(\n \"beforePaymentCreation\",\n paymentRequired.x402Version,\n requirements,\n paymentRequired.extensions,\n )) {\n const result = await hook(context);\n if (result && \"abort\" in result && result.abort) {\n throw new Error(`Payment creation aborted: ${result.reason}`);\n }\n }\n\n try {\n const schemeNetworkClient = findByNetworkAndScheme(clientSchemesByNetwork, requirements.scheme, requirements.network);\n if (!schemeNetworkClient) {\n throw new Error(`No client registered for scheme: ${requirements.scheme} and network: ${requirements.network}`);\n }\n\n const partialPayload = await schemeNetworkClient.createPaymentPayload(\n paymentRequired.x402Version,\n requirements,\n {\n extensions: paymentRequired.extensions,\n maxAmountPerPayment: resolveAtomicSpendCap(\n this.spendControls,\n requirements,\n schemeNetworkClient.findDefaultAsset?.(requirements.asset, requirements.network),\n ),\n },\n );\n\n let paymentPayload: PaymentPayload;\n if (partialPayload.x402Version == 1) {\n paymentPayload = partialPayload as PaymentPayload;\n } else {\n // Merge server-declared extensions with any scheme-provided extensions.\n // Scheme extensions overlay on top (e.g., EIP-2612 info enriches server declaration).\n const mergedExtensions = this.mergeExtensions(\n paymentRequired.extensions,\n partialPayload.extensions,\n );\n\n paymentPayload = {\n x402Version: partialPayload.x402Version,\n payload: partialPayload.payload,\n extensions: mergedExtensions,\n resource: paymentRequired.resource,\n accepted: requirements,\n };\n }\n\n // Enrich payload via registered client extensions (for non-scheme extensions)\n paymentPayload = await this.enrichPaymentPayloadWithExtensions(paymentPayload, paymentRequired);\n\n const createdContext: PaymentCreatedContext = {\n ...context,\n paymentPayload,\n };\n\n for (const hook of this.getLabeledHooks(\n \"afterPaymentCreation\",\n paymentRequired.x402Version,\n requirements,\n paymentRequired.extensions,\n )) {\n await hook(createdContext);\n }\n\n return paymentPayload;\n } catch (error) {\n const failureContext: PaymentCreationFailureContext = {\n ...context,\n error: error as Error,\n };\n\n for (const hook of this.getLabeledHooks(\n \"onPaymentCreationFailure\",\n paymentRequired.x402Version,\n requirements,\n paymentRequired.extensions,\n )) {\n const result = await hook(failureContext);\n if (result && \"recovered\" in result && result.recovered) {\n return result.payload;\n }\n }\n\n throw error;\n }\n }\n\n\n\n /**\n * Merges server-declared extensions with client extension echoes.\n * Client extension data may add fields, but server-declared fields remain intact.\n * For fields listed in `ADDITIVE_ARRAY_INFO_FIELDS` (e.g. builder-code `s`), a\n * conflicting array is concatenated with client entries first (so a downstream\n * length cap trims server entries rather than the client's) and duplicates\n * removed; a scalar on either side is treated as a single-element array. Every\n * other conflicting array keeps the server's value, same as any other scalar.\n *\n * @param serverExtensions - Extensions declared by the server in the 402 response\n * @param clientExtensions - Extensions provided by the client or scheme\n * @returns The merged extensions object, or undefined if both inputs are undefined\n */\n private mergeExtensions(\n serverExtensions?: Record<string, unknown>,\n clientExtensions?: Record<string, unknown>,\n ): Record<string, unknown> | undefined {\n if (!clientExtensions) return serverExtensions;\n if (!serverExtensions) return clientExtensions;\n\n const merged = { ...serverExtensions };\n for (const [key, clientValue] of Object.entries(clientExtensions)) {\n const serverValue = merged[key];\n if (\n serverValue === null ||\n typeof serverValue !== \"object\" ||\n Array.isArray(serverValue) ||\n clientValue === null ||\n typeof clientValue !== \"object\" ||\n Array.isArray(clientValue)\n ) {\n merged[key] = clientValue;\n continue;\n }\n\n const serverRecord = serverValue as Record<string, unknown>;\n const clientRecord = clientValue as Record<string, unknown>;\n const additiveFields = ADDITIVE_ARRAY_INFO_FIELDS[key];\n const extensionValue = { ...serverRecord };\n const pending = [{ target: extensionValue, source: clientRecord }];\n for (const item of pending) {\n for (const [fieldKey, clientFieldValue] of Object.entries(item.source)) {\n const serverFieldValue = item.target[fieldKey];\n if (\n serverFieldValue !== null &&\n typeof serverFieldValue === \"object\" &&\n !Array.isArray(serverFieldValue) &&\n clientFieldValue !== null &&\n typeof clientFieldValue === \"object\" &&\n !Array.isArray(clientFieldValue)\n ) {\n const nestedValue = { ...(serverFieldValue as Record<string, unknown>) };\n item.target[fieldKey] = nestedValue;\n pending.push({\n target: nestedValue,\n source: clientFieldValue as Record<string, unknown>,\n });\n continue;\n }\n\n // A scalar on one side (e.g. builder-code `s` sent as a bare string)\n // merges as a single-element array against an array on the other side.\n // Only additive fields concatenate; other conflicting arrays keep the\n // server's value below, same as any other scalar leaf field.\n if (\n additiveFields?.has(fieldKey) &&\n (Array.isArray(serverFieldValue) || Array.isArray(clientFieldValue))\n ) {\n const serverArray = toComparableArray(serverFieldValue);\n const clientArray = toComparableArray(clientFieldValue);\n if (serverArray && clientArray) {\n item.target[fieldKey] = mergeArraysUnique(clientArray, serverArray);\n continue;\n }\n }\n\n if (!Object.prototype.hasOwnProperty.call(item.target, fieldKey)) {\n item.target[fieldKey] = clientFieldValue;\n }\n }\n }\n\n merged[key] = extensionValue;\n }\n return merged;\n }\n\n /**\n * Enriches a payment payload by calling registered extension hooks.\n * Invokes enrichPaymentPayload for every registered extension, then merges\n * server-declared extension fields back into the result.\n *\n * @param paymentPayload - The payment payload to enrich with extension data\n * @param paymentRequired - The PaymentRequired response containing extension declarations\n * @returns The enriched payment payload with extension data applied\n */\n private async enrichPaymentPayloadWithExtensions(\n paymentPayload: PaymentPayload,\n paymentRequired: PaymentRequired,\n ): Promise<PaymentPayload> {\n if (this.registeredExtensions.size === 0) {\n return paymentPayload;\n }\n\n let enriched = paymentPayload;\n for (const [, extension] of this.registeredExtensions) {\n if (extension.enrichPaymentPayload) {\n enriched = await extension.enrichPaymentPayload(enriched, paymentRequired);\n }\n }\n\n return {\n ...enriched,\n extensions: this.mergeExtensions(paymentRequired.extensions, enriched.extensions),\n };\n }\n\n /**\n * Selects appropriate payment requirements based on registered clients and policies.\n *\n * Selection process:\n * 1. Filter by registered schemes (network + scheme support)\n * 2. Drop accepts with unrecognized `extra.paymentFlow`\n * 3. Enforce spend controls (allowlist, per-asset caps, USD cap on default assets)\n * 4. Apply all registered policies in order\n * 5. Prefer authorization (omit or explicit) over upfront/escrow when both remain\n * 6. Use selector to choose final requirement\n *\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - Array of available payment requirements\n * @returns The selected payment requirements\n */\n private selectPaymentRequirements(x402Version: number, paymentRequirements: PaymentRequirements[]): PaymentRequirements {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(x402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for x402 version: ${x402Version}`);\n }\n\n // Step 1: Filter by registered schemes\n const supportedPaymentRequirements = paymentRequirements.filter(requirement => {\n let clientSchemes = findSchemesByNetwork(clientSchemesByNetwork, requirement.network);\n if (!clientSchemes) {\n return false;\n }\n\n return clientSchemes.has(requirement.scheme);\n })\n\n if (supportedPaymentRequirements.length === 0) {\n throw new Error(`No network/scheme registered for x402 version: ${x402Version} which comply with the payment requirements. ${JSON.stringify({\n x402Version,\n paymentRequirements,\n x402Versions: Array.from(this.registeredClientSchemes.keys()),\n networks: Array.from(clientSchemesByNetwork.keys()),\n schemes: Array.from(clientSchemesByNetwork.values()).map(schemes => Array.from(schemes.keys())).flat(),\n })}`);\n }\n\n // Step 2: Drop unrecognized paymentFlow values\n const recognizedFlowRequirements = supportedPaymentRequirements.filter(requirement => {\n const flow = requirement.extra?.paymentFlow;\n return (\n flow == null ||\n flow === \"authorization\" ||\n flow === \"upfront\" ||\n flow === \"escrow\"\n );\n });\n if (recognizedFlowRequirements.length === 0) {\n throw new Error(\n `No payment requirements with a recognized paymentFlow for x402 version: ${x402Version}`,\n );\n }\n\n // Step 3: Enforce spend controls\n let filteredRequirements = this.applySpendControls(\n x402Version,\n recognizedFlowRequirements,\n clientSchemesByNetwork,\n );\n\n // Step 4: Apply all policies in order\n for (const policy of this.policies) {\n filteredRequirements = policy(x402Version, filteredRequirements);\n\n if (filteredRequirements.length === 0) {\n throw new Error(`All payment requirements were filtered out by policies for x402 version: ${x402Version}`);\n }\n }\n\n // Step 5: Prefer authorization when both post- and pre-handler flows remain\n const authorizationAccepts = filteredRequirements.filter(\n requirement =>\n requirement.extra?.paymentFlow == null ||\n requirement.extra?.paymentFlow === \"authorization\",\n );\n if (authorizationAccepts.length > 0) {\n filteredRequirements = authorizationAccepts;\n }\n\n // Step 6: Use selector to choose final requirement\n return this.paymentRequirementsSelector(x402Version, filteredRequirements);\n }\n\n /**\n * Filter by spend controls (default-asset allowlist → opt-in assets → caps).\n * Keeps any accept that fits so a mixed offer can still pay the affordable option.\n *\n * @param x402Version - Protocol version (v1 uses `maxAmountRequired`)\n * @param requirements - Post scheme/flow filter\n * @param clientSchemesByNetwork - Registered clients for this version\n * @returns Requirements that pass spend controls\n */\n private applySpendControls(\n x402Version: number,\n requirements: PaymentRequirements[],\n clientSchemesByNetwork: Map<string, Map<string, SchemeNetworkClient>>,\n ): PaymentRequirements[] {\n const controls = this.spendControls;\n if (controls === false) {\n return requirements;\n }\n\n const rawAmountOf = (requirement: PaymentRequirements) =>\n x402Version === 1\n ? (requirement as unknown as PaymentRequirementsV1).maxAmountRequired\n : requirement.amount;\n const schemeFor = (requirement: PaymentRequirements) =>\n findByNetworkAndScheme(\n clientSchemesByNetwork,\n requirement.scheme,\n requirement.network,\n );\n const defaultAssetFor = (requirement: PaymentRequirements) =>\n schemeFor(requirement)?.findDefaultAsset?.(requirement.asset, requirement.network);\n const findAssetEntry = (requirement: PaymentRequirements) =>\n findSpendControlAssetEntry(controls, requirement, defaultAssetFor(requirement));\n const allowAnyAsset = controls.allowedAssets === true;\n\n let filtered = allowAnyAsset\n ? requirements\n : requirements.filter(requirement => {\n if (defaultAssetFor(requirement) != null) {\n return true;\n }\n return findAssetEntry(requirement) != null;\n });\n if (filtered.length === 0) {\n throw new Error(\n `All payment requirements were rejected by spendControls: only default assets ` +\n `or entries in spendControls.allowedAssets are allowed. Add an allowedAssets ` +\n `entry for non-default tokens, set allowedAssets: true, or set spendControls: false.`,\n );\n }\n\n const usdLimit =\n controls.maxAmountPerPayment === false\n ? false\n : (controls.maxAmountPerPayment ?? DEFAULT_MAX_AMOUNT_PER_PAYMENT);\n\n const beforeAmountCaps = filtered;\n let rejectedByAssetCap = false;\n let rejectedUsdSymbol: string | undefined;\n\n filtered = filtered.filter(requirement => {\n const defaultAsset = defaultAssetFor(requirement);\n const assetEntry = findSpendControlAssetEntry(controls, requirement, defaultAsset);\n const cap = resolveAtomicSpendCap(controls, requirement, defaultAsset);\n if (cap === undefined) {\n return true;\n }\n\n const rawAmount = rawAmountOf(requirement);\n if (!isAtomicAmount(rawAmount)) {\n if (assetEntry?.maxAmountPerPayment != null) {\n rejectedByAssetCap = true;\n return false;\n }\n // Decimal ledger value (e.g. XRPL IOU \"0.01\") — 1:1 USD vs the Money cap.\n if (usdLimit === false) {\n return true;\n }\n const valueScaled = BigInt(convertToTokenAmount(rawAmount, 18));\n const capScaled = BigInt(convertToTokenAmount(parseMoney(usdLimit).amount, 18));\n const ok = valueScaled <= capScaled;\n if (!ok) rejectedUsdSymbol = defaultAsset?.symbol;\n return ok;\n }\n\n const ok = BigInt(rawAmount) <= BigInt(cap);\n if (!ok) {\n if (assetEntry?.maxAmountPerPayment != null) {\n rejectedByAssetCap = true;\n } else {\n rejectedUsdSymbol = defaultAsset?.symbol;\n }\n }\n return ok;\n });\n\n if (filtered.length === 0) {\n if (\n rejectedByAssetCap &&\n beforeAmountCaps.every(requirement => {\n const entry = findAssetEntry(requirement);\n return entry?.maxAmountPerPayment != null;\n })\n ) {\n throw new Error(\n `All payment requirements were rejected by spendControls.allowedAssets maxAmountPerPayment. ` +\n `Raise the per-asset cap, or omit maxAmountPerPayment to allow uncapped ` +\n `(default assets then fall back to the top-level USD cap).`,\n );\n }\n throw new Error(\n `All payment requirements were rejected by spendControls.maxAmountPerPayment ` +\n `(${String(usdLimit)}${rejectedUsdSymbol ? `, including ${rejectedUsdSymbol}` : \"\"}). ` +\n `Raise maxAmountPerPayment, set it to false to disable, ` +\n `set allowedAssets[].maxAmountPerPayment for a per-asset atomic cap, ` +\n `or set spendControls: false to disable all spend controls.`,\n );\n }\n\n return filtered;\n }\n\n /**\n * Internal method to register a scheme client.\n *\n * @param x402Version - The x402 protocol version\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The x402Client instance for chaining\n */\n private _registerScheme(x402Version: number, network: Network, client: SchemeNetworkClient): x402Client {\n if (!this.registeredClientSchemes.has(x402Version)) {\n this.registeredClientSchemes.set(x402Version, new Map());\n }\n const clientSchemesByNetwork = this.registeredClientSchemes.get(x402Version)!;\n if (!clientSchemesByNetwork.has(network)) {\n clientSchemesByNetwork.set(network, new Map());\n }\n\n const clientByScheme = clientSchemesByNetwork.get(network)!;\n clientByScheme.set(client.scheme, client);\n\n if (!this.schemeClientHookAdapters.has(x402Version)) {\n this.schemeClientHookAdapters.set(x402Version, new Map());\n }\n const adaptersByNetwork = this.schemeClientHookAdapters.get(x402Version)!;\n if (!adaptersByNetwork.has(network)) {\n adaptersByNetwork.set(network, new Map());\n }\n\n const adaptersByScheme = adaptersByNetwork.get(network)!;\n const hooks = client.schemeHooks;\n if (!hooks) {\n adaptersByScheme.delete(client.scheme);\n return this;\n }\n\n const handles: ClientHookAdapterHandles = {};\n if (hooks.onBeforePaymentCreation) {\n handles.beforePaymentCreation = hooks.onBeforePaymentCreation;\n }\n if (hooks.onAfterPaymentCreation) {\n handles.afterPaymentCreation = hooks.onAfterPaymentCreation;\n }\n if (hooks.onPaymentCreationFailure) {\n handles.onPaymentCreationFailure = hooks.onPaymentCreationFailure;\n }\n if (hooks.onPaymentResponse) {\n handles.onPaymentResponse = hooks.onPaymentResponse;\n }\n\n if (Object.keys(handles).length > 0) {\n adaptersByScheme.set(client.scheme, handles);\n } else {\n adaptersByScheme.delete(client.scheme);\n }\n\n return this;\n }\n\n /**\n * Returns manual hooks followed by the selected scheme hook and declared extension hooks.\n *\n * @param phase - Hook slot to collect\n * @param x402Version - Protocol version for the selected requirement\n * @param requirements - Selected payment requirement\n * @param declaredExtensions - Extension declarations that scope extension hooks\n * @returns Hooks in invocation order\n */\n private getLabeledHooks<P extends ClientHookPhase>(\n phase: P,\n x402Version: number,\n requirements: PaymentRequirements,\n declaredExtensions?: Record<string, unknown>,\n ): Array<NonNullable<ClientHookAdapterHandles[P]>> {\n let manual: Array<NonNullable<ClientHookAdapterHandles[P]>>;\n switch (phase) {\n case \"beforePaymentCreation\":\n manual = this.beforePaymentCreationHooks as Array<\n NonNullable<ClientHookAdapterHandles[P]>\n >;\n break;\n case \"afterPaymentCreation\":\n manual = this.afterPaymentCreationHooks as Array<\n NonNullable<ClientHookAdapterHandles[P]>\n >;\n break;\n case \"onPaymentCreationFailure\":\n manual = this.onPaymentCreationFailureHooks as Array<\n NonNullable<ClientHookAdapterHandles[P]>\n >;\n break;\n case \"onPaymentResponse\":\n manual = this.paymentResponseHooks as Array<NonNullable<ClientHookAdapterHandles[P]>>;\n break;\n }\n\n const out: Array<NonNullable<ClientHookAdapterHandles[P]>> = [...manual];\n const adaptersByNetwork = this.schemeClientHookAdapters.get(x402Version);\n const schemeAdapter = adaptersByNetwork\n ? findByNetworkAndScheme(adaptersByNetwork, requirements.scheme, requirements.network)\n : undefined;\n const hook = schemeAdapter?.[phase];\n if (hook !== undefined) {\n out.push(hook);\n }\n if (!declaredExtensions) {\n return out;\n }\n\n const extensionHookKey = this.getClientExtensionHookKey(phase);\n for (const [extensionKey, extension] of this.registeredExtensions) {\n if (!(extensionKey in declaredExtensions)) continue;\n\n const extensionHook = extension.hooks?.[extensionHookKey];\n if (!extensionHook) continue;\n\n type HookFn = NonNullable<ClientHookAdapterHandles[P]>;\n type HookContext = Parameters<HookFn>[0];\n out.push((async (ctx: HookContext) => {\n return (\n extensionHook as (\n declaration: unknown,\n context: HookContext,\n ) => ReturnType<HookFn>\n )(declaredExtensions[extensionKey], ctx);\n }) as HookFn);\n }\n return out;\n }\n\n /**\n * Maps internal hook phases to extension hook names.\n *\n * @param phase - Internal hook phase\n * @returns Extension hook key for the phase\n */\n private getClientExtensionHookKey<P extends ClientHookPhase>(\n phase: P,\n ): keyof ClientExtensionHooks {\n switch (phase) {\n case \"beforePaymentCreation\":\n return \"onBeforePaymentCreation\";\n case \"afterPaymentCreation\":\n return \"onAfterPaymentCreation\";\n case \"onPaymentCreationFailure\":\n return \"onPaymentCreationFailure\";\n case \"onPaymentResponse\":\n return \"onPaymentResponse\";\n }\n }\n}\n\n/**\n * Concatenates two arrays, keeping client entries first (so a downstream length\n * cap trims server entries rather than the client's) and dropping duplicates\n * (deep equality) wherever they occur, including within either input array.\n *\n * @param client - Client-provided array values\n * @param server - Server-declared array values\n * @returns Deduplicated concatenation\n */\nfunction mergeArraysUnique(client: unknown[], server: unknown[]): unknown[] {\n const merged: unknown[] = [];\n for (const item of [...client, ...server]) {\n if (!merged.some(existing => deepEqual(existing, item))) {\n merged.push(item);\n }\n }\n return merged;\n}\n","/** V1 legacy network name → EVM chain ID. */\nexport const EVM_NETWORK_CHAIN_ID_MAP = {\n ethereum: 1,\n sepolia: 11155111,\n abstract: 2741,\n \"abstract-testnet\": 11124,\n \"base-sepolia\": 84532,\n base: 8453,\n \"avalanche-fuji\": 43113,\n avalanche: 43114,\n iotex: 4689,\n sei: 1329,\n \"sei-testnet\": 1328,\n polygon: 137,\n \"polygon-amoy\": 80002,\n peaq: 3338,\n story: 1514,\n educhain: 41923,\n \"skale-base-sepolia\": 324705682,\n megaeth: 4326,\n monad: 143,\n \"monad-testnet\": 10143,\n stable: 988,\n \"stable-testnet\": 2201,\n celo: 42220,\n flare: 14,\n} as const;\n\nexport type EvmNetworkV1 = keyof typeof EVM_NETWORK_CHAIN_ID_MAP;\n\nexport const NETWORKS: string[] = Object.keys(EVM_NETWORK_CHAIN_ID_MAP);\n\n/**\n * Extract chain ID from a v1 legacy network name.\n *\n * @param network - The v1 network name (e.g., \"base-sepolia\", \"polygon\")\n * @returns The numeric chain ID\n * @throws Error if the network name is not a known v1 network\n */\nexport function getEvmChainIdV1(network: string): number {\n const chainId = EVM_NETWORK_CHAIN_ID_MAP[network as EvmNetworkV1];\n if (!chainId) {\n throw new Error(`Unsupported v1 network: ${network}`);\n }\n return chainId;\n}\n\n// EIP-3009 TransferWithAuthorization types for EIP-712 signing\nexport const authorizationTypes = {\n TransferWithAuthorization: [\n { name: \"from\", type: \"address\" },\n { name: \"to\", type: \"address\" },\n { name: \"value\", type: \"uint256\" },\n { name: \"validAfter\", type: \"uint256\" },\n { name: \"validBefore\", type: \"uint256\" },\n { name: \"nonce\", type: \"bytes32\" },\n ],\n} as const;\n\n/**\n * Permit2 EIP-712 types for signing PermitWitnessTransferFrom (exact scheme).\n * Must match the exact format expected by the Permit2 contract.\n * Note: Types must be in ALPHABETICAL order after the primary type (TokenPermissions < Witness).\n */\nexport const permit2WitnessTypes = {\n PermitWitnessTransferFrom: [\n { name: \"permitted\", type: \"TokenPermissions\" },\n { name: \"spender\", type: \"address\" },\n { name: \"nonce\", type: \"uint256\" },\n { name: \"deadline\", type: \"uint256\" },\n { name: \"witness\", type: \"Witness\" },\n ],\n TokenPermissions: [\n { name: \"token\", type: \"address\" },\n { name: \"amount\", type: \"uint256\" },\n ],\n Witness: [\n { name: \"to\", type: \"address\" },\n { name: \"validAfter\", type: \"uint256\" },\n ],\n} as const;\n\n/**\n * Permit2 EIP-712 types for signing PermitWitnessTransferFrom (upto scheme).\n * The upto witness includes a `facilitator` field that the exact witness does not.\n * This ensures only the authorized facilitator can settle the payment.\n * Must match: Witness(address to,address facilitator,uint256 validAfter)\n */\nexport const uptoPermit2WitnessTypes = {\n PermitWitnessTransferFrom: [\n { name: \"permitted\", type: \"TokenPermissions\" },\n { name: \"spender\", type: \"address\" },\n { name: \"nonce\", type: \"uint256\" },\n { name: \"deadline\", type: \"uint256\" },\n { name: \"witness\", type: \"Witness\" },\n ],\n TokenPermissions: [\n { name: \"token\", type: \"address\" },\n { name: \"amount\", type: \"uint256\" },\n ],\n Witness: [\n { name: \"to\", type: \"address\" },\n { name: \"facilitator\", type: \"address\" },\n { name: \"validAfter\", type: \"uint256\" },\n ],\n} as const;\n\n// EIP3009 ABI for transferWithAuthorization function\nexport const eip3009ABI = [\n {\n inputs: [\n { name: \"from\", type: \"address\" },\n { name: \"to\", type: \"address\" },\n { name: \"value\", type: \"uint256\" },\n { name: \"validAfter\", type: \"uint256\" },\n { name: \"validBefore\", type: \"uint256\" },\n { name: \"nonce\", type: \"bytes32\" },\n { name: \"v\", type: \"uint8\" },\n { name: \"r\", type: \"bytes32\" },\n { name: \"s\", type: \"bytes32\" },\n ],\n name: \"transferWithAuthorization\",\n outputs: [],\n stateMutability: \"nonpayable\",\n type: \"function\",\n },\n {\n inputs: [\n { name: \"from\", type: \"address\" },\n { name: \"to\", type: \"address\" },\n { name: \"value\", type: \"uint256\" },\n { name: \"validAfter\", type: \"uint256\" },\n { name: \"validBefore\", type: \"uint256\" },\n { name: \"nonce\", type: \"bytes32\" },\n { name: \"signature\", type: \"bytes\" },\n ],\n name: \"transferWithAuthorization\",\n outputs: [],\n stateMutability: \"nonpayable\",\n type: \"function\",\n },\n {\n inputs: [{ name: \"account\", type: \"address\" }],\n name: \"balanceOf\",\n outputs: [{ name: \"\", type: \"uint256\" }],\n stateMutability: \"view\",\n type: \"function\",\n },\n {\n inputs: [],\n name: \"version\",\n outputs: [{ name: \"\", type: \"string\" }],\n stateMutability: \"view\",\n type: \"function\",\n },\n {\n inputs: [],\n name: \"name\",\n outputs: [{ name: \"\", type: \"string\" }],\n stateMutability: \"view\",\n type: \"function\",\n },\n {\n inputs: [\n { name: \"authorizer\", type: \"address\" },\n { name: \"nonce\", type: \"bytes32\" },\n ],\n name: \"authorizationState\",\n outputs: [{ name: \"\", type: \"bool\" }],\n stateMutability: \"view\",\n type: \"function\",\n },\n] as const;\n\n/**\n * EIP-2612 Permit EIP-712 types for signing token.permit().\n */\nexport const eip2612PermitTypes = {\n Permit: [\n { name: \"owner\", type: \"address\" },\n { name: \"spender\", type: \"address\" },\n { name: \"value\", type: \"uint256\" },\n { name: \"nonce\", type: \"uint256\" },\n { name: \"deadline\", type: \"uint256\" },\n ],\n} as const;\n\n/**\n * EIP-2612 nonces ABI for querying current nonce.\n */\nexport const eip2612NoncesAbi = [\n {\n type: \"function\",\n name: \"nonces\",\n inputs: [{ name: \"owner\", type: \"address\" }],\n outputs: [{ type: \"uint256\" }],\n stateMutability: \"view\",\n },\n] as const;\n\n/** ERC-20 approve(address,uint256) ABI for encoding/decoding approval calldata. */\nexport const erc20ApproveAbi = [\n {\n type: \"function\",\n name: \"approve\",\n inputs: [\n { name: \"spender\", type: \"address\" },\n { name: \"amount\", type: \"uint256\" },\n ],\n outputs: [{ type: \"bool\" }],\n stateMutability: \"nonpayable\",\n },\n] as const;\n\n/** ERC-20 allowance(address,address) ABI for checking spender approval. */\nexport const erc20AllowanceAbi = [\n {\n type: \"function\",\n name: \"allowance\",\n inputs: [\n { name: \"owner\", type: \"address\" },\n { name: \"spender\", type: \"address\" },\n ],\n outputs: [{ type: \"uint256\" }],\n stateMutability: \"view\",\n },\n] as const;\n\n/** Gas limit for a standard ERC-20 approve() transaction. */\nexport const ERC20_APPROVE_GAS_LIMIT = 70_000n;\n\n/** Fallback max fee per gas (1 gwei) when fee estimation fails. */\nexport const DEFAULT_MAX_FEE_PER_GAS = 1_000_000_000n;\n\n/** Fallback max priority fee per gas (0.1 gwei) when fee estimation fails. */\nexport const DEFAULT_MAX_PRIORITY_FEE_PER_GAS = 100_000_000n;\n\n/**\n * Canonical Permit2 contract address.\n * Same address on all EVM chains via CREATE2 deployment.\n *\n * @see https://github.com/Uniswap/permit2\n */\nexport const PERMIT2_ADDRESS = \"0x000000000022D473030F116dDEE9F6B43aC78BA3\" as const;\n\n/**\n * x402ExactPermit2Proxy contract address.\n * Vanity address: 0x4020...0001 for easy recognition.\n * This address is deterministic based on:\n * - Arachnid's deterministic deployer (0x4e59b44847b379578588920cA78FbF26c0B4956C)\n * - Vanity-mined salt for prefix 0x4020 and suffix 0001\n * - Contract bytecode + constructor args (PERMIT2_ADDRESS)\n */\nexport const x402ExactPermit2ProxyAddress = \"0x402085c248EeA27D92E8b30b2C58ed07f9E20001\" as const;\n\n/**\n * x402UptoPermit2Proxy contract address.\n * Vanity address: 0x4020...0002 for easy recognition.\n * This address is deterministic based on:\n * - Arachnid's deterministic deployer (0x4e59b44847b379578588920cA78FbF26c0B4956C)\n * - Vanity-mined salt for prefix 0x4020 and suffix 0002\n * - Contract bytecode + constructor args (PERMIT2_ADDRESS)\n */\nexport const x402UptoPermit2ProxyAddress = \"0x4020A4f3b7b90ccA423B9fabCc0CE57C6C240002\" as const;\n\n/**\n * ABI components for the exact Permit2 witness tuple: Witness(address to, uint256 validAfter).\n */\nconst permit2WitnessABIComponents = [\n { name: \"to\", type: \"address\", internalType: \"address\" },\n { name: \"validAfter\", type: \"uint256\", internalType: \"uint256\" },\n] as const;\n\n/**\n * ABI components for the upto Permit2 witness tuple:\n * Witness(address to, address facilitator, uint256 validAfter).\n */\nconst uptoPermit2WitnessABIComponents = [\n { name: \"to\", type: \"address\", internalType: \"address\" },\n { name: \"facilitator\", type: \"address\", internalType: \"address\" },\n { name: \"validAfter\", type: \"uint256\", internalType: \"uint256\" },\n] as const;\n\n/**\n * x402UptoPermit2Proxy ABI — settle/settleWithPermit for the upto payment scheme.\n * Key differences from exact: settle() takes a `uint256 amount` parameter, and the\n * Witness struct includes an `address facilitator` field.\n */\nexport const x402UptoPermit2ProxyABI = [\n {\n type: \"function\",\n name: \"PERMIT2\",\n inputs: [],\n outputs: [{ name: \"\", type: \"address\", internalType: \"contract ISignatureTransfer\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"WITNESS_TYPEHASH\",\n inputs: [],\n outputs: [{ name: \"\", type: \"bytes32\", internalType: \"bytes32\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"WITNESS_TYPE_STRING\",\n inputs: [],\n outputs: [{ name: \"\", type: \"string\", internalType: \"string\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"settle\",\n inputs: [\n {\n name: \"permit\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n components: [\n {\n name: \"permitted\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.TokenPermissions\",\n components: [\n { name: \"token\", type: \"address\", internalType: \"address\" },\n { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"owner\", type: \"address\", internalType: \"address\" },\n {\n name: \"witness\",\n type: \"tuple\",\n internalType: \"struct x402UptoPermit2Proxy.Witness\",\n components: uptoPermit2WitnessABIComponents,\n },\n { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"settleWithPermit\",\n inputs: [\n {\n name: \"permit2612\",\n type: \"tuple\",\n internalType: \"struct x402UptoPermit2Proxy.EIP2612Permit\",\n components: [\n { name: \"value\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"r\", type: \"bytes32\", internalType: \"bytes32\" },\n { name: \"s\", type: \"bytes32\", internalType: \"bytes32\" },\n { name: \"v\", type: \"uint8\", internalType: \"uint8\" },\n ],\n },\n {\n name: \"permit\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n components: [\n {\n name: \"permitted\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.TokenPermissions\",\n components: [\n { name: \"token\", type: \"address\", internalType: \"address\" },\n { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"owner\", type: \"address\", internalType: \"address\" },\n {\n name: \"witness\",\n type: \"tuple\",\n internalType: \"struct x402UptoPermit2Proxy.Witness\",\n components: uptoPermit2WitnessABIComponents,\n },\n { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n { type: \"event\", name: \"Settled\", inputs: [], anonymous: false },\n { type: \"event\", name: \"SettledWithPermit\", inputs: [], anonymous: false },\n { type: \"error\", name: \"AmountExceedsPermitted\", inputs: [] },\n { type: \"error\", name: \"InvalidDestination\", inputs: [] },\n { type: \"error\", name: \"InvalidOwner\", inputs: [] },\n { type: \"error\", name: \"InvalidPermit2Address\", inputs: [] },\n { type: \"error\", name: \"PaymentTooEarly\", inputs: [] },\n { type: \"error\", name: \"Permit2612AmountMismatch\", inputs: [] },\n { type: \"error\", name: \"ReentrancyGuardReentrantCall\", inputs: [] },\n { type: \"error\", name: \"UnauthorizedFacilitator\", inputs: [] },\n] as const;\n\n/**\n * x402ExactPermit2Proxy ABI - settle function for exact payment scheme.\n */\nexport const x402ExactPermit2ProxyABI = [\n {\n type: \"function\",\n name: \"PERMIT2\",\n inputs: [],\n outputs: [{ name: \"\", type: \"address\", internalType: \"contract ISignatureTransfer\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"WITNESS_TYPEHASH\",\n inputs: [],\n outputs: [{ name: \"\", type: \"bytes32\", internalType: \"bytes32\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"WITNESS_TYPE_STRING\",\n inputs: [],\n outputs: [{ name: \"\", type: \"string\", internalType: \"string\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"settle\",\n inputs: [\n {\n name: \"permit\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n components: [\n {\n name: \"permitted\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.TokenPermissions\",\n components: [\n { name: \"token\", type: \"address\", internalType: \"address\" },\n { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"owner\", type: \"address\", internalType: \"address\" },\n {\n name: \"witness\",\n type: \"tuple\",\n internalType: \"struct x402ExactPermit2Proxy.Witness\",\n components: permit2WitnessABIComponents,\n },\n { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"settleWithPermit\",\n inputs: [\n {\n name: \"permit2612\",\n type: \"tuple\",\n internalType: \"struct x402ExactPermit2Proxy.EIP2612Permit\",\n components: [\n { name: \"value\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"r\", type: \"bytes32\", internalType: \"bytes32\" },\n { name: \"s\", type: \"bytes32\", internalType: \"bytes32\" },\n { name: \"v\", type: \"uint8\", internalType: \"uint8\" },\n ],\n },\n {\n name: \"permit\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n components: [\n {\n name: \"permitted\",\n type: \"tuple\",\n internalType: \"struct ISignatureTransfer.TokenPermissions\",\n components: [\n { name: \"token\", type: \"address\", internalType: \"address\" },\n { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n ],\n },\n { name: \"owner\", type: \"address\", internalType: \"address\" },\n {\n name: \"witness\",\n type: \"tuple\",\n internalType: \"struct x402ExactPermit2Proxy.Witness\",\n components: permit2WitnessABIComponents,\n },\n { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n { type: \"event\", name: \"Settled\", inputs: [], anonymous: false },\n { type: \"event\", name: \"SettledWithPermit\", inputs: [], anonymous: false },\n { type: \"error\", name: \"InvalidAmount\", inputs: [] },\n { type: \"error\", name: \"InvalidDestination\", inputs: [] },\n { type: \"error\", name: \"InvalidOwner\", inputs: [] },\n { type: \"error\", name: \"InvalidPermit2Address\", inputs: [] },\n { type: \"error\", name: \"PaymentTooEarly\", inputs: [] },\n { type: \"error\", name: \"Permit2612AmountMismatch\", inputs: [] },\n { type: \"error\", name: \"ReentrancyGuardReentrantCall\", inputs: [] },\n] as const;\n","import type {\n DefaultAsset,\n DefaultAssetTable,\n FindDefaultAsset,\n GetDefaultAsset,\n Network,\n} from \"@x402/core/types\";\nimport { EVM_NETWORK_CHAIN_ID_MAP } from \"./constants\";\n\n/**\n * Base stablecoin asset configuration shared across all EVM payment schemes.\n * Contains the core fields needed to identify and convert tokens.\n */\nexport type DefaultAssetInfo = DefaultAsset & {\n /** EIP-712 domain name (must match the token's domain separator) */\n name: string;\n /** EIP-712 domain version (must match the token's domain separator) */\n version: string;\n};\n\n/**\n * Extended asset configuration for the exact scheme.\n * Includes transfer method hints that control client-side behaviour.\n */\nexport type ExactDefaultAssetInfo = DefaultAssetInfo & {\n /**\n * Transfer method override: `\"permit2\"` for tokens that don't support EIP-3009.\n * Omit for EIP-3009 tokens (default behaviour).\n */\n assetTransferMethod?: string;\n /**\n * Set to `true` for permit2 tokens that implement EIP-2612 `permit()`.\n * Controls whether name/version are included in `extra` so the client can\n * sign a gasless EIP-2612 permit for Permit2 approval.\n */\n supportsEip2612?: boolean;\n};\n\n/** Default USD-pegged assets by CAIP-2 network; index 0 is the `\"$0.10\"` default. */\nexport const DEFAULT_ASSETS: DefaultAssetTable<ExactDefaultAssetInfo> = {\n \"eip155:8453\": [\n {\n asset: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n name: \"USD Coin\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Base mainnet USDC\n \"eip155:84532\": [\n {\n asset: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Base Sepolia USDC\n \"eip155:1\": [\n {\n asset: \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n name: \"USD Coin\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Ethereum mainnet USDC\n \"eip155:43114\": [\n {\n asset: \"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E\",\n name: \"USD Coin\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Avalanche C-Chain USDC\n \"eip155:4326\": [\n {\n asset: \"0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7\",\n name: \"MegaUSD\",\n version: \"1\",\n decimals: 18,\n symbol: \"MegaUSD\",\n assetTransferMethod: \"permit2\",\n supportsEip2612: true,\n },\n ], // MegaETH mainnet MegaUSD (no EIP-3009, supports EIP-2612)\n \"eip155:143\": [\n {\n asset: \"0x754704Bc059F8C67012fEd69BC8A327a5aafb603\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Monad mainnet USDC\n \"eip155:10143\": [\n {\n asset: \"0x534b2f3A21130d7a60830c2Df862319e593943A3\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Monad testnet USDC\n \"eip155:988\": [\n {\n asset: \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\",\n name: \"USDT0\",\n version: \"1\",\n decimals: 6,\n symbol: \"USDT0\",\n },\n ], // Stable mainnet USDT0\n \"eip155:2201\": [\n {\n asset: \"0x78Cf24370174180738C5B8E352B6D14c83a6c9A9\",\n name: \"USDT0\",\n version: \"1\",\n decimals: 6,\n symbol: \"USDT0\",\n },\n ], // Stable testnet USDT0\n \"eip155:137\": [\n {\n asset: \"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359\",\n name: \"USD Coin\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Polygon mainnet USDC\n \"eip155:42161\": [\n {\n asset: \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n name: \"USD Coin\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Arbitrum One USDC\n \"eip155:421614\": [\n {\n asset: \"0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d\",\n name: \"USD Coin\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Arbitrum Sepolia USDC\n \"eip155:31612\": [\n {\n asset: \"0xdD468A1DDc392dcdbEf6db6e34E89AA338F9F186\",\n name: \"Mezo USD\",\n version: \"1\",\n decimals: 18,\n symbol: \"mUSD\",\n assetTransferMethod: \"permit2\",\n supportsEip2612: true,\n },\n ], // Mezo mainnet mUSD (no EIP-3009, supports EIP-2612)\n \"eip155:31611\": [\n {\n asset: \"0x118917a40FAF1CD7a13dB0Ef56C86De7973Ac503\",\n name: \"Mezo USD\",\n version: \"1\",\n decimals: 18,\n symbol: \"mUSD\",\n assetTransferMethod: \"permit2\",\n supportsEip2612: true,\n },\n ], // Mezo Testnet mUSD (no EIP-3009, supports EIP-2612)\n \"eip155:723487\": [\n {\n asset: \"0x33ad9e4BD16B69B5BFdED37D8B5D9fF9aba014Fb\",\n name: \"Stable Coin\",\n version: \"1\",\n decimals: 6,\n symbol: \"SBC\",\n assetTransferMethod: \"permit2\",\n supportsEip2612: true,\n },\n ], // Radius Network SBC (no EIP-3009, supports EIP-2612)\n \"eip155:72344\": [\n {\n asset: \"0x33ad9e4BD16B69B5BFdED37D8B5D9fF9aba014Fb\",\n name: \"Stable Coin\",\n version: \"1\",\n decimals: 6,\n symbol: \"SBC\",\n assetTransferMethod: \"permit2\",\n supportsEip2612: true,\n },\n ], // Radius Testnet SBC (no EIP-3009, supports EIP-2612)\n \"eip155:36900\": [\n {\n asset: \"0x9cb8142aEBBcdc60AF7c97Af897A67A8f3CA71C2\",\n name: \"USDC.e\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC.e\",\n },\n ], // ADI Chain USDC.e (EIP-3009 supported)\n \"eip155:190415\": [\n {\n asset: \"0x401eCb1D350407f13ba348573E5630B83638E30D\",\n name: \"Bridged USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC.e\",\n },\n ], // HPP mainnet USDC.e\n \"eip155:181228\": [\n {\n asset: \"0x401eCb1D350407f13ba348573E5630B83638E30D\",\n name: \"Bridged USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC.e\",\n },\n ], // HPP Sepolia USDC.e\n \"eip155:50\": [\n {\n asset: \"0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // XDC Network mainnet USDC (Bridged USDC Standard, EIP-3009 supported)\n \"eip155:51\": [\n {\n asset: \"0xb5AB69F7bBada22B28e79C8FFAECe55eF1c771D4\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // XDC Apothem testnet USDC (Bridged USDC Standard, EIP-3009 supported)\n \"eip155:38833\": [\n {\n asset: \"0xA5b8BF902b2844dA17d4506cc827F7F1681735E7\",\n name: \"USDC\",\n version: \"1\",\n decimals: 6,\n symbol: \"USDC\",\n assetTransferMethod: \"permit2\",\n },\n ], // Igra mainnet USDC (no EIP-3009, no EIP-2612)\n \"eip155:14\": [\n {\n asset: \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\",\n name: \"USD\\u20AE0\",\n version: \"1\",\n decimals: 6,\n symbol: \"USDT0\",\n },\n ], // Flare mainnet USD₮0 (EIP-3009 supported)\n \"eip155:42220\": [\n {\n asset: \"0xcebA9300f2b948710d2653dD7B07f33A8B32118C\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n {\n asset: \"0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e\",\n name: \"Tether USD\",\n version: \"1\",\n decimals: 6,\n symbol: \"USDT\",\n },\n {\n asset: \"0xD2ab3C9A02DBBAB236BfEC45D1d755DF4267F771\",\n name: \"Tether America USD\",\n version: \"1\",\n decimals: 6,\n symbol: \"USAT\",\n },\n ], // Celo mainnet USDC, USDT, USAT (EIP-3009 supported)\n \"eip155:11142220\": [\n {\n asset: \"0x01C5C0122039549AD1493B8220cABEdD739BC44E\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Celo Sepolia testnet USDC (EIP-3009 supported)\n \"eip155:1329\": [\n {\n asset: \"0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Sei mainnet USDC (EIP-3009 supported)\n \"eip155:1328\": [\n {\n asset: \"0x4fCF1784B31630811181f670Aea7A7bEF803eaED\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Sei testnet USDC (EIP-3009 supported)\n \"eip155:5042\": [\n {\n asset: \"0x3600000000000000000000000000000000000000\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Arc mainnet USDC (EIP-3009 supported)\n \"eip155:5042002\": [\n {\n asset: \"0x3600000000000000000000000000000000000000\",\n name: \"USDC\",\n version: \"2\",\n decimals: 6,\n symbol: \"USDC\",\n },\n ], // Arc Testnet USDC (EIP-3009 supported)\n};\n\n/**\n * Map CAIP-2 or v1 legacy name to a {@link DEFAULT_ASSETS} key.\n *\n * @param network - CAIP-2 or legacy EVM network id\n * @returns Normalized CAIP-2 network key\n */\nfunction resolveNetworkKey(network: Network): string {\n if (network in DEFAULT_ASSETS) {\n return network;\n }\n const chainId = EVM_NETWORK_CHAIN_ID_MAP[network as keyof typeof EVM_NETWORK_CHAIN_ID_MAP];\n if (chainId !== undefined) {\n return `eip155:${chainId}`;\n }\n return network;\n}\n\n/**\n * Look up a default asset by network and optional ticker.\n *\n * @param network - CAIP-2 or v1 network\n * @param symbol - Ticker; omit for the network default\n * @returns Matching entry\n * @throws If network or ticker is unknown\n */\nexport const getDefaultAsset: GetDefaultAsset<ExactDefaultAssetInfo> = (network, symbol?) => {\n const key = resolveNetworkKey(network);\n const assets = DEFAULT_ASSETS[key];\n if (!assets || assets.length === 0) {\n throw new Error(`No default asset configured for network ${network}`);\n }\n if (!symbol) {\n return assets[0];\n }\n const normalized = symbol.toUpperCase();\n const match = assets.find(entry => entry.symbol.toUpperCase() === normalized);\n if (!match) {\n throw new Error(`No ${symbol} default asset configured for network ${network}`);\n }\n return match;\n};\n\n/**\n * Reverse lookup by asset id (case-insensitive) and network.\n *\n * @param asset - Asset address from payment requirements\n * @param network - CAIP-2 or v1 network\n * @returns Matching entry, or undefined\n */\nexport const findDefaultAsset: FindDefaultAsset<ExactDefaultAssetInfo> = (asset, network) => {\n const key = resolveNetworkKey(network);\n const assets = DEFAULT_ASSETS[key];\n if (!assets) {\n return undefined;\n }\n const normalized = asset.toLowerCase();\n return assets.find(entry => entry.asset.toLowerCase() === normalized);\n};\n","import { getAddress, isAddress, isAddressEqual, keccak256, toBytes } from \"viem\";\n\n// Scheme identifier for the auth-capture payment scheme.\nexport const AUTH_CAPTURE_SCHEME = \"auth-capture\" as const;\n\n// Canonical AuthCaptureEscrow + token collector deployments from\n// base/commerce-payments (https://github.com/base/commerce-payments). These are\n// the audited, live addresses listed in the upstream README and are the source\n// of truth for this scheme. They are universal constants, not configurable per\n// merchant. Two CREATE2 sets are specified; default exports point at v1.1.\nexport type AuthCaptureDeploymentVersion = \"v1.0\" | \"v1.1\";\n\nexport type AuthCaptureDeployment = {\n version: AuthCaptureDeploymentVersion;\n escrow: `0x${string}`;\n eip3009Collector: `0x${string}`;\n permit2Collector: `0x${string}`;\n operatorRefundCollector: `0x${string}`;\n};\n\n// commerce-payments v1.0 (tag v1.0.0)\nexport const AUTH_CAPTURE_ESCROW_V1_0_ADDRESS =\n \"0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff\" as const satisfies `0x${string}`;\nexport const EIP3009_TOKEN_COLLECTOR_V1_0_ADDRESS =\n \"0x0E3dF9510de65469C4518D7843919c0b8C7A7757\" as const satisfies `0x${string}`;\nexport const PERMIT2_TOKEN_COLLECTOR_V1_0_ADDRESS =\n \"0x992476B9Ee81d52a5BdA0622C333938D0Af0aB26\" as const satisfies `0x${string}`;\nexport const OPERATOR_REFUND_COLLECTOR_V1_0_ADDRESS =\n \"0x934907bffd0901b6A21e398B9C53A4A38F02fa5d\" as const satisfies `0x${string}`;\n\n// commerce-payments v1.1 (default)\nexport const AUTH_CAPTURE_ESCROW_V1_1_ADDRESS =\n \"0xf96815976523E00e65Be8f34cA5e64b4f41EB19c\" as const satisfies `0x${string}`;\nexport const EIP3009_TOKEN_COLLECTOR_V1_1_ADDRESS =\n \"0x8612dfdc421f80336cd14E8EF9cb1E765dB5ab88\" as const satisfies `0x${string}`;\nexport const PERMIT2_TOKEN_COLLECTOR_V1_1_ADDRESS =\n \"0xD69831Aed5bfe262067ec4c751f4F830EcdD446e\" as const satisfies `0x${string}`;\nexport const OPERATOR_REFUND_COLLECTOR_V1_1_ADDRESS =\n \"0x7a03443724d14798c4AB4622F1DAAcA761Fea486\" as const satisfies `0x${string}`;\n\n/** Default deployment aliases (v1.1). */\nexport const AUTH_CAPTURE_ESCROW_ADDRESS = AUTH_CAPTURE_ESCROW_V1_1_ADDRESS;\nexport const EIP3009_TOKEN_COLLECTOR_ADDRESS = EIP3009_TOKEN_COLLECTOR_V1_1_ADDRESS;\nexport const PERMIT2_TOKEN_COLLECTOR_ADDRESS = PERMIT2_TOKEN_COLLECTOR_V1_1_ADDRESS;\nexport const OPERATOR_REFUND_COLLECTOR_ADDRESS = OPERATOR_REFUND_COLLECTOR_V1_1_ADDRESS;\n\nexport const AUTH_CAPTURE_DEPLOYMENT_V1_0: AuthCaptureDeployment = {\n version: \"v1.0\",\n escrow: AUTH_CAPTURE_ESCROW_V1_0_ADDRESS,\n eip3009Collector: EIP3009_TOKEN_COLLECTOR_V1_0_ADDRESS,\n permit2Collector: PERMIT2_TOKEN_COLLECTOR_V1_0_ADDRESS,\n operatorRefundCollector: OPERATOR_REFUND_COLLECTOR_V1_0_ADDRESS,\n};\n\nexport const AUTH_CAPTURE_DEPLOYMENT_V1_1: AuthCaptureDeployment = {\n version: \"v1.1\",\n escrow: AUTH_CAPTURE_ESCROW_V1_1_ADDRESS,\n eip3009Collector: EIP3009_TOKEN_COLLECTOR_V1_1_ADDRESS,\n permit2Collector: PERMIT2_TOKEN_COLLECTOR_V1_1_ADDRESS,\n operatorRefundCollector: OPERATOR_REFUND_COLLECTOR_V1_1_ADDRESS,\n};\n\n/**\n * Resolve the commerce-payments deployment from optional `extra.authCaptureEscrow`.\n * Absent or the v1.1 escrow selects v1.1; the v1.0 escrow selects v1.0.\n *\n * @param escrow - Optional escrow address from extra (`authCaptureEscrow`).\n * @returns Known v1.0 or v1.1 deployment, or undefined when the address is unknown.\n */\nexport function resolveAuthCaptureDeployment(escrow?: string): AuthCaptureDeployment | undefined {\n if (escrow === undefined || escrow === \"\") {\n return AUTH_CAPTURE_DEPLOYMENT_V1_1;\n }\n if (!isAddress(escrow)) {\n return undefined;\n }\n const normalized = getAddress(escrow);\n if (\n isAddressEqual(normalized, AUTH_CAPTURE_ESCROW_V1_1_ADDRESS) ||\n isAddressEqual(normalized, AUTH_CAPTURE_ESCROW_ADDRESS)\n ) {\n return AUTH_CAPTURE_DEPLOYMENT_V1_1;\n }\n if (isAddressEqual(normalized, AUTH_CAPTURE_ESCROW_V1_0_ADDRESS)) {\n return AUTH_CAPTURE_DEPLOYMENT_V1_0;\n }\n return undefined;\n}\n\n/** Default max gas for a custom-operator collect relay (`authorize` or `charge`). */\nexport const DEFAULT_CUSTOM_OPERATOR_AUTHORIZE_GAS_LIMIT = 1_000_000n;\n\n// Domain tag for the bound-salt derivation. Encoded as the first word of\n// `abi.encode(SALT_BINDING_TYPEHASH, receiverAuthorizer, policy, saltNonce)`\n// so a value produced as a salt commitment can never be read as a signature nonce.\nexport const SALT_BINDING_TYPEHASH = keccak256(\n toBytes(\n \"x402AuthCaptureSaltBinding(address receiverAuthorizer,address policy,uint256 saltNonce)\",\n ),\n);\n\n// Shared EIP-712 domain for every operator type. `verifyingContract` is the\n// capture authorizer (PaymentInfo.operator), not a scheme-wide address.\nexport const OPERATOR_EIP712_DOMAIN = {\n name: \"x402 Auth Capture Operator\",\n version: \"1\",\n} as const;\n\n// ERC-3009 ReceiveWithAuthorization EIP-712 types\nexport const RECEIVE_AUTHORIZATION_TYPES = {\n ReceiveWithAuthorization: [\n { name: \"from\", type: \"address\" },\n { name: \"to\", type: \"address\" },\n { name: \"value\", type: \"uint256\" },\n { name: \"validAfter\", type: \"uint256\" },\n { name: \"validBefore\", type: \"uint256\" },\n { name: \"nonce\", type: \"bytes32\" },\n ],\n} as const;\n\n// Uniswap Permit2 PermitTransferFrom EIP-712 types\nexport const PERMIT2_TRANSFER_FROM_TYPES = {\n PermitTransferFrom: [\n { name: \"permitted\", type: \"TokenPermissions\" },\n { name: \"spender\", type: \"address\" },\n { name: \"nonce\", type: \"uint256\" },\n { name: \"deadline\", type: \"uint256\" },\n ],\n TokenPermissions: [\n { name: \"token\", type: \"address\" },\n { name: \"amount\", type: \"uint256\" },\n ],\n} as const;\n\n// Operator EIP-712 types for facilitator-relayed charge and lifecycle.\n// v1.0 operator EIP-712 types (feeBps on charge/capture).\nexport const CHARGE_TYPES_V1_0 = {\n Charge: [\n { name: \"paymentInfoHash\", type: \"bytes32\" },\n { name: \"amount\", type: \"uint256\" },\n { name: \"tokenCollector\", type: \"address\" },\n { name: \"collectorDataHash\", type: \"bytes32\" },\n { name: \"feeBps\", type: \"uint16\" },\n { name: \"feeReceiver\", type: \"address\" },\n ],\n} as const;\n\nexport const CAPTURE_TYPES_V1_0 = {\n Capture: [\n { name: \"paymentInfoHash\", type: \"bytes32\" },\n { name: \"amount\", type: \"uint256\" },\n { name: \"feeBps\", type: \"uint16\" },\n { name: \"feeReceiver\", type: \"address\" },\n { name: \"expectedCapturableAmount\", type: \"uint256\" },\n { name: \"expectedRefundableAmount\", type: \"uint256\" },\n ],\n} as const;\n\n// v1.1 operator EIP-712 types (absolute feeAmount on charge/capture).\nexport const CHARGE_TYPES_V1_1 = {\n Charge: [\n { name: \"paymentInfoHash\", type: \"bytes32\" },\n { name: \"amount\", type: \"uint256\" },\n { name: \"tokenCollector\", type: \"address\" },\n { name: \"collectorDataHash\", type: \"bytes32\" },\n { name: \"feeAmount\", type: \"uint256\" },\n { name: \"feeReceiver\", type: \"address\" },\n ],\n} as const;\n\nexport const CAPTURE_TYPES_V1_1 = {\n Capture: [\n { name: \"paymentInfoHash\", type: \"bytes32\" },\n { name: \"amount\", type: \"uint256\" },\n { name: \"feeAmount\", type: \"uint256\" },\n { name: \"feeReceiver\", type: \"address\" },\n { name: \"expectedCapturableAmount\", type: \"uint256\" },\n { name: \"expectedRefundableAmount\", type: \"uint256\" },\n ],\n} as const;\n\n/** Default v1.1 charge/capture EIP-712 types. */\nexport const CHARGE_TYPES = CHARGE_TYPES_V1_1;\nexport const CAPTURE_TYPES = CAPTURE_TYPES_V1_1;\n\nexport const VOID_TYPES = {\n Void: [{ name: \"paymentInfoHash\", type: \"bytes32\" }],\n} as const;\n\nexport const REFUND_TYPES = {\n Refund: [\n { name: \"paymentInfoHash\", type: \"bytes32\" },\n { name: \"amount\", type: \"uint256\" },\n { name: \"tokenCollector\", type: \"address\" },\n { name: \"expectedCapturableAmount\", type: \"uint256\" },\n { name: \"expectedRefundableAmount\", type: \"uint256\" },\n ],\n} as const;\n\n/**\n * Operator Charge EIP-712 types for a resolved deployment.\n *\n * @param deployment - Resolved escrow addresses and version.\n * @returns Charge typed-data fields matching the deployment fee encoding.\n */\nexport function chargeTypesForDeployment(deployment: AuthCaptureDeployment) {\n return deployment.version === \"v1.0\" ? CHARGE_TYPES_V1_0 : CHARGE_TYPES_V1_1;\n}\n\n/**\n * Operator Capture EIP-712 types for a resolved deployment.\n *\n * @param deployment - Resolved escrow addresses and version.\n * @returns Capture typed-data fields matching the deployment fee encoding.\n */\nexport function captureTypesForDeployment(deployment: AuthCaptureDeployment) {\n return deployment.version === \"v1.0\" ? CAPTURE_TYPES_V1_0 : CAPTURE_TYPES_V1_1;\n}\n\n/**\n * Integer fee from amount and bps (same division the escrow uses).\n *\n * @param amount - Principal amount in atomic token units.\n * @param feeBps - Fee in basis points.\n * @returns Absolute fee amount using escrow integer division.\n */\nexport function feeAmountFromBps(amount: bigint, feeBps: number): bigint {\n return (amount * BigInt(feeBps)) / 10_000n;\n}\n","/**\n * AuthCapture Scheme - Client\n * Builds payment payloads for auth-capture payments.\n *\n * Implements x402's SchemeNetworkClient interface so it can be registered\n * on an x402Client via client.register('eip155:84532', new AuthCaptureEvmScheme(signer)).\n */\n\nimport type {\n PaymentPayloadContext,\n PaymentPayloadResult,\n PaymentRequirements,\n SchemeNetworkClient,\n} from \"@x402/core/types\";\nimport type { ClientEvmSigner } from \"../../signer\";\nimport { hexToBigInt } from \"viem\";\nimport { AUTH_CAPTURE_SCHEME, resolveAuthCaptureDeployment } from \"../constants\";\nimport {\n computePayerAgnosticPaymentInfoHash,\n deriveBoundSalt,\n extraAddress,\n generateSalt,\n isSaltBindingOn,\n signERC3009,\n signPermit2,\n} from \"../nonce\";\nimport type { AuthCaptureExtra, Eip3009Payload, PaymentInfoStruct, Permit2Payload } from \"../types\";\nimport { findDefaultAsset } from \"../../defaultAssets\";\nimport { getEvmChainId } from \"../../utils\";\n\n/**\n * Client-side implementation of the auth-capture scheme: derives the canonical\n * payer-agnostic PaymentInfo hash, signs an ERC-3009 ReceiveWithAuthorization\n * (default) or a Permit2 PermitTransferFrom against it, and returns a wire\n * payload the facilitator can settle. Implements `SchemeNetworkClient`.\n */\nexport class AuthCaptureEvmScheme implements SchemeNetworkClient {\n readonly scheme = AUTH_CAPTURE_SCHEME;\n findDefaultAsset = findDefaultAsset;\n\n /**\n * Construct a client-side auth-capture scheme bound to a specific signer.\n *\n * @param signer - Client-side signer that exposes `address` and `signTypedData`.\n */\n constructor(private readonly signer: ClientEvmSigner) {}\n\n /**\n * Build and sign an auth-capture payment payload for the given requirements.\n * Validates all spec-mandated `extra` fields and the asset-transfer method\n * (default `eip3009`, alternative `permit2`), reconstructs the on-chain\n * PaymentInfo struct, computes its payer-agnostic hash, and returns the\n * signed wire payload.\n *\n * @param x402Version - Wire protocol version; only `2` is supported.\n * @param requirements - Resource server's payment requirements (includes scheme `extra`).\n * @param _ - Unused FacilitatorContext (interface compatibility).\n * @returns The signed wire payload tagged with the x402 protocol version.\n * @throws If `x402Version !== 2` or any required `extra` field is missing.\n */\n async createPaymentPayload(\n x402Version: number,\n requirements: PaymentRequirements,\n _?: PaymentPayloadContext,\n ): Promise<PaymentPayloadResult> {\n if (x402Version !== 2) {\n throw new Error(`Unsupported x402Version: ${x402Version}. Only version 2 is supported.`);\n }\n\n const extra = requirements.extra as unknown as AuthCaptureExtra;\n\n // Validate required EIP-712 token-domain parameters\n if (!extra.name) {\n throw new Error(\n `EIP-712 domain parameter 'name' is required in payment requirements for asset ${requirements.asset}`,\n );\n }\n if (!extra.version) {\n throw new Error(\n `EIP-712 domain parameter 'version' is required in payment requirements for asset ${requirements.asset}`,\n );\n }\n if (!extra.captureAuthorizer) {\n throw new Error(`'captureAuthorizer' is required in payment requirements extra`);\n }\n if (!extra.feeRecipient) {\n throw new Error(`'feeRecipient' is required in payment requirements extra`);\n }\n if (typeof extra.captureDeadline !== \"number\") {\n throw new Error(`'captureDeadline' is required in payment requirements extra`);\n }\n if (typeof extra.refundDeadline !== \"number\") {\n throw new Error(`'refundDeadline' is required in payment requirements extra`);\n }\n if (typeof extra.minFeeBps !== \"number\") {\n throw new Error(`'minFeeBps' is required in payment requirements extra`);\n }\n if (typeof extra.maxFeeBps !== \"number\") {\n throw new Error(`'maxFeeBps' is required in payment requirements extra`);\n }\n if (typeof requirements.maxTimeoutSeconds !== \"number\") {\n throw new Error(\n `'maxTimeoutSeconds' is required in PaymentRequirements (used to derive preApprovalExpiry)`,\n );\n }\n\n const chainId = getEvmChainId(requirements.network);\n const deployment = resolveAuthCaptureDeployment(extra.authCaptureEscrow);\n if (!deployment) {\n throw new Error(`Invalid authCaptureEscrow in payment requirements extra`);\n }\n const maxAmount = requirements.amount;\n const nowSeconds = Math.floor(Date.now() / 1000);\n const preApprovalExpiry = nowSeconds + requirements.maxTimeoutSeconds;\n const assetTransferMethod = extra.assetTransferMethod ?? \"eip3009\";\n\n const bindOn = isSaltBindingOn(extra);\n const saltNonce = generateSalt();\n const salt = bindOn\n ? deriveBoundSalt(\n extraAddress(extra.receiverAuthorizer),\n extraAddress(extra.policy),\n saltNonce,\n )\n : saltNonce;\n\n // Build the canonical PaymentInfo struct (Solidity field names — do not rename).\n const paymentInfo: PaymentInfoStruct = {\n operator: extra.captureAuthorizer,\n payer: this.signer.address,\n receiver: requirements.payTo as `0x${string}`,\n token: requirements.asset as `0x${string}`,\n maxAmount,\n preApprovalExpiry,\n authorizationExpiry: extra.captureDeadline,\n refundExpiry: extra.refundDeadline,\n minFeeBps: extra.minFeeBps,\n maxFeeBps: extra.maxFeeBps,\n feeReceiver: extra.feeRecipient,\n salt,\n };\n\n // Payer-agnostic PaymentInfo hash — used as ERC-3009 nonce or Permit2 nonce.\n const nonce = computePayerAgnosticPaymentInfoHash(chainId, paymentInfo, deployment.escrow);\n\n if (assetTransferMethod === \"permit2\") {\n const permit2Authorization: Permit2Payload[\"permit2Authorization\"] = {\n from: this.signer.address,\n permitted: {\n token: requirements.asset as `0x${string}`,\n amount: maxAmount,\n },\n spender: deployment.permit2Collector,\n nonce: hexToBigInt(nonce).toString(),\n deadline: String(preApprovalExpiry),\n };\n const signature = await signPermit2(this.signer, permit2Authorization, chainId);\n const payload: Permit2Payload = bindOn\n ? { permit2Authorization, signature, salt, saltNonce }\n : { permit2Authorization, signature, salt };\n return { x402Version, payload: payload as unknown as Record<string, unknown> };\n }\n\n // Default: EIP-3009 ReceiveWithAuthorization to the canonical EIP-3009 token collector.\n const authorization: Eip3009Payload[\"authorization\"] = {\n from: this.signer.address,\n to: deployment.eip3009Collector,\n value: maxAmount,\n validAfter: \"0\",\n validBefore: String(preApprovalExpiry),\n nonce,\n };\n const signature = await signERC3009(\n this.signer,\n authorization,\n extra,\n requirements.asset as `0x${string}`,\n chainId,\n );\n const payload: Eip3009Payload = bindOn\n ? { authorization, signature, salt, saltNonce }\n : { authorization, signature, salt };\n return { x402Version, payload: payload as unknown as Record<string, unknown> };\n }\n}\n","/**\n * Nonce computation, salt generation, and signing helpers.\n */\n\nimport {\n encodeAbiParameters,\n getAddress,\n isAddress,\n isAddressEqual,\n keccak256,\n toHex,\n zeroAddress,\n} from \"viem\";\nimport type { ClientEvmSigner, FacilitatorEvmSigner } from \"../signer\";\nimport { verifyTypedDataSignature } from \"../shared/verifySignature\";\nimport { PERMIT2_ADDRESS } from \"../constants\";\nimport {\n AUTH_CAPTURE_ESCROW_ADDRESS,\n PERMIT2_TRANSFER_FROM_TYPES,\n RECEIVE_AUTHORIZATION_TYPES,\n SALT_BINDING_TYPEHASH,\n} from \"./constants\";\nimport type { AuthCaptureExtra, Eip3009Payload, PaymentInfoStruct, Permit2Payload } from \"./types\";\n\n/**\n * PaymentInfo typehash — must match AuthCaptureEscrow.PAYMENT_INFO_TYPEHASH.\n */\nconst PAYMENT_INFO_TYPEHASH = keccak256(\n new TextEncoder().encode(\n \"PaymentInfo(address operator,address payer,address receiver,address token,uint120 maxAmount,uint48 preApprovalExpiry,uint48 authorizationExpiry,uint48 refundExpiry,uint16 minFeeBps,uint16 maxFeeBps,address feeReceiver,uint256 salt)\",\n ),\n);\n\n/**\n * Encode PaymentInfo the way AuthCaptureEscrow.getHash does: typehash plus\n * struct fields, then wrap with chain id and escrow address.\n *\n * @param chainId - EVM chain id; binds the hash to a specific chain.\n * @param paymentInfo - Canonical PaymentInfo struct.\n * @param payer - Payer encoded in the struct hash. Pass `zeroAddress` for the\n * payer-agnostic signature nonce.\n * @param escrowAddress - AuthCaptureEscrow bound into the outer hash.\n * @returns The 32-byte hash.\n */\nfunction hashPaymentInfo(\n chainId: number,\n paymentInfo: PaymentInfoStruct,\n payer: `0x${string}`,\n escrowAddress: `0x${string}` = AUTH_CAPTURE_ESCROW_ADDRESS,\n): `0x${string}` {\n const paymentInfoEncoded = encodeAbiParameters(\n [\n { name: \"typehash\", type: \"bytes32\" },\n { name: \"operator\", type: \"address\" },\n { name: \"payer\", type: \"address\" },\n { name: \"receiver\", type: \"address\" },\n { name: \"token\", type: \"address\" },\n { name: \"maxAmount\", type: \"uint120\" },\n { name: \"preApprovalExpiry\", type: \"uint48\" },\n { name: \"authorizationExpiry\", type: \"uint48\" },\n { name: \"refundExpiry\", type: \"uint48\" },\n { name: \"minFeeBps\", type: \"uint16\" },\n { name: \"maxFeeBps\", type: \"uint16\" },\n { name: \"feeReceiver\", type: \"address\" },\n { name: \"salt\", type: \"uint256\" },\n ],\n [\n PAYMENT_INFO_TYPEHASH,\n paymentInfo.operator,\n payer,\n paymentInfo.receiver,\n paymentInfo.token,\n BigInt(paymentInfo.maxAmount),\n paymentInfo.preApprovalExpiry,\n paymentInfo.authorizationExpiry,\n paymentInfo.refundExpiry,\n paymentInfo.minFeeBps,\n paymentInfo.maxFeeBps,\n paymentInfo.feeReceiver,\n BigInt(paymentInfo.salt),\n ],\n );\n const paymentInfoHash = keccak256(paymentInfoEncoded);\n\n const outerEncoded = encodeAbiParameters(\n [\n { name: \"chainId\", type: \"uint256\" },\n { name: \"escrow\", type: \"address\" },\n { name: \"paymentInfoHash\", type: \"bytes32\" },\n ],\n [BigInt(chainId), escrowAddress, paymentInfoHash],\n );\n\n return keccak256(outerEncoded);\n}\n\n/**\n * Compute the payer-agnostic PaymentInfo hash that auth-capture uses as both\n * the ERC-3009 nonce (`bytes32`) and the Permit2 nonce (`uint256`, via the\n * same 32 bytes interpreted as an integer). The payer field is zeroed before\n * hashing so the facilitator can reconstruct the same hash on the verify side\n * without knowing payer identity in advance.\n *\n * Freshness comes from `paymentInfo.salt`; generate a new salt per signing\n * call via `generateSalt`. Identical extras + same salt would collide across\n * payers.\n *\n * @param chainId - EVM chain id; binds the hash to a specific chain.\n * @param paymentInfo - The reconstructed PaymentInfo struct (canonical Solidity field names).\n * @param escrowAddress - AuthCaptureEscrow bound into the outer hash.\n * @returns The 32-byte hash to use as the nonce on the wire.\n */\nexport function computePayerAgnosticPaymentInfoHash(\n chainId: number,\n paymentInfo: PaymentInfoStruct,\n escrowAddress: `0x${string}` = AUTH_CAPTURE_ESCROW_ADDRESS,\n): `0x${string}` {\n return hashPaymentInfo(chainId, paymentInfo, zeroAddress, escrowAddress);\n}\n\n/**\n * Compute AuthCaptureEscrow.getHash(paymentInfo) locally. Differs from the\n * signature nonce by encoding the real payer rather than address(0).\n *\n * @param chainId - EVM chain id.\n * @param paymentInfo - PaymentInfo with the real payer.\n * @param escrowAddress - AuthCaptureEscrow bound into the outer hash.\n * @returns The escrow payment identifier (`paymentInfoHash`).\n */\nexport function computePaymentInfoHash(\n chainId: number,\n paymentInfo: PaymentInfoStruct,\n escrowAddress: `0x${string}` = AUTH_CAPTURE_ESCROW_ADDRESS,\n): `0x${string}` {\n return hashPaymentInfo(chainId, paymentInfo, paymentInfo.payer, escrowAddress);\n}\n\n/**\n * Sign an ERC-3009 `ReceiveWithAuthorization` over the supplied authorization\n * fields. The EIP-712 domain is bound to the **token contract** (not the\n * escrow), so the token's `name` and `version` come from `extra` because they\n * vary per asset (e.g. `\"USDC\"` on Sepolia vs `\"USD Coin\"` on mainnet).\n *\n * @param signer - Client signer with `signTypedData`.\n * @param authorization - The ERC-3009 authorization to sign.\n * @param extra - Carries the token EIP-712 domain `name` + `version`.\n * @param tokenAddress - Address of the token contract (verifyingContract in the domain).\n * @param chainId - EVM chain id (chainId in the domain).\n * @returns The 65-byte ECDSA signature (or EIP-1271 / EIP-6492 envelope, depending on the signer).\n */\nexport async function signERC3009(\n signer: ClientEvmSigner,\n authorization: Eip3009Payload[\"authorization\"],\n extra: AuthCaptureExtra,\n tokenAddress: `0x${string}`,\n chainId: number,\n): Promise<`0x${string}`> {\n const domain = {\n name: extra.name,\n version: extra.version,\n chainId,\n verifyingContract: getAddress(tokenAddress),\n };\n\n const message = {\n from: getAddress(authorization.from),\n to: getAddress(authorization.to),\n value: BigInt(authorization.value),\n validAfter: BigInt(authorization.validAfter),\n validBefore: BigInt(authorization.validBefore),\n nonce: authorization.nonce,\n };\n\n return signer.signTypedData({\n domain,\n types: RECEIVE_AUTHORIZATION_TYPES,\n primaryType: \"ReceiveWithAuthorization\",\n message,\n });\n}\n\n/**\n * Verify an ERC-3009 `ReceiveWithAuthorization` signature against the supplied\n * authorization fields. Mirrors `signERC3009`: the EIP-712 domain is bound to\n * the **token contract**, with `name`/`version` from `extra`.\n *\n * Routed through {@link verifyTypedDataSignature} rather than\n * `signer.verifyTypedData` so pre-verify matches on-chain SignatureChecker\n * semantics: no ECDSA fallback when EIP-1271 returns failure, which otherwise\n * accepts signatures the token contract rejects for any payer with code.\n *\n * @param signer - Facilitator signer used for `eth_getCode` / `isValidSignature`.\n * @param authorization - The ERC-3009 authorization to verify.\n * @param signature - The signature blob from the payer.\n * @param extra - Carries the token EIP-712 domain `name`, `version`, and the chain id.\n * @param tokenAddress - Address of the token contract (verifyingContract in the domain).\n * @returns True if the signature is valid for `authorization.from`; false otherwise.\n */\nexport async function verifyERC3009Signature(\n signer: FacilitatorEvmSigner,\n authorization: Eip3009Payload[\"authorization\"],\n signature: `0x${string}`,\n extra: AuthCaptureExtra & { chainId: number },\n tokenAddress: `0x${string}`,\n): Promise<boolean> {\n return verifyTypedDataSignature(signer, {\n address: getAddress(authorization.from),\n domain: {\n name: extra.name,\n version: extra.version,\n chainId: extra.chainId,\n verifyingContract: getAddress(tokenAddress),\n },\n types: RECEIVE_AUTHORIZATION_TYPES,\n primaryType: \"ReceiveWithAuthorization\",\n message: {\n from: getAddress(authorization.from),\n to: getAddress(authorization.to),\n value: BigInt(authorization.value),\n validAfter: BigInt(authorization.validAfter),\n validBefore: BigInt(authorization.validBefore),\n nonce: authorization.nonce,\n },\n signature,\n });\n}\n\n/**\n * Sign a Permit2 `PermitTransferFrom` over the supplied permit fields. Domain\n * is bound to the canonical Permit2 contract. No witness struct is needed —\n * the deterministic nonce (the payer-agnostic PaymentInfo hash, packed into\n * uint256) cryptographically binds all payment parameters including receiver,\n * amount, and deadlines.\n *\n * @param signer - Client signer with `signTypedData`.\n * @param permit - The Permit2 PermitTransferFrom message to sign.\n * @param chainId - EVM chain id (chainId in the Permit2 domain).\n * @returns The 65-byte ECDSA signature (or EIP-1271 / EIP-6492 envelope, depending on the signer).\n */\nexport async function signPermit2(\n signer: ClientEvmSigner,\n permit: Permit2Payload[\"permit2Authorization\"],\n chainId: number,\n): Promise<`0x${string}`> {\n const domain = {\n name: \"Permit2\",\n chainId,\n verifyingContract: PERMIT2_ADDRESS,\n };\n\n const message = {\n permitted: {\n token: getAddress(permit.permitted.token),\n amount: BigInt(permit.permitted.amount),\n },\n spender: getAddress(permit.spender),\n nonce: BigInt(permit.nonce),\n deadline: BigInt(permit.deadline),\n };\n\n return signer.signTypedData({\n domain,\n types: PERMIT2_TRANSFER_FROM_TYPES,\n primaryType: \"PermitTransferFrom\",\n message,\n });\n}\n\n/**\n * Verify a Permit2 `PermitTransferFrom` signature against the supplied permit\n * fields. Mirrors `signPermit2`: domain bound to the canonical Permit2\n * contract. Routed through {@link verifyTypedDataSignature} so pre-verify\n * matches Permit2's own `SignatureVerification` semantics.\n *\n * @param signer - Facilitator signer used for `eth_getCode` / `isValidSignature`.\n * @param permit - The Permit2 PermitTransferFrom message to verify.\n * @param signature - The signature blob from the payer.\n * @param chainId - EVM chain id (chainId in the Permit2 domain).\n * @returns True if the signature is valid for `permit.from`; false otherwise.\n */\nexport async function verifyPermit2Signature(\n signer: FacilitatorEvmSigner,\n permit: Permit2Payload[\"permit2Authorization\"],\n signature: `0x${string}`,\n chainId: number,\n): Promise<boolean> {\n return verifyTypedDataSignature(signer, {\n address: getAddress(permit.from),\n domain: {\n name: \"Permit2\",\n chainId,\n verifyingContract: PERMIT2_ADDRESS,\n },\n types: PERMIT2_TRANSFER_FROM_TYPES,\n primaryType: \"PermitTransferFrom\",\n message: {\n permitted: {\n token: getAddress(permit.permitted.token),\n amount: BigInt(permit.permitted.amount),\n },\n spender: getAddress(permit.spender),\n nonce: BigInt(permit.nonce),\n deadline: BigInt(permit.deadline),\n },\n signature,\n });\n}\n\n/**\n * Generate a fresh cryptographically-random 32-byte salt. MUST be called once\n * per signing request — never reuse across requests. Freshness is required\n * because the nonce derivation zeroes the payer field; identical extras with\n * the same salt would collide across payers.\n *\n * @returns A new 32-byte salt as a `0x`-prefixed hex string.\n */\nexport function generateSalt(): `0x${string}` {\n const bytes = new Uint8Array(32);\n crypto.getRandomValues(bytes);\n return toHex(bytes);\n}\n\n/**\n * Zero-pad a 0x-prefixed hex integer to a full 32-byte word.\n *\n * @param value - Hex string, with or without `0x`.\n * @returns 66-character `0x`-prefixed hex.\n */\nexport function normalizeBytes32(value: string): `0x${string}` {\n const hex = value.startsWith(\"0x\") || value.startsWith(\"0X\") ? value.slice(2) : value;\n if (!/^[0-9a-fA-F]+$/.test(hex) || hex.length === 0 || hex.length > 64) {\n throw new Error(`Invalid bytes32: ${value}`);\n }\n return `0x${hex.padStart(64, \"0\").toLowerCase()}` as `0x${string}`;\n}\n\n/**\n * Treat absent or invalid values as the zero address; otherwise checksum.\n *\n * @param value - Candidate address from extra or config.\n * @returns Checksummed address, or the zero address when absent.\n */\nexport function extraAddress(value: string | undefined): `0x${string}` {\n if (!value || !isAddress(value)) return zeroAddress;\n return getAddress(value);\n}\n\n/**\n * Whether `value` is a non-zero EVM address.\n *\n * @param value - Candidate address.\n * @returns True when `value` is a valid address other than address(0).\n */\nexport function isNonZeroAddress(value: string | undefined): boolean {\n if (!value || !isAddress(value)) return false;\n return !isAddressEqual(getAddress(value), zeroAddress);\n}\n\n/**\n * Salt binding is on when either `receiverAuthorizer` or `policy` is non-zero.\n * Absent fields are the zero address.\n *\n * @param extra - Wire extra (or a subset with the two address fields).\n * @param extra.receiverAuthorizer - Optional receiver authorizer; absent is the zero address.\n * @param extra.policy - Optional policy contract; absent is the zero address.\n * @returns True when the client must emit `saltNonce` and a keccak salt.\n */\nexport function isSaltBindingOn(extra: { receiverAuthorizer?: string; policy?: string }): boolean {\n return isNonZeroAddress(extra.receiverAuthorizer) || isNonZeroAddress(extra.policy);\n}\n\n/**\n * Bound PaymentInfo.salt: keccak256(abi.encode(SALT_BINDING_TYPEHASH,\n * receiverAuthorizer, policy, saltNonce)).\n *\n * @param receiverAuthorizer - extra.receiverAuthorizer, or the zero address.\n * @param policy - extra.policy, or the zero address.\n * @param saltNonce - Client's random 32-byte contribution.\n * @returns 32-byte salt commitment.\n */\nexport function deriveBoundSalt(\n receiverAuthorizer: `0x${string}`,\n policy: `0x${string}`,\n saltNonce: `0x${string}`,\n): `0x${string}` {\n const encoded = encodeAbiParameters(\n [\n { name: \"typehash\", type: \"bytes32\" },\n { name: \"receiverAuthorizer\", type: \"address\" },\n { name: \"policy\", type: \"address\" },\n { name: \"saltNonce\", type: \"uint256\" },\n ],\n [SALT_BINDING_TYPEHASH, receiverAuthorizer, policy, BigInt(saltNonce)],\n );\n return keccak256(encoded);\n}\n","/**\n * @file Encoding helpers for batch-settlement deposit collectors.\n */\nimport { encodeAbiParameters, keccak256 } from \"viem\";\n\n/**\n * Computes the ERC-3009 nonce used by the deposit collector:\n * `keccak256(abi.encode(channelId, salt))`.\n *\n * @param channelId - The `bytes32` channel id binding the authorization to a channel.\n * @param salt - Random salt provided by the client to make the nonce unique per deposit.\n * @returns The `bytes32` ERC-3009 nonce.\n */\nexport function buildErc3009DepositNonce(\n channelId: `0x${string}`,\n salt: `0x${string}`,\n): `0x${string}` {\n return keccak256(\n encodeAbiParameters([{ type: \"bytes32\" }, { type: \"uint256\" }], [channelId, BigInt(salt)]),\n );\n}\n\n/**\n * Encodes the `collectorData` payload for `ERC3009DepositCollector.collect()`:\n * `abi.encode(validAfter, validBefore, salt, signature)`.\n *\n * @param validAfter - Earliest unix timestamp the authorization is valid (decimal string).\n * @param validBefore - Latest unix timestamp the authorization is valid (decimal string).\n * @param salt - Random salt provided by the client (hex string).\n * @param signature - ERC-3009 `ReceiveWithAuthorization` signature.\n * @returns ABI-encoded collector data passed to `deposit(..., collector, collectorData)`.\n */\nexport function buildErc3009CollectorData(\n validAfter: string,\n validBefore: string,\n salt: `0x${string}`,\n signature: `0x${string}`,\n): `0x${string}` {\n return encodeAbiParameters(\n [{ type: \"uint256\" }, { type: \"uint256\" }, { type: \"uint256\" }, { type: \"bytes\" }],\n [BigInt(validAfter), BigInt(validBefore), BigInt(salt), signature],\n );\n}\n\n/**\n * Encodes optional EIP-2612 permit data consumed by `Permit2DepositCollector`.\n *\n * @param params - Permit amount, deadline, and split signature fields.\n * @param params.value - Approved Permit2 allowance value.\n * @param params.deadline - EIP-2612 permit deadline.\n * @param params.v - Signature recovery id.\n * @param params.r - Signature `r` value.\n * @param params.s - Signature `s` value.\n * @returns ABI-encoded permit segment.\n */\nexport function buildEip2612PermitData(params: {\n value: string;\n deadline: string;\n v: number;\n r: `0x${string}`;\n s: `0x${string}`;\n}): `0x${string}` {\n return encodeAbiParameters(\n [\n { type: \"uint256\" },\n { type: \"uint256\" },\n { type: \"uint8\" },\n { type: \"bytes32\" },\n { type: \"bytes32\" },\n ],\n [BigInt(params.value), BigInt(params.deadline), params.v, params.r, params.s],\n );\n}\n\n/**\n * Encodes the `collectorData` payload for `Permit2DepositCollector.collect()`.\n *\n * @param nonce - Permit2 transfer nonce.\n * @param deadline - Permit2 transfer deadline.\n * @param permit2Signature - Signature over the channel-bound Permit2 authorization.\n * @param eip2612PermitData - Optional encoded EIP-2612 permit segment.\n * @returns ABI-encoded collector data passed to `deposit`.\n */\nexport function buildPermit2CollectorData(\n nonce: string,\n deadline: string,\n permit2Signature: `0x${string}`,\n eip2612PermitData: `0x${string}` = \"0x\",\n): `0x${string}` {\n return encodeAbiParameters(\n [{ type: \"uint256\" }, { type: \"uint256\" }, { type: \"bytes\" }, { type: \"bytes\" }],\n [BigInt(nonce), BigInt(deadline), permit2Signature, eip2612PermitData],\n );\n}\n","export const channelConfigComponents = [\n { name: \"payer\", type: \"address\" },\n { name: \"payerAuthorizer\", type: \"address\" },\n { name: \"receiver\", type: \"address\" },\n { name: \"receiverAuthorizer\", type: \"address\" },\n { name: \"token\", type: \"address\" },\n { name: \"withdrawDelay\", type: \"uint40\" },\n { name: \"salt\", type: \"bytes32\" },\n] as const;\n\nconst voucherClaimComponents = [\n {\n name: \"voucher\",\n type: \"tuple\",\n components: [\n {\n name: \"channel\",\n type: \"tuple\",\n components: channelConfigComponents,\n },\n { name: \"maxClaimableAmount\", type: \"uint128\" },\n ],\n },\n { name: \"signature\", type: \"bytes\" },\n { name: \"totalClaimed\", type: \"uint128\" },\n] as const;\n\nexport const batchSettlementABI = [\n {\n type: \"function\",\n name: \"multicall\",\n inputs: [{ name: \"data\", type: \"bytes[]\" }],\n outputs: [{ name: \"results\", type: \"bytes[]\" }],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"deposit\",\n inputs: [\n { name: \"config\", type: \"tuple\", components: channelConfigComponents },\n { name: \"amount\", type: \"uint128\" },\n { name: \"collector\", type: \"address\" },\n { name: \"collectorData\", type: \"bytes\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"claim\",\n inputs: [{ name: \"voucherClaims\", type: \"tuple[]\", components: voucherClaimComponents }],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"claimWithSignature\",\n inputs: [\n { name: \"voucherClaims\", type: \"tuple[]\", components: voucherClaimComponents },\n { name: \"authorizerSignature\", type: \"bytes\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"settle\",\n inputs: [\n { name: \"receiver\", type: \"address\" },\n { name: \"token\", type: \"address\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"initiateWithdraw\",\n inputs: [\n { name: \"config\", type: \"tuple\", components: channelConfigComponents },\n { name: \"amount\", type: \"uint128\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"finalizeWithdraw\",\n inputs: [{ name: \"config\", type: \"tuple\", components: channelConfigComponents }],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"refund\",\n inputs: [\n { name: \"config\", type: \"tuple\", components: channelConfigComponents },\n { name: \"amount\", type: \"uint128\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"refundWithSignature\",\n inputs: [\n { name: \"config\", type: \"tuple\", components: channelConfigComponents },\n { name: \"amount\", type: \"uint128\" },\n { name: \"nonce\", type: \"uint256\" },\n { name: \"receiverAuthorizerSignature\", type: \"bytes\" },\n ],\n outputs: [],\n stateMutability: \"nonpayable\",\n },\n {\n type: \"function\",\n name: \"getChannelId\",\n inputs: [{ name: \"config\", type: \"tuple\", components: channelConfigComponents }],\n outputs: [{ name: \"\", type: \"bytes32\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"CHANNEL_CONFIG_TYPEHASH\",\n inputs: [],\n outputs: [{ name: \"\", type: \"bytes32\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"channels\",\n inputs: [{ name: \"channelId\", type: \"bytes32\" }],\n outputs: [\n { name: \"balance\", type: \"uint128\" },\n { name: \"totalClaimed\", type: \"uint128\" },\n ],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"pendingWithdrawals\",\n inputs: [{ name: \"channelId\", type: \"bytes32\" }],\n outputs: [\n { name: \"amount\", type: \"uint128\" },\n { name: \"initiatedAt\", type: \"uint40\" },\n ],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"receivers\",\n inputs: [\n { name: \"receiver\", type: \"address\" },\n { name: \"token\", type: \"address\" },\n ],\n outputs: [\n { name: \"totalClaimed\", type: \"uint128\" },\n { name: \"totalSettled\", type: \"uint128\" },\n ],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"getVoucherDigest\",\n inputs: [\n { name: \"channelId\", type: \"bytes32\" },\n { name: \"maxClaimableAmount\", type: \"uint128\" },\n ],\n outputs: [{ name: \"\", type: \"bytes32\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"getRefundDigest\",\n inputs: [\n { name: \"channelId\", type: \"bytes32\" },\n { name: \"nonce\", type: \"uint256\" },\n { name: \"amount\", type: \"uint128\" },\n ],\n outputs: [{ name: \"\", type: \"bytes32\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"refundNonce\",\n inputs: [{ name: \"channelId\", type: \"bytes32\" }],\n outputs: [{ name: \"\", type: \"uint256\" }],\n stateMutability: \"view\",\n },\n {\n type: \"function\",\n name: \"getClaimBatchDigest\",\n inputs: [{ name: \"voucherClaims\", type: \"tuple[]\", components: voucherClaimComponents }],\n outputs: [{ name: \"\", type: \"bytes32\" }],\n stateMutability: \"view\",\n },\n {\n type: \"event\",\n name: \"Settled\",\n inputs: [\n { name: \"receiver\", type: \"address\", indexed: true },\n { name: \"token\", type: \"address\", indexed: true },\n { name: \"sender\", type: \"address\", indexed: true },\n { name: \"amount\", type: \"uint128\", indexed: false },\n ],\n anonymous: false,\n },\n] as const;\n\nexport const erc20BalanceOfABI = [\n {\n type: \"function\",\n name: \"balanceOf\",\n inputs: [{ name: \"account\", type: \"address\" }],\n outputs: [{ name: \"\", type: \"uint256\" }],\n stateMutability: \"view\",\n },\n] as const;\n","import type { TypedData } from \"viem\";\n\nexport interface AuthorizerSigner {\n address: `0x${string}`;\n signTypedData(params: {\n domain: Record<string, unknown>;\n types: TypedData;\n primaryType: string;\n message: Record<string, unknown>;\n }): Promise<`0x${string}`>;\n}\n\nexport type ChannelState = {\n balance: bigint;\n totalClaimed: bigint;\n withdrawRequestedAt: number;\n refundNonce: bigint;\n};\n\nexport type ChannelConfig = {\n payer: `0x${string}`;\n payerAuthorizer: `0x${string}`;\n receiver: `0x${string}`;\n receiverAuthorizer: `0x${string}`;\n token: `0x${string}`;\n withdrawDelay: number;\n salt: `0x${string}`;\n};\n\nexport type BatchSettlementErc3009Authorization = {\n validAfter: string;\n validBefore: string;\n salt: `0x${string}`;\n signature: `0x${string}`;\n};\n\nexport type BatchSettlementPermit2Authorization = {\n from: `0x${string}`;\n permitted: {\n token: `0x${string}`;\n amount: string;\n };\n spender: `0x${string}`;\n nonce: string;\n deadline: string;\n witness: {\n channelId: `0x${string}`;\n };\n signature: `0x${string}`;\n};\n\nexport type BatchSettlementAssetTransferMethod = \"eip3009\" | \"permit2\";\n\nexport type BatchSettlementDepositAuthorization =\n | {\n erc3009Authorization: BatchSettlementErc3009Authorization;\n permit2Authorization?: never;\n }\n | {\n erc3009Authorization?: never;\n permit2Authorization: BatchSettlementPermit2Authorization;\n };\n\nexport type BatchSettlementDepositPayload = {\n type: \"deposit\";\n channelConfig: ChannelConfig;\n voucher: BatchSettlementVoucherFields;\n deposit: {\n amount: string;\n authorization: BatchSettlementDepositAuthorization;\n };\n};\n\nexport type BatchSettlementVoucherPayload = {\n type: \"voucher\";\n channelConfig: ChannelConfig;\n voucher: BatchSettlementVoucherFields;\n};\n\nexport type BatchSettlementRefundPayload = {\n type: \"refund\";\n channelConfig: ChannelConfig;\n voucher: BatchSettlementVoucherFields;\n amount?: string;\n};\n\nexport type BatchSettlementVoucherFields = {\n channelId: `0x${string}`;\n maxClaimableAmount: string;\n signature: `0x${string}`;\n};\n\nexport type BatchSettlementVoucherClaim = {\n voucher: {\n channel: ChannelConfig;\n maxClaimableAmount: string;\n };\n signature: `0x${string}`;\n totalClaimed: string;\n};\n\nexport type BatchSettlementChannelStateExtra = {\n channelId: `0x${string}`;\n balance: string;\n totalClaimed: string;\n withdrawRequestedAt: number;\n refundNonce: string;\n chargedCumulativeAmount?: string;\n};\n\nexport type BatchSettlementVoucherStateExtra = {\n signedMaxClaimable?: string;\n signature?: `0x${string}`;\n};\n\nexport type BatchSettlementPaymentRequirementsExtra = {\n receiverAuthorizer: `0x${string}`;\n withdrawDelay: number;\n name: string;\n version: string;\n assetTransferMethod?: BatchSettlementAssetTransferMethod;\n channelState?: BatchSettlementChannelStateExtra;\n voucherState?: BatchSettlementVoucherStateExtra;\n};\n\nexport type FileChannelStorageOptions = {\n /** Root directory; channels are stored under `{directory}/{client|server}/{channelId}.json`. */\n directory: string;\n};\n\nexport type BatchSettlementPaymentResponseExtra = {\n chargedAmount?: string;\n channelState?: BatchSettlementChannelStateExtra;\n voucherState?: BatchSettlementVoucherStateExtra;\n};\n\nexport type BatchSettlementClaimPayload = {\n type: \"claim\";\n claims: BatchSettlementVoucherClaim[];\n claimAuthorizerSignature?: `0x${string}`;\n};\n\nexport type BatchSettlementSettlePayload = {\n type: \"settle\";\n receiver: `0x${string}`;\n token: `0x${string}`;\n};\n\nexport type BatchSettlementEnrichedRefundPayload = BatchSettlementRefundPayload & {\n amount: string;\n refundNonce: string;\n claims: BatchSettlementVoucherClaim[];\n refundAuthorizerSignature?: `0x${string}`;\n claimAuthorizerSignature?: `0x${string}`;\n};\n\nexport type BatchSettlementPayload =\n | BatchSettlementDepositPayload\n | BatchSettlementVoucherPayload\n | BatchSettlementRefundPayload;\n\nexport type BatchSettlementFacilitatorSettlePayload =\n | BatchSettlementDepositPayload\n | BatchSettlementClaimPayload\n | BatchSettlementSettlePayload\n | BatchSettlementEnrichedRefundPayload;\n\n/**\n * Returns true when the value is a non-null object (a usable record).\n *\n * @param payload - Value of unknown shape.\n * @returns True if `payload` is an object that can be indexed by string keys.\n */\nfunction isObject(payload: unknown): payload is Record<string, unknown> {\n return typeof payload === \"object\" && payload !== null;\n}\n\n/**\n * Type guard for internal voucher field shape (channel, amount, signature).\n *\n * @param payload - Unknown value to check.\n * @returns True if `payload` is an object with `channelId`, `maxClaimableAmount`, and `signature`.\n */\nfunction isVoucherFields(payload: unknown): payload is BatchSettlementVoucherFields {\n return (\n isObject(payload) &&\n \"channelId\" in payload &&\n \"maxClaimableAmount\" in payload &&\n \"signature\" in payload\n );\n}\n\n/**\n * Type guard for {@link BatchSettlementDepositPayload}.\n *\n * @param payload - Unknown payload to check.\n * @returns True if `payload` is a deposit payload (carries `deposit` and `voucher`).\n */\nexport function isBatchSettlementDepositPayload(\n payload: unknown,\n): payload is BatchSettlementDepositPayload {\n return (\n isObject(payload) &&\n payload.type === \"deposit\" &&\n \"channelConfig\" in payload &&\n isVoucherFields(payload.voucher) &&\n isObject(payload.deposit) &&\n typeof payload.deposit.amount === \"string\" &&\n isObject(payload.deposit.authorization)\n );\n}\n\n/**\n * Type guard for {@link BatchSettlementVoucherPayload}.\n *\n * @param payload - Unknown payload to check.\n * @returns True if `payload` is a voucher payload with channel and signature fields.\n */\nexport function isBatchSettlementVoucherPayload(\n payload: unknown,\n): payload is BatchSettlementVoucherPayload {\n return (\n isObject(payload) &&\n payload.type === \"voucher\" &&\n \"channelConfig\" in payload &&\n isVoucherFields(payload.voucher)\n );\n}\n\n/**\n * Type guard for {@link BatchSettlementRefundPayload}.\n *\n * @param payload - Unknown payload to check.\n * @returns True if `payload` is a refund payload with channel config and voucher fields.\n */\nexport function isBatchSettlementRefundPayload(\n payload: unknown,\n): payload is BatchSettlementRefundPayload {\n return (\n isObject(payload) &&\n payload.type === \"refund\" &&\n \"channelConfig\" in payload &&\n isVoucherFields(payload.voucher)\n );\n}\n\n/**\n * Type guard for {@link BatchSettlementClaimPayload}.\n *\n * @param payload - Unknown payload to check.\n * @returns True if `payload` is a settle-action `claimWithSignature` payload.\n */\nexport function isBatchSettlementClaimPayload(\n payload: unknown,\n): payload is BatchSettlementClaimPayload {\n return isObject(payload) && payload.type === \"claim\" && \"claims\" in payload;\n}\n\n/**\n * Type guard for {@link BatchSettlementSettlePayload}.\n *\n * @param payload - Unknown payload to check.\n * @returns True if `payload` is a settle-action `settle` payload.\n */\nexport function isBatchSettlementSettlePayload(\n payload: unknown,\n): payload is BatchSettlementSettlePayload {\n return (\n isObject(payload) && payload.type === \"settle\" && \"receiver\" in payload && \"token\" in payload\n );\n}\n\n/**\n * Type guard for {@link BatchSettlementEnrichedRefundPayload}.\n *\n * @param payload - Unknown payload to check.\n * @returns True if `payload` is a settle-action `refundWithSignature` payload.\n */\nexport function isBatchSettlementEnrichedRefundPayload(\n payload: unknown,\n): payload is BatchSettlementEnrichedRefundPayload {\n return (\n isBatchSettlementRefundPayload(payload) &&\n \"amount\" in payload &&\n \"refundNonce\" in payload &&\n \"claims\" in payload\n );\n}\n","import type {\n FacilitatorContext,\n FacilitatorExtension,\n PaymentPayload,\n PaymentRequirements,\n} from \"@x402/core/types\";\nimport type { Hex } from \"viem\";\n\nexport const BUILDER_CODE_KEY = \"builder-code\" as const;\n\nexport interface DataSuffixContext {\n paymentPayload: PaymentPayload;\n paymentRequirements: PaymentRequirements;\n}\n\nexport interface BuilderCodeFacilitatorExtension extends FacilitatorExtension {\n key: typeof BUILDER_CODE_KEY;\n buildDataSuffix?(ctx: DataSuffixContext): Hex | undefined | Promise<Hex | undefined>;\n}\n\ntype DataSuffixResolver = (\n context: FacilitatorContext,\n ctx: DataSuffixContext,\n) => Promise<Hex | undefined>;\n\nconst BUILDER_CODE_RESOLVER: DataSuffixResolver = async (context, ctx) => {\n const ext = context.getExtension<BuilderCodeFacilitatorExtension>(BUILDER_CODE_KEY);\n if (!ext?.buildDataSuffix) {\n return undefined;\n }\n\n return ext.buildDataSuffix(ctx);\n};\n\nconst DATA_SUFFIX_RESOLVERS: DataSuffixResolver[] = [BUILDER_CODE_RESOLVER];\n\n/**\n * Resolves and concatenates data suffixes from registered extensions.\n *\n * @param context - Facilitator context with registered extensions\n * @param ctx - Data suffix context passed to extension resolvers\n * @returns Hex-encoded suffix to append to settlement calldata, or undefined if none\n */\nexport async function resolveDataSuffix(\n context: FacilitatorContext | undefined,\n ctx: DataSuffixContext,\n): Promise<Hex | undefined> {\n if (!context) {\n return undefined;\n }\n\n const parts: Hex[] = [];\n for (const resolver of DATA_SUFFIX_RESOLVERS) {\n const suffix = await resolver(context, ctx);\n if (suffix && suffix !== \"0x\" && suffix.length > 2) {\n parts.push(suffix);\n }\n }\n\n if (parts.length === 0) {\n return undefined;\n }\n\n if (parts.length === 1) {\n return parts[0];\n }\n\n return parts.reduce((acc, part, index) => {\n if (index === 0) {\n return part;\n }\n const stripped = part.startsWith(\"0x\") ? part.slice(2) : part;\n return `${acc}${stripped}` as Hex;\n });\n}\n\n/**\n * Appends a hex data suffix to encoded contract calldata.\n *\n * @param calldata - Base encoded function calldata\n * @param suffix - Optional hex suffix (with or without 0x prefix)\n * @returns Calldata with suffix appended, or the original calldata when suffix is empty\n */\nexport function appendDataSuffix(calldata: Hex, suffix?: Hex): Hex {\n if (!suffix || suffix === \"0x\" || suffix.length <= 2) {\n return calldata;\n }\n const suffixHex = suffix.startsWith(\"0x\") ? suffix.slice(2) : suffix;\n return `${calldata}${suffixHex}` as Hex;\n}\n","import type { FacilitatorContext, PaymentPayload } from \"@x402/core/types\";\nimport type { FacilitatorEvmSigner } from \"../signer\";\n\nexport const EIP2612_GAS_SPONSORING_KEY = \"eip2612GasSponsoring\" as const;\nexport const ERC20_APPROVAL_GAS_SPONSORING_KEY = \"erc20ApprovalGasSponsoring\" as const;\nexport const ERC20_APPROVAL_GAS_SPONSORING_VERSION = \"1\" as const;\n\nexport interface Eip2612GasSponsoringInfo {\n [key: string]: unknown;\n from: string;\n asset: string;\n spender: string;\n amount: string;\n nonce: string;\n deadline: string;\n signature: string;\n version: string;\n}\n\nexport interface Erc20ApprovalGasSponsoringInfo {\n [key: string]: unknown;\n from: `0x${string}`;\n asset: `0x${string}`;\n spender: `0x${string}`;\n amount: string;\n signedTransaction: `0x${string}`;\n version: string;\n}\n\n/**\n * A single transaction to be executed by the signer.\n * - `0x${string}`: a pre-signed serialized transaction (broadcast as-is via sendRawTransaction)\n * - `{ to, data, gas? }`: an unsigned call intent (signer signs and broadcasts)\n */\nexport type TransactionRequest =\n | `0x${string}`\n | { to: `0x${string}`; data: `0x${string}`; gas?: bigint };\n\nexport type Erc20ApprovalGasSponsoringSigner = FacilitatorEvmSigner & {\n /**\n * Returns one hash per request for sequential execution, or one hash for an atomic bundle.\n */\n sendTransactions(transactions: TransactionRequest[]): Promise<`0x${string}`[]>;\n simulateTransactions?(transactions: TransactionRequest[]): Promise<boolean>;\n};\n\nexport interface Erc20ApprovalGasSponsoringFacilitatorExtension {\n key: typeof ERC20_APPROVAL_GAS_SPONSORING_KEY;\n signer?: Erc20ApprovalGasSponsoringSigner;\n signerForNetwork?: (network: string) => Erc20ApprovalGasSponsoringSigner | undefined;\n}\n\n/**\n * Extracts a typed `info` payload from an extension entry.\n *\n * @param payload - Payment payload containing optional extensions.\n * @param extensionKey - Extension key to extract.\n * @returns The extension `info` object when present; otherwise null.\n */\nfunction _extractInfo(\n payload: PaymentPayload,\n extensionKey: string,\n): Record<string, unknown> | null {\n const extensions = payload.extensions;\n if (!extensions) return null;\n const extension = extensions[extensionKey] as { info?: Record<string, unknown> } | undefined;\n if (!extension?.info) return null;\n return extension.info;\n}\n\n/**\n * Extracts and validates required EIP-2612 gas sponsoring fields.\n *\n * @param payload - Payment payload returned by the client scheme.\n * @returns Parsed EIP-2612 gas sponsoring info when available and complete.\n */\nexport function extractEip2612GasSponsoringInfo(\n payload: PaymentPayload,\n): Eip2612GasSponsoringInfo | null {\n const info = _extractInfo(payload, EIP2612_GAS_SPONSORING_KEY);\n if (!info) return null;\n if (\n !info.from ||\n !info.asset ||\n !info.spender ||\n !info.amount ||\n !info.nonce ||\n !info.deadline ||\n !info.signature ||\n !info.version\n ) {\n return null;\n }\n return info as unknown as Eip2612GasSponsoringInfo;\n}\n\n/**\n * Validates the structure and formatting of EIP-2612 sponsoring info.\n *\n * @param info - EIP-2612 extension info to validate.\n * @returns True when all required fields match expected patterns.\n */\nexport function validateEip2612GasSponsoringInfo(info: Eip2612GasSponsoringInfo): boolean {\n const addressPattern = /^0x[a-fA-F0-9]{40}$/;\n const numericPattern = /^[0-9]+$/;\n const hexPattern = /^0x[a-fA-F0-9]+$/;\n const versionPattern = /^[0-9]+(\\.[0-9]+)*$/;\n return (\n addressPattern.test(info.from) &&\n addressPattern.test(info.asset) &&\n addressPattern.test(info.spender) &&\n numericPattern.test(info.amount) &&\n numericPattern.test(info.nonce) &&\n numericPattern.test(info.deadline) &&\n hexPattern.test(info.signature) &&\n versionPattern.test(info.version)\n );\n}\n\n/**\n * Extracts and validates required ERC-20 approval sponsoring fields.\n *\n * @param payload - Payment payload returned by the client scheme.\n * @returns Parsed ERC-20 approval sponsoring info when available and complete.\n */\nexport function extractErc20ApprovalGasSponsoringInfo(\n payload: PaymentPayload,\n): Erc20ApprovalGasSponsoringInfo | null {\n const info = _extractInfo(payload, ERC20_APPROVAL_GAS_SPONSORING_KEY);\n if (!info) return null;\n if (\n !info.from ||\n !info.asset ||\n !info.spender ||\n !info.amount ||\n !info.signedTransaction ||\n !info.version\n ) {\n return null;\n }\n return info as unknown as Erc20ApprovalGasSponsoringInfo;\n}\n\n/**\n * Validates the structure and formatting of ERC-20 approval sponsoring info.\n *\n * @param info - ERC-20 approval extension info to validate.\n * @returns True when all required fields match expected patterns.\n */\nexport function validateErc20ApprovalGasSponsoringInfo(\n info: Erc20ApprovalGasSponsoringInfo,\n): boolean {\n const addressPattern = /^0x[a-fA-F0-9]{40}$/;\n const numericPattern = /^[0-9]+$/;\n const hexPattern = /^0x[a-fA-F0-9]+$/;\n const versionPattern = /^[0-9]+(\\.[0-9]+)*$/;\n return (\n addressPattern.test(info.from) &&\n addressPattern.test(info.asset) &&\n addressPattern.test(info.spender) &&\n numericPattern.test(info.amount) &&\n hexPattern.test(info.signedTransaction) &&\n versionPattern.test(info.version)\n );\n}\n\n/**\n * Resolves the ERC-20 approval extension signer for a specific network.\n *\n * @param extension - Optional facilitator extension config.\n * @param network - CAIP-2 network identifier.\n * @returns A network-specific signer when available, else the default signer.\n */\nexport function resolveErc20ApprovalExtensionSigner(\n extension: Erc20ApprovalGasSponsoringFacilitatorExtension | undefined,\n network: string,\n): Erc20ApprovalGasSponsoringSigner | undefined {\n if (!extension) return undefined;\n return extension.signerForNetwork?.(network) ?? extension.signer;\n}\n\n/**\n * Resolves the signer that should wait for a Permit2 settlement receipt.\n *\n * When the ERC-20-approval-gas-sponsoring extension broadcast the settlement\n * transaction, that extension's signer may be a different account/RPC context\n * than the base facilitator signer, so the receipt must be awaited through it\n * instead. Depends only on `payload.extensions` and `context`, so it can be\n * resolved before verify runs (the pending-settlement fast path skips verify\n * entirely and reconciles a previously-broadcast transaction directly).\n *\n * @param signer - The base facilitator signer.\n * @param payload - The payment payload (read for its extensions).\n * @param context - Optional facilitator context providing extension signers.\n * @returns The signer that should be used to await the settlement receipt.\n */\nexport function resolvePermit2ReceiptWaitSigner(\n signer: FacilitatorEvmSigner,\n payload: PaymentPayload,\n context: FacilitatorContext | undefined,\n): FacilitatorEvmSigner {\n if (!context) return signer;\n const erc20Info = extractErc20ApprovalGasSponsoringInfo(payload);\n if (!erc20Info) return signer;\n const extension = context.getExtension<Erc20ApprovalGasSponsoringFacilitatorExtension>(\n ERC20_APPROVAL_GAS_SPONSORING_KEY,\n );\n return resolveErc20ApprovalExtensionSigner(extension, payload.accepted.network) ?? signer;\n}\n","import type {\n PaymentRequirements,\n PaymentPayloadResult,\n PaymentPayloadContext,\n} from \"@x402/core/types\";\nimport {\n EIP2612_GAS_SPONSORING_KEY,\n ERC20_APPROVAL_GAS_SPONSORING_KEY,\n} from \"../../exact/extensions\";\nimport { getAddress } from \"viem\";\nimport { PERMIT2_ADDRESS, erc20AllowanceAbi } from \"../../constants\";\nimport { getEvmChainId } from \"../../utils\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { signEip2612Permit } from \"../../exact/client/eip2612\";\nimport { signErc20ApprovalTransaction } from \"../../exact/client/erc20approval\";\nimport { resolveExtensionRpcCapabilities, type EvmSchemeOptions } from \"../rpc\";\n\n/**\n * Attempts to sign an EIP-2612 permit for gasless Permit2 approval.\n *\n * @param signer - The EVM client signer\n * @param options - Optional RPC configuration for backfilling capabilities\n * @param requirements - The payment requirements from the server\n * @param result - The payment payload result from the scheme\n * @param context - Optional context containing server extensions and metadata\n * @param approvalAmount - Optional amount to approve instead of `requirements.amount`\n * @returns Extension data for EIP-2612 gas sponsoring, or undefined if not applicable\n */\nexport async function trySignEip2612PermitExtension(\n signer: ClientEvmSigner,\n options: EvmSchemeOptions | undefined,\n requirements: PaymentRequirements,\n result: PaymentPayloadResult,\n context?: PaymentPayloadContext,\n approvalAmount?: string,\n): Promise<Record<string, unknown> | undefined> {\n const capabilities = resolveExtensionRpcCapabilities(requirements.network, signer, options);\n\n if (!capabilities.readContract) {\n return undefined;\n }\n\n if (!context?.extensions?.[EIP2612_GAS_SPONSORING_KEY]) {\n return undefined;\n }\n\n const tokenName = requirements.extra?.name as string | undefined;\n const tokenVersion = requirements.extra?.version as string | undefined;\n if (!tokenName || !tokenVersion) {\n return undefined;\n }\n\n const chainId = getEvmChainId(requirements.network);\n const tokenAddress = getAddress(requirements.asset) as `0x${string}`;\n const requiredAllowance = approvalAmount ?? requirements.amount;\n\n try {\n const allowance = (await capabilities.readContract({\n address: tokenAddress,\n abi: erc20AllowanceAbi,\n functionName: \"allowance\",\n args: [signer.address, PERMIT2_ADDRESS],\n })) as bigint;\n\n if (allowance >= BigInt(requiredAllowance)) {\n return undefined;\n }\n } catch {\n // Allowance check failed, proceed with signing\n }\n\n const permit2Auth = result.payload?.permit2Authorization as Record<string, unknown> | undefined;\n const deadline =\n (permit2Auth?.deadline as string) ??\n Math.floor(Date.now() / 1000 + requirements.maxTimeoutSeconds).toString();\n\n const info = await signEip2612Permit(\n {\n address: signer.address,\n signTypedData: msg => signer.signTypedData(msg),\n readContract: capabilities.readContract,\n },\n tokenAddress,\n tokenName,\n tokenVersion,\n chainId,\n deadline,\n requiredAllowance,\n );\n\n return {\n [EIP2612_GAS_SPONSORING_KEY]: { info },\n };\n}\n\n/**\n * Attempts to sign an ERC-20 approval transaction for gasless Permit2 approval.\n *\n * @param signer - The EVM client signer\n * @param options - Optional RPC configuration for backfilling capabilities\n * @param requirements - The payment requirements from the server\n * @param context - Optional context containing server extensions and metadata\n * @param approvalAmount - Optional amount to check for Permit2 allowance\n * @returns Extension data for ERC-20 approval gas sponsoring, or undefined if not applicable\n */\nexport async function trySignErc20ApprovalExtension(\n signer: ClientEvmSigner,\n options: EvmSchemeOptions | undefined,\n requirements: PaymentRequirements,\n context?: PaymentPayloadContext,\n approvalAmount?: string,\n): Promise<Record<string, unknown> | undefined> {\n const capabilities = resolveExtensionRpcCapabilities(requirements.network, signer, options);\n\n if (!capabilities.readContract) {\n return undefined;\n }\n\n if (!context?.extensions?.[ERC20_APPROVAL_GAS_SPONSORING_KEY]) {\n return undefined;\n }\n\n if (!capabilities.signTransaction || !capabilities.getTransactionCount) {\n return undefined;\n }\n\n const chainId = getEvmChainId(requirements.network);\n const tokenAddress = getAddress(requirements.asset) as `0x${string}`;\n const requiredAllowance = approvalAmount ?? requirements.amount;\n\n try {\n const allowance = (await capabilities.readContract({\n address: tokenAddress,\n abi: erc20AllowanceAbi,\n functionName: \"allowance\",\n args: [signer.address, PERMIT2_ADDRESS],\n })) as bigint;\n\n if (allowance >= BigInt(requiredAllowance)) {\n return undefined;\n }\n } catch {\n // Allowance check failed, proceed with signing\n }\n\n const info = await signErc20ApprovalTransaction(\n {\n address: signer.address,\n signTransaction: capabilities.signTransaction,\n getTransactionCount: capabilities.getTransactionCount,\n estimateFeesPerGas: capabilities.estimateFeesPerGas,\n },\n tokenAddress,\n chainId,\n );\n\n return {\n [ERC20_APPROVAL_GAS_SPONSORING_KEY]: { info },\n };\n}\n","import { getAddress } from \"viem\";\nimport { eip2612PermitTypes, eip2612NoncesAbi, PERMIT2_ADDRESS } from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport type { Eip2612GasSponsoringInfo } from \"../extensions\";\n\nexport type Eip2612PermitSigner = Pick<ClientEvmSigner, \"address\" | \"signTypedData\"> & {\n readContract: NonNullable<ClientEvmSigner[\"readContract\"]>;\n};\n\n/**\n * Signs an EIP-2612 permit authorizing the Permit2 contract to spend tokens.\n *\n * This creates a gasless off-chain signature that the facilitator can submit\n * on-chain via `x402Permit2Proxy.settleWithPermit()`.\n *\n * The `permittedAmount` must match the Permit2 `permitted.amount` exactly, as the\n * proxy contract enforces `permit2612.value == permittedAmount`.\n *\n * @param signer - The client EVM signer (must support readContract for nonce query)\n * @param tokenAddress - The ERC-20 token contract address\n * @param tokenName - The token name (from paymentRequirements.extra.name)\n * @param tokenVersion - The token version (from paymentRequirements.extra.version)\n * @param chainId - The chain ID\n * @param deadline - The deadline for the permit (unix timestamp as string)\n * @param permittedAmount - The Permit2 permitted amount (must match exactly)\n * @returns The EIP-2612 gas sponsoring info object\n */\nexport async function signEip2612Permit(\n signer: Eip2612PermitSigner,\n tokenAddress: `0x${string}`,\n tokenName: string,\n tokenVersion: string,\n chainId: number,\n deadline: string,\n permittedAmount: string,\n): Promise<Eip2612GasSponsoringInfo> {\n const owner = signer.address;\n const spender = getAddress(PERMIT2_ADDRESS);\n\n // Query the current EIP-2612 nonce from the token contract\n const nonce = (await signer.readContract({\n address: tokenAddress,\n abi: eip2612NoncesAbi,\n functionName: \"nonces\",\n args: [owner],\n })) as bigint;\n\n // Construct EIP-712 domain for the token's permit function\n const domain = {\n name: tokenName,\n version: tokenVersion,\n chainId,\n verifyingContract: tokenAddress,\n };\n\n const approvalAmount = BigInt(permittedAmount);\n\n const message = {\n owner,\n spender,\n value: approvalAmount,\n nonce,\n deadline: BigInt(deadline),\n };\n\n // Sign the EIP-2612 permit\n const signature = await signer.signTypedData({\n domain,\n types: eip2612PermitTypes,\n primaryType: \"Permit\",\n message,\n });\n\n return {\n from: owner,\n asset: tokenAddress,\n spender,\n amount: approvalAmount.toString(),\n nonce: nonce.toString(),\n deadline,\n signature,\n version: \"1\",\n };\n}\n","import { encodeFunctionData, getAddress, maxUint256 } from \"viem\";\nimport {\n PERMIT2_ADDRESS,\n erc20ApproveAbi,\n ERC20_APPROVE_GAS_LIMIT,\n DEFAULT_MAX_FEE_PER_GAS,\n DEFAULT_MAX_PRIORITY_FEE_PER_GAS,\n} from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport {\n ERC20_APPROVAL_GAS_SPONSORING_VERSION,\n type Erc20ApprovalGasSponsoringInfo,\n} from \"../extensions\";\n\nexport type Erc20ApprovalTxSigner = Pick<ClientEvmSigner, \"address\"> & {\n signTransaction: NonNullable<ClientEvmSigner[\"signTransaction\"]>;\n getTransactionCount: NonNullable<ClientEvmSigner[\"getTransactionCount\"]>;\n estimateFeesPerGas?: NonNullable<ClientEvmSigner[\"estimateFeesPerGas\"]>;\n};\n\n/**\n * Signs an EIP-1559 `approve(Permit2, MaxUint256)` transaction for the given token.\n *\n * The signed transaction is NOT broadcast here — the facilitator broadcasts it\n * atomically before settling the Permit2 payment. This enables Permit2 payments\n * for generic ERC-20 tokens that do NOT implement EIP-2612.\n *\n * Always approves MaxUint256 regardless of the payment amount.\n *\n * @param signer - The client EVM signer (must support signTransaction, getTransactionCount)\n * @param tokenAddress - The ERC-20 token contract address\n * @param chainId - The chain ID\n * @returns The ERC-20 approval gas sponsoring info object\n */\nexport async function signErc20ApprovalTransaction(\n signer: Erc20ApprovalTxSigner,\n tokenAddress: `0x${string}`,\n chainId: number,\n): Promise<Erc20ApprovalGasSponsoringInfo> {\n const from = signer.address;\n const spender = getAddress(PERMIT2_ADDRESS);\n\n // Encode approve(PERMIT2_ADDRESS, MaxUint256) calldata\n const data = encodeFunctionData({\n abi: erc20ApproveAbi,\n functionName: \"approve\",\n args: [spender, maxUint256],\n });\n\n // Get current nonce for the sender\n const nonce = await signer.getTransactionCount({ address: from });\n\n // Get current fee estimates, with fallback values\n let maxFeePerGas: bigint;\n let maxPriorityFeePerGas: bigint;\n try {\n const fees = await signer.estimateFeesPerGas?.();\n if (!fees) {\n throw new Error(\"no fee estimates available\");\n }\n maxFeePerGas = fees.maxFeePerGas;\n maxPriorityFeePerGas = fees.maxPriorityFeePerGas;\n } catch {\n maxFeePerGas = DEFAULT_MAX_FEE_PER_GAS;\n maxPriorityFeePerGas = DEFAULT_MAX_PRIORITY_FEE_PER_GAS;\n }\n\n // Sign the EIP-1559 transaction (not broadcast)\n const signedTransaction = await signer.signTransaction({\n to: tokenAddress,\n data,\n nonce,\n gas: ERC20_APPROVE_GAS_LIMIT,\n maxFeePerGas,\n maxPriorityFeePerGas,\n chainId,\n });\n\n return {\n from,\n asset: tokenAddress,\n spender,\n amount: maxUint256.toString(),\n signedTransaction,\n version: ERC20_APPROVAL_GAS_SPONSORING_VERSION,\n };\n}\n","import { createPublicClient, http } from \"viem\";\nimport type { ClientEvmSigner } from \"../signer\";\nimport { getEvmChainId } from \"../utils\";\n\nexport type EvmSchemeConfig = {\n rpcUrl?: string;\n};\n\nexport type EvmSchemeConfigByChainId = Record<number, EvmSchemeConfig>;\n\nexport type EvmSchemeOptions = EvmSchemeConfig | EvmSchemeConfigByChainId;\n\n/** @deprecated Use EvmSchemeConfig */\nexport type ExactEvmSchemeConfig = EvmSchemeConfig;\n/** @deprecated Use EvmSchemeConfigByChainId */\nexport type ExactEvmSchemeConfigByChainId = EvmSchemeConfigByChainId;\n/** @deprecated Use EvmSchemeOptions */\nexport type ExactEvmSchemeOptions = EvmSchemeOptions;\n\ntype ExtensionRpcCapabilities = Pick<\n ClientEvmSigner,\n \"readContract\" | \"signTransaction\" | \"getTransactionCount\" | \"estimateFeesPerGas\"\n>;\n\nconst rpcClientCache = new Map<string, ReturnType<typeof createPublicClient>>();\n\n/**\n * Check if options is a per-chain-id configuration map.\n *\n * @param options - The EVM scheme options to check\n * @returns True if the options are keyed by chain ID\n */\nfunction isConfigByChainId(options: EvmSchemeOptions): options is EvmSchemeConfigByChainId {\n const keys = Object.keys(options);\n return keys.length > 0 && keys.every(key => /^\\d+$/.test(key));\n}\n\n/**\n * Get or create a cached viem public client for the given RPC URL.\n *\n * @param rpcUrl - The JSON-RPC endpoint URL\n * @returns A viem PublicClient instance\n */\nfunction getRpcClient(rpcUrl: string): ReturnType<typeof createPublicClient> {\n const existing = rpcClientCache.get(rpcUrl);\n if (existing) {\n return existing;\n }\n\n const client = createPublicClient({\n transport: http(rpcUrl),\n });\n rpcClientCache.set(rpcUrl, client);\n return client;\n}\n\n/**\n * Resolve an RPC URL from scheme options for the given network.\n *\n * @param network - The CAIP-2 network identifier\n * @param options - Optional EVM scheme options (flat or per-chain-id)\n * @returns The resolved RPC URL, or undefined if not configured\n */\nexport function resolveRpcUrl(network: string, options?: EvmSchemeOptions): string | undefined {\n if (!options) {\n return undefined;\n }\n\n if (isConfigByChainId(options)) {\n const chainId = getEvmChainId(network);\n const optionsByChainId = options as EvmSchemeConfigByChainId;\n return optionsByChainId[chainId]?.rpcUrl;\n }\n\n return (options as EvmSchemeConfig).rpcUrl;\n}\n\n/**\n * Resolve RPC capabilities for extensions, backfilling from a public RPC client when the signer lacks them.\n *\n * @param network - The CAIP-2 network identifier\n * @param signer - The client EVM signer\n * @param options - Optional EVM scheme options for RPC URL resolution\n * @returns Extension RPC capabilities (readContract, signTransaction, etc.)\n */\nexport function resolveExtensionRpcCapabilities(\n network: string,\n signer: ClientEvmSigner,\n options?: EvmSchemeOptions,\n): ExtensionRpcCapabilities {\n const capabilities: ExtensionRpcCapabilities = {\n signTransaction: signer.signTransaction,\n readContract: signer.readContract,\n getTransactionCount: signer.getTransactionCount,\n estimateFeesPerGas: signer.estimateFeesPerGas,\n };\n\n const needsRpcBackfill =\n !capabilities.readContract ||\n !capabilities.getTransactionCount ||\n !capabilities.estimateFeesPerGas;\n if (!needsRpcBackfill) {\n return capabilities;\n }\n\n const rpcUrl = resolveRpcUrl(network, options);\n if (!rpcUrl) {\n return capabilities;\n }\n const rpcClient = getRpcClient(rpcUrl);\n if (!capabilities.readContract) {\n capabilities.readContract = args => rpcClient.readContract(args as never) as Promise<unknown>;\n }\n if (!capabilities.getTransactionCount) {\n capabilities.getTransactionCount = async args =>\n rpcClient.getTransactionCount({ address: args.address });\n }\n if (!capabilities.estimateFeesPerGas) {\n capabilities.estimateFeesPerGas = async () => rpcClient.estimateFeesPerGas();\n }\n\n return capabilities;\n}\n","import { ClientEvmSigner } from \"../../signer\";\nimport { voucherTypes } from \"../constants\";\nimport { BatchSettlementVoucherFields } from \"../types\";\nimport { getEvmChainId } from \"../../utils\";\nimport { getBatchSettlementEip712Domain } from \"../utils\";\n\n/**\n * Signs a cumulative voucher using the client's wallet.\n *\n * The voucher authorises the receiver to claim up to `maxClaimableAmount` from the\n * channel identified by `channelId`. The signature covers the EIP-712 `Voucher` struct\n * under the batched domain.\n *\n * @param signer - Client wallet used to produce the EIP-712 signature.\n * @param channelId - Identifier of the payment channel. This is the EIP-712\n * hash of the `ChannelConfig` typed data for the batch settlement domain; see\n * `computeChannelId`.\n * @param maxClaimableAmount - Cumulative ceiling the receiver may claim (decimal string in token units).\n * @param network - CAIP-2 network identifier (e.g. `eip155:84532`).\n * @returns Signed voucher fields ready to be included in a payment payload.\n */\nexport async function signVoucher(\n signer: ClientEvmSigner,\n channelId: `0x${string}`,\n maxClaimableAmount: string,\n network: string,\n): Promise<BatchSettlementVoucherFields> {\n const chainId = getEvmChainId(network);\n\n const signature = await signer.signTypedData({\n domain: getBatchSettlementEip712Domain(chainId),\n types: voucherTypes,\n primaryType: \"Voucher\",\n message: {\n channelId,\n maxClaimableAmount: BigInt(maxClaimableAmount),\n },\n });\n\n return {\n channelId,\n maxClaimableAmount,\n signature,\n };\n}\n","import { PaymentRequirements, PaymentPayloadResult } from \"@x402/core/types\";\nimport { getAddress } from \"viem\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { ChannelConfig, BatchSettlementDepositPayload } from \"../types\";\nimport { ERC3009_DEPOSIT_COLLECTOR_ADDRESS, receiveAuthorizationTypes } from \"../constants\";\nimport { createNonce, getEvmChainId } from \"../../utils\";\nimport { signVoucher } from \"./voucher\";\nimport { computeChannelId } from \"../utils\";\nimport { buildErc3009DepositNonce } from \"../encoding\";\n\n/**\n * Creates a deposit payload that bundles an ERC-3009 `receiveWithAuthorization` approval\n * together with a cumulative voucher signature.\n *\n * When the facilitator submits this payload onchain, the contract atomically transfers\n * tokens from the payer into the channel and records the initial voucher.\n *\n * @param signer - Client wallet used to sign the ERC-3009 authorization (`from` = payer).\n * @param x402Version - Protocol version to embed in the payload envelope.\n * @param paymentRequirements - Server-provided payment requirements (asset, network, amount, etc.).\n * @param channelConfig - Immutable channel configuration (payer, receiver, token, …).\n * @param depositAmount - Number of tokens (decimal string) to deposit into the channel.\n * @param maxClaimableAmount - Cumulative ceiling for the accompanying voucher.\n * @param voucherSigner - Optional key that signs the voucher; defaults to `signer` (same as payer).\n * @returns A {@link PaymentPayloadResult} containing the signed deposit + voucher payload.\n */\nexport async function createBatchSettlementEIP3009DepositPayload(\n signer: ClientEvmSigner,\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n channelConfig: ChannelConfig,\n depositAmount: string,\n maxClaimableAmount: string,\n voucherSigner?: ClientEvmSigner,\n): Promise<PaymentPayloadResult> {\n const salt = createNonce();\n const now = Math.floor(Date.now() / 1000);\n const chainId = getEvmChainId(paymentRequirements.network);\n\n if (!paymentRequirements.extra?.name || !paymentRequirements.extra?.version) {\n throw new Error(\n `EIP-712 domain parameters (name, version) are required in payment requirements for asset ${paymentRequirements.asset}`,\n );\n }\n\n const { name, version } = paymentRequirements.extra;\n\n const channelId = computeChannelId(channelConfig, paymentRequirements.network);\n\n const erc3009Nonce = buildErc3009DepositNonce(channelId, salt);\n\n const signature = await signer.signTypedData({\n domain: {\n name,\n version,\n chainId,\n verifyingContract: getAddress(paymentRequirements.asset),\n },\n types: receiveAuthorizationTypes,\n primaryType: \"ReceiveWithAuthorization\",\n message: {\n from: getAddress(signer.address),\n to: getAddress(ERC3009_DEPOSIT_COLLECTOR_ADDRESS),\n value: BigInt(depositAmount),\n validAfter: BigInt(0),\n validBefore: BigInt(now + paymentRequirements.maxTimeoutSeconds),\n nonce: erc3009Nonce,\n },\n });\n\n const vSigner = voucherSigner ?? signer;\n const voucher = await signVoucher(\n vSigner,\n channelId,\n maxClaimableAmount,\n paymentRequirements.network,\n );\n\n const payload: BatchSettlementDepositPayload = {\n type: \"deposit\",\n channelConfig,\n voucher,\n deposit: {\n amount: depositAmount,\n authorization: {\n erc3009Authorization: {\n validAfter: \"0\",\n validBefore: (now + paymentRequirements.maxTimeoutSeconds).toString(),\n salt,\n signature,\n },\n },\n },\n };\n\n return {\n x402Version,\n payload,\n };\n}\n","import { normalizeChannelId } from \"../utils\";\n\n/**\n * Client-side channel fields mirrored from PAYMENT-RESPONSE / recovery flows.\n */\nexport interface BatchSettlementClientContext {\n /** Current cumulative amount charged by the server for this channel */\n chargedCumulativeAmount?: string;\n /** Current onchain channel balance */\n balance?: string;\n /** Total claimed onchain */\n totalClaimed?: string;\n /** Latest client-signed maxClaimableAmount cap (after corrective recovery, optional) */\n signedMaxClaimable?: string;\n /** Client voucher signature for {@link signedMaxClaimable} (optional) */\n signature?: `0x${string}`;\n}\n\nexport interface ClientChannelStorage {\n get(key: string): Promise<BatchSettlementClientContext | undefined>;\n set(key: string, context: BatchSettlementClientContext): Promise<void>;\n delete(key: string): Promise<void>;\n}\n\n/**\n * Default in-memory {@link ClientChannelStorage} (channel records do not survive process restart).\n */\nexport class InMemoryClientChannelStorage implements ClientChannelStorage {\n private readonly channels = new Map<string, BatchSettlementClientContext>();\n\n /**\n * Returns the channel record for `key` if present.\n *\n * @param key - Channel storage key (a canonical `bytes32` channel id).\n * @returns Persisted context or undefined.\n */\n async get(key: string): Promise<BatchSettlementClientContext | undefined> {\n return this.channels.get(normalizeChannelId(key));\n }\n\n /**\n * Stores or replaces the channel record for `key`.\n *\n * @param key - Channel storage key (a canonical `bytes32` channel id).\n * @param context - Channel fields to persist.\n * @returns Resolves when stored.\n */\n async set(key: string, context: BatchSettlementClientContext): Promise<void> {\n this.channels.set(normalizeChannelId(key), context);\n }\n\n /**\n * Removes the channel record for `key` if it exists.\n *\n * @param key - Channel storage key (a canonical `bytes32` channel id).\n * @returns Resolves when removed.\n */\n async delete(key: string): Promise<void> {\n this.channels.delete(normalizeChannelId(key));\n }\n}\n","import type { PaymentRequirements } from \"@x402/core/types\";\nimport type { ClientEvmSigner } from \"../../signer\";\nimport type { EvmSchemeOptions } from \"../../shared/rpc\";\nimport type { ChannelConfig } from \"../types\";\nimport { type ClientChannelStorage, InMemoryClientChannelStorage } from \"./storage\";\nimport type { BatchSettlementClientContext } from \"./storage\";\n\nconst DEFAULT_SALT =\n \"0x0000000000000000000000000000000000000000000000000000000000000000\" as `0x${string}`;\n\n/**\n * Caller-tunable policy controlling how the client sizes channel deposits.\n */\nexport interface BatchSettlementDepositPolicy {\n depositMultiplier?: number;\n}\n\n/**\n * Return shape for custom deposit sizing.\n */\nexport type BatchSettlementDepositStrategyResult = string | bigint | false | undefined;\n\n/**\n * Information supplied before the client signs a deposit authorization.\n */\nexport interface BatchSettlementDepositStrategyContext {\n paymentRequirements: PaymentRequirements;\n channelConfig: ChannelConfig;\n channelId: `0x${string}`;\n clientContext: BatchSettlementClientContext;\n requestAmount: string;\n maxClaimableAmount: string;\n currentBalance: string;\n minimumDepositAmount: string;\n depositAmount: string;\n maxDeposit?: string;\n}\n\n/**\n * Custom deposit sizing callback for initial deposits and top-ups.\n */\nexport type BatchSettlementDepositStrategy = (\n context: BatchSettlementDepositStrategyContext,\n) => BatchSettlementDepositStrategyResult | Promise<BatchSettlementDepositStrategyResult>;\n\n/**\n * Full options object accepted by `BatchSettlementEvmScheme`. Either this or a\n * bare {@link BatchSettlementDepositPolicy} can be passed as the second\n * constructor argument.\n */\nexport interface BatchSettlementEvmSchemeOptions {\n depositPolicy?: BatchSettlementDepositPolicy;\n /** Optional callback for app-specific deposit sizing or skipping. */\n depositStrategy?: BatchSettlementDepositStrategy;\n storage?: ClientChannelStorage;\n salt?: `0x${string}`;\n payerAuthorizer?: `0x${string}`;\n rpcUrl?: string;\n /** When set, EIP-712 vouchers are signed with this key; deposits still use the main `signer`. */\n voucherSigner?: ClientEvmSigner;\n}\n\n/**\n * Resolved options after merging defaults — used internally by the scheme,\n * recovery, and refund modules.\n */\nexport interface ResolvedClientOptions {\n depositPolicy?: BatchSettlementDepositPolicy;\n depositStrategy?: BatchSettlementDepositStrategy;\n storage: ClientChannelStorage;\n salt: `0x${string}`;\n payerAuthorizer?: `0x${string}`;\n voucherSigner?: ClientEvmSigner;\n extensionRpcOptions?: EvmSchemeOptions;\n}\n\n/**\n * Discriminates a full options object from a bare deposit-policy object.\n *\n * @param o - Constructor argument that may be options, deposit policy only, or undefined.\n * @returns `true` when `o` is a {@link BatchSettlementEvmSchemeOptions} object.\n */\nexport function isBatchSettlementEvmSchemeOptions(\n o: BatchSettlementEvmSchemeOptions | BatchSettlementDepositPolicy | undefined,\n): o is BatchSettlementEvmSchemeOptions {\n return (\n o !== undefined &&\n typeof o === \"object\" &&\n (\"storage\" in o ||\n \"depositPolicy\" in o ||\n \"depositStrategy\" in o ||\n \"salt\" in o ||\n \"payerAuthorizer\" in o ||\n \"rpcUrl\" in o ||\n \"voucherSigner\" in o)\n );\n}\n\n/**\n * Normalises the constructor's second argument into a uniform options shape.\n *\n * @param second - Optional second constructor argument (options or deposit policy).\n * @returns Resolved storage, salt, deposit policy, and optional payer authorizer.\n */\nexport function resolveClientOptions(\n second?: BatchSettlementEvmSchemeOptions | BatchSettlementDepositPolicy,\n): ResolvedClientOptions {\n if (second === undefined) {\n return { storage: new InMemoryClientChannelStorage(), salt: DEFAULT_SALT };\n }\n if (isBatchSettlementEvmSchemeOptions(second)) {\n return {\n storage: second.storage ?? new InMemoryClientChannelStorage(),\n depositPolicy: second.depositPolicy,\n depositStrategy: second.depositStrategy,\n salt: second.salt ?? DEFAULT_SALT,\n payerAuthorizer: second.payerAuthorizer,\n voucherSigner: second.voucherSigner,\n extensionRpcOptions: second.rpcUrl ? { rpcUrl: second.rpcUrl } : undefined,\n };\n }\n return {\n storage: new InMemoryClientChannelStorage(),\n depositPolicy: second,\n salt: DEFAULT_SALT,\n };\n}\n\n/**\n * Validates a {@link BatchSettlementDepositPolicy}, throwing on invalid fields.\n *\n * @param policy - The policy to validate (no-op when undefined).\n */\nexport function validateDepositPolicy(policy: BatchSettlementDepositPolicy | undefined): void {\n if (!policy) return;\n\n const m = policy.depositMultiplier;\n if (m !== undefined && (!Number.isInteger(m) || m < 3)) {\n throw new Error(\"depositMultiplier must be an integer >= 3\");\n }\n}\n\n/**\n * Parses a server-announced `extra.minDeposit` when it is a valid deposit target.\n *\n * @param value - Wire value from payment requirement `extra`.\n * @param requestAmount - Per-request voucher amount in token base units.\n * @returns Parsed minimum deposit target, or `undefined` when invalid or below `requestAmount`.\n */\nexport function parseAnnouncedMinDeposit(\n value: unknown,\n requestAmount: bigint,\n): bigint | undefined {\n if (typeof value !== \"string\" || !/^\\d+$/.test(value)) {\n return undefined;\n }\n\n const parsed = BigInt(value);\n if (parsed <= 0n || parsed < requestAmount) {\n return undefined;\n }\n\n return parsed;\n}\n\n/**\n * Derives the deposit ceiling as `depositMultiplier ×` the resolved spend cap.\n *\n * @param maxAmountPerPayment - Atomic spend cap from payment payload context.\n * @param depositMultiplier - Policy multiplier (default 5).\n * @returns Atomic deposit ceiling, or `undefined` when the payment is uncapped.\n */\nexport function maxDepositFromSpendCap(\n maxAmountPerPayment: unknown,\n depositMultiplier = 5,\n): bigint | undefined {\n if (\n typeof maxAmountPerPayment !== \"string\" ||\n !/^\\d+$/.test(maxAmountPerPayment) ||\n BigInt(maxAmountPerPayment) <= 0n\n ) {\n return undefined;\n }\n return BigInt(maxAmountPerPayment) * BigInt(depositMultiplier);\n}\n\n/**\n * Clamps a computed deposit to `maxDeposit`. Throws when the voucher gap exceeds the cap.\n *\n * @param deposit - Proposed deposit in token base units.\n * @param needed - Minimum deposit to cover the next voucher.\n * @param maxDeposit - Atomic ceiling (`depositMultiplier ×` spend cap). Omitted when uncapped.\n * @returns Deposit amount string in token base units.\n */\nexport function applyMaxDeposit(deposit: bigint, needed: bigint, maxDeposit?: bigint): string {\n if (maxDeposit === undefined) {\n return deposit.toString();\n }\n if (needed > maxDeposit) {\n throw new Error(\n `Required deposit ${needed.toString()} exceeds depositMultiplier × spendControls.maxAmountPerPayment (${maxDeposit.toString()}). ` +\n `Raise maxAmountPerPayment or depositMultiplier.`,\n );\n }\n return (deposit > maxDeposit ? maxDeposit : deposit).toString();\n}\n\n/**\n * Computes the deposit amount from the voucher gap, server hint, or deposit multiplier.\n *\n * @param policy - Deposit policy controlling multiplier.\n * @param requestAmount - Amount requested for this operation, in token base units.\n * @param needed - Minimum deposit to cover the next voucher (`maxClaimableAmount - balance`).\n * @param extra - Payment requirement `extra` (may contain `minDeposit`).\n * @param maxDeposit - Atomic ceiling (`depositMultiplier ×` spend cap). Omitted when uncapped.\n * @returns Deposit amount string in token base units.\n */\nexport function depositAmountForRequest(\n policy: BatchSettlementDepositPolicy | undefined,\n requestAmount: bigint,\n needed: bigint,\n extra: Record<string, unknown> | undefined,\n maxDeposit?: bigint,\n): string {\n const announced = parseAnnouncedMinDeposit(extra?.minDeposit, requestAmount);\n const multiplier = BigInt(policy?.depositMultiplier ?? 5);\n const target = announced ?? multiplier * requestAmount;\n const deposit = needed > target ? needed : target;\n return applyMaxDeposit(deposit, needed, maxDeposit);\n}\n","import { decodePaymentResponseHeader } from \"@x402/core/http\";\nimport type { PaymentRequirements } from \"@x402/core/types\";\nimport { getAddress } from \"viem\";\nimport type { ClientEvmSigner } from \"../../signer\";\nimport { batchSettlementABI } from \"../abi\";\nimport { BATCH_SETTLEMENT_ADDRESS, MIN_WITHDRAW_DELAY } from \"../constants\";\nimport type {\n BatchSettlementChannelStateExtra,\n BatchSettlementPaymentRequirementsExtra,\n ChannelConfig,\n} from \"../types\";\nimport { computeChannelId } from \"../utils\";\nimport type { BatchSettlementClientContext, ClientChannelStorage } from \"./storage\";\n\n/**\n * Runtime dependency bag shared by every storage-bound client helper (channel,\n * recovery, refund) and the {@link BatchSettlementEvmScheme} class.\n */\nexport interface BatchSettlementClientDeps {\n signer: ClientEvmSigner;\n storage: ClientChannelStorage;\n salt: `0x${string}`;\n payerAuthorizer?: `0x${string}`;\n voucherSigner?: ClientEvmSigner;\n}\n\n/**\n * Constructs the immutable {@link ChannelConfig} from payment requirements and\n * a client deps bag (signer, salt, optional payerAuthorizer / voucherSigner).\n *\n * @param deps - Client identity inputs.\n * @param paymentRequirements - Server payment requirements providing receiver, asset, and extra fields.\n * @returns The ChannelConfig that uniquely identifies this payment channel.\n */\nexport function buildChannelConfig(\n deps: BatchSettlementClientDeps,\n paymentRequirements: PaymentRequirements,\n): ChannelConfig {\n const extra = paymentRequirements.extra as\n | Partial<BatchSettlementPaymentRequirementsExtra>\n | undefined;\n const receiverAuthorizer = extra?.receiverAuthorizer;\n if (\n !receiverAuthorizer ||\n getAddress(receiverAuthorizer) === \"0x0000000000000000000000000000000000000000\"\n ) {\n throw new Error(\"Payment requirements must include a non-zero extra.receiverAuthorizer\");\n }\n\n return {\n payer: deps.signer.address,\n payerAuthorizer: getAddress(\n deps.payerAuthorizer ?? deps.voucherSigner?.address ?? deps.signer.address,\n ),\n receiver: paymentRequirements.payTo as `0x${string}`,\n receiverAuthorizer: getAddress(receiverAuthorizer),\n token: paymentRequirements.asset as `0x${string}`,\n withdrawDelay:\n typeof extra?.withdrawDelay === \"number\" ? extra.withdrawDelay : MIN_WITHDRAW_DELAY,\n salt: deps.salt,\n };\n}\n\n/**\n * Local inputs for applying a deposit or voucher settle.\n *\n * `requestAmount` is the per-request maximum (`PaymentRequirements.amount`);\n * the voucher ceiling was `chargedCumulativeAmount + requestAmount`.\n * `depositAmount` is `payload.deposit.amount` for this payment and is added to\n * previous local `balance` after settle. Omit it on voucher-only.\n */\nexport type ChannelSettleLocal = {\n channelId: `0x${string}`;\n requestAmount: string;\n depositAmount?: string;\n};\n\n/**\n * Updates local channel state after a deposit or voucher settle.\n *\n * Next cumulative is previous local `chargedCumulativeAmount` plus\n * `server.chargedAmount` (capped at `local.requestAmount`). Next balance is\n * previous local `balance` plus `local.depositAmount` when present;\n * voucher-only leaves balance unchanged. The write is skipped when extra\n * `chargedCumulativeAmount` is present and is not a non-negative integer equal\n * to that next cumulative. Server `channelState` fields are never copied.\n *\n * @param storage - Client channel storage.\n * @param input - Server-reported charge and client-owned settle inputs.\n * @param input.server - Untrusted settlement response fields.\n * @param input.server.chargedAmount - Untrusted `PAYMENT-RESPONSE` extra.chargedAmount.\n * @param input.server.chargedCumulativeAmount - Untrusted extra.channelState.chargedCumulativeAmount.\n * @param input.local - Client-computed channel id, request maximum, and optional deposit.\n */\nexport async function updateChannelFromSettle(\n storage: ClientChannelStorage,\n input: {\n server: { chargedAmount?: string; chargedCumulativeAmount?: string };\n local: ChannelSettleLocal;\n },\n): Promise<void> {\n const { server, local } = input;\n let chargedAmount = 0n;\n if (server.chargedAmount !== undefined) {\n if (!/^\\d+$/.test(server.chargedAmount)) {\n throw new Error(\"invalid chargedAmount: not a non-negative integer\");\n }\n chargedAmount = BigInt(server.chargedAmount);\n }\n const requestAmount = BigInt(local.requestAmount);\n if (chargedAmount > requestAmount) {\n throw new Error(\"settle response chargedAmount exceeds PaymentRequirements.amount\");\n }\n\n const key = local.channelId.toLowerCase();\n const previous = await storage.get(key);\n const depositAmount = local.depositAmount === undefined ? undefined : BigInt(local.depositAmount);\n\n if (!previous && chargedAmount === 0n && depositAmount === undefined) {\n return;\n }\n\n const nextChargedCumulative = BigInt(previous?.chargedCumulativeAmount ?? \"0\") + chargedAmount;\n if (server.chargedCumulativeAmount !== undefined) {\n if (\n !/^\\d+$/.test(server.chargedCumulativeAmount) ||\n BigInt(server.chargedCumulativeAmount) !== nextChargedCumulative\n ) {\n return;\n }\n }\n\n const next: BatchSettlementClientContext = { ...(previous ?? {}) };\n next.chargedCumulativeAmount = nextChargedCumulative.toString();\n\n if (depositAmount !== undefined) {\n next.balance = (BigInt(previous?.balance ?? \"0\") + depositAmount).toString();\n }\n\n await storage.set(key, next);\n}\n\n/**\n * Updates local channel state after a cooperative refund the client signed.\n *\n * Omitted `refundAmount` is a full refund: delete the local record. Otherwise\n * the signed amount is capped to the locally expected refundable balance.\n * Delete the record when that drains the refundable balance; otherwise subtract\n * the effective refund from balance. Cumulative is unchanged, and server\n * `channelState` is not an input.\n *\n * @param storage - Client channel storage.\n * @param channelKey - Lowercased client-computed channel id used as the storage key.\n * @param refundAmount - Partial refund the client signed; omit for a full refund.\n */\nexport async function updateChannelAfterRefund(\n storage: ClientChannelStorage,\n channelKey: string,\n refundAmount?: string,\n): Promise<void> {\n if (refundAmount === undefined) {\n await storage.delete(channelKey);\n return;\n }\n\n const amount = BigInt(refundAmount);\n const previous = await storage.get(channelKey);\n const previousBalance = BigInt(previous?.balance ?? \"0\");\n const chargedCumulativeAmount = BigInt(previous?.chargedCumulativeAmount ?? \"0\");\n const refundableBalance =\n previousBalance > chargedCumulativeAmount ? previousBalance - chargedCumulativeAmount : 0n;\n if (amount >= refundableBalance) {\n await storage.delete(channelKey);\n return;\n }\n\n const next: BatchSettlementClientContext = { ...(previous ?? {}) };\n next.balance = (previousBalance - amount).toString();\n await storage.set(channelKey, next);\n}\n\n/**\n * Processes the `PAYMENT-RESPONSE` header after a successful request.\n *\n * Decodes the untrusted header and delegates to {@link updateChannelFromSettle}\n * with server `chargedAmount`, optional extra cumulative, and the caller-supplied\n * local channel inputs.\n *\n * @param storage - Client channel storage.\n * @param getHeader - Function to retrieve a response header by name.\n * @param local - Channel id, per-request maximum, and optional deposit from this payment.\n * @param local.channelId - Client-computed channel id used as the storage key.\n * @param local.requestAmount - Per-request maximum (`PaymentRequirements.amount`).\n * @param local.depositAmount - `payload.deposit.amount` from this payment.\n */\nexport async function processPaymentResponse(\n storage: ClientChannelStorage,\n getHeader: (name: string) => string | null | undefined,\n local: ChannelSettleLocal,\n): Promise<void> {\n const raw = getHeader(\"PAYMENT-RESPONSE\");\n if (!raw) return;\n\n const settle = decodePaymentResponseHeader(raw);\n if (!settle.success) return;\n\n const chargedAmount = settle.extra?.chargedAmount;\n if (chargedAmount !== undefined && typeof chargedAmount !== \"string\") {\n throw new Error(\"invalid chargedAmount: not a non-negative integer\");\n }\n const channelState = settle.extra?.channelState as BatchSettlementChannelStateExtra | undefined;\n await updateChannelFromSettle(storage, {\n server: {\n chargedAmount,\n chargedCumulativeAmount: channelState?.chargedCumulativeAmount,\n },\n local,\n });\n}\n\n/**\n * Recovers a channel record from onchain state (useful after a cold start or\n * channel record loss).\n *\n * @param deps - Signer + storage + identity inputs.\n * @param paymentRequirements - Server payment requirements used to derive the ChannelConfig.\n * @returns The recovered client context.\n */\nexport async function recoverChannel(\n deps: BatchSettlementClientDeps,\n paymentRequirements: PaymentRequirements,\n): Promise<BatchSettlementClientContext> {\n if (!deps.signer.readContract) {\n throw new Error(\"recoverChannel requires ClientEvmSigner.readContract\");\n }\n\n const config = buildChannelConfig(deps, paymentRequirements);\n const channelId = computeChannelId(config, paymentRequirements.network);\n\n const [chBalance, chTotalClaimed] = await readChannelBalanceAndTotalClaimed(\n deps.signer,\n channelId,\n );\n\n const ctx: BatchSettlementClientContext = {\n chargedCumulativeAmount: chTotalClaimed.toString(),\n balance: chBalance.toString(),\n totalClaimed: chTotalClaimed.toString(),\n };\n\n await deps.storage.set(channelId.toLowerCase(), ctx);\n return ctx;\n}\n\n/**\n * Reads `channels(channelId)` returning `[balance, totalClaimed]`.\n *\n * @param signer - Signer providing `readContract`.\n * @param channelId - The `bytes32` channel id to query.\n * @returns Tuple of `[balance, totalClaimed]` as bigints.\n */\nexport async function readChannelBalanceAndTotalClaimed(\n signer: ClientEvmSigner,\n channelId: `0x${string}`,\n): Promise<[bigint, bigint]> {\n if (!signer.readContract) {\n throw new Error(\"readChannelBalanceAndTotalClaimed requires ClientEvmSigner.readContract\");\n }\n return (await signer.readContract({\n address: BATCH_SETTLEMENT_ADDRESS,\n abi: batchSettlementABI,\n functionName: \"channels\",\n args: [channelId],\n })) as [bigint, bigint];\n}\n\n/**\n * Returns whether a local channel record exists for the given channel.\n *\n * @param storage - Client channel storage.\n * @param channelId - The channel identifier to check.\n * @returns `true` when a channel record is stored.\n */\nexport async function hasChannel(\n storage: ClientChannelStorage,\n channelId: string,\n): Promise<boolean> {\n const channel = await storage.get(channelId.toLowerCase());\n return channel !== undefined;\n}\n\n/**\n * Returns the local channel context for a channel, if present.\n *\n * @param storage - Client channel storage.\n * @param channelId - The channel identifier.\n * @returns Stored context or `undefined`.\n */\nexport async function getChannel(\n storage: ClientChannelStorage,\n channelId: string,\n): Promise<BatchSettlementClientContext | undefined> {\n return storage.get(channelId.toLowerCase());\n}\n","import type { PaymentRequired, PaymentRequirements } from \"@x402/core/types\";\nimport { getAddress, recoverTypedDataAddress } from \"viem\";\nimport { BATCH_SETTLEMENT_SCHEME, voucherTypes } from \"../constants\";\nimport type { BatchSettlementClientContext } from \"./storage\";\nimport { computeChannelId, getBatchSettlementEip712Domain } from \"../utils\";\nimport { getEvmChainId } from \"../../utils\";\nimport {\n type BatchSettlementClientDeps,\n buildChannelConfig,\n readChannelBalanceAndTotalClaimed,\n} from \"./channel\";\nimport * as Errors from \"../errors\";\nimport type { BatchSettlementChannelStateExtra, BatchSettlementVoucherStateExtra } from \"../types\";\n\n/**\n * Handles a corrective 402 response from the server when the client's\n * cumulative base is out of sync.\n *\n * Validates the server-provided state (chargedCumulativeAmount,\n * signedMaxClaimable, signature) against onchain data and the client's own\n * signing key, then updates the local channel state if everything checks out.\n *\n * @param deps - Signer + storage + identity inputs.\n * @param paymentRequired - The decoded 402 response body.\n * @returns `true` if the channel state was successfully resynced and the request can be retried.\n */\nexport async function processCorrectivePaymentRequired(\n deps: BatchSettlementClientDeps,\n paymentRequired: PaymentRequired,\n): Promise<boolean> {\n if (\n paymentRequired.error !== Errors.ErrCumulativeAmountMismatch &&\n paymentRequired.error !== Errors.ErrCumulativeAmountBelowClaimed\n ) {\n return false;\n }\n\n const accept = paymentRequired.accepts.find(a => a.scheme === BATCH_SETTLEMENT_SCHEME);\n if (!accept) {\n return false;\n }\n\n const channelState = accept.extra.channelState as BatchSettlementChannelStateExtra | undefined;\n const voucherState = accept.extra.voucherState as BatchSettlementVoucherStateExtra | undefined;\n const hasSig =\n channelState?.chargedCumulativeAmount !== undefined &&\n voucherState?.signedMaxClaimable !== undefined &&\n voucherState.signature !== undefined;\n\n if (!hasSig) {\n return recoverFromOnChainState(deps, accept);\n }\n\n return recoverFromSignature(deps, accept, channelState, voucherState);\n}\n\n/**\n * Recovers channel state from a corrective 402 that includes a server-provided\n * voucher signature. Verifies the signature matches the client's own signing\n * key before accepting.\n *\n * @param deps - Signer + storage + identity inputs.\n * @param accept - Batch settlement payment requirements from the corrective 402.\n * @param channelState - Server channel snapshot from `accept.extra.channelState`.\n * @param voucherState - Latest signed voucher proof from `accept.extra.voucherState`.\n * @returns `true` when local channel state was updated successfully.\n */\nexport async function recoverFromSignature(\n deps: BatchSettlementClientDeps,\n accept: PaymentRequirements,\n channelState: BatchSettlementChannelStateExtra,\n voucherState: BatchSettlementVoucherStateExtra,\n): Promise<boolean> {\n const chargedRaw = channelState.chargedCumulativeAmount;\n const signedRaw = voucherState.signedMaxClaimable;\n const sig = voucherState.signature as `0x${string}`;\n\n const charged = BigInt(String(chargedRaw));\n const signed = BigInt(String(signedRaw));\n\n if (charged > signed) {\n return false;\n }\n\n const config = buildChannelConfig(deps, accept);\n const channelId = computeChannelId(config, accept.network);\n\n if (!deps.signer.readContract) {\n return false;\n }\n\n const [chBalance, chTotalClaimed] = await readChannelBalanceAndTotalClaimed(\n deps.signer,\n channelId,\n );\n\n if (charged < chTotalClaimed) {\n return false;\n }\n\n const chainId = getEvmChainId(accept.network);\n const recovered = await recoverTypedDataAddress({\n domain: getBatchSettlementEip712Domain(chainId),\n types: voucherTypes,\n primaryType: \"Voucher\",\n message: {\n channelId,\n maxClaimableAmount: signed,\n },\n signature: sig,\n });\n\n const expectedSigner = getAddress(\n deps.payerAuthorizer ?? deps.voucherSigner?.address ?? deps.signer.address,\n );\n if (recovered.toLowerCase() !== expectedSigner.toLowerCase()) {\n return false;\n }\n\n const ctx: BatchSettlementClientContext = {\n chargedCumulativeAmount: charged.toString(),\n signedMaxClaimable: signed.toString(),\n signature: sig,\n balance: chBalance.toString(),\n totalClaimed: chTotalClaimed.toString(),\n };\n\n await deps.storage.set(channelId.toLowerCase(), ctx);\n return true;\n}\n\n/**\n * Recovers channel state purely from onchain state when the server has no stored\n * voucher (e.g. after a cooperative refund deleted the channel record). The onchain\n * `totalClaimed` becomes the new baseline — no signature verification is\n * needed because the contract is the source of truth when no outstanding\n * voucher exists.\n *\n * @param deps - Signer + storage + identity inputs.\n * @param accept - Batch settlement payment requirements from the corrective 402.\n * @returns `true` when local channel state was updated from onchain data.\n */\nexport async function recoverFromOnChainState(\n deps: BatchSettlementClientDeps,\n accept: PaymentRequirements,\n): Promise<boolean> {\n if (!deps.signer.readContract) {\n return false;\n }\n\n const config = buildChannelConfig(deps, accept);\n const channelId = computeChannelId(config, accept.network);\n\n const [chBalance, chTotalClaimed] = await readChannelBalanceAndTotalClaimed(\n deps.signer,\n channelId,\n );\n\n const ctx: BatchSettlementClientContext = {\n chargedCumulativeAmount: chTotalClaimed.toString(),\n balance: chBalance.toString(),\n totalClaimed: chTotalClaimed.toString(),\n };\n\n await deps.storage.set(channelId.toLowerCase(), ctx);\n return true;\n}\n","import type { SchemeClientHooks } from \"@x402/core/types\";\nimport {\n isBatchSettlementDepositPayload,\n isBatchSettlementRefundPayload,\n type BatchSettlementChannelStateExtra,\n} from \"../types\";\nimport { computeChannelId } from \"../utils\";\nimport {\n type BatchSettlementClientDeps,\n buildChannelConfig,\n updateChannelAfterRefund,\n updateChannelFromSettle,\n} from \"./channel\";\nimport { processCorrectivePaymentRequired } from \"./recovery\";\n\n/**\n * Creates storage-aware client hooks for batch-settlement payment responses.\n *\n * @param deps - Client identity and storage inputs.\n * @returns Scheme hooks for response reconciliation and corrective recovery.\n */\nexport function createBatchSettlementClientHooks(\n deps: BatchSettlementClientDeps,\n): SchemeClientHooks {\n return {\n onPaymentResponse: async ctx => {\n const settleResponse = ctx.settleResponse;\n if (settleResponse) {\n if (!settleResponse.success) {\n return;\n }\n\n const payload = ctx.paymentPayload.payload;\n const channelId = computeChannelId(\n buildChannelConfig(deps, ctx.requirements),\n ctx.requirements.network,\n );\n if (isBatchSettlementRefundPayload(payload)) {\n await updateChannelAfterRefund(deps.storage, channelId.toLowerCase(), payload.amount);\n return;\n }\n const chargedAmount = settleResponse.extra?.chargedAmount;\n if (chargedAmount !== undefined && typeof chargedAmount !== \"string\") {\n throw new Error(\"invalid chargedAmount: not a non-negative integer\");\n }\n const channelState = settleResponse.extra?.channelState as\n | BatchSettlementChannelStateExtra\n | undefined;\n await updateChannelFromSettle(deps.storage, {\n server: {\n chargedAmount,\n chargedCumulativeAmount: channelState?.chargedCumulativeAmount,\n },\n local: {\n channelId,\n requestAmount: ctx.requirements.amount,\n depositAmount: isBatchSettlementDepositPayload(payload)\n ? payload.deposit.amount\n : undefined,\n },\n });\n return;\n }\n\n if (ctx.paymentRequired) {\n const recovered = await processCorrectivePaymentRequired(deps, ctx.paymentRequired);\n return recovered ? { recovered: true } : undefined;\n }\n },\n };\n}\n","import { decodePaymentRequiredHeader, decodePaymentResponseHeader } from \"@x402/core/http\";\nimport { x402Client, x402HTTPClient } from \"@x402/core/client\";\nimport type {\n PaymentPayload,\n PaymentRequired,\n PaymentRequirements,\n SettleResponse,\n} from \"@x402/core/types\";\nimport { BATCH_SETTLEMENT_SCHEME } from \"../constants\";\nimport * as Errors from \"../errors\";\nimport type {\n BatchSettlementPaymentRequirementsExtra,\n BatchSettlementRefundPayload,\n} from \"../types\";\nimport { computeChannelId } from \"../utils\";\nimport { type BatchSettlementClientDeps, buildChannelConfig, recoverChannel } from \"./channel\";\nimport { createBatchSettlementClientHooks } from \"./hooks\";\nimport { signVoucher } from \"./voucher\";\n\n/**\n * Refund-specific server errors that the client cannot recover from automatically.\n * Seeing any of these means the user should adjust their request (or accept that the\n * channel has nothing left to refund) — retrying will not help.\n */\nconst NON_RECOVERABLE_REFUND_ERRORS: ReadonlySet<string> = new Set([\n Errors.ErrRefundNoBalance,\n Errors.ErrRefundAmountInvalid,\n]);\n\ninterface RefundRequirementsProbe {\n paymentRequired: PaymentRequired;\n requirements: PaymentRequirements;\n}\n\n/**\n * Caller-facing options for {@link refundChannel}.\n */\nexport interface RefundOptions {\n /** Token base units to refund; omit for a full refund (drains remaining balance). */\n amount?: string;\n /** Custom fetch implementation (defaults to `globalThis.fetch`). */\n fetch?: typeof fetch;\n}\n\n/**\n * Sends a cooperative refund request to the channel that backs `url`.\n *\n * Flow:\n * 1. Probe the URL with `GET` (no payment) to obtain the route's payment requirements.\n * 2. Build the `ChannelConfig` and resolve the local session (or recover it).\n * 3. Sign a zero-charge refund voucher (`maxClaimableAmount = chargedCumulativeAmount`).\n * 4. Send the voucher via `PAYMENT-SIGNATURE`. On a corrective 402, run the\n * standard recovery path and retry once.\n * 5. Return the parsed `SettleResponse` from the server.\n *\n * @param ctx - Identity inputs (storage, signers, salt, payerAuthorizer).\n * @param url - Any protected route on the channel to refund (the resource handler is bypassed).\n * @param options - Optional `amount` (partial refund) and `fetch` override.\n * @returns The settle response describing the refund outcome.\n * @throws When the probe fails, the receiver lacks an authorizer, or recovery fails.\n */\nexport async function refundChannel(\n ctx: BatchSettlementClientDeps,\n url: string,\n options?: RefundOptions,\n): Promise<SettleResponse> {\n const fetchImpl = options?.fetch ?? globalThis.fetch;\n if (!fetchImpl) {\n throw new Error(\"refund requires a fetch implementation (globalThis.fetch unavailable)\");\n }\n\n const refundAmount = normalizeRefundAmount(options?.amount);\n const probe = await probeRefundRequirements(url, fetchImpl);\n return executeRefund(ctx, url, probe, refundAmount, fetchImpl);\n}\n\n/**\n * Probes a URL with an unauthenticated GET to retrieve batch-settlement payment\n * requirements via the 402 PAYMENT-REQUIRED header.\n *\n * @param url - The protected URL to probe.\n * @param fetchImpl - Fetch implementation used for the probe.\n * @returns Matching batch-settlement payment requirements for the route.\n */\nasync function probeRefundRequirements(\n url: string,\n fetchImpl: typeof fetch,\n): Promise<RefundRequirementsProbe> {\n const probe = await fetchImpl(url, { method: \"GET\" });\n if (probe.status !== 402) {\n throw new Error(`Refund probe expected 402, got ${probe.status}`);\n }\n\n const header = probe.headers.get(\"PAYMENT-REQUIRED\");\n if (!header) {\n throw new Error(\"Refund probe response missing PAYMENT-REQUIRED header\");\n }\n\n const paymentRequired = decodePaymentRequiredHeader(header);\n const requirements = paymentRequired.accepts.find(a => a.scheme === BATCH_SETTLEMENT_SCHEME);\n if (!requirements) {\n throw new Error(`No ${BATCH_SETTLEMENT_SCHEME} payment option at ${url}`);\n }\n\n const extra = requirements.extra as Partial<BatchSettlementPaymentRequirementsExtra> | undefined;\n if (!extra?.receiverAuthorizer) {\n throw new Error(\"Refund requires a configured receiverAuthorizer on the receiver\");\n }\n\n return { paymentRequired, requirements };\n}\n\n/**\n * Builds and submits the refund voucher, retrying once after a corrective 402.\n *\n * @param ctx - Identity inputs (storage, signers, salt, payerAuthorizer).\n * @param url - The protected URL to send the refund voucher to.\n * @param probe - Resolved payment requirements and probe metadata for this channel.\n * @param refundAmount - Optional partial refund amount in token base units.\n * @param fetchImpl - Fetch implementation used for the request.\n * @returns The parsed settle response.\n */\nasync function executeRefund(\n ctx: BatchSettlementClientDeps,\n url: string,\n probe: RefundRequirementsProbe,\n refundAmount: string | undefined,\n fetchImpl: typeof fetch,\n): Promise<SettleResponse> {\n const maxAttempts = 2;\n const { paymentRequired, requirements } = probe;\n const httpClient = createRefundHttpClient(ctx, requirements);\n\n for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n const paymentPayload = await buildRefundPaymentPayload(\n ctx,\n paymentRequired,\n requirements,\n refundAmount,\n );\n const headers = httpClient.encodePaymentSignatureHeader(paymentPayload);\n\n const response = await fetchImpl(url, { method: \"GET\", headers });\n\n if (response.status === 402) {\n const nonRecoverable = getNonRecoverableRefundFailure(response);\n if (nonRecoverable) {\n throw new Error(nonRecoverable);\n }\n }\n\n const result = await httpClient.processPaymentResult(\n paymentPayload,\n name => response.headers.get(name),\n response.status,\n );\n\n if (response.status === 402) {\n if (result.recovered && attempt < maxAttempts) {\n continue;\n }\n if (result.recovered) {\n throw new Error(`Refund failed: server returned 402 after ${attempt} attempt(s)`);\n }\n\n const corrective = getRefundPaymentRequired(response);\n throw new Error(`Refund failed: ${corrective.error ?? \"unknown\"}`);\n }\n\n if (!result.settleResponse) {\n throw new Error(\n `Refund response missing PAYMENT-RESPONSE header (status ${response.status})`,\n );\n }\n\n return result.settleResponse;\n }\n\n throw new Error(\"Refund failed: retry budget exhausted\");\n}\n\n/**\n * Builds the refund payload with a zero-charge `maxClaimableAmount`.\n *\n * @param ctx - Identity inputs (storage, signers, salt, payerAuthorizer).\n * @param paymentRequired - Decoded 402 body from the probe (resource, extensions, etc.).\n * @param requirements - Resolved payment requirements for the channel.\n * @param refundAmount - Optional partial refund amount in token base units.\n * @returns A full payment payload wrapping the signed refund request.\n */\nasync function buildRefundPaymentPayload(\n ctx: BatchSettlementClientDeps,\n paymentRequired: PaymentRequired,\n requirements: PaymentRequirements,\n refundAmount: string | undefined,\n): Promise<PaymentPayload> {\n const config = buildChannelConfig(ctx, requirements);\n const channelId = computeChannelId(config, requirements.network);\n const key = channelId.toLowerCase();\n\n let channel = await ctx.storage.get(key);\n if (channel === undefined && ctx.signer.readContract) {\n channel = await recoverChannel(ctx, requirements);\n }\n if (channel === undefined) {\n throw new Error(\n \"Refund requires an existing channel record; deposit first or call from a context with an EVM RPC\",\n );\n }\n\n // Avoid a refund request when local state shows the channel has no refundable balance.\n const charged = channel.chargedCumulativeAmount ?? \"0\";\n if (channel.balance !== undefined && BigInt(channel.balance) <= BigInt(charged)) {\n throw new Error(\n `Refund failed: channel has no remaining balance (balance=${channel.balance}, chargedCumulativeAmount=${charged})`,\n );\n }\n\n const voucherSigner = ctx.voucherSigner ?? ctx.signer;\n const voucher = await signVoucher(voucherSigner, channelId, charged, requirements.network);\n\n const payload: BatchSettlementRefundPayload = {\n type: \"refund\",\n channelConfig: config,\n voucher,\n ...(refundAmount !== undefined ? { amount: refundAmount } : {}),\n };\n\n return {\n x402Version: 2,\n accepted: requirements,\n payload: payload as unknown as Record<string, unknown>,\n ...(paymentRequired.resource ? { resource: paymentRequired.resource } : {}),\n ...(paymentRequired.extensions ? { extensions: paymentRequired.extensions } : {}),\n };\n}\n\n/**\n * Creates an x402 HTTP client for batch settlement with hooks; refund payloads are supplied\n * by {@link refundChannel} instead of the default payment builder.\n *\n * @param ctx - Identity inputs (storage, signers, salt, payerAuthorizer).\n * @param requirements - Resolved payment requirements for the channel network.\n * @returns An `x402HTTPClient` wired for batch-settlement scheme hooks.\n */\nfunction createRefundHttpClient(\n ctx: BatchSettlementClientDeps,\n requirements: PaymentRequirements,\n): x402HTTPClient {\n const client = new x402Client().register(requirements.network, {\n scheme: BATCH_SETTLEMENT_SCHEME,\n schemeHooks: createBatchSettlementClientHooks(ctx),\n createPaymentPayload: async () => {\n throw new Error(\"Refund payloads are built by refundChannel\");\n },\n });\n return new x402HTTPClient(client);\n}\n\n/**\n * If the refund HTTP response cannot be recovered by retrying, returns a user-facing message;\n * otherwise returns `undefined`.\n *\n * @param response - The refund request response (402 with headers or settle failure).\n * @returns A formatted failure string, or `undefined` when retry may succeed.\n */\nfunction getNonRecoverableRefundFailure(response: Response): string | undefined {\n const settleHeader = response.headers.get(\"PAYMENT-RESPONSE\");\n if (settleHeader) {\n return formatRefundFailure(decodePaymentResponseHeader(settleHeader));\n }\n\n const paymentRequired = getRefundPaymentRequired(response);\n const errorCode = paymentRequired.error;\n if (errorCode && NON_RECOVERABLE_REFUND_ERRORS.has(errorCode)) {\n return `Refund failed: ${errorCode}`;\n }\n}\n\n/**\n * Reads and decodes the `PAYMENT-REQUIRED` header from a refund-related 402 response.\n *\n * @param response - HTTP response that must include `PAYMENT-REQUIRED`.\n * @returns The decoded {@link PaymentRequired} payload.\n * @throws When the header is missing.\n */\nfunction getRefundPaymentRequired(response: Response): PaymentRequired {\n const requiredHeader = response.headers.get(\"PAYMENT-REQUIRED\");\n if (!requiredHeader) {\n throw new Error(\"Refund 402 missing PAYMENT-REQUIRED header\");\n }\n return decodePaymentRequiredHeader(requiredHeader);\n}\n\n/**\n * Builds a human-readable error message from a settle failure response.\n *\n * @param settle - The decoded SettleResponse from the server's 402 reply.\n * @returns A formatted error string suitable for `throw new Error(...)`.\n */\nfunction formatRefundFailure(settle: SettleResponse): string {\n const reason = settle.errorReason ?? \"unknown_settlement_error\";\n const message = settle.errorMessage;\n if (message && message !== reason) {\n return `Refund failed: ${reason}: ${message}`;\n }\n return `Refund failed: ${reason}`;\n}\n\n/**\n * Validates and normalises the optional `refundAmount` argument.\n *\n * @param amount - Raw amount from caller (string of base units).\n * @returns The same string when valid, or `undefined` when omitted.\n */\nfunction normalizeRefundAmount(amount: string | undefined): string | undefined {\n if (amount === undefined) return undefined;\n if (!/^\\d+$/.test(amount) || amount === \"0\") {\n throw new Error(`Invalid refund amount \"${amount}\": must be a positive integer string`);\n }\n return amount;\n}\n","import {\n SchemeNetworkClient,\n SchemeClientHooks,\n PaymentRequired,\n PaymentRequirements,\n PaymentPayloadResult,\n PaymentPayloadContext,\n SettleResponse,\n} from \"@x402/core/types\";\nimport { getAddress } from \"viem\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { BATCH_SETTLEMENT_SCHEME } from \"../constants\";\nimport {\n BatchSettlementAssetTransferMethod,\n BatchSettlementVoucherPayload,\n ChannelConfig,\n} from \"../types\";\nimport { computeChannelId } from \"../utils\";\nimport {\n trySignEip2612PermitExtension,\n trySignErc20ApprovalExtension,\n} from \"../../shared/extensions\";\nimport type { EvmSchemeOptions } from \"../../shared/rpc\";\nimport { createBatchSettlementEIP3009DepositPayload } from \"./eip3009\";\nimport { createBatchSettlementPermit2DepositPayload } from \"./permit2\";\nimport {\n type BatchSettlementDepositStrategy,\n type BatchSettlementDepositStrategyContext,\n type BatchSettlementDepositPolicy,\n type BatchSettlementEvmSchemeOptions,\n applyMaxDeposit,\n depositAmountForRequest,\n maxDepositFromSpendCap,\n resolveClientOptions,\n validateDepositPolicy,\n} from \"./config\";\nimport { refundChannel, type RefundOptions } from \"./refund\";\nimport { type BatchSettlementClientDeps, buildChannelConfig, recoverChannel } from \"./channel\";\nimport { createBatchSettlementClientHooks } from \"./hooks\";\nimport { processCorrectivePaymentRequired } from \"./recovery\";\nimport type { ClientChannelStorage } from \"./storage\";\nimport { findDefaultAsset } from \"../../defaultAssets\";\nimport { signVoucher } from \"./voucher\";\n\nexport type { BatchSettlementClientContext } from \"./storage\";\nexport type {\n BatchSettlementDepositPolicy,\n BatchSettlementDepositStrategy,\n BatchSettlementDepositStrategyContext,\n BatchSettlementDepositStrategyResult,\n BatchSettlementEvmSchemeOptions,\n} from \"./config\";\nexport type { RefundOptions } from \"./refund\";\n\n/**\n * Client-side implementation of the `batch-settlement` scheme for EVM networks.\n *\n * Builds payment payloads (deposit + voucher or voucher-only), updates local\n * channel state from payment-response hooks, handles corrective 402\n * resynchronisation via {@link processCorrectivePaymentRequired}, and supports\n * on-demand cooperative refund requests via {@link refundChannel}.\n */\nexport class BatchSettlementEvmScheme implements SchemeNetworkClient {\n readonly scheme = BATCH_SETTLEMENT_SCHEME;\n findDefaultAsset = findDefaultAsset;\n\n readonly schemeHooks: SchemeClientHooks;\n\n private readonly storage: ClientChannelStorage;\n private readonly depositPolicy: BatchSettlementDepositPolicy | undefined;\n private readonly depositStrategy: BatchSettlementDepositStrategy | undefined;\n private readonly salt: `0x${string}`;\n private readonly payerAuthorizer: `0x${string}` | undefined;\n private readonly voucherSigner: ClientEvmSigner | undefined;\n private readonly extensionRpcOptions: EvmSchemeOptions | undefined;\n\n /**\n * Constructs a batched client scheme.\n *\n * @param signer - Client EVM wallet used for signing vouchers and ERC-3009 authorizations.\n * @param optionsOrPolicy - Either a full options object or a bare deposit-policy.\n */\n constructor(\n private readonly signer: ClientEvmSigner,\n optionsOrPolicy?: BatchSettlementEvmSchemeOptions | BatchSettlementDepositPolicy,\n ) {\n const {\n storage,\n depositPolicy,\n depositStrategy,\n salt,\n payerAuthorizer,\n voucherSigner,\n extensionRpcOptions,\n } = resolveClientOptions(optionsOrPolicy);\n this.storage = storage;\n this.depositPolicy = depositPolicy;\n this.depositStrategy = depositStrategy;\n this.salt = salt;\n this.payerAuthorizer = payerAuthorizer;\n this.voucherSigner = voucherSigner;\n this.extensionRpcOptions = extensionRpcOptions;\n\n if (\n payerAuthorizer !== undefined &&\n voucherSigner !== undefined &&\n getAddress(payerAuthorizer) !== getAddress(voucherSigner.address)\n ) {\n throw new Error(\"payerAuthorizer address must match voucherSigner.address\");\n }\n\n validateDepositPolicy(depositPolicy);\n this.schemeHooks = createBatchSettlementClientHooks(this.deps());\n }\n\n /**\n * Creates the payment payload for a batched request.\n *\n * If the channel has no onchain deposit (or needs a top-up), builds an\n * ERC-3009 deposit payload bundled with a voucher. Otherwise, signs and\n * returns a voucher-only payload.\n *\n * @param x402Version - Protocol version for the payload envelope.\n * @param paymentRequirements - Server payment requirements (scheme, network, asset, amount).\n * @param context - Optional extensions and the resolved atomic spend cap.\n * @returns A {@link PaymentPayloadResult} ready to be sent as the `X-PAYMENT` header.\n */\n async createPaymentPayload(\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n context?: PaymentPayloadContext,\n ): Promise<PaymentPayloadResult> {\n const deps = this.deps();\n const config = buildChannelConfig(deps, paymentRequirements);\n const channelId = computeChannelId(config, paymentRequirements.network);\n const key = channelId.toLowerCase();\n\n let batchedCtx = await this.storage.get(key);\n if (batchedCtx === undefined && this.signer.readContract) {\n batchedCtx = await recoverChannel(deps, paymentRequirements);\n }\n batchedCtx = batchedCtx ?? {};\n\n const needsInitialDeposit = !batchedCtx.balance || batchedCtx.balance === \"0\";\n\n const baseCumulative = BigInt(batchedCtx.chargedCumulativeAmount ?? \"0\");\n const requestAmount = BigInt(paymentRequirements.amount);\n const maxClaimableAmount = (baseCumulative + requestAmount).toString();\n\n const currentBalance = BigInt(batchedCtx.balance ?? \"0\");\n const needsTopUp = !needsInitialDeposit && BigInt(maxClaimableAmount) > currentBalance;\n\n if (needsInitialDeposit || needsTopUp) {\n const minimumDepositAmount = BigInt(maxClaimableAmount) - currentBalance;\n const maxDeposit = maxDepositFromSpendCap(\n context?.maxAmountPerPayment,\n this.depositPolicy?.depositMultiplier ?? 5,\n );\n const computedDeposit = depositAmountForRequest(\n this.depositPolicy,\n requestAmount,\n minimumDepositAmount,\n paymentRequirements.extra,\n maxDeposit,\n );\n const depositAmount = await this.resolveDepositAmount({\n paymentRequirements,\n channelConfig: config,\n channelId,\n clientContext: batchedCtx,\n requestAmount: requestAmount.toString(),\n maxClaimableAmount,\n currentBalance: currentBalance.toString(),\n minimumDepositAmount: minimumDepositAmount.toString(),\n depositAmount: computedDeposit,\n ...(maxDeposit !== undefined ? { maxDeposit: maxDeposit.toString() } : {}),\n });\n if (depositAmount === false) {\n return this.createVoucherPayload(\n x402Version,\n channelId,\n maxClaimableAmount,\n paymentRequirements.network,\n config,\n );\n }\n\n const assetTransferMethod =\n (paymentRequirements.extra?.assetTransferMethod as BatchSettlementAssetTransferMethod) ??\n \"eip3009\";\n\n if (assetTransferMethod === \"eip3009\") {\n return createBatchSettlementEIP3009DepositPayload(\n this.signer,\n x402Version,\n paymentRequirements,\n config,\n depositAmount,\n maxClaimableAmount,\n this.voucherSigner,\n );\n }\n\n if (assetTransferMethod !== \"permit2\") {\n throw new Error(`unsupported batch-settlement assetTransferMethod: ${assetTransferMethod}`);\n }\n\n const result = await createBatchSettlementPermit2DepositPayload(\n this.signer,\n x402Version,\n paymentRequirements,\n config,\n depositAmount,\n maxClaimableAmount,\n this.voucherSigner,\n );\n\n const eip2612Extensions = await trySignEip2612PermitExtension(\n this.signer,\n this.extensionRpcOptions,\n paymentRequirements,\n result,\n context,\n depositAmount,\n );\n if (eip2612Extensions) {\n return { ...result, extensions: eip2612Extensions };\n }\n\n const erc20Extensions = await trySignErc20ApprovalExtension(\n this.signer,\n this.extensionRpcOptions,\n paymentRequirements,\n context,\n depositAmount,\n );\n if (erc20Extensions) {\n return { ...result, extensions: erc20Extensions };\n }\n\n return result;\n }\n\n return this.createVoucherPayload(\n x402Version,\n channelId,\n maxClaimableAmount,\n paymentRequirements.network,\n config,\n );\n }\n\n /**\n * Sends a cooperative refund request.\n *\n * @param url - The route URL backing the channel to refund.\n * @param options - Optional `amount` (partial refund) and `fetch` override.\n * @returns The settle response describing the refund outcome.\n */\n async refund(url: string, options?: RefundOptions): Promise<SettleResponse> {\n return refundChannel(this.deps(), url, options);\n }\n\n /**\n * Resyncs local channel state from a corrective 402 response.\n *\n * @param paymentRequired - The decoded 402 response body.\n * @returns `true` if local state was successfully resynced and a retry is warranted.\n */\n async processCorrectivePaymentRequired(paymentRequired: PaymentRequired): Promise<boolean> {\n return processCorrectivePaymentRequired(this.deps(), paymentRequired);\n }\n\n /**\n * Builds the immutable {@link ChannelConfig} for a given set of payment\n * requirements, using the scheme's own signer and salt.\n *\n * @param paymentRequirements - Server payment requirements for the channel.\n * @returns The channel config that uniquely identifies the payment channel.\n */\n buildChannelConfig(paymentRequirements: PaymentRequirements): ChannelConfig {\n return buildChannelConfig(this.deps(), paymentRequirements);\n }\n\n /**\n * Resolves the deposit amount after applying the optional custom strategy.\n *\n * @param context - Deposit attempt context exposed to the strategy.\n * @returns The deposit amount to sign, or `false` to skip this deposit attempt.\n */\n private async resolveDepositAmount(\n context: BatchSettlementDepositStrategyContext,\n ): Promise<string | false> {\n const strategyResult = await this.depositStrategy?.(context);\n if (strategyResult === false) return false;\n if (strategyResult === undefined) return context.depositAmount;\n\n const depositAmount = this.normalizeStrategyDepositAmount(strategyResult);\n if (BigInt(depositAmount) < BigInt(context.minimumDepositAmount)) {\n throw new Error(\n `depositStrategy returned ${depositAmount}, below required top-up ${context.minimumDepositAmount}`,\n );\n }\n return applyMaxDeposit(\n BigInt(depositAmount),\n BigInt(context.minimumDepositAmount),\n context.maxDeposit === undefined ? undefined : BigInt(context.maxDeposit),\n );\n }\n\n /**\n * Normalizes and validates a strategy-provided base-unit deposit amount.\n *\n * @param value - Strategy-provided string or bigint amount.\n * @returns Normalized decimal string.\n */\n private normalizeStrategyDepositAmount(value: string | bigint): string {\n if (typeof value === \"bigint\") {\n if (value <= 0n) {\n throw new Error(\"depositStrategy must return a positive integer deposit amount\");\n }\n return value.toString();\n }\n\n if (/^\\d+$/.test(value) && BigInt(value) > 0n) {\n return BigInt(value).toString();\n }\n\n throw new Error(\"depositStrategy must return a positive integer deposit amount\");\n }\n\n /**\n * Signs a voucher-only payment payload for the current channel.\n *\n * @param x402Version - Protocol version for the payload envelope.\n * @param channelId - Channel identifier for the voucher.\n * @param maxClaimableAmount - Cumulative ceiling for the voucher.\n * @param network - CAIP-2 network identifier.\n * @param config - Immutable channel configuration.\n * @returns Voucher-only payment payload.\n */\n private async createVoucherPayload(\n x402Version: number,\n channelId: `0x${string}`,\n maxClaimableAmount: string,\n network: string,\n config: ChannelConfig,\n ): Promise<PaymentPayloadResult> {\n const voucherSigner = this.voucherSigner ?? this.signer;\n const voucher = await signVoucher(voucherSigner, channelId, maxClaimableAmount, network);\n\n const payload: BatchSettlementVoucherPayload = {\n type: \"voucher\",\n channelConfig: config,\n voucher,\n };\n\n return {\n x402Version,\n payload,\n };\n }\n\n /**\n * Bundles the class state into the {@link BatchSettlementClientDeps} shape\n * consumed by the `channel`, `recovery`, and `refund` modules.\n *\n * @returns Client deps wrapping the scheme's own signer and storage.\n */\n private deps(): BatchSettlementClientDeps {\n return {\n signer: this.signer,\n storage: this.storage,\n salt: this.salt,\n payerAuthorizer: this.payerAuthorizer,\n voucherSigner: this.voucherSigner,\n };\n }\n}\n","import { PaymentRequirements, PaymentPayloadResult } from \"@x402/core/types\";\nimport { getAddress } from \"viem\";\nimport { PERMIT2_ADDRESS } from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { createPermit2Nonce, getEvmChainId } from \"../../utils\";\nimport { PERMIT2_DEPOSIT_COLLECTOR_ADDRESS, batchPermit2WitnessTypes } from \"../constants\";\nimport { ChannelConfig, BatchSettlementDepositPayload } from \"../types\";\nimport { computeChannelId } from \"../utils\";\nimport { signVoucher } from \"./voucher\";\n\n/**\n * Builds a batch deposit payload using a channel-bound Permit2 witness transfer.\n *\n * @param signer - Payer signer for the Permit2 authorization.\n * @param x402Version - Protocol version for the payment envelope.\n * @param paymentRequirements - Server-provided payment requirements.\n * @param channelConfig - Channel configuration bound into the voucher and witness.\n * @param depositAmount - Token amount deposited into the channel.\n * @param maxClaimableAmount - Cumulative amount signed in the voucher.\n * @param voucherSigner - Optional signer for the voucher.\n * @returns Signed deposit payload and voucher.\n */\nexport async function createBatchSettlementPermit2DepositPayload(\n signer: ClientEvmSigner,\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n channelConfig: ChannelConfig,\n depositAmount: string,\n maxClaimableAmount: string,\n voucherSigner?: ClientEvmSigner,\n): Promise<PaymentPayloadResult> {\n const chainId = getEvmChainId(paymentRequirements.network);\n const nonce = createPermit2Nonce();\n const deadline = Math.floor(Date.now() / 1000 + paymentRequirements.maxTimeoutSeconds).toString();\n const channelId = computeChannelId(channelConfig, paymentRequirements.network);\n\n const permit2Authorization = {\n from: signer.address,\n permitted: {\n token: getAddress(paymentRequirements.asset),\n amount: depositAmount,\n },\n spender: getAddress(PERMIT2_DEPOSIT_COLLECTOR_ADDRESS),\n nonce,\n deadline,\n witness: {\n channelId,\n },\n };\n\n const signature = await signer.signTypedData({\n domain: { name: \"Permit2\", chainId, verifyingContract: PERMIT2_ADDRESS },\n types: batchPermit2WitnessTypes,\n primaryType: \"PermitWitnessTransferFrom\",\n message: {\n permitted: {\n token: permit2Authorization.permitted.token,\n amount: BigInt(permit2Authorization.permitted.amount),\n },\n spender: permit2Authorization.spender,\n nonce: BigInt(permit2Authorization.nonce),\n deadline: BigInt(permit2Authorization.deadline),\n witness: {\n channelId,\n },\n },\n });\n\n const voucher = await signVoucher(\n voucherSigner ?? signer,\n channelId,\n maxClaimableAmount,\n paymentRequirements.network,\n );\n\n const payload: BatchSettlementDepositPayload = {\n type: \"deposit\",\n channelConfig,\n voucher,\n deposit: {\n amount: depositAmount,\n authorization: {\n permit2Authorization: {\n ...permit2Authorization,\n signature,\n },\n },\n },\n };\n\n return { x402Version, payload };\n}\n","import {\n PaymentPayload,\n PaymentPayloadResult,\n PaymentRequirements,\n FacilitatorContext,\n SettleResponse,\n VerifyResponse,\n} from \"@x402/core/types\";\nimport {\n extractEip2612GasSponsoringInfo,\n validateEip2612GasSponsoringInfo,\n extractErc20ApprovalGasSponsoringInfo,\n ERC20_APPROVAL_GAS_SPONSORING_KEY,\n type Eip2612GasSponsoringInfo,\n type Erc20ApprovalGasSponsoringFacilitatorExtension,\n type Erc20ApprovalGasSponsoringSigner,\n} from \"../exact/extensions\";\nimport { getAddress, encodeFunctionData, parseErc6492Signature } from \"viem\";\nimport { PERMIT2_ADDRESS, eip3009ABI, erc20AllowanceAbi, permit2WitnessTypes } from \"../constants\";\nimport { multicall, ContractCall } from \"../multicall\";\nimport { createPermit2Nonce, getEvmChainId, truncateErrorMessage } from \"../utils\";\nimport {\n ErrPermit2612AmountMismatch,\n ErrPermit2InvalidAmount,\n ErrPermit2InvalidDestination,\n ErrPermit2InvalidNonce,\n ErrPermit2InvalidOwner,\n ErrPermit2InvalidSignature,\n ErrPermit2PaymentTooEarly,\n ErrPermit2AllowanceRequired,\n ErrPermit2SimulationFailed,\n ErrPermit2InsufficientBalance,\n ErrPermit2ProxyNotDeployed,\n ErrTransactionFailed,\n ErrInvalidEip2612ExtensionFormat,\n ErrEip2612FromMismatch,\n ErrEip2612AssetMismatch,\n ErrEip2612SpenderNotPermit2,\n ErrEip2612DeadlineExpired,\n ErrErc20ApprovalBroadcastFailed,\n ErrErc20ApprovalTxFailed,\n} from \"../exact/facilitator/errors\";\nimport { ClientEvmSigner, FacilitatorEvmSigner } from \"../signer\";\nimport { ExactPermit2Payload, Permit2Authorization, UptoPermit2Payload } from \"../types\";\nimport { validateErc20ApprovalForPayment } from \"./erc20approval\";\nimport {\n ErrUptoAmountExceedsPermitted,\n ErrUptoUnauthorizedFacilitator,\n} from \"../upto/facilitator/errors\";\n\n/**\n * Base type for Permit2 payloads shared between exact and upto schemes.\n * Both {@link ExactPermit2Payload} and {@link UptoPermit2Payload} satisfy this type.\n */\nexport type Permit2PayloadBase = ExactPermit2Payload | UptoPermit2Payload;\n\n/**\n * Configuration for the Permit2 proxy contract used during settlement.\n * The exact and upto schemes use different proxy addresses and ABIs.\n */\nexport type Permit2ProxyConfig = {\n /** The deployed proxy contract address. */\n proxyAddress: `0x${string}`;\n /** The proxy contract ABI (must include settle and settleWithPermit functions). */\n proxyABI: readonly Record<string, unknown>[];\n};\n\n/**\n * Checks Permit2 allowance and validates gas sponsoring extensions if allowance is insufficient.\n *\n * When the on-chain ERC-20 allowance to the Permit2 contract is below the required amount,\n * this function falls back to validating EIP-2612 or ERC-20 approval gas sponsoring extensions\n * attached to the payment payload.\n *\n * @param signer - The facilitator signer for on-chain reads\n * @param payload - The payment payload\n * @param requirements - The payment requirements\n * @param payer - The payer address\n * @param tokenAddress - The token contract address\n * @param context - Optional facilitator context for extension lookup\n * @returns A VerifyResponse if verification should stop (failure), or null to continue\n */\nexport async function verifyPermit2Allowance(\n signer: FacilitatorEvmSigner,\n payload: PaymentPayload,\n requirements: PaymentRequirements,\n payer: `0x${string}`,\n tokenAddress: `0x${string}`,\n context?: FacilitatorContext,\n): Promise<VerifyResponse | null> {\n try {\n const allowance = (await signer.readContract({\n address: tokenAddress,\n abi: erc20AllowanceAbi,\n functionName: \"allowance\",\n args: [payer, PERMIT2_ADDRESS],\n })) as bigint;\n\n if (allowance >= BigInt(requirements.amount)) {\n return null; // Sufficient allowance, continue verification\n }\n\n // Allowance insufficient — try EIP-2612 gas sponsoring first\n const eip2612Info = extractEip2612GasSponsoringInfo(payload);\n if (eip2612Info) {\n const result = validateEip2612PermitForPayment(eip2612Info, payer, tokenAddress);\n if (!result.isValid) {\n return { isValid: false, invalidReason: result.invalidReason!, payer };\n }\n return null; // EIP-2612 is valid, allowance will be set atomically during settlement\n }\n\n // Try ERC-20 approval gas sponsoring as fallback\n const erc20GasSponsorshipExtension =\n context?.getExtension<Erc20ApprovalGasSponsoringFacilitatorExtension>(\n ERC20_APPROVAL_GAS_SPONSORING_KEY,\n );\n if (erc20GasSponsorshipExtension) {\n const erc20Info = extractErc20ApprovalGasSponsoringInfo(payload);\n if (erc20Info) {\n const result = await validateErc20ApprovalForPayment(erc20Info, payer, tokenAddress);\n if (!result.isValid) {\n return { isValid: false, invalidReason: result.invalidReason!, payer };\n }\n return null; // ERC-20 approval is valid, will be broadcast before settlement\n }\n }\n\n return { isValid: false, invalidReason: \"permit2_allowance_required\", payer };\n } catch {\n // Allowance check failed — validate extensions if present; fail closed if none valid\n const eip2612Info = extractEip2612GasSponsoringInfo(payload);\n if (eip2612Info) {\n const result = validateEip2612PermitForPayment(eip2612Info, payer, tokenAddress);\n if (!result.isValid) {\n return { isValid: false, invalidReason: result.invalidReason!, payer };\n }\n return null;\n }\n\n const erc20GasSponsorshipExtension =\n context?.getExtension<Erc20ApprovalGasSponsoringFacilitatorExtension>(\n ERC20_APPROVAL_GAS_SPONSORING_KEY,\n );\n if (erc20GasSponsorshipExtension) {\n const erc20Info = extractErc20ApprovalGasSponsoringInfo(payload);\n if (erc20Info) {\n const result = await validateErc20ApprovalForPayment(erc20Info, payer, tokenAddress);\n if (!result.isValid) {\n return { isValid: false, invalidReason: result.invalidReason!, payer };\n }\n return null;\n }\n }\n\n return { isValid: false, invalidReason: \"permit2_allowance_required\", payer };\n }\n}\n\n/**\n * Maps contract revert errors to structured SettleResponse error reasons.\n *\n * Inspects the error message for known contract revert strings and maps them\n * to the corresponding error reason constants. Falls back to a generic\n * \"transaction_failed\" reason with truncated message for unrecognized errors.\n *\n * @param error - The caught error (typically from a contract write)\n * @param payload - The payment payload (for network info)\n * @param payer - The payer address\n * @returns A failed SettleResponse with the mapped error reason\n */\nexport function mapSettleError(\n error: unknown,\n payload: PaymentPayload,\n payer: `0x${string}`,\n): SettleResponse {\n let errorReason: string = ErrTransactionFailed;\n if (error instanceof Error) {\n const message = error.message;\n if (message.includes(\"Permit2612AmountMismatch\")) {\n errorReason = ErrPermit2612AmountMismatch;\n } else if (message.includes(\"InvalidAmount\")) {\n errorReason = ErrPermit2InvalidAmount;\n } else if (message.includes(\"InvalidDestination\")) {\n errorReason = ErrPermit2InvalidDestination;\n } else if (message.includes(\"InvalidOwner\")) {\n errorReason = ErrPermit2InvalidOwner;\n } else if (message.includes(\"PaymentTooEarly\")) {\n errorReason = ErrPermit2PaymentTooEarly;\n } else if (message.includes(\"InvalidSignature\") || message.includes(\"SignatureExpired\")) {\n errorReason = ErrPermit2InvalidSignature;\n } else if (message.includes(\"InvalidNonce\")) {\n errorReason = ErrPermit2InvalidNonce;\n } else if (message.includes(ErrErc20ApprovalTxFailed)) {\n errorReason = ErrErc20ApprovalBroadcastFailed;\n } else if (message.includes(\"AmountExceedsPermitted\")) {\n errorReason = ErrUptoAmountExceedsPermitted;\n } else if (message.includes(\"UnauthorizedFacilitator\")) {\n errorReason = ErrUptoUnauthorizedFacilitator;\n } else {\n errorReason = `${ErrTransactionFailed}: ${truncateErrorMessage(message)}`;\n }\n }\n return {\n success: false,\n errorReason,\n transaction: \"\",\n network: payload.accepted.network,\n payer,\n };\n}\n\n/**\n * Validates EIP-2612 permit extension data for a Permit2 payment.\n *\n * Checks that the permit extension has a valid format and that the from address,\n * asset address, spender address, and deadline all match expectations.\n *\n * @param info - The EIP-2612 gas sponsoring info extracted from the payment payload\n * @param payer - The expected payer address\n * @param tokenAddress - The expected token address\n * @returns Validation result with isValid flag and optional invalidReason string\n */\nexport function validateEip2612PermitForPayment(\n info: Eip2612GasSponsoringInfo,\n payer: `0x${string}`,\n tokenAddress: `0x${string}`,\n): { isValid: boolean; invalidReason?: string } {\n if (!validateEip2612GasSponsoringInfo(info)) {\n return { isValid: false, invalidReason: ErrInvalidEip2612ExtensionFormat };\n }\n\n if (getAddress(info.from as `0x${string}`) !== getAddress(payer)) {\n return { isValid: false, invalidReason: ErrEip2612FromMismatch };\n }\n\n if (getAddress(info.asset as `0x${string}`) !== tokenAddress) {\n return { isValid: false, invalidReason: ErrEip2612AssetMismatch };\n }\n\n if (getAddress(info.spender as `0x${string}`) !== getAddress(PERMIT2_ADDRESS)) {\n return { isValid: false, invalidReason: ErrEip2612SpenderNotPermit2 };\n }\n\n const now = Math.floor(Date.now() / 1000);\n if (BigInt(info.deadline) < BigInt(now + 6)) {\n return { isValid: false, invalidReason: ErrEip2612DeadlineExpired };\n }\n\n return { isValid: true };\n}\n\n// ---------------------------------------------------------------------------\n// Simulation helpers (shared across exact and upto)\n// ---------------------------------------------------------------------------\n\n/**\n * Simulates settle() via eth_call (readContract).\n * Returns true if simulation succeeded, false if it failed.\n *\n * @param config - The proxy contract configuration (address and ABI)\n * @param signer - EVM signer for contract reads\n * @param settleArgs - Pre-built settle function arguments (scheme-specific)\n * @returns true if simulation succeeded, false if it failed\n */\nexport async function simulatePermit2Settle(\n config: Permit2ProxyConfig,\n signer: FacilitatorEvmSigner,\n settleArgs: readonly unknown[],\n): Promise<boolean> {\n try {\n await signer.readContract({\n address: config.proxyAddress,\n abi: config.proxyABI,\n functionName: \"settle\",\n args: settleArgs,\n });\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * Simulates settleWithPermit() via eth_call (readContract).\n * The contract atomically calls token.permit() then PERMIT2.permitTransferFrom(),\n * so simulation covers allowance + balance + nonces.\n *\n * @param config - The proxy contract configuration (address and ABI)\n * @param signer - EVM signer for contract reads\n * @param settleArgs - Pre-built settle function arguments (scheme-specific)\n * @param eip2612Info - EIP-2612 gas sponsoring info from the payload extension\n * @returns true if simulation succeeded, false if it failed\n */\nexport async function simulatePermit2SettleWithPermit(\n config: Permit2ProxyConfig,\n signer: FacilitatorEvmSigner,\n settleArgs: readonly unknown[],\n eip2612Info: Eip2612GasSponsoringInfo,\n): Promise<boolean> {\n try {\n const { v, r, s } = splitEip2612Signature(eip2612Info.signature);\n\n await signer.readContract({\n address: config.proxyAddress,\n abi: config.proxyABI,\n functionName: \"settleWithPermit\",\n args: [\n {\n value: BigInt(eip2612Info.amount),\n deadline: BigInt(eip2612Info.deadline),\n r,\n s,\n v,\n },\n ...settleArgs,\n ],\n });\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * Delegates the full approve+settle simulation flow to the extension signer via simulateTransactions.\n * The signer owns execution strategy.\n *\n * @param config - The proxy contract configuration (address and ABI)\n * @param extensionSigner - The extension signer with simulateTransactions capability\n * @param settleArgs - Pre-built settle function arguments (scheme-specific)\n * @param erc20Info - Object containing the signed approval transaction\n * @param erc20Info.signedTransaction - The RLP-encoded signed ERC-20 approve transaction hex string\n * @returns true if the bundle simulation succeeded, false otherwise\n */\nexport async function simulatePermit2SettleWithErc20Approval(\n config: Permit2ProxyConfig,\n extensionSigner: Erc20ApprovalGasSponsoringSigner,\n settleArgs: readonly unknown[],\n erc20Info: { signedTransaction: string },\n): Promise<boolean> {\n if (!extensionSigner.simulateTransactions) {\n return false;\n }\n\n try {\n const settleData = encodeFunctionData({\n abi: config.proxyABI,\n functionName: \"settle\",\n args: settleArgs,\n });\n\n return await extensionSigner.simulateTransactions([\n erc20Info.signedTransaction as `0x${string}`,\n { to: config.proxyAddress, data: settleData, gas: BigInt(300_000) },\n ]);\n } catch {\n return false;\n }\n}\n\n/**\n * Diagnoses a Permit2 simulation failure by performing a multicall to check the proxy deployment, balance and allowance.\n *\n * @param config - The proxy contract configuration (address and ABI)\n * @param signer - EVM signer for contract reads\n * @param tokenAddress - ERC-20 token contract address\n * @param permit2Payload - The Permit2 authorization payload\n * @param amountRequired - Required payment amount (as string)\n * @returns VerifyResponse with the most specific failure reason\n */\nexport async function diagnosePermit2SimulationFailure(\n config: Permit2ProxyConfig,\n signer: FacilitatorEvmSigner,\n tokenAddress: `0x${string}`,\n permit2Payload: Permit2PayloadBase,\n amountRequired: string,\n): Promise<VerifyResponse> {\n const payer = permit2Payload.permit2Authorization.from;\n\n const diagnosticCalls: ContractCall[] = [\n {\n address: config.proxyAddress,\n abi: config.proxyABI,\n functionName: \"PERMIT2\",\n },\n {\n address: tokenAddress,\n abi: eip3009ABI,\n functionName: \"balanceOf\",\n args: [payer],\n },\n {\n address: tokenAddress,\n abi: erc20AllowanceAbi,\n functionName: \"allowance\",\n args: [payer, PERMIT2_ADDRESS],\n },\n ];\n\n try {\n const results = await multicall(signer.readContract.bind(signer), diagnosticCalls);\n\n const [proxyResult, balanceResult, allowanceResult] = results;\n\n if (proxyResult.status === \"failure\") {\n return { isValid: false, invalidReason: ErrPermit2ProxyNotDeployed, payer };\n }\n\n if (balanceResult.status === \"success\") {\n const balance = balanceResult.result as bigint;\n if (balance < BigInt(amountRequired)) {\n return { isValid: false, invalidReason: ErrPermit2InsufficientBalance, payer };\n }\n }\n\n if (allowanceResult.status === \"success\") {\n const allowance = allowanceResult.result as bigint;\n if (allowance < BigInt(amountRequired)) {\n return { isValid: false, invalidReason: ErrPermit2AllowanceRequired, payer };\n }\n }\n } catch {\n // Diagnostic multicall itself failed — fall through to generic error\n }\n\n return { isValid: false, invalidReason: ErrPermit2SimulationFailed, payer };\n}\n\n/**\n * Targeted multicall for the ERC-20 approval path where simulation cannot be used\n * (the approval hasn't been broadcast yet, so settle() would fail for expected reasons).\n * Checks proxy deployment, payer token balance and payer ETH balance for gas.\n *\n * @param config - The proxy contract configuration (address and ABI)\n * @param signer - EVM signer for contract reads\n * @param tokenAddress - ERC-20 token contract address\n * @param payer - The payer address\n * @param amountRequired - Required payment amount (as string)\n * @returns VerifyResponse — valid if checks pass, otherwise the most specific failure\n */\nexport async function checkPermit2Prerequisites(\n config: Permit2ProxyConfig,\n signer: FacilitatorEvmSigner,\n tokenAddress: `0x${string}`,\n payer: `0x${string}`,\n amountRequired: string,\n): Promise<VerifyResponse> {\n const diagnosticCalls: ContractCall[] = [\n {\n address: config.proxyAddress,\n abi: config.proxyABI,\n functionName: \"PERMIT2\",\n },\n {\n address: tokenAddress,\n abi: eip3009ABI,\n functionName: \"balanceOf\",\n args: [payer],\n },\n ];\n\n try {\n const results = await multicall(signer.readContract.bind(signer), diagnosticCalls);\n\n const [proxyResult, balanceResult] = results;\n\n if (proxyResult.status === \"failure\") {\n return { isValid: false, invalidReason: ErrPermit2ProxyNotDeployed, payer };\n }\n\n if (balanceResult.status === \"success\") {\n const balance = balanceResult.result as bigint;\n if (balance < BigInt(amountRequired)) {\n return { isValid: false, invalidReason: ErrPermit2InsufficientBalance, payer };\n }\n }\n } catch {\n // Multicall failed — fall through to valid (fail open for prerequisites-only check)\n }\n\n return { isValid: true, invalidReason: undefined, payer };\n}\n\n/**\n * Builds args for exact settle(permit, owner, witness, signature).\n *\n * @param permit2Payload - The Permit2 payload containing authorization and signature data\n * @returns Tuple of contract call arguments for the exact settle function\n */\nexport function buildExactPermit2SettleArgs(permit2Payload: Permit2PayloadBase) {\n const { signature } = parseErc6492Signature(permit2Payload.signature);\n\n return [\n {\n permitted: {\n token: getAddress(permit2Payload.permit2Authorization.permitted.token),\n amount: BigInt(permit2Payload.permit2Authorization.permitted.amount),\n },\n nonce: BigInt(permit2Payload.permit2Authorization.nonce),\n deadline: BigInt(permit2Payload.permit2Authorization.deadline),\n },\n getAddress(permit2Payload.permit2Authorization.from),\n {\n to: getAddress(permit2Payload.permit2Authorization.witness.to),\n validAfter: BigInt(permit2Payload.permit2Authorization.witness.validAfter),\n },\n signature,\n ] as const;\n}\n\n/**\n * Builds args for upto settle(permit, amount, owner, witness, signature).\n * The upto contract's settle() takes an additional `amount` parameter and the witness\n * includes a `facilitator` field.\n *\n * @param permit2Payload - The upto Permit2 payload containing authorization and signature data\n * @param settlementAmount - The amount to settle on-chain\n * @param facilitatorAddress - The facilitator address authorized in the witness\n * @returns Tuple of contract call arguments for the upto settle function\n */\nexport function buildUptoPermit2SettleArgs(\n permit2Payload: UptoPermit2Payload,\n settlementAmount: bigint,\n facilitatorAddress: `0x${string}`,\n) {\n const { signature } = parseErc6492Signature(permit2Payload.signature);\n\n return [\n {\n permitted: {\n token: getAddress(permit2Payload.permit2Authorization.permitted.token),\n amount: BigInt(permit2Payload.permit2Authorization.permitted.amount),\n },\n nonce: BigInt(permit2Payload.permit2Authorization.nonce),\n deadline: BigInt(permit2Payload.permit2Authorization.deadline),\n },\n settlementAmount,\n getAddress(permit2Payload.permit2Authorization.from),\n {\n to: getAddress(permit2Payload.permit2Authorization.witness.to),\n facilitator: getAddress(facilitatorAddress),\n validAfter: BigInt(permit2Payload.permit2Authorization.witness.validAfter),\n },\n signature,\n ] as const;\n}\n\n/**\n * Splits a 65-byte EIP-2612 signature into v, r, s components.\n *\n * @param signature - The hex-encoded 65-byte signature (with or without 0x prefix)\n * @returns Object with v (uint8), r (bytes32 hex), s (bytes32 hex)\n * @throws Error if the signature is not exactly 65 bytes (130 hex chars)\n */\nexport function splitEip2612Signature(signature: string): {\n v: number;\n r: `0x${string}`;\n s: `0x${string}`;\n} {\n const sig = signature.startsWith(\"0x\") ? signature.slice(2) : signature;\n\n if (sig.length !== 130) {\n throw new Error(\n `invalid EIP-2612 signature length: expected 65 bytes (130 hex chars), got ${sig.length / 2} bytes`,\n );\n }\n\n const r = `0x${sig.slice(0, 64)}` as `0x${string}`;\n const s = `0x${sig.slice(64, 128)}` as `0x${string}`;\n const v = parseInt(sig.slice(128, 130), 16);\n\n return { v, r, s };\n}\n\n// ---------------------------------------------------------------------------\n// Client-side helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a Permit2 payload for any scheme (exact or upto).\n * The only scheme-specific input is the proxy address used as the spender.\n *\n * @param proxyAddress - The x402 proxy contract address to set as spender\n * @param signer - The EVM client signer\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - The payment requirements\n * @returns Promise resolving to a payment payload result\n */\nexport async function createPermit2PayloadForProxy(\n proxyAddress: `0x${string}`,\n signer: ClientEvmSigner,\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n): Promise<PaymentPayloadResult> {\n const now = Math.floor(Date.now() / 1000);\n const nonce = createPermit2Nonce();\n\n // Lower time bound - allow some clock skew\n const validAfter = \"0\";\n // Upper time bound is enforced by Permit2's deadline field\n const deadline = (now + paymentRequirements.maxTimeoutSeconds).toString();\n\n const permit2Authorization: Permit2Authorization & { from: `0x${string}` } = {\n from: signer.address,\n permitted: {\n token: getAddress(paymentRequirements.asset),\n amount: paymentRequirements.amount,\n },\n spender: proxyAddress,\n nonce,\n deadline,\n witness: {\n to: getAddress(paymentRequirements.payTo),\n validAfter,\n },\n };\n\n const signature = await signPermit2Authorization(\n signer,\n permit2Authorization,\n paymentRequirements,\n );\n\n return {\n x402Version,\n payload: { signature, permit2Authorization },\n };\n}\n\n/**\n * Signs a Permit2 authorization using EIP-712 with witness data.\n * The signature authorizes the proxy contract to transfer tokens on behalf of the signer.\n *\n * @param signer - The EVM client signer\n * @param permit2Authorization - The Permit2 authorization parameters\n * @param requirements - The payment requirements\n * @returns Promise resolving to the hex-encoded signature\n */\nasync function signPermit2Authorization(\n signer: ClientEvmSigner,\n permit2Authorization: Permit2Authorization & { from: `0x${string}` },\n requirements: PaymentRequirements,\n): Promise<`0x${string}`> {\n const chainId = getEvmChainId(requirements.network);\n\n return await signer.signTypedData({\n domain: { name: \"Permit2\", chainId, verifyingContract: PERMIT2_ADDRESS },\n types: permit2WitnessTypes,\n primaryType: \"PermitWitnessTransferFrom\",\n message: {\n permitted: {\n token: getAddress(permit2Authorization.permitted.token),\n amount: BigInt(permit2Authorization.permitted.amount),\n },\n spender: getAddress(permit2Authorization.spender),\n nonce: BigInt(permit2Authorization.nonce),\n deadline: BigInt(permit2Authorization.deadline),\n witness: {\n to: getAddress(permit2Authorization.witness.to),\n validAfter: BigInt(permit2Authorization.witness.validAfter),\n },\n },\n });\n}\n","import {\n getAddress,\n parseTransaction,\n decodeFunctionData,\n recoverTransactionAddress,\n type TransactionSerialized,\n} from \"viem\";\nimport type { VerifyResponse } from \"@x402/core/types\";\nimport {\n validateErc20ApprovalGasSponsoringInfo,\n type Erc20ApprovalGasSponsoringInfo,\n} from \"../exact/extensions\";\nimport { PERMIT2_ADDRESS, erc20ApproveAbi } from \"../constants\";\nimport {\n ErrErc20ApprovalInvalidFormat,\n ErrErc20ApprovalFromMismatch,\n ErrErc20ApprovalAssetMismatch,\n ErrErc20ApprovalSpenderNotPermit2,\n ErrErc20ApprovalTxWrongTarget,\n ErrErc20ApprovalTxWrongSelector,\n ErrErc20ApprovalTxWrongSpender,\n ErrErc20ApprovalTxInvalidCalldata,\n ErrErc20ApprovalTxSignerMismatch,\n ErrErc20ApprovalTxInvalidSignature,\n ErrErc20ApprovalTxParseFailed,\n} from \"../exact/facilitator/errors\";\n\n/** The approve(address,uint256) function selector */\nconst APPROVE_SELECTOR = \"0x095ea7b3\";\n\n/**\n * Validates ERC-20 approval extension data for a Permit2 payment.\n *\n * Performs comprehensive validation:\n * - Format validation via validateErc20ApprovalGasSponsoringInfo (JSON Schema)\n * - `from` matches payer\n * - `asset` matches token\n * - `spender` is PERMIT2_ADDRESS\n * - Transaction `to` matches token address\n * - Transaction calldata is a valid approve(PERMIT2_ADDRESS, ...) call\n * - Recovered transaction signer matches `from`\n *\n * @param info - The ERC-20 approval gas sponsoring info\n * @param payer - The expected payer address\n * @param tokenAddress - The expected token address\n * @returns Validation result with invalidReason and invalidMessage on failure\n */\nexport async function validateErc20ApprovalForPayment(\n info: Erc20ApprovalGasSponsoringInfo,\n payer: `0x${string}`,\n tokenAddress: `0x${string}`,\n): Promise<Pick<VerifyResponse, \"isValid\" | \"invalidReason\" | \"invalidMessage\">> {\n if (!validateErc20ApprovalGasSponsoringInfo(info)) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalInvalidFormat,\n invalidMessage: \"ERC-20 approval extension info failed schema validation\",\n };\n }\n\n if (getAddress(info.from) !== getAddress(payer)) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalFromMismatch,\n invalidMessage: `Expected from=${payer}, got ${info.from}`,\n };\n }\n\n if (getAddress(info.asset) !== tokenAddress) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalAssetMismatch,\n invalidMessage: `Expected asset=${tokenAddress}, got ${info.asset}`,\n };\n }\n\n if (getAddress(info.spender) !== getAddress(PERMIT2_ADDRESS)) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalSpenderNotPermit2,\n invalidMessage: `Expected spender=${PERMIT2_ADDRESS}, got ${info.spender}`,\n };\n }\n\n try {\n const serializedTx = info.signedTransaction as TransactionSerialized;\n const tx = parseTransaction(serializedTx);\n\n if (!tx.to || getAddress(tx.to) !== tokenAddress) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalTxWrongTarget,\n invalidMessage: `Transaction targets ${tx.to ?? \"null\"}, expected ${tokenAddress}`,\n };\n }\n\n const data = tx.data ?? \"0x\";\n if (!data.startsWith(APPROVE_SELECTOR)) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalTxWrongSelector,\n invalidMessage: `Transaction calldata does not start with approve() selector ${APPROVE_SELECTOR}`,\n };\n }\n\n try {\n const decoded = decodeFunctionData({\n abi: erc20ApproveAbi,\n data: data as `0x${string}`,\n });\n const calldataSpender = getAddress(decoded.args[0] as `0x${string}`);\n if (calldataSpender !== getAddress(PERMIT2_ADDRESS)) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalTxWrongSpender,\n invalidMessage: `approve() spender is ${calldataSpender}, expected Permit2 ${PERMIT2_ADDRESS}`,\n };\n }\n } catch {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalTxInvalidCalldata,\n invalidMessage: \"Failed to decode approve() calldata from the signed transaction\",\n };\n }\n\n try {\n const recoveredAddress = await recoverTransactionAddress({\n serializedTransaction: serializedTx,\n });\n if (getAddress(recoveredAddress) !== getAddress(payer)) {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalTxSignerMismatch,\n invalidMessage: `Transaction signed by ${recoveredAddress}, expected payer ${payer}`,\n };\n }\n } catch {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalTxInvalidSignature,\n invalidMessage: \"Failed to recover signer from the signed transaction\",\n };\n }\n } catch {\n return {\n isValid: false,\n invalidReason: ErrErc20ApprovalTxParseFailed,\n invalidMessage: \"Failed to parse the signed transaction\",\n };\n }\n\n return { isValid: true };\n}\n","/**\n * Named error reason constants for the upto EVM facilitator.\n *\n * Shared Permit2 errors are re-exported from exact/facilitator/errors.ts.\n * Upto-specific errors are defined here.\n *\n * These strings must be character-for-character identical to the Go constants\n * to maintain cross-SDK parity.\n */\n\n// Re-export shared EVM errors\nexport { ErrAssetNotDeployedContract } from \"../../exact/facilitator/errors\";\n\n// Re-export shared Permit2 errors\nexport {\n ErrPermit2InvalidSpender,\n ErrPermit2RecipientMismatch,\n ErrPermit2DeadlineExpired,\n ErrPermit2NotYetValid,\n ErrPermit2AmountMismatch,\n ErrPermit2TokenMismatch,\n ErrPermit2InvalidSignature,\n ErrPermit2AllowanceRequired,\n ErrPermit2InvalidAmount,\n ErrPermit2InvalidDestination,\n ErrPermit2InvalidOwner,\n ErrPermit2PaymentTooEarly,\n ErrPermit2InvalidNonce,\n ErrPermit2612AmountMismatch,\n ErrErc20ApprovalInvalidFormat,\n ErrErc20ApprovalFromMismatch,\n ErrErc20ApprovalAssetMismatch,\n ErrErc20ApprovalSpenderNotPermit2,\n ErrErc20ApprovalTxWrongTarget,\n ErrErc20ApprovalTxWrongSelector,\n ErrErc20ApprovalTxWrongSpender,\n ErrErc20ApprovalTxInvalidCalldata,\n ErrErc20ApprovalTxSignerMismatch,\n ErrErc20ApprovalTxInvalidSignature,\n ErrErc20ApprovalTxFailed,\n ErrErc20ApprovalBroadcastFailed,\n ErrErc20ApprovalTxParseFailed,\n} from \"../../exact/facilitator/errors\";\n\n// Upto-specific errors\nexport const ErrUptoTransactionFailed = \"invalid_upto_evm_transaction_failed\";\nexport const ErrUptoInvalidScheme = \"invalid_upto_evm_scheme\";\nexport const ErrUptoNetworkMismatch = \"invalid_upto_evm_network_mismatch\";\nexport const ErrUptoSettlementExceedsAmount = \"invalid_upto_evm_payload_settlement_exceeds_amount\";\nexport const ErrUptoAmountExceedsPermitted = \"upto_amount_exceeds_permitted\";\nexport const ErrUptoUnauthorizedFacilitator = \"upto_unauthorized_facilitator\";\nexport const ErrUptoFacilitatorMismatch = \"upto_facilitator_mismatch\";\n","import { PaymentRequirements, PaymentPayloadResult } from \"@x402/core/types\";\nimport { encodeFunctionData, getAddress } from \"viem\";\nimport {\n PERMIT2_ADDRESS,\n x402ExactPermit2ProxyAddress,\n erc20ApproveAbi,\n erc20AllowanceAbi,\n} from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { createPermit2PayloadForProxy } from \"../../shared/permit2\";\n\n/** Maximum uint256 value for unlimited approval. */\nconst MAX_UINT256 = BigInt(\"0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\");\n\n/**\n * Creates a Permit2 payload using the x402Permit2Proxy witness pattern.\n * The spender is set to x402Permit2Proxy, which enforces that funds\n * can only be sent to the witness.to address.\n *\n * @param signer - The EVM signer for client operations\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - The payment requirements\n * @returns Promise resolving to a payment payload result\n */\nexport async function createPermit2Payload(\n signer: ClientEvmSigner,\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n): Promise<PaymentPayloadResult> {\n return createPermit2PayloadForProxy(\n x402ExactPermit2ProxyAddress,\n signer,\n x402Version,\n paymentRequirements,\n );\n}\n\n/**\n * Creates transaction data to approve Permit2 to spend tokens.\n * The user sends this transaction (paying gas) before using Permit2 flow.\n *\n * @param tokenAddress - The ERC20 token contract address\n * @returns Transaction data to send for approval\n *\n * @example\n * ```typescript\n * const tx = createPermit2ApprovalTx(\"0x...\");\n * await walletClient.sendTransaction({\n * to: tx.to,\n * data: tx.data,\n * });\n * ```\n */\nexport function createPermit2ApprovalTx(tokenAddress: `0x${string}`): {\n to: `0x${string}`;\n data: `0x${string}`;\n} {\n const data = encodeFunctionData({\n abi: erc20ApproveAbi,\n functionName: \"approve\",\n args: [PERMIT2_ADDRESS, MAX_UINT256],\n });\n\n return {\n to: getAddress(tokenAddress),\n data,\n };\n}\n\n/**\n * Parameters for checking Permit2 allowance.\n * Application provides these to check if approval is needed.\n */\nexport interface Permit2AllowanceParams {\n tokenAddress: `0x${string}`;\n ownerAddress: `0x${string}`;\n}\n\n/**\n * Returns contract read parameters for checking Permit2 allowance.\n * Use with a public client to check if the user has approved Permit2.\n *\n * @param params - The allowance check parameters\n * @returns Contract read parameters for checking allowance\n *\n * @example\n * ```typescript\n * const readParams = getPermit2AllowanceReadParams({\n * tokenAddress: \"0x...\",\n * ownerAddress: \"0x...\",\n * });\n *\n * const allowance = await publicClient.readContract(readParams);\n * const needsApproval = allowance < requiredAmount;\n * ```\n */\nexport function getPermit2AllowanceReadParams(params: Permit2AllowanceParams): {\n address: `0x${string}`;\n abi: typeof erc20AllowanceAbi;\n functionName: \"allowance\";\n args: [`0x${string}`, `0x${string}`];\n} {\n return {\n address: getAddress(params.tokenAddress),\n abi: erc20AllowanceAbi,\n functionName: \"allowance\",\n args: [getAddress(params.ownerAddress), PERMIT2_ADDRESS],\n };\n}\n","import { PaymentRequirements, PaymentPayloadResult } from \"@x402/core/types\";\nimport { getAddress } from \"viem\";\nimport { authorizationTypes } from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { ExactEIP3009Payload } from \"../../types\";\nimport { createNonce, getEvmChainId } from \"../../utils\";\n\n/**\n * Creates an EIP-3009 (transferWithAuthorization) payload.\n *\n * @param signer - The EVM signer for client operations\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - The payment requirements\n * @returns Promise resolving to a payment payload result\n */\nexport async function createEIP3009Payload(\n signer: ClientEvmSigner,\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n): Promise<PaymentPayloadResult> {\n const nonce = createNonce();\n const now = Math.floor(Date.now() / 1000);\n\n const authorization: ExactEIP3009Payload[\"authorization\"] = {\n from: signer.address,\n to: getAddress(paymentRequirements.payTo),\n value: paymentRequirements.amount,\n validAfter: \"0\",\n validBefore: (now + paymentRequirements.maxTimeoutSeconds).toString(),\n nonce,\n };\n\n const signature = await signEIP3009Authorization(signer, authorization, paymentRequirements);\n\n const payload: ExactEIP3009Payload = {\n authorization,\n signature,\n };\n\n return {\n x402Version,\n payload,\n };\n}\n\n/**\n * Sign the EIP-3009 authorization using EIP-712.\n *\n * @param signer - The EVM signer\n * @param authorization - The authorization to sign\n * @param requirements - The payment requirements\n * @returns Promise resolving to the signature\n */\nasync function signEIP3009Authorization(\n signer: ClientEvmSigner,\n authorization: ExactEIP3009Payload[\"authorization\"],\n requirements: PaymentRequirements,\n): Promise<`0x${string}`> {\n const chainId = getEvmChainId(requirements.network);\n\n if (!requirements.extra?.name || !requirements.extra?.version) {\n throw new Error(\n `EIP-712 domain parameters (name, version) are required in payment requirements for asset ${requirements.asset}`,\n );\n }\n\n const { name, version } = requirements.extra;\n\n const domain = {\n name,\n version,\n chainId,\n verifyingContract: getAddress(requirements.asset),\n };\n\n const message = {\n from: getAddress(authorization.from),\n to: getAddress(authorization.to),\n value: BigInt(authorization.value),\n validAfter: BigInt(authorization.validAfter),\n validBefore: BigInt(authorization.validBefore),\n nonce: authorization.nonce,\n };\n\n return await signer.signTypedData({\n domain,\n types: authorizationTypes,\n primaryType: \"TransferWithAuthorization\",\n message,\n });\n}\n","import {\n SchemeNetworkClient,\n PaymentRequirements,\n PaymentPayloadResult,\n PaymentPayloadContext,\n} from \"@x402/core/types\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { AssetTransferMethod } from \"../../types\";\nimport { createEIP3009Payload } from \"./eip3009\";\nimport { createPermit2Payload } from \"./permit2\";\nimport {\n trySignEip2612PermitExtension,\n trySignErc20ApprovalExtension,\n} from \"../../shared/extensions\";\nimport { findDefaultAsset } from \"../../defaultAssets\";\nimport type { EvmSchemeOptions } from \"../../shared/rpc\";\n\n/**\n * EVM client implementation for the Exact payment scheme.\n * Supports both EIP-3009 (transferWithAuthorization) and Permit2 flows.\n *\n * Routes to the appropriate authorization method based on\n * `requirements.extra.assetTransferMethod`. Defaults to EIP-3009\n * for backward compatibility with older facilitators.\n *\n * When the server advertises `eip2612GasSponsoring` and the asset transfer\n * method is `permit2`, the scheme automatically signs an EIP-2612 permit\n * if the user lacks Permit2 approval. This requires `readContract` on the signer.\n */\nexport class ExactEvmScheme implements SchemeNetworkClient {\n readonly scheme = \"exact\";\n findDefaultAsset = findDefaultAsset;\n\n /**\n * Creates a new ExactEvmClient instance.\n *\n * @param signer - The EVM signer for client operations.\n * Base flow only requires `address` + `signTypedData`.\n * Extension enrichment (EIP-2612 / ERC-20 approval sponsoring) additionally\n * requires optional capabilities like `readContract` and tx signing helpers.\n * @param options - Optional RPC configuration used to backfill extension capabilities.\n */\n constructor(\n private readonly signer: ClientEvmSigner,\n private readonly options?: EvmSchemeOptions,\n ) {}\n\n /**\n * Creates a payment payload for the Exact scheme.\n * Routes to EIP-3009 or Permit2 based on requirements.extra.assetTransferMethod.\n *\n * For Permit2 flows, if the server advertises `eip2612GasSponsoring` and the\n * signer supports `readContract`, automatically signs an EIP-2612 permit\n * when Permit2 allowance is insufficient.\n *\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - The payment requirements\n * @param context - Optional context with server-declared extensions\n * @returns Promise resolving to a payment payload result (with optional extensions)\n */\n async createPaymentPayload(\n x402Version: number,\n paymentRequirements: PaymentRequirements,\n context?: PaymentPayloadContext,\n ): Promise<PaymentPayloadResult> {\n const assetTransferMethod =\n (paymentRequirements.extra?.assetTransferMethod as AssetTransferMethod) ?? \"eip3009\";\n\n if (assetTransferMethod === \"permit2\") {\n const result = await createPermit2Payload(this.signer, x402Version, paymentRequirements);\n\n const eip2612Extensions = await trySignEip2612PermitExtension(\n this.signer,\n this.options,\n paymentRequirements,\n result,\n context,\n );\n\n if (eip2612Extensions) {\n return {\n ...result,\n extensions: eip2612Extensions,\n };\n }\n\n const erc20Extensions = await trySignErc20ApprovalExtension(\n this.signer,\n this.options,\n paymentRequirements,\n context,\n );\n if (erc20Extensions) {\n return {\n ...result,\n extensions: erc20Extensions,\n };\n }\n\n return result;\n }\n\n return createEIP3009Payload(this.signer, x402Version, paymentRequirements);\n }\n}\n","import { x402Client, SelectPaymentRequirements, PaymentPolicy } from \"@x402/core/client\";\nimport { Network } from \"@x402/core/types\";\nimport { networkMatchesPattern } from \"@x402/core/utils\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { ExactEvmScheme } from \"./scheme\";\nimport type { EvmSchemeOptions } from \"../../shared/rpc\";\nimport { ExactEvmSchemeV1 } from \"../v1/client/scheme\";\nimport { NETWORKS, getEvmChainIdV1 } from \"../../v1\";\n\n/**\n * Configuration options for registering EVM schemes to an x402Client\n */\nexport interface EvmClientConfig {\n /**\n * The EVM signer to use for creating payment payloads\n */\n signer: ClientEvmSigner;\n\n /**\n * Optional payment requirements selector function\n * If not provided, uses the default selector (first available option)\n */\n paymentRequirementsSelector?: SelectPaymentRequirements;\n\n /**\n * Optional policies to apply to the client\n */\n policies?: PaymentPolicy[];\n\n /**\n * Optional Exact EVM client scheme options.\n * Supports either a single config ({ rpcUrl }) or per-chain configs\n * keyed by EVM chain ID ({ 8453: { rpcUrl: \"...\" } }).\n */\n schemeOptions?: EvmSchemeOptions;\n\n /**\n * Optional specific networks to register.\n * If not provided, registers wildcard support (eip155:*).\n */\n networks?: Network[];\n}\n\n/**\n * Registers EVM exact payment schemes to an x402Client instance.\n *\n * This function registers:\n * - V2: eip155:* wildcard scheme with ExactEvmScheme (or specific networks if provided)\n * - V1: All supported EVM networks with ExactEvmSchemeV1\n *\n * @param client - The x402Client instance to register schemes to\n * @param config - Configuration for EVM client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactEvmScheme } from \"@x402/evm/exact/client/register\";\n * import { x402Client } from \"@x402/core/client\";\n * import { privateKeyToAccount } from \"viem/accounts\";\n *\n * const account = privateKeyToAccount(\"0x...\");\n * const client = new x402Client();\n * registerExactEvmScheme(client, { signer: account });\n * ```\n */\nexport function registerExactEvmScheme(client: x402Client, config: EvmClientConfig): x402Client {\n const evmScheme = new ExactEvmScheme(config.signer, config.schemeOptions);\n\n // Register V2 scheme\n // EIP-2612 gas sponsoring is handled internally by the scheme when the\n // server advertises support - no separate extension registration needed.\n if (config.networks && config.networks.length > 0) {\n // Register specific networks\n config.networks.forEach(network => {\n client.register(network, evmScheme);\n });\n } else {\n // Register wildcard for all EVM chains\n client.register(\"eip155:*\", evmScheme);\n }\n\n const v1Networks =\n config.networks && config.networks.length > 0\n ? NETWORKS.filter(name =>\n config.networks!.some(pattern =>\n networkMatchesPattern(pattern, `eip155:${getEvmChainIdV1(name)}` as Network),\n ),\n )\n : NETWORKS;\n\n v1Networks.forEach(network => {\n client.registerV1(network as Network, new ExactEvmSchemeV1(config.signer));\n });\n\n // Apply policies if provided\n if (config.policies) {\n config.policies.forEach(policy => {\n client.registerPolicy(policy);\n });\n }\n\n return client;\n}\n","/**\n * Asset transfer methods for the exact EVM scheme.\n * - eip3009: Uses transferWithAuthorization (USDC, etc.) - recommended for compatible tokens\n * - permit2: Uses Permit2 + x402Permit2Proxy - universal fallback for any ERC-20\n */\nexport type AssetTransferMethod = \"eip3009\" | \"permit2\";\n\n/**\n * EIP-3009 payload for tokens with native transferWithAuthorization support.\n */\nexport type ExactEIP3009Payload = {\n signature?: `0x${string}`;\n authorization: {\n from: `0x${string}`;\n to: `0x${string}`;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: `0x${string}`;\n };\n};\n\n/**\n * Permit2 witness data structure.\n * Matches the Witness struct in x402Permit2Proxy contract.\n * Note: Upper time bound is enforced by Permit2's `deadline` field, not a witness field.\n */\nexport type Permit2Witness = {\n to: `0x${string}`;\n validAfter: string;\n};\n\n/**\n * Permit2 authorization parameters.\n * Used to reconstruct the signed message for verification.\n */\nexport type Permit2Authorization = {\n permitted: {\n token: `0x${string}`;\n amount: string;\n };\n spender: `0x${string}`;\n nonce: string;\n deadline: string;\n witness: Permit2Witness;\n};\n\n/**\n * Permit2 payload for tokens using the Permit2 + x402Permit2Proxy flow.\n */\nexport type ExactPermit2Payload = {\n signature: `0x${string}`;\n permit2Authorization: Permit2Authorization & {\n from: `0x${string}`;\n };\n};\n\nexport type ExactEvmPayloadV1 = ExactEIP3009Payload;\n\nexport type ExactEvmPayloadV2 = ExactEIP3009Payload | ExactPermit2Payload;\n\n/**\n * Type guard to check if a payload is a Permit2 payload.\n * Permit2 payloads have a `permit2Authorization` field.\n *\n * @param payload - The payload to check.\n * @returns True if the payload is a Permit2 payload, false otherwise.\n */\nexport function isPermit2Payload(payload: ExactEvmPayloadV2): payload is ExactPermit2Payload {\n return \"permit2Authorization\" in payload;\n}\n\n/**\n * Type guard to check if a payload is an EIP-3009 payload.\n * EIP-3009 payloads have an `authorization` field.\n *\n * @param payload - The payload to check.\n * @returns True if the payload is an EIP-3009 payload, false otherwise.\n */\nexport function isEIP3009Payload(payload: ExactEvmPayloadV2): payload is ExactEIP3009Payload {\n return \"authorization\" in payload;\n}\n\n/**\n * Upto Permit2 witness — includes `facilitator` field absent from exact witness.\n * Only the address matching `witness.facilitator` can call settle() on-chain.\n */\nexport type UptoPermit2Witness = {\n to: `0x${string}`;\n facilitator: `0x${string}`;\n validAfter: string;\n};\n\nexport type UptoPermit2Authorization = {\n permitted: {\n token: `0x${string}`;\n amount: string;\n };\n spender: `0x${string}`;\n nonce: string;\n deadline: string;\n witness: UptoPermit2Witness;\n};\n\nexport type UptoPermit2Payload = {\n signature: `0x${string}`;\n permit2Authorization: UptoPermit2Authorization & {\n from: `0x${string}`;\n };\n};\n\n// Batch-settlement EVM scheme payload types\nexport type {\n AuthorizerSigner,\n ChannelConfig,\n ChannelState,\n BatchSettlementDepositPayload,\n BatchSettlementVoucherPayload,\n BatchSettlementRefundPayload,\n BatchSettlementVoucherFields,\n BatchSettlementErc3009Authorization,\n BatchSettlementPermit2Authorization,\n BatchSettlementDepositAuthorization,\n BatchSettlementAssetTransferMethod,\n BatchSettlementClaimPayload,\n BatchSettlementEnrichedRefundPayload,\n BatchSettlementVoucherClaim,\n BatchSettlementPayload,\n BatchSettlementSettlePayload,\n BatchSettlementFacilitatorSettlePayload,\n BatchSettlementPaymentRequirementsExtra,\n BatchSettlementPaymentResponseExtra,\n} from \"./batch-settlement/types\";\nexport {\n isBatchSettlementDepositPayload,\n isBatchSettlementVoucherPayload,\n isBatchSettlementRefundPayload,\n isBatchSettlementClaimPayload,\n isBatchSettlementSettlePayload,\n isBatchSettlementEnrichedRefundPayload,\n} from \"./batch-settlement/types\";\n\n/**\n * Type guard to check if a payload is an upto Permit2 payload.\n * Validates structural presence of all required fields: signature, permit2Authorization\n * (with from, permitted, spender, nonce, deadline), and a witness containing facilitator.\n *\n * @param payload - The payload to check.\n * @returns True if the payload is an upto Permit2 payload, false otherwise.\n */\nexport function isUptoPermit2Payload(\n payload: Record<string, unknown>,\n): payload is UptoPermit2Payload {\n if (typeof payload.signature !== \"string\") return false;\n if (!(\"permit2Authorization\" in payload)) return false;\n\n const auth = payload.permit2Authorization;\n if (typeof auth !== \"object\" || auth === null) return false;\n\n const a = auth as Record<string, unknown>;\n if (typeof a.from !== \"string\") return false;\n if (typeof a.spender !== \"string\") return false;\n if (typeof a.nonce !== \"string\") return false;\n if (typeof a.deadline !== \"string\") return false;\n\n const permitted = a.permitted;\n if (typeof permitted !== \"object\" || permitted === null) return false;\n const p = permitted as Record<string, unknown>;\n if (typeof p.token !== \"string\") return false;\n if (typeof p.amount !== \"string\") return false;\n\n const witness = a.witness;\n if (typeof witness !== \"object\" || witness === null) return false;\n const w = witness as Record<string, unknown>;\n return (\n typeof w.facilitator === \"string\" &&\n typeof w.to === \"string\" &&\n typeof w.validAfter === \"string\"\n );\n}\n","import { getAddress } from \"viem\";\nimport { ErrAssetNotDeployedContract } from \"./exact/facilitator/errors\";\nimport type { FacilitatorEvmSigner } from \"./signer\";\n\n/** Bounds how long a positive asset-contract check is reused. */\nexport const DEFAULT_ASSET_CONTRACT_CACHE_TTL_MS = 15 * 60 * 1000;\n\nexport const MAX_ASSET_CONTRACT_CACHE_ENTRIES = 4096;\n\nexport type AssetContractCacheKey = {\n network: string;\n asset: string;\n};\n\ntype AssetContractCache = {\n ttl: number;\n expiries: Map<string, number>;\n isFresh(key: AssetContractCacheKey, now: number): boolean;\n record(key: AssetContractCacheKey, now: number): void;\n};\n\nconst cacheKey = (key: AssetContractCacheKey): string => `${key.network}\\0${key.asset}`;\n\nconst normalizeAsset = (asset: string): string => getAddress(asset).toLowerCase();\n\n/**\n * Process-wide memo of \"this asset address has bytecode\" per network.\n * Only positive results are stored: a negative result may be a token observed mid-deployment,\n * which has to self-heal on the next request.\n */\nexport const globalAssetContractCache: AssetContractCache = {\n ttl: DEFAULT_ASSET_CONTRACT_CACHE_TTL_MS,\n // Node's event loop is single-threaded, so a plain Map is enough; Go needs RWMutex.\n expiries: new Map<string, number>(),\n\n isFresh(key: AssetContractCacheKey, now: number): boolean {\n // An empty network is never cached, since entries would otherwise collide\n // across chains where one address can hold bytecode on one chain and nothing\n // on another.\n if (key.network === \"\") {\n return false;\n }\n\n const expiry = this.expiries.get(cacheKey(key));\n return expiry !== undefined && now < expiry;\n },\n\n record(key: AssetContractCacheKey, now: number): void {\n if (key.network === \"\") {\n return;\n }\n\n for (const [existing, expiry] of this.expiries) {\n if (now > expiry) {\n this.expiries.delete(existing);\n }\n }\n\n const serialized = cacheKey(key);\n if (!this.expiries.has(serialized) && this.expiries.size >= MAX_ASSET_CONTRACT_CACHE_ENTRIES) {\n return;\n }\n this.expiries.set(serialized, now + this.ttl);\n },\n};\n\n/**\n * Clears the process-wide asset-contract cache, for tests that assert\n * on eth_getCode call counts across cases sharing an asset address.\n */\nexport function resetAssetContractCache(): void {\n globalAssetContractCache.expiries = new Map();\n}\n\n/**\n * Checks whether the payment asset is a deployed contract.\n * Returns {@link ErrAssetNotDeployedContract} for an EOA/empty address,\n * `\"\"` for a deployed contract, or throws if eth_getCode itself fails.\n *\n * `network` identifies the chain the signer is bound to. It must be accurate, since it scopes the\n * cache that serves positive results; an empty network disables caching for the call. Only\n * {@link AssetContractCheck.await} populates that cache, so calling this directly always hits the RPC\n * on a miss.\n *\n * @param signer - Facilitator signer used to call eth_getCode on the asset.\n * @param network - CAIP-2 network id that scopes the cache; empty disables caching.\n * @param asset - Payment token address.\n * @returns An empty string when the asset is a contract, or {@link ErrAssetNotDeployedContract}.\n */\nexport async function validateAssetIsContract(\n signer: FacilitatorEvmSigner,\n network: string,\n asset: string,\n): Promise<string> {\n const normalizedAsset = normalizeAsset(asset);\n if (globalAssetContractCache.isFresh({ network, asset: normalizedAsset }, Date.now())) {\n return \"\";\n }\n\n let code: `0x${string}` | undefined;\n try {\n code = await signer.getCode({ address: getAddress(asset) });\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n throw new Error(`failed to check whether asset is a contract: ${message}`);\n }\n\n if (!code || code === \"0x\") {\n return ErrAssetNotDeployedContract;\n }\n return \"\";\n}\n\n/**\n * An asset-contract check running in the background.\n */\nexport class AssetContractCheck {\n /**\n * Resolves with the check result. Reading this does not populate the cache;\n * only {@link await} does.\n */\n readonly results: Promise<string>;\n private readonly network: string;\n private readonly asset: string;\n\n /**\n * Starts {@link validateAssetIsContract} immediately. Cache recording waits for {@link AssetContractCheck.await}.\n *\n * @param signer - Facilitator signer used to call eth_getCode on the asset.\n * @param network - CAIP-2 network id that scopes the cache; empty disables caching.\n * @param asset - Payment token address.\n */\n constructor(signer: FacilitatorEvmSigner, network: string, asset: string) {\n this.network = network;\n this.asset = asset;\n this.results = validateAssetIsContract(signer, network, asset);\n }\n\n /**\n * Returns the check's result, caching a positive one for {@link DEFAULT_ASSET_CONTRACT_CACHE_TTL_MS}.\n * Recording on await rather than when the Promise settles keeps cache contents independent of\n * scheduling: a check abandoned by an early return cannot publish a result.\n *\n * @returns An empty string when the asset is a contract, or {@link ErrAssetNotDeployedContract}.\n */\n async await(): Promise<string> {\n const reason = await this.results;\n if (reason === \"\") {\n globalAssetContractCache.record(\n { network: this.network, asset: normalizeAsset(this.asset) },\n Date.now(),\n );\n }\n return reason;\n }\n}\n\n/**\n * Runs {@link validateAssetIsContract} in the background so callers can overlap\n * it with signature verification. The result is delivered by {@link AssetContractCheck.await}.\n *\n * @param signer - Facilitator signer used to call eth_getCode on the asset.\n * @param network - CAIP-2 network id that scopes the cache; empty disables caching.\n * @param asset - Payment token address.\n * @returns A check whose {@link AssetContractCheck.await} delivers the result.\n */\nexport function startAssetContractCheck(\n signer: FacilitatorEvmSigner,\n network: string,\n asset: string,\n): AssetContractCheck {\n return new AssetContractCheck(signer, network, asset);\n}\n","import type { Log } from \"viem\";\n\n/**\n * ClientEvmSigner - Used by x402 clients to sign payment authorizations.\n *\n * Typically a viem LocalAccount:\n * ```typescript\n * const account = privateKeyToAccount('0x...');\n * ```\n *\n * Or composed via `toClientEvmSigner(account, publicClient)`.\n */\nexport type ClientEvmSigner = {\n readonly address: `0x${string}`;\n signTypedData(message: {\n domain: Record<string, unknown>;\n types: Record<string, unknown>;\n primaryType: string;\n message: Record<string, unknown>;\n }): Promise<`0x${string}`>;\n /**\n * Optional on-chain reads.\n * Required only for extension enrichment (EIP-2612 / ERC-20 approval).\n */\n readContract?(args: {\n address: `0x${string}`;\n abi: readonly unknown[];\n functionName: string;\n args?: readonly unknown[];\n }): Promise<unknown>;\n /**\n * Optional: Signs a raw EIP-1559 transaction without broadcasting.\n * Required for ERC-20 approval gas sponsoring when the token lacks EIP-2612.\n */\n signTransaction?(args: {\n to: `0x${string}`;\n data: `0x${string}`;\n nonce: number;\n gas: bigint;\n maxFeePerGas: bigint;\n maxPriorityFeePerGas: bigint;\n chainId: number;\n }): Promise<`0x${string}`>;\n /**\n * Optional: Gets the current transaction count (nonce) for an address.\n * Required for ERC-20 approval gas sponsoring.\n */\n getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n /**\n * Optional: Estimates current gas fees per gas.\n * Required for ERC-20 approval gas sponsoring.\n */\n estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n};\n\n/**\n * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments\n * This is typically a viem PublicClient + WalletClient combination that can\n * read contract state, verify signatures, write transactions, and wait for receipts\n *\n * Supports multiple addresses for load balancing, key rotation, and high availability\n */\nexport type FacilitatorEvmSigner = {\n /**\n * Get all addresses this facilitator can use for signing\n * Enables dynamic address selection for load balancing and key rotation\n */\n getAddresses(): readonly `0x${string}`[];\n\n readContract(args: {\n address: `0x${string}`;\n abi: readonly unknown[];\n functionName: string;\n args?: readonly unknown[];\n }): Promise<unknown>;\n verifyTypedData(args: {\n address: `0x${string}`;\n domain: Record<string, unknown>;\n types: Record<string, unknown>;\n primaryType: string;\n message: Record<string, unknown>;\n signature: `0x${string}`;\n }): Promise<boolean>;\n writeContract(args: {\n address: `0x${string}`;\n abi: readonly unknown[];\n functionName: string;\n args: readonly unknown[];\n gas?: bigint;\n dataSuffix?: `0x${string}`;\n }): Promise<`0x${string}`>;\n sendTransaction(args: { to: `0x${string}`; data: `0x${string}` }): Promise<`0x${string}`>;\n waitForTransactionReceipt(args: {\n hash: `0x${string}`;\n /** Milliseconds to wait before giving up; set by {@link toFacilitatorEvmSigner}. */\n timeout?: number;\n }): Promise<{\n status: string;\n logs?: readonly Log[];\n }>;\n getCode(args: { address: `0x${string}` }): Promise<`0x${string}` | undefined>;\n};\n\n/**\n * Composes a ClientEvmSigner from a local account and a public client.\n *\n * Use this when your signer (e.g., `privateKeyToAccount`) doesn't have\n * `readContract`. The `publicClient` provides the on-chain read capability.\n *\n * Alternatively, use a local account with an explicit public client:\n * ```typescript\n * const account = privateKeyToAccount('0x...');\n * const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });\n * const signer = toClientEvmSigner(account, publicClient);\n * ```\n *\n * @param signer - A signer with `address` and `signTypedData` (and optionally `readContract`)\n * @param publicClient - A client with optional read/nonce/fee helpers\n * @param publicClient.readContract - The readContract method from the public client\n * @param publicClient.getTransactionCount - Optional getTransactionCount for ERC-20 approval\n * @param publicClient.estimateFeesPerGas - Optional estimateFeesPerGas for ERC-20 approval\n * @returns A ClientEvmSigner with any available optional capabilities\n *\n * @example\n * ```typescript\n * const account = privateKeyToAccount(\"0x...\");\n * const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });\n * const signer = toClientEvmSigner(account, publicClient);\n * ```\n */\nexport function toClientEvmSigner(\n signer: Omit<ClientEvmSigner, \"readContract\"> & {\n readContract?: ClientEvmSigner[\"readContract\"];\n },\n publicClient?: {\n readContract(args: {\n address: `0x${string}`;\n abi: readonly unknown[];\n functionName: string;\n args?: readonly unknown[];\n }): Promise<unknown>;\n getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n },\n): ClientEvmSigner {\n const readContract = signer.readContract ?? publicClient?.readContract.bind(publicClient);\n\n const result: ClientEvmSigner = {\n address: signer.address,\n signTypedData: msg => signer.signTypedData(msg),\n };\n\n if (readContract) {\n result.readContract = readContract;\n }\n\n // Forward optional capabilities from signer or publicClient\n const signTransaction = signer.signTransaction;\n if (signTransaction) {\n result.signTransaction = args => signTransaction(args);\n }\n\n const getTransactionCount =\n signer.getTransactionCount ?? publicClient?.getTransactionCount?.bind(publicClient);\n if (getTransactionCount) {\n result.getTransactionCount = args => getTransactionCount(args);\n }\n\n const estimateFeesPerGas =\n signer.estimateFeesPerGas ?? publicClient?.estimateFeesPerGas?.bind(publicClient);\n if (estimateFeesPerGas) {\n result.estimateFeesPerGas = () => estimateFeesPerGas();\n }\n\n return result;\n}\n\n/** viem's own `waitForTransactionReceipt` default, so wrapping is behavior-preserving. */\nconst DEFAULT_CONFIRMATION_TIMEOUT_MS = 180_000;\n\n/**\n * Converts a viem client with single address to a FacilitatorEvmSigner\n * Wraps the single address in a getAddresses() function for compatibility\n *\n * Every receipt wait the returned signer performs is bounded by `confirmationTimeoutMs`.\n * Facilitators behind a platform request deadline (serverless functions, gateway timeouts)\n * should set it below that deadline, so settlement reports `settlement_pending` with the\n * broadcast hash instead of the process being killed mid-wait.\n *\n * @param client - The client to convert (must have 'address' property)\n * @param options - Optional signer behavior\n * @param options.confirmationTimeoutMs - Receipt-wait bound in milliseconds. Defaults to 180_000.\n * @returns FacilitatorEvmSigner with getAddresses() support\n */\nexport function toFacilitatorEvmSigner(\n client: Omit<FacilitatorEvmSigner, \"getAddresses\"> & { address: `0x${string}` },\n {\n confirmationTimeoutMs = DEFAULT_CONFIRMATION_TIMEOUT_MS,\n }: { confirmationTimeoutMs?: number } = {},\n): FacilitatorEvmSigner {\n return {\n ...client,\n getAddresses: () => [client.address],\n waitForTransactionReceipt: args =>\n client.waitForTransactionReceipt({ ...args, timeout: confirmationTimeoutMs }),\n };\n}\n","/**\n * Detection utilities for the ERC-7702 delegation designation (`0xef0100 + 20-byte address`).\n *\n * NOTE: These helpers are diagnostic only. The signature-verification path does\n * not branch on 7702 detection — it routes by `code.length` (matching on-chain\n * SignatureChecker) and the delegate decides via `isValidSignature`. See\n * {@link ./verifySignature.ts} for the verification primitive.\n *\n * Use these helpers for telemetry, logging, or surfacing wallet types in UIs.\n */\n\nconst ERC7702_PREFIX = \"0xef0100\";\nconst ERC7702_BYTECODE_LENGTH = 48; // \"0x\" + 6 hex chars (prefix) + 40 hex chars (address)\n\n/**\n * Returns `true` if `bytecode` is a valid ERC-7702 delegation designation.\n *\n * The check is case-insensitive — `eth_getCode` casing is not normalized at the\n * JSON-RPC layer, so callers using ethers, custom signers, or post-processed\n * hex can pass uppercase variants.\n *\n * @param bytecode - Raw hex bytecode returned by `eth_getCode`.\n * @returns `true` if the bytecode is an ERC-7702 delegation designation.\n */\nexport function isERC7702Delegation(bytecode: `0x${string}` | undefined | null): boolean {\n if (!bytecode || bytecode === \"0x\") return false;\n if (bytecode.length !== ERC7702_BYTECODE_LENGTH) return false;\n return bytecode.toLowerCase().startsWith(ERC7702_PREFIX);\n}\n\n/**\n * Extracts the 20-byte delegate address from a 7702 delegation designation.\n * Returns the address in **lowercase** hex with a `0x` prefix.\n * The Go equivalent ({@link GetERC7702DelegateAddress}) returns a checksummed EIP-55 address.\n * The Python equivalent returns lowercase hex. Normalise with `getAddress()` when comparing\n * cross-SDK outputs or storing in a case-sensitive index.\n * Returns `null` for non-7702 bytecode.\n *\n * @param bytecode - Raw hex bytecode returned by `eth_getCode`.\n * @returns The lowercase `0x`-prefixed delegate address, or `null` if `bytecode` is not a 7702 designation.\n */\nexport function getERC7702DelegateAddress(\n bytecode: `0x${string}` | undefined | null,\n): `0x${string}` | null {\n if (!isERC7702Delegation(bytecode)) return null;\n return (\"0x\" + bytecode!.slice(8).toLowerCase()) as `0x${string}`;\n}\n","/**\n * auth-capture wire-format types.\n *\n * Spec-level field names (captureAuthorizer, captureDeadline, refundDeadline,\n * feeRecipient) live here at the extra/wire layer. The onchain PaymentInfo\n * struct keeps the canonical Solidity field names (operator, authorizationExpiry,\n * refundExpiry, feeReceiver) so the EIP-712 typehash stays byte-identical with\n * the AuthCaptureEscrow contract.\n *\n * Salt is NOT in extra. It is generated client-side per signing call and rides\n * on the payload alongside the signature. When salt binding is on, `saltNonce`\n * is added beside `salt`.\n */\n\nimport type { PendingSettlementStore } from \"@x402/core/facilitator\";\nimport type { TypedData } from \"viem\";\nimport type { AssetTransferMethod } from \"../types\";\n\nexport type AuthCapturePaymentFlow = \"escrow\" | \"authorization\";\nexport type AuthCaptureCaptureMode = \"sync\" | \"deferred\";\nexport type AuthCaptureOperatorType = \"delegated\" | \"custom\" | \"policy\";\n\nexport interface AuthorizerSigner {\n address: `0x${string}`;\n signTypedData(params: {\n domain: Record<string, unknown>;\n types: TypedData;\n primaryType: string;\n message: Record<string, unknown>;\n }): Promise<`0x${string}`>;\n}\n\ntype AuthCaptureLifecycleExtra =\n | {\n paymentFlow?: \"escrow\";\n captureMode?: AuthCaptureCaptureMode;\n receiverAuthorizer?: `0x${string}`;\n }\n | { paymentFlow: \"authorization\"; captureMode?: never; receiverAuthorizer?: `0x${string}` };\n\ntype AuthCaptureDeadlineExtra =\n | {\n captureDeadline: number;\n refundDeadline: number;\n captureDeadlineSeconds?: never;\n refundDeadlineSeconds?: never;\n }\n | {\n captureDeadlineSeconds: number;\n refundDeadlineSeconds: number;\n captureDeadline?: never;\n refundDeadline?: never;\n };\n\ntype AuthCaptureMerchantFeesExtra = {\n feeRecipient: `0x${string}`;\n minFeeBps: number;\n maxFeeBps: number;\n name: string;\n version: string;\n policy?: `0x${string}`;\n assetTransferMethod?: AssetTransferMethod;\n};\n\ntype AuthCaptureDelegatedRouteExtra = AuthCaptureMerchantFeesExtra & {\n operatorType?: \"delegated\";\n /** Omitted for delegated routes when the facilitator advertises it on `/supported` extra. */\n captureAuthorizer?: `0x${string}`;\n};\n\ntype AuthCaptureCustomRouteExtra = AuthCaptureMerchantFeesExtra & {\n operatorType: \"custom\";\n captureAuthorizer: `0x${string}`;\n /** Collect-only: the facilitator relays no lifecycle, so sync has nothing to finalize with. */\n captureMode?: \"deferred\";\n};\n\n/**\n * Merchant-authored route extra. Correlated optionals are unions so forbidden\n * combinations (captureMode on an authorization route, sync capture on a custom\n * operator, mixed absolute/relative deadlines) are unrepresentable when the\n * literal is checked with `satisfies AuthCaptureRouteExtra`. Escrow sync derives\n * `receiverAuthorizer` from the scheme signer when the route omits it.\n */\nexport type AuthCaptureRouteExtra = (AuthCaptureDelegatedRouteExtra | AuthCaptureCustomRouteExtra) &\n AuthCaptureLifecycleExtra &\n AuthCaptureDeadlineExtra;\n\n/**\n * Wire extra after `enhancePaymentRequirements`. Deadlines are always absolute.\n * `paymentFlow` / `captureMode` / `receiverAuthorizer` are independent optionals\n * here because the facilitator validates untrusted `Record<string, unknown>`.\n */\nexport interface AuthCaptureExtra {\n captureAuthorizer: `0x${string}`;\n captureDeadline: number;\n refundDeadline: number;\n feeRecipient: `0x${string}`;\n minFeeBps: number;\n maxFeeBps: number;\n name: string;\n version: string;\n authCaptureEscrow?: `0x${string}`;\n paymentFlow?: AuthCapturePaymentFlow;\n captureMode?: AuthCaptureCaptureMode;\n receiverAuthorizer?: `0x${string}`;\n policy?: `0x${string}`;\n operatorType?: AuthCaptureOperatorType;\n assetTransferMethod?: AssetTransferMethod;\n}\n\nexport type AuthCaptureFeeTerms = {\n feeRecipient: `0x${string}`;\n minFeeBps: number;\n maxFeeBps: number;\n};\n\nexport type OperatorAllowlistEntry = {\n address: \"*\" | `0x${string}`;\n operatorType: \"custom\";\n};\n\nexport type AuthCaptureFacilitatorConfig = {\n feeTerms?: AuthCaptureFeeTerms;\n operators?: OperatorAllowlistEntry[];\n receiverAuthorizer?: `0x${string}`;\n /**\n * Max gas for a custom-operator collect relay (`authorize` or `charge`).\n * Used as the verify reject threshold and as a hard broadcast ceiling.\n *\n * @default DEFAULT_CUSTOM_OPERATOR_AUTHORIZE_GAS_LIMIT (1_000_000)\n */\n customOperatorAuthorizeGasLimit?: bigint;\n /**\n * Allowlist of ERC-6492 preparation targets (hex strings, case-insensitive) the\n * facilitator accepts for an undeployed payer wallet.\n *\n * A counterfactual payer has no `isValidSignature` to call, so its signature can only\n * be validated by the onchain simulation, where the canonical token collector deploys\n * the wallet before checking the inner signature. The collector makes that preparation\n * call through Multicall3, so the facilitator is never its sender; the allowlist exists\n * to bound the gas an unknown preparation target can burn. An empty or omitted list\n * rejects every counterfactual payment.\n *\n * @default []\n */\n eip6492AllowedFactories?: string[];\n /**\n * When true, the facilitator relays `type: \"refund\"` for `\"delegated\"`\n * operators. Requires an out-of-band funding agreement: refunds pull tokens\n * from `PaymentInfo.operator`. With a rotated submitter set, every address\n * in the rotation must be funded and approved — `OperatorRefundCollector`\n * pulls with `safeTransferFrom(token, PaymentInfo.operator, ...)`.\n *\n * Each submitter also gets its own CREATE2 `TokenStore` on first authorize,\n * so N keys mean N deployment costs and escrow-held balances split N ways.\n */\n refundFunding?: boolean;\n /**\n * Lets a retried settle for the same payload reconcile against an\n * already-broadcast transaction instead of re-verifying and\n * re-broadcasting (see {@link PendingSettlementStore}). Defaults to a\n * fresh in-memory store shared across all settle calls on this scheme\n * instance.\n */\n pendingSettlementStore?: PendingSettlementStore;\n};\n\nexport type CaptureOptions = {\n feeReceiver?: `0x${string}`;\n feeBps?: number;\n feeAmount?: string;\n} & ({ amount?: string; voidRemainder?: false } | { amount: string; voidRemainder: true });\n\n/**\n * Type guard for AuthCaptureExtra. Checks the structural shape an auth-capture\n * scheme requires inside `PaymentRequirements.extra`: every spec-mandated\n * required field present with the right primitive type.\n *\n * @param value - Candidate object from `requirements.extra`.\n * @returns True if `value` has every required AuthCaptureExtra field.\n */\nexport function isAuthCaptureExtra(value: unknown): value is AuthCaptureExtra {\n if (typeof value !== \"object\" || value === null) return false;\n const v = value as Record<string, unknown>;\n return (\n typeof v.captureAuthorizer === \"string\" &&\n typeof v.captureDeadline === \"number\" &&\n typeof v.refundDeadline === \"number\" &&\n typeof v.feeRecipient === \"string\" &&\n typeof v.minFeeBps === \"number\" &&\n typeof v.maxFeeBps === \"number\" &&\n typeof v.name === \"string\" &&\n typeof v.version === \"string\"\n );\n}\n\ntype ChargeCompletionV1_0 = {\n amount: string;\n feeBps: number;\n feeReceiver: `0x${string}`;\n authorizerSignature: `0x${string}`;\n};\n\ntype ChargeCompletionV1_1 = {\n amount: string;\n feeAmount: string;\n feeReceiver: `0x${string}`;\n authorizerSignature: `0x${string}`;\n};\n\ntype ChargeCompletion = ChargeCompletionV1_0 | ChargeCompletionV1_1;\n\ntype NoChargeCompletion = {\n amount?: never;\n feeBps?: never;\n feeAmount?: never;\n feeReceiver?: never;\n authorizerSignature?: never;\n};\n\ntype CollectEnvelope<TAuth> =\n | (TAuth & { salt: `0x${string}`; saltNonce?: never; type?: never } & NoChargeCompletion)\n | (TAuth & { salt: `0x${string}`; saltNonce: `0x${string}`; type?: never } & NoChargeCompletion)\n | (TAuth & { salt: `0x${string}`; saltNonce: `0x${string}`; type?: never } & ChargeCompletion);\n\nexport type Eip3009Authorization = {\n from: `0x${string}`;\n to: `0x${string}`;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: `0x${string}`;\n};\n\nexport type Permit2Authorization = {\n from: `0x${string}`;\n permitted: {\n token: `0x${string}`;\n amount: string;\n };\n spender: `0x${string}`;\n nonce: string;\n deadline: string;\n};\n\nexport type Eip3009Payload = CollectEnvelope<{\n authorization: Eip3009Authorization;\n signature: `0x${string}`;\n}>;\n\nexport type Permit2Payload = CollectEnvelope<{\n permit2Authorization: Permit2Authorization;\n signature: `0x${string}`;\n}>;\n\nexport type AuthCaptureCollectPayload = Eip3009Payload | Permit2Payload;\n\ntype LifecycleBase = {\n paymentInfo: PaymentInfoStruct;\n saltNonce: `0x${string}`;\n authorizerSignature: `0x${string}`;\n};\n\nexport type CapturePayload = LifecycleBase & {\n type: \"capture\";\n amount: string;\n feeReceiver: `0x${string}`;\n expectedCapturableAmount: string;\n expectedRefundableAmount: string;\n voidAuthorizerSignature?: `0x${string}`;\n} & ({ feeBps: number; feeAmount?: never } | { feeAmount: string; feeBps?: never });\n\nexport type VoidPayload = LifecycleBase & {\n type: \"void\";\n voidAuthorizerSignature?: never;\n};\n\nexport type RefundPayload = LifecycleBase & {\n type: \"refund\";\n amount: string;\n expectedCapturableAmount: string;\n expectedRefundableAmount: string;\n voidAuthorizerSignature?: never;\n};\n\nexport type AuthCaptureLifecyclePayload = CapturePayload | VoidPayload | RefundPayload;\n\nexport type AuthCapturePayload = AuthCaptureCollectPayload | AuthCaptureLifecyclePayload;\n\n/**\n * True when `value` has a collect-payload `type` discriminant of `capture` /\n * `void` / `refund`. Field-level validation happens in the lifecycle verifier.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` names a lifecycle operation.\n */\nexport function isLifecyclePayload(value: unknown): value is AuthCaptureLifecyclePayload {\n if (typeof value !== \"object\" || value === null) return false;\n const type = (value as Record<string, unknown>).type;\n return type === \"capture\" || type === \"void\" || type === \"refund\";\n}\n\n/**\n * Type guard for a capture lifecycle payload.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` is a capture envelope with the required fields.\n */\nexport function isCapturePayload(value: unknown): value is CapturePayload {\n if (!isLifecyclePayload(value) || value.type !== \"capture\") return false;\n const v = value as Record<string, unknown>;\n const hasFeeBps = typeof v.feeBps === \"number\";\n const hasFeeAmount = typeof v.feeAmount === \"string\";\n if (hasFeeBps === hasFeeAmount) return false;\n return (\n isPaymentInfoStruct(v.paymentInfo) &&\n typeof v.saltNonce === \"string\" &&\n typeof v.amount === \"string\" &&\n typeof v.feeReceiver === \"string\" &&\n typeof v.expectedCapturableAmount === \"string\" &&\n typeof v.expectedRefundableAmount === \"string\" &&\n typeof v.authorizerSignature === \"string\" &&\n (v.voidAuthorizerSignature === undefined || typeof v.voidAuthorizerSignature === \"string\")\n );\n}\n\n/**\n * Type guard for a void lifecycle payload.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` is a void envelope with the required fields.\n */\nexport function isVoidPayload(value: unknown): value is VoidPayload {\n if (!isLifecyclePayload(value) || value.type !== \"void\") return false;\n const v = value as Record<string, unknown>;\n return (\n isPaymentInfoStruct(v.paymentInfo) &&\n typeof v.saltNonce === \"string\" &&\n typeof v.authorizerSignature === \"string\" &&\n v.voidAuthorizerSignature === undefined\n );\n}\n\n/**\n * Type guard for a refund lifecycle payload.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` is a refund envelope with the required fields.\n */\nexport function isRefundPayload(value: unknown): value is RefundPayload {\n if (!isLifecyclePayload(value) || value.type !== \"refund\") return false;\n const v = value as Record<string, unknown>;\n return (\n isPaymentInfoStruct(v.paymentInfo) &&\n typeof v.saltNonce === \"string\" &&\n typeof v.amount === \"string\" &&\n typeof v.expectedCapturableAmount === \"string\" &&\n typeof v.expectedRefundableAmount === \"string\" &&\n typeof v.authorizerSignature === \"string\" &&\n v.voidAuthorizerSignature === undefined\n );\n}\n\n/**\n * Type guard for the onchain PaymentInfo struct shape.\n *\n * @param value - Candidate struct from a lifecycle payload.\n * @returns True if every PaymentInfo field is present with the expected type.\n */\nfunction isPaymentInfoStruct(value: unknown): value is PaymentInfoStruct {\n if (typeof value !== \"object\" || value === null) return false;\n const v = value as Record<string, unknown>;\n return (\n typeof v.operator === \"string\" &&\n typeof v.payer === \"string\" &&\n typeof v.receiver === \"string\" &&\n typeof v.token === \"string\" &&\n typeof v.maxAmount === \"string\" &&\n typeof v.preApprovalExpiry === \"number\" &&\n typeof v.authorizationExpiry === \"number\" &&\n typeof v.refundExpiry === \"number\" &&\n typeof v.minFeeBps === \"number\" &&\n typeof v.maxFeeBps === \"number\" &&\n typeof v.feeReceiver === \"string\" &&\n typeof v.salt === \"string\"\n );\n}\n\n/**\n * Whether `value` is a 0x-prefixed hex string.\n *\n * @param value - Candidate wire field.\n * @returns True when `value` is hex.\n */\nfunction isHexString(value: unknown): value is `0x${string}` {\n return typeof value === \"string\" && value.startsWith(\"0x\");\n}\n\n/**\n * Parse the four charge-completion fields as an all-or-none group.\n *\n * @param v - Collect payload fields.\n * @returns ChargeCompletion when all four are present and well-typed; undefined when all are absent.\n */\nfunction readChargeCompletion(v: Record<string, unknown>): ChargeCompletion | undefined {\n const hasAny =\n \"amount\" in v ||\n \"feeBps\" in v ||\n \"feeAmount\" in v ||\n \"feeReceiver\" in v ||\n \"authorizerSignature\" in v;\n if (!hasAny) return undefined;\n if (\n typeof v.amount === \"string\" &&\n typeof v.feeBps === \"number\" &&\n v.feeAmount === undefined &&\n typeof v.feeReceiver === \"string\" &&\n typeof v.authorizerSignature === \"string\"\n ) {\n return {\n amount: v.amount,\n feeBps: v.feeBps,\n feeReceiver: v.feeReceiver as `0x${string}`,\n authorizerSignature: v.authorizerSignature as `0x${string}`,\n };\n }\n if (\n typeof v.amount === \"string\" &&\n typeof v.feeAmount === \"string\" &&\n v.feeBps === undefined &&\n typeof v.feeReceiver === \"string\" &&\n typeof v.authorizerSignature === \"string\"\n ) {\n return {\n amount: v.amount,\n feeAmount: v.feeAmount,\n feeReceiver: v.feeReceiver as `0x${string}`,\n authorizerSignature: v.authorizerSignature as `0x${string}`,\n };\n }\n return undefined;\n}\n\n/**\n * Parse collect `salt` and optional `saltNonce`.\n *\n * @param v - Collect payload fields.\n * @returns Unbound or bound salt pair, or undefined when malformed.\n */\nfunction collectExtras(\n v: Record<string, unknown>,\n):\n | { salt: `0x${string}`; saltNonce?: never }\n | { salt: `0x${string}`; saltNonce: `0x${string}` }\n | undefined {\n if (!isHexString(v.salt)) return undefined;\n if (v.saltNonce === undefined) {\n return { salt: v.salt };\n }\n if (!isHexString(v.saltNonce)) return undefined;\n return { salt: v.salt, saltNonce: v.saltNonce };\n}\n\n/**\n * Type guard for an EIP-3009-shaped auth-capture collect payload. Rejects\n * lifecycle envelopes (`payload.type` set) so `payload.type` remains the\n * discriminant the facilitator dispatches on.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` has the EIP-3009 collect envelope shape.\n */\nexport function isEip3009Payload(value: unknown): value is Eip3009Payload {\n if (typeof value !== \"object\" || value === null) return false;\n const v = value as Record<string, unknown>;\n if (v.type !== undefined) return false;\n if (\n typeof v.authorization !== \"object\" ||\n v.authorization === null ||\n typeof v.signature !== \"string\"\n ) {\n return false;\n }\n const saltFields = collectExtras(v);\n if (!saltFields) return false;\n const hasAnyCharge =\n \"amount\" in v ||\n \"feeBps\" in v ||\n \"feeAmount\" in v ||\n \"feeReceiver\" in v ||\n \"authorizerSignature\" in v;\n if (hasAnyCharge) {\n if (!saltFields.saltNonce) return false;\n return readChargeCompletion(v) !== undefined;\n }\n return true;\n}\n\n/**\n * Type guard for a Permit2-shaped auth-capture collect payload.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` has the Permit2 collect envelope shape.\n */\nexport function isPermit2Payload(value: unknown): value is Permit2Payload {\n if (typeof value !== \"object\" || value === null) return false;\n const v = value as Record<string, unknown>;\n if (v.type !== undefined) return false;\n if (typeof v.signature !== \"string\") return false;\n if (typeof v.permit2Authorization !== \"object\" || v.permit2Authorization === null) return false;\n const a = v.permit2Authorization as Record<string, unknown>;\n if (\n typeof a.from !== \"string\" ||\n typeof a.spender !== \"string\" ||\n typeof a.nonce !== \"string\" ||\n typeof a.deadline !== \"string\" ||\n typeof a.permitted !== \"object\" ||\n a.permitted === null\n ) {\n return false;\n }\n const saltFields = collectExtras(v);\n if (!saltFields) return false;\n const hasAnyCharge =\n \"amount\" in v ||\n \"feeBps\" in v ||\n \"feeAmount\" in v ||\n \"feeReceiver\" in v ||\n \"authorizerSignature\" in v;\n if (hasAnyCharge) {\n if (!saltFields.saltNonce) return false;\n return readChargeCompletion(v) !== undefined;\n }\n return true;\n}\n\n/**\n * Type guard for a collect (authorize/charge) payload of either envelope.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` is an EIP-3009 or Permit2 collect envelope.\n */\nexport function isAuthCaptureCollectPayload(value: unknown): value is AuthCaptureCollectPayload {\n return isEip3009Payload(value) || isPermit2Payload(value);\n}\n\n/**\n * Type guard for any auth-capture payload: collect or lifecycle.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` is a valid auth-capture envelope.\n */\nexport function isAuthCapturePayload(value: unknown): value is AuthCapturePayload {\n if (isLifecyclePayload(value)) {\n return isCapturePayload(value) || isVoidPayload(value) || isRefundPayload(value);\n }\n return isAuthCaptureCollectPayload(value);\n}\n\n/**\n * Onchain PaymentInfo struct (canonical Solidity names — DO NOT RENAME).\n * Reconstructed by the facilitator from extra + payload.salt + payer + receiver/asset/amount.\n */\nexport interface PaymentInfoStruct {\n operator: `0x${string}`;\n payer: `0x${string}`;\n receiver: `0x${string}`;\n token: `0x${string}`;\n maxAmount: string;\n preApprovalExpiry: number;\n authorizationExpiry: number;\n refundExpiry: number;\n minFeeBps: number;\n maxFeeBps: number;\n feeReceiver: `0x${string}`;\n salt: `0x${string}`;\n}\n\nexport interface PaymentState {\n hasCollectedPayment: boolean;\n capturableAmount: bigint;\n refundableAmount: bigint;\n}\n","/**\n * Type definitions for the Builder Code Extension (ERC-8021)\n *\n * Enables attribution tracking for x402 payments by appending\n * ERC-8021 Schema 2 builder codes to settlement transaction calldata.\n */\n\nimport type { PaymentPayload, PaymentRequirements } from \"@x402/core/types\";\n\n/**\n * Extension identifier constant\n */\nexport const BUILDER_CODE = \"builder-code\";\n\n/**\n * ERC-8021 marker bytes (16 bytes) appended at the end of every suffix\n */\nexport const ERC_8021_MARKER = \"80218021802180218021802180218021\";\n\n/**\n * Schema 2 identifier byte\n */\nexport const SCHEMA_2_ID = 0x02;\n\n/**\n * Pattern for valid builder codes (lowercase alphanumeric + underscore, 1-32 chars)\n */\nexport const BUILDER_CODE_PATTERN = /^[a-z0-9_]{1,32}$/;\n\n/**\n * Maximum client-provided service codes reserved in the `s` array. Enforced by\n * {@link BuilderCodeClientExtension} independently of the server's reservation\n * so one side can never crowd out the other.\n */\nexport const MAX_CLIENT_SERVICE_CODES = 5;\n\n/**\n * Maximum server-declared service codes reserved in the `s` array. Enforced by\n * `declareBuilderCodeExtension` independently of the client's reservation so\n * one side can never crowd out the other.\n */\nexport const MAX_SERVER_SERVICE_CODES = 5;\n\n/**\n * Maximum facilitator-appended service codes reserved in the `s` array.\n * Enforced by {@link BuilderCodeFacilitatorExtension} for its own\n * `BuilderCodeFacilitatorConfig.serviceCode`.\n */\nexport const MAX_FACILITATOR_SERVICE_CODES = 1;\n\n/**\n * Maximum number of service codes (`s`) encoded onchain at settlement — the\n * sum of each side's dedicated reservation ({@link MAX_CLIENT_SERVICE_CODES},\n * {@link MAX_SERVER_SERVICE_CODES}, {@link MAX_FACILITATOR_SERVICE_CODES}).\n */\nexport const MAX_SERVICE_CODES =\n MAX_CLIENT_SERVICE_CODES + MAX_SERVER_SERVICE_CODES + MAX_FACILITATOR_SERVICE_CODES;\n\n/**\n * Builder code extension data as it appears in PaymentRequired/PaymentPayload extensions.\n *\n * Maps to ERC-8021 Schema 2 fields:\n * - a: app code (the x402 service that exposed the endpoint)\n * - w: wallet code (the facilitator that settled the payment on-chain)\n * - s: service codes array (related on-chain services the app depends on)\n */\nexport interface BuilderCodeExtensionData {\n /**\n * App builder code — the x402 service that exposed the paid endpoint.\n * Maps to the \"a\" field in ERC-8021 Schema 2.\n * Set by the service in the 402 response.\n */\n a?: string;\n\n /**\n * Wallet builder code — the facilitator that settled the payment on-chain.\n * Maps to the \"w\" field in ERC-8021 Schema 2.\n * Set by the facilitator at settlement time.\n */\n w?: string;\n\n /**\n * Service builder codes — client-provided attribution codes.\n * Maps to the \"s\" field in ERC-8021 Schema 2 (encoded as an array on wire).\n * Accepts a single string or an array of strings; normalized to an array internally.\n */\n s?: string | string[];\n}\n\n/**\n * Configuration for the builder code facilitator extension.\n */\nexport interface BuilderCodeFacilitatorConfig {\n /**\n * The facilitator's own builder code, set as the \"w\" field at settlement when provided.\n */\n builderCode?: string;\n\n /**\n * The facilitator's own service code, appended to the \"s\" field at settlement when\n * provided. Reserved independently of the client/server \"s\" entries (see\n * {@link MAX_FACILITATOR_SERVICE_CODES}).\n */\n serviceCode?: string;\n}\n\nexport interface DataSuffixContext {\n paymentPayload: PaymentPayload;\n paymentRequirements: PaymentRequirements;\n}\n","/**\n * ERC-8021 Schema 2 CBOR encoding for builder code suffixes.\n *\n * Schema 2 suffix format:\n * [cbor_data (variable)] [suffix_data_length (2 bytes)] [schema_id = 0x02 (1 byte)] [ERC-8021 marker (16 bytes)]\n *\n * CBOR payload uses single-letter keys:\n * \"a\" — app builder code (string)\n * \"w\" — wallet/facilitator builder code (string)\n * \"s\" — service codes (string array)\n */\n\nimport { type Hex } from \"viem\";\nimport { ERC_8021_MARKER, SCHEMA_2_ID, type BuilderCodeExtensionData } from \"./types\";\n\n/**\n * Normalizes the `s` field (string or array of strings) into an array of strings.\n *\n * @param s - Service code value as a string, array of strings, or undefined\n * @returns Array of service code strings (empty when absent)\n */\nfunction normalizeServiceCodes(s: BuilderCodeExtensionData[\"s\"]): string[] {\n if (typeof s === \"string\") return [s];\n if (Array.isArray(s)) return s;\n return [];\n}\n\n/**\n * Encodes a CBOR map from builder code extension data.\n *\n * Produces a minimal CBOR map with:\n * - \"a\" key (major type 3, length 1) → string value (app/service code)\n * - \"w\" key (major type 3, length 1) → string value (facilitator code)\n * - \"s\" key (major type 3, length 1) → array of strings (related services)\n *\n * Uses hand-rolled CBOR to avoid adding a dependency.\n *\n * @param data - Builder code extension fields to encode\n * @returns CBOR-encoded map bytes\n */\nfunction encodeCborMap(data: BuilderCodeExtensionData): Uint8Array {\n const entries: Uint8Array[] = [];\n let mapSize = 0;\n\n if (data.a) {\n mapSize++;\n entries.push(encodeCborString(\"a\"));\n entries.push(encodeCborString(data.a));\n }\n\n if (data.w) {\n mapSize++;\n entries.push(encodeCborString(\"w\"));\n entries.push(encodeCborString(data.w));\n }\n\n const serviceCodes = normalizeServiceCodes(data.s);\n if (serviceCodes.length > 0) {\n mapSize++;\n entries.push(encodeCborString(\"s\"));\n entries.push(encodeCborArray(serviceCodes));\n }\n\n // CBOR map header\n const header = encodeCborMajorType(5, mapSize); // major type 5 = map\n\n const totalLength = header.length + entries.reduce((sum, e) => sum + e.length, 0);\n const result = new Uint8Array(totalLength);\n let offset = 0;\n\n result.set(header, offset);\n offset += header.length;\n\n for (const entry of entries) {\n result.set(entry, offset);\n offset += entry.length;\n }\n\n return result;\n}\n\n/**\n * Encodes a CBOR text string (major type 3).\n *\n * @param value - UTF-8 text to encode\n * @returns CBOR-encoded text string bytes\n */\nfunction encodeCborString(value: string): Uint8Array {\n const encoded = new TextEncoder().encode(value);\n const header = encodeCborMajorType(3, encoded.length); // major type 3 = text string\n const result = new Uint8Array(header.length + encoded.length);\n result.set(header, 0);\n result.set(encoded, header.length);\n return result;\n}\n\n/**\n * Encodes a CBOR array of strings (major type 4).\n *\n * @param values - UTF-8 strings to encode as array elements\n * @returns CBOR-encoded array bytes\n */\nfunction encodeCborArray(values: string[]): Uint8Array {\n const header = encodeCborMajorType(4, values.length); // major type 4 = array\n const encodedValues = values.map(encodeCborString);\n\n const totalLength = header.length + encodedValues.reduce((sum, e) => sum + e.length, 0);\n const result = new Uint8Array(totalLength);\n let offset = 0;\n\n result.set(header, offset);\n offset += header.length;\n\n for (const encoded of encodedValues) {\n result.set(encoded, offset);\n offset += encoded.length;\n }\n\n return result;\n}\n\n/**\n * Encodes a CBOR major type with an argument value.\n *\n * CBOR encoding rules:\n * - 0-23: single byte (major type << 5 | value)\n * - 24-255: two bytes (major type << 5 | 24, value)\n * - 256-65535: three bytes (major type << 5 | 25, value high, value low)\n *\n * @param majorType - CBOR major type (0–7)\n * @param value - Argument length or inline value for the header\n * @returns CBOR header bytes\n */\nfunction encodeCborMajorType(majorType: number, value: number): Uint8Array {\n const mt = majorType << 5;\n\n if (value <= 23) {\n return new Uint8Array([mt | value]);\n }\n if (value <= 0xff) {\n return new Uint8Array([mt | 24, value]);\n }\n if (value <= 0xffff) {\n return new Uint8Array([mt | 25, (value >> 8) & 0xff, value & 0xff]);\n }\n\n throw new Error(`CBOR value too large: ${value}`);\n}\n\n/**\n * Builds a complete ERC-8021 Schema 2 data suffix from builder code data.\n *\n * Format: [cbor_data][suffix_data_length (2 bytes)][schema_id (1 byte)][marker (16 bytes)]\n *\n * The suffix_data_length covers the cbor_data only (not itself, schema_id, or marker).\n *\n * @param data - Builder code extension data with \"a\" and/or \"s\" fields\n * @returns Hex-encoded suffix bytes (without 0x prefix) ready to append to calldata\n */\nexport function encodeBuilderCodeSuffix(data: BuilderCodeExtensionData): Hex {\n const cborBytes = encodeCborMap(data);\n const cborLength = cborBytes.length;\n\n // suffix_data_length is 2 bytes, big-endian\n const lengthHigh = (cborLength >> 8) & 0xff;\n const lengthLow = cborLength & 0xff;\n\n // Build the full suffix: [cbor][length 2B][schema_id 1B][marker 16B]\n const suffixBytes = new Uint8Array(cborLength + 2 + 1 + 16);\n let offset = 0;\n\n // CBOR data\n suffixBytes.set(cborBytes, offset);\n offset += cborLength;\n\n // Suffix data length (2 bytes, big-endian)\n suffixBytes[offset++] = lengthHigh;\n suffixBytes[offset++] = lengthLow;\n\n // Schema ID\n suffixBytes[offset++] = SCHEMA_2_ID;\n\n // ERC-8021 marker (16 bytes)\n const markerBytes = hexToBytes(ERC_8021_MARKER);\n suffixBytes.set(markerBytes, offset);\n\n return `0x${bytesToHex(suffixBytes)}`;\n}\n\n/**\n * Converts a hex string (without 0x prefix) to bytes.\n *\n * @param hex - Hex-encoded string (two characters per byte)\n * @returns Decoded byte array\n */\nfunction hexToBytes(hex: string): Uint8Array {\n const bytes = new Uint8Array(hex.length / 2);\n for (let i = 0; i < hex.length; i += 2) {\n bytes[i / 2] = parseInt(hex.substring(i, i + 2), 16);\n }\n return bytes;\n}\n\n/**\n * Converts bytes to a lowercase hex string (without 0x prefix).\n *\n * @param bytes - Raw bytes to encode\n * @returns Lowercase hex string\n */\nfunction bytesToHex(bytes: Uint8Array): string {\n return Array.from(bytes)\n .map(b => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n}\n\n/**\n * Parses ERC-8021 Schema 2 builder code attribution from settlement calldata.\n *\n * @param calldata - Full transaction input data\n * @returns Decoded builder code fields, or undefined if no valid suffix is present\n */\nexport function parseBuilderCodeSuffixFromCalldata(\n calldata: Hex,\n): BuilderCodeExtensionData | undefined {\n const hex = calldata.startsWith(\"0x\") ? calldata.slice(2) : calldata;\n const markerPos = hex.lastIndexOf(ERC_8021_MARKER.toLowerCase());\n if (markerPos < 6) {\n return undefined;\n }\n\n if (parseInt(hex.slice(markerPos - 2, markerPos), 16) !== SCHEMA_2_ID) {\n return undefined;\n }\n\n const cborLength = parseInt(hex.slice(markerPos - 6, markerPos - 2), 16);\n const suffixStart = markerPos - 6 - cborLength * 2;\n if (suffixStart < 0 || suffixStart + (cborLength + 19) * 2 !== hex.length) {\n return undefined;\n }\n\n const bytes = hexToBytes(hex.slice(suffixStart, markerPos - 6));\n let o = 0;\n\n if (bytes[o] >> 5 !== 5) {\n return undefined;\n }\n\n const mapInfo = bytes[o++] & 0x1f;\n const mapSize = mapInfo <= 23 ? mapInfo : mapInfo === 24 ? bytes[o++] : undefined;\n if (mapSize === undefined) {\n return undefined;\n }\n\n const result: BuilderCodeExtensionData = {};\n for (let entry = 0; entry < mapSize; entry++) {\n if (bytes[o] >> 5 !== 3) {\n return undefined;\n }\n\n const keyInfo = bytes[o++] & 0x1f;\n const keyLen = keyInfo <= 23 ? keyInfo : keyInfo === 24 ? bytes[o++] : undefined;\n if (keyLen === undefined) {\n return undefined;\n }\n\n const key = new TextDecoder().decode(bytes.subarray(o, o + keyLen));\n o += keyLen;\n\n if (key === \"a\" || key === \"w\") {\n if (bytes[o] >> 5 !== 3) {\n return undefined;\n }\n\n const valueInfo = bytes[o++] & 0x1f;\n const valueLen = valueInfo <= 23 ? valueInfo : valueInfo === 24 ? bytes[o++] : undefined;\n if (valueLen === undefined) {\n return undefined;\n }\n\n result[key] = new TextDecoder().decode(bytes.subarray(o, o + valueLen));\n o += valueLen;\n continue;\n }\n\n if (key === \"s\") {\n if (bytes[o] >> 5 !== 4) {\n return undefined;\n }\n\n const arrayInfo = bytes[o++] & 0x1f;\n const arraySize = arrayInfo <= 23 ? arrayInfo : arrayInfo === 24 ? bytes[o++] : undefined;\n if (arraySize === undefined) {\n return undefined;\n }\n\n const codes: string[] = [];\n for (let i = 0; i < arraySize; i++) {\n if (bytes[o] >> 5 !== 3) {\n return undefined;\n }\n\n const itemInfo = bytes[o++] & 0x1f;\n const itemLen = itemInfo <= 23 ? itemInfo : itemInfo === 24 ? bytes[o++] : undefined;\n if (itemLen === undefined) {\n return undefined;\n }\n\n codes.push(new TextDecoder().decode(bytes.subarray(o, o + itemLen)));\n o += itemLen;\n }\n\n if (codes.length > 0) {\n result.s = codes;\n }\n continue;\n }\n\n return undefined;\n }\n\n return result;\n}\n","/**\n * Resource Server utilities for the Builder Code Extension.\n */\n\nimport type { ResourceServerExtension } from \"@x402/core/types\";\nimport {\n BUILDER_CODE,\n BUILDER_CODE_PATTERN,\n MAX_SERVER_SERVICE_CODES,\n MAX_SERVICE_CODES,\n type BuilderCodeExtensionData,\n} from \"./types\";\n\nexport const BUILDER_CODE_SCHEMA = {\n $schema: \"https://json-schema.org/draft/2020-12/schema\",\n type: \"object\",\n properties: {\n a: {\n type: \"string\",\n pattern: \"^[a-z0-9_]{1,32}$\",\n description: \"App builder code\",\n },\n w: {\n type: \"string\",\n pattern: \"^[a-z0-9_]{1,32}$\",\n description: \"Wallet builder code\",\n },\n s: {\n type: \"array\",\n maxItems: MAX_SERVICE_CODES,\n items: {\n type: \"string\",\n pattern: \"^[a-z0-9_]{1,32}$\",\n },\n description: \"Service builder codes\",\n },\n },\n additionalProperties: false,\n} as const;\n\nexport interface BuilderCodeRequiredExtension {\n info: BuilderCodeExtensionData;\n schema: typeof BUILDER_CODE_SCHEMA;\n}\n\n/**\n * Declares the builder-code extension for inclusion in PaymentRequired.extensions.\n *\n * @param appCode - The service's builder code (e.g., \"bc_weather_svc\")\n * @param serviceCodes - Optional service code(s) (e.g. attribution for a server-side\n * SDK the service depends on). Client-provided service codes are merged with these\n * by the core client, client entries first.\n * @returns Extension declaration with info and schema for PaymentRequired.extensions\n */\nexport function declareBuilderCodeExtension(\n appCode: string,\n serviceCodes?: string | string[],\n): BuilderCodeRequiredExtension {\n if (!BUILDER_CODE_PATTERN.test(appCode)) {\n throw new Error(\n `Invalid builder code: \"${appCode}\". ` +\n `Must be 1-32 characters, lowercase alphanumeric and underscores only.`,\n );\n }\n\n const codes = serviceCodes === undefined ? [] : ([] as string[]).concat(serviceCodes);\n if (codes.length > MAX_SERVER_SERVICE_CODES) {\n throw new Error(\n `Too many service codes: ${codes.length} exceeds the maximum of ${MAX_SERVER_SERVICE_CODES}.`,\n );\n }\n for (const code of codes) {\n if (!BUILDER_CODE_PATTERN.test(code)) {\n throw new Error(\n `Invalid builder code: \"${code}\". ` +\n `Must be 1-32 characters, lowercase alphanumeric and underscores only.`,\n );\n }\n }\n\n return {\n info: codes.length > 0 ? { a: appCode, s: codes } : { a: appCode },\n schema: BUILDER_CODE_SCHEMA,\n };\n}\n\nexport const builderCodeResourceServerExtension: ResourceServerExtension = {\n key: BUILDER_CODE,\n};\n","/**\n * Client-side extension for the Builder Code Extension.\n *\n * Attaches the client's service code (`s`) to the payment payload.\n */\n\nimport type { ClientExtension } from \"@x402/core/client\";\nimport type { PaymentPayload, PaymentRequired } from \"@x402/core/types\";\nimport { BUILDER_CODE, BUILDER_CODE_PATTERN, MAX_CLIENT_SERVICE_CODES } from \"./types\";\n\n/**\n * Client extension that adds builder-code attribution to payment payloads.\n *\n * @example\n * ```typescript\n * import { BuilderCodeClientExtension } from '@x402/extensions/builder-code';\n *\n * const client = new x402Client();\n * client.registerExtension(new BuilderCodeClientExtension(\"bc_my_client\"));\n * ```\n */\nexport class BuilderCodeClientExtension implements ClientExtension {\n readonly key = BUILDER_CODE;\n private readonly serviceCodes: string[];\n\n /**\n * Creates a client extension that attaches the given service code(s) to payments.\n *\n * Accepts a single code or an array of codes so layered clients (e.g. an MCP\n * middleware) can attribute multiple participants. Codes are normalized to an\n * array and sent as the `s` field.\n *\n * @param serviceCodes - Client service code(s) (`s`), each 1-32 lowercase alphanumeric/underscore characters\n */\n constructor(serviceCodes: string | string[]) {\n const codes = Array.isArray(serviceCodes) ? serviceCodes : [serviceCodes];\n if (codes.length > MAX_CLIENT_SERVICE_CODES) {\n throw new Error(\n `Too many service codes: ${codes.length} exceeds the maximum of ${MAX_CLIENT_SERVICE_CODES}.`,\n );\n }\n for (const code of codes) {\n if (!BUILDER_CODE_PATTERN.test(code)) {\n throw new Error(\n `Invalid builder code: \"${code}\". ` +\n `Must be 1-32 characters, lowercase alphanumeric and underscores only.`,\n );\n }\n }\n this.serviceCodes = codes;\n }\n\n /**\n * Attaches this client's service code(s) (`s`).\n *\n * @param payload - Payment payload to enrich\n * @param _ - Server payment requirements; core merges server extension data\n * @returns Payment payload with builder-code extension data\n */\n async enrichPaymentPayload(payload: PaymentPayload, _: PaymentRequired): Promise<PaymentPayload> {\n return {\n ...payload,\n extensions: {\n ...payload.extensions,\n [BUILDER_CODE]: { info: { s: this.serviceCodes } },\n },\n };\n }\n}\n","/**\n * Facilitator-side extension for the Builder Code Extension.\n *\n * At settlement time, the facilitator encodes its wallet code into the ERC-8021\n * suffix when configured. App code (`a`) and service code (`s`) are read from\n * the client payment payload extensions.\n */\n\nimport type { FacilitatorExtension } from \"@x402/core/types\";\nimport type { Hex } from \"viem\";\nimport { encodeBuilderCodeSuffix } from \"./cbor\";\nimport {\n BUILDER_CODE,\n BUILDER_CODE_PATTERN,\n MAX_CLIENT_SERVICE_CODES,\n MAX_SERVER_SERVICE_CODES,\n type BuilderCodeExtensionData,\n type BuilderCodeFacilitatorConfig,\n type DataSuffixContext,\n} from \"./types\";\n\n/**\n * Reads the client builder-code extension object from payment-payload extensions.\n *\n * @param extensions - Extensions map from PaymentPayload\n * @returns Raw builder-code extension object, or undefined if absent\n */\nfunction extractClientExtension(\n extensions?: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n const info = (extensions?.[BUILDER_CODE] as { info?: unknown } | undefined)?.info;\n if (typeof info !== \"object\" || info === null || Array.isArray(info)) return undefined;\n return info as Record<string, unknown>;\n}\n\n/**\n * Maximum echoed client+server service codes, before the facilitator's own\n * {@link MAX_FACILITATOR_SERVICE_CODES} reservation is appended. Each side\n * already caps its own contribution ({@link MAX_CLIENT_SERVICE_CODES},\n * {@link MAX_SERVER_SERVICE_CODES}) at declaration time, so this bound is a\n * defensive backstop against a malformed or hand-crafted payload rather than\n * something a compliant client/server pair could ever hit.\n */\nconst MAX_ECHOED_SERVICE_CODES = MAX_CLIENT_SERVICE_CODES + MAX_SERVER_SERVICE_CODES;\n\n/**\n * Normalizes `s` from the client payload — accepts a string or an array, keeps\n * valid entries in order, and truncates to {@link MAX_ECHOED_SERVICE_CODES}.\n *\n * @param raw - Client-provided service code value (string or array of strings)\n * @returns Array of valid service codes (empty when missing or all invalid)\n */\nfunction resolveServiceCodes(raw: unknown): string[] {\n const candidates = typeof raw === \"string\" ? [raw] : Array.isArray(raw) ? raw : [];\n return candidates\n .filter((v): v is string => typeof v === \"string\" && BUILDER_CODE_PATTERN.test(v))\n .slice(0, MAX_ECHOED_SERVICE_CODES);\n}\n\n/**\n * Facilitator extension that manages builder code attribution at settlement time.\n *\n * @example\n * ```typescript\n * import { BuilderCodeFacilitatorExtension } from '@x402/extensions/builder-code';\n *\n * const facilitator = new x402Facilitator();\n * facilitator.registerExtension(new BuilderCodeFacilitatorExtension({\n * builderCode: \"bc_my_facilitator\", // optional\n * }));\n * ```\n */\nexport class BuilderCodeFacilitatorExtension implements FacilitatorExtension {\n readonly key = BUILDER_CODE;\n private readonly config: BuilderCodeFacilitatorConfig;\n\n /**\n * Creates a facilitator extension that encodes builder-code attribution at settlement.\n *\n * @param config - Optional facilitator builder-code configuration (wallet code `w`, service code `s`)\n */\n constructor(config: BuilderCodeFacilitatorConfig = {}) {\n if (config.builderCode && !BUILDER_CODE_PATTERN.test(config.builderCode)) {\n throw new Error(\n `Invalid builder code: \"${config.builderCode}\". ` +\n `Must be 1-32 characters, lowercase alphanumeric and underscores only.`,\n );\n }\n if (config.serviceCode && !BUILDER_CODE_PATTERN.test(config.serviceCode)) {\n throw new Error(\n `Invalid builder code: \"${config.serviceCode}\". ` +\n `Must be 1-32 characters, lowercase alphanumeric and underscores only.`,\n );\n }\n this.config = config;\n }\n\n /**\n * Builds the ERC-8021 Schema 2 calldata suffix for a settlement transaction.\n *\n * - On v2 payloads, `a` is read from the client's payment payload extensions.\n * - On v1 payloads, client `a` is omitted (no resource-server echo gate); `s` is still read.\n * - `w` is the facilitator's own code when configured.\n * - The facilitator's own `s` entry (`config.serviceCode`) is appended after the\n * echoed client/server codes, within its own {@link MAX_FACILITATOR_SERVICE_CODES}\n * reservation.\n *\n * @param ctx - Settlement context with payment-payload extensions\n * @returns Hex-encoded ERC-8021 builder-code calldata suffix, or undefined when no attribution is present\n */\n buildDataSuffix(ctx: DataSuffixContext): Hex | undefined {\n const clientExt = extractClientExtension(ctx.paymentPayload.extensions);\n // v1 payloads omit `a`: the resource-server echo gate does not run on v1.\n const a =\n ctx.paymentPayload.x402Version === 2 &&\n typeof clientExt?.a === \"string\" &&\n BUILDER_CODE_PATTERN.test(clientExt.a)\n ? clientExt.a\n : undefined;\n const echoedServiceCodes = resolveServiceCodes(clientExt?.s);\n const s =\n this.config.serviceCode && !echoedServiceCodes.includes(this.config.serviceCode)\n ? [...echoedServiceCodes, this.config.serviceCode]\n : echoedServiceCodes;\n\n const data: BuilderCodeExtensionData = {\n ...(this.config.builderCode && { w: this.config.builderCode }),\n ...(a && { a }),\n ...(s.length > 0 && { s }),\n };\n\n if (!data.a && !data.w && (!data.s || (Array.isArray(data.s) && data.s.length === 0))) {\n return undefined;\n }\n\n return encodeBuilderCodeSuffix(data);\n }\n}\n","import { x402Client, x402HTTPClient } from '@x402/core/client';\nimport type { PaymentPolicy } from '@x402/core/client';\nimport { ExactEvmScheme } from '@x402/evm';\nimport { BuilderCodeClientExtension } from '@x402/extensions/builder-code';\nimport type { ClientEvmSigner } from '@x402/evm';\nimport type { PaymentRequired, PaymentRequirements } from '@x402/core/types';\nimport type { TypedDataDefinition } from 'viem';\nimport { getAddress } from 'viem';\nimport { CliError } from './errors';\nimport { sanitizeForTerminal } from './output';\nimport { USDC_ADDRESS } from './usdc';\nimport type { TenjinSigner } from './wallet/provider';\nimport { isRecord } from './guards';\nimport { ADDRESS_RE } from './ids';\n\n/**\n * x402 exact-scheme payment construction (spec 10 sanctioned deps: @x402/* +\n * viem). Given the server's decoded PAYMENT-REQUIRED and a structural signer, it\n * produces the `PAYMENT-SIGNATURE` header the paid re-request carries. The base\n * exact flow needs only `address` + `signTypedData` (no RPC), so this never\n * touches the network, the signature is an offline EIP-712/EIP-3009 authorization\n * the facilitator settles.\n */\n\nexport interface BuiltPayment {\n /** The `PAYMENT-SIGNATURE` header(s) to attach to the paid re-request. */\n headers: Record<string, string>;\n /** The exact amount authorized, atomic USDC (from accepts[0]). */\n amountAtomic: bigint;\n /** The wallet that signed it, read from the signer, never the payload: who\n * paid, whatever shape the scheme's payload has. */\n payer: string;\n /** The signed EIP-3009 authorization's identity, when the scheme used one,\n * with the network and token of the requirement it was signed for: enough\n * to ask that token later whether it was spent. */\n authorization?: {\n from: string;\n nonce: string;\n validBefore: string;\n network: string;\n asset: string;\n };\n}\n\n/** `payload.authorization`'s `from`, `nonce` and `validBefore`, on the\n * requirement's network and asset, or nothing. */\nfunction authorizationOf(\n payload: unknown,\n requirement: Pick<PaymentRequirements, 'network' | 'asset'>,\n): BuiltPayment['authorization'] {\n const inner = (payload as { payload?: { authorization?: unknown } } | null)?.payload;\n const auth = inner?.authorization;\n if (auth === null || typeof auth !== 'object') return undefined;\n const { from, nonce, validBefore } = auth as Record<string, unknown>;\n if (typeof from !== 'string' || !ADDRESS_RE.test(from)) return undefined;\n if (typeof nonce !== 'string' || !/^0x[0-9a-fA-F]{64}$/.test(nonce)) return undefined;\n const before = typeof validBefore === 'number' ? String(validBefore) : validBefore;\n if (typeof before !== 'string' || !/^\\d+$/.test(before)) return undefined;\n return {\n from,\n nonce,\n validBefore: before,\n network: requirement.network,\n asset: requirement.asset,\n };\n}\n\n/**\n * Build the payment header for the first advertised requirement. The read route\n * advertises exactly one `exact` requirement; if the scheme isn't the exact-EVM\n * this CLI supports, it fails PAYMENT_FAILED rather than signing something the\n * facilitator will reject.\n */\n/**\n * The only asset/chain pairs this CLI will EVER sign for: canonical USDC on\n * Base, and on Base Sepolia for previews. Both are 6-decimal, so every USD\n * display and cap in the CLI stays truthful. Without this pin, a hostile or\n * misconfigured 402 (reachable via --base-url or a candidate URL) could name\n * any eip155 chain, any token, and its own payTo: the signed EIP-3009\n * authorization is a bearer instrument valid on that chain's contract directly,\n * no Tenjin facilitator required. Asset compare is checksummed via getAddress.\n */\nconst ALLOWED_USDC_BY_NETWORK: Record<string, string> = {\n 'eip155:8453': USDC_ADDRESS,\n 'eip155:84532': '0x036CbD53842c5426634e7929541eC2318f3dCF7e',\n};\n\n/**\n * Tenjin's registered ERC-8021 builder code, claimed here as the client service\n * code (`s`). One value, not a CLI-specific second code: Base registers one code\n * per account, and Schema 2 already separates the roles structurally, so a\n * payment this CLI brokers to Tenjin carries the code in BOTH `a` (seller) and\n * `s` (client) while a payment to any other seller carries it only in `s`. It\n * names the client, never the user, and is public by construction. Attribution\n * only, never proof: the ERC-8021 suffix is emitted by the FACILITATOR at\n * settlement, so a facilitator without the extension registered puts nothing on\n * chain, and `s` is unauthenticated and seller-writable, so an occurrence of the\n * code proves nothing about who brokered the payment. Constant, not\n * configurable: a per-install override would make the code meaningless as a\n * client identity.\n */\nexport const TENJIN_CLI_BUILDER_CODE = 'bc_kc0altv3';\n\n/**\n * Drop any `builder-code.info.s` the SELLER declared, leaving its `a` and schema\n * untouched. Without this a 402 that names its own `s` silently wins: the SDK\n * merges the enriched payload onto the server's extensions as the base and\n * copies a client field only where the server left it unset, so the client\n * extension's `{info: {s}}` is discarded and Tenjin's code never reaches the\n * payload, with no error. Narrowing the top-level `extensions` key set does not\n * help, the override lives inside the entry. Per ERC-8021 Schema 2 `a` is the\n * seller's to declare and `s` is the client's, so removing it here restores the\n * roles rather than suppressing seller data, and this is client-side composition\n * of what we send: nothing off-spec goes on the wire.\n */\nfunction withoutSellerServiceCodes(\n extensions: PaymentRequired['extensions'],\n key: string,\n): PaymentRequired['extensions'] {\n const entry = extensions?.[key];\n if (!isRecord(entry) || !isRecord(entry.info)) return extensions;\n const info = { ...entry.info };\n delete info.s;\n return { ...extensions, [key]: { ...entry, info } };\n}\n\n/**\n * THE SDK OWNS SELECTION AND PAYLOAD; THIS FILE OWNS WHAT THIS WALLET HOLDS.\n *\n * `x402Client.selectPaymentRequirements` filters a 402's `accepts` to the\n * (network, scheme) pairs registered on the client, runs the registered\n * policies, and picks from what survives. Registering the exact EVM scheme for\n * the Base networks therefore IS the selection rule, and the canonical-USDC pin\n * below is a policy, which the SDK applies as a veto and never as a licence.\n *\n * It replaces a hand-rolled `accepts[0]`, which registered the scheme for\n * whatever network the FIRST entry named and then agreed that entry was\n * supported. Against CoinMarketCap, whose live 402 lists seven entries with BNB\n * chain first and Base USDC third, every quote was priced against an\n * 18-decimal BNB entry and refused before anything was signed.\n */\nexport function createPayerClient(getSigner: () => TenjinSigner): {\n core: x402Client;\n http: x402HTTPClient;\n builderCodeKey: string;\n} {\n // LAZY, so selection can run before the wallet is opened: the price check and\n // the advertised-terms check both happen before a signer exists on purpose,\n // and neither reads an address.\n const lazy: ClientEvmSigner = {\n get address() {\n return getSigner().address;\n },\n signTypedData: (message) =>\n getSigner().signTypedData(message as unknown as TypedDataDefinition),\n };\n const core = new x402Client();\n for (const network of Object.keys(ALLOWED_USDC_BY_NETWORK)) {\n core.register(network as `${string}:${string}`, new ExactEvmScheme(lazy));\n }\n core.registerPolicy(canonicalUsdcOnly);\n core.registerPolicy(eip3009Only);\n // The SDK (2.21+) runs this hook on every payment, so every seller gets\n // Tenjin's service code; a seller that declared `builder-code` also gets its\n // own fields echoed. Both are the SDK's own payload.\n const builderCode = new BuilderCodeClientExtension(TENJIN_CLI_BUILDER_CODE);\n core.registerExtension(builderCode);\n return { core, http: new x402HTTPClient(core), builderCodeKey: builderCode.key };\n}\n\n/**\n * A VETO, in the SDK's own vocabulary: the scheme registration already limits\n * the networks, and this drops any entry on one of them whose asset is not that\n * network's canonical USDC. Without it a seller could advertise `exact` on Base\n * in a token of its choosing, and the signed EIP-3009 authorization is valid\n * against that token's contract directly, no facilitator required.\n */\nexport const canonicalUsdcOnly: PaymentPolicy = (_version, requirements) =>\n requirements.filter(isCanonicalUsdc);\n\n/**\n * EIP-3009 ONLY, until this CLI supports Permit2. The SDK signs a Permit2\n * transfer for an entry whose `extra.assetTransferMethod` asks for one, and\n * that cannot settle without a Permit2 allowance this CLI never sets (the\n * facilitator answers `invalid_exact_evm_permit2_payload_allowance_required`).\n * An entry that names no method is\n * EIP-3009, as the SDK reads it; any other method is dropped too.\n */\nexport const eip3009Only: PaymentPolicy = (_version, requirements) =>\n requirements.filter(signsEip3009);\n\n/** The transfer method an entry asks for, as the seller wrote it. */\nfunction transferMethod(entry: Pick<PaymentRequirements, 'extra'>): unknown {\n return (entry.extra as Record<string, unknown> | undefined)?.assetTransferMethod;\n}\n\n/** Whether the SDK would sign an EIP-3009 authorization for this entry. */\nexport function signsEip3009(entry: Pick<PaymentRequirements, 'extra'>): boolean {\n const method = transferMethod(entry);\n return method === undefined || method === 'eip3009';\n}\n\n/**\n * Whether an entry names canonical USDC on a chain this CLI pays on. Only such\n * an amount is 6-decimal by construction, so only it may be shown in USD.\n */\nexport function isCanonicalUsdc(entry: Pick<PaymentRequirements, 'network' | 'asset'>): boolean {\n const allowed = ALLOWED_USDC_BY_NETWORK[entry.network];\n if (allowed === undefined) return false;\n try {\n return getAddress(entry.asset) === getAddress(allowed);\n } catch {\n return false;\n }\n}\n\n/**\n * The entry the SDK would pay, or undefined when it would pay none. The SDK\n * throws on an empty selection; callers here have their own named refusals, so\n * the throw becomes an absence. `want` narrows it to a caller's advertised\n * terms, which is a further veto and never a widening.\n */\nexport function selectPayableRequirement(\n core: x402Client,\n paymentRequired: PaymentRequired,\n want?: { network?: string; asset?: string },\n): PaymentRequirements | undefined {\n const approved = supportedEntries(paymentRequired);\n if (want === undefined) return sdkSelect(core, paymentRequired) ?? approved[0];\n // A caller holding terms wants the supported entry that matches THEM, so the\n // search runs over the same policy-approved set the SDK would choose from\n // rather than over the raw list.\n return approved.find(\n (r) =>\n (want.network === undefined || r.network === want.network) &&\n (want.asset === undefined || sameAsset(r.asset, want.asset)),\n );\n}\n\n/**\n * The entries the SDK's selection would consider: the registered networks, the\n * `exact` scheme, and the canonical-USDC policy. Spelled here because the\n * SDK's own `selectPaymentRequirements` is typed private at 2.17.0, so this is\n * the set the adapter below falls back to and the set a terms-narrowed search\n * runs over; the SIGNATURE always goes through the SDK either way.\n */\nfunction supportedEntries(paymentRequired: PaymentRequired): PaymentRequirements[] {\n return canonicalUsdcOnly(paymentRequired.x402Version, paymentRequired.accepts).filter(\n (r) =>\n r.scheme === 'exact' && ALLOWED_USDC_BY_NETWORK[r.network] !== undefined && signsEip3009(r),\n );\n}\n\n/**\n * The SDK's own selector when it is reachable. `selectPaymentRequirements` is\n * public at runtime and carries the registered schemes, the policies and the\n * configured selector, which is exactly the decision wanted here; it is only\n * typed private, so the call is adapted rather than reimplemented, and an SDK\n * that ever removes it degrades to {@link supportedEntries} rather than\n * breaking. A test pins the two agreeing on a multi-network challenge.\n */\nfunction sdkSelect(\n core: x402Client,\n paymentRequired: PaymentRequired,\n): PaymentRequirements | undefined {\n const select = (\n core as unknown as {\n selectPaymentRequirements?: (\n version: number,\n accepts: readonly PaymentRequirements[],\n ) => PaymentRequirements;\n }\n ).selectPaymentRequirements;\n if (typeof select !== 'function') return undefined;\n try {\n return select.call(core, paymentRequired.x402Version, paymentRequired.accepts);\n } catch {\n return undefined;\n }\n}\n\nfunction sameAsset(a: string, b: string): boolean {\n try {\n return getAddress(a) === getAddress(b);\n } catch {\n return a.toLowerCase() === b.toLowerCase();\n }\n}\n\n/**\n * The named refusal when a 402 advertises nothing this wallet can pay. An\n * entry it would pay but for its transfer method is named by that method:\n * Permit2 only when it asks for `permit2`, any other as the seller wrote it.\n */\nexport function noPayableRequirement(accepts: readonly PaymentRequirements[]): CliError {\n const advertised = accepts.map((a) => `${a.scheme}/${a.network}/${a.asset}`);\n const unsigned = accepts.find(\n (a) => a.scheme === 'exact' && isCanonicalUsdc(a) && !signsEip3009(a),\n );\n const method = unsigned !== undefined ? transferMethod(unsigned) : undefined;\n const permit2 = method === 'permit2';\n return new CliError(\n 'PAYMENT_FAILED',\n accepts.length === 0\n ? 'The 402 advertised no payment requirements.'\n : permit2\n ? 'The 402 asks for a Permit2 transfer, which this CLI does not sign: it pays USDC on Base by EIP-3009 only.'\n : unsigned !== undefined\n ? `This payment method is not supported: the 402 asks for the transfer method \"${sanitizeForTerminal(String(method)).slice(0, 100)}\", and this CLI pays USDC on Base by EIP-3009 only.`\n : 'The 402 advertises nothing this CLI can pay: it lists no exact-scheme entry in canonical USDC on Base.',\n {\n fix: 'Only USDC on Base (eip155:8453) by EIP-3009, or Base Sepolia for previews, is supported. Nothing was signed.',\n ...(accepts.length > 0\n ? { details: { advertised, ...(permit2 ? { reason: 'permit2' } : {}) } }\n : {}),\n },\n );\n}\n\n/**\n * Build the `PAYMENT-SIGNATURE` header for the entry the SDK selects, or for\n * `only` when the caller has already selected one and wants that exact deal\n * signed. Selection, payload construction and header encoding are all the\n * SDK's; what stays here is which networks and assets this wallet holds.\n */\nexport async function buildExactPayment(\n paymentRequired: PaymentRequired,\n signer: TenjinSigner,\n only?: PaymentRequirements,\n): Promise<BuiltPayment> {\n const { core, http, builderCodeKey } = createPayerClient(() => signer);\n const requirement = only ?? selectPayableRequirement(core, paymentRequired);\n if (requirement === undefined) throw noPayableRequirement(paymentRequired.accepts);\n // THE SDK'S PER-PAYMENT CAP IS THE AUTHORIZED AMOUNT. Since 2.23 the client\n // refuses anything over $1 unless told otherwise; the spend policy has already\n // authorized this exact requirement (with consent when it is manual), so the\n // cap is set to it: the SDK then signs that amount and nothing larger.\n core.setSpendControls({\n allowedAssets: [\n {\n network: requirement.network,\n asset: requirement.asset,\n maxAmountPerPayment: requirement.amount,\n },\n ],\n });\n\n // A single-accept challenge, so nothing can re-select a different or costlier\n // entry between the check and the signature. Narrow `accepts` only, so the\n // extensions the seller declared still ride along.\n const bound: PaymentRequired = {\n ...paymentRequired,\n accepts: [requirement],\n extensions: withoutSellerServiceCodes(paymentRequired.extensions, builderCodeKey),\n };\n\n let headers: Record<string, string>;\n let authorization: BuiltPayment['authorization'];\n try {\n const payload = await http.createPaymentPayload(bound);\n headers = http.encodePaymentSignatureHeader(payload);\n authorization = authorizationOf(payload, requirement);\n } catch (err) {\n throw new CliError('PAYMENT_FAILED', 'Could not build the x402 payment authorization.', {\n fix: 'Confirm the wallet is a supported EVM account on the advertised network.',\n cause: err,\n });\n }\n\n return {\n headers,\n amountAtomic: BigInt(requirement.amount),\n payer: signer.address,\n ...(authorization !== undefined ? { authorization } : {}),\n };\n}\n"],"mappings":"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AAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,YAAY;IACV;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,eAAe;IACb;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;MACR,qBAAqB;MACrB,iBAAiB;IACnB;EACF;;EACA,cAAc;IACZ;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,cAAc;IACZ;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,eAAe;IACb;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,cAAc;IACZ;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,iBAAiB;IACf;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;MACR,qBAAqB;MACrB,iBAAiB;IACnB;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;MACR,qBAAqB;MACrB,iBAAiB;IACnB;EACF;;EACA,iBAAiB;IACf;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;MACR,qBAAqB;MACrB,iBAAiB;IACnB;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;MACR,qBAAqB;MACrB,iBAAiB;IACnB;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,iBAAiB;IACf;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,iBAAiB;IACf;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,aAAa;IACX;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,aAAa;IACX;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;MACR,qBAAqB;IACvB;EACF;;EACA,aAAa;IACX;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,gBAAgB;IACd;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;IACA;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;IACA;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,mBAAmB;IACjB;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,eAAe;IACb;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,eAAe;IACb;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,eAAe;IACb;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;EACA,kBAAkB;IAChB;MACE,OAAO;MACP,MAAM;MACN,SAAS;MACT,UAAU;MACV,QAAQ;IACV;EACF;;AACF;AAQA,SAAS,kBA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","names":["x402Version","ok","keccak256","getAddress","x402Version","getAddress","getAddress","decodePaymentResponseHeader","x402Version","x402Version","getAddress","x402Version","x402Version","http"]}
|