openplanter 0.1.2 → 0.2.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/dist/builder.d.ts.map +1 -1
- package/dist/builder.js +87 -5
- package/dist/builder.js.map +1 -1
- package/dist/credentials.d.ts.map +1 -1
- package/dist/credentials.js +4 -1
- package/dist/credentials.js.map +1 -1
- package/dist/engine.d.ts.map +1 -1
- package/dist/engine.js +5 -0
- package/dist/engine.js.map +1 -1
- package/dist/investigation-tools/advanced-analytics.d.ts +130 -0
- package/dist/investigation-tools/advanced-analytics.d.ts.map +1 -0
- package/dist/investigation-tools/advanced-analytics.js +340 -0
- package/dist/investigation-tools/advanced-analytics.js.map +1 -0
- package/dist/investigation-tools/blockchain-scanner.d.ts +83 -0
- package/dist/investigation-tools/blockchain-scanner.d.ts.map +1 -0
- package/dist/investigation-tools/blockchain-scanner.js +194 -0
- package/dist/investigation-tools/blockchain-scanner.js.map +1 -0
- package/dist/investigation-tools/crypto-ecosystem.d.ts +83 -0
- package/dist/investigation-tools/crypto-ecosystem.d.ts.map +1 -0
- package/dist/investigation-tools/crypto-ecosystem.js +124 -0
- package/dist/investigation-tools/crypto-ecosystem.js.map +1 -0
- package/dist/investigation-tools/dexscreener-pairs.d.ts +41 -0
- package/dist/investigation-tools/dexscreener-pairs.d.ts.map +1 -0
- package/dist/investigation-tools/dexscreener-pairs.js +60 -0
- package/dist/investigation-tools/dexscreener-pairs.js.map +1 -0
- package/dist/investigation-tools/document-processing.d.ts +78 -0
- package/dist/investigation-tools/document-processing.d.ts.map +1 -0
- package/dist/investigation-tools/document-processing.js +252 -0
- package/dist/investigation-tools/document-processing.js.map +1 -0
- package/dist/investigation-tools/dune-analytics.d.ts +47 -0
- package/dist/investigation-tools/dune-analytics.d.ts.map +1 -0
- package/dist/investigation-tools/dune-analytics.js +160 -0
- package/dist/investigation-tools/dune-analytics.js.map +1 -0
- package/dist/investigation-tools/global-registries.d.ts +86 -0
- package/dist/investigation-tools/global-registries.d.ts.map +1 -0
- package/dist/investigation-tools/global-registries.js +212 -0
- package/dist/investigation-tools/global-registries.js.map +1 -0
- package/dist/investigation-tools/government-records.d.ts +85 -0
- package/dist/investigation-tools/government-records.d.ts.map +1 -0
- package/dist/investigation-tools/government-records.js +170 -0
- package/dist/investigation-tools/government-records.js.map +1 -0
- package/dist/investigation-tools/index.d.ts +18 -0
- package/dist/investigation-tools/index.d.ts.map +1 -1
- package/dist/investigation-tools/index.js +19 -0
- package/dist/investigation-tools/index.js.map +1 -1
- package/dist/investigation-tools/investigation-automation.d.ts +144 -0
- package/dist/investigation-tools/investigation-automation.d.ts.map +1 -0
- package/dist/investigation-tools/investigation-automation.js +345 -0
- package/dist/investigation-tools/investigation-automation.js.map +1 -0
- package/dist/investigation-tools/monitoring-tools.d.ts +102 -0
- package/dist/investigation-tools/monitoring-tools.d.ts.map +1 -0
- package/dist/investigation-tools/monitoring-tools.js +214 -0
- package/dist/investigation-tools/monitoring-tools.js.map +1 -0
- package/dist/investigation-tools/political-finance.d.ts +114 -0
- package/dist/investigation-tools/political-finance.d.ts.map +1 -0
- package/dist/investigation-tools/political-finance.js +205 -0
- package/dist/investigation-tools/political-finance.js.map +1 -0
- package/dist/investigation-tools/polymarket-markets.d.ts +137 -0
- package/dist/investigation-tools/polymarket-markets.d.ts.map +1 -0
- package/dist/investigation-tools/polymarket-markets.js +287 -0
- package/dist/investigation-tools/polymarket-markets.js.map +1 -0
- package/dist/investigation-tools/prediction-markets.d.ts +52 -0
- package/dist/investigation-tools/prediction-markets.d.ts.map +1 -0
- package/dist/investigation-tools/prediction-markets.js +116 -0
- package/dist/investigation-tools/prediction-markets.js.map +1 -0
- package/dist/investigation-tools/sec-tools.d.ts +75 -0
- package/dist/investigation-tools/sec-tools.d.ts.map +1 -0
- package/dist/investigation-tools/sec-tools.js +192 -0
- package/dist/investigation-tools/sec-tools.js.map +1 -0
- package/dist/investigation-tools/shared-crypto.d.ts +50 -0
- package/dist/investigation-tools/shared-crypto.d.ts.map +1 -0
- package/dist/investigation-tools/shared-crypto.js +122 -0
- package/dist/investigation-tools/shared-crypto.js.map +1 -0
- package/dist/investigation-tools/social-intelligence.d.ts +91 -0
- package/dist/investigation-tools/social-intelligence.d.ts.map +1 -0
- package/dist/investigation-tools/social-intelligence.js +302 -0
- package/dist/investigation-tools/social-intelligence.js.map +1 -0
- package/dist/investigation-tools/tool-registry.d.ts +12 -0
- package/dist/investigation-tools/tool-registry.d.ts.map +1 -0
- package/dist/investigation-tools/tool-registry.js +399 -0
- package/dist/investigation-tools/tool-registry.js.map +1 -0
- package/dist/investigation-tools/wallet-clusterer.d.ts +28 -0
- package/dist/investigation-tools/wallet-clusterer.d.ts.map +1 -0
- package/dist/investigation-tools/wallet-clusterer.js +179 -0
- package/dist/investigation-tools/wallet-clusterer.js.map +1 -0
- package/dist/model.d.ts.map +1 -1
- package/dist/model.js +1 -1
- package/dist/model.js.map +1 -1
- package/dist/tool-defs.d.ts.map +1 -1
- package/dist/tool-defs.js +301 -0
- package/dist/tool-defs.js.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,340 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* advanced-analytics.ts — Statistical anomaly detection, timeline correlation,
|
|
3
|
+
* network centrality analysis, and prediction market arbitrage detection.
|
|
4
|
+
*
|
|
5
|
+
* Tools: anomaly_detector_ts, timeline_correlator, network_centrality_analyzer, prediction_market_arbitrage
|
|
6
|
+
*/
|
|
7
|
+
import { parseDate, daysBetween } from "./shared.js";
|
|
8
|
+
import { makeProvenance, zScore, computeConfidence, } from "./shared-crypto.js";
|
|
9
|
+
// ── Mock Data ────────────────────────────────────────────────────
|
|
10
|
+
const MOCK_ANOMALIES = {
|
|
11
|
+
anomalies: [
|
|
12
|
+
{ index: 45, timestamp: "2026-02-15", value: 5200000, zScore: 3.8, anomalyType: "spike", severity: "high", context: "Volume 3.8 std devs above mean" },
|
|
13
|
+
{ index: 47, timestamp: "2026-02-17", value: 4800000, zScore: 3.2, anomalyType: "spike", severity: "high", context: "Volume 3.2 std devs above mean" },
|
|
14
|
+
],
|
|
15
|
+
totalPoints: 60, mean: 1200000, stdDev: 450000,
|
|
16
|
+
provenance: makeProvenance("anomaly_detector", "test://mock", ["test_mode"]),
|
|
17
|
+
};
|
|
18
|
+
const MOCK_CORRELATIONS = {
|
|
19
|
+
correlations: [
|
|
20
|
+
{
|
|
21
|
+
sourceEvent: { id: "trade_001", type: "insider_trade", date: "2026-02-10", description: "CEO sold 50k shares" },
|
|
22
|
+
targetEvent: { id: "ann_001", type: "announcement", date: "2026-02-17", description: "Earnings miss -15%" },
|
|
23
|
+
lagDays: 7, correlationScore: 92, correlationType: "precedes",
|
|
24
|
+
evidence: "Insider sale 7 days before negative earnings announcement",
|
|
25
|
+
},
|
|
26
|
+
],
|
|
27
|
+
totalSourceEvents: 5, totalTargetEvents: 12, avgLag: 7,
|
|
28
|
+
provenance: makeProvenance("timeline_correlator", "test://mock", ["test_mode"]),
|
|
29
|
+
};
|
|
30
|
+
const MOCK_CENTRALITY = {
|
|
31
|
+
nodes: [
|
|
32
|
+
{ nodeId: "person_001", label: "John Smith", degreeCentrality: 0.85, betweennessCentrality: 0.72, closenessCentrality: 0.68, pageRank: 0.12, clusterCoefficient: 0.45 },
|
|
33
|
+
{ nodeId: "company_001", label: "TechCorp Inc", degreeCentrality: 0.92, betweennessCentrality: 0.88, closenessCentrality: 0.75, pageRank: 0.15, clusterCoefficient: 0.32 },
|
|
34
|
+
],
|
|
35
|
+
totalNodes: 25, totalEdges: 48, density: 0.16,
|
|
36
|
+
provenance: makeProvenance("network_centrality", "test://mock", ["test_mode"]),
|
|
37
|
+
};
|
|
38
|
+
const MOCK_ARBITRAGE = {
|
|
39
|
+
opportunities: [
|
|
40
|
+
{
|
|
41
|
+
question: "Will BTC exceed $100k by March 2026?",
|
|
42
|
+
platforms: [
|
|
43
|
+
{ platform: "polymarket", yesPrice: 0.72, noPrice: 0.28 },
|
|
44
|
+
{ platform: "kalshi", yesPrice: 0.65, noPrice: 0.35 },
|
|
45
|
+
],
|
|
46
|
+
spreadPct: 7.0, estimatedProfit: 700, risk: "medium",
|
|
47
|
+
confidence: { score: 75, factors: ["price_divergence", "sufficient_liquidity"] },
|
|
48
|
+
},
|
|
49
|
+
],
|
|
50
|
+
totalScanned: 25,
|
|
51
|
+
provenance: makeProvenance("prediction_market_arbitrage", "test://mock", ["test_mode"]),
|
|
52
|
+
};
|
|
53
|
+
// ── anomaly_detector_ts ──────────────────────────────────────────
|
|
54
|
+
export function detectTimeSeriesAnomalies(opts) {
|
|
55
|
+
if (opts.test)
|
|
56
|
+
return MOCK_ANOMALIES;
|
|
57
|
+
const window = opts.window ?? 20;
|
|
58
|
+
const threshold = opts.threshold ?? 2.5;
|
|
59
|
+
const values = opts.values;
|
|
60
|
+
const n = values.length;
|
|
61
|
+
if (n < window + 1) {
|
|
62
|
+
return { anomalies: [], totalPoints: n, mean: 0, stdDev: 0, provenance: makeProvenance("anomaly_detector", undefined, ["insufficient_data"]) };
|
|
63
|
+
}
|
|
64
|
+
const globalMean = values.reduce((a, b) => a + b, 0) / n;
|
|
65
|
+
const globalVariance = values.reduce((a, v) => a + (v - globalMean) ** 2, 0) / (n - 1);
|
|
66
|
+
const globalStd = Math.sqrt(globalVariance);
|
|
67
|
+
const anomalies = [];
|
|
68
|
+
for (let i = window; i < n; i++) {
|
|
69
|
+
const z = zScore(values, i, window);
|
|
70
|
+
if (z === null)
|
|
71
|
+
continue;
|
|
72
|
+
const absZ = Math.abs(z);
|
|
73
|
+
if (absZ < threshold)
|
|
74
|
+
continue;
|
|
75
|
+
let anomalyType;
|
|
76
|
+
if (z > 0)
|
|
77
|
+
anomalyType = "spike";
|
|
78
|
+
else if (z < 0)
|
|
79
|
+
anomalyType = "drop";
|
|
80
|
+
else
|
|
81
|
+
anomalyType = "outlier";
|
|
82
|
+
let severity;
|
|
83
|
+
if (absZ >= 4)
|
|
84
|
+
severity = "critical";
|
|
85
|
+
else if (absZ >= 3)
|
|
86
|
+
severity = "high";
|
|
87
|
+
else if (absZ >= 2.5)
|
|
88
|
+
severity = "medium";
|
|
89
|
+
else
|
|
90
|
+
severity = "low";
|
|
91
|
+
anomalies.push({
|
|
92
|
+
index: i,
|
|
93
|
+
timestamp: opts.timestamps?.[i] ?? `index_${i}`,
|
|
94
|
+
value: values[i],
|
|
95
|
+
zScore: Math.round(z * 100) / 100,
|
|
96
|
+
anomalyType,
|
|
97
|
+
severity,
|
|
98
|
+
context: `Value ${z > 0 ? "above" : "below"} mean by ${absZ.toFixed(1)} std devs`,
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
anomalies.sort((a, b) => Math.abs(b.zScore) - Math.abs(a.zScore));
|
|
102
|
+
return {
|
|
103
|
+
anomalies,
|
|
104
|
+
totalPoints: n,
|
|
105
|
+
mean: Math.round(globalMean * 100) / 100,
|
|
106
|
+
stdDev: Math.round(globalStd * 100) / 100,
|
|
107
|
+
provenance: makeProvenance("anomaly_detector"),
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
export function correlateTimelines(opts) {
|
|
111
|
+
if (opts.test)
|
|
112
|
+
return MOCK_CORRELATIONS;
|
|
113
|
+
const windowDays = opts.windowDays ?? 14;
|
|
114
|
+
const minScore = opts.minScore ?? 50;
|
|
115
|
+
const correlations = [];
|
|
116
|
+
for (const source of opts.sourceEvents) {
|
|
117
|
+
const sourceDate = parseDate(source.date);
|
|
118
|
+
if (!sourceDate)
|
|
119
|
+
continue;
|
|
120
|
+
for (const target of opts.targetEvents) {
|
|
121
|
+
const targetDate = parseDate(target.date);
|
|
122
|
+
if (!targetDate)
|
|
123
|
+
continue;
|
|
124
|
+
const lag = daysBetween(sourceDate, targetDate);
|
|
125
|
+
if (Math.abs(lag) > windowDays)
|
|
126
|
+
continue;
|
|
127
|
+
let correlationType;
|
|
128
|
+
if (lag > 1)
|
|
129
|
+
correlationType = "precedes";
|
|
130
|
+
else if (lag < -1)
|
|
131
|
+
correlationType = "follows";
|
|
132
|
+
else
|
|
133
|
+
correlationType = "concurrent";
|
|
134
|
+
const timingScore = Math.max(0, 100 - Math.abs(lag) * 7);
|
|
135
|
+
const typeBoost = (source.type === "insider_trade" && target.type === "announcement") ? 20 : 0;
|
|
136
|
+
const score = Math.min(100, timingScore + typeBoost);
|
|
137
|
+
if (score < minScore)
|
|
138
|
+
continue;
|
|
139
|
+
correlations.push({
|
|
140
|
+
sourceEvent: source,
|
|
141
|
+
targetEvent: target,
|
|
142
|
+
lagDays: lag,
|
|
143
|
+
correlationScore: score,
|
|
144
|
+
correlationType,
|
|
145
|
+
evidence: `${source.type} "${source.description}" ${correlationType} ${target.type} "${target.description}" by ${Math.abs(lag)} days`,
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
correlations.sort((a, b) => b.correlationScore - a.correlationScore);
|
|
150
|
+
const avgLag = correlations.length > 0
|
|
151
|
+
? correlations.reduce((sum, c) => sum + Math.abs(c.lagDays), 0) / correlations.length
|
|
152
|
+
: 0;
|
|
153
|
+
return {
|
|
154
|
+
correlations,
|
|
155
|
+
totalSourceEvents: opts.sourceEvents.length,
|
|
156
|
+
totalTargetEvents: opts.targetEvents.length,
|
|
157
|
+
avgLag: Math.round(avgLag * 10) / 10,
|
|
158
|
+
provenance: makeProvenance("timeline_correlator"),
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
export function analyzeNetworkCentrality(opts) {
|
|
162
|
+
if (opts.test)
|
|
163
|
+
return MOCK_CENTRALITY;
|
|
164
|
+
const { nodes, edges } = opts.graph;
|
|
165
|
+
const topN = opts.topN ?? 20;
|
|
166
|
+
const n = nodes.length;
|
|
167
|
+
if (n === 0)
|
|
168
|
+
return { nodes: [], totalNodes: 0, totalEdges: 0, density: 0, provenance: makeProvenance("network_centrality") };
|
|
169
|
+
const adj = new Map();
|
|
170
|
+
for (const node of nodes)
|
|
171
|
+
adj.set(node.id, new Map());
|
|
172
|
+
for (const edge of edges) {
|
|
173
|
+
const w = edge.weight ?? 1;
|
|
174
|
+
adj.get(edge.source)?.set(edge.target, w);
|
|
175
|
+
adj.get(edge.target)?.set(edge.source, w);
|
|
176
|
+
}
|
|
177
|
+
const maxDegree = Math.max(1, n - 1);
|
|
178
|
+
const nodeIds = nodes.map((n) => n.id);
|
|
179
|
+
const nodeLabels = new Map(nodes.map((n) => [n.id, n.label ?? n.id]));
|
|
180
|
+
const degreeCentrality = new Map();
|
|
181
|
+
for (const [id, neighbors] of adj) {
|
|
182
|
+
degreeCentrality.set(id, neighbors.size / maxDegree);
|
|
183
|
+
}
|
|
184
|
+
const dist = new Map();
|
|
185
|
+
const paths = new Map();
|
|
186
|
+
for (const source of nodeIds) {
|
|
187
|
+
const d = new Map();
|
|
188
|
+
const p = new Map();
|
|
189
|
+
const visited = new Set();
|
|
190
|
+
const queue = [[source, 0]];
|
|
191
|
+
d.set(source, 0);
|
|
192
|
+
p.set(source, 1);
|
|
193
|
+
while (queue.length > 0) {
|
|
194
|
+
queue.sort((a, b) => a[1] - b[1]);
|
|
195
|
+
const [u, du] = queue.shift();
|
|
196
|
+
if (visited.has(u))
|
|
197
|
+
continue;
|
|
198
|
+
visited.add(u);
|
|
199
|
+
for (const [v, w] of adj.get(u) ?? []) {
|
|
200
|
+
const alt = du + w;
|
|
201
|
+
if (!d.has(v) || alt < d.get(v)) {
|
|
202
|
+
d.set(v, alt);
|
|
203
|
+
p.set(v, p.get(u) ?? 1);
|
|
204
|
+
queue.push([v, alt]);
|
|
205
|
+
}
|
|
206
|
+
else if (alt === d.get(v)) {
|
|
207
|
+
p.set(v, (p.get(v) ?? 0) + (p.get(u) ?? 1));
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
dist.set(source, d);
|
|
212
|
+
paths.set(source, p);
|
|
213
|
+
}
|
|
214
|
+
const betweenness = new Map();
|
|
215
|
+
for (const id of nodeIds)
|
|
216
|
+
betweenness.set(id, 0);
|
|
217
|
+
for (const s of nodeIds) {
|
|
218
|
+
for (const t of nodeIds) {
|
|
219
|
+
if (s === t)
|
|
220
|
+
continue;
|
|
221
|
+
const totalPaths = paths.get(s)?.get(t) ?? 0;
|
|
222
|
+
if (totalPaths === 0)
|
|
223
|
+
continue;
|
|
224
|
+
for (const v of nodeIds) {
|
|
225
|
+
if (v === s || v === t)
|
|
226
|
+
continue;
|
|
227
|
+
const sv = dist.get(s)?.get(v);
|
|
228
|
+
const vt = dist.get(v)?.get(t);
|
|
229
|
+
const st = dist.get(s)?.get(t);
|
|
230
|
+
if (sv === undefined || vt === undefined || st === undefined)
|
|
231
|
+
continue;
|
|
232
|
+
if (sv + vt === st) {
|
|
233
|
+
const pathsThrough = (paths.get(s)?.get(v) ?? 0) * (paths.get(v)?.get(t) ?? 0);
|
|
234
|
+
betweenness.set(v, (betweenness.get(v) ?? 0) + pathsThrough / totalPaths);
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
const normFactor = n > 2 ? (n - 1) * (n - 2) : 1;
|
|
240
|
+
for (const [id, val] of betweenness)
|
|
241
|
+
betweenness.set(id, val / normFactor);
|
|
242
|
+
const closeness = new Map();
|
|
243
|
+
for (const id of nodeIds) {
|
|
244
|
+
const distances = dist.get(id);
|
|
245
|
+
if (!distances) {
|
|
246
|
+
closeness.set(id, 0);
|
|
247
|
+
continue;
|
|
248
|
+
}
|
|
249
|
+
const totalDist = [...distances.values()].reduce((a, b) => a + b, 0);
|
|
250
|
+
closeness.set(id, totalDist > 0 ? (distances.size - 1) / totalDist : 0);
|
|
251
|
+
}
|
|
252
|
+
const pageRank = new Map();
|
|
253
|
+
const damping = 0.85;
|
|
254
|
+
for (const id of nodeIds)
|
|
255
|
+
pageRank.set(id, 1 / n);
|
|
256
|
+
for (let iter = 0; iter < 20; iter++) {
|
|
257
|
+
const newRank = new Map();
|
|
258
|
+
for (const id of nodeIds)
|
|
259
|
+
newRank.set(id, (1 - damping) / n);
|
|
260
|
+
for (const id of nodeIds) {
|
|
261
|
+
const neighbors = adj.get(id);
|
|
262
|
+
if (!neighbors || neighbors.size === 0)
|
|
263
|
+
continue;
|
|
264
|
+
const share = (pageRank.get(id) ?? 0) / neighbors.size;
|
|
265
|
+
for (const neighbor of neighbors.keys()) {
|
|
266
|
+
newRank.set(neighbor, (newRank.get(neighbor) ?? 0) + damping * share);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
for (const [id, val] of newRank)
|
|
270
|
+
pageRank.set(id, val);
|
|
271
|
+
}
|
|
272
|
+
const result = nodeIds.map((id) => ({
|
|
273
|
+
nodeId: id,
|
|
274
|
+
label: nodeLabels.get(id) ?? id,
|
|
275
|
+
degreeCentrality: Math.round((degreeCentrality.get(id) ?? 0) * 1000) / 1000,
|
|
276
|
+
betweennessCentrality: Math.round((betweenness.get(id) ?? 0) * 1000) / 1000,
|
|
277
|
+
closenessCentrality: Math.round((closeness.get(id) ?? 0) * 1000) / 1000,
|
|
278
|
+
pageRank: Math.round((pageRank.get(id) ?? 0) * 10000) / 10000,
|
|
279
|
+
clusterCoefficient: 0,
|
|
280
|
+
}));
|
|
281
|
+
result.sort((a, b) => b.pageRank - a.pageRank);
|
|
282
|
+
const density = n > 1 ? (2 * edges.length) / (n * (n - 1)) : 0;
|
|
283
|
+
return {
|
|
284
|
+
nodes: result.slice(0, topN),
|
|
285
|
+
totalNodes: n,
|
|
286
|
+
totalEdges: edges.length,
|
|
287
|
+
density: Math.round(density * 1000) / 1000,
|
|
288
|
+
provenance: makeProvenance("network_centrality"),
|
|
289
|
+
};
|
|
290
|
+
}
|
|
291
|
+
// ── prediction_market_arbitrage ──────────────────────────────────
|
|
292
|
+
export function detectArbitrage(opts) {
|
|
293
|
+
if (opts.test)
|
|
294
|
+
return MOCK_ARBITRAGE;
|
|
295
|
+
const minSpread = opts.minSpread ?? 3.0;
|
|
296
|
+
const byQuestion = new Map();
|
|
297
|
+
for (const m of opts.markets) {
|
|
298
|
+
const key = m.question.toLowerCase().trim();
|
|
299
|
+
const group = byQuestion.get(key) ?? [];
|
|
300
|
+
group.push(m);
|
|
301
|
+
byQuestion.set(key, group);
|
|
302
|
+
}
|
|
303
|
+
const opportunities = [];
|
|
304
|
+
for (const [, group] of byQuestion) {
|
|
305
|
+
if (group.length < 2)
|
|
306
|
+
continue;
|
|
307
|
+
for (let i = 0; i < group.length; i++) {
|
|
308
|
+
for (let j = i + 1; j < group.length; j++) {
|
|
309
|
+
const a = group[i], b = group[j];
|
|
310
|
+
const spread = Math.abs(a.yesPrice - b.yesPrice) * 100;
|
|
311
|
+
if (spread >= minSpread) {
|
|
312
|
+
const buyFrom = a.yesPrice < b.yesPrice ? a : b;
|
|
313
|
+
const sellTo = a.yesPrice < b.yesPrice ? b : a;
|
|
314
|
+
const profit = (sellTo.yesPrice - buyFrom.yesPrice) * 1000;
|
|
315
|
+
const factors = [["price_divergence", Math.min(spread * 5, 50)]];
|
|
316
|
+
if ((buyFrom.liquidity ?? 0) > 10000 && (sellTo.liquidity ?? 0) > 10000) {
|
|
317
|
+
factors.push(["sufficient_liquidity", 30]);
|
|
318
|
+
}
|
|
319
|
+
if (spread > 10)
|
|
320
|
+
factors.push(["large_spread", 20]);
|
|
321
|
+
opportunities.push({
|
|
322
|
+
question: group[0].question,
|
|
323
|
+
platforms: group.map((m) => ({ platform: m.platform, yesPrice: m.yesPrice, noPrice: m.noPrice })),
|
|
324
|
+
spreadPct: Math.round(spread * 100) / 100,
|
|
325
|
+
estimatedProfit: Math.round(profit * 100) / 100,
|
|
326
|
+
risk: spread > 15 ? "high" : spread > 8 ? "medium" : "low",
|
|
327
|
+
confidence: computeConfidence(factors),
|
|
328
|
+
});
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
opportunities.sort((a, b) => b.spreadPct - a.spreadPct);
|
|
334
|
+
return {
|
|
335
|
+
opportunities,
|
|
336
|
+
totalScanned: opts.markets.length,
|
|
337
|
+
provenance: makeProvenance("prediction_market_arbitrage"),
|
|
338
|
+
};
|
|
339
|
+
}
|
|
340
|
+
//# sourceMappingURL=advanced-analytics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"advanced-analytics.js","sourceRoot":"","sources":["../../src/investigation-tools/advanced-analytics.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* blockchain-scanner.ts — Polygon, Ethereum, and blockchain transaction tools.
|
|
3
|
+
*
|
|
4
|
+
* Tools: polygonscan_wallet, etherscan_wallet, blockchain_tx_tracer
|
|
5
|
+
*/
|
|
6
|
+
import { type Provenance } from "./shared-crypto.js";
|
|
7
|
+
export interface WalletTransaction {
|
|
8
|
+
hash: string;
|
|
9
|
+
blockNumber: number;
|
|
10
|
+
timestamp: string;
|
|
11
|
+
from: string;
|
|
12
|
+
to: string;
|
|
13
|
+
value: number;
|
|
14
|
+
tokenSymbol?: string;
|
|
15
|
+
tokenName?: string;
|
|
16
|
+
gasUsed: number;
|
|
17
|
+
gasPrice: number;
|
|
18
|
+
methodId: string;
|
|
19
|
+
isError: boolean;
|
|
20
|
+
}
|
|
21
|
+
export interface WalletInfo {
|
|
22
|
+
address: string;
|
|
23
|
+
balance: number;
|
|
24
|
+
balanceUsd?: number;
|
|
25
|
+
txCount: number;
|
|
26
|
+
label?: string;
|
|
27
|
+
ensName?: string;
|
|
28
|
+
firstSeen?: string;
|
|
29
|
+
lastSeen?: string;
|
|
30
|
+
}
|
|
31
|
+
export interface WalletScanResult {
|
|
32
|
+
wallet: WalletInfo;
|
|
33
|
+
transactions: WalletTransaction[];
|
|
34
|
+
tokenTransfers: WalletTransaction[];
|
|
35
|
+
provenance: Provenance;
|
|
36
|
+
}
|
|
37
|
+
export interface EnsResolution {
|
|
38
|
+
address: string;
|
|
39
|
+
ensName: string | null;
|
|
40
|
+
avatar?: string;
|
|
41
|
+
twitter?: string;
|
|
42
|
+
github?: string;
|
|
43
|
+
url?: string;
|
|
44
|
+
}
|
|
45
|
+
export interface TxTraceHop {
|
|
46
|
+
from: string;
|
|
47
|
+
to: string;
|
|
48
|
+
value: number;
|
|
49
|
+
token: string;
|
|
50
|
+
timestamp: string;
|
|
51
|
+
txHash: string;
|
|
52
|
+
}
|
|
53
|
+
export interface TxTraceResult {
|
|
54
|
+
origin: string;
|
|
55
|
+
hops: TxTraceHop[];
|
|
56
|
+
totalValue: number;
|
|
57
|
+
uniqueAddresses: string[];
|
|
58
|
+
depth: number;
|
|
59
|
+
provenance: Provenance;
|
|
60
|
+
}
|
|
61
|
+
export declare function scanPolygonWallet(opts: {
|
|
62
|
+
address: string;
|
|
63
|
+
apiKey?: string;
|
|
64
|
+
test?: boolean;
|
|
65
|
+
}): Promise<WalletScanResult>;
|
|
66
|
+
export interface EtherscanResult extends WalletScanResult {
|
|
67
|
+
ens?: EnsResolution;
|
|
68
|
+
}
|
|
69
|
+
export declare function scanEtherscanWallet(opts: {
|
|
70
|
+
address: string;
|
|
71
|
+
resolveEns?: boolean;
|
|
72
|
+
apiKey?: string;
|
|
73
|
+
test?: boolean;
|
|
74
|
+
}): Promise<EtherscanResult>;
|
|
75
|
+
export declare function traceTransactions(opts: {
|
|
76
|
+
address: string;
|
|
77
|
+
direction?: "outgoing" | "incoming" | "both";
|
|
78
|
+
maxDepth?: number;
|
|
79
|
+
chain?: string;
|
|
80
|
+
apiKey?: string;
|
|
81
|
+
test?: boolean;
|
|
82
|
+
}): Promise<TxTraceResult>;
|
|
83
|
+
//# sourceMappingURL=blockchain-scanner.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"blockchain-scanner.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/blockchain-scanner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* blockchain-scanner.ts — Polygon, Ethereum, and blockchain transaction tools.
|
|
3
|
+
*
|
|
4
|
+
* Tools: polygonscan_wallet, etherscan_wallet, blockchain_tx_tracer
|
|
5
|
+
*/
|
|
6
|
+
import { fetchJson } from "./shared.js";
|
|
7
|
+
import { makeProvenance, isValidEvmAddress, normalizeAddress, weiToEth, } from "./shared-crypto.js";
|
|
8
|
+
// ── Mock Data ────────────────────────────────────────────────────
|
|
9
|
+
const MOCK_POLYGON_WALLET = {
|
|
10
|
+
wallet: {
|
|
11
|
+
address: "0xabc123def456789", balance: 12.5, txCount: 342,
|
|
12
|
+
label: "Polymarket Whale", firstSeen: "2024-03-15", lastSeen: "2026-02-20",
|
|
13
|
+
},
|
|
14
|
+
transactions: [
|
|
15
|
+
{
|
|
16
|
+
hash: "0xtx001", blockNumber: 52_000_000, timestamp: "2026-02-20T10:30:00Z",
|
|
17
|
+
from: "0xabc123def456789", to: "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
|
|
18
|
+
value: 50000, gasUsed: 150000, gasPrice: 30, methodId: "0x", isError: false,
|
|
19
|
+
},
|
|
20
|
+
],
|
|
21
|
+
tokenTransfers: [
|
|
22
|
+
{
|
|
23
|
+
hash: "0xtx002", blockNumber: 52_000_001, timestamp: "2026-02-20T10:31:00Z",
|
|
24
|
+
from: "0xabc123def456789", to: "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
|
|
25
|
+
value: 50000, tokenSymbol: "USDC", tokenName: "USD Coin",
|
|
26
|
+
gasUsed: 120000, gasPrice: 30, methodId: "0xa9059cbb", isError: false,
|
|
27
|
+
},
|
|
28
|
+
],
|
|
29
|
+
provenance: makeProvenance("polygonscan", "test://mock", ["test_mode"]),
|
|
30
|
+
};
|
|
31
|
+
const MOCK_ETH_WALLET = {
|
|
32
|
+
wallet: {
|
|
33
|
+
address: "0xabc123def456789", balance: 45.2, txCount: 1200,
|
|
34
|
+
label: "Known Trader", ensName: "whaletrader.eth",
|
|
35
|
+
firstSeen: "2021-06-10", lastSeen: "2026-02-20",
|
|
36
|
+
},
|
|
37
|
+
transactions: [],
|
|
38
|
+
tokenTransfers: [],
|
|
39
|
+
provenance: makeProvenance("etherscan", "test://mock", ["test_mode"]),
|
|
40
|
+
};
|
|
41
|
+
const MOCK_TX_TRACE = {
|
|
42
|
+
origin: "0xabc123",
|
|
43
|
+
hops: [
|
|
44
|
+
{ from: "0xabc123", to: "0xdef456", value: 100000, token: "USDC", timestamp: "2026-02-20T10:00:00Z", txHash: "0xtx1" },
|
|
45
|
+
{ from: "0xdef456", to: "0x789abc", value: 95000, token: "USDC", timestamp: "2026-02-20T10:05:00Z", txHash: "0xtx2" },
|
|
46
|
+
{ from: "0x789abc", to: "0xpolymarket", value: 95000, token: "USDC", timestamp: "2026-02-20T10:10:00Z", txHash: "0xtx3" },
|
|
47
|
+
],
|
|
48
|
+
totalValue: 100000,
|
|
49
|
+
uniqueAddresses: ["0xabc123", "0xdef456", "0x789abc", "0xpolymarket"],
|
|
50
|
+
depth: 3,
|
|
51
|
+
provenance: makeProvenance("blockchain_tx_tracer", "test://mock", ["test_mode"]),
|
|
52
|
+
};
|
|
53
|
+
// ── Helpers ──────────────────────────────────────────────────────
|
|
54
|
+
async function scanExplorerApi(baseUrl, address, apiKey, chain) {
|
|
55
|
+
if (!isValidEvmAddress(address)) {
|
|
56
|
+
throw new Error(`Invalid EVM address: ${address}`);
|
|
57
|
+
}
|
|
58
|
+
const keyParam = apiKey ? `&apikey=${apiKey}` : "";
|
|
59
|
+
const balUrl = `${baseUrl}?module=account&action=balance&address=${address}&tag=latest${keyParam}`;
|
|
60
|
+
const txUrl = `${baseUrl}?module=account&action=txlist&address=${address}&startblock=0&endblock=99999999&sort=desc&page=1&offset=100${keyParam}`;
|
|
61
|
+
const tokenUrl = `${baseUrl}?module=account&action=tokentx&address=${address}&startblock=0&endblock=99999999&sort=desc&page=1&offset=100${keyParam}`;
|
|
62
|
+
const [balData, txData, tokenData] = await Promise.all([
|
|
63
|
+
fetchJson(balUrl, { delay: 0.3 }),
|
|
64
|
+
fetchJson(txUrl, { delay: 0.3 }),
|
|
65
|
+
fetchJson(tokenUrl, { delay: 0.3 }),
|
|
66
|
+
]);
|
|
67
|
+
const balance = weiToEth(balData.result ?? "0");
|
|
68
|
+
const txList = Array.isArray(txData.result) ? txData.result : [];
|
|
69
|
+
const tokenList = Array.isArray(tokenData.result) ? tokenData.result : [];
|
|
70
|
+
const mapTx = (t, isToken = false) => ({
|
|
71
|
+
hash: String(t.hash ?? ""),
|
|
72
|
+
blockNumber: Number(t.blockNumber ?? 0),
|
|
73
|
+
timestamp: new Date(Number(t.timeStamp ?? 0) * 1000).toISOString(),
|
|
74
|
+
from: String(t.from ?? ""),
|
|
75
|
+
to: String(t.to ?? ""),
|
|
76
|
+
value: isToken ? Number(t.value ?? 0) / 10 ** Number(t.tokenDecimal ?? 18) : weiToEth(String(t.value ?? "0")),
|
|
77
|
+
tokenSymbol: isToken ? String(t.tokenSymbol ?? "") : undefined,
|
|
78
|
+
tokenName: isToken ? String(t.tokenName ?? "") : undefined,
|
|
79
|
+
gasUsed: Number(t.gasUsed ?? 0),
|
|
80
|
+
gasPrice: Number(t.gasPrice ?? 0),
|
|
81
|
+
methodId: String(t.methodId ?? t.input?.toString().slice(0, 10) ?? ""),
|
|
82
|
+
isError: t.isError === "1",
|
|
83
|
+
});
|
|
84
|
+
const firstTx = txList.length > 0 ? txList[txList.length - 1] : null;
|
|
85
|
+
const lastTx = txList.length > 0 ? txList[0] : null;
|
|
86
|
+
return {
|
|
87
|
+
wallet: {
|
|
88
|
+
address: normalizeAddress(address),
|
|
89
|
+
balance,
|
|
90
|
+
txCount: txList.length,
|
|
91
|
+
firstSeen: firstTx ? new Date(Number(firstTx.timeStamp ?? 0) * 1000).toISOString().slice(0, 10) : undefined,
|
|
92
|
+
lastSeen: lastTx ? new Date(Number(lastTx.timeStamp ?? 0) * 1000).toISOString().slice(0, 10) : undefined,
|
|
93
|
+
},
|
|
94
|
+
transactions: txList.map((t) => mapTx(t)),
|
|
95
|
+
tokenTransfers: tokenList.map((t) => mapTx(t, true)),
|
|
96
|
+
provenance: makeProvenance(chain, `${baseUrl}?address=${address}`),
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
// ── polygonscan_wallet ───────────────────────────────────────────
|
|
100
|
+
export async function scanPolygonWallet(opts) {
|
|
101
|
+
if (opts.test)
|
|
102
|
+
return MOCK_POLYGON_WALLET;
|
|
103
|
+
const apiKey = opts.apiKey ?? process.env.POLYGONSCAN_API_KEY;
|
|
104
|
+
return scanExplorerApi("https://api.polygonscan.com/api", opts.address, apiKey, "polygonscan");
|
|
105
|
+
}
|
|
106
|
+
export async function scanEtherscanWallet(opts) {
|
|
107
|
+
if (opts.test)
|
|
108
|
+
return { ...MOCK_ETH_WALLET, ens: { address: MOCK_ETH_WALLET.wallet.address, ensName: "whaletrader.eth", twitter: "@whaletrader" } };
|
|
109
|
+
const apiKey = opts.apiKey ?? process.env.ETHERSCAN_API_KEY;
|
|
110
|
+
const result = await scanExplorerApi("https://api.etherscan.io/api", opts.address, apiKey, "etherscan");
|
|
111
|
+
let ens;
|
|
112
|
+
if (opts.resolveEns !== false) {
|
|
113
|
+
try {
|
|
114
|
+
const ensUrl = `https://api.ensideas.com/ens/resolve/${opts.address}`;
|
|
115
|
+
const ensData = await fetchJson(ensUrl, { delay: 0.3 });
|
|
116
|
+
if (ensData.name) {
|
|
117
|
+
ens = {
|
|
118
|
+
address: opts.address,
|
|
119
|
+
ensName: String(ensData.name),
|
|
120
|
+
avatar: ensData.avatar ? String(ensData.avatar) : undefined,
|
|
121
|
+
twitter: ensData.twitter ? String(ensData.twitter) : undefined,
|
|
122
|
+
github: ensData.github ? String(ensData.github) : undefined,
|
|
123
|
+
};
|
|
124
|
+
result.wallet.ensName = ens.ensName ?? undefined;
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
catch {
|
|
128
|
+
// ENS resolution failure is non-fatal
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
return { ...result, ens };
|
|
132
|
+
}
|
|
133
|
+
// ── blockchain_tx_tracer ─────────────────────────────────────────
|
|
134
|
+
export async function traceTransactions(opts) {
|
|
135
|
+
if (opts.test)
|
|
136
|
+
return MOCK_TX_TRACE;
|
|
137
|
+
const chain = opts.chain ?? "polygon";
|
|
138
|
+
const maxDepth = Math.min(opts.maxDepth ?? 3, 5);
|
|
139
|
+
const direction = opts.direction ?? "outgoing";
|
|
140
|
+
const baseUrl = chain === "ethereum"
|
|
141
|
+
? "https://api.etherscan.io/api"
|
|
142
|
+
: "https://api.polygonscan.com/api";
|
|
143
|
+
const apiKey = opts.apiKey ?? (chain === "ethereum" ? process.env.ETHERSCAN_API_KEY : process.env.POLYGONSCAN_API_KEY);
|
|
144
|
+
const visited = new Set();
|
|
145
|
+
const hops = [];
|
|
146
|
+
const queue = [{ address: normalizeAddress(opts.address), depth: 0 }];
|
|
147
|
+
while (queue.length > 0 && hops.length < 200) {
|
|
148
|
+
const item = queue.shift();
|
|
149
|
+
if (item.depth >= maxDepth || visited.has(item.address))
|
|
150
|
+
continue;
|
|
151
|
+
visited.add(item.address);
|
|
152
|
+
const keyParam = apiKey ? `&apikey=${apiKey}` : "";
|
|
153
|
+
const txUrl = `${baseUrl}?module=account&action=tokentx&address=${item.address}&startblock=0&endblock=99999999&sort=desc&page=1&offset=50${keyParam}`;
|
|
154
|
+
try {
|
|
155
|
+
const data = await fetchJson(txUrl, { delay: 0.5 });
|
|
156
|
+
const txList = Array.isArray(data.result) ? data.result : [];
|
|
157
|
+
for (const tx of txList) {
|
|
158
|
+
const from = normalizeAddress(String(tx.from ?? ""));
|
|
159
|
+
const to = normalizeAddress(String(tx.to ?? ""));
|
|
160
|
+
const isRelevant = (direction === "outgoing" && from === item.address)
|
|
161
|
+
|| (direction === "incoming" && to === item.address)
|
|
162
|
+
|| direction === "both";
|
|
163
|
+
if (isRelevant) {
|
|
164
|
+
const hop = {
|
|
165
|
+
from, to,
|
|
166
|
+
value: Number(tx.value ?? 0) / 10 ** Number(tx.tokenDecimal ?? 18),
|
|
167
|
+
token: String(tx.tokenSymbol ?? "ETH"),
|
|
168
|
+
timestamp: new Date(Number(tx.timeStamp ?? 0) * 1000).toISOString(),
|
|
169
|
+
txHash: String(tx.hash ?? ""),
|
|
170
|
+
};
|
|
171
|
+
hops.push(hop);
|
|
172
|
+
const nextAddr = direction === "outgoing" ? to : from;
|
|
173
|
+
if (!visited.has(nextAddr)) {
|
|
174
|
+
queue.push({ address: nextAddr, depth: item.depth + 1 });
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
catch {
|
|
180
|
+
// Continue tracing on failure
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
const totalValue = hops.reduce((sum, h) => sum + h.value, 0);
|
|
184
|
+
const uniqueAddresses = [...visited];
|
|
185
|
+
return {
|
|
186
|
+
origin: normalizeAddress(opts.address),
|
|
187
|
+
hops,
|
|
188
|
+
totalValue,
|
|
189
|
+
uniqueAddresses,
|
|
190
|
+
depth: maxDepth,
|
|
191
|
+
provenance: makeProvenance("blockchain_tx_tracer", baseUrl),
|
|
192
|
+
};
|
|
193
|
+
}
|
|
194
|
+
//# sourceMappingURL=blockchain-scanner.js.map
|