safehands-pharos 1.2.6 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/.env.example +64 -26
  2. package/README.md +333 -445
  3. package/dist/cli.d.ts +5 -5
  4. package/dist/cli.d.ts.map +1 -1
  5. package/dist/cli.js +124 -98
  6. package/dist/cli.js.map +1 -1
  7. package/dist/demo.d.ts +1 -1
  8. package/dist/demo.js +171 -171
  9. package/dist/index.d.ts +2 -2
  10. package/dist/index.js +138 -87
  11. package/dist/index.js.map +1 -1
  12. package/dist/init.d.ts +1 -1
  13. package/dist/init.js +65 -65
  14. package/dist/lib/auditLog.d.ts +9 -0
  15. package/dist/lib/auditLog.d.ts.map +1 -0
  16. package/dist/lib/auditLog.js +30 -0
  17. package/dist/lib/auditLog.js.map +1 -0
  18. package/dist/lib/constants.d.ts +291 -291
  19. package/dist/lib/constants.js +292 -292
  20. package/dist/lib/dodoApi.d.ts +78 -70
  21. package/dist/lib/dodoApi.d.ts.map +1 -1
  22. package/dist/lib/dodoApi.js +196 -178
  23. package/dist/lib/dodoApi.js.map +1 -1
  24. package/dist/lib/http.d.ts +14 -14
  25. package/dist/lib/http.js +118 -118
  26. package/dist/lib/pharosClient.d.ts +58 -58
  27. package/dist/lib/pharosClient.d.ts.map +1 -1
  28. package/dist/lib/pharosClient.js +63 -53
  29. package/dist/lib/pharosClient.js.map +1 -1
  30. package/dist/lib/policy/actionPolicyEngine.d.ts +53 -53
  31. package/dist/lib/policy/actionPolicyEngine.js +212 -212
  32. package/dist/lib/policy/actionPolicyEngine.js.map +1 -1
  33. package/dist/lib/riskEngine.d.ts +26 -26
  34. package/dist/lib/riskEngine.js +283 -283
  35. package/dist/lib/signer/index.d.ts +24 -24
  36. package/dist/lib/signer/index.d.ts.map +1 -1
  37. package/dist/lib/signer/index.js +88 -89
  38. package/dist/lib/signer/index.js.map +1 -1
  39. package/dist/lib/spendAccumulator.d.ts +10 -0
  40. package/dist/lib/spendAccumulator.d.ts.map +1 -0
  41. package/dist/lib/spendAccumulator.js +54 -0
  42. package/dist/lib/spendAccumulator.js.map +1 -0
  43. package/dist/lib/testDodoLive.d.ts +1 -1
  44. package/dist/lib/testDodoLive.js +104 -104
  45. package/dist/lib/testLiveSafehands.d.ts +1 -1
  46. package/dist/lib/testLiveSafehands.js +92 -92
  47. package/dist/lib/testRpc.d.ts +1 -1
  48. package/dist/lib/testRpc.js +29 -29
  49. package/dist/lib/testRpcLive.d.ts +1 -1
  50. package/dist/lib/testRpcLive.js +88 -88
  51. package/dist/lib/testTools.d.ts +1 -1
  52. package/dist/lib/testTools.js +397 -397
  53. package/dist/lib/testX402Live.d.ts +1 -1
  54. package/dist/lib/testX402Live.js +159 -159
  55. package/dist/lib/toolResponse.d.ts +25 -25
  56. package/dist/lib/toolResponse.js +53 -53
  57. package/dist/lib/wallet/index.d.ts +37 -18
  58. package/dist/lib/wallet/index.d.ts.map +1 -1
  59. package/dist/lib/wallet/index.js +128 -70
  60. package/dist/lib/wallet/index.js.map +1 -1
  61. package/dist/scripts/checkDeploy.d.ts +1 -1
  62. package/dist/scripts/checkDeploy.js +24 -24
  63. package/dist/scripts/deployRegistry.d.ts +1 -1
  64. package/dist/scripts/deployRegistry.js +100 -100
  65. package/dist/scripts/testRegistry.d.ts +1 -1
  66. package/dist/scripts/testRegistry.js +43 -43
  67. package/dist/tools/approveToken.d.ts +45 -46
  68. package/dist/tools/approveToken.d.ts.map +1 -1
  69. package/dist/tools/approveToken.js +85 -83
  70. package/dist/tools/approveToken.js.map +1 -1
  71. package/dist/tools/assessRisk.d.ts +79 -79
  72. package/dist/tools/assessRisk.d.ts.map +1 -1
  73. package/dist/tools/assessRisk.js +104 -93
  74. package/dist/tools/assessRisk.js.map +1 -1
  75. package/dist/tools/checkAllowance.d.ts +43 -36
  76. package/dist/tools/checkAllowance.d.ts.map +1 -1
  77. package/dist/tools/checkAllowance.js +56 -42
  78. package/dist/tools/checkAllowance.js.map +1 -1
  79. package/dist/tools/checkTokenSecurity.d.ts +46 -46
  80. package/dist/tools/checkTokenSecurity.d.ts.map +1 -1
  81. package/dist/tools/checkTokenSecurity.js +95 -88
  82. package/dist/tools/checkTokenSecurity.js.map +1 -1
  83. package/dist/tools/createAgentWallet.d.ts +26 -26
  84. package/dist/tools/createAgentWallet.d.ts.map +1 -1
  85. package/dist/tools/createAgentWallet.js +58 -59
  86. package/dist/tools/createAgentWallet.js.map +1 -1
  87. package/dist/tools/estimateGas.d.ts +79 -79
  88. package/dist/tools/estimateGas.js +124 -124
  89. package/dist/tools/executeSwap.d.ts +61 -59
  90. package/dist/tools/executeSwap.d.ts.map +1 -1
  91. package/dist/tools/executeSwap.js +141 -129
  92. package/dist/tools/executeSwap.js.map +1 -1
  93. package/dist/tools/explainRisk.d.ts +29 -29
  94. package/dist/tools/explainRisk.js +32 -32
  95. package/dist/tools/getAgentWallet.d.ts +21 -21
  96. package/dist/tools/getAgentWallet.js +27 -27
  97. package/dist/tools/getAgentWalletBalance.d.ts +11 -11
  98. package/dist/tools/getAgentWalletBalance.js +70 -70
  99. package/dist/tools/getExecutionHistory.d.ts +49 -51
  100. package/dist/tools/getExecutionHistory.d.ts.map +1 -1
  101. package/dist/tools/getExecutionHistory.js +154 -93
  102. package/dist/tools/getExecutionHistory.js.map +1 -1
  103. package/dist/tools/getGasPrice.d.ts +43 -43
  104. package/dist/tools/getGasPrice.js +59 -59
  105. package/dist/tools/getPoolInfo.d.ts +75 -75
  106. package/dist/tools/getPoolInfo.js +137 -137
  107. package/dist/tools/getTokenPrice.d.ts +113 -113
  108. package/dist/tools/getTokenPrice.js +117 -117
  109. package/dist/tools/getTransactionStatus.d.ts +43 -57
  110. package/dist/tools/getTransactionStatus.d.ts.map +1 -1
  111. package/dist/tools/getTransactionStatus.js +59 -67
  112. package/dist/tools/getTransactionStatus.js.map +1 -1
  113. package/dist/tools/getWalletBalance.d.ts +68 -68
  114. package/dist/tools/getWalletBalance.js +87 -87
  115. package/dist/tools/publishRiskScore.d.ts +63 -63
  116. package/dist/tools/publishRiskScore.d.ts.map +1 -1
  117. package/dist/tools/publishRiskScore.js +88 -85
  118. package/dist/tools/publishRiskScore.js.map +1 -1
  119. package/dist/tools/queryRiskRegistry.d.ts +38 -48
  120. package/dist/tools/queryRiskRegistry.d.ts.map +1 -1
  121. package/dist/tools/queryRiskRegistry.js +55 -60
  122. package/dist/tools/queryRiskRegistry.js.map +1 -1
  123. package/dist/tools/safehandsPreflightCheck.d.ts +77 -77
  124. package/dist/tools/safehandsPreflightCheck.js +47 -47
  125. package/dist/tools/safehandsRiskReport.d.ts +81 -81
  126. package/dist/tools/safehandsRiskReport.js +28 -28
  127. package/dist/tools/safehandsSafeExecute.d.ts +20 -20
  128. package/dist/tools/safehandsSafeExecute.d.ts.map +1 -1
  129. package/dist/tools/safehandsSafeExecute.js +81 -75
  130. package/dist/tools/safehandsSafeExecute.js.map +1 -1
  131. package/dist/tools/safehandsWalletHealth.d.ts +14 -14
  132. package/dist/tools/safehandsWalletHealth.js +103 -103
  133. package/dist/tools/safehandsX402Preflight.d.ts +26 -26
  134. package/dist/tools/safehandsX402Preflight.js +65 -65
  135. package/dist/tools/sendPayment.d.ts +57 -58
  136. package/dist/tools/sendPayment.d.ts.map +1 -1
  137. package/dist/tools/sendPayment.js +117 -108
  138. package/dist/tools/sendPayment.js.map +1 -1
  139. package/dist/tools/simulateTransaction.d.ts +60 -81
  140. package/dist/tools/simulateTransaction.d.ts.map +1 -1
  141. package/dist/tools/simulateTransaction.js +83 -88
  142. package/dist/tools/simulateTransaction.js.map +1 -1
  143. package/dist/tools/tokenRegistryStatus.d.ts +26 -26
  144. package/dist/tools/tokenRegistryStatus.js +96 -96
  145. package/dist/tools/x402PayAndFetch.d.ts +81 -81
  146. package/dist/tools/x402PayAndFetch.d.ts.map +1 -1
  147. package/dist/tools/x402PayAndFetch.js +152 -149
  148. package/dist/tools/x402PayAndFetch.js.map +1 -1
  149. package/dist/x402Server.d.ts +1 -1
  150. package/dist/x402Server.js +252 -252
  151. package/examples/dashboard/index.html +337 -0
  152. package/package.json +83 -82
  153. package/skill/SKILL.md +133 -133
