safehands-pharos 1.5.0 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (561) hide show
  1. package/.agents/policies/default.json +15 -0
  2. package/.env.example +81 -64
  3. package/README.md +301 -444
  4. package/SECURITY.md +112 -0
  5. package/SKILL.md +59 -0
  6. package/contracts/SafeHandsAttestation.sol +182 -0
  7. package/contracts/SafeHandsRegistry.sol +149 -0
  8. package/dist/agent/SafeHandsGuardianAgent.d.ts +39 -0
  9. package/dist/agent/SafeHandsGuardianAgent.d.ts.map +1 -0
  10. package/dist/agent/SafeHandsGuardianAgent.js +98 -0
  11. package/dist/agent/SafeHandsGuardianAgent.js.map +1 -0
  12. package/dist/agent/agentDecisionFormatter.d.ts +43 -0
  13. package/dist/agent/agentDecisionFormatter.d.ts.map +1 -0
  14. package/dist/agent/agentDecisionFormatter.js +96 -0
  15. package/dist/agent/agentDecisionFormatter.js.map +1 -0
  16. package/dist/agent/agentEnrich.d.ts +28 -0
  17. package/dist/agent/agentEnrich.d.ts.map +1 -0
  18. package/dist/agent/agentEnrich.js +99 -0
  19. package/dist/agent/agentEnrich.js.map +1 -0
  20. package/dist/agent/agentIntentClassifier.d.ts +44 -0
  21. package/dist/agent/agentIntentClassifier.d.ts.map +1 -0
  22. package/dist/agent/agentIntentClassifier.js +77 -0
  23. package/dist/agent/agentIntentClassifier.js.map +1 -0
  24. package/dist/agent/agentPolicyResolver.d.ts +44 -0
  25. package/dist/agent/agentPolicyResolver.d.ts.map +1 -0
  26. package/dist/agent/agentPolicyResolver.js +94 -0
  27. package/dist/agent/agentPolicyResolver.js.map +1 -0
  28. package/dist/agent/agentRuntime.d.ts +12 -0
  29. package/dist/agent/agentRuntime.d.ts.map +1 -0
  30. package/dist/agent/agentRuntime.js +31 -0
  31. package/dist/agent/agentRuntime.js.map +1 -0
  32. package/dist/agent/agentToolRouter.d.ts +24 -0
  33. package/dist/agent/agentToolRouter.d.ts.map +1 -0
  34. package/dist/agent/agentToolRouter.js +89 -0
  35. package/dist/agent/agentToolRouter.js.map +1 -0
  36. package/dist/agent/guardianOperator.d.ts +35 -0
  37. package/dist/agent/guardianOperator.d.ts.map +1 -0
  38. package/dist/agent/guardianOperator.js +65 -0
  39. package/dist/agent/guardianOperator.js.map +1 -0
  40. package/dist/agent/index.d.ts +8 -0
  41. package/dist/agent/index.d.ts.map +1 -0
  42. package/dist/agent/index.js +14 -0
  43. package/dist/agent/index.js.map +1 -0
  44. package/dist/api/activityRoutes.d.ts +70 -0
  45. package/dist/api/activityRoutes.d.ts.map +1 -0
  46. package/dist/api/activityRoutes.js +100 -0
  47. package/dist/api/activityRoutes.js.map +1 -0
  48. package/dist/api/agentRoutes.d.ts +16 -0
  49. package/dist/api/agentRoutes.d.ts.map +1 -0
  50. package/dist/api/agentRoutes.js +37 -0
  51. package/dist/api/agentRoutes.js.map +1 -0
  52. package/dist/api/broadcastRoutes.d.ts +34 -0
  53. package/dist/api/broadcastRoutes.d.ts.map +1 -0
  54. package/dist/api/broadcastRoutes.js +147 -0
  55. package/dist/api/broadcastRoutes.js.map +1 -0
  56. package/dist/api/consolePage.d.ts +2 -0
  57. package/dist/api/consolePage.d.ts.map +1 -0
  58. package/dist/api/consolePage.js +206 -0
  59. package/dist/api/consolePage.js.map +1 -0
  60. package/dist/api/httpHardening.d.ts +75 -0
  61. package/dist/api/httpHardening.d.ts.map +1 -0
  62. package/dist/api/httpHardening.js +122 -0
  63. package/dist/api/httpHardening.js.map +1 -0
  64. package/dist/api/indexerRoutes.d.ts +46 -0
  65. package/dist/api/indexerRoutes.d.ts.map +1 -0
  66. package/dist/api/indexerRoutes.js +75 -0
  67. package/dist/api/indexerRoutes.js.map +1 -0
  68. package/dist/api/paidRoutes.d.ts +8 -0
  69. package/dist/api/paidRoutes.d.ts.map +1 -0
  70. package/dist/api/paidRoutes.js +175 -0
  71. package/dist/api/paidRoutes.js.map +1 -0
  72. package/dist/api/prepareRoutes.d.ts +58 -0
  73. package/dist/api/prepareRoutes.d.ts.map +1 -0
  74. package/dist/api/prepareRoutes.js +90 -0
  75. package/dist/api/prepareRoutes.js.map +1 -0
  76. package/dist/api/response.d.ts +39 -0
  77. package/dist/api/response.d.ts.map +1 -0
  78. package/dist/api/response.js +53 -0
  79. package/dist/api/response.js.map +1 -0
  80. package/dist/api/routes.d.ts +175 -0
  81. package/dist/api/routes.d.ts.map +1 -0
  82. package/dist/api/routes.js +276 -0
  83. package/dist/api/routes.js.map +1 -0
  84. package/dist/api/schemas.d.ts +147 -0
  85. package/dist/api/schemas.d.ts.map +1 -0
  86. package/dist/api/schemas.js +81 -0
  87. package/dist/api/schemas.js.map +1 -0
  88. package/dist/api/server.d.ts +11 -0
  89. package/dist/api/server.d.ts.map +1 -0
  90. package/dist/api/server.js +505 -0
  91. package/dist/api/server.js.map +1 -0
  92. package/dist/api/toolRoutes.d.ts +14 -0
  93. package/dist/api/toolRoutes.d.ts.map +1 -0
  94. package/dist/api/toolRoutes.js +138 -0
  95. package/dist/api/toolRoutes.js.map +1 -0
  96. package/dist/api/walletPrepareRoutes.d.ts +74 -0
  97. package/dist/api/walletPrepareRoutes.d.ts.map +1 -0
  98. package/dist/api/walletPrepareRoutes.js +127 -0
  99. package/dist/api/walletPrepareRoutes.js.map +1 -0
  100. package/dist/api/x402Gate.d.ts +51 -0
  101. package/dist/api/x402Gate.d.ts.map +1 -0
  102. package/dist/api/x402Gate.js +184 -0
  103. package/dist/api/x402Gate.js.map +1 -0
  104. package/dist/cli.d.ts +1 -1
  105. package/dist/cli.d.ts.map +1 -1
  106. package/dist/cli.js +29 -1
  107. package/dist/cli.js.map +1 -1
  108. package/dist/data/ecosystemRegistry.data.d.ts +3 -0
  109. package/dist/data/ecosystemRegistry.data.d.ts.map +1 -0
  110. package/dist/data/ecosystemRegistry.data.js +582 -0
  111. package/dist/data/ecosystemRegistry.data.js.map +1 -0
  112. package/dist/demo.d.ts +0 -0
  113. package/dist/demo.d.ts.map +1 -1
  114. package/dist/demo.js +43 -8
  115. package/dist/demo.js.map +1 -1
  116. package/dist/index.d.ts +0 -0
  117. package/dist/index.d.ts.map +0 -0
  118. package/dist/index.js +212 -135
  119. package/dist/index.js.map +1 -1
  120. package/dist/init.d.ts +0 -0
  121. package/dist/init.d.ts.map +1 -1
  122. package/dist/init.js +72 -10
  123. package/dist/init.js.map +1 -1
  124. package/dist/lib/analysis/approval.d.ts +29 -0
  125. package/dist/lib/analysis/approval.d.ts.map +1 -0
  126. package/dist/lib/analysis/approval.js +162 -0
  127. package/dist/lib/analysis/approval.js.map +1 -0
  128. package/dist/lib/analysis/calldata.d.ts +60 -0
  129. package/dist/lib/analysis/calldata.d.ts.map +1 -0
  130. package/dist/lib/analysis/calldata.js +349 -0
  131. package/dist/lib/analysis/calldata.js.map +1 -0
  132. package/dist/lib/analysis/contractIntel.d.ts +65 -0
  133. package/dist/lib/analysis/contractIntel.d.ts.map +1 -0
  134. package/dist/lib/analysis/contractIntel.js +320 -0
  135. package/dist/lib/analysis/contractIntel.js.map +1 -0
  136. package/dist/lib/analysis/evm.d.ts +42 -0
  137. package/dist/lib/analysis/evm.d.ts.map +1 -0
  138. package/dist/lib/analysis/evm.js +185 -0
  139. package/dist/lib/analysis/evm.js.map +1 -0
  140. package/dist/lib/analysis/gas.d.ts +4 -0
  141. package/dist/lib/analysis/gas.d.ts.map +1 -0
  142. package/dist/lib/analysis/gas.js +13 -0
  143. package/dist/lib/analysis/gas.js.map +1 -0
  144. package/dist/lib/analysis/index.d.ts +11 -0
  145. package/dist/lib/analysis/index.d.ts.map +1 -0
  146. package/dist/lib/analysis/index.js +16 -0
  147. package/dist/lib/analysis/index.js.map +1 -0
  148. package/dist/lib/analysis/pharosTokens.d.ts +31 -0
  149. package/dist/lib/analysis/pharosTokens.d.ts.map +1 -0
  150. package/dist/lib/analysis/pharosTokens.js +78 -0
  151. package/dist/lib/analysis/pharosTokens.js.map +1 -0
  152. package/dist/lib/analysis/safeTx.d.ts +27 -0
  153. package/dist/lib/analysis/safeTx.d.ts.map +1 -0
  154. package/dist/lib/analysis/safeTx.js +118 -0
  155. package/dist/lib/analysis/safeTx.js.map +1 -0
  156. package/dist/lib/analysis/token.d.ts +21 -0
  157. package/dist/lib/analysis/token.d.ts.map +1 -0
  158. package/dist/lib/analysis/token.js +151 -0
  159. package/dist/lib/analysis/token.js.map +1 -0
  160. package/dist/lib/analysis/types.d.ts +49 -0
  161. package/dist/lib/analysis/types.d.ts.map +1 -0
  162. package/dist/lib/analysis/types.js +10 -0
  163. package/dist/lib/analysis/types.js.map +1 -0
  164. package/dist/lib/analysis/x402.d.ts +24 -0
  165. package/dist/lib/analysis/x402.d.ts.map +1 -0
  166. package/dist/lib/analysis/x402.js +60 -0
  167. package/dist/lib/analysis/x402.js.map +1 -0
  168. package/dist/lib/auditLog.d.ts +1 -0
  169. package/dist/lib/auditLog.d.ts.map +1 -1
  170. package/dist/lib/auditLog.js +0 -0
  171. package/dist/lib/auditLog.js.map +1 -1
  172. package/dist/lib/config.d.ts +77 -0
  173. package/dist/lib/config.d.ts.map +1 -0
  174. package/dist/lib/config.js +120 -0
  175. package/dist/lib/config.js.map +1 -0
  176. package/dist/lib/constants.d.ts +246 -97
  177. package/dist/lib/constants.d.ts.map +1 -1
  178. package/dist/lib/constants.js +334 -127
  179. package/dist/lib/constants.js.map +1 -1
  180. package/dist/lib/dodoApi.d.ts +26 -3
  181. package/dist/lib/dodoApi.d.ts.map +1 -1
  182. package/dist/lib/dodoApi.js +80 -17
  183. package/dist/lib/dodoApi.js.map +1 -1
  184. package/dist/lib/ecosystemRegistry.d.ts +116 -0
  185. package/dist/lib/ecosystemRegistry.d.ts.map +1 -0
  186. package/dist/lib/ecosystemRegistry.js +178 -0
  187. package/dist/lib/ecosystemRegistry.js.map +1 -0
  188. package/dist/lib/envLoader.d.ts +0 -0
  189. package/dist/lib/envLoader.d.ts.map +0 -0
  190. package/dist/lib/envLoader.js +39 -18
  191. package/dist/lib/envLoader.js.map +1 -1
  192. package/dist/lib/goldsky.d.ts +58 -0
  193. package/dist/lib/goldsky.d.ts.map +1 -0
  194. package/dist/lib/goldsky.js +275 -0
  195. package/dist/lib/goldsky.js.map +1 -0
  196. package/dist/lib/guardian/decision.d.ts +23 -0
  197. package/dist/lib/guardian/decision.d.ts.map +1 -0
  198. package/dist/lib/guardian/decision.js +40 -0
  199. package/dist/lib/guardian/decision.js.map +1 -0
  200. package/dist/lib/http.d.ts +0 -1
  201. package/dist/lib/http.d.ts.map +1 -1
  202. package/dist/lib/http.js +297 -32
  203. package/dist/lib/http.js.map +1 -1
  204. package/dist/lib/managedExecution.d.ts +19 -0
  205. package/dist/lib/managedExecution.d.ts.map +1 -0
  206. package/dist/lib/managedExecution.js +64 -0
  207. package/dist/lib/managedExecution.js.map +1 -0
  208. package/dist/lib/merkleBatcher.d.ts +23 -0
  209. package/dist/lib/merkleBatcher.d.ts.map +1 -0
  210. package/dist/lib/merkleBatcher.js +62 -0
  211. package/dist/lib/merkleBatcher.js.map +1 -0
  212. package/dist/lib/networks.d.ts +48 -0
  213. package/dist/lib/networks.d.ts.map +1 -0
  214. package/dist/lib/networks.js +103 -0
  215. package/dist/lib/networks.js.map +1 -0
  216. package/dist/lib/observability/accessContext.d.ts +29 -0
  217. package/dist/lib/observability/accessContext.d.ts.map +1 -0
  218. package/dist/lib/observability/accessContext.js +50 -0
  219. package/dist/lib/observability/accessContext.js.map +1 -0
  220. package/dist/lib/observability/activityStore.d.ts +70 -0
  221. package/dist/lib/observability/activityStore.d.ts.map +1 -0
  222. package/dist/lib/observability/activityStore.js +149 -0
  223. package/dist/lib/observability/activityStore.js.map +1 -0
  224. package/dist/lib/observability/apiKey.d.ts +55 -0
  225. package/dist/lib/observability/apiKey.d.ts.map +1 -0
  226. package/dist/lib/observability/apiKey.js +141 -0
  227. package/dist/lib/observability/apiKey.js.map +1 -0
  228. package/dist/lib/observability/logger.d.ts +30 -0
  229. package/dist/lib/observability/logger.d.ts.map +1 -0
  230. package/dist/lib/observability/logger.js +30 -0
  231. package/dist/lib/observability/logger.js.map +1 -0
  232. package/dist/lib/observability/quota.d.ts +33 -0
  233. package/dist/lib/observability/quota.d.ts.map +1 -0
  234. package/dist/lib/observability/quota.js +49 -0
  235. package/dist/lib/observability/quota.js.map +1 -0
  236. package/dist/lib/observability/requestId.d.ts +8 -0
  237. package/dist/lib/observability/requestId.d.ts.map +1 -0
  238. package/dist/lib/observability/requestId.js +24 -0
  239. package/dist/lib/observability/requestId.js.map +1 -0
  240. package/dist/lib/observability/sanitize.d.ts +77 -0
  241. package/dist/lib/observability/sanitize.d.ts.map +1 -0
  242. package/dist/lib/observability/sanitize.js +228 -0
  243. package/dist/lib/observability/sanitize.js.map +1 -0
  244. package/dist/lib/observability/scopes.d.ts +20 -0
  245. package/dist/lib/observability/scopes.d.ts.map +1 -0
  246. package/dist/lib/observability/scopes.js +77 -0
  247. package/dist/lib/observability/scopes.js.map +1 -0
  248. package/dist/lib/okxDexApi.d.ts +106 -0
  249. package/dist/lib/okxDexApi.d.ts.map +1 -0
  250. package/dist/lib/okxDexApi.js +221 -0
  251. package/dist/lib/okxDexApi.js.map +1 -0
  252. package/dist/lib/persistentJsonStore.d.ts +5 -0
  253. package/dist/lib/persistentJsonStore.d.ts.map +1 -0
  254. package/dist/lib/persistentJsonStore.js +39 -0
  255. package/dist/lib/persistentJsonStore.js.map +1 -0
  256. package/dist/lib/pharos/attestationPublisher.d.ts +50 -0
  257. package/dist/lib/pharos/attestationPublisher.d.ts.map +1 -0
  258. package/dist/lib/pharos/attestationPublisher.js +262 -0
  259. package/dist/lib/pharos/attestationPublisher.js.map +1 -0
  260. package/dist/lib/pharos/ecosystem.d.ts +52 -0
  261. package/dist/lib/pharos/ecosystem.d.ts.map +1 -0
  262. package/dist/lib/pharos/ecosystem.js +431 -0
  263. package/dist/lib/pharos/ecosystem.js.map +1 -0
  264. package/dist/lib/pharos/ecosystemEvidence.d.ts +53 -0
  265. package/dist/lib/pharos/ecosystemEvidence.d.ts.map +1 -0
  266. package/dist/lib/pharos/ecosystemEvidence.js +133 -0
  267. package/dist/lib/pharos/ecosystemEvidence.js.map +1 -0
  268. package/dist/lib/pharos/rpc.d.ts +44 -0
  269. package/dist/lib/pharos/rpc.d.ts.map +1 -0
  270. package/dist/lib/pharos/rpc.js +90 -0
  271. package/dist/lib/pharos/rpc.js.map +1 -0
  272. package/dist/lib/pharos/rpcEvidence.d.ts +49 -0
  273. package/dist/lib/pharos/rpcEvidence.d.ts.map +1 -0
  274. package/dist/lib/pharos/rpcEvidence.js +46 -0
  275. package/dist/lib/pharos/rpcEvidence.js.map +1 -0
  276. package/dist/lib/pharos/rpcMethods.d.ts +46 -0
  277. package/dist/lib/pharos/rpcMethods.d.ts.map +1 -0
  278. package/dist/lib/pharos/rpcMethods.js +176 -0
  279. package/dist/lib/pharos/rpcMethods.js.map +1 -0
  280. package/dist/lib/pharos/spvVerifier.d.ts +47 -0
  281. package/dist/lib/pharos/spvVerifier.d.ts.map +1 -0
  282. package/dist/lib/pharos/spvVerifier.js +105 -0
  283. package/dist/lib/pharos/spvVerifier.js.map +1 -0
  284. package/dist/lib/pharos/userSignedBroadcaster.d.ts +10 -0
  285. package/dist/lib/pharos/userSignedBroadcaster.d.ts.map +1 -0
  286. package/dist/lib/pharos/userSignedBroadcaster.js +50 -0
  287. package/dist/lib/pharos/userSignedBroadcaster.js.map +1 -0
  288. package/dist/lib/pharosClient.d.ts +5 -10
  289. package/dist/lib/pharosClient.d.ts.map +1 -1
  290. package/dist/lib/pharosClient.js +9 -16
  291. package/dist/lib/pharosClient.js.map +1 -1
  292. package/dist/lib/policy/actionPolicyEngine.d.ts +37 -1
  293. package/dist/lib/policy/actionPolicyEngine.d.ts.map +1 -1
  294. package/dist/lib/policy/actionPolicyEngine.js +213 -52
  295. package/dist/lib/policy/actionPolicyEngine.js.map +1 -1
  296. package/dist/lib/policy/agentPolicy.d.ts +29 -0
  297. package/dist/lib/policy/agentPolicy.d.ts.map +1 -0
  298. package/dist/lib/policy/agentPolicy.js +154 -0
  299. package/dist/lib/policy/agentPolicy.js.map +1 -0
  300. package/dist/lib/policy/policyPresets.d.ts +30 -0
  301. package/dist/lib/policy/policyPresets.d.ts.map +1 -0
  302. package/dist/lib/policy/policyPresets.js +124 -0
  303. package/dist/lib/policy/policyPresets.js.map +1 -0
  304. package/dist/lib/policy/writeExecutionGate.d.ts +23 -0
  305. package/dist/lib/policy/writeExecutionGate.d.ts.map +1 -0
  306. package/dist/lib/policy/writeExecutionGate.js +65 -0
  307. package/dist/lib/policy/writeExecutionGate.js.map +1 -0
  308. package/dist/lib/preparedTxStore.d.ts +21 -0
  309. package/dist/lib/preparedTxStore.d.ts.map +1 -0
  310. package/dist/lib/preparedTxStore.js +90 -0
  311. package/dist/lib/preparedTxStore.js.map +1 -0
  312. package/dist/lib/price/chainlinkPushProvider.d.ts +34 -0
  313. package/dist/lib/price/chainlinkPushProvider.d.ts.map +1 -0
  314. package/dist/lib/price/chainlinkPushProvider.js +36 -0
  315. package/dist/lib/price/chainlinkPushProvider.js.map +1 -0
  316. package/dist/lib/price/feedRegistry.d.ts +26 -0
  317. package/dist/lib/price/feedRegistry.d.ts.map +1 -0
  318. package/dist/lib/price/feedRegistry.js +67 -0
  319. package/dist/lib/price/feedRegistry.js.map +1 -0
  320. package/dist/lib/price/priceResolver.d.ts +35 -0
  321. package/dist/lib/price/priceResolver.d.ts.map +1 -0
  322. package/dist/lib/price/priceResolver.js +246 -0
  323. package/dist/lib/price/priceResolver.js.map +1 -0
  324. package/dist/lib/price/supraProvider.d.ts +9 -0
  325. package/dist/lib/price/supraProvider.d.ts.map +1 -0
  326. package/dist/lib/price/supraProvider.js +17 -0
  327. package/dist/lib/price/supraProvider.js.map +1 -0
  328. package/dist/lib/price/types.d.ts +67 -0
  329. package/dist/lib/price/types.d.ts.map +1 -0
  330. package/dist/lib/price/types.js +7 -0
  331. package/dist/lib/price/types.js.map +1 -0
  332. package/dist/lib/productionGuards.d.ts +16 -0
  333. package/dist/lib/productionGuards.d.ts.map +1 -0
  334. package/dist/lib/productionGuards.js +93 -0
  335. package/dist/lib/productionGuards.js.map +1 -0
  336. package/dist/lib/recipientSafety.d.ts +5 -0
  337. package/dist/lib/recipientSafety.d.ts.map +1 -0
  338. package/dist/lib/recipientSafety.js +28 -0
  339. package/dist/lib/recipientSafety.js.map +1 -0
  340. package/dist/lib/riskEngine.d.ts +19 -0
  341. package/dist/lib/riskEngine.d.ts.map +1 -1
  342. package/dist/lib/riskEngine.js +94 -36
  343. package/dist/lib/riskEngine.js.map +1 -1
  344. package/dist/lib/riskInclusion.d.ts +72 -0
  345. package/dist/lib/riskInclusion.d.ts.map +1 -0
  346. package/dist/lib/riskInclusion.js +252 -0
  347. package/dist/lib/riskInclusion.js.map +1 -0
  348. package/dist/lib/safeHandsRegistry.d.ts +32 -0
  349. package/dist/lib/safeHandsRegistry.d.ts.map +1 -0
  350. package/dist/lib/safeHandsRegistry.js +151 -0
  351. package/dist/lib/safeHandsRegistry.js.map +1 -0
  352. package/dist/lib/signer/index.d.ts +3 -3
  353. package/dist/lib/signer/index.d.ts.map +1 -1
  354. package/dist/lib/signer/index.js +33 -11
  355. package/dist/lib/signer/index.js.map +1 -1
  356. package/dist/lib/spendAccumulator.d.ts +24 -1
  357. package/dist/lib/spendAccumulator.d.ts.map +1 -1
  358. package/dist/lib/spendAccumulator.js +76 -6
  359. package/dist/lib/spendAccumulator.js.map +1 -1
  360. package/dist/lib/toolResponse.d.ts +6 -1
  361. package/dist/lib/toolResponse.d.ts.map +1 -1
  362. package/dist/lib/toolResponse.js +13 -9
  363. package/dist/lib/toolResponse.js.map +1 -1
  364. package/dist/lib/validation.d.ts +7 -0
  365. package/dist/lib/validation.d.ts.map +1 -0
  366. package/dist/lib/validation.js +62 -0
  367. package/dist/lib/validation.js.map +1 -0
  368. package/dist/lib/wallet/index.d.ts +8 -12
  369. package/dist/lib/wallet/index.d.ts.map +1 -1
  370. package/dist/lib/wallet/index.js +48 -35
  371. package/dist/lib/wallet/index.js.map +1 -1
  372. package/dist/lib/x402ReplayStore.d.ts +6 -0
  373. package/dist/lib/x402ReplayStore.d.ts.map +1 -0
  374. package/dist/lib/x402ReplayStore.js +79 -0
  375. package/dist/lib/x402ReplayStore.js.map +1 -0
  376. package/dist/safehands.zip +0 -0
  377. package/dist/sdk.d.ts +14 -0
  378. package/dist/sdk.d.ts.map +1 -0
  379. package/dist/sdk.js +25 -0
  380. package/dist/sdk.js.map +1 -0
  381. package/dist/tools/approveToken.d.ts +31 -10
  382. package/dist/tools/approveToken.d.ts.map +1 -1
  383. package/dist/tools/approveToken.js +91 -24
  384. package/dist/tools/approveToken.js.map +1 -1
  385. package/dist/tools/assessRisk.d.ts +13 -26
  386. package/dist/tools/assessRisk.d.ts.map +1 -1
  387. package/dist/tools/assessRisk.js +34 -75
  388. package/dist/tools/assessRisk.js.map +1 -1
  389. package/dist/tools/checkAllowance.d.ts +9 -3
  390. package/dist/tools/checkAllowance.d.ts.map +1 -1
  391. package/dist/tools/checkAllowance.js +27 -5
  392. package/dist/tools/checkAllowance.js.map +1 -1
  393. package/dist/tools/checkTokenSecurity.d.ts +62 -5
  394. package/dist/tools/checkTokenSecurity.d.ts.map +1 -1
  395. package/dist/tools/checkTokenSecurity.js +166 -21
  396. package/dist/tools/checkTokenSecurity.js.map +1 -1
  397. package/dist/tools/createAgentWallet.d.ts +4 -2
  398. package/dist/tools/createAgentWallet.d.ts.map +1 -1
  399. package/dist/tools/createAgentWallet.js +36 -31
  400. package/dist/tools/createAgentWallet.js.map +1 -1
  401. package/dist/tools/estimateGas.d.ts +7 -2
  402. package/dist/tools/estimateGas.d.ts.map +1 -1
  403. package/dist/tools/estimateGas.js +16 -10
  404. package/dist/tools/estimateGas.js.map +1 -1
  405. package/dist/tools/executeSwap.d.ts +56 -8
  406. package/dist/tools/executeSwap.d.ts.map +1 -1
  407. package/dist/tools/executeSwap.js +194 -46
  408. package/dist/tools/executeSwap.js.map +1 -1
  409. package/dist/tools/explainRisk.d.ts +9 -9
  410. package/dist/tools/explainRisk.d.ts.map +1 -1
  411. package/dist/tools/explainRisk.js +5 -4
  412. package/dist/tools/explainRisk.js.map +1 -1
  413. package/dist/tools/getAgentPolicy.d.ts +15 -0
  414. package/dist/tools/getAgentPolicy.d.ts.map +1 -0
  415. package/dist/tools/getAgentPolicy.js +16 -0
  416. package/dist/tools/getAgentPolicy.js.map +1 -0
  417. package/dist/tools/getAgentReputation.d.ts +31 -0
  418. package/dist/tools/getAgentReputation.d.ts.map +1 -0
  419. package/dist/tools/getAgentReputation.js +44 -0
  420. package/dist/tools/getAgentReputation.js.map +1 -0
  421. package/dist/tools/getAgentWallet.d.ts +1 -1
  422. package/dist/tools/getAgentWallet.d.ts.map +1 -1
  423. package/dist/tools/getAgentWallet.js +11 -1
  424. package/dist/tools/getAgentWallet.js.map +1 -1
  425. package/dist/tools/getAgentWalletBalance.d.ts +1 -1
  426. package/dist/tools/getAgentWalletBalance.d.ts.map +1 -1
  427. package/dist/tools/getAgentWalletBalance.js +58 -26
  428. package/dist/tools/getAgentWalletBalance.js.map +1 -1
  429. package/dist/tools/getExecutionHistory.d.ts +1 -1
  430. package/dist/tools/getExecutionHistory.d.ts.map +1 -1
  431. package/dist/tools/getExecutionHistory.js +13 -19
  432. package/dist/tools/getExecutionHistory.js.map +1 -1
  433. package/dist/tools/getGasPrice.d.ts +3 -3
  434. package/dist/tools/getGasPrice.d.ts.map +0 -0
  435. package/dist/tools/getGasPrice.js +7 -7
  436. package/dist/tools/getGasPrice.js.map +1 -1
  437. package/dist/tools/getPoolInfo.d.ts +17 -17
  438. package/dist/tools/getPoolInfo.d.ts.map +1 -1
  439. package/dist/tools/getPoolInfo.js +14 -9
  440. package/dist/tools/getPoolInfo.js.map +1 -1
  441. package/dist/tools/getSpvProof.d.ts +24 -0
  442. package/dist/tools/getSpvProof.d.ts.map +1 -0
  443. package/dist/tools/getSpvProof.js +64 -0
  444. package/dist/tools/getSpvProof.js.map +1 -0
  445. package/dist/tools/getTokenPrice.d.ts +28 -85
  446. package/dist/tools/getTokenPrice.d.ts.map +1 -1
  447. package/dist/tools/getTokenPrice.js +87 -94
  448. package/dist/tools/getTokenPrice.js.map +1 -1
  449. package/dist/tools/getTransactionStatus.d.ts +2 -2
  450. package/dist/tools/getTransactionStatus.d.ts.map +0 -0
  451. package/dist/tools/getTransactionStatus.js +0 -0
  452. package/dist/tools/getTransactionStatus.js.map +0 -0
  453. package/dist/tools/getWalletBalance.d.ts +38 -3
  454. package/dist/tools/getWalletBalance.d.ts.map +1 -1
  455. package/dist/tools/getWalletBalance.js +92 -52
  456. package/dist/tools/getWalletBalance.js.map +1 -1
  457. package/dist/tools/publishRiskScore.d.ts +36 -14
  458. package/dist/tools/publishRiskScore.d.ts.map +1 -1
  459. package/dist/tools/publishRiskScore.js +80 -32
  460. package/dist/tools/publishRiskScore.js.map +1 -1
  461. package/dist/tools/queryGoldsky.d.ts +20 -0
  462. package/dist/tools/queryGoldsky.d.ts.map +1 -0
  463. package/dist/tools/queryGoldsky.js +29 -0
  464. package/dist/tools/queryGoldsky.js.map +1 -0
  465. package/dist/tools/queryRiskRegistry.d.ts +14 -14
  466. package/dist/tools/queryRiskRegistry.d.ts.map +1 -1
  467. package/dist/tools/queryRiskRegistry.js +34 -30
  468. package/dist/tools/queryRiskRegistry.js.map +1 -1
  469. package/dist/tools/safehandsPreflightCheck.d.ts +29 -14
  470. package/dist/tools/safehandsPreflightCheck.d.ts.map +1 -1
  471. package/dist/tools/safehandsPreflightCheck.js +133 -6
  472. package/dist/tools/safehandsPreflightCheck.js.map +1 -1
  473. package/dist/tools/safehandsRiskReport.d.ts +29 -14
  474. package/dist/tools/safehandsRiskReport.d.ts.map +1 -1
  475. package/dist/tools/safehandsRiskReport.js +23 -3
  476. package/dist/tools/safehandsRiskReport.js.map +1 -1
  477. package/dist/tools/safehandsSafeExecute.d.ts +1 -1
  478. package/dist/tools/safehandsSafeExecute.d.ts.map +1 -1
  479. package/dist/tools/safehandsSafeExecute.js +100 -17
  480. package/dist/tools/safehandsSafeExecute.js.map +1 -1
  481. package/dist/tools/safehandsWalletHealth.d.ts +15 -1
  482. package/dist/tools/safehandsWalletHealth.d.ts.map +1 -1
  483. package/dist/tools/safehandsWalletHealth.js +67 -25
  484. package/dist/tools/safehandsWalletHealth.js.map +1 -1
  485. package/dist/tools/safehandsX402Preflight.d.ts +3 -3
  486. package/dist/tools/safehandsX402Preflight.d.ts.map +1 -1
  487. package/dist/tools/safehandsX402Preflight.js +24 -3
  488. package/dist/tools/safehandsX402Preflight.js.map +1 -1
  489. package/dist/tools/sendPayment.d.ts +10 -4
  490. package/dist/tools/sendPayment.d.ts.map +1 -1
  491. package/dist/tools/sendPayment.js +63 -36
  492. package/dist/tools/sendPayment.js.map +1 -1
  493. package/dist/tools/setAgentPolicy.d.ts +75 -0
  494. package/dist/tools/setAgentPolicy.d.ts.map +1 -0
  495. package/dist/tools/setAgentPolicy.js +80 -0
  496. package/dist/tools/setAgentPolicy.js.map +1 -0
  497. package/dist/tools/simulateTransaction.d.ts +7 -3
  498. package/dist/tools/simulateTransaction.d.ts.map +1 -1
  499. package/dist/tools/simulateTransaction.js +42 -9
  500. package/dist/tools/simulateTransaction.js.map +1 -1
  501. package/dist/tools/tokenRegistryStatus.d.ts +25 -5
  502. package/dist/tools/tokenRegistryStatus.d.ts.map +1 -1
  503. package/dist/tools/tokenRegistryStatus.js +61 -31
  504. package/dist/tools/tokenRegistryStatus.js.map +1 -1
  505. package/dist/tools/verifyRiskInclusion.d.ts +59 -0
  506. package/dist/tools/verifyRiskInclusion.d.ts.map +1 -0
  507. package/dist/tools/verifyRiskInclusion.js +40 -0
  508. package/dist/tools/verifyRiskInclusion.js.map +1 -0
  509. package/dist/tools/x402PayAndFetch.d.ts +15 -9
  510. package/dist/tools/x402PayAndFetch.d.ts.map +1 -1
  511. package/dist/tools/x402PayAndFetch.js +163 -20
  512. package/dist/tools/x402PayAndFetch.js.map +1 -1
  513. package/dist/worker.d.ts +3 -0
  514. package/dist/worker.d.ts.map +1 -0
  515. package/dist/worker.js +39 -0
  516. package/dist/worker.js.map +1 -0
  517. package/dist/x402Server.d.ts +1 -1
  518. package/dist/x402Server.d.ts.map +1 -1
  519. package/dist/x402Server.js +144 -35
  520. package/dist/x402Server.js.map +1 -1
  521. package/docs/REVIEWER_QUICKSTART.md +113 -0
  522. package/docs/SAFEHANDS_REVIEWER_DEMO_SCRIPT.md +228 -0
  523. package/package.json +130 -73
  524. package/contracts/RiskRegistry.json +0 -223
  525. package/contracts/RiskRegistry.sol +0 -58
  526. package/dist/lib/testDodoLive.d.ts +0 -2
  527. package/dist/lib/testDodoLive.d.ts.map +0 -1
  528. package/dist/lib/testDodoLive.js +0 -105
  529. package/dist/lib/testDodoLive.js.map +0 -1
  530. package/dist/lib/testLiveSafehands.d.ts +0 -2
  531. package/dist/lib/testLiveSafehands.d.ts.map +0 -1
  532. package/dist/lib/testLiveSafehands.js +0 -93
  533. package/dist/lib/testLiveSafehands.js.map +0 -1
  534. package/dist/lib/testRpc.d.ts +0 -2
  535. package/dist/lib/testRpc.d.ts.map +0 -1
  536. package/dist/lib/testRpc.js +0 -30
  537. package/dist/lib/testRpc.js.map +0 -1
  538. package/dist/lib/testRpcLive.d.ts +0 -2
  539. package/dist/lib/testRpcLive.d.ts.map +0 -1
  540. package/dist/lib/testRpcLive.js +0 -89
  541. package/dist/lib/testRpcLive.js.map +0 -1
  542. package/dist/lib/testTools.d.ts +0 -2
  543. package/dist/lib/testTools.d.ts.map +0 -1
  544. package/dist/lib/testTools.js +0 -397
  545. package/dist/lib/testTools.js.map +0 -1
  546. package/dist/lib/testX402Live.d.ts +0 -2
  547. package/dist/lib/testX402Live.d.ts.map +0 -1
  548. package/dist/lib/testX402Live.js +0 -160
  549. package/dist/lib/testX402Live.js.map +0 -1
  550. package/dist/scripts/checkDeploy.d.ts +0 -2
  551. package/dist/scripts/checkDeploy.d.ts.map +0 -1
  552. package/dist/scripts/checkDeploy.js +0 -25
  553. package/dist/scripts/checkDeploy.js.map +0 -1
  554. package/dist/scripts/deployRegistry.d.ts +0 -2
  555. package/dist/scripts/deployRegistry.d.ts.map +0 -1
  556. package/dist/scripts/deployRegistry.js +0 -101
  557. package/dist/scripts/deployRegistry.js.map +0 -1
  558. package/dist/scripts/testRegistry.d.ts +0 -2
  559. package/dist/scripts/testRegistry.d.ts.map +0 -1
  560. package/dist/scripts/testRegistry.js +0 -44
  561. package/dist/scripts/testRegistry.js.map +0 -1
