safehands-pharos 1.1.1 → 1.2.3
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/.env.example +26 -0
- package/README.md +311 -350
- package/contracts/RiskRegistry.json +75 -1
- package/contracts/RiskRegistry.sol +29 -1
- package/dist/cli.d.ts +6 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +91 -0
- package/dist/cli.js.map +1 -0
- package/dist/demo.d.ts +2 -0
- package/dist/demo.d.ts.map +1 -0
- package/dist/demo.js +172 -0
- package/dist/demo.js.map +1 -0
- package/dist/index.js +181 -169
- package/dist/index.js.map +1 -1
- package/dist/init.d.ts +2 -0
- package/dist/init.d.ts.map +1 -0
- package/dist/init.js +66 -0
- package/dist/init.js.map +1 -0
- package/dist/lib/constants.d.ts +122 -7
- package/dist/lib/constants.d.ts.map +1 -1
- package/dist/lib/constants.js +139 -13
- package/dist/lib/constants.js.map +1 -1
- package/dist/lib/dodoApi.d.ts +14 -0
- package/dist/lib/dodoApi.d.ts.map +1 -1
- package/dist/lib/dodoApi.js +78 -22
- package/dist/lib/dodoApi.js.map +1 -1
- package/dist/lib/http.d.ts +15 -0
- package/dist/lib/http.d.ts.map +1 -0
- package/dist/lib/http.js +119 -0
- package/dist/lib/http.js.map +1 -0
- package/dist/lib/pharosClient.d.ts +4 -3
- package/dist/lib/pharosClient.d.ts.map +1 -1
- package/dist/lib/pharosClient.js +8 -5
- package/dist/lib/pharosClient.js.map +1 -1
- package/dist/lib/policy/actionPolicyEngine.d.ts +54 -0
- package/dist/lib/policy/actionPolicyEngine.d.ts.map +1 -0
- package/dist/lib/policy/actionPolicyEngine.js +213 -0
- package/dist/lib/policy/actionPolicyEngine.js.map +1 -0
- package/dist/lib/signer/index.d.ts +25 -0
- package/dist/lib/signer/index.d.ts.map +1 -0
- package/dist/lib/signer/index.js +90 -0
- package/dist/lib/signer/index.js.map +1 -0
- package/dist/lib/testDodoLive.d.ts +2 -0
- package/dist/lib/testDodoLive.d.ts.map +1 -0
- package/dist/lib/testDodoLive.js +105 -0
- package/dist/lib/testDodoLive.js.map +1 -0
- package/dist/lib/testLiveSafehands.d.ts +2 -0
- package/dist/lib/testLiveSafehands.d.ts.map +1 -0
- package/dist/lib/testLiveSafehands.js +93 -0
- package/dist/lib/testLiveSafehands.js.map +1 -0
- package/dist/lib/testRpcLive.d.ts +2 -0
- package/dist/lib/testRpcLive.d.ts.map +1 -0
- package/dist/lib/testRpcLive.js +89 -0
- package/dist/lib/testRpcLive.js.map +1 -0
- package/dist/lib/testTools.js +363 -355
- package/dist/lib/testTools.js.map +1 -1
- package/dist/lib/testX402Live.d.ts +2 -0
- package/dist/lib/testX402Live.d.ts.map +1 -0
- package/dist/lib/testX402Live.js +160 -0
- package/dist/lib/testX402Live.js.map +1 -0
- package/dist/lib/toolResponse.d.ts +26 -0
- package/dist/lib/toolResponse.d.ts.map +1 -0
- package/dist/lib/toolResponse.js +54 -0
- package/dist/lib/toolResponse.js.map +1 -0
- package/dist/lib/wallet/index.d.ts +19 -0
- package/dist/lib/wallet/index.d.ts.map +1 -0
- package/dist/lib/wallet/index.js +71 -0
- package/dist/lib/wallet/index.js.map +1 -0
- package/dist/tools/approveToken.d.ts +19 -32
- package/dist/tools/approveToken.d.ts.map +1 -1
- package/dist/tools/approveToken.js +44 -19
- package/dist/tools/approveToken.js.map +1 -1
- package/dist/tools/assessRisk.d.ts +22 -9
- package/dist/tools/assessRisk.d.ts.map +1 -1
- package/dist/tools/assessRisk.js +32 -9
- package/dist/tools/assessRisk.js.map +1 -1
- package/dist/tools/checkAllowance.d.ts +6 -6
- package/dist/tools/checkTokenSecurity.d.ts +9 -16
- package/dist/tools/checkTokenSecurity.d.ts.map +1 -1
- package/dist/tools/checkTokenSecurity.js +17 -22
- package/dist/tools/checkTokenSecurity.js.map +1 -1
- package/dist/tools/createAgentWallet.d.ts +27 -0
- package/dist/tools/createAgentWallet.d.ts.map +1 -0
- package/dist/tools/createAgentWallet.js +60 -0
- package/dist/tools/createAgentWallet.js.map +1 -0
- package/dist/tools/estimateGas.d.ts +31 -21
- package/dist/tools/estimateGas.d.ts.map +1 -1
- package/dist/tools/estimateGas.js +91 -95
- package/dist/tools/estimateGas.js.map +1 -1
- package/dist/tools/executeSwap.d.ts +13 -47
- package/dist/tools/executeSwap.d.ts.map +1 -1
- package/dist/tools/executeSwap.js +69 -46
- package/dist/tools/executeSwap.js.map +1 -1
- package/dist/tools/explainRisk.d.ts +30 -0
- package/dist/tools/explainRisk.d.ts.map +1 -0
- package/dist/tools/explainRisk.js +33 -0
- package/dist/tools/explainRisk.js.map +1 -0
- package/dist/tools/getAgentWallet.d.ts +22 -0
- package/dist/tools/getAgentWallet.d.ts.map +1 -0
- package/dist/tools/getAgentWallet.js +28 -0
- package/dist/tools/getAgentWallet.js.map +1 -0
- package/dist/tools/getAgentWalletBalance.d.ts +12 -0
- package/dist/tools/getAgentWalletBalance.d.ts.map +1 -0
- package/dist/tools/getAgentWalletBalance.js +71 -0
- package/dist/tools/getAgentWalletBalance.js.map +1 -0
- package/dist/tools/getExecutionHistory.d.ts +4 -4
- package/dist/tools/getGasPrice.d.ts +26 -8
- package/dist/tools/getGasPrice.d.ts.map +1 -1
- package/dist/tools/getGasPrice.js +43 -35
- package/dist/tools/getGasPrice.js.map +1 -1
- package/dist/tools/getPoolInfo.d.ts +47 -59
- package/dist/tools/getPoolInfo.d.ts.map +1 -1
- package/dist/tools/getPoolInfo.js +96 -57
- package/dist/tools/getPoolInfo.js.map +1 -1
- package/dist/tools/getTokenPrice.d.ts +95 -9
- package/dist/tools/getTokenPrice.d.ts.map +1 -1
- package/dist/tools/getTokenPrice.js +95 -56
- package/dist/tools/getTokenPrice.js.map +1 -1
- package/dist/tools/getWalletBalance.d.ts +40 -11
- package/dist/tools/getWalletBalance.d.ts.map +1 -1
- package/dist/tools/getWalletBalance.js +64 -47
- package/dist/tools/getWalletBalance.js.map +1 -1
- package/dist/tools/publishRiskScore.d.ts +12 -22
- package/dist/tools/publishRiskScore.d.ts.map +1 -1
- package/dist/tools/publishRiskScore.js +34 -18
- package/dist/tools/publishRiskScore.js.map +1 -1
- package/dist/tools/queryRiskRegistry.d.ts +3 -3
- package/dist/tools/safehandsPreflightCheck.d.ts +78 -0
- package/dist/tools/safehandsPreflightCheck.d.ts.map +1 -0
- package/dist/tools/safehandsPreflightCheck.js +48 -0
- package/dist/tools/safehandsPreflightCheck.js.map +1 -0
- package/dist/tools/safehandsRiskReport.d.ts +82 -0
- package/dist/tools/safehandsRiskReport.d.ts.map +1 -0
- package/dist/tools/safehandsRiskReport.js +29 -0
- package/dist/tools/safehandsRiskReport.js.map +1 -0
- package/dist/tools/safehandsSafeExecute.d.ts +21 -0
- package/dist/tools/safehandsSafeExecute.d.ts.map +1 -0
- package/dist/tools/safehandsSafeExecute.js +76 -0
- package/dist/tools/safehandsSafeExecute.js.map +1 -0
- package/dist/tools/safehandsWalletHealth.d.ts +15 -0
- package/dist/tools/safehandsWalletHealth.d.ts.map +1 -0
- package/dist/tools/safehandsWalletHealth.js +104 -0
- package/dist/tools/safehandsWalletHealth.js.map +1 -0
- package/dist/tools/safehandsX402Preflight.d.ts +27 -0
- package/dist/tools/safehandsX402Preflight.d.ts.map +1 -0
- package/dist/tools/safehandsX402Preflight.js +66 -0
- package/dist/tools/safehandsX402Preflight.js.map +1 -0
- package/dist/tools/sendPayment.d.ts +13 -53
- package/dist/tools/sendPayment.d.ts.map +1 -1
- package/dist/tools/sendPayment.js +55 -48
- package/dist/tools/sendPayment.js.map +1 -1
- package/dist/tools/simulateTransaction.d.ts +4 -4
- package/dist/tools/tokenRegistryStatus.d.ts +27 -0
- package/dist/tools/tokenRegistryStatus.d.ts.map +1 -0
- package/dist/tools/tokenRegistryStatus.js +97 -0
- package/dist/tools/tokenRegistryStatus.js.map +1 -0
- package/dist/tools/x402PayAndFetch.d.ts +40 -22
- package/dist/tools/x402PayAndFetch.d.ts.map +1 -1
- package/dist/tools/x402PayAndFetch.js +115 -45
- package/dist/tools/x402PayAndFetch.js.map +1 -1
- package/dist/x402Server.js +149 -115
- package/dist/x402Server.js.map +1 -1
- package/examples/pharos-skill-engine/SKILL.safehands.md +85 -0
- package/examples/pharos-skill-engine/assets/safehands/example-actions.json +49 -0
- package/examples/pharos-skill-engine/assets/safehands/policy-defaults.json +11 -0
- package/examples/pharos-skill-engine/references/safehands.md +345 -0
- package/examples/scenario-hack.ts +38 -0
- package/package.json +19 -5
- package/skill/SKILL.md +127 -0
- package/skill/assets/safehands/example-actions.json +49 -0
- package/skill/assets/safehands/policy-defaults.json +11 -0
- package/skill/references/safehands.md +345 -0
- package/.agents/skill/safehands/SKILL.md +0 -200
- package/.agents/skill/safehands/assets/networks.json +0 -24
- package/.agents/skill/safehands/assets/tokens.json +0 -60
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sendPayment.js","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,
|
|
1
|
+
{"version":3,"file":"sendPayment.js","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,mCAAmC,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACpI,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;CAC3G,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,wHAAwH;IACrI,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAqB;IAC3D,MAAM,UAAU,GAAG,wBAAwB,CAAC,cAAc,CAAC,CAAC;IAC5D,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAErC,MAAM,MAAM,GAAG,oBAAoB,CAAC;QAClC,UAAU,EAAE,cAAc;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,iBAAiB,EAAE,KAAK;QACxB,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,sCAAsC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC3H,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,mBAAmB,EAAE,oDAAoD,kBAAkB,SAAS,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC3I,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAE/E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,wBAAwB,EAAE,2BAA2B,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;IAE/B,IAAI,KAAK,CAAC,SAAS,KAAK,4CAA4C,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;QAClE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,OAAO,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,8BAA8B,EAAE,8BAA8B,WAAW,CAAC,OAAO,CAAC,eAAe,KAAK,CAAC,MAAM,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5J,CAAC;IACD,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEpC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACtD,IAAI,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,SAAS,QAAQ,qCAAqC,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;QAC5B,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa;KACd,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,SAAS,GAAG,oBAAoB,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,gBAAgB,EAAE,gCAAgC,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IACjI,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,mCAAmC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;YAC1C,EAAE,EAAE,KAAK,CAAC,SAA0B;YACpC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/E,OAAO,EAAE,CAAC;YACR,SAAS,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS;YACvC,MAAM;YACN,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;YACnC,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,aAAa;YACb,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;YACnC,UAAU;YACV,MAAM;YACN,cAAc,EAAE;gBACd,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,KAAK;aAClB;YACD,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,qBAAqB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}
|
|
@@ -8,15 +8,15 @@ export declare const simulateTransactionSchema: z.ZodObject<{
|
|
|
8
8
|
walletAddress: z.ZodString;
|
|
9
9
|
}, "strip", z.ZodTypeAny, {
|
|
10
10
|
amount: string;
|
|
11
|
-
action: "transfer" | "swap";
|
|
12
11
|
walletAddress: string;
|
|
12
|
+
action: "transfer" | "swap";
|
|
13
13
|
tokenIn?: string | undefined;
|
|
14
14
|
tokenOut?: string | undefined;
|
|
15
15
|
toAddress?: string | undefined;
|
|
16
16
|
}, {
|
|
17
17
|
amount: string;
|
|
18
|
-
action: "transfer" | "swap";
|
|
19
18
|
walletAddress: string;
|
|
19
|
+
action: "transfer" | "swap";
|
|
20
20
|
tokenIn?: string | undefined;
|
|
21
21
|
tokenOut?: string | undefined;
|
|
22
22
|
toAddress?: string | undefined;
|
|
@@ -34,15 +34,15 @@ export declare const simulateTransactionTool: {
|
|
|
34
34
|
walletAddress: z.ZodString;
|
|
35
35
|
}, "strip", z.ZodTypeAny, {
|
|
36
36
|
amount: string;
|
|
37
|
-
action: "transfer" | "swap";
|
|
38
37
|
walletAddress: string;
|
|
38
|
+
action: "transfer" | "swap";
|
|
39
39
|
tokenIn?: string | undefined;
|
|
40
40
|
tokenOut?: string | undefined;
|
|
41
41
|
toAddress?: string | undefined;
|
|
42
42
|
}, {
|
|
43
43
|
amount: string;
|
|
44
|
-
action: "transfer" | "swap";
|
|
45
44
|
walletAddress: string;
|
|
45
|
+
action: "transfer" | "swap";
|
|
46
46
|
tokenIn?: string | undefined;
|
|
47
47
|
tokenOut?: string | undefined;
|
|
48
48
|
toAddress?: string | undefined;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { type ToolResponse } from "../lib/toolResponse.js";
|
|
3
|
+
export declare const tokenRegistryStatusSchema: z.ZodObject<{
|
|
4
|
+
token: z.ZodOptional<z.ZodString>;
|
|
5
|
+
tokenAddress: z.ZodOptional<z.ZodString>;
|
|
6
|
+
}, "strip", z.ZodTypeAny, {
|
|
7
|
+
token?: string | undefined;
|
|
8
|
+
tokenAddress?: string | undefined;
|
|
9
|
+
}, {
|
|
10
|
+
token?: string | undefined;
|
|
11
|
+
tokenAddress?: string | undefined;
|
|
12
|
+
}>;
|
|
13
|
+
export type TokenRegistryStatusInput = z.input<typeof tokenRegistryStatusSchema>;
|
|
14
|
+
export type TokenRegistryStatusValue = "CANONICAL_TESTNET_TOKEN" | "SKILL_ENGINE_CANONICAL_TOKEN" | "ALTERNATE_SOURCE_TOKEN" | "CUSTOM_NON_REGISTRY" | "UNKNOWN" | "INVALID_ADDRESS";
|
|
15
|
+
export declare function classifyTokenRegistryStatus(token: string): {
|
|
16
|
+
input: string;
|
|
17
|
+
normalizedAddress: any;
|
|
18
|
+
symbol: any;
|
|
19
|
+
status: TokenRegistryStatusValue;
|
|
20
|
+
verificationStatus: any;
|
|
21
|
+
docsSource: any;
|
|
22
|
+
chainId: number;
|
|
23
|
+
environment: string;
|
|
24
|
+
isMainnet: boolean;
|
|
25
|
+
};
|
|
26
|
+
export declare function handleTokenRegistryStatus(raw: TokenRegistryStatusInput): Promise<ToolResponse<unknown>>;
|
|
27
|
+
//# sourceMappingURL=tokenRegistryStatus.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tokenRegistryStatus.d.ts","sourceRoot":"","sources":["../../src/tools/tokenRegistryStatus.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG/D,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,MAAM,MAAM,wBAAwB,GAChC,yBAAyB,GACzB,8BAA8B,GAC9B,wBAAwB,GACxB,qBAAqB,GACrB,SAAS,GACT,iBAAiB,CAAC;AAQtB,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;EA2ExD;AAED,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAG7G"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
// ─── Tool: token_registry_status ───────────────────────────────────────
|
|
2
|
+
// Classify exact token addresses without silently replacing user input.
|
|
3
|
+
// The official Pharos Skill Engine (pharos-skill-engine-0.1.0)
|
|
4
|
+
// assets/tokens.json lists 0xE0BE... as USDC for atlantic-testnet.
|
|
5
|
+
// ───────────────────────────────────────────────────────────────────────
|
|
6
|
+
import { z } from "zod";
|
|
7
|
+
import { getAddress, isAddress } from "viem";
|
|
8
|
+
import { ok } from "../lib/toolResponse.js";
|
|
9
|
+
import { TOKEN_REGISTRY, CIRCLE_USDC_ADDRESS, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
|
|
10
|
+
export const tokenRegistryStatusSchema = z.object({
|
|
11
|
+
token: z.string().optional().describe("Token symbol or exact contract address to classify"),
|
|
12
|
+
tokenAddress: z.string().optional().describe("Exact token contract address to classify"),
|
|
13
|
+
});
|
|
14
|
+
function deriveStatus(match) {
|
|
15
|
+
if (match.verificationStatus === "DOCS_VERIFIED_FROM_PHAROS_SKILL_ENGINE")
|
|
16
|
+
return "SKILL_ENGINE_CANONICAL_TOKEN";
|
|
17
|
+
if (match.verificationStatus === "CIRCLE_REFERENCED_USDC")
|
|
18
|
+
return "ALTERNATE_SOURCE_TOKEN";
|
|
19
|
+
return "CANONICAL_TESTNET_TOKEN";
|
|
20
|
+
}
|
|
21
|
+
export function classifyTokenRegistryStatus(token) {
|
|
22
|
+
const raw = token.trim();
|
|
23
|
+
const upper = raw.toUpperCase();
|
|
24
|
+
const bySymbol = TOKEN_REGISTRY[upper];
|
|
25
|
+
if (bySymbol) {
|
|
26
|
+
return {
|
|
27
|
+
input: token,
|
|
28
|
+
normalizedAddress: bySymbol.address,
|
|
29
|
+
symbol: bySymbol.symbol,
|
|
30
|
+
status: deriveStatus(bySymbol),
|
|
31
|
+
verificationStatus: bySymbol.verificationStatus || (bySymbol.isCanonical ? "PROJECT_CONFIGURED" : "UNVERIFIED_CONFIG_VALUE"),
|
|
32
|
+
docsSource: bySymbol.docsSource || "project constants",
|
|
33
|
+
chainId: CHAIN_ID,
|
|
34
|
+
environment: PHAROS_ENVIRONMENT,
|
|
35
|
+
isMainnet: false,
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
if (!isAddress(raw)) {
|
|
39
|
+
return {
|
|
40
|
+
input: token,
|
|
41
|
+
normalizedAddress: null,
|
|
42
|
+
symbol: null,
|
|
43
|
+
status: "INVALID_ADDRESS",
|
|
44
|
+
verificationStatus: "INVALID_ADDRESS",
|
|
45
|
+
docsSource: null,
|
|
46
|
+
chainId: CHAIN_ID,
|
|
47
|
+
environment: PHAROS_ENVIRONMENT,
|
|
48
|
+
isMainnet: false,
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
const checksum = getAddress(raw);
|
|
52
|
+
const entries = Object.values(TOKEN_REGISTRY);
|
|
53
|
+
const match = entries.find((t) => t.address.toLowerCase() === checksum.toLowerCase());
|
|
54
|
+
if (match) {
|
|
55
|
+
return {
|
|
56
|
+
input: token,
|
|
57
|
+
normalizedAddress: checksum,
|
|
58
|
+
symbol: match.symbol,
|
|
59
|
+
status: deriveStatus(match),
|
|
60
|
+
verificationStatus: match.verificationStatus || "PROJECT_CONFIGURED",
|
|
61
|
+
docsSource: match.docsSource || "project constants",
|
|
62
|
+
chainId: CHAIN_ID,
|
|
63
|
+
environment: PHAROS_ENVIRONMENT,
|
|
64
|
+
isMainnet: false,
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
// Check if it's the Circle USDC address directly (even if not primary)
|
|
68
|
+
if (checksum.toLowerCase() === CIRCLE_USDC_ADDRESS.toLowerCase()) {
|
|
69
|
+
return {
|
|
70
|
+
input: token,
|
|
71
|
+
normalizedAddress: checksum,
|
|
72
|
+
symbol: "CIRCLE_USDC",
|
|
73
|
+
status: "ALTERNATE_SOURCE_TOKEN",
|
|
74
|
+
verificationStatus: "CIRCLE_REFERENCED_USDC",
|
|
75
|
+
docsSource: "https://developers.circle.com/stablecoins/usdc-contract-addresses",
|
|
76
|
+
chainId: CHAIN_ID,
|
|
77
|
+
environment: PHAROS_ENVIRONMENT,
|
|
78
|
+
isMainnet: false,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
return {
|
|
82
|
+
input: token,
|
|
83
|
+
normalizedAddress: checksum,
|
|
84
|
+
symbol: null,
|
|
85
|
+
status: "CUSTOM_NON_REGISTRY",
|
|
86
|
+
verificationStatus: "UNVERIFIED_CUSTOM_TOKEN",
|
|
87
|
+
docsSource: null,
|
|
88
|
+
chainId: CHAIN_ID,
|
|
89
|
+
environment: PHAROS_ENVIRONMENT,
|
|
90
|
+
isMainnet: false,
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
export async function handleTokenRegistryStatus(raw) {
|
|
94
|
+
const input = tokenRegistryStatusSchema.parse(raw);
|
|
95
|
+
return ok(classifyTokenRegistryStatus(input.tokenAddress || input.token || ""));
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=tokenRegistryStatus.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tokenRegistryStatus.js","sourceRoot":"","sources":["../../src/tools/tokenRegistryStatus.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,20 +3,23 @@ export declare const x402PayAndFetchSchema: z.ZodObject<{
|
|
|
3
3
|
url: z.ZodString;
|
|
4
4
|
method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE"]>>>;
|
|
5
5
|
body: z.ZodOptional<z.ZodString>;
|
|
6
|
-
privateKey: z.ZodOptional<z.ZodString>;
|
|
7
6
|
rpcUrl: z.ZodOptional<z.ZodString>;
|
|
7
|
+
agentId: z.ZodOptional<z.ZodString>;
|
|
8
|
+
maxPaymentUsdc: z.ZodDefault<z.ZodOptional<z.ZodString>>;
|
|
8
9
|
}, "strip", z.ZodTypeAny, {
|
|
9
|
-
method: "GET" | "POST" | "PUT" | "DELETE";
|
|
10
10
|
url: string;
|
|
11
|
-
|
|
11
|
+
method: "GET" | "POST" | "PUT" | "DELETE";
|
|
12
|
+
maxPaymentUsdc: string;
|
|
12
13
|
body?: string | undefined;
|
|
14
|
+
agentId?: string | undefined;
|
|
13
15
|
rpcUrl?: string | undefined;
|
|
14
16
|
}, {
|
|
15
17
|
url: string;
|
|
16
|
-
privateKey?: string | undefined;
|
|
17
18
|
body?: string | undefined;
|
|
18
19
|
method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
|
|
20
|
+
agentId?: string | undefined;
|
|
19
21
|
rpcUrl?: string | undefined;
|
|
22
|
+
maxPaymentUsdc?: string | undefined;
|
|
20
23
|
}>;
|
|
21
24
|
export type X402PayAndFetchInput = z.input<typeof x402PayAndFetchSchema>;
|
|
22
25
|
export declare const x402PayAndFetchTool: {
|
|
@@ -26,39 +29,54 @@ export declare const x402PayAndFetchTool: {
|
|
|
26
29
|
url: z.ZodString;
|
|
27
30
|
method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE"]>>>;
|
|
28
31
|
body: z.ZodOptional<z.ZodString>;
|
|
29
|
-
privateKey: z.ZodOptional<z.ZodString>;
|
|
30
32
|
rpcUrl: z.ZodOptional<z.ZodString>;
|
|
33
|
+
agentId: z.ZodOptional<z.ZodString>;
|
|
34
|
+
maxPaymentUsdc: z.ZodDefault<z.ZodOptional<z.ZodString>>;
|
|
31
35
|
}, "strip", z.ZodTypeAny, {
|
|
32
|
-
method: "GET" | "POST" | "PUT" | "DELETE";
|
|
33
36
|
url: string;
|
|
34
|
-
|
|
37
|
+
method: "GET" | "POST" | "PUT" | "DELETE";
|
|
38
|
+
maxPaymentUsdc: string;
|
|
35
39
|
body?: string | undefined;
|
|
40
|
+
agentId?: string | undefined;
|
|
36
41
|
rpcUrl?: string | undefined;
|
|
37
42
|
}, {
|
|
38
43
|
url: string;
|
|
39
|
-
privateKey?: string | undefined;
|
|
40
44
|
body?: string | undefined;
|
|
41
45
|
method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
|
|
46
|
+
agentId?: string | undefined;
|
|
42
47
|
rpcUrl?: string | undefined;
|
|
48
|
+
maxPaymentUsdc?: string | undefined;
|
|
43
49
|
}>;
|
|
44
50
|
};
|
|
45
|
-
export declare function handleX402PayAndFetch(raw: X402PayAndFetchInput): Promise<{
|
|
46
|
-
success: boolean;
|
|
51
|
+
export declare function handleX402PayAndFetch(raw: X402PayAndFetchInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
|
|
47
52
|
status: number;
|
|
48
53
|
statusText: string;
|
|
49
|
-
data:
|
|
54
|
+
data: unknown;
|
|
55
|
+
paymentExecuted: boolean;
|
|
56
|
+
paymentDetails: null;
|
|
57
|
+
chainId: number;
|
|
58
|
+
environment: string;
|
|
59
|
+
isMainnet: boolean;
|
|
60
|
+
policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
|
|
61
|
+
source: string;
|
|
62
|
+
}> | import("../lib/toolResponse.js").ToolSuccess<{
|
|
63
|
+
status: number;
|
|
64
|
+
statusText: string;
|
|
65
|
+
data: unknown;
|
|
50
66
|
paymentExecuted: boolean;
|
|
51
67
|
paymentDetails: {
|
|
52
|
-
|
|
68
|
+
headerRedacted: boolean;
|
|
69
|
+
note: string;
|
|
53
70
|
} | null;
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
71
|
+
signerMode: import("../lib/signer/index.js").SignerMode;
|
|
72
|
+
walletAddress: `0x${string}`;
|
|
73
|
+
paymentToken: `0x${string}`;
|
|
74
|
+
maxPaymentUsdc: string;
|
|
75
|
+
chainId: number;
|
|
76
|
+
environment: string;
|
|
77
|
+
isMainnet: boolean;
|
|
78
|
+
policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
|
|
79
|
+
testnetPayment: boolean;
|
|
80
|
+
source: string;
|
|
81
|
+
}>>;
|
|
64
82
|
//# sourceMappingURL=x402PayAndFetch.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"x402PayAndFetch.d.ts","sourceRoot":"","sources":["../../src/tools/x402PayAndFetch.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"x402PayAndFetch.d.ts","sourceRoot":"","sources":["../../src/tools/x402PayAndFetch.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;CAM/B,CAAC;AA0BF,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0HpE"}
|
|
@@ -1,80 +1,150 @@
|
|
|
1
1
|
// ─── Tool: x402_pay_and_fetch ─────────────────────────────────────────────
|
|
2
2
|
// Enables an agent to fetch protected resources from an x402 server.
|
|
3
|
-
// Automatically executes the payment challenge
|
|
3
|
+
// Automatically executes the payment challenge only after HTTP 402 is returned.
|
|
4
4
|
// ─────────────────────────────────────────────────────────────────────────
|
|
5
5
|
import { z } from "zod";
|
|
6
6
|
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
|
|
7
7
|
import { registerExactEvmScheme } from "@x402/evm/exact/client";
|
|
8
|
-
import {
|
|
8
|
+
import { CHAIN_ID, PHAROS_ENVIRONMENT, RPC_URL, MAX_X402_PAYMENT_USDC, X402_PAYMENT_TOKEN_ADDRESS } from "../lib/constants.js";
|
|
9
|
+
import { assertSafeFetchUrl, fetchWithTimeoutAndRetry } from "../lib/http.js";
|
|
10
|
+
import { fail, ok } from "../lib/toolResponse.js";
|
|
11
|
+
import { getSigner, isSignerFailure } from "../lib/signer/index.js";
|
|
12
|
+
import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
|
|
9
13
|
export const x402PayAndFetchSchema = z.object({
|
|
10
14
|
url: z.string().describe("Target URL of the protected resource requiring x402 payment"),
|
|
11
15
|
method: z.enum(["GET", "POST", "PUT", "DELETE"]).optional().default("GET").describe("HTTP method to use"),
|
|
12
16
|
body: z.string().optional().describe("Optional stringified JSON request body"),
|
|
13
|
-
privateKey: z.string().optional().describe("EVM private key to pay with. If not provided, falls back to PRIVATE_KEY env var"),
|
|
14
17
|
rpcUrl: z.string().optional().describe("Custom RPC URL for payment verification (defaults to Atlantic Testnet RPC)"),
|
|
18
|
+
agentId: z.string().optional().describe("Managed testnet wallet agentId when WALLET_MODE=managed-testnet"),
|
|
19
|
+
maxPaymentUsdc: z.string().optional().default(MAX_X402_PAYMENT_USDC),
|
|
15
20
|
});
|
|
16
21
|
export const x402PayAndFetchTool = {
|
|
17
22
|
name: "x402_pay_and_fetch",
|
|
18
23
|
description: "Fetch resources from an HTTP x402 payment-gated server. " +
|
|
19
|
-
"If the server challenges with HTTP 402, this tool
|
|
24
|
+
"If the server challenges with HTTP 402, this tool signs the required testnet payment payload and completes the fetch.",
|
|
20
25
|
inputSchema: x402PayAndFetchSchema,
|
|
21
26
|
};
|
|
22
|
-
|
|
23
|
-
const
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
+
async function readResponseBody(res) {
|
|
28
|
+
const contentType = res.headers.get("content-type") || "";
|
|
29
|
+
if (contentType.includes("application/json")) {
|
|
30
|
+
try {
|
|
31
|
+
return await res.json();
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
27
36
|
}
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
// 2. Setup x402 client
|
|
32
|
-
const client = new x402Client();
|
|
33
|
-
registerExactEvmScheme(client, {
|
|
34
|
-
signer,
|
|
35
|
-
schemeOptions: {
|
|
36
|
-
688689: { rpcUrl: rpc },
|
|
37
|
-
},
|
|
38
|
-
});
|
|
39
|
-
// 3. Wrap fetch
|
|
40
|
-
const fetchWithPayment = wrapFetchWithPayment(fetch, client);
|
|
41
|
-
// 4. Perform the request
|
|
37
|
+
return await res.text();
|
|
38
|
+
}
|
|
39
|
+
function buildFetchOptions(input) {
|
|
42
40
|
const fetchOptions = {
|
|
43
41
|
method: input.method,
|
|
44
42
|
headers: {
|
|
45
43
|
"Content-Type": "application/json",
|
|
46
44
|
},
|
|
47
45
|
};
|
|
48
|
-
if (input.body)
|
|
46
|
+
if (input.body)
|
|
49
47
|
fetchOptions.body = input.body;
|
|
48
|
+
return fetchOptions;
|
|
49
|
+
}
|
|
50
|
+
export async function handleX402PayAndFetch(raw) {
|
|
51
|
+
const input = x402PayAndFetchSchema.parse(raw);
|
|
52
|
+
try {
|
|
53
|
+
await assertSafeFetchUrl(input.url);
|
|
54
|
+
}
|
|
55
|
+
catch (err) {
|
|
56
|
+
return fail("SSRF_BLOCKED", err instanceof Error ? err.message.replace(/^SSRF_BLOCKED:\s*/, "") : String(err), false, "x402_pay_and_fetch");
|
|
57
|
+
}
|
|
58
|
+
const staticPolicy = evaluateActionPolicy({
|
|
59
|
+
actionType: "x402_pay_and_fetch",
|
|
60
|
+
url: input.url,
|
|
61
|
+
paymentAmountUsdc: input.maxPaymentUsdc,
|
|
62
|
+
paymentTokenAddress: X402_PAYMENT_TOKEN_ADDRESS,
|
|
63
|
+
chainId: CHAIN_ID,
|
|
64
|
+
environment: PHAROS_ENVIRONMENT,
|
|
65
|
+
isMainnet: false,
|
|
66
|
+
});
|
|
67
|
+
if (staticPolicy.decision === "BLOCK") {
|
|
68
|
+
return fail("POLICY_BLOCKED", staticPolicy.reasons.join(" ") || "x402 request blocked by SafeHands policy.", false, "x402_pay_and_fetch");
|
|
50
69
|
}
|
|
70
|
+
const fetchOptions = buildFetchOptions(input);
|
|
51
71
|
try {
|
|
52
|
-
const
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
72
|
+
const initial = await fetchWithTimeoutAndRetry(input.url, {
|
|
73
|
+
...fetchOptions,
|
|
74
|
+
timeoutMs: 10_000,
|
|
75
|
+
retries: 1,
|
|
76
|
+
retryDelayMs: 250,
|
|
77
|
+
});
|
|
78
|
+
if (initial.status !== 402) {
|
|
79
|
+
const data = await readResponseBody(initial);
|
|
80
|
+
return ok({
|
|
81
|
+
status: initial.status,
|
|
82
|
+
statusText: initial.statusText,
|
|
83
|
+
data,
|
|
84
|
+
paymentExecuted: false,
|
|
85
|
+
paymentDetails: null,
|
|
86
|
+
chainId: CHAIN_ID,
|
|
87
|
+
environment: PHAROS_ENVIRONMENT,
|
|
88
|
+
isMainnet: false,
|
|
89
|
+
policy: staticPolicy,
|
|
90
|
+
source: "x402_fetch",
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
const signer = await getSigner(input.agentId, { purpose: "x402" });
|
|
94
|
+
if (isSignerFailure(signer)) {
|
|
95
|
+
return fail("X402_PAYMENT_REQUIRED", `The resource returned HTTP 402, but no safe x402 signer is available: ${signer.error.message}`, false, "x402_pay_and_fetch");
|
|
57
96
|
}
|
|
58
|
-
|
|
59
|
-
|
|
97
|
+
const paymentPolicy = evaluateActionPolicy({
|
|
98
|
+
actionType: "x402_pay_and_fetch",
|
|
99
|
+
url: input.url,
|
|
100
|
+
paymentAmountUsdc: input.maxPaymentUsdc,
|
|
101
|
+
paymentTokenAddress: X402_PAYMENT_TOKEN_ADDRESS,
|
|
102
|
+
chainId: CHAIN_ID,
|
|
103
|
+
environment: PHAROS_ENVIRONMENT,
|
|
104
|
+
isMainnet: false,
|
|
105
|
+
signerAvailable: true,
|
|
106
|
+
requiresSigner: true,
|
|
107
|
+
});
|
|
108
|
+
if (paymentPolicy.decision === "BLOCK") {
|
|
109
|
+
return fail("POLICY_BLOCKED", paymentPolicy.reasons.join(" ") || "x402 payment blocked by SafeHands policy.", false, "x402_pay_and_fetch");
|
|
60
110
|
}
|
|
61
|
-
const
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
111
|
+
const rpc = input.rpcUrl || process.env.PHAROS_RPC_URL || RPC_URL;
|
|
112
|
+
const client = new x402Client();
|
|
113
|
+
registerExactEvmScheme(client, {
|
|
114
|
+
signer: signer.account,
|
|
115
|
+
schemeOptions: {
|
|
116
|
+
[CHAIN_ID]: { rpcUrl: rpc },
|
|
117
|
+
},
|
|
118
|
+
});
|
|
119
|
+
const fetchWithPayment = wrapFetchWithPayment(fetch, client);
|
|
120
|
+
const paidResponse = await fetchWithPayment(input.url, fetchOptions);
|
|
121
|
+
const data = await readResponseBody(paidResponse);
|
|
122
|
+
const paymentResponseHeader = paidResponse.headers.get("PAYMENT-RESPONSE");
|
|
123
|
+
return ok({
|
|
124
|
+
status: paidResponse.status,
|
|
125
|
+
statusText: paidResponse.statusText,
|
|
126
|
+
data,
|
|
67
127
|
paymentExecuted: !!paymentResponseHeader,
|
|
68
|
-
paymentDetails: paymentResponseHeader
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
128
|
+
paymentDetails: paymentResponseHeader
|
|
129
|
+
? {
|
|
130
|
+
headerRedacted: true,
|
|
131
|
+
note: "PAYMENT-RESPONSE header was present but intentionally not exposed to avoid leaking signed payment data.",
|
|
132
|
+
}
|
|
133
|
+
: null,
|
|
134
|
+
signerMode: signer.mode,
|
|
135
|
+
walletAddress: signer.address,
|
|
136
|
+
paymentToken: X402_PAYMENT_TOKEN_ADDRESS,
|
|
137
|
+
maxPaymentUsdc: input.maxPaymentUsdc,
|
|
138
|
+
chainId: CHAIN_ID,
|
|
139
|
+
environment: PHAROS_ENVIRONMENT,
|
|
140
|
+
isMainnet: false,
|
|
141
|
+
policy: paymentPolicy,
|
|
142
|
+
testnetPayment: true,
|
|
143
|
+
source: "x402_fetch",
|
|
144
|
+
});
|
|
72
145
|
}
|
|
73
146
|
catch (err) {
|
|
74
|
-
return
|
|
75
|
-
success: false,
|
|
76
|
-
error: `x402 fetch failed: ${err.message}`,
|
|
77
|
-
};
|
|
147
|
+
return fail("X402_PAYMENT_FAILED", err instanceof Error ? err.message : String(err), true, "x402_pay_and_fetch");
|
|
78
148
|
}
|
|
79
149
|
}
|
|
80
150
|
//# sourceMappingURL=x402PayAndFetch.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"x402PayAndFetch.js","sourceRoot":"","sources":["../../src/tools/x402PayAndFetch.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,qEAAqE;AACrE,
|
|
1
|
+
{"version":3,"file":"x402PayAndFetch.js","sourceRoot":"","sources":["../../src/tools/x402PayAndFetch.ts"],"names":[],"mappings":"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"}
|