safehands-pharos 1.4.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.
- package/.agents/policies/default.json +15 -0
- package/.env.example +81 -64
- package/README.md +301 -333
- package/SECURITY.md +112 -0
- package/SKILL.md +59 -0
- package/contracts/SafeHandsAttestation.sol +182 -0
- package/contracts/SafeHandsRegistry.sol +149 -0
- package/dist/agent/SafeHandsGuardianAgent.d.ts +39 -0
- package/dist/agent/SafeHandsGuardianAgent.d.ts.map +1 -0
- package/dist/agent/SafeHandsGuardianAgent.js +98 -0
- package/dist/agent/SafeHandsGuardianAgent.js.map +1 -0
- package/dist/agent/agentDecisionFormatter.d.ts +43 -0
- package/dist/agent/agentDecisionFormatter.d.ts.map +1 -0
- package/dist/agent/agentDecisionFormatter.js +96 -0
- package/dist/agent/agentDecisionFormatter.js.map +1 -0
- package/dist/agent/agentEnrich.d.ts +28 -0
- package/dist/agent/agentEnrich.d.ts.map +1 -0
- package/dist/agent/agentEnrich.js +99 -0
- package/dist/agent/agentEnrich.js.map +1 -0
- package/dist/agent/agentIntentClassifier.d.ts +44 -0
- package/dist/agent/agentIntentClassifier.d.ts.map +1 -0
- package/dist/agent/agentIntentClassifier.js +77 -0
- package/dist/agent/agentIntentClassifier.js.map +1 -0
- package/dist/agent/agentPolicyResolver.d.ts +44 -0
- package/dist/agent/agentPolicyResolver.d.ts.map +1 -0
- package/dist/agent/agentPolicyResolver.js +94 -0
- package/dist/agent/agentPolicyResolver.js.map +1 -0
- package/dist/agent/agentRuntime.d.ts +12 -0
- package/dist/agent/agentRuntime.d.ts.map +1 -0
- package/dist/agent/agentRuntime.js +31 -0
- package/dist/agent/agentRuntime.js.map +1 -0
- package/dist/agent/agentToolRouter.d.ts +24 -0
- package/dist/agent/agentToolRouter.d.ts.map +1 -0
- package/dist/agent/agentToolRouter.js +89 -0
- package/dist/agent/agentToolRouter.js.map +1 -0
- package/dist/agent/guardianOperator.d.ts +35 -0
- package/dist/agent/guardianOperator.d.ts.map +1 -0
- package/dist/agent/guardianOperator.js +65 -0
- package/dist/agent/guardianOperator.js.map +1 -0
- package/dist/agent/index.d.ts +8 -0
- package/dist/agent/index.d.ts.map +1 -0
- package/dist/agent/index.js +14 -0
- package/dist/agent/index.js.map +1 -0
- package/dist/api/activityRoutes.d.ts +70 -0
- package/dist/api/activityRoutes.d.ts.map +1 -0
- package/dist/api/activityRoutes.js +100 -0
- package/dist/api/activityRoutes.js.map +1 -0
- package/dist/api/agentRoutes.d.ts +16 -0
- package/dist/api/agentRoutes.d.ts.map +1 -0
- package/dist/api/agentRoutes.js +37 -0
- package/dist/api/agentRoutes.js.map +1 -0
- package/dist/api/broadcastRoutes.d.ts +34 -0
- package/dist/api/broadcastRoutes.d.ts.map +1 -0
- package/dist/api/broadcastRoutes.js +147 -0
- package/dist/api/broadcastRoutes.js.map +1 -0
- package/dist/api/consolePage.d.ts +2 -0
- package/dist/api/consolePage.d.ts.map +1 -0
- package/dist/api/consolePage.js +206 -0
- package/dist/api/consolePage.js.map +1 -0
- package/dist/api/httpHardening.d.ts +75 -0
- package/dist/api/httpHardening.d.ts.map +1 -0
- package/dist/api/httpHardening.js +122 -0
- package/dist/api/httpHardening.js.map +1 -0
- package/dist/api/indexerRoutes.d.ts +46 -0
- package/dist/api/indexerRoutes.d.ts.map +1 -0
- package/dist/api/indexerRoutes.js +75 -0
- package/dist/api/indexerRoutes.js.map +1 -0
- package/dist/api/paidRoutes.d.ts +8 -0
- package/dist/api/paidRoutes.d.ts.map +1 -0
- package/dist/api/paidRoutes.js +175 -0
- package/dist/api/paidRoutes.js.map +1 -0
- package/dist/api/prepareRoutes.d.ts +58 -0
- package/dist/api/prepareRoutes.d.ts.map +1 -0
- package/dist/api/prepareRoutes.js +90 -0
- package/dist/api/prepareRoutes.js.map +1 -0
- package/dist/api/response.d.ts +39 -0
- package/dist/api/response.d.ts.map +1 -0
- package/dist/api/response.js +53 -0
- package/dist/api/response.js.map +1 -0
- package/dist/api/routes.d.ts +175 -0
- package/dist/api/routes.d.ts.map +1 -0
- package/dist/api/routes.js +276 -0
- package/dist/api/routes.js.map +1 -0
- package/dist/api/schemas.d.ts +147 -0
- package/dist/api/schemas.d.ts.map +1 -0
- package/dist/api/schemas.js +81 -0
- package/dist/api/schemas.js.map +1 -0
- package/dist/api/server.d.ts +11 -0
- package/dist/api/server.d.ts.map +1 -0
- package/dist/api/server.js +505 -0
- package/dist/api/server.js.map +1 -0
- package/dist/api/toolRoutes.d.ts +14 -0
- package/dist/api/toolRoutes.d.ts.map +1 -0
- package/dist/api/toolRoutes.js +138 -0
- package/dist/api/toolRoutes.js.map +1 -0
- package/dist/api/walletPrepareRoutes.d.ts +74 -0
- package/dist/api/walletPrepareRoutes.d.ts.map +1 -0
- package/dist/api/walletPrepareRoutes.js +127 -0
- package/dist/api/walletPrepareRoutes.js.map +1 -0
- package/dist/api/x402Gate.d.ts +51 -0
- package/dist/api/x402Gate.d.ts.map +1 -0
- package/dist/api/x402Gate.js +184 -0
- package/dist/api/x402Gate.js.map +1 -0
- package/dist/cli.d.ts +5 -5
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +154 -124
- package/dist/cli.js.map +1 -1
- package/dist/data/ecosystemRegistry.data.d.ts +3 -0
- package/dist/data/ecosystemRegistry.data.d.ts.map +1 -0
- package/dist/data/ecosystemRegistry.data.js +582 -0
- package/dist/data/ecosystemRegistry.data.js.map +1 -0
- package/dist/demo.d.ts +1 -1
- package/dist/demo.d.ts.map +1 -1
- package/dist/demo.js +206 -171
- package/dist/demo.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +249 -164
- package/dist/index.js.map +1 -1
- package/dist/init.d.ts +1 -1
- package/dist/init.d.ts.map +1 -1
- package/dist/init.js +127 -65
- package/dist/init.js.map +1 -1
- package/dist/lib/analysis/approval.d.ts +29 -0
- package/dist/lib/analysis/approval.d.ts.map +1 -0
- package/dist/lib/analysis/approval.js +162 -0
- package/dist/lib/analysis/approval.js.map +1 -0
- package/dist/lib/analysis/calldata.d.ts +60 -0
- package/dist/lib/analysis/calldata.d.ts.map +1 -0
- package/dist/lib/analysis/calldata.js +349 -0
- package/dist/lib/analysis/calldata.js.map +1 -0
- package/dist/lib/analysis/contractIntel.d.ts +65 -0
- package/dist/lib/analysis/contractIntel.d.ts.map +1 -0
- package/dist/lib/analysis/contractIntel.js +320 -0
- package/dist/lib/analysis/contractIntel.js.map +1 -0
- package/dist/lib/analysis/evm.d.ts +42 -0
- package/dist/lib/analysis/evm.d.ts.map +1 -0
- package/dist/lib/analysis/evm.js +185 -0
- package/dist/lib/analysis/evm.js.map +1 -0
- package/dist/lib/analysis/gas.d.ts +4 -0
- package/dist/lib/analysis/gas.d.ts.map +1 -0
- package/dist/lib/analysis/gas.js +13 -0
- package/dist/lib/analysis/gas.js.map +1 -0
- package/dist/lib/analysis/index.d.ts +11 -0
- package/dist/lib/analysis/index.d.ts.map +1 -0
- package/dist/lib/analysis/index.js +16 -0
- package/dist/lib/analysis/index.js.map +1 -0
- package/dist/lib/analysis/pharosTokens.d.ts +31 -0
- package/dist/lib/analysis/pharosTokens.d.ts.map +1 -0
- package/dist/lib/analysis/pharosTokens.js +78 -0
- package/dist/lib/analysis/pharosTokens.js.map +1 -0
- package/dist/lib/analysis/safeTx.d.ts +27 -0
- package/dist/lib/analysis/safeTx.d.ts.map +1 -0
- package/dist/lib/analysis/safeTx.js +118 -0
- package/dist/lib/analysis/safeTx.js.map +1 -0
- package/dist/lib/analysis/token.d.ts +21 -0
- package/dist/lib/analysis/token.d.ts.map +1 -0
- package/dist/lib/analysis/token.js +151 -0
- package/dist/lib/analysis/token.js.map +1 -0
- package/dist/lib/analysis/types.d.ts +49 -0
- package/dist/lib/analysis/types.d.ts.map +1 -0
- package/dist/lib/analysis/types.js +10 -0
- package/dist/lib/analysis/types.js.map +1 -0
- package/dist/lib/analysis/x402.d.ts +24 -0
- package/dist/lib/analysis/x402.d.ts.map +1 -0
- package/dist/lib/analysis/x402.js +60 -0
- package/dist/lib/analysis/x402.js.map +1 -0
- package/dist/lib/auditLog.d.ts +1 -0
- package/dist/lib/auditLog.d.ts.map +1 -1
- package/dist/lib/auditLog.js +0 -0
- package/dist/lib/auditLog.js.map +1 -1
- package/dist/lib/config.d.ts +77 -0
- package/dist/lib/config.d.ts.map +1 -0
- package/dist/lib/config.js +120 -0
- package/dist/lib/config.js.map +1 -0
- package/dist/lib/constants.d.ts +452 -291
- package/dist/lib/constants.d.ts.map +1 -1
- package/dist/lib/constants.js +509 -292
- package/dist/lib/constants.js.map +1 -1
- package/dist/lib/dodoApi.d.ts +101 -78
- package/dist/lib/dodoApi.d.ts.map +1 -1
- package/dist/lib/dodoApi.js +259 -196
- package/dist/lib/dodoApi.js.map +1 -1
- package/dist/lib/ecosystemRegistry.d.ts +116 -0
- package/dist/lib/ecosystemRegistry.d.ts.map +1 -0
- package/dist/lib/ecosystemRegistry.js +178 -0
- package/dist/lib/ecosystemRegistry.js.map +1 -0
- package/dist/lib/envLoader.d.ts +2 -0
- package/dist/lib/envLoader.d.ts.map +1 -0
- package/dist/lib/envLoader.js +65 -0
- package/dist/lib/envLoader.js.map +1 -0
- package/dist/lib/goldsky.d.ts +58 -0
- package/dist/lib/goldsky.d.ts.map +1 -0
- package/dist/lib/goldsky.js +275 -0
- package/dist/lib/goldsky.js.map +1 -0
- package/dist/lib/guardian/decision.d.ts +23 -0
- package/dist/lib/guardian/decision.d.ts.map +1 -0
- package/dist/lib/guardian/decision.js +40 -0
- package/dist/lib/guardian/decision.js.map +1 -0
- package/dist/lib/http.d.ts +13 -14
- package/dist/lib/http.d.ts.map +1 -1
- package/dist/lib/http.js +383 -118
- package/dist/lib/http.js.map +1 -1
- package/dist/lib/managedExecution.d.ts +19 -0
- package/dist/lib/managedExecution.d.ts.map +1 -0
- package/dist/lib/managedExecution.js +64 -0
- package/dist/lib/managedExecution.js.map +1 -0
- package/dist/lib/merkleBatcher.d.ts +23 -0
- package/dist/lib/merkleBatcher.d.ts.map +1 -0
- package/dist/lib/merkleBatcher.js +62 -0
- package/dist/lib/merkleBatcher.js.map +1 -0
- package/dist/lib/networks.d.ts +48 -0
- package/dist/lib/networks.d.ts.map +1 -0
- package/dist/lib/networks.js +103 -0
- package/dist/lib/networks.js.map +1 -0
- package/dist/lib/observability/accessContext.d.ts +29 -0
- package/dist/lib/observability/accessContext.d.ts.map +1 -0
- package/dist/lib/observability/accessContext.js +50 -0
- package/dist/lib/observability/accessContext.js.map +1 -0
- package/dist/lib/observability/activityStore.d.ts +70 -0
- package/dist/lib/observability/activityStore.d.ts.map +1 -0
- package/dist/lib/observability/activityStore.js +149 -0
- package/dist/lib/observability/activityStore.js.map +1 -0
- package/dist/lib/observability/apiKey.d.ts +55 -0
- package/dist/lib/observability/apiKey.d.ts.map +1 -0
- package/dist/lib/observability/apiKey.js +141 -0
- package/dist/lib/observability/apiKey.js.map +1 -0
- package/dist/lib/observability/logger.d.ts +30 -0
- package/dist/lib/observability/logger.d.ts.map +1 -0
- package/dist/lib/observability/logger.js +30 -0
- package/dist/lib/observability/logger.js.map +1 -0
- package/dist/lib/observability/quota.d.ts +33 -0
- package/dist/lib/observability/quota.d.ts.map +1 -0
- package/dist/lib/observability/quota.js +49 -0
- package/dist/lib/observability/quota.js.map +1 -0
- package/dist/lib/observability/requestId.d.ts +8 -0
- package/dist/lib/observability/requestId.d.ts.map +1 -0
- package/dist/lib/observability/requestId.js +24 -0
- package/dist/lib/observability/requestId.js.map +1 -0
- package/dist/lib/observability/sanitize.d.ts +77 -0
- package/dist/lib/observability/sanitize.d.ts.map +1 -0
- package/dist/lib/observability/sanitize.js +228 -0
- package/dist/lib/observability/sanitize.js.map +1 -0
- package/dist/lib/observability/scopes.d.ts +20 -0
- package/dist/lib/observability/scopes.d.ts.map +1 -0
- package/dist/lib/observability/scopes.js +77 -0
- package/dist/lib/observability/scopes.js.map +1 -0
- package/dist/lib/okxDexApi.d.ts +106 -0
- package/dist/lib/okxDexApi.d.ts.map +1 -0
- package/dist/lib/okxDexApi.js +221 -0
- package/dist/lib/okxDexApi.js.map +1 -0
- package/dist/lib/persistentJsonStore.d.ts +5 -0
- package/dist/lib/persistentJsonStore.d.ts.map +1 -0
- package/dist/lib/persistentJsonStore.js +39 -0
- package/dist/lib/persistentJsonStore.js.map +1 -0
- package/dist/lib/pharos/attestationPublisher.d.ts +50 -0
- package/dist/lib/pharos/attestationPublisher.d.ts.map +1 -0
- package/dist/lib/pharos/attestationPublisher.js +262 -0
- package/dist/lib/pharos/attestationPublisher.js.map +1 -0
- package/dist/lib/pharos/ecosystem.d.ts +52 -0
- package/dist/lib/pharos/ecosystem.d.ts.map +1 -0
- package/dist/lib/pharos/ecosystem.js +431 -0
- package/dist/lib/pharos/ecosystem.js.map +1 -0
- package/dist/lib/pharos/ecosystemEvidence.d.ts +53 -0
- package/dist/lib/pharos/ecosystemEvidence.d.ts.map +1 -0
- package/dist/lib/pharos/ecosystemEvidence.js +133 -0
- package/dist/lib/pharos/ecosystemEvidence.js.map +1 -0
- package/dist/lib/pharos/rpc.d.ts +44 -0
- package/dist/lib/pharos/rpc.d.ts.map +1 -0
- package/dist/lib/pharos/rpc.js +90 -0
- package/dist/lib/pharos/rpc.js.map +1 -0
- package/dist/lib/pharos/rpcEvidence.d.ts +49 -0
- package/dist/lib/pharos/rpcEvidence.d.ts.map +1 -0
- package/dist/lib/pharos/rpcEvidence.js +46 -0
- package/dist/lib/pharos/rpcEvidence.js.map +1 -0
- package/dist/lib/pharos/rpcMethods.d.ts +46 -0
- package/dist/lib/pharos/rpcMethods.d.ts.map +1 -0
- package/dist/lib/pharos/rpcMethods.js +176 -0
- package/dist/lib/pharos/rpcMethods.js.map +1 -0
- package/dist/lib/pharos/spvVerifier.d.ts +47 -0
- package/dist/lib/pharos/spvVerifier.d.ts.map +1 -0
- package/dist/lib/pharos/spvVerifier.js +105 -0
- package/dist/lib/pharos/spvVerifier.js.map +1 -0
- package/dist/lib/pharos/userSignedBroadcaster.d.ts +10 -0
- package/dist/lib/pharos/userSignedBroadcaster.d.ts.map +1 -0
- package/dist/lib/pharos/userSignedBroadcaster.js +50 -0
- package/dist/lib/pharos/userSignedBroadcaster.js.map +1 -0
- package/dist/lib/pharosClient.d.ts +53 -58
- package/dist/lib/pharosClient.d.ts.map +1 -1
- package/dist/lib/pharosClient.js +56 -63
- package/dist/lib/pharosClient.js.map +1 -1
- package/dist/lib/policy/actionPolicyEngine.d.ts +89 -53
- package/dist/lib/policy/actionPolicyEngine.d.ts.map +1 -1
- package/dist/lib/policy/actionPolicyEngine.js +373 -212
- package/dist/lib/policy/actionPolicyEngine.js.map +1 -1
- package/dist/lib/policy/agentPolicy.d.ts +29 -0
- package/dist/lib/policy/agentPolicy.d.ts.map +1 -0
- package/dist/lib/policy/agentPolicy.js +154 -0
- package/dist/lib/policy/agentPolicy.js.map +1 -0
- package/dist/lib/policy/policyPresets.d.ts +30 -0
- package/dist/lib/policy/policyPresets.d.ts.map +1 -0
- package/dist/lib/policy/policyPresets.js +124 -0
- package/dist/lib/policy/policyPresets.js.map +1 -0
- package/dist/lib/policy/writeExecutionGate.d.ts +23 -0
- package/dist/lib/policy/writeExecutionGate.d.ts.map +1 -0
- package/dist/lib/policy/writeExecutionGate.js +65 -0
- package/dist/lib/policy/writeExecutionGate.js.map +1 -0
- package/dist/lib/preparedTxStore.d.ts +21 -0
- package/dist/lib/preparedTxStore.d.ts.map +1 -0
- package/dist/lib/preparedTxStore.js +90 -0
- package/dist/lib/preparedTxStore.js.map +1 -0
- package/dist/lib/price/chainlinkPushProvider.d.ts +34 -0
- package/dist/lib/price/chainlinkPushProvider.d.ts.map +1 -0
- package/dist/lib/price/chainlinkPushProvider.js +36 -0
- package/dist/lib/price/chainlinkPushProvider.js.map +1 -0
- package/dist/lib/price/feedRegistry.d.ts +26 -0
- package/dist/lib/price/feedRegistry.d.ts.map +1 -0
- package/dist/lib/price/feedRegistry.js +67 -0
- package/dist/lib/price/feedRegistry.js.map +1 -0
- package/dist/lib/price/priceResolver.d.ts +35 -0
- package/dist/lib/price/priceResolver.d.ts.map +1 -0
- package/dist/lib/price/priceResolver.js +246 -0
- package/dist/lib/price/priceResolver.js.map +1 -0
- package/dist/lib/price/supraProvider.d.ts +9 -0
- package/dist/lib/price/supraProvider.d.ts.map +1 -0
- package/dist/lib/price/supraProvider.js +17 -0
- package/dist/lib/price/supraProvider.js.map +1 -0
- package/dist/lib/price/types.d.ts +67 -0
- package/dist/lib/price/types.d.ts.map +1 -0
- package/dist/lib/price/types.js +7 -0
- package/dist/lib/price/types.js.map +1 -0
- package/dist/lib/productionGuards.d.ts +16 -0
- package/dist/lib/productionGuards.d.ts.map +1 -0
- package/dist/lib/productionGuards.js +93 -0
- package/dist/lib/productionGuards.js.map +1 -0
- package/dist/lib/recipientSafety.d.ts +5 -0
- package/dist/lib/recipientSafety.d.ts.map +1 -0
- package/dist/lib/recipientSafety.js +28 -0
- package/dist/lib/recipientSafety.js.map +1 -0
- package/dist/lib/riskEngine.d.ts +45 -26
- package/dist/lib/riskEngine.d.ts.map +1 -1
- package/dist/lib/riskEngine.js +346 -283
- package/dist/lib/riskEngine.js.map +1 -1
- package/dist/lib/riskInclusion.d.ts +72 -0
- package/dist/lib/riskInclusion.d.ts.map +1 -0
- package/dist/lib/riskInclusion.js +252 -0
- package/dist/lib/riskInclusion.js.map +1 -0
- package/dist/lib/safeHandsRegistry.d.ts +32 -0
- package/dist/lib/safeHandsRegistry.d.ts.map +1 -0
- package/dist/lib/safeHandsRegistry.js +151 -0
- package/dist/lib/safeHandsRegistry.js.map +1 -0
- package/dist/lib/signer/index.d.ts +24 -24
- package/dist/lib/signer/index.d.ts.map +1 -1
- package/dist/lib/signer/index.js +110 -88
- package/dist/lib/signer/index.js.map +1 -1
- package/dist/lib/spendAccumulator.d.ts +24 -1
- package/dist/lib/spendAccumulator.d.ts.map +1 -1
- package/dist/lib/spendAccumulator.js +76 -6
- package/dist/lib/spendAccumulator.js.map +1 -1
- package/dist/lib/toolResponse.d.ts +30 -25
- package/dist/lib/toolResponse.d.ts.map +1 -1
- package/dist/lib/toolResponse.js +57 -53
- package/dist/lib/toolResponse.js.map +1 -1
- package/dist/lib/validation.d.ts +7 -0
- package/dist/lib/validation.d.ts.map +1 -0
- package/dist/lib/validation.js +62 -0
- package/dist/lib/validation.js.map +1 -0
- package/dist/lib/wallet/index.d.ts +33 -37
- package/dist/lib/wallet/index.d.ts.map +1 -1
- package/dist/lib/wallet/index.js +141 -128
- package/dist/lib/wallet/index.js.map +1 -1
- package/dist/lib/x402ReplayStore.d.ts +6 -0
- package/dist/lib/x402ReplayStore.d.ts.map +1 -0
- package/dist/lib/x402ReplayStore.js +79 -0
- package/dist/lib/x402ReplayStore.js.map +1 -0
- package/dist/safehands.zip +0 -0
- package/dist/sdk.d.ts +14 -0
- package/dist/sdk.d.ts.map +1 -0
- package/dist/sdk.js +25 -0
- package/dist/sdk.js.map +1 -0
- package/dist/tools/approveToken.d.ts +66 -45
- package/dist/tools/approveToken.d.ts.map +1 -1
- package/dist/tools/approveToken.js +152 -85
- package/dist/tools/approveToken.js.map +1 -1
- package/dist/tools/assessRisk.d.ts +66 -79
- package/dist/tools/assessRisk.d.ts.map +1 -1
- package/dist/tools/assessRisk.js +63 -104
- package/dist/tools/assessRisk.js.map +1 -1
- package/dist/tools/checkAllowance.d.ts +49 -43
- package/dist/tools/checkAllowance.d.ts.map +1 -1
- package/dist/tools/checkAllowance.js +78 -56
- package/dist/tools/checkAllowance.js.map +1 -1
- package/dist/tools/checkTokenSecurity.d.ts +103 -46
- package/dist/tools/checkTokenSecurity.d.ts.map +1 -1
- package/dist/tools/checkTokenSecurity.js +240 -95
- package/dist/tools/checkTokenSecurity.js.map +1 -1
- package/dist/tools/createAgentWallet.d.ts +30 -26
- package/dist/tools/createAgentWallet.d.ts.map +1 -1
- package/dist/tools/createAgentWallet.js +87 -58
- package/dist/tools/createAgentWallet.js.map +1 -1
- package/dist/tools/estimateGas.d.ts +84 -79
- package/dist/tools/estimateGas.d.ts.map +1 -1
- package/dist/tools/estimateGas.js +130 -124
- package/dist/tools/estimateGas.js.map +1 -1
- package/dist/tools/executeSwap.d.ts +109 -61
- package/dist/tools/executeSwap.d.ts.map +1 -1
- package/dist/tools/executeSwap.js +289 -141
- package/dist/tools/executeSwap.js.map +1 -1
- package/dist/tools/explainRisk.d.ts +29 -29
- package/dist/tools/explainRisk.d.ts.map +1 -1
- package/dist/tools/explainRisk.js +33 -32
- package/dist/tools/explainRisk.js.map +1 -1
- package/dist/tools/getAgentPolicy.d.ts +15 -0
- package/dist/tools/getAgentPolicy.d.ts.map +1 -0
- package/dist/tools/getAgentPolicy.js +16 -0
- package/dist/tools/getAgentPolicy.js.map +1 -0
- package/dist/tools/getAgentReputation.d.ts +31 -0
- package/dist/tools/getAgentReputation.d.ts.map +1 -0
- package/dist/tools/getAgentReputation.js +44 -0
- package/dist/tools/getAgentReputation.js.map +1 -0
- package/dist/tools/getAgentWallet.d.ts +21 -21
- package/dist/tools/getAgentWallet.d.ts.map +1 -1
- package/dist/tools/getAgentWallet.js +37 -27
- package/dist/tools/getAgentWallet.js.map +1 -1
- package/dist/tools/getAgentWalletBalance.d.ts +11 -11
- package/dist/tools/getAgentWalletBalance.d.ts.map +1 -1
- package/dist/tools/getAgentWalletBalance.js +102 -70
- package/dist/tools/getAgentWalletBalance.js.map +1 -1
- package/dist/tools/getExecutionHistory.d.ts +49 -49
- package/dist/tools/getExecutionHistory.d.ts.map +1 -1
- package/dist/tools/getExecutionHistory.js +148 -154
- package/dist/tools/getExecutionHistory.js.map +1 -1
- package/dist/tools/getGasPrice.d.ts +43 -43
- package/dist/tools/getGasPrice.d.ts.map +0 -0
- package/dist/tools/getGasPrice.js +59 -59
- package/dist/tools/getGasPrice.js.map +1 -1
- package/dist/tools/getPoolInfo.d.ts +75 -75
- package/dist/tools/getPoolInfo.d.ts.map +1 -1
- package/dist/tools/getPoolInfo.js +142 -137
- package/dist/tools/getPoolInfo.js.map +1 -1
- package/dist/tools/getSpvProof.d.ts +24 -0
- package/dist/tools/getSpvProof.d.ts.map +1 -0
- package/dist/tools/getSpvProof.js +64 -0
- package/dist/tools/getSpvProof.js.map +1 -0
- package/dist/tools/getTokenPrice.d.ts +56 -113
- package/dist/tools/getTokenPrice.d.ts.map +1 -1
- package/dist/tools/getTokenPrice.js +110 -117
- package/dist/tools/getTokenPrice.js.map +1 -1
- package/dist/tools/getTransactionStatus.d.ts +43 -43
- package/dist/tools/getTransactionStatus.d.ts.map +0 -0
- package/dist/tools/getTransactionStatus.js +59 -59
- package/dist/tools/getTransactionStatus.js.map +0 -0
- package/dist/tools/getWalletBalance.d.ts +103 -68
- package/dist/tools/getWalletBalance.d.ts.map +1 -1
- package/dist/tools/getWalletBalance.js +127 -87
- package/dist/tools/getWalletBalance.js.map +1 -1
- package/dist/tools/publishRiskScore.d.ts +85 -63
- package/dist/tools/publishRiskScore.d.ts.map +1 -1
- package/dist/tools/publishRiskScore.js +136 -88
- package/dist/tools/publishRiskScore.js.map +1 -1
- package/dist/tools/queryGoldsky.d.ts +20 -0
- package/dist/tools/queryGoldsky.d.ts.map +1 -0
- package/dist/tools/queryGoldsky.js +29 -0
- package/dist/tools/queryGoldsky.js.map +1 -0
- package/dist/tools/queryRiskRegistry.d.ts +38 -38
- package/dist/tools/queryRiskRegistry.d.ts.map +1 -1
- package/dist/tools/queryRiskRegistry.js +59 -55
- package/dist/tools/queryRiskRegistry.js.map +1 -1
- package/dist/tools/safehandsPreflightCheck.d.ts +92 -77
- package/dist/tools/safehandsPreflightCheck.d.ts.map +1 -1
- package/dist/tools/safehandsPreflightCheck.js +174 -47
- package/dist/tools/safehandsPreflightCheck.js.map +1 -1
- package/dist/tools/safehandsRiskReport.d.ts +96 -81
- package/dist/tools/safehandsRiskReport.d.ts.map +1 -1
- package/dist/tools/safehandsRiskReport.js +48 -28
- package/dist/tools/safehandsRiskReport.js.map +1 -1
- package/dist/tools/safehandsSafeExecute.d.ts +20 -20
- package/dist/tools/safehandsSafeExecute.d.ts.map +1 -1
- package/dist/tools/safehandsSafeExecute.js +164 -81
- package/dist/tools/safehandsSafeExecute.js.map +1 -1
- package/dist/tools/safehandsWalletHealth.d.ts +28 -14
- package/dist/tools/safehandsWalletHealth.d.ts.map +1 -1
- package/dist/tools/safehandsWalletHealth.js +145 -103
- package/dist/tools/safehandsWalletHealth.js.map +1 -1
- package/dist/tools/safehandsX402Preflight.d.ts +26 -26
- package/dist/tools/safehandsX402Preflight.d.ts.map +1 -1
- package/dist/tools/safehandsX402Preflight.js +86 -65
- package/dist/tools/safehandsX402Preflight.js.map +1 -1
- package/dist/tools/sendPayment.d.ts +63 -57
- package/dist/tools/sendPayment.d.ts.map +1 -1
- package/dist/tools/sendPayment.js +144 -117
- package/dist/tools/sendPayment.js.map +1 -1
- package/dist/tools/setAgentPolicy.d.ts +75 -0
- package/dist/tools/setAgentPolicy.d.ts.map +1 -0
- package/dist/tools/setAgentPolicy.js +80 -0
- package/dist/tools/setAgentPolicy.js.map +1 -0
- package/dist/tools/simulateTransaction.d.ts +64 -60
- package/dist/tools/simulateTransaction.d.ts.map +1 -1
- package/dist/tools/simulateTransaction.js +116 -83
- package/dist/tools/simulateTransaction.js.map +1 -1
- package/dist/tools/tokenRegistryStatus.d.ts +46 -26
- package/dist/tools/tokenRegistryStatus.d.ts.map +1 -1
- package/dist/tools/tokenRegistryStatus.js +126 -96
- package/dist/tools/tokenRegistryStatus.js.map +1 -1
- package/dist/tools/verifyRiskInclusion.d.ts +59 -0
- package/dist/tools/verifyRiskInclusion.d.ts.map +1 -0
- package/dist/tools/verifyRiskInclusion.js +40 -0
- package/dist/tools/verifyRiskInclusion.js.map +1 -0
- package/dist/tools/x402PayAndFetch.d.ts +87 -81
- package/dist/tools/x402PayAndFetch.d.ts.map +1 -1
- package/dist/tools/x402PayAndFetch.js +295 -152
- package/dist/tools/x402PayAndFetch.js.map +1 -1
- package/dist/worker.d.ts +3 -0
- package/dist/worker.d.ts.map +1 -0
- package/dist/worker.js +39 -0
- package/dist/worker.js.map +1 -0
- package/dist/x402Server.d.ts +1 -1
- package/dist/x402Server.d.ts.map +1 -1
- package/dist/x402Server.js +409 -252
- package/dist/x402Server.js.map +1 -1
- package/docs/REVIEWER_QUICKSTART.md +113 -0
- package/docs/SAFEHANDS_REVIEWER_DEMO_SCRIPT.md +228 -0
- package/package.json +130 -83
- package/contracts/RiskRegistry.json +0 -223
- package/contracts/RiskRegistry.sol +0 -58
- package/dist/lib/testDodoLive.d.ts +0 -2
- package/dist/lib/testDodoLive.d.ts.map +0 -1
- package/dist/lib/testDodoLive.js +0 -105
- package/dist/lib/testDodoLive.js.map +0 -1
- package/dist/lib/testLiveSafehands.d.ts +0 -2
- package/dist/lib/testLiveSafehands.d.ts.map +0 -1
- package/dist/lib/testLiveSafehands.js +0 -93
- package/dist/lib/testLiveSafehands.js.map +0 -1
- package/dist/lib/testRpc.d.ts +0 -2
- package/dist/lib/testRpc.d.ts.map +0 -1
- package/dist/lib/testRpc.js +0 -30
- package/dist/lib/testRpc.js.map +0 -1
- package/dist/lib/testRpcLive.d.ts +0 -2
- package/dist/lib/testRpcLive.d.ts.map +0 -1
- package/dist/lib/testRpcLive.js +0 -89
- package/dist/lib/testRpcLive.js.map +0 -1
- package/dist/lib/testTools.d.ts +0 -2
- package/dist/lib/testTools.d.ts.map +0 -1
- package/dist/lib/testTools.js +0 -398
- package/dist/lib/testTools.js.map +0 -1
- package/dist/lib/testX402Live.d.ts +0 -2
- package/dist/lib/testX402Live.d.ts.map +0 -1
- package/dist/lib/testX402Live.js +0 -160
- package/dist/lib/testX402Live.js.map +0 -1
- package/dist/scripts/checkDeploy.d.ts +0 -2
- package/dist/scripts/checkDeploy.d.ts.map +0 -1
- package/dist/scripts/checkDeploy.js +0 -25
- package/dist/scripts/checkDeploy.js.map +0 -1
- package/dist/scripts/deployRegistry.d.ts +0 -2
- package/dist/scripts/deployRegistry.d.ts.map +0 -1
- package/dist/scripts/deployRegistry.js +0 -101
- package/dist/scripts/deployRegistry.js.map +0 -1
- package/dist/scripts/testRegistry.d.ts +0 -2
- package/dist/scripts/testRegistry.d.ts.map +0 -1
- package/dist/scripts/testRegistry.js +0 -44
- package/dist/scripts/testRegistry.js.map +0 -1
- package/examples/dashboard/index.html +0 -337
- package/examples/pharos-skill-engine/SKILL.safehands.md +0 -85
- package/examples/pharos-skill-engine/assets/safehands/example-actions.json +0 -49
- package/examples/pharos-skill-engine/assets/safehands/policy-defaults.json +0 -11
- package/examples/pharos-skill-engine/references/safehands.md +0 -345
- package/examples/scenario-hack.ts +0 -38
- package/skill/SKILL.md +0 -133
- package/skill/assets/safehands/example-actions.json +0 -49
- package/skill/assets/safehands/policy-defaults.json +0 -11
- package/skill/references/safehands.md +0 -345
|
@@ -1,76 +1,76 @@
|
|
|
1
|
-
import { z } from "zod";
|
|
2
|
-
export declare const getPoolInfoSchema: z.ZodObject<{
|
|
3
|
-
tokenA: z.ZodEnum<["
|
|
4
|
-
tokenB: z.ZodEnum<["
|
|
5
|
-
}, "strip", z.ZodTypeAny, {
|
|
6
|
-
tokenA: "
|
|
7
|
-
tokenB: "
|
|
8
|
-
}, {
|
|
9
|
-
tokenA: "
|
|
10
|
-
tokenB: "
|
|
11
|
-
}>;
|
|
12
|
-
export type GetPoolInfoInput = z.input<typeof getPoolInfoSchema>;
|
|
13
|
-
export declare const getPoolInfoTool: {
|
|
14
|
-
name: string;
|
|
15
|
-
description: string;
|
|
16
|
-
inputSchema: z.ZodObject<{
|
|
17
|
-
tokenA: z.ZodEnum<["
|
|
18
|
-
tokenB: z.ZodEnum<["
|
|
19
|
-
}, "strip", z.ZodTypeAny, {
|
|
20
|
-
tokenA: "
|
|
21
|
-
tokenB: "
|
|
22
|
-
}, {
|
|
23
|
-
tokenA: "
|
|
24
|
-
tokenB: "
|
|
25
|
-
}>;
|
|
26
|
-
};
|
|
27
|
-
export declare function handleGetPoolInfo(raw: GetPoolInfoInput): Promise<import("../
|
|
28
|
-
pair: string;
|
|
29
|
-
available: boolean;
|
|
30
|
-
message: string;
|
|
31
|
-
source: string;
|
|
32
|
-
sourceStatus: string;
|
|
33
|
-
publicMode: boolean;
|
|
34
|
-
chainId: number;
|
|
35
|
-
environment: string;
|
|
36
|
-
isMainnet: boolean;
|
|
37
|
-
}> | import("../
|
|
38
|
-
pair: string;
|
|
39
|
-
available: boolean;
|
|
40
|
-
priceRatio: {
|
|
41
|
-
value: string;
|
|
42
|
-
unit: "
|
|
43
|
-
per: string;
|
|
44
|
-
} | null;
|
|
45
|
-
priceImpact: {
|
|
46
|
-
value: string;
|
|
47
|
-
unit: string;
|
|
48
|
-
};
|
|
49
|
-
pricePerFromToken: {
|
|
50
|
-
value: string;
|
|
51
|
-
unit: "
|
|
52
|
-
} | null;
|
|
53
|
-
pricePerToToken: {
|
|
54
|
-
value: string;
|
|
55
|
-
unit: "
|
|
56
|
-
} | null;
|
|
57
|
-
fee: {
|
|
58
|
-
value: string;
|
|
59
|
-
unit: string;
|
|
60
|
-
} | null;
|
|
61
|
-
liquidity: {
|
|
62
|
-
baseLiquidity: string;
|
|
63
|
-
quoteLiquidity: string;
|
|
64
|
-
poolType: string;
|
|
65
|
-
} | null;
|
|
66
|
-
poolListStatus: string;
|
|
67
|
-
source: string;
|
|
68
|
-
sourceStatus: string;
|
|
69
|
-
publicMode: boolean;
|
|
70
|
-
routeAvailable: boolean;
|
|
71
|
-
confidence: string;
|
|
72
|
-
chainId: number;
|
|
73
|
-
environment: string;
|
|
74
|
-
isMainnet: boolean;
|
|
75
|
-
}>>;
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const getPoolInfoSchema: z.ZodObject<{
|
|
3
|
+
tokenA: z.ZodEnum<["PROS", "USDC", "USDT"]>;
|
|
4
|
+
tokenB: z.ZodEnum<["PROS", "USDC", "USDT"]>;
|
|
5
|
+
}, "strip", z.ZodTypeAny, {
|
|
6
|
+
tokenA: "PROS" | "USDC" | "USDT";
|
|
7
|
+
tokenB: "PROS" | "USDC" | "USDT";
|
|
8
|
+
}, {
|
|
9
|
+
tokenA: "PROS" | "USDC" | "USDT";
|
|
10
|
+
tokenB: "PROS" | "USDC" | "USDT";
|
|
11
|
+
}>;
|
|
12
|
+
export type GetPoolInfoInput = z.input<typeof getPoolInfoSchema>;
|
|
13
|
+
export declare const getPoolInfoTool: {
|
|
14
|
+
name: string;
|
|
15
|
+
description: string;
|
|
16
|
+
inputSchema: z.ZodObject<{
|
|
17
|
+
tokenA: z.ZodEnum<["PROS", "USDC", "USDT"]>;
|
|
18
|
+
tokenB: z.ZodEnum<["PROS", "USDC", "USDT"]>;
|
|
19
|
+
}, "strip", z.ZodTypeAny, {
|
|
20
|
+
tokenA: "PROS" | "USDC" | "USDT";
|
|
21
|
+
tokenB: "PROS" | "USDC" | "USDT";
|
|
22
|
+
}, {
|
|
23
|
+
tokenA: "PROS" | "USDC" | "USDT";
|
|
24
|
+
tokenB: "PROS" | "USDC" | "USDT";
|
|
25
|
+
}>;
|
|
26
|
+
};
|
|
27
|
+
export declare function handleGetPoolInfo(raw: GetPoolInfoInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
|
|
28
|
+
pair: string;
|
|
29
|
+
available: boolean;
|
|
30
|
+
message: string;
|
|
31
|
+
source: string;
|
|
32
|
+
sourceStatus: string;
|
|
33
|
+
publicMode: boolean;
|
|
34
|
+
chainId: number;
|
|
35
|
+
environment: string;
|
|
36
|
+
isMainnet: boolean;
|
|
37
|
+
}> | import("../sdk.js").ToolSuccess<{
|
|
38
|
+
pair: string;
|
|
39
|
+
available: boolean;
|
|
40
|
+
priceRatio: {
|
|
41
|
+
value: string;
|
|
42
|
+
unit: "PROS" | "USDC" | "USDT";
|
|
43
|
+
per: string;
|
|
44
|
+
} | null;
|
|
45
|
+
priceImpact: {
|
|
46
|
+
value: string;
|
|
47
|
+
unit: string;
|
|
48
|
+
};
|
|
49
|
+
pricePerFromToken: {
|
|
50
|
+
value: string;
|
|
51
|
+
unit: "PROS" | "USDC" | "USDT";
|
|
52
|
+
} | null;
|
|
53
|
+
pricePerToToken: {
|
|
54
|
+
value: string;
|
|
55
|
+
unit: "PROS" | "USDC" | "USDT";
|
|
56
|
+
} | null;
|
|
57
|
+
fee: {
|
|
58
|
+
value: string;
|
|
59
|
+
unit: string;
|
|
60
|
+
} | null;
|
|
61
|
+
liquidity: {
|
|
62
|
+
baseLiquidity: string;
|
|
63
|
+
quoteLiquidity: string;
|
|
64
|
+
poolType: string;
|
|
65
|
+
} | null;
|
|
66
|
+
poolListStatus: string;
|
|
67
|
+
source: string;
|
|
68
|
+
sourceStatus: string;
|
|
69
|
+
publicMode: boolean;
|
|
70
|
+
routeAvailable: boolean;
|
|
71
|
+
confidence: string;
|
|
72
|
+
chainId: number;
|
|
73
|
+
environment: string;
|
|
74
|
+
isMainnet: boolean;
|
|
75
|
+
}>>;
|
|
76
76
|
//# sourceMappingURL=getPoolInfo.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"getPoolInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getPoolInfo.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAK3B,CAAC;AA4BF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"getPoolInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getPoolInfo.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAK3B,CAAC;AA4BF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAoFrB,MAAM;wBAAkB,MAAM;kBAAY,MAAM;;;;;;;;;;;IAwDvF"}
|
|
@@ -1,138 +1,143 @@
|
|
|
1
|
-
// ─── Tool: get_pool_info ───────────────────────────────────────────────
|
|
2
|
-
// Fetches DODO/FaroSwap route-derived liquidity info for a token pair on
|
|
3
|
-
// Pharos
|
|
4
|
-
// when DODO_API_KEY is not configured.
|
|
5
|
-
// ────────────────────────────────────────────────────────────────────────
|
|
6
|
-
import { z } from "zod";
|
|
7
|
-
import { resolveTokenAddress } from "../lib/dodoApi.js";
|
|
8
|
-
import { DODO_API_BASE, DODO_API_KEY, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
|
|
9
|
-
import { fetchWithTimeoutAndRetry } from "../lib/http.js";
|
|
10
|
-
import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
|
|
11
|
-
export const getPoolInfoSchema = z.object({
|
|
12
|
-
tokenA: z.enum(["
|
|
13
|
-
tokenB: z.enum(["
|
|
14
|
-
});
|
|
15
|
-
export const getPoolInfoTool = {
|
|
16
|
-
name: "get_pool_info",
|
|
17
|
-
description: "Fetch DODO/FaroSwap route-derived liquidity info for a token pair on Pharos
|
|
18
|
-
inputSchema: getPoolInfoSchema,
|
|
19
|
-
};
|
|
20
|
-
function addOptionalApiKey(url) {
|
|
21
|
-
const key = DODO_API_KEY?.trim();
|
|
22
|
-
if (!key)
|
|
23
|
-
return false;
|
|
24
|
-
url.searchParams.set("apikey", key);
|
|
25
|
-
return true;
|
|
26
|
-
}
|
|
27
|
-
function isAuthErrorStatus(status) {
|
|
28
|
-
return status === 401 || status === 403;
|
|
29
|
-
}
|
|
30
|
-
export async function handleGetPoolInfo(raw) {
|
|
31
|
-
const input = getPoolInfoSchema.parse(raw);
|
|
32
|
-
if (input.tokenA === input.tokenB) {
|
|
33
|
-
return fail("INVALID_PAIR", "Cannot query pool for identical tokens.", false, "get_pool_info");
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
routeUrl
|
|
44
|
-
routeUrl.searchParams.set("
|
|
45
|
-
routeUrl.searchParams.set("
|
|
46
|
-
routeUrl.searchParams.set("
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
const
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
const
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
1
|
+
// ─── Tool: get_pool_info ───────────────────────────────────────────────
|
|
2
|
+
// Fetches DODO/FaroSwap route-derived liquidity info for a token pair on
|
|
3
|
+
// Pharos Network. API key is optional: public mode is tried first
|
|
4
|
+
// when DODO_API_KEY is not configured.
|
|
5
|
+
// ────────────────────────────────────────────────────────────────────────
|
|
6
|
+
import { z } from "zod";
|
|
7
|
+
import { resolveTokenAddress, isDodoApiConfiguredForChain, DodoNotConfiguredError } from "../lib/dodoApi.js";
|
|
8
|
+
import { DODO_API_BASE, DODO_API_KEY, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET } from "../lib/constants.js";
|
|
9
|
+
import { fetchWithTimeoutAndRetry } from "../lib/http.js";
|
|
10
|
+
import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
|
|
11
|
+
export const getPoolInfoSchema = z.object({
|
|
12
|
+
tokenA: z.enum(["PROS", "USDC", "USDT"]).describe("First token in the pair"),
|
|
13
|
+
tokenB: z.enum(["PROS", "USDC", "USDT"]).describe("Second token in the pair"),
|
|
14
|
+
});
|
|
15
|
+
export const getPoolInfoTool = {
|
|
16
|
+
name: "get_pool_info",
|
|
17
|
+
description: "Fetch DODO/FaroSwap route-derived liquidity info for a token pair on Pharos Mainnet. API key is optional; public mode is attempted first.",
|
|
18
|
+
inputSchema: getPoolInfoSchema,
|
|
19
|
+
};
|
|
20
|
+
function addOptionalApiKey(url) {
|
|
21
|
+
const key = DODO_API_KEY?.trim();
|
|
22
|
+
if (!key)
|
|
23
|
+
return false;
|
|
24
|
+
url.searchParams.set("apikey", key);
|
|
25
|
+
return true;
|
|
26
|
+
}
|
|
27
|
+
function isAuthErrorStatus(status) {
|
|
28
|
+
return status === 401 || status === 403;
|
|
29
|
+
}
|
|
30
|
+
export async function handleGetPoolInfo(raw) {
|
|
31
|
+
const input = getPoolInfoSchema.parse(raw);
|
|
32
|
+
if (input.tokenA === input.tokenB) {
|
|
33
|
+
return fail("INVALID_PAIR", "Cannot query pool for identical tokens.", false, "get_pool_info");
|
|
34
|
+
}
|
|
35
|
+
// Same evidence gate as getDodoRoute: this tool queries the DODO route API
|
|
36
|
+
// directly, and that provider is unverified outside its supported chains.
|
|
37
|
+
if (!isDodoApiConfiguredForChain(CHAIN_ID)) {
|
|
38
|
+
return fail("SWAP_LIQUIDITY_NOT_CONFIGURED", new DodoNotConfiguredError(CHAIN_ID).message, false, "dodo_api");
|
|
39
|
+
}
|
|
40
|
+
try {
|
|
41
|
+
const addrA = resolveTokenAddress(input.tokenA);
|
|
42
|
+
const addrB = resolveTokenAddress(input.tokenB);
|
|
43
|
+
const routeUrl = new URL(`${DODO_API_BASE}/route-service/v2/widget/getdodoroute`);
|
|
44
|
+
routeUrl.searchParams.set("chainId", String(CHAIN_ID));
|
|
45
|
+
routeUrl.searchParams.set("fromTokenAddress", addrA);
|
|
46
|
+
routeUrl.searchParams.set("toTokenAddress", addrB);
|
|
47
|
+
routeUrl.searchParams.set("fromAmount", "1000000000000000000");
|
|
48
|
+
routeUrl.searchParams.set("userAddr", "0x0000000000000000000000000000000000000001");
|
|
49
|
+
routeUrl.searchParams.set("slippage", "3");
|
|
50
|
+
routeUrl.searchParams.set("source", "dodoV2AndMixWasm");
|
|
51
|
+
routeUrl.searchParams.set("estimateGas", "true");
|
|
52
|
+
const routeUsedApiKey = addOptionalApiKey(routeUrl);
|
|
53
|
+
const routeResponse = await fetchWithTimeoutAndRetry(routeUrl, { timeoutMs: 10_000, retries: 2, retryDelayMs: 300 });
|
|
54
|
+
if (isAuthErrorStatus(routeResponse.status)) {
|
|
55
|
+
return fail("DODO_API_AUTH_REQUIRED", "DODO/FaroSwap route API rejected public mode. Configure DODO_API_KEY only if this endpoint requires authenticated access.", false, "dodo_api");
|
|
56
|
+
}
|
|
57
|
+
if (!routeResponse.ok) {
|
|
58
|
+
return fail("DODO_API_UNAVAILABLE", `DODO route API returned ${routeResponse.status} ${routeResponse.statusText}.`, true, "dodo_api");
|
|
59
|
+
}
|
|
60
|
+
const routeJson = (await routeResponse.json());
|
|
61
|
+
if (!routeJson.data || routeJson.status !== 200) {
|
|
62
|
+
const msg = (routeJson.message || "").toLowerCase();
|
|
63
|
+
if (msg.includes("api key") || msg.includes("apikey") || msg.includes("unauthorized") || msg.includes("forbidden")) {
|
|
64
|
+
return fail("DODO_API_AUTH_REQUIRED", "DODO/FaroSwap route API rejected public mode. Configure DODO_API_KEY only if this endpoint requires authenticated access.", false, "dodo_api");
|
|
65
|
+
}
|
|
66
|
+
return ok({
|
|
67
|
+
pair: `${input.tokenA}/${input.tokenB}`,
|
|
68
|
+
available: false,
|
|
69
|
+
message: "No active DODO/FaroSwap route found for this pair on Pharos Mainnet.",
|
|
70
|
+
source: "DODO/FaroSwap public route API",
|
|
71
|
+
sourceStatus: "no_route_available",
|
|
72
|
+
publicMode: !routeUsedApiKey,
|
|
73
|
+
chainId: CHAIN_ID,
|
|
74
|
+
environment: PHAROS_ENVIRONMENT,
|
|
75
|
+
isMainnet: IS_MAINNET,
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
const d = routeJson.data;
|
|
79
|
+
const resAmount = parseFloat(String(d.resAmount || "0"));
|
|
80
|
+
const priceImpact = parseFloat(String(d.priceImpact || "0"));
|
|
81
|
+
const fee = parseFloat(String(d.baseFeeAmount || "0"));
|
|
82
|
+
const pricePerFrom = parseFloat(String(d.resPricePerFromToken || "0"));
|
|
83
|
+
const pricePerTo = parseFloat(String(d.resPricePerToToken || "0"));
|
|
84
|
+
let liquidityInfo = null;
|
|
85
|
+
let poolListStatus = "unavailable";
|
|
86
|
+
try {
|
|
87
|
+
const poolsUrl = new URL(`${DODO_API_BASE}/dodo-pair/list`);
|
|
88
|
+
poolsUrl.searchParams.set("chainId", String(CHAIN_ID));
|
|
89
|
+
poolsUrl.searchParams.set("baseToken", addrA);
|
|
90
|
+
poolsUrl.searchParams.set("quoteToken", addrB);
|
|
91
|
+
addOptionalApiKey(poolsUrl);
|
|
92
|
+
const poolsResp = await fetchWithTimeoutAndRetry(poolsUrl, { timeoutMs: 10_000, retries: 1, retryDelayMs: 300 });
|
|
93
|
+
if (poolsResp.ok) {
|
|
94
|
+
const poolsJson = (await poolsResp.json());
|
|
95
|
+
if (poolsJson.data?.list && poolsJson.data.list.length > 0) {
|
|
96
|
+
const pool = poolsJson.data.list[0];
|
|
97
|
+
liquidityInfo = {
|
|
98
|
+
baseLiquidity: pool.baseLiquidity || "unknown",
|
|
99
|
+
quoteLiquidity: pool.quoteLiquidity || "unknown",
|
|
100
|
+
poolType: pool.type || "unknown",
|
|
101
|
+
};
|
|
102
|
+
poolListStatus = "ok";
|
|
103
|
+
}
|
|
104
|
+
else {
|
|
105
|
+
poolListStatus = "empty";
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
else if (isAuthErrorStatus(poolsResp.status)) {
|
|
109
|
+
poolListStatus = "auth_required";
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
poolListStatus = "unavailable";
|
|
114
|
+
}
|
|
115
|
+
return ok({
|
|
116
|
+
pair: `${input.tokenA}/${input.tokenB}`,
|
|
117
|
+
available: true,
|
|
118
|
+
priceRatio: resAmount > 0 ? { value: resAmount.toString(), unit: input.tokenB, per: `1 ${input.tokenA}` } : null,
|
|
119
|
+
priceImpact: { value: priceImpact.toFixed(4), unit: "percent" },
|
|
120
|
+
pricePerFromToken: pricePerFrom > 0 ? { value: pricePerFrom.toFixed(6), unit: input.tokenB } : null,
|
|
121
|
+
pricePerToToken: pricePerTo > 0 ? { value: pricePerTo.toFixed(6), unit: input.tokenA } : null,
|
|
122
|
+
fee: fee > 0 ? { value: fee.toString(), unit: "raw" } : null,
|
|
123
|
+
liquidity: liquidityInfo,
|
|
124
|
+
poolListStatus,
|
|
125
|
+
source: "DODO/FaroSwap public route API",
|
|
126
|
+
sourceStatus: "ok",
|
|
127
|
+
publicMode: !routeUsedApiKey,
|
|
128
|
+
routeAvailable: true,
|
|
129
|
+
confidence: liquidityInfo ? "medium" : "low",
|
|
130
|
+
chainId: CHAIN_ID,
|
|
131
|
+
environment: PHAROS_ENVIRONMENT,
|
|
132
|
+
isMainnet: IS_MAINNET,
|
|
133
|
+
});
|
|
134
|
+
}
|
|
135
|
+
catch (err) {
|
|
136
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
137
|
+
if (message.includes("INVALID_TOKEN_ADDRESS")) {
|
|
138
|
+
return fail("INVALID_TOKEN_ADDRESS", message, false, "get_pool_info");
|
|
139
|
+
}
|
|
140
|
+
return classifyExternalError("dodo_api", err);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
138
143
|
//# sourceMappingURL=getPoolInfo.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"getPoolInfo.js","sourceRoot":"","sources":["../../src/tools/getPoolInfo.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,
|
|
1
|
+
{"version":3,"file":"getPoolInfo.js","sourceRoot":"","sources":["../../src/tools/getPoolInfo.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { type ToolResponse } from "../lib/toolResponse.js";
|
|
3
|
+
export declare const getSpvProofSchema: z.ZodObject<{
|
|
4
|
+
address: z.ZodString;
|
|
5
|
+
storageKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
6
|
+
blockTag: z.ZodDefault<z.ZodOptional<z.ZodString>>;
|
|
7
|
+
verifyTrustless: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
8
|
+
}, "strip", z.ZodTypeAny, {
|
|
9
|
+
address: string;
|
|
10
|
+
blockTag: string;
|
|
11
|
+
verifyTrustless: boolean;
|
|
12
|
+
storageKeys?: string[] | undefined;
|
|
13
|
+
}, {
|
|
14
|
+
address: string;
|
|
15
|
+
blockTag?: string | undefined;
|
|
16
|
+
storageKeys?: string[] | undefined;
|
|
17
|
+
verifyTrustless?: boolean | undefined;
|
|
18
|
+
}>;
|
|
19
|
+
export type GetSpvProofParams = z.infer<typeof getSpvProofSchema>;
|
|
20
|
+
/**
|
|
21
|
+
* Calls eth_getProof on Pharos and performs trustless SPV Verification using the hexary SHA-256 trie logic.
|
|
22
|
+
*/
|
|
23
|
+
export declare function handleGetSpvProof(params: GetSpvProofParams): Promise<ToolResponse<any>>;
|
|
24
|
+
//# sourceMappingURL=getSpvProof.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"getSpvProof.d.ts","sourceRoot":"","sources":["../../src/tools/getSpvProof.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,wBAAwB,CAAC;AAIrE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAoE7F"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { ok, fail } from "../lib/toolResponse.js";
|
|
3
|
+
import { publicClient } from "../lib/pharosClient.js";
|
|
4
|
+
import { verifyPharosSPV } from "../lib/pharos/spvVerifier.js";
|
|
5
|
+
export const getSpvProofSchema = z.object({
|
|
6
|
+
address: z.string().describe("The 20-byte hex address of the account to query (e.g. 0x...)."),
|
|
7
|
+
storageKeys: z.array(z.string()).optional().describe("Optional array of 32-byte hex storage keys to query."),
|
|
8
|
+
blockTag: z.string().optional().default("latest").describe("Block number in hex or 'latest'/'earliest'."),
|
|
9
|
+
verifyTrustless: z.boolean().optional().default(true).describe("If true, performs local Cryptographic SPV verification against the block's stateRoot."),
|
|
10
|
+
});
|
|
11
|
+
/**
|
|
12
|
+
* Calls eth_getProof on Pharos and performs trustless SPV Verification using the hexary SHA-256 trie logic.
|
|
13
|
+
*/
|
|
14
|
+
export async function handleGetSpvProof(params) {
|
|
15
|
+
try {
|
|
16
|
+
const keys = params.storageKeys || [];
|
|
17
|
+
// Fetch the proof from RPC
|
|
18
|
+
// Note: We use publicClient.request to call a custom/underlying RPC method
|
|
19
|
+
const rpcResponse = await publicClient.request({
|
|
20
|
+
method: "eth_getProof",
|
|
21
|
+
params: [params.address, keys, params.blockTag]
|
|
22
|
+
});
|
|
23
|
+
if (!rpcResponse) {
|
|
24
|
+
return fail("RPC_ERROR", "Failed to retrieve eth_getProof data.", true, "eth_getProof");
|
|
25
|
+
}
|
|
26
|
+
let verificationStatus = "not_verified";
|
|
27
|
+
if (params.verifyTrustless) {
|
|
28
|
+
try {
|
|
29
|
+
// Fetch the block header to get the trusted stateRoot
|
|
30
|
+
const block = await publicClient.getBlock({ blockTag: params.blockTag });
|
|
31
|
+
const stateRoot = block.stateRoot;
|
|
32
|
+
// Verify Account Proof
|
|
33
|
+
const accountValid = verifyPharosSPV(params.address, stateRoot, rpcResponse.isExist, rpcResponse.accountProof, rpcResponse.siblingLeftmostLeafProofs);
|
|
34
|
+
if (!accountValid) {
|
|
35
|
+
return fail("SPV_VERIFICATION_FAILED", "The Account SPV cryptographic proof could not be verified against the state root.", false, "spv_verifier");
|
|
36
|
+
}
|
|
37
|
+
verificationStatus = "cryptographically_verified_success";
|
|
38
|
+
}
|
|
39
|
+
catch (error) {
|
|
40
|
+
return fail("SPV_VERIFICATION_ERROR", `Failed during cryptographic SPV verification: ${error instanceof Error ? error.message : String(error)}`, false, "spv_verifier");
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
return ok({
|
|
44
|
+
verified: verificationStatus === "cryptographically_verified_success",
|
|
45
|
+
verificationStatus,
|
|
46
|
+
isExist: rpcResponse.isExist,
|
|
47
|
+
balance: rpcResponse.balance,
|
|
48
|
+
nonce: rpcResponse.nonce,
|
|
49
|
+
storageHash: rpcResponse.storageHash,
|
|
50
|
+
// For brevity, we don't return the raw hexproof arrays to the AI to avoid max context length issues,
|
|
51
|
+
// since the AI only cares if it's verified and what the values are.
|
|
52
|
+
accountDataVerified: true,
|
|
53
|
+
storageValues: rpcResponse.storageProof ? rpcResponse.storageProof.map(sp => ({
|
|
54
|
+
key: sp.key,
|
|
55
|
+
value: sp.value,
|
|
56
|
+
isExist: sp.isExist
|
|
57
|
+
})) : []
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
catch (error) {
|
|
61
|
+
return fail("ETH_GET_PROOF_FAILED", `Failed to execute eth_getProof: ${error instanceof Error ? error.message : String(error)}`, true, "eth_getProof");
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=getSpvProof.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"getSpvProof.js","sourceRoot":"","sources":["../../src/tools/getSpvProof.ts"],"names":[],"mappings":"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"}
|