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.
- package/.agents/policies/default.json +15 -0
- package/.env.example +81 -64
- package/README.md +301 -444
- 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 +1 -1
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +29 -1
- 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 +0 -0
- package/dist/demo.d.ts.map +1 -1
- package/dist/demo.js +43 -8
- package/dist/demo.js.map +1 -1
- package/dist/index.d.ts +0 -0
- package/dist/index.d.ts.map +0 -0
- package/dist/index.js +212 -135
- package/dist/index.js.map +1 -1
- package/dist/init.d.ts +0 -0
- package/dist/init.d.ts.map +1 -1
- package/dist/init.js +72 -10
- 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 +246 -97
- package/dist/lib/constants.d.ts.map +1 -1
- package/dist/lib/constants.js +334 -127
- package/dist/lib/constants.js.map +1 -1
- package/dist/lib/dodoApi.d.ts +26 -3
- package/dist/lib/dodoApi.d.ts.map +1 -1
- package/dist/lib/dodoApi.js +80 -17
- 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 +0 -0
- package/dist/lib/envLoader.d.ts.map +0 -0
- package/dist/lib/envLoader.js +39 -18
- package/dist/lib/envLoader.js.map +1 -1
- 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 +0 -1
- package/dist/lib/http.d.ts.map +1 -1
- package/dist/lib/http.js +297 -32
- 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 +5 -10
- package/dist/lib/pharosClient.d.ts.map +1 -1
- package/dist/lib/pharosClient.js +9 -16
- package/dist/lib/pharosClient.js.map +1 -1
- package/dist/lib/policy/actionPolicyEngine.d.ts +37 -1
- package/dist/lib/policy/actionPolicyEngine.d.ts.map +1 -1
- package/dist/lib/policy/actionPolicyEngine.js +213 -52
- 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 +19 -0
- package/dist/lib/riskEngine.d.ts.map +1 -1
- package/dist/lib/riskEngine.js +94 -36
- 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 +3 -3
- package/dist/lib/signer/index.d.ts.map +1 -1
- package/dist/lib/signer/index.js +33 -11
- 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 +6 -1
- package/dist/lib/toolResponse.d.ts.map +1 -1
- package/dist/lib/toolResponse.js +13 -9
- 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 +8 -12
- package/dist/lib/wallet/index.d.ts.map +1 -1
- package/dist/lib/wallet/index.js +48 -35
- 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 +31 -10
- package/dist/tools/approveToken.d.ts.map +1 -1
- package/dist/tools/approveToken.js +91 -24
- package/dist/tools/approveToken.js.map +1 -1
- package/dist/tools/assessRisk.d.ts +13 -26
- package/dist/tools/assessRisk.d.ts.map +1 -1
- package/dist/tools/assessRisk.js +34 -75
- package/dist/tools/assessRisk.js.map +1 -1
- package/dist/tools/checkAllowance.d.ts +9 -3
- package/dist/tools/checkAllowance.d.ts.map +1 -1
- package/dist/tools/checkAllowance.js +27 -5
- package/dist/tools/checkAllowance.js.map +1 -1
- package/dist/tools/checkTokenSecurity.d.ts +62 -5
- package/dist/tools/checkTokenSecurity.d.ts.map +1 -1
- package/dist/tools/checkTokenSecurity.js +166 -21
- package/dist/tools/checkTokenSecurity.js.map +1 -1
- package/dist/tools/createAgentWallet.d.ts +4 -2
- package/dist/tools/createAgentWallet.d.ts.map +1 -1
- package/dist/tools/createAgentWallet.js +36 -31
- package/dist/tools/createAgentWallet.js.map +1 -1
- package/dist/tools/estimateGas.d.ts +7 -2
- package/dist/tools/estimateGas.d.ts.map +1 -1
- package/dist/tools/estimateGas.js +16 -10
- package/dist/tools/estimateGas.js.map +1 -1
- package/dist/tools/executeSwap.d.ts +56 -8
- package/dist/tools/executeSwap.d.ts.map +1 -1
- package/dist/tools/executeSwap.js +194 -46
- package/dist/tools/executeSwap.js.map +1 -1
- package/dist/tools/explainRisk.d.ts +9 -9
- package/dist/tools/explainRisk.d.ts.map +1 -1
- package/dist/tools/explainRisk.js +5 -4
- 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 +1 -1
- package/dist/tools/getAgentWallet.d.ts.map +1 -1
- package/dist/tools/getAgentWallet.js +11 -1
- package/dist/tools/getAgentWallet.js.map +1 -1
- package/dist/tools/getAgentWalletBalance.d.ts +1 -1
- package/dist/tools/getAgentWalletBalance.d.ts.map +1 -1
- package/dist/tools/getAgentWalletBalance.js +58 -26
- package/dist/tools/getAgentWalletBalance.js.map +1 -1
- package/dist/tools/getExecutionHistory.d.ts +1 -1
- package/dist/tools/getExecutionHistory.d.ts.map +1 -1
- package/dist/tools/getExecutionHistory.js +13 -19
- package/dist/tools/getExecutionHistory.js.map +1 -1
- package/dist/tools/getGasPrice.d.ts +3 -3
- package/dist/tools/getGasPrice.d.ts.map +0 -0
- package/dist/tools/getGasPrice.js +7 -7
- package/dist/tools/getGasPrice.js.map +1 -1
- package/dist/tools/getPoolInfo.d.ts +17 -17
- package/dist/tools/getPoolInfo.d.ts.map +1 -1
- package/dist/tools/getPoolInfo.js +14 -9
- 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 +28 -85
- package/dist/tools/getTokenPrice.d.ts.map +1 -1
- package/dist/tools/getTokenPrice.js +87 -94
- package/dist/tools/getTokenPrice.js.map +1 -1
- package/dist/tools/getTransactionStatus.d.ts +2 -2
- package/dist/tools/getTransactionStatus.d.ts.map +0 -0
- package/dist/tools/getTransactionStatus.js +0 -0
- package/dist/tools/getTransactionStatus.js.map +0 -0
- package/dist/tools/getWalletBalance.d.ts +38 -3
- package/dist/tools/getWalletBalance.d.ts.map +1 -1
- package/dist/tools/getWalletBalance.js +92 -52
- package/dist/tools/getWalletBalance.js.map +1 -1
- package/dist/tools/publishRiskScore.d.ts +36 -14
- package/dist/tools/publishRiskScore.d.ts.map +1 -1
- package/dist/tools/publishRiskScore.js +80 -32
- 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 +14 -14
- package/dist/tools/queryRiskRegistry.d.ts.map +1 -1
- package/dist/tools/queryRiskRegistry.js +34 -30
- package/dist/tools/queryRiskRegistry.js.map +1 -1
- package/dist/tools/safehandsPreflightCheck.d.ts +29 -14
- package/dist/tools/safehandsPreflightCheck.d.ts.map +1 -1
- package/dist/tools/safehandsPreflightCheck.js +133 -6
- package/dist/tools/safehandsPreflightCheck.js.map +1 -1
- package/dist/tools/safehandsRiskReport.d.ts +29 -14
- package/dist/tools/safehandsRiskReport.d.ts.map +1 -1
- package/dist/tools/safehandsRiskReport.js +23 -3
- package/dist/tools/safehandsRiskReport.js.map +1 -1
- package/dist/tools/safehandsSafeExecute.d.ts +1 -1
- package/dist/tools/safehandsSafeExecute.d.ts.map +1 -1
- package/dist/tools/safehandsSafeExecute.js +100 -17
- package/dist/tools/safehandsSafeExecute.js.map +1 -1
- package/dist/tools/safehandsWalletHealth.d.ts +15 -1
- package/dist/tools/safehandsWalletHealth.d.ts.map +1 -1
- package/dist/tools/safehandsWalletHealth.js +67 -25
- package/dist/tools/safehandsWalletHealth.js.map +1 -1
- package/dist/tools/safehandsX402Preflight.d.ts +3 -3
- package/dist/tools/safehandsX402Preflight.d.ts.map +1 -1
- package/dist/tools/safehandsX402Preflight.js +24 -3
- package/dist/tools/safehandsX402Preflight.js.map +1 -1
- package/dist/tools/sendPayment.d.ts +10 -4
- package/dist/tools/sendPayment.d.ts.map +1 -1
- package/dist/tools/sendPayment.js +63 -36
- 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 +7 -3
- package/dist/tools/simulateTransaction.d.ts.map +1 -1
- package/dist/tools/simulateTransaction.js +42 -9
- package/dist/tools/simulateTransaction.js.map +1 -1
- package/dist/tools/tokenRegistryStatus.d.ts +25 -5
- package/dist/tools/tokenRegistryStatus.d.ts.map +1 -1
- package/dist/tools/tokenRegistryStatus.js +61 -31
- 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 +15 -9
- package/dist/tools/x402PayAndFetch.d.ts.map +1 -1
- package/dist/tools/x402PayAndFetch.js +163 -20
- 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 +144 -35
- 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 -73
- 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 -397
- 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
|
@@ -1,55 +1,111 @@
|
|
|
1
1
|
// ─── Tool: approve_token ───────────────────────────────────────────────
|
|
2
|
-
// Approves ERC-20 token spending for
|
|
2
|
+
// Approves ERC-20 token spending for an EXPLICIT, caller-provided spender.
|
|
3
|
+
// There is no default spender: the former DODO_APPROVE_ADDRESS default silently
|
|
4
|
+
// approved a testnet-provenance address on mainnet while stamping
|
|
5
|
+
// spenderVerified:true — a fabricated claim. Spender verification now comes
|
|
6
|
+
// only from the ecosystem registry (addressTrustEvidence); anything else is an
|
|
7
|
+
// unverified claim and the policy engine requires explicit confirmation.
|
|
3
8
|
// ────────────────────────────────────────────────────────────────────────
|
|
4
9
|
import { z } from "zod";
|
|
10
|
+
import { isAddress } from "viem";
|
|
5
11
|
import { publicClient, createPharosWalletClientFromAccount, getExplorerUrl } from "../lib/pharosClient.js";
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
12
|
+
import { ERC20_ABI, MAX_APPROVAL_AMOUNT_USDC, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, activeTokenMap, activeTokenDecimals } from "../lib/constants.js";
|
|
13
|
+
import { addressTrustEvidence } from "../lib/ecosystemRegistry.js";
|
|
14
|
+
import { toWei } from "../lib/dodoApi.js";
|
|
8
15
|
import { fail, ok, classifyExternalError } from "../lib/toolResponse.js";
|
|
9
|
-
import {
|
|
16
|
+
import { requireManagedExecutionReady, isManagedExecutionFailure } from "../lib/managedExecution.js";
|
|
10
17
|
import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
|
|
18
|
+
import { enforceWriteDecision } from "../lib/policy/writeExecutionGate.js";
|
|
19
|
+
import { evaluateTokenSecurityGate } from "./checkTokenSecurity.js";
|
|
20
|
+
import { validatePositiveAmount } from "../lib/validation.js";
|
|
11
21
|
export const approveTokenSchema = z.object({
|
|
12
22
|
token: z.enum(["USDC", "USDT"]).describe("ERC-20 token to approve"),
|
|
13
23
|
amount: z.string().describe("Human-readable amount to approve, or 'max' for unlimited"),
|
|
14
|
-
|
|
15
|
-
|
|
24
|
+
spender: z.string().describe("EXPLICIT spender contract address to approve (0x…). There is no default spender; SafeHands never picks one for you. Verification is derived from the ecosystem registry; unverified spenders require confirm=true."),
|
|
25
|
+
agentId: z.string().optional().describe("Managed wallet agentId when WALLET_MODE=managed-mainnet"),
|
|
26
|
+
confirm: z.boolean().optional().default(false).describe("Explicit acknowledgement to proceed when SafeHands returns REQUIRE_CONFIRMATION / REQUIRE_TOKEN_REVIEW. Hard BLOCK / honeypot / unlimited / over-limit are never overridable."),
|
|
27
|
+
}).strict();
|
|
16
28
|
export const approveTokenTool = {
|
|
17
29
|
name: "approve_token",
|
|
18
|
-
description: "Approve ERC-20 token spending for
|
|
30
|
+
description: "Approve ERC-20 token spending for an explicit spender address you provide. Spender trust is derived from the SafeHands ecosystem registry (never asserted blindly); approvals to unverified spenders require explicit confirmation, and unlimited approvals are blocked by default. Gated by WRITE_TOOLS_ENABLED.",
|
|
19
31
|
inputSchema: approveTokenSchema,
|
|
20
32
|
};
|
|
33
|
+
function resolveApprovalToken(symbol) {
|
|
34
|
+
const map = activeTokenMap();
|
|
35
|
+
const decimals = activeTokenDecimals();
|
|
36
|
+
const tokenAddress = map[symbol];
|
|
37
|
+
if (!tokenAddress) {
|
|
38
|
+
return null;
|
|
39
|
+
}
|
|
40
|
+
return {
|
|
41
|
+
tokenAddress,
|
|
42
|
+
decimals: decimals[symbol] ?? decimals[tokenAddress.toLowerCase()] ?? 18,
|
|
43
|
+
};
|
|
44
|
+
}
|
|
21
45
|
export async function handleApproveToken(raw) {
|
|
22
|
-
|
|
23
|
-
|
|
46
|
+
let input;
|
|
47
|
+
try {
|
|
48
|
+
input = approveTokenSchema.parse(raw);
|
|
49
|
+
}
|
|
50
|
+
catch (err) {
|
|
51
|
+
const msg = err instanceof z.ZodError
|
|
52
|
+
? err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
|
|
53
|
+
: String(err);
|
|
54
|
+
return fail("VALIDATION_ERROR", `approve_token input validation failed: ${msg}`, false, "approve_token");
|
|
55
|
+
}
|
|
56
|
+
if (input.amount !== "max") {
|
|
57
|
+
const amtErr = validatePositiveAmount(input.amount, "amount");
|
|
58
|
+
if (amtErr)
|
|
59
|
+
return fail("VALIDATION_ERROR", amtErr, false, "approve_token");
|
|
60
|
+
}
|
|
61
|
+
if (!isAddress(input.spender)) {
|
|
62
|
+
return fail("VALIDATION_ERROR", `spender must be a valid EVM address (got "${input.spender}").`, false, "approve_token");
|
|
63
|
+
}
|
|
64
|
+
const spender = input.spender;
|
|
65
|
+
// Registry-derived trust — the ONLY source of a spenderVerified assertion.
|
|
66
|
+
// Not verified ⇒ pass undefined so the policy engine treats the spender as an
|
|
67
|
+
// unverified claim (spender_reputation: unknown → REQUIRE_CONFIRMATION).
|
|
68
|
+
const spenderEvidence = addressTrustEvidence(spender, CHAIN_ID);
|
|
69
|
+
const resolved = resolveApprovalToken(input.token);
|
|
70
|
+
if (!resolved) {
|
|
71
|
+
return fail("UNSUPPORTED_TOKEN", `${input.token} is not configured for ${PHAROS_ENVIRONMENT} (${CHAIN_ID}). Use a supported active-network token such as USDC, or add a verified ${input.token} address before approving.`, false, "approve_token");
|
|
24
72
|
}
|
|
25
|
-
const
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
73
|
+
const gate = await requireManagedExecutionReady("approve_token", input.agentId);
|
|
74
|
+
if (isManagedExecutionFailure(gate))
|
|
75
|
+
return gate;
|
|
76
|
+
const { signer } = gate;
|
|
77
|
+
// Consult token-security (GoPlus) on the token being approved. Honeypot /
|
|
78
|
+
// extreme-tax → hard block; flagged/unavailable → REQUIRE_TOKEN_REVIEW.
|
|
79
|
+
const sec = await evaluateTokenSecurityGate(resolved.tokenAddress);
|
|
80
|
+
if (sec.verdict === "block") {
|
|
81
|
+
return fail("TOKEN_SECURITY_BLOCKED", `Approval blocked: ${sec.detail ?? "token failed security review"} ${sec.flags.join("; ")}`.trim(), false, "approve_token");
|
|
29
82
|
}
|
|
30
83
|
const policy = evaluateActionPolicy({
|
|
31
84
|
actionType: "approve_token",
|
|
85
|
+
agentId: input.agentId,
|
|
32
86
|
approvalAmount: input.amount,
|
|
33
87
|
approvalToken: input.token,
|
|
34
88
|
approvalUnlimited: input.amount === "max",
|
|
35
|
-
|
|
36
|
-
|
|
89
|
+
tokenSecurityStatus: sec.policyStatus,
|
|
90
|
+
spender,
|
|
91
|
+
spenderVerified: spenderEvidence.verifiedCanonical ? true : undefined,
|
|
37
92
|
chainId: CHAIN_ID,
|
|
38
93
|
environment: PHAROS_ENVIRONMENT,
|
|
39
|
-
isMainnet:
|
|
94
|
+
isMainnet: IS_MAINNET,
|
|
40
95
|
signerAvailable: true,
|
|
41
96
|
requiresSigner: true,
|
|
42
97
|
allowUnlimitedApproval: process.env.ALLOW_UNLIMITED_APPROVAL === "true",
|
|
43
98
|
});
|
|
44
|
-
if (policy.decision === "BLOCK") {
|
|
45
|
-
|
|
46
|
-
return fail(code, policy.reasons.join(" ") || "Approval blocked by SafeHands policy.", false, "approve_token");
|
|
99
|
+
if (policy.decision === "BLOCK" && input.amount === "max") {
|
|
100
|
+
return fail("UNLIMITED_APPROVAL_BLOCKED", policy.reasons.join(" ") || "Unlimited approval blocked by SafeHands policy.", false, "approve_token");
|
|
47
101
|
}
|
|
102
|
+
const approvalGate = enforceWriteDecision(policy, { confirmed: input.confirm === true, toolName: "approve_token" });
|
|
103
|
+
if (approvalGate)
|
|
104
|
+
return approvalGate;
|
|
48
105
|
if (input.amount !== "max" && Number(input.amount) > Number(MAX_APPROVAL_AMOUNT_USDC)) {
|
|
49
|
-
return fail("APPROVAL_LIMIT_EXCEEDED", `Approval amount exceeds
|
|
106
|
+
return fail("APPROVAL_LIMIT_EXCEEDED", `Approval amount exceeds the operator ceiling MAX_APPROVAL_AMOUNT_USDC (${MAX_APPROVAL_AMOUNT_USDC}), which bounds all agent policies. Raise MAX_APPROVAL_AMOUNT_USDC to allow larger mainnet approvals.`, false, "approve_token");
|
|
50
107
|
}
|
|
51
|
-
const tokenAddress
|
|
52
|
-
const decimals = resolveTokenDecimals(input.token);
|
|
108
|
+
const { tokenAddress, decimals } = resolved;
|
|
53
109
|
const approveAmount = input.amount === "max"
|
|
54
110
|
? 2n ** 256n - 1n
|
|
55
111
|
: BigInt(toWei(input.amount, decimals));
|
|
@@ -59,7 +115,7 @@ export async function handleApproveToken(raw) {
|
|
|
59
115
|
address: tokenAddress,
|
|
60
116
|
abi: ERC20_ABI,
|
|
61
117
|
functionName: "approve",
|
|
62
|
-
args: [
|
|
118
|
+
args: [spender, approveAmount],
|
|
63
119
|
});
|
|
64
120
|
const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
|
|
65
121
|
if (receipt.status !== "success") {
|
|
@@ -71,7 +127,18 @@ export async function handleApproveToken(raw) {
|
|
|
71
127
|
token: input.token,
|
|
72
128
|
tokenAddress,
|
|
73
129
|
approvedAmount: input.amount === "max" ? "unlimited" : input.amount,
|
|
74
|
-
spender
|
|
130
|
+
spender,
|
|
131
|
+
spenderVerified: spenderEvidence.verifiedCanonical,
|
|
132
|
+
spenderRegistryEvidence: spenderEvidence.recognized || spenderEvidence.note
|
|
133
|
+
? {
|
|
134
|
+
recognized: spenderEvidence.recognized,
|
|
135
|
+
verifiedCanonical: spenderEvidence.verifiedCanonical,
|
|
136
|
+
label: spenderEvidence.contractLabel,
|
|
137
|
+
item: spenderEvidence.itemId,
|
|
138
|
+
verificationStatus: spenderEvidence.verificationStatus,
|
|
139
|
+
note: spenderEvidence.note,
|
|
140
|
+
}
|
|
141
|
+
: null,
|
|
75
142
|
signerMode: signer.mode,
|
|
76
143
|
walletAddress: signer.address,
|
|
77
144
|
gasUsed: receipt.gasUsed.toString(),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"approveToken.js","sourceRoot":"","sources":["../../src/tools/approveToken.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,
|
|
1
|
+
{"version":3,"file":"approveToken.js","sourceRoot":"","sources":["../../src/tools/approveToken.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { type RiskAssessment } from "../lib/riskEngine.js";
|
|
3
|
+
import { type ToolResponse } from "../lib/toolResponse.js";
|
|
3
4
|
export declare const assessRiskSchema: z.ZodObject<{
|
|
4
5
|
action: z.ZodEnum<["swap", "transfer"]>;
|
|
5
6
|
tokenIn: z.ZodOptional<z.ZodString>;
|
|
@@ -8,39 +9,28 @@ export declare const assessRiskSchema: z.ZodObject<{
|
|
|
8
9
|
toAddress: z.ZodOptional<z.ZodString>;
|
|
9
10
|
walletAddress: z.ZodString;
|
|
10
11
|
agentId: z.ZodOptional<z.ZodString>;
|
|
11
|
-
autoPublish: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
12
12
|
privateKey: z.ZodOptional<z.ZodString>;
|
|
13
|
-
}, "
|
|
13
|
+
}, "strict", z.ZodTypeAny, {
|
|
14
14
|
amount: string;
|
|
15
15
|
walletAddress: string;
|
|
16
16
|
action: "transfer" | "swap";
|
|
17
|
-
autoPublish: boolean;
|
|
18
|
-
tokenIn?: string | undefined;
|
|
19
|
-
tokenOut?: string | undefined;
|
|
20
17
|
privateKey?: string | undefined;
|
|
21
18
|
agentId?: string | undefined;
|
|
19
|
+
tokenIn?: string | undefined;
|
|
20
|
+
tokenOut?: string | undefined;
|
|
22
21
|
toAddress?: string | undefined;
|
|
23
22
|
}, {
|
|
24
23
|
amount: string;
|
|
25
24
|
walletAddress: string;
|
|
26
25
|
action: "transfer" | "swap";
|
|
27
|
-
tokenIn?: string | undefined;
|
|
28
|
-
tokenOut?: string | undefined;
|
|
29
26
|
privateKey?: string | undefined;
|
|
30
27
|
agentId?: string | undefined;
|
|
28
|
+
tokenIn?: string | undefined;
|
|
29
|
+
tokenOut?: string | undefined;
|
|
31
30
|
toAddress?: string | undefined;
|
|
32
|
-
autoPublish?: boolean | undefined;
|
|
33
31
|
}>;
|
|
34
32
|
export type AssessRiskInput = z.input<typeof assessRiskSchema>;
|
|
35
|
-
export
|
|
36
|
-
registryPublish?: {
|
|
37
|
-
published: boolean;
|
|
38
|
-
txHash?: string;
|
|
39
|
-
explorerUrl?: string;
|
|
40
|
-
error?: string;
|
|
41
|
-
signerMode?: string;
|
|
42
|
-
};
|
|
43
|
-
}
|
|
33
|
+
export type AssessRiskResult = RiskAssessment;
|
|
44
34
|
export declare const assessRiskTool: {
|
|
45
35
|
name: string;
|
|
46
36
|
description: string;
|
|
@@ -52,29 +42,26 @@ export declare const assessRiskTool: {
|
|
|
52
42
|
toAddress: z.ZodOptional<z.ZodString>;
|
|
53
43
|
walletAddress: z.ZodString;
|
|
54
44
|
agentId: z.ZodOptional<z.ZodString>;
|
|
55
|
-
autoPublish: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
56
45
|
privateKey: z.ZodOptional<z.ZodString>;
|
|
57
|
-
}, "
|
|
46
|
+
}, "strict", z.ZodTypeAny, {
|
|
58
47
|
amount: string;
|
|
59
48
|
walletAddress: string;
|
|
60
49
|
action: "transfer" | "swap";
|
|
61
|
-
autoPublish: boolean;
|
|
62
|
-
tokenIn?: string | undefined;
|
|
63
|
-
tokenOut?: string | undefined;
|
|
64
50
|
privateKey?: string | undefined;
|
|
65
51
|
agentId?: string | undefined;
|
|
52
|
+
tokenIn?: string | undefined;
|
|
53
|
+
tokenOut?: string | undefined;
|
|
66
54
|
toAddress?: string | undefined;
|
|
67
55
|
}, {
|
|
68
56
|
amount: string;
|
|
69
57
|
walletAddress: string;
|
|
70
58
|
action: "transfer" | "swap";
|
|
71
|
-
tokenIn?: string | undefined;
|
|
72
|
-
tokenOut?: string | undefined;
|
|
73
59
|
privateKey?: string | undefined;
|
|
74
60
|
agentId?: string | undefined;
|
|
61
|
+
tokenIn?: string | undefined;
|
|
62
|
+
tokenOut?: string | undefined;
|
|
75
63
|
toAddress?: string | undefined;
|
|
76
|
-
autoPublish?: boolean | undefined;
|
|
77
64
|
}>;
|
|
78
65
|
};
|
|
79
|
-
export declare function handleAssessRisk(raw: AssessRiskInput): Promise<AssessRiskResult
|
|
66
|
+
export declare function handleAssessRisk(raw: AssessRiskInput): Promise<ToolResponse<AssessRiskResult>>;
|
|
80
67
|
//# sourceMappingURL=assessRisk.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assessRisk.d.ts","sourceRoot":"","sources":["../../src/tools/assessRisk.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"assessRisk.d.ts","sourceRoot":"","sources":["../../src/tools/assessRisk.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGrE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASlB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM1B,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAsCpG"}
|
package/dist/tools/assessRisk.js
CHANGED
|
@@ -1,13 +1,12 @@
|
|
|
1
1
|
// ─── Tool: assess_risk ─────────────────────────────────────────────────
|
|
2
|
-
// Core risk assessment tool.
|
|
3
|
-
//
|
|
2
|
+
// Core risk assessment tool. Risk scoring / analysis ONLY — it never writes
|
|
3
|
+
// to any registry. To publish an attestation on-chain, use publish_risk_score
|
|
4
|
+
// (SafeHandsRegistry, gated by WRITE_TOOLS_ENABLED + signer + authorization).
|
|
4
5
|
// ────────────────────────────────────────────────────────────────────────
|
|
5
6
|
import { z } from "zod";
|
|
6
7
|
import { assessRisk } from "../lib/riskEngine.js";
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
9
|
-
import { getSigner, isSignerFailure } from "../lib/signer/index.js";
|
|
10
|
-
import { requireWriteToolsEnabled } from "../lib/toolResponse.js";
|
|
8
|
+
import { fail, ok } from "../lib/toolResponse.js";
|
|
9
|
+
import { validatePositiveAmount, validateAddress } from "../lib/validation.js";
|
|
11
10
|
export const assessRiskSchema = z.object({
|
|
12
11
|
action: z.enum(["swap", "transfer"]),
|
|
13
12
|
tokenIn: z.string().optional(),
|
|
@@ -15,23 +14,42 @@ export const assessRiskSchema = z.object({
|
|
|
15
14
|
amount: z.string(),
|
|
16
15
|
toAddress: z.string().optional(),
|
|
17
16
|
walletAddress: z.string(),
|
|
18
|
-
agentId: z.string().optional().describe("
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
});
|
|
17
|
+
agentId: z.string().optional().describe("Optional agent identifier (informational only; assess_risk does not execute or publish)"),
|
|
18
|
+
privateKey: z.string().optional().describe("Deprecated and ignored. assess_risk never signs or publishes. Use publish_risk_score for on-chain attestation."),
|
|
19
|
+
}).strict();
|
|
22
20
|
export const assessRiskTool = {
|
|
23
21
|
name: "assess_risk",
|
|
24
22
|
description: "Evaluate risk of a planned on-chain action (swap or transfer). Returns 0-100 risk score with 5-dimension breakdown. " +
|
|
25
|
-
"
|
|
23
|
+
"Scoring and analysis only; does not publish on-chain. Use publish_risk_score to attest a result to SafeHandsRegistry.",
|
|
26
24
|
inputSchema: assessRiskSchema,
|
|
27
25
|
};
|
|
28
26
|
export async function handleAssessRisk(raw) {
|
|
29
|
-
|
|
27
|
+
let input;
|
|
28
|
+
try {
|
|
29
|
+
input = assessRiskSchema.parse(raw);
|
|
30
|
+
}
|
|
31
|
+
catch (err) {
|
|
32
|
+
const msg = err instanceof z.ZodError
|
|
33
|
+
? err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
|
|
34
|
+
: String(err);
|
|
35
|
+
return fail("VALIDATION_ERROR", `assess_risk input validation failed: ${msg}`, false, "assess_risk");
|
|
36
|
+
}
|
|
37
|
+
const amtErr = validatePositiveAmount(input.amount, "amount");
|
|
38
|
+
if (amtErr)
|
|
39
|
+
return fail("VALIDATION_ERROR", amtErr, false, "assess_risk");
|
|
40
|
+
const addrErr = validateAddress(input.walletAddress, "walletAddress");
|
|
41
|
+
if (addrErr)
|
|
42
|
+
return fail("VALIDATION_ERROR", addrErr, false, "assess_risk");
|
|
30
43
|
if (input.action === "swap" && (!input.tokenIn || !input.tokenOut)) {
|
|
31
|
-
|
|
44
|
+
return fail("VALIDATION_ERROR", "Swap action requires both tokenIn and tokenOut.", false, "assess_risk");
|
|
32
45
|
}
|
|
33
|
-
if (input.action === "transfer"
|
|
34
|
-
|
|
46
|
+
if (input.action === "transfer") {
|
|
47
|
+
if (!input.toAddress) {
|
|
48
|
+
return fail("VALIDATION_ERROR", "Transfer action requires toAddress.", false, "assess_risk");
|
|
49
|
+
}
|
|
50
|
+
const toErr = validateAddress(input.toAddress, "toAddress");
|
|
51
|
+
if (toErr)
|
|
52
|
+
return fail("VALIDATION_ERROR", toErr, false, "assess_risk");
|
|
35
53
|
}
|
|
36
54
|
const assessment = await assessRisk({
|
|
37
55
|
action: input.action,
|
|
@@ -41,65 +59,6 @@ export async function handleAssessRisk(raw) {
|
|
|
41
59
|
toAddress: input.toAddress,
|
|
42
60
|
walletAddress: input.walletAddress,
|
|
43
61
|
});
|
|
44
|
-
|
|
45
|
-
const wantsPublish = input.autoPublish || Boolean(input.privateKey);
|
|
46
|
-
if (wantsPublish) {
|
|
47
|
-
if (input.privateKey) {
|
|
48
|
-
result.registryPublish = {
|
|
49
|
-
published: false,
|
|
50
|
-
error: "Direct privateKey input is deprecated and ignored. Use WALLET_MODE=managed-testnet with agentId or WALLET_MODE=env through SignerProvider.",
|
|
51
|
-
};
|
|
52
|
-
return result;
|
|
53
|
-
}
|
|
54
|
-
const writeGuard = requireWriteToolsEnabled("assess_risk_auto_publish");
|
|
55
|
-
if (writeGuard) {
|
|
56
|
-
result.registryPublish = { published: false, error: `${writeGuard.error.code}: ${writeGuard.error.message}` };
|
|
57
|
-
return result;
|
|
58
|
-
}
|
|
59
|
-
const signer = await getSigner(input.agentId);
|
|
60
|
-
if (isSignerFailure(signer)) {
|
|
61
|
-
result.registryPublish = { published: false, error: `${signer.error.code}: ${signer.error.message}` };
|
|
62
|
-
return result;
|
|
63
|
-
}
|
|
64
|
-
try {
|
|
65
|
-
const wallet = createPharosWalletClientFromAccount(signer.account);
|
|
66
|
-
const txHash = await wallet.writeContract({
|
|
67
|
-
address: RISK_REGISTRY_ADDRESS,
|
|
68
|
-
abi: RISK_REGISTRY_ABI,
|
|
69
|
-
functionName: "publish",
|
|
70
|
-
args: [
|
|
71
|
-
input.walletAddress,
|
|
72
|
-
BigInt(assessment.riskScore),
|
|
73
|
-
assessment.riskLevel,
|
|
74
|
-
assessment.recommendation,
|
|
75
|
-
],
|
|
76
|
-
});
|
|
77
|
-
const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
|
|
78
|
-
if (receipt.status !== "success") {
|
|
79
|
-
result.registryPublish = {
|
|
80
|
-
published: false,
|
|
81
|
-
txHash,
|
|
82
|
-
explorerUrl: getExplorerUrl(txHash),
|
|
83
|
-
error: "TX_REVERTED: transaction was mined but reverted. Ensure the calling wallet is authorized via RiskRegistry.setAuthorizedAgent() by the contract owner.",
|
|
84
|
-
signerMode: signer.mode,
|
|
85
|
-
};
|
|
86
|
-
}
|
|
87
|
-
else {
|
|
88
|
-
result.registryPublish = {
|
|
89
|
-
published: true,
|
|
90
|
-
txHash,
|
|
91
|
-
explorerUrl: getExplorerUrl(txHash),
|
|
92
|
-
signerMode: signer.mode,
|
|
93
|
-
};
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
catch (err) {
|
|
97
|
-
result.registryPublish = {
|
|
98
|
-
published: false,
|
|
99
|
-
error: `Registry publish failed: ${err.message}`,
|
|
100
|
-
};
|
|
101
|
-
}
|
|
102
|
-
}
|
|
103
|
-
return result;
|
|
62
|
+
return ok(assessment);
|
|
104
63
|
}
|
|
105
64
|
//# sourceMappingURL=assessRisk.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assessRisk.js","sourceRoot":"","sources":["../../src/tools/assessRisk.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,
|
|
1
|
+
{"version":3,"file":"assessRisk.js","sourceRoot":"","sources":["../../src/tools/assessRisk.ts"],"names":[],"mappings":"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"}
|
|
@@ -30,15 +30,21 @@ export declare const checkAllowanceTool: {
|
|
|
30
30
|
amount?: string | undefined;
|
|
31
31
|
}>;
|
|
32
32
|
};
|
|
33
|
-
export declare function handleCheckAllowance(raw: CheckAllowanceInput): Promise<import("../
|
|
33
|
+
export declare function handleCheckAllowance(raw: CheckAllowanceInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
|
|
34
34
|
token: "USDC" | "USDT";
|
|
35
|
-
tokenAddress:
|
|
36
|
-
walletAddress: string
|
|
35
|
+
tokenAddress: `0x${string}`;
|
|
36
|
+
walletAddress: `0x${string}`;
|
|
37
37
|
spender: "0x4Cf317b8918FbE8A890c01eDAb7d548555Ac2cE9";
|
|
38
|
+
spenderRecognition: {
|
|
39
|
+
recognized: boolean;
|
|
40
|
+
label: string;
|
|
41
|
+
};
|
|
38
42
|
allowance: string;
|
|
39
43
|
allowanceRaw: string;
|
|
40
44
|
isApproved: boolean;
|
|
41
45
|
needsApproval: boolean;
|
|
42
46
|
approvalNote: string;
|
|
47
|
+
chainId: number;
|
|
48
|
+
environment: string;
|
|
43
49
|
}>>;
|
|
44
50
|
//# sourceMappingURL=checkAllowance.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"checkAllowance.d.ts","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"checkAllowance.d.ts","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAK9B,CAAC;AAaF,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;;;;;;;;IA2DlE"}
|
|
@@ -3,9 +3,10 @@
|
|
|
3
3
|
// ────────────────────────────────────────────────────────────────────────
|
|
4
4
|
import { z } from "zod";
|
|
5
5
|
import { publicClient } from "../lib/pharosClient.js";
|
|
6
|
-
import { DODO_APPROVE_ADDRESS,
|
|
7
|
-
import { formatUnits, parseUnits } from "viem";
|
|
8
|
-
import { ok } from "../lib/toolResponse.js";
|
|
6
|
+
import { DODO_APPROVE_ADDRESS, ERC20_ABI, CHAIN_ID, PHAROS_ENVIRONMENT, activeTokenMap, activeTokenDecimals, } from "../lib/constants.js";
|
|
7
|
+
import { formatUnits, isAddress, parseUnits } from "viem";
|
|
8
|
+
import { ok, fail } from "../lib/toolResponse.js";
|
|
9
|
+
import { lookupCanonical } from "../lib/analysis/contractIntel.js";
|
|
9
10
|
export const checkAllowanceSchema = z.object({
|
|
10
11
|
walletAddress: z.string().describe("Wallet address to check allowance for"),
|
|
11
12
|
token: z.enum(["USDC", "USDT"]).describe("ERC-20 token to check"),
|
|
@@ -16,11 +17,28 @@ export const checkAllowanceTool = {
|
|
|
16
17
|
description: "Check ERC-20 token allowance granted to DODO_APPROVE_ADDRESS for swaps. Returns current allowance and whether approval is needed.",
|
|
17
18
|
inputSchema: checkAllowanceSchema,
|
|
18
19
|
};
|
|
20
|
+
function resolveAllowanceToken(symbol) {
|
|
21
|
+
const map = activeTokenMap();
|
|
22
|
+
const decimalsMap = activeTokenDecimals();
|
|
23
|
+
const tokenAddress = map[symbol];
|
|
24
|
+
if (!tokenAddress)
|
|
25
|
+
return null;
|
|
26
|
+
return {
|
|
27
|
+
tokenAddress,
|
|
28
|
+
decimals: decimalsMap[symbol] ?? decimalsMap[tokenAddress.toLowerCase()] ?? 18,
|
|
29
|
+
};
|
|
30
|
+
}
|
|
19
31
|
export async function handleCheckAllowance(raw) {
|
|
20
32
|
const input = checkAllowanceSchema.parse(raw);
|
|
33
|
+
if (!isAddress(input.walletAddress)) {
|
|
34
|
+
return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "check_allowance");
|
|
35
|
+
}
|
|
36
|
+
const resolved = resolveAllowanceToken(input.token);
|
|
37
|
+
if (!resolved) {
|
|
38
|
+
return fail("UNSUPPORTED_TOKEN", `${input.token} is not configured for ${PHAROS_ENVIRONMENT} (${CHAIN_ID}). No allowance query was made against a fallback/testnet address.`, false, "check_allowance");
|
|
39
|
+
}
|
|
21
40
|
const walletAddr = input.walletAddress;
|
|
22
|
-
const tokenAddress
|
|
23
|
-
const decimals = 6;
|
|
41
|
+
const { tokenAddress, decimals } = resolved;
|
|
24
42
|
const allowanceRaw = (await publicClient.readContract({
|
|
25
43
|
address: tokenAddress,
|
|
26
44
|
abi: ERC20_ABI,
|
|
@@ -42,16 +60,20 @@ export async function handleCheckAllowance(raw) {
|
|
|
42
60
|
needsApproval = !isApproved;
|
|
43
61
|
approvalNote = "Heuristic (no amount provided): any nonzero allowance counts as approved. Pass 'amount' for an exact check.";
|
|
44
62
|
}
|
|
63
|
+
const spenderCanonical = lookupCanonical(DODO_APPROVE_ADDRESS);
|
|
45
64
|
return ok({
|
|
46
65
|
token: input.token,
|
|
47
66
|
tokenAddress,
|
|
48
67
|
walletAddress: input.walletAddress,
|
|
49
68
|
spender: DODO_APPROVE_ADDRESS,
|
|
69
|
+
spenderRecognition: { recognized: Boolean(spenderCanonical), label: spenderCanonical?.label ?? "DODO/FaroSwap approve proxy (project-configured allowlist target; not registry-verified)" },
|
|
50
70
|
allowance: allowanceFormatted,
|
|
51
71
|
allowanceRaw: allowanceRaw.toString(),
|
|
52
72
|
isApproved,
|
|
53
73
|
needsApproval,
|
|
54
74
|
approvalNote,
|
|
75
|
+
chainId: CHAIN_ID,
|
|
76
|
+
environment: PHAROS_ENVIRONMENT,
|
|
55
77
|
});
|
|
56
78
|
}
|
|
57
79
|
//# sourceMappingURL=checkAllowance.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"checkAllowance.js","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0DAA0D;AAC1D,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,oBAAoB,EACpB,
|
|
1
|
+
{"version":3,"file":"checkAllowance.js","sourceRoot":"","sources":["../../src/tools/checkAllowance.ts"],"names":[],"mappings":"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"}
|