@@ -1,60 +1,60 @@
1
- // ─── Tool: get_gas_price ───────────────────────────────────────────────
2
- // Fetches current gas price from Pharos RPC with trend analysis.
3
- // ────────────────────────────────────────────────────────────────────────
4
- import { z } from "zod";
5
- import { publicClient } from "../lib/pharosClient.js";
6
- import { formatGwei } from "viem";
7
- import { CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
8
- import { classifyExternalError, ok } from "../lib/toolResponse.js";
9
- export const getGasPriceSchema = z.object({});
10
- export const getGasPriceTool = {
11
- name: "get_gas_price",
12
- description: "Get the current gas price on Pharos Atlantic Testnet with trend classification (low/normal/high) and cost estimates.",
13
- inputSchema: getGasPriceSchema,
14
- };
15
- export async function handleGetGasPrice(_raw) {
16
- try {
17
- const gasPrice = await publicClient.getGasPrice();
18
- const gasPriceGwei = parseFloat(formatGwei(gasPrice));
19
- let trend;
20
- let recommendation;
21
- if (gasPriceGwei <= 5) {
22
- trend = "low";
23
- recommendation = "Gas is cheap. Good time to execute testnet transactions.";
24
- }
25
- else if (gasPriceGwei <= 50) {
26
- trend = "normal";
27
- recommendation = "Gas is at normal testnet levels. Proceed with standard transactions.";
28
- }
29
- else {
30
- trend = "high";
31
- recommendation = "Gas is elevated. Consider waiting or reducing transaction complexity.";
32
- }
33
- const transferCostWei = gasPrice * 21000n;
34
- const swapCostWei = gasPrice * 250000n;
35
- return ok({
36
- gasPrice: { value: gasPriceGwei.toFixed(4), unit: "gwei" },
37
- gasPriceWei: gasPrice.toString(),
38
- trend,
39
- recommendation,
40
- estimates: {
41
- nativeTransfer: {
42
- gas: { value: "21000", unit: "gas" },
43
- costPHRS: { value: (Number(transferCostWei) / 1e18).toFixed(8), unit: "PHRS" },
44
- },
45
- tokenSwap: {
46
- gas: { value: "250000", unit: "gas" },
47
- costPHRS: { value: (Number(swapCostWei) / 1e18).toFixed(8), unit: "PHRS" },
48
- },
49
- },
50
- chainId: CHAIN_ID,
51
- environment: PHAROS_ENVIRONMENT,
52
- isMainnet: false,
53
- source: "pharos_rpc",
54
- });
55
- }
56
- catch (err) {
57
- return classifyExternalError("pharos_rpc", err);
58
- }
59
- }
1
+ // ─── Tool: get_gas_price ───────────────────────────────────────────────
2
+ // Fetches current gas price from Pharos RPC with trend analysis.
3
+ // ────────────────────────────────────────────────────────────────────────
4
+ import { z } from "zod";
5
+ import { publicClient } from "../lib/pharosClient.js";
6
+ import { formatGwei } from "viem";
7
+ import { CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
8
+ import { classifyExternalError, ok } from "../lib/toolResponse.js";
9
+ export const getGasPriceSchema = z.object({});
10
+ export const getGasPriceTool = {
11
+ name: "get_gas_price",
12
+ description: "Get the current gas price on Pharos Atlantic Testnet with trend classification (low/normal/high) and cost estimates.",
13
+ inputSchema: getGasPriceSchema,
14
+ };
15
+ export async function handleGetGasPrice(_raw) {
16
+ try {
17
+ const gasPrice = await publicClient.getGasPrice();
18
+ const gasPriceGwei = parseFloat(formatGwei(gasPrice));
19
+ let trend;
20
+ let recommendation;
21
+ if (gasPriceGwei <= 5) {
22
+ trend = "low";
23
+ recommendation = "Gas is cheap. Good time to execute testnet transactions.";
24
+ }
25
+ else if (gasPriceGwei <= 50) {
26
+ trend = "normal";
27
+ recommendation = "Gas is at normal testnet levels. Proceed with standard transactions.";
28
+ }
29
+ else {
30
+ trend = "high";
31
+ recommendation = "Gas is elevated. Consider waiting or reducing transaction complexity.";
32
+ }
33
+ const transferCostWei = gasPrice * 21000n;
34
+ const swapCostWei = gasPrice * 250000n;
35
+ return ok({
36
+ gasPrice: { value: gasPriceGwei.toFixed(4), unit: "gwei" },
37
+ gasPriceWei: gasPrice.toString(),
38
+ trend,
39
+ recommendation,
40
+ estimates: {
41
+ nativeTransfer: {
42
+ gas: { value: "21000", unit: "gas" },
43
+ costPHRS: { value: (Number(transferCostWei) / 1e18).toFixed(8), unit: "PHRS" },
44
+ },
45
+ tokenSwap: {
46
+ gas: { value: "250000", unit: "gas" },
47
+ costPHRS: { value: (Number(swapCostWei) / 1e18).toFixed(8), unit: "PHRS" },
48
+ },
49
+ },
50
+ chainId: CHAIN_ID,
51
+ environment: PHAROS_ENVIRONMENT,
52
+ isMainnet: false,
53
+ source: "pharos_rpc",
54
+ });
55
+ }
56
+ catch (err) {
57
+ return classifyExternalError("pharos_rpc", err);
58
+ }
59
+ }
60
60
  //# sourceMappingURL=getGasPrice.js.map
@@ -1,76 +1,76 @@
1
- import { z } from "zod";
2
- export declare const getPoolInfoSchema: z.ZodObject<{
3
- tokenA: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
4
- tokenB: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
5
- }, "strip", z.ZodTypeAny, {
6
- tokenA: "PHRS" | "USDC" | "USDT";
7
- tokenB: "PHRS" | "USDC" | "USDT";
8
- }, {
9
- tokenA: "PHRS" | "USDC" | "USDT";
10
- tokenB: "PHRS" | "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<["PHRS", "USDC", "USDT"]>;
18
- tokenB: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
19
- }, "strip", z.ZodTypeAny, {
20
- tokenA: "PHRS" | "USDC" | "USDT";
21
- tokenB: "PHRS" | "USDC" | "USDT";
22
- }, {
23
- tokenA: "PHRS" | "USDC" | "USDT";
24
- tokenB: "PHRS" | "USDC" | "USDT";
25
- }>;
26
- };
27
- export declare function handleGetPoolInfo(raw: GetPoolInfoInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.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("../lib/toolResponse.js").ToolSuccess<{
38
- pair: string;
39
- available: boolean;
40
- priceRatio: {
41
- value: string;
42
- unit: "PHRS" | "USDC" | "USDT";
43
- per: string;
44
- } | null;
45
- priceImpact: {
46
- value: string;
47
- unit: string;
48
- };
49
- pricePerFromToken: {
50
- value: string;
51
- unit: "PHRS" | "USDC" | "USDT";
52
- } | null;
53
- pricePerToToken: {
54
- value: string;
55
- unit: "PHRS" | "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
- }>>;
1
+ import { z } from "zod";
2
+ export declare const getPoolInfoSchema: z.ZodObject<{
3
+ tokenA: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
4
+ tokenB: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
5
+ }, "strip", z.ZodTypeAny, {
6
+ tokenA: "PHRS" | "USDC" | "USDT";
7
+ tokenB: "PHRS" | "USDC" | "USDT";
8
+ }, {
9
+ tokenA: "PHRS" | "USDC" | "USDT";
10
+ tokenB: "PHRS" | "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<["PHRS", "USDC", "USDT"]>;
18
+ tokenB: z.ZodEnum<["PHRS", "USDC", "USDT"]>;
19
+ }, "strip", z.ZodTypeAny, {
20
+ tokenA: "PHRS" | "USDC" | "USDT";
21
+ tokenB: "PHRS" | "USDC" | "USDT";
22
+ }, {
23
+ tokenA: "PHRS" | "USDC" | "USDT";
24
+ tokenB: "PHRS" | "USDC" | "USDT";
25
+ }>;
26
+ };
27
+ export declare function handleGetPoolInfo(raw: GetPoolInfoInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.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("../lib/toolResponse.js").ToolSuccess<{
38
+ pair: string;
39
+ available: boolean;
40
+ priceRatio: {
41
+ value: string;
42
+ unit: "PHRS" | "USDC" | "USDT";
43
+ per: string;
44
+ } | null;
45
+ priceImpact: {
46
+ value: string;
47
+ unit: string;
48
+ };
49
+ pricePerFromToken: {
50
+ value: string;
51
+ unit: "PHRS" | "USDC" | "USDT";
52
+ } | null;
53
+ pricePerToToken: {
54
+ value: string;
55
+ unit: "PHRS" | "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,138 +1,138 @@
1
- // ─── Tool: get_pool_info ───────────────────────────────────────────────
2
- // Fetches DODO/FaroSwap route-derived liquidity info for a token pair on
3
- // Pharos Atlantic Testnet. 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 } 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(["PHRS", "USDC", "USDT"]).describe("First token in the pair"),
13
- tokenB: z.enum(["PHRS", "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 testnet. 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
- try {
36
- const addrA = resolveTokenAddress(input.tokenA);
37
- const addrB = resolveTokenAddress(input.tokenB);
38
- const routeUrl = new URL(`${DODO_API_BASE}/route-service/v2/widget/getdodoroute`);
39
- routeUrl.searchParams.set("chainId", String(CHAIN_ID));
40
- routeUrl.searchParams.set("fromTokenAddress", addrA);
41
- routeUrl.searchParams.set("toTokenAddress", addrB);
42
- routeUrl.searchParams.set("fromAmount", "1000000000000000000");
43
- routeUrl.searchParams.set("userAddr", "0x0000000000000000000000000000000000000001");
44
- routeUrl.searchParams.set("slippage", "3");
45
- routeUrl.searchParams.set("source", "dodoV2AndMixWasm");
46
- routeUrl.searchParams.set("estimateGas", "true");
47
- const routeUsedApiKey = addOptionalApiKey(routeUrl);
48
- const routeResponse = await fetchWithTimeoutAndRetry(routeUrl, { timeoutMs: 10_000, retries: 2, retryDelayMs: 300 });
49
- if (isAuthErrorStatus(routeResponse.status)) {
50
- 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");
51
- }
52
- if (!routeResponse.ok) {
53
- return fail("DODO_API_UNAVAILABLE", `DODO route API returned ${routeResponse.status} ${routeResponse.statusText}.`, true, "dodo_api");
54
- }
55
- const routeJson = (await routeResponse.json());
56
- if (!routeJson.data || routeJson.status !== 200) {
57
- const msg = (routeJson.message || "").toLowerCase();
58
- if (msg.includes("api key") || msg.includes("apikey") || msg.includes("unauthorized") || msg.includes("forbidden")) {
59
- 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");
60
- }
61
- return ok({
62
- pair: `${input.tokenA}/${input.tokenB}`,
63
- available: false,
64
- message: "No active DODO/FaroSwap route found for this pair on Pharos testnet.",
65
- source: "DODO/FaroSwap public route API",
66
- sourceStatus: "no_route_available",
67
- publicMode: !routeUsedApiKey,
68
- chainId: CHAIN_ID,
69
- environment: PHAROS_ENVIRONMENT,
70
- isMainnet: false,
71
- });
72
- }
73
- const d = routeJson.data;
74
- const resAmount = parseFloat(String(d.resAmount || "0"));
75
- const priceImpact = parseFloat(String(d.priceImpact || "0"));
76
- const fee = parseFloat(String(d.baseFeeAmount || "0"));
77
- const pricePerFrom = parseFloat(String(d.resPricePerFromToken || "0"));
78
- const pricePerTo = parseFloat(String(d.resPricePerToToken || "0"));
79
- let liquidityInfo = null;
80
- let poolListStatus = "unavailable";
81
- try {
82
- const poolsUrl = new URL(`${DODO_API_BASE}/dodo-pair/list`);
83
- poolsUrl.searchParams.set("chainId", String(CHAIN_ID));
84
- poolsUrl.searchParams.set("baseToken", addrA);
85
- poolsUrl.searchParams.set("quoteToken", addrB);
86
- addOptionalApiKey(poolsUrl);
87
- const poolsResp = await fetchWithTimeoutAndRetry(poolsUrl, { timeoutMs: 10_000, retries: 1, retryDelayMs: 300 });
88
- if (poolsResp.ok) {
89
- const poolsJson = (await poolsResp.json());
90
- if (poolsJson.data?.list && poolsJson.data.list.length > 0) {
91
- const pool = poolsJson.data.list[0];
92
- liquidityInfo = {
93
- baseLiquidity: pool.baseLiquidity || "unknown",
94
- quoteLiquidity: pool.quoteLiquidity || "unknown",
95
- poolType: pool.type || "unknown",
96
- };
97
- poolListStatus = "ok";
98
- }
99
- else {
100
- poolListStatus = "empty";
101
- }
102
- }
103
- else if (isAuthErrorStatus(poolsResp.status)) {
104
- poolListStatus = "auth_required";
105
- }
106
- }
107
- catch {
108
- poolListStatus = "unavailable";
109
- }
110
- return ok({
111
- pair: `${input.tokenA}/${input.tokenB}`,
112
- available: true,
113
- priceRatio: resAmount > 0 ? { value: resAmount.toString(), unit: input.tokenB, per: `1 ${input.tokenA}` } : null,
114
- priceImpact: { value: priceImpact.toFixed(4), unit: "percent" },
115
- pricePerFromToken: pricePerFrom > 0 ? { value: pricePerFrom.toFixed(6), unit: input.tokenB } : null,
116
- pricePerToToken: pricePerTo > 0 ? { value: pricePerTo.toFixed(6), unit: input.tokenA } : null,
117
- fee: fee > 0 ? { value: fee.toString(), unit: "raw" } : null,
118
- liquidity: liquidityInfo,
119
- poolListStatus,
120
- source: "DODO/FaroSwap public route API",
121
- sourceStatus: "ok",
122
- publicMode: !routeUsedApiKey,
123
- routeAvailable: true,
124
- confidence: liquidityInfo ? "medium" : "low",
125
- chainId: CHAIN_ID,
126
- environment: PHAROS_ENVIRONMENT,
127
- isMainnet: false,
128
- });
129
- }
130
- catch (err) {
131
- const message = err instanceof Error ? err.message : String(err);
132
- if (message.includes("INVALID_TOKEN_ADDRESS")) {
133
- return fail("INVALID_TOKEN_ADDRESS", message, false, "get_pool_info");
134
- }
135
- return classifyExternalError("dodo_api", err);
136
- }
137
- }
1
+ // ─── Tool: get_pool_info ───────────────────────────────────────────────
2
+ // Fetches DODO/FaroSwap route-derived liquidity info for a token pair on
3
+ // Pharos Atlantic Testnet. 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 } 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(["PHRS", "USDC", "USDT"]).describe("First token in the pair"),
13
+ tokenB: z.enum(["PHRS", "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 testnet. 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
+ try {
36
+ const addrA = resolveTokenAddress(input.tokenA);
37
+ const addrB = resolveTokenAddress(input.tokenB);
38
+ const routeUrl = new URL(`${DODO_API_BASE}/route-service/v2/widget/getdodoroute`);
39
+ routeUrl.searchParams.set("chainId", String(CHAIN_ID));
40
+ routeUrl.searchParams.set("fromTokenAddress", addrA);
41
+ routeUrl.searchParams.set("toTokenAddress", addrB);
42
+ routeUrl.searchParams.set("fromAmount", "1000000000000000000");
43
+ routeUrl.searchParams.set("userAddr", "0x0000000000000000000000000000000000000001");
44
+ routeUrl.searchParams.set("slippage", "3");
45
+ routeUrl.searchParams.set("source", "dodoV2AndMixWasm");
46
+ routeUrl.searchParams.set("estimateGas", "true");
47
+ const routeUsedApiKey = addOptionalApiKey(routeUrl);
48
+ const routeResponse = await fetchWithTimeoutAndRetry(routeUrl, { timeoutMs: 10_000, retries: 2, retryDelayMs: 300 });
49
+ if (isAuthErrorStatus(routeResponse.status)) {
50
+ 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");
51
+ }
52
+ if (!routeResponse.ok) {
53
+ return fail("DODO_API_UNAVAILABLE", `DODO route API returned ${routeResponse.status} ${routeResponse.statusText}.`, true, "dodo_api");
54
+ }
55
+ const routeJson = (await routeResponse.json());
56
+ if (!routeJson.data || routeJson.status !== 200) {
57
+ const msg = (routeJson.message || "").toLowerCase();
58
+ if (msg.includes("api key") || msg.includes("apikey") || msg.includes("unauthorized") || msg.includes("forbidden")) {
59
+ 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");
60
+ }
61
+ return ok({
62
+ pair: `${input.tokenA}/${input.tokenB}`,
63
+ available: false,
64
+ message: "No active DODO/FaroSwap route found for this pair on Pharos testnet.",
65
+ source: "DODO/FaroSwap public route API",
66
+ sourceStatus: "no_route_available",
67
+ publicMode: !routeUsedApiKey,
68
+ chainId: CHAIN_ID,
69
+ environment: PHAROS_ENVIRONMENT,
70
+ isMainnet: false,
71
+ });
72
+ }
73
+ const d = routeJson.data;
74
+ const resAmount = parseFloat(String(d.resAmount || "0"));
75
+ const priceImpact = parseFloat(String(d.priceImpact || "0"));
76
+ const fee = parseFloat(String(d.baseFeeAmount || "0"));
77
+ const pricePerFrom = parseFloat(String(d.resPricePerFromToken || "0"));
78
+ const pricePerTo = parseFloat(String(d.resPricePerToToken || "0"));
79
+ let liquidityInfo = null;
80
+ let poolListStatus = "unavailable";
81
+ try {
82
+ const poolsUrl = new URL(`${DODO_API_BASE}/dodo-pair/list`);
83
+ poolsUrl.searchParams.set("chainId", String(CHAIN_ID));
84
+ poolsUrl.searchParams.set("baseToken", addrA);
85
+ poolsUrl.searchParams.set("quoteToken", addrB);
86
+ addOptionalApiKey(poolsUrl);
87
+ const poolsResp = await fetchWithTimeoutAndRetry(poolsUrl, { timeoutMs: 10_000, retries: 1, retryDelayMs: 300 });
88
+ if (poolsResp.ok) {
89
+ const poolsJson = (await poolsResp.json());
90
+ if (poolsJson.data?.list && poolsJson.data.list.length > 0) {
91
+ const pool = poolsJson.data.list[0];
92
+ liquidityInfo = {
93
+ baseLiquidity: pool.baseLiquidity || "unknown",
94
+ quoteLiquidity: pool.quoteLiquidity || "unknown",
95
+ poolType: pool.type || "unknown",
96
+ };
97
+ poolListStatus = "ok";
98
+ }
99
+ else {
100
+ poolListStatus = "empty";
101
+ }
102
+ }
103
+ else if (isAuthErrorStatus(poolsResp.status)) {
104
+ poolListStatus = "auth_required";
105
+ }
106
+ }
107
+ catch {
108
+ poolListStatus = "unavailable";
109
+ }
110
+ return ok({
111
+ pair: `${input.tokenA}/${input.tokenB}`,
112
+ available: true,
113
+ priceRatio: resAmount > 0 ? { value: resAmount.toString(), unit: input.tokenB, per: `1 ${input.tokenA}` } : null,
114
+ priceImpact: { value: priceImpact.toFixed(4), unit: "percent" },
115
+ pricePerFromToken: pricePerFrom > 0 ? { value: pricePerFrom.toFixed(6), unit: input.tokenB } : null,
116
+ pricePerToToken: pricePerTo > 0 ? { value: pricePerTo.toFixed(6), unit: input.tokenA } : null,
117
+ fee: fee > 0 ? { value: fee.toString(), unit: "raw" } : null,
118
+ liquidity: liquidityInfo,
119
+ poolListStatus,
120
+ source: "DODO/FaroSwap public route API",
121
+ sourceStatus: "ok",
122
+ publicMode: !routeUsedApiKey,
123
+ routeAvailable: true,
124
+ confidence: liquidityInfo ? "medium" : "low",
125
+ chainId: CHAIN_ID,
126
+ environment: PHAROS_ENVIRONMENT,
127
+ isMainnet: false,
128
+ });
129
+ }
130
+ catch (err) {
131
+ const message = err instanceof Error ? err.message : String(err);
132
+ if (message.includes("INVALID_TOKEN_ADDRESS")) {
133
+ return fail("INVALID_TOKEN_ADDRESS", message, false, "get_pool_info");
134
+ }
135
+ return classifyExternalError("dodo_api", err);
136
+ }
137
+ }
138
138
  //# sourceMappingURL=getPoolInfo.js.map