@@ -0,0 +1,175 @@
1
+ import { type AnalyzerResult, type AnalyzerRiskLevel, type ReadOnlyChainAccess } from "../lib/analysis/index.js";
2
+ import { type GuardianDecision } from "../lib/guardian/decision.js";
3
+ export declare function handleHealth(): {
4
+ status: string;
5
+ service: string;
6
+ version: string;
7
+ timestamp: string;
8
+ };
9
+ export declare function handleInfraStatus(): {
10
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
11
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
12
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
13
+ readOnly: true;
14
+ executionAvailable: boolean;
15
+ network: import("../lib/networks.js").NetworkName;
16
+ label: string;
17
+ chainId: number;
18
+ nativeToken: string;
19
+ isMainnet: boolean;
20
+ explorer: {
21
+ explorerUrl: string;
22
+ socialScanUrl: string | null;
23
+ };
24
+ readOnlyMode: boolean;
25
+ walletMode: string;
26
+ gates: import("../sdk.js").SafetyGates;
27
+ capabilities: import("../sdk.js").CapabilityFlags;
28
+ ecosystem: import("../lib/pharos/ecosystem.js").EcosystemRegistrySummary;
29
+ };
30
+ export declare function handlePublicConfig(): {
31
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
32
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
33
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
34
+ readOnly: true;
35
+ executionAvailable: boolean;
36
+ service: string;
37
+ version: string;
38
+ network: import("../lib/networks.js").NetworkName;
39
+ label: string;
40
+ chainId: number;
41
+ nativeToken: string;
42
+ isMainnet: boolean;
43
+ explorer: {
44
+ explorerUrl: string;
45
+ socialScanUrl: string | null;
46
+ };
47
+ publicRpcUrl: string;
48
+ decisions: readonly GuardianDecision[];
49
+ supportedFeatures: string[];
50
+ readOnlyMode: boolean;
51
+ gates: import("../sdk.js").SafetyGates;
52
+ capabilities: import("../sdk.js").CapabilityFlags;
53
+ ecosystem: import("../lib/pharos/ecosystem.js").EcosystemRegistrySummary;
54
+ };
55
+ export declare function handleGuardianCheck(raw: unknown, access?: ReadOnlyChainAccess): Promise<{
56
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
57
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
58
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
59
+ readOnly: true;
60
+ executionAvailable: boolean;
61
+ decision: GuardianDecision;
62
+ riskLevel: AnalyzerRiskLevel;
63
+ reasons: string[];
64
+ warnings: string[];
65
+ analyzers: AnalyzerResult<unknown>[];
66
+ network: import("../lib/networks.js").NetworkName;
67
+ chainId: number;
68
+ explorerLinks: import("./response.js").ExplorerLinks;
69
+ ecosystemEvidence: import("../lib/pharos/ecosystemEvidence.js").EcosystemEvidence;
70
+ }>;
71
+ export declare function handleAnalyzeTx(raw: unknown, access?: ReadOnlyChainAccess): Promise<{
72
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
73
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
74
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
75
+ readOnly: true;
76
+ executionAvailable: boolean;
77
+ explorerLinks: import("./response.js").ExplorerLinks;
78
+ ecosystemEvidence: import("../lib/pharos/ecosystemEvidence.js").EcosystemEvidence;
79
+ analyzer: string;
80
+ decision: GuardianDecision;
81
+ internalDecision?: string;
82
+ riskLevel: AnalyzerRiskLevel;
83
+ reasons: string[];
84
+ warnings: string[];
85
+ analyzerStatus: import("../lib/analysis/types.js").AnalyzerStatus;
86
+ experimental?: boolean;
87
+ details: import("../lib/analysis/evm.js").EvmTxReceiptDetails;
88
+ }>;
89
+ export declare function handleAnalyzeContract(raw: unknown, access?: ReadOnlyChainAccess): Promise<{
90
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
91
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
92
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
93
+ readOnly: true;
94
+ executionAvailable: boolean;
95
+ explorerLinks: import("./response.js").ExplorerLinks;
96
+ ecosystemEvidence: import("../lib/pharos/ecosystemEvidence.js").EcosystemEvidence;
97
+ analyzer: string;
98
+ decision: GuardianDecision;
99
+ internalDecision?: string;
100
+ riskLevel: AnalyzerRiskLevel;
101
+ reasons: string[];
102
+ warnings: string[];
103
+ analyzerStatus: import("../lib/analysis/types.js").AnalyzerStatus;
104
+ experimental?: boolean;
105
+ details: import("../lib/analysis/contractIntel.js").ContractIntelDetails;
106
+ }>;
107
+ export declare function handleAnalyzeApproval(raw: unknown): {
108
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
109
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
110
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
111
+ readOnly: true;
112
+ executionAvailable: boolean;
113
+ ecosystemEvidence: import("../lib/pharos/ecosystemEvidence.js").EcosystemEvidence;
114
+ analyzer: string;
115
+ decision: GuardianDecision;
116
+ internalDecision?: string;
117
+ riskLevel: AnalyzerRiskLevel;
118
+ reasons: string[];
119
+ warnings: string[];
120
+ analyzerStatus: import("../lib/analysis/types.js").AnalyzerStatus;
121
+ experimental?: boolean;
122
+ details: import("../lib/analysis/approval.js").ApprovalAnalysisDetails;
123
+ };
124
+ export declare function handleAnalyzeCalldata(raw: unknown): {
125
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
126
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
127
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
128
+ readOnly: true;
129
+ executionAvailable: boolean;
130
+ ecosystemEvidence: import("../lib/pharos/ecosystemEvidence.js").EcosystemEvidence;
131
+ analyzer: string;
132
+ decision: GuardianDecision;
133
+ internalDecision?: string;
134
+ riskLevel: AnalyzerRiskLevel;
135
+ reasons: string[];
136
+ warnings: string[];
137
+ analyzerStatus: import("../lib/analysis/types.js").AnalyzerStatus;
138
+ experimental?: boolean;
139
+ details: import("../lib/analysis/calldata.js").CalldataAnalysisDetails;
140
+ };
141
+ export declare function handleAnalyzeSafe(raw: unknown): Promise<{
142
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
143
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
144
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
145
+ readOnly: true;
146
+ executionAvailable: boolean;
147
+ ecosystemEvidence: import("../lib/pharos/ecosystemEvidence.js").EcosystemEvidence;
148
+ analyzer: string;
149
+ decision: GuardianDecision;
150
+ internalDecision?: string;
151
+ riskLevel: AnalyzerRiskLevel;
152
+ reasons: string[];
153
+ warnings: string[];
154
+ analyzerStatus: import("../lib/analysis/types.js").AnalyzerStatus;
155
+ experimental?: boolean;
156
+ details: import("../lib/analysis/safeTx.js").SafeTxAnalysisDetails;
157
+ }>;
158
+ export declare function handleAnalyzeX402(raw: unknown): {
159
+ rpcEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
160
+ gasEvidence: import("../lib/pharos/rpcEvidence.js").GasEvidence;
161
+ pharosEvidence: import("../lib/pharos/rpcEvidence.js").RpcEvidence;
162
+ readOnly: true;
163
+ executionAvailable: boolean;
164
+ ecosystemEvidence: import("../lib/pharos/ecosystemEvidence.js").EcosystemEvidence;
165
+ analyzer: string;
166
+ decision: GuardianDecision;
167
+ internalDecision?: string;
168
+ riskLevel: AnalyzerRiskLevel;
169
+ reasons: string[];
170
+ warnings: string[];
171
+ analyzerStatus: import("../lib/analysis/types.js").AnalyzerStatus;
172
+ experimental?: boolean;
173
+ details: import("../lib/analysis/x402.js").X402AnalysisDetails;
174
+ };
175
+ //# sourceMappingURL=routes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAcA,OAAO,EASL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAkExF,wBAAgB,YAAY;;;;;EAO3B;AAGD,wBAAgB,iBAAiB;;;;;;;;;;;;;;;;;;;;EAoBhC;AAKD,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EAgCjC;AAID,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;GAuEnF;AAGD,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;GAW/E;AAGD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;GAWrF;AAGD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;EASjD;AAMD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;EASjD;AAGD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;GASnD;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;EAS7C"}
@@ -0,0 +1,276 @@
1
+ // ─── SafeHands API — Route Handlers (read-only) ───────────────
2
+ // Pure handler functions: each takes a plain parsed-request object (+ optional
3
+ // read-only chain access) and returns a plain serializable payload. server.ts
4
+ // wraps these in the response envelope. They import ONLY the Phase 2 analyzers,
5
+ // the network registry, and the config/gates — never a signer, managed-wallet,
6
+ // write-tool, x402 facilitator, or publish module. There is no code path here to
7
+ // sign, send, approve, swap, create/load a wallet, or publish. Read-only by
8
+ // construction.
9
+ // ────────────────────────────────────────────────────────────────────────
10
+ import { readFileSync } from "fs";
11
+ import { fileURLToPath } from "url";
12
+ import { dirname, join } from "path";
13
+ import { analyzeEvmCall, analyzeTxHash, analyzeContract, analyzeApproval, analyzeSafeTx, analyzeCalldata, isDecodableCalldataSelector, analyzeX402, } from "../lib/analysis/index.js";
14
+ import { APPROVE_SELECTOR } from "../lib/analysis/approval.js";
15
+ import { MULTISEND_SELECTOR } from "../lib/analysis/safeTx.js";
16
+ import { GUARDIAN_DECISIONS } from "../lib/guardian/decision.js";
17
+ import { getActiveNetwork, getActiveNetworkName, getNetworkByChainId, isNetworkName, } from "../lib/networks.js";
18
+ import { getGates, isReadOnlyMode, getCapabilityFlags } from "../lib/config.js";
19
+ import { guardianCheckSchema, analyzeTxSchema, analyzeContractSchema, analyzeApprovalSchema, analyzeSafeSchema, analyzeCalldataSchema, analyzeX402Schema, } from "./schemas.js";
20
+ import { readOnlyMeta, rpcMeta, explorerLinks, worstDecision } from "./response.js";
21
+ import { ecosystemEvidenceForRequest, applyEcosystemEscalation } from "../lib/pharos/ecosystemEvidence.js";
22
+ import { ecosystemRegistrySummary } from "../lib/pharos/ecosystem.js";
23
+ const SERVICE = "SafeHands API";
24
+ function readVersion() {
25
+ try {
26
+ const here = dirname(fileURLToPath(import.meta.url));
27
+ // dist/api/routes.js or src/api/routes.ts → repo root is two levels up.
28
+ const pkg = JSON.parse(readFileSync(join(here, "..", "..", "package.json"), "utf-8"));
29
+ return typeof pkg.version === "string" ? pkg.version : "unknown";
30
+ }
31
+ catch {
32
+ return "unknown";
33
+ }
34
+ }
35
+ const VERSION = readVersion();
36
+ /** Resolve the target network from explicit name/chainId, else the active one. */
37
+ function resolveNetwork(input) {
38
+ if (input.network && isNetworkName(input.network)) {
39
+ return getNetworkByChainId(input.network === "pacific-mainnet" ? 1672 : 688689) ?? getActiveNetwork();
40
+ }
41
+ if (typeof input.chainId === "number") {
42
+ return getNetworkByChainId(input.chainId) ?? getActiveNetwork();
43
+ }
44
+ return getActiveNetwork();
45
+ }
46
+ const RISK_SEVERITY = {
47
+ CRITICAL: 4,
48
+ HIGH: 3,
49
+ MEDIUM: 2,
50
+ LOW: 1,
51
+ UNKNOWN: 0,
52
+ };
53
+ function worstRisk(levels) {
54
+ if (levels.length === 0)
55
+ return "UNKNOWN";
56
+ return levels.reduce((worst, l) => (RISK_SEVERITY[l] > RISK_SEVERITY[worst] ? l : worst), "UNKNOWN");
57
+ }
58
+ function selectorOf(data) {
59
+ if (!data || !data.startsWith("0x") || data.length < 10)
60
+ return null;
61
+ return data.slice(0, 10).toLowerCase();
62
+ }
63
+ // ── GET /health ────────────────────────────────────────────────────────
64
+ export function handleHealth() {
65
+ return {
66
+ status: "ok",
67
+ service: SERVICE,
68
+ version: VERSION,
69
+ timestamp: new Date().toISOString(),
70
+ };
71
+ }
72
+ // ── GET /infra/status ──────────────────────────────────────────────────
73
+ export function handleInfraStatus() {
74
+ const network = getActiveNetwork();
75
+ return {
76
+ network: getActiveNetworkName(),
77
+ label: network.label,
78
+ chainId: network.chainId,
79
+ nativeToken: network.nativeToken,
80
+ isMainnet: network.isMainnet,
81
+ explorer: {
82
+ explorerUrl: network.explorerUrl,
83
+ socialScanUrl: network.socialScanUrl ?? null,
84
+ },
85
+ readOnlyMode: isReadOnlyMode(),
86
+ walletMode: process.env.WALLET_MODE ?? "none",
87
+ gates: getGates(),
88
+ capabilities: getCapabilityFlags(network),
89
+ ecosystem: ecosystemRegistrySummary(),
90
+ ...readOnlyMeta(),
91
+ ...rpcMeta(network),
92
+ };
93
+ }
94
+ // ── GET /public-config ─────────────────────────────────────────────────
95
+ // Safe public config only. Emits the hardcoded PUBLIC default RPC URL — never
96
+ // resolveRpcUrl()/env values (which may be premium/keyed) — and no secrets.
97
+ export function handlePublicConfig() {
98
+ const network = getActiveNetwork();
99
+ return {
100
+ service: SERVICE,
101
+ version: VERSION,
102
+ network: getActiveNetworkName(),
103
+ label: network.label,
104
+ chainId: network.chainId,
105
+ nativeToken: network.nativeToken,
106
+ isMainnet: network.isMainnet,
107
+ explorer: {
108
+ explorerUrl: network.explorerUrl,
109
+ socialScanUrl: network.socialScanUrl ?? null,
110
+ },
111
+ publicRpcUrl: network.defaultRpcUrl,
112
+ decisions: GUARDIAN_DECISIONS,
113
+ supportedFeatures: [
114
+ "read-only SafeHands checks",
115
+ "evm call analysis",
116
+ "transaction-hash analysis",
117
+ "contract intelligence (canonical recognition)",
118
+ "approval analysis (ERC-20 approve)",
119
+ "safe-tx / multiSend decode (experimental)",
120
+ "x402 preflight analysis (no payment)",
121
+ ],
122
+ readOnlyMode: isReadOnlyMode(),
123
+ gates: getGates(),
124
+ capabilities: getCapabilityFlags(network),
125
+ ecosystem: ecosystemRegistrySummary(),
126
+ ...readOnlyMeta(),
127
+ ...rpcMeta(network),
128
+ };
129
+ }
130
+ // ── POST /guardian/check ───────────────────────────────────────────────
131
+ // Universal read-only entry: routes to the right analyzer(s) and aggregates.
132
+ export async function handleGuardianCheck(raw, access) {
133
+ const input = guardianCheckSchema.parse(raw);
134
+ const network = resolveNetwork(input);
135
+ const analyzers = [];
136
+ // Ecosystem awareness (evidence only; escalate-only — never relaxes a decision).
137
+ const ecosystemEvidence = ecosystemEvidenceForRequest(input);
138
+ const selector = selectorOf(input.data);
139
+ if (input.txHash || input.inputType === "tx") {
140
+ if (!input.txHash)
141
+ throw new Error("inputType 'tx' requires a txHash.");
142
+ analyzers.push(await analyzeTxHash(input.txHash, access));
143
+ }
144
+ else if (input.inputType === "contract") {
145
+ if (!input.to)
146
+ throw new Error("inputType 'contract' requires a 'to' address.");
147
+ analyzers.push(await analyzeContract(input.to, access));
148
+ }
149
+ else if (input.to || input.data || input.value) {
150
+ analyzers.push(await analyzeEvmCall({ to: input.to, data: input.data, value: input.value, chainId: network.chainId }, access));
151
+ if (selector === APPROVE_SELECTOR && input.data) {
152
+ analyzers.push(analyzeApproval(input.data, input.to));
153
+ }
154
+ else if (selector === MULTISEND_SELECTOR && input.data) {
155
+ analyzers.push(await analyzeSafeTx(input.data));
156
+ }
157
+ else if (input.data && isDecodableCalldataSelector(selector)) {
158
+ // permit / Permit2 approve / setApprovalForAll / transferFrom / transfer /
159
+ // allowance / dangerous-admin selectors — offline decode, escalate-only.
160
+ analyzers.push(analyzeCalldata(input.data, input.to));
161
+ }
162
+ }
163
+ if (analyzers.length === 0) {
164
+ return {
165
+ decision: "REQUIRE_CONFIRMATION",
166
+ riskLevel: "UNKNOWN",
167
+ reasons: ["No analyzable input. Provide txHash, a contract address, or to/data/value."],
168
+ warnings: [],
169
+ analyzers: [],
170
+ network: getActiveNetworkName(),
171
+ chainId: network.chainId,
172
+ explorerLinks: {},
173
+ ecosystemEvidence,
174
+ ...readOnlyMeta(),
175
+ ...rpcMeta(network, access),
176
+ };
177
+ }
178
+ const baseDecision = worstDecision(analyzers.map((a) => a.decision));
179
+ // Escalate-only: ecosystem awareness may raise (cross-chain / WASM →
180
+ // REQUIRE_CONFIRMATION) but NEVER relaxes a decision or makes a risky action safe.
181
+ const decision = applyEcosystemEscalation(baseDecision, ecosystemEvidence);
182
+ const riskLevel = worstRisk(analyzers.map((a) => a.riskLevel));
183
+ const reasons = analyzers.flatMap((a) => a.reasons);
184
+ if (decision !== baseDecision) {
185
+ reasons.push(`Ecosystem awareness (${ecosystemEvidence.category}): ${ecosystemEvidence.safehandsBehavior}`);
186
+ }
187
+ const warnings = analyzers.flatMap((a) => a.warnings);
188
+ return {
189
+ decision,
190
+ riskLevel,
191
+ reasons,
192
+ warnings,
193
+ analyzers,
194
+ network: getActiveNetworkName(),
195
+ chainId: network.chainId,
196
+ explorerLinks: explorerLinks(network, { address: input.to, txHash: input.txHash }),
197
+ ecosystemEvidence,
198
+ ...readOnlyMeta(),
199
+ ...rpcMeta(network, access),
200
+ };
201
+ }
202
+ // ── POST /analyze/tx ───────────────────────────────────────────────────
203
+ export async function handleAnalyzeTx(raw, access) {
204
+ const input = analyzeTxSchema.parse(raw);
205
+ const network = resolveNetwork(input);
206
+ const result = await analyzeTxHash(input.txHash, access);
207
+ return {
208
+ ...result,
209
+ explorerLinks: explorerLinks(network, { txHash: input.txHash }),
210
+ ecosystemEvidence: ecosystemEvidenceForRequest(input),
211
+ ...readOnlyMeta(),
212
+ ...rpcMeta(network, access),
213
+ };
214
+ }
215
+ // ── POST /analyze/contract ─────────────────────────────────────────────
216
+ export async function handleAnalyzeContract(raw, access) {
217
+ const input = analyzeContractSchema.parse(raw);
218
+ const network = resolveNetwork(input);
219
+ const result = await analyzeContract(input.address, access);
220
+ return {
221
+ ...result,
222
+ explorerLinks: explorerLinks(network, { address: input.address }),
223
+ ecosystemEvidence: ecosystemEvidenceForRequest({ address: input.address, network: input.network }),
224
+ ...readOnlyMeta(),
225
+ ...rpcMeta(network, access),
226
+ };
227
+ }
228
+ // ── POST /analyze/approval ─────────────────────────────────────────────
229
+ export function handleAnalyzeApproval(raw) {
230
+ const input = analyzeApprovalSchema.parse(raw);
231
+ const result = analyzeApproval(input.data, input.token);
232
+ return {
233
+ ...result,
234
+ ecosystemEvidence: ecosystemEvidenceForRequest({ token: input.token }),
235
+ ...readOnlyMeta(),
236
+ ...rpcMeta(getActiveNetwork()),
237
+ };
238
+ }
239
+ // ── POST /analyze/calldata ─────────────────────────────────────────────
240
+ // Offline superset decoder (permit, Permit2 approve, setApprovalForAll,
241
+ // transferFrom/transfer, allowance changes, dangerous-admin selectors). Never
242
+ // signs/sends — verdict only. Read-only.
243
+ export function handleAnalyzeCalldata(raw) {
244
+ const input = analyzeCalldataSchema.parse(raw);
245
+ const result = analyzeCalldata(input.data, input.token);
246
+ return {
247
+ ...result,
248
+ ecosystemEvidence: ecosystemEvidenceForRequest({ token: input.token }),
249
+ ...readOnlyMeta(),
250
+ ...rpcMeta(getActiveNetwork()),
251
+ };
252
+ }
253
+ // ── POST /analyze/safe ─────────────────────────────────────────────────
254
+ export async function handleAnalyzeSafe(raw) {
255
+ const input = analyzeSafeSchema.parse(raw);
256
+ const result = await analyzeSafeTx(input.data);
257
+ return {
258
+ ...result,
259
+ ecosystemEvidence: ecosystemEvidenceForRequest({ provider: "safe" }),
260
+ ...readOnlyMeta(),
261
+ ...rpcMeta(getActiveNetwork()),
262
+ };
263
+ }
264
+ // ── POST /analyze/x402 ─────────────────────────────────────────────────
265
+ // SSRF protection is inherited from analyzeX402's static URL check (offline-safe).
266
+ export function handleAnalyzeX402(raw) {
267
+ const input = analyzeX402Schema.parse(raw);
268
+ const result = analyzeX402(input);
269
+ return {
270
+ ...result,
271
+ ecosystemEvidence: ecosystemEvidenceForRequest({ provider: "x402", address: input.paymentTokenAddress }),
272
+ ...readOnlyMeta(),
273
+ ...rpcMeta(getActiveNetwork()),
274
+ };
275
+ }
276
+ //# sourceMappingURL=routes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,147 @@
1
+ import { z } from "zod";
2
+ export declare const addressSchema: z.ZodEffects<z.ZodString, `0x${string}`, string>;
3
+ /** Calldata: 0x followed by an even number of hex chars (may be empty 0x). */
4
+ export declare const hexDataSchema: z.ZodString;
5
+ export declare const txHashSchema: z.ZodString;
6
+ /** Value in wei: a non-negative decimal string or 0x-prefixed hex string. */
7
+ export declare const valueSchema: z.ZodString;
8
+ export declare const networkNameSchema: z.ZodEffects<z.ZodString, import("../lib/networks.js").NetworkName, string>;
9
+ export declare const chainIdSchema: z.ZodNumber;
10
+ /** Universal SafeHands check — every field optional; the router decides. */
11
+ export declare const guardianCheckSchema: z.ZodObject<{
12
+ network: z.ZodOptional<z.ZodEffects<z.ZodString, import("../lib/networks.js").NetworkName, string>>;
13
+ chainId: z.ZodOptional<z.ZodNumber>;
14
+ to: z.ZodOptional<z.ZodEffects<z.ZodString, `0x${string}`, string>>;
15
+ data: z.ZodOptional<z.ZodString>;
16
+ value: z.ZodOptional<z.ZodString>;
17
+ txHash: z.ZodOptional<z.ZodString>;
18
+ policy: z.ZodOptional<z.ZodString>;
19
+ actor: z.ZodOptional<z.ZodString>;
20
+ inputType: z.ZodOptional<z.ZodEnum<["tx", "contract", "approval", "safe", "x402", "call"]>>;
21
+ /** Optional ecosystem provider hint (e.g. "LayerZero") — evidence only. */
22
+ provider: z.ZodOptional<z.ZodString>;
23
+ /** Optional ecosystem category hint (e.g. "cross_chain") — evidence only. */
24
+ ecosystemCategory: z.ZodOptional<z.ZodString>;
25
+ }, "strip", z.ZodTypeAny, {
26
+ network?: import("../lib/networks.js").NetworkName | undefined;
27
+ provider?: string | undefined;
28
+ to?: `0x${string}` | undefined;
29
+ data?: string | undefined;
30
+ value?: string | undefined;
31
+ chainId?: number | undefined;
32
+ txHash?: string | undefined;
33
+ policy?: string | undefined;
34
+ actor?: string | undefined;
35
+ inputType?: "x402" | "call" | "safe" | "contract" | "approval" | "tx" | undefined;
36
+ ecosystemCategory?: string | undefined;
37
+ }, {
38
+ network?: string | undefined;
39
+ provider?: string | undefined;
40
+ to?: string | undefined;
41
+ data?: string | undefined;
42
+ value?: string | undefined;
43
+ chainId?: number | undefined;
44
+ txHash?: string | undefined;
45
+ policy?: string | undefined;
46
+ actor?: string | undefined;
47
+ inputType?: "x402" | "call" | "safe" | "contract" | "approval" | "tx" | undefined;
48
+ ecosystemCategory?: string | undefined;
49
+ }>;
50
+ export type GuardianCheckInput = z.infer<typeof guardianCheckSchema>;
51
+ export declare const analyzeTxSchema: z.ZodObject<{
52
+ txHash: z.ZodString;
53
+ network: z.ZodOptional<z.ZodEffects<z.ZodString, import("../lib/networks.js").NetworkName, string>>;
54
+ chainId: z.ZodOptional<z.ZodNumber>;
55
+ }, "strip", z.ZodTypeAny, {
56
+ txHash: string;
57
+ network?: import("../lib/networks.js").NetworkName | undefined;
58
+ chainId?: number | undefined;
59
+ }, {
60
+ txHash: string;
61
+ network?: string | undefined;
62
+ chainId?: number | undefined;
63
+ }>;
64
+ export type AnalyzeTxInput = z.infer<typeof analyzeTxSchema>;
65
+ export declare const analyzeContractSchema: z.ZodObject<{
66
+ address: z.ZodEffects<z.ZodString, `0x${string}`, string>;
67
+ network: z.ZodOptional<z.ZodEffects<z.ZodString, import("../lib/networks.js").NetworkName, string>>;
68
+ chainId: z.ZodOptional<z.ZodNumber>;
69
+ }, "strip", z.ZodTypeAny, {
70
+ address: `0x${string}`;
71
+ network?: import("../lib/networks.js").NetworkName | undefined;
72
+ chainId?: number | undefined;
73
+ }, {
74
+ address: string;
75
+ network?: string | undefined;
76
+ chainId?: number | undefined;
77
+ }>;
78
+ export type AnalyzeContractInput = z.infer<typeof analyzeContractSchema>;
79
+ export declare const analyzeApprovalSchema: z.ZodObject<{
80
+ data: z.ZodString;
81
+ token: z.ZodOptional<z.ZodEffects<z.ZodString, `0x${string}`, string>>;
82
+ }, "strip", z.ZodTypeAny, {
83
+ data: string;
84
+ token?: `0x${string}` | undefined;
85
+ }, {
86
+ data: string;
87
+ token?: string | undefined;
88
+ }>;
89
+ export type AnalyzeApprovalInput = z.infer<typeof analyzeApprovalSchema>;
90
+ export declare const analyzeSafeSchema: z.ZodObject<{
91
+ data: z.ZodString;
92
+ }, "strip", z.ZodTypeAny, {
93
+ data: string;
94
+ }, {
95
+ data: string;
96
+ }>;
97
+ export type AnalyzeSafeInput = z.infer<typeof analyzeSafeSchema>;
98
+ export declare const analyzeCalldataSchema: z.ZodObject<{
99
+ data: z.ZodString;
100
+ /** Optional token/contract the calldata targets — read-only metadata only. */
101
+ token: z.ZodOptional<z.ZodEffects<z.ZodString, `0x${string}`, string>>;
102
+ }, "strip", z.ZodTypeAny, {
103
+ data: string;
104
+ token?: `0x${string}` | undefined;
105
+ }, {
106
+ data: string;
107
+ token?: string | undefined;
108
+ }>;
109
+ export type AnalyzeCalldataInput = z.infer<typeof analyzeCalldataSchema>;
110
+ export declare const analyzeX402Schema: z.ZodObject<{
111
+ url: z.ZodString;
112
+ paymentAmountUsdc: z.ZodOptional<z.ZodString>;
113
+ paymentTokenAddress: z.ZodOptional<z.ZodEffects<z.ZodString, `0x${string}`, string>>;
114
+ payTo: z.ZodOptional<z.ZodEffects<z.ZodString, `0x${string}`, string>>;
115
+ agentId: z.ZodOptional<z.ZodString>;
116
+ chainId: z.ZodOptional<z.ZodNumber>;
117
+ }, "strip", z.ZodTypeAny, {
118
+ url: string;
119
+ chainId?: number | undefined;
120
+ agentId?: string | undefined;
121
+ paymentAmountUsdc?: string | undefined;
122
+ paymentTokenAddress?: `0x${string}` | undefined;
123
+ payTo?: `0x${string}` | undefined;
124
+ }, {
125
+ url: string;
126
+ chainId?: number | undefined;
127
+ agentId?: string | undefined;
128
+ paymentAmountUsdc?: string | undefined;
129
+ paymentTokenAddress?: string | undefined;
130
+ payTo?: string | undefined;
131
+ }>;
132
+ export type AnalyzeX402Input = z.infer<typeof analyzeX402Schema>;
133
+ export declare const broadcastSignedSchema: z.ZodObject<{
134
+ rawSignedTransaction: z.ZodString;
135
+ preparedTransactionId: z.ZodString;
136
+ preparedTransactionHash: z.ZodString;
137
+ }, "strip", z.ZodTypeAny, {
138
+ preparedTransactionHash: string;
139
+ rawSignedTransaction: string;
140
+ preparedTransactionId: string;
141
+ }, {
142
+ preparedTransactionHash: string;
143
+ rawSignedTransaction: string;
144
+ preparedTransactionId: string;
145
+ }>;
146
+ export type BroadcastSignedInput = z.infer<typeof broadcastSignedSchema>;
147
+ //# sourceMappingURL=schemas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/api/schemas.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,aAAa,kDAE+D,CAAC;AAE1F,8EAA8E;AAC9E,eAAO,MAAM,aAAa,aAEwD,CAAC;AAEnF,eAAO,MAAM,YAAY,aAEyD,CAAC;AAEnF,6EAA6E;AAC7E,eAAO,MAAM,WAAW,aAE8D,CAAC;AAEvF,eAAO,MAAM,iBAAiB,6EAE6E,CAAC;AAE5G,eAAO,MAAM,aAAa,aAA8B,CAAC;AAIzD,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB;;;;;;;;;;IAU9B,2EAA2E;;IAE3E,6EAA6E;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7E,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,qBAAqB;;IAEhC,8EAA8E;;;;;;;;EAE9E,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}