@xrpl-utilities/mcp 0.2.110 → 0.2.112

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 (13) hide show
  1. package/dist/services/flows.js +13 -46
  2. package/dist/services/flows.js.map +1 -1
  3. package/dist/services/pulse.js +37 -144
  4. package/dist/services/pulse.js.map +1 -1
  5. package/dist/services/sentinel.js +7 -21
  6. package/dist/services/sentinel.js.map +1 -1
  7. package/dist/services/telemetry.js +20 -48
  8. package/dist/services/telemetry.js.map +1 -1
  9. package/dist/services/trust.js +31 -74
  10. package/dist/services/trust.js.map +1 -1
  11. package/dist/services/vault.js +7 -33
  12. package/dist/services/vault.js.map +1 -1
  13. package/package.json +1 -1
package/dist/services/flows.js CHANGED
@@ -17,31 +17,18 @@ export const flows = {
17
17
  {
18
18
  name: "xrpl_flows_scan",
19
19
  description: "Paid ($0.10 USD). " +
20
- "Per-ETF deep dive for any of the six US-listed spot XRP ETFs " +
21
- "(Bitwise XRP, Canary XRPC, Franklin Templeton XRPZ, Grayscale " +
22
- "GXRP, 21Shares TOXR, REX-Osprey XRPR). Returns the ticker's " +
23
- "registry metadata (launch date, expense ratio, source URL, " +
24
- "asset class, any operator caveat), latest reading (current " +
25
- "AUM, xrp_held when available, NAV, source lineage), full " +
26
- "accruing daily history with per-day AUM and source labels, " +
27
- "and the latest XRPL exchange-flow delta row from XR-Pulse " +
28
- "as the on-chain side of the correlation. An inline re-scrape " +
29
- "fires before the response is built so the latest_reading is " +
30
- "current-as-of-call, not as-of-last-hourly-loop. $0.10 USD " +
31
- "per call paid via x402 v2 (XRPL `exact` scheme, t54 " +
32
- "facilitator; XRP and RLUSD both accepted).",
20
+ "Per-ETF deep dive for US-listed spot XRP ETFs (XRP/XRPC/XRPZ/GXRP/TOXR/XRPR): " +
21
+ "metadata, latest AUM reading, daily history, and on-chain exchange-flow delta.",
33
22
  inputSchema: {
34
23
  type: "object",
35
24
  properties: {
36
25
  ticker: {
37
26
  type: "string",
38
- description: "ETF ticker (case-insensitive). One of XRP, XRPC, XRPZ, " +
39
- "GXRP, TOXR, XRPR. Returns 404 when the ticker is not " +
40
- "in the operator-curated registry.",
27
+ description: "ETF ticker, e.g. XRP, XRPC, GXRP.",
41
28
  },
42
29
  payment_signature: {
43
30
  type: "string",
44
- description: "x402 v2 PAYMENT-SIGNATURE header.",
31
+ description: "x402 payment header.",
45
32
  },
46
33
  },
47
34
  required: ["ticker"],
@@ -56,25 +43,17 @@ export const flows = {
56
43
  {
57
44
  name: "xrpl_flows_correlation",
58
45
  description: "Free. " +
59
- "Daily ETF AUM and XRPL exchange-flow delta for the six US-listed " +
60
- "spot XRP ETFs (Bitwise XRP, Canary XRPC, Franklin XRPZ, Grayscale " +
61
- "GXRP, 21Shares TOXR, REX-Osprey XRPR). Returns per-ticker daily " +
62
- "AUM with day-over-day delta, a chain_flow_daily series from " +
63
- "XR-Pulse, and a 7-day rolling Pearson coefficient measuring how " +
64
- "tightly ETF flow aligns with on-chain flow. CORRELATION ONLY, " +
65
- "NEVER CAUSATION: ETFs hold XRP via pooled institutional custody " +
66
- "so on-chain wallets cannot be attributed to a specific fund. " +
67
- "v1.0.0: per-issuer scrapers are stubbed; AUM fields return null " +
68
- "until v1.x lands real readings.",
46
+ "Daily ETF AUM vs XRPL exchange-flow delta for six spot XRP ETFs with " +
47
+ "7-day rolling Pearson correlation. Correlation only, not causation.",
69
48
  inputSchema: {
70
49
  type: "object",
71
50
  properties: {
72
51
  days: {
73
52
  type: "integer",
53
+ description: "Trailing days.",
74
54
  minimum: 1,
75
55
  maximum: 90,
76
56
  default: 30,
77
- description: "Days of history to return (1-90, default 30).",
78
57
  },
79
58
  },
80
59
  additionalProperties: false,
@@ -86,30 +65,24 @@ export const flows = {
86
65
  {
87
66
  name: "xrpl_flows_cross_border_flow",
88
67
  description: "Free. " +
89
- "XRPL institutional cross-border settlement edges: country-pair " +
90
- "flow aggregates over a configurable window. A Payment counts " +
91
- "as a cross-border edge only when BOTH sender and receiver " +
92
- "XRPScan labels resolve to operator-curated jurisdictions AND " +
93
- "those countries differ. Returns per-country inbound/outbound/net " +
94
- "USD plus top corridors plus an honest coverage block. Labeled " +
95
- "wallets only - the institutional/exchange/issuer layer, not " +
96
- "retail. Free; aggregates of public on-chain data.",
68
+ "XRPL cross-border settlement flow: country-pair aggregates (inbound/outbound/net USD), " +
69
+ "top corridors, and coverage block. Institutional/exchange wallets only.",
97
70
  inputSchema: {
98
71
  type: "object",
99
72
  properties: {
100
73
  window_days: {
101
74
  type: "integer",
75
+ description: "Trailing days.",
102
76
  minimum: 1,
103
77
  maximum: 365,
104
78
  default: 30,
105
- description: "Trailing window in UTC days.",
106
79
  },
107
80
  top_corridors: {
108
81
  type: "integer",
82
+ description: "Max corridors returned.",
109
83
  minimum: 1,
110
84
  maximum: 200,
111
85
  default: 20,
112
- description: "Cap on the top_corridors[] list.",
113
86
  },
114
87
  },
115
88
  additionalProperties: false,
@@ -121,14 +94,8 @@ export const flows = {
121
94
  {
122
95
  name: "xrpl_flows_launch_impact",
123
96
  description: "Free. " +
124
- "Per-ETF launch-window analysis: for each tracked spot XRP ETF, " +
125
- "returns its launch date and a [L-30, L+30] window summary of " +
126
- "XRPL exchange-flow delta + DEX volume. The post-window vs " +
127
- "pre-window ratio is the headline 'launch impact' figure. Static " +
128
- "analysis; recomputed on demand rather than polled. v1.0.0 " +
129
- "returns the launch metadata only; the on-chain delta window " +
130
- "analysis lands once Pulse /stats/exchange-flow-delta is shipped " +
131
- "and a recompute pass runs.",
97
+ "Per-ETF launch-window analysis: [L-30, L+30] exchange-flow delta and DEX " +
98
+ "volume around each spot XRP ETF launch date.",
132
99
  inputSchema: {
133
100
  type: "object",
134
101
  properties: {},
package/dist/services/flows.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"flows.js","sourceRoot":"","sources":["../../src/services/flows.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"flows.js","sourceRoot":"","sources":["../../src/services/flows.ts"],"names":[],"mappings":"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"}
package/dist/services/pulse.js CHANGED
@@ -18,66 +18,39 @@ export const pulse = {
18
18
  {
19
19
  name: "xrpl_pulse_recent_events",
20
20
  description: "Paid ($0.10 USD). " +
21
- "Return the most-recent normalized XRPL signal events newest-first. " +
22
- "Mixes six streams: public-source news (regulatory press + " +
23
- "central banks + crypto media filtered for XRP/RLUSD/XRPL/Ripple), " +
24
- "on-chain whale activity (every Payment above the storage " +
25
- "threshold), XLS-70/80/81 permissioned-domain lifecycle events " +
26
- "sourced from XR-Trust, Sentinel state-change signals " +
27
- "(activity-level transitions + first-fire of " +
28
- "INSTITUTIONAL_SCALE_FLOW / DORMANT_REAWAKENING / " +
29
- "SCORE_TRAJECTORY_BOT_ONBOARDING), RWA issuer per-mint/per-burn " +
30
- "flow (Ondo OUSG (permissioned + public), Schuman EUROP, " +
31
- "Braza USDB + BBRL, SG-FORGE EURCV, Guggenheim DCP, Justoken " +
32
- "JMWH, OpenEden TBL, RLUSD, AUDD, Archax abrdn MMF, Circle " +
33
- "USDCAllow, Ctrl Alt DIA-L-COL1, Ctrl Alt DLD-25-24722-IAHG, " +
34
- "Quantoz EURQ), and RWA issuer daily aggregate snapshots " +
35
- "(obligations + trustline-count deltas per UTC day, with " +
36
- "treasury-balance subtraction applied across USD-pegged issuers " +
37
- "as appropriate). Each event " +
38
- "carries title, brief, published_at, source_appearances[], " +
39
- "correlation (news only), active_utility (per-source canonical " +
40
- "shape), and target_addresses[]. Costs $0.10 USD per call paid " +
41
- "via x402 (XRP/RLUSD on XRPL or USDC on Base).",
21
+ "Most-recent XRPL signal events newest-first. Mixes news, whale activity, " +
22
+ "permissioned-domain lifecycle, Sentinel signals, and RWA issuer flows. " +
23
+ "Filterable by kind, time range, and min whale USD.",
42
24
  inputSchema: {
43
25
  type: "object",
44
26
  properties: {
45
27
  limit: {
46
28
  type: "integer",
47
- description: "Max events to return (1-500). Default 50.",
48
29
  minimum: 1,
49
30
  maximum: 500,
50
31
  default: 50,
51
32
  },
52
33
  since_iso: {
53
34
  type: "string",
54
- description: "ISO 8601 timestamp; only events with published_at >= this " +
55
- "are returned. Optional.",
35
+ description: "ISO 8601 lower bound on published_at.",
56
36
  },
57
37
  before_iso: {
58
38
  type: "string",
59
- description: "ISO 8601 cursor for backward pagination. When set, only " +
60
- "events strictly older than this timestamp are returned. " +
61
- "Pair with the oldest event's published_at from a prior " +
62
- "response to walk backward through history. Optional.",
39
+ description: "ISO 8601 upper bound for backward pagination.",
63
40
  },
64
41
  kind: {
65
42
  type: "string",
66
43
  enum: ["news", "activity"],
67
- description: "Source-bucket filter. 'news' returns RSS sources only; " +
68
- "'activity' returns whale + sentinel_signal + " +
69
- "permissioned_domain rows. Omit to return the mixed feed.",
44
+ description: "Filter by source bucket. Omit for mixed feed.",
70
45
  },
71
46
  min_whale_usd: {
72
47
  type: "number",
73
- description: "Suppress whale events below this USD threshold. Default " +
74
- "$1,000,000 (whale-grade only). Pass 0 to see the full " +
75
- "$50k+ activity stream.",
48
+ description: "USD floor for whale events. Default $1M.",
76
49
  minimum: 0,
77
50
  },
78
51
  payment_signature: {
79
52
  type: "string",
80
- description: "x402 v2 PAYMENT-SIGNATURE header.",
53
+ description: "x402 payment header.",
81
54
  },
82
55
  },
83
56
  additionalProperties: false,
@@ -91,39 +64,29 @@ export const pulse = {
91
64
  {
92
65
  name: "xrpl_pulse_events_by_address",
93
66
  description: "Paid ($0.10 USD). " +
94
- "Return Pulse events that reference a specific XRPL classic " +
95
- "address, newest-first. Match strategy spans all event sources: " +
96
- "whale events where the address is sender or receiver, " +
97
- "sentinel_signal events for that address, news + permissioned- " +
98
- "domain events whose target_addresses[] includes it. Useful " +
99
- "as the on-chain-history complement to xrpl_sentinel_scan " +
100
- "(behavioral classification of one wallet); together they answer " +
101
- "'what does this wallet look like AND what has it actually been " +
102
- "doing on the public feed?'. No title-similarity clustering on " +
103
- "this endpoint - events about the same wallet aren't necessarily " +
104
- "about the same story. Costs $0.10 USD per call paid via x402 (XRP/RLUSD on XRPL or USDC on Base).",
67
+ "Pulse events referencing a specific XRPL address (whale, sentinel signal, " +
68
+ "news, permissioned-domain). Complements xrpl_sentinel_scan with event history.",
105
69
  inputSchema: {
106
70
  type: "object",
107
71
  properties: {
108
72
  address: {
109
73
  type: "string",
110
- description: "XRPL classic address (starts with 'r', 25-35 chars).",
74
+ description: "XRPL r-address.",
75
+ pattern: "^r[1-9A-HJ-NP-Za-km-z]{24,34}$",
111
76
  },
112
77
  limit: {
113
78
  type: "integer",
114
- description: "Max events to return (1-200). Default 50.",
115
79
  minimum: 1,
116
80
  maximum: 200,
117
81
  default: 50,
118
82
  },
119
83
  since_iso: {
120
84
  type: "string",
121
- description: "ISO 8601 timestamp; only events with published_at >= this " +
122
- "are returned. Optional.",
85
+ description: "ISO 8601 lower bound on published_at.",
123
86
  },
124
87
  payment_signature: {
125
88
  type: "string",
126
- description: "x402 v2 PAYMENT-SIGNATURE header.",
89
+ description: "x402 payment header.",
127
90
  },
128
91
  },
129
92
  required: ["address"],
@@ -138,58 +101,37 @@ export const pulse = {
138
101
  {
139
102
  name: "xrpl_pulse_stream_purchase",
140
103
  description: "Paid (tiered: 1h ~$0.50 / 6h ~$2.50 / 24h ~$7.50). " +
141
- "Buy a time-boxed XR-Pulse live WebSocket subscription. Returns " +
142
- "a stream_token (HS256 JWT) plus a ws_url. Open the WebSocket " +
143
- "and pass the token as the ?token= query parameter; events are " +
144
- "pushed as they fire, with server-side filtering by source / " +
145
- "signal / min USD value bound into the token at purchase time. " +
146
- "Tiers: 1h ~$0.50, 6h ~$2.50, 24h ~$7.50 (XRP/RLUSD on XRPL or USDC on Base via " +
147
- "x402). Reconnect with the same token until expires_at_unix; " +
148
- "no event replay across reconnects (use xrpl_pulse_recent_events " +
149
- "to catch up history). The WebSocket itself is not exposed as " +
150
- "an MCP tool (MCP is request/response) — agents take the token " +
151
- "and open the WebSocket directly. v2 of this surface will swap " +
152
- "the time-boxed billing for native XRPL Payment Channels with " +
153
- "per-message claims.",
104
+ "Buy a time-boxed WebSocket subscription to live Pulse events. Returns " +
105
+ "a stream_token JWT and ws_url. Server-side filtering by source, signal, " +
106
+ "and min USD is bound into the token at purchase.",
154
107
  inputSchema: {
155
108
  type: "object",
156
109
  properties: {
157
110
  duration: {
158
111
  type: "string",
159
112
  enum: ["1h", "6h", "24h"],
160
- description: "Subscription window length. Default 1h.",
161
113
  default: "1h",
162
114
  },
163
115
  min_usd: {
164
116
  type: "number",
165
- description: "Optional server-side filter: drop whale-style events " +
166
- "whose active_utility.usd_value is below this floor. " +
167
- "Bound into the JWT — change filters means buying a new " +
168
- "subscription.",
117
+ description: "USD floor for whale events. Bound into JWT.",
169
118
  minimum: 0,
170
119
  },
171
120
  sources: {
172
121
  type: "array",
173
122
  items: { type: "string" },
174
- description: "Optional source allowlist (whale_xrpl, sentinel_signal, " +
175
- "permissioned_domain_lifecycle, rwa_issuer_flow, " +
176
- "rwa_issuer_daily, rwa_amm_pool_state, plus any news " +
177
- "source key). Omit to receive every source.",
123
+ description: "Source allowlist. Omit for all sources.",
178
124
  maxItems: 32,
179
125
  },
180
126
  signals: {
181
127
  type: "array",
182
128
  items: { type: "string" },
183
- description: "Optional signal allowlist (whale_transfer, " +
184
- "INSTITUTIONAL_SCALE_FLOW, issuer_deepfreeze, " +
185
- "token_escrow_event, permissioned_dex_event, etc.). " +
186
- "Filters on active_utility.signal (whale-style) or " +
187
- "active_utility.signals[].signal (news-style).",
129
+ description: "Signal allowlist. Omit for all signals.",
188
130
  maxItems: 32,
189
131
  },
190
132
  payment_signature: {
191
133
  type: "string",
192
- description: "x402 v2 PAYMENT-SIGNATURE header.",
134
+ description: "x402 payment header.",
193
135
  },
194
136
  },
195
137
  additionalProperties: false,
@@ -203,26 +145,13 @@ export const pulse = {
203
145
  {
204
146
  name: "xrpl_pulse_ripple_counterparties",
205
147
  description: "Free. " +
206
- "Anonymized view of XR-Pulse's Ripple-counterparty auto-discovery " +
207
- "loop plus the relay-burst detector. The discovery loop polls a " +
208
- "curated set of Ripple-controlled wallets (multi-signer treasuries, " +
209
- "the RLUSD distribution wallet, and TOML-attested escrow wallets) " +
210
- "for outgoing Payments to new destinations and scores each on " +
211
- "seven weighted heuristics (XRP balance, RLUSD pre-approval, " +
212
- "account age, multi-exchange connectivity, intake-treasury " +
213
- "fingerprint, Ripple-funded-MM inflow, recency). The relay-burst " +
214
- "detector flags multi-hop pure-payment chains (>=3 hops, >=$30M " +
215
- "total, >=$10M per hop, within 1h) where at least one wallet is " +
216
- "operator-labeled. Returns score-tier and funding-source " +
217
- "distributions plus relay-burst summaries (hop_count, total_usd, " +
218
- "anchor_label, news_correlation_count); specific wallet addresses " +
219
- "are intentionally NOT exposed on this surface. Free, public.",
148
+ "Anonymized Ripple-counterparty auto-discovery and relay-burst detector findings. " +
149
+ "Score-tier and funding-source distributions; specific wallet addresses not exposed.",
220
150
  inputSchema: {
221
151
  type: "object",
222
152
  properties: {
223
153
  limit: {
224
154
  type: "integer",
225
- description: "Max candidate rows to summarize (1-200). Default 50.",
226
155
  minimum: 1,
227
156
  maximum: 200,
228
157
  default: 50,
@@ -237,17 +166,8 @@ export const pulse = {
237
166
  {
238
167
  name: "xrpl_pulse_ripple_topology",
239
168
  description: "Free. " +
240
- "Public-attribution map of the Ripple ecosystem on XRPL. Three " +
241
- "columns matching the xrpl-utilities.com/lineage/ topology view: " +
242
- "Source (Ripple-published or XRPScan-attested infrastructure — " +
243
- "issuer, distribution, MM hub, root treasury, escrow wallets, " +
244
- "burn agent — wallet addresses + labels exposed), Pipeline (the " +
245
- "operator-curated middle layer; shown by role + count only, " +
246
- "specific addresses intentionally not exposed because the " +
247
- "operator-curated wallet list is the moat), and Exits (named " +
248
- "CEX hot wallets attested by XRPScan well-known — Binance, " +
249
- "Coinbase, Bitso, etc. — wallet addresses + entity names " +
250
- "exposed). Free, public.",
169
+ "Ripple ecosystem topology map: Source (treasury/issuer/escrow wallets), " +
170
+ "Pipeline (curated middle layer by role), and Exits (named CEX hot wallets).",
251
171
  inputSchema: {
252
172
  type: "object",
253
173
  properties: {},
@@ -260,24 +180,14 @@ export const pulse = {
260
180
  {
261
181
  name: "xrpl_pulse_cex_attribution",
262
182
  description: "Free. " +
263
- "Anonymized view of XR-Pulse's cex_attribution_walker findings. " +
264
- "The walker complements the relay-burst detector: it fires when " +
265
- "an operator-labeled CEX wallet (Bitso, Binance, Coinbase, Gemini, " +
266
- "Kraken, Bitstamp, OKX, Ceffu, etc.) receives a whale Payment over " +
267
- "$5M and walks the chain backward up to 4 hops within a 4h window, " +
268
- "looking for unlabeled intermediate wallets that the relay-burst " +
269
- "detector skips because they pass through long-standing Ripple " +
270
- "infrastructure that doesn't show the burst fingerprint. Each row " +
271
- "is one unlabeled intermediate plus the chain it sat in (hop " +
272
- "count, total USD, sanitized anchor label, sanitized terminal CEX " +
273
- "label). Specific wallet addresses, intermediate addresses, and " +
274
- "tx hashes are NOT exposed on this surface. Free, public.",
183
+ "CEX attribution walker findings: backward-walked payment chains ending at " +
184
+ "named exchanges. Hop count, total USD, anchor and terminal labels; " +
185
+ "specific addresses not exposed.",
275
186
  inputSchema: {
276
187
  type: "object",
277
188
  properties: {
278
189
  limit: {
279
190
  type: "integer",
280
- description: "Max candidate rows to summarize (1-200). Default 50.",
281
191
  minimum: 1,
282
192
  maximum: 200,
283
193
  default: 50,
@@ -292,12 +202,8 @@ export const pulse = {
292
202
  {
293
203
  name: "xrpl_pulse_network_stats",
294
204
  description: "Free. " +
295
- "XRPL network summary: total funded addresses (per the " +
296
- "api.xrpl.to source), live trustline count, live offer count, " +
297
- "24h active address count, and snapshot freshness. Use this as " +
298
- "a baseline-state probe before paying for /events/recent or " +
299
- "deciding whether activity-level signals are likely meaningful. " +
300
- "Free, public.",
205
+ "XRPL network summary: funded addresses, trustline count, offer count, " +
206
+ "24h active addresses, and snapshot freshness.",
301
207
  inputSchema: {
302
208
  type: "object",
303
209
  properties: {},
@@ -310,12 +216,8 @@ export const pulse = {
310
216
  {
311
217
  name: "xrpl_pulse_whale_flow_24h",
312
218
  description: "Free. " +
313
- "Aggregate of all whale_xrpl Payments above the storage " +
314
- "threshold in the trailing 24h. Returns total USD value, total " +
315
- "tx count, top sender + receiver labels (institutional " +
316
- "watchlist + auto-promoted), per-currency breakdown (XRP, RLUSD, " +
317
- "other IOUs). Comparable across services and days; no specific " +
318
- "wallet addresses are returned. Free, public.",
219
+ "Trailing 24h whale Payment aggregate: total USD, tx count, top labels, " +
220
+ "per-currency breakdown. No specific addresses returned.",
319
221
  inputSchema: {
320
222
  type: "object",
321
223
  properties: {},
@@ -328,17 +230,14 @@ export const pulse = {
328
230
  {
329
231
  name: "xrpl_pulse_exchange_flow_delta",
330
232
  description: "Free. " +
331
- "Per-UTC-day series of net XRPL exchange flow: inbound, " +
332
- "outbound, net (positive = exchanges are net-receivers of " +
333
- "XRP), 24h settlement-volume USD, active-float bridge components. " +
334
- "Same series XR-Flows /stats/correlation overlays with ETF AUM " +
335
- "for the correlation headline. Free, public.",
233
+ "Per-UTC-day series of net XRPL exchange flow: inbound, outbound, net, " +
234
+ "and settlement volume. Same series used in XR-Flows ETF correlation.",
336
235
  inputSchema: {
337
236
  type: "object",
338
237
  properties: {
339
238
  days: {
340
239
  type: "integer",
341
- description: "Trailing day count (1-90). Default 30.",
240
+ description: "Trailing days.",
342
241
  minimum: 1,
343
242
  maximum: 90,
344
243
  default: 30,
@@ -353,14 +252,8 @@ export const pulse = {
353
252
  {
354
253
  name: "xrpl_pulse_rwa_summary",
355
254
  description: "Free. " +
356
- "RWA issuer rollup: per-issuer current obligations, " +
357
- "net-circulating (treasury-adjusted where applicable), trustline " +
358
- "count, 24h mint and burn flow, AMM-of-RWA pool exposure. Covers " +
359
- "the full operator-curated issuer set plus auto-discovered " +
360
- "candidates surfaced via the rwa_issuer_discovery loop. Native " +
361
- "unit-of-account; no fabricated USD valuation. Same data backing " +
362
- "XR-Vault's per-issuer deep dive, surfaced here as a free " +
363
- "cross-issuer view. Free, public.",
255
+ "Cross-issuer RWA rollup: obligations, net-circulating supply, trustline count, " +
256
+ "24h mint/burn flow, and AMM pool exposure per tracked issuer.",
364
257
  inputSchema: {
365
258
  type: "object",
366
259
  properties: {},
package/dist/services/pulse.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/services/pulse.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/services/pulse.ts"],"names":[],"mappings":"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"}
package/dist/services/sentinel.js CHANGED
@@ -17,28 +17,19 @@ export const sentinel = {
17
17
  {
18
18
  name: "xrpl_sentinel_scan",
19
19
  description: "Paid ($0.10 USD). " +
20
- "Classify an XRPL wallet by its on-chain activity pattern. Returns " +
21
- "activity_score (0-100, higher = more automated/service-like), " +
22
- "activity_level (Low/Medium/High/Dormant/Unknown), confidence, " +
23
- "signals[] from a 35-entry behavioral catalog, top_counterparties[] " +
24
- "with public labels, an AI-generated reasoning narrative, and a " +
25
- "_delta block when prior recorded scans exist. Costs $0.10 USD per " +
26
- "call paid via x402 (XRP/RLUSD on XRPL or USDC on Base). Pass payment_signature " +
27
- "from your x402-xrpl client.",
20
+ "Classify an XRPL wallet by on-chain activity pattern. Returns activity_score (0-100), " +
21
+ "activity_level, confidence, behavioral signals, top counterparties, and AI reasoning.",
28
22
  inputSchema: {
29
23
  type: "object",
30
24
  properties: {
31
25
  address: {
32
26
  type: "string",
33
- description: "XRPL classic address (r-prefixed, base58).",
27
+ description: "XRPL r-address.",
34
28
  pattern: "^r[1-9A-HJ-NP-Za-km-z]{24,34}$",
35
29
  },
36
30
  payment_signature: {
37
31
  type: "string",
38
- description: "x402 v2 PAYMENT-SIGNATURE header (base64-encoded JSON of a " +
39
- "signed XRPL Payment matching one of the requirements returned " +
40
- "by an initial unauthenticated probe). Omit for free " +
41
- "marketing-site preview, supply for the paid agent path.",
32
+ description: "x402 payment header.",
42
33
  },
43
34
  },
44
35
  required: ["address"],
@@ -53,23 +44,18 @@ export const sentinel = {
53
44
  {
54
45
  name: "xrpl_sentinel_scan_history",
55
46
  description: "Paid ($0.10 USD). " +
56
- "Return up to 25 prior recorded scans for an address so an agent " +
57
- "can read trajectory without scanning the wallet N times. Each " +
58
- "history row carries score, level, signals, features, and " +
59
- "scanned_at. Costs $0.10 USD per call paid via x402 (XRP/RLUSD on XRPL or USDC on Base). " +
60
- "Recording began with schema 2.1.0; older paid scans were not " +
61
- "persisted.",
47
+ "Return up to 25 prior recorded scans for an address to read score trajectory over time.",
62
48
  inputSchema: {
63
49
  type: "object",
64
50
  properties: {
65
51
  address: {
66
52
  type: "string",
67
- description: "XRPL classic address.",
53
+ description: "XRPL r-address.",
68
54
  pattern: "^r[1-9A-HJ-NP-Za-km-z]{24,34}$",
69
55
  },
70
56
  payment_signature: {
71
57
  type: "string",
72
- description: "x402 v2 PAYMENT-SIGNATURE header.",
58
+ description: "x402 payment header.",
73
59
  },
74
60
  },
75
61
  required: ["address"],
package/dist/services/sentinel.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"sentinel.js","sourceRoot":"","sources":["../../src/services/sentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,QAAQ,GAAe;IAClC,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,oCAAoC;IAC7C,WAAW,EAAE,gDAAgD;IAC7D,mBAAmB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAChP,KAAK,EAAE;QACL;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,oBAAoB;gBACpB,oEAAoE;gBACpE,gEAAgE;gBAChE,gEAAgE;gBAChE,qEAAqE;gBACrE,iEAAiE;gBACjE,oEAAoE;gBACpE,iFAAiF;gBACjF,6BAA6B;YAC/B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4CAA4C;wBACzD,OAAO,EAAE,gCAAgC;qBAC1C;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,6DAA6D;4BAC7D,gEAAgE;4BAChE,sDAAsD;4BACtD,yDAAyD;qBAC5D;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,aAAa;YACvB,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC;QACD;YACE,IAAI,EAAE,4BAA4B;YAClC,WAAW,EACT,oBAAoB;gBACpB,kEAAkE;gBAClE,gEAAgE;gBAChE,2DAA2D;gBAC3D,0FAA0F;gBAC1F,+DAA+D;gBAC/D,YAAY;YACd,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,uBAAuB;wBACpC,OAAO,EAAE,gCAAgC;qBAC1C;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;qBACjD;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,aAAa;YACvB,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC;KACF;CACF,CAAC"}
1
+ {"version":3,"file":"sentinel.js","sourceRoot":"","sources":["../../src/services/sentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,QAAQ,GAAe;IAClC,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,oCAAoC;IAC7C,WAAW,EAAE,gDAAgD;IAC7D,mBAAmB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAChP,KAAK,EAAE;QACL;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,oBAAoB;gBACpB,wFAAwF;gBACxF,uFAAuF;YACzF,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iBAAiB;wBAC9B,OAAO,EAAE,gCAAgC;qBAC1C;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sBAAsB;qBACpC;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,aAAa;YACvB,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC;QACD;YACE,IAAI,EAAE,4BAA4B;YAClC,WAAW,EACT,oBAAoB;gBACpB,yFAAyF;YAC3F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iBAAiB;wBAC9B,OAAO,EAAE,gCAAgC;qBAC1C;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sBAAsB;qBACpC;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,aAAa;YACvB,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC;KACF;CACF,CAAC"}
package/dist/services/telemetry.js CHANGED
@@ -27,20 +27,14 @@ export const telemetry = {
27
27
  {
28
28
  name: "xrpl_telemetry_snapshot",
29
29
  description: "Paid ($0.10 USD). " +
30
- "One-shot XRPL macro snapshot. Returns supply (total / circulating " +
31
- "/ escrowed / dormant / AMM-locked / exchange omnibus / DEX " +
32
- "orderbook depth), liquidity (per-region 24h flows), amm (top " +
33
- "pairs + vaults), derived_models.active_float (modeled supply " +
34
- "available for 3-second settlement, with the full additive " +
35
- "mathematical_bridge), and utility_floor (baseline equilibrium " +
36
- "price + premium ratio). Standard x402 verify-then-work-then-" +
37
- "settle. $0.10 USD per call. Pass payment_signature.",
30
+ "One-shot XRPL macro snapshot: supply breakdown, liquidity flows, AMM state, " +
31
+ "derived Active Float model, and utility floor price.",
38
32
  inputSchema: {
39
33
  type: "object",
40
34
  properties: {
41
35
  payment_signature: {
42
36
  type: "string",
43
- description: "x402 v2 PAYMENT-SIGNATURE header.",
37
+ description: "x402 payment header.",
44
38
  },
45
39
  },
46
40
  additionalProperties: false,
@@ -54,14 +48,8 @@ export const telemetry = {
54
48
  {
55
49
  name: "xrpl_telemetry_get_quote",
56
50
  description: "Paid flow step 1 ($0.10 USD total). " +
57
- "Start the async invoice flow: returns invoice_id, amount in " +
58
- "drops, payTo address, deepLink + QR, and expiry. The caller " +
59
- "pays the XRPL Payment to that address from any wallet, then " +
60
- "polls xrpl_telemetry_get_status until paid: true, then calls " +
61
- "xrpl_telemetry_get_results. The MCP wrapper itself doesn't " +
62
- "require a payment_signature header, but the snapshot still " +
63
- "costs $0.10 USD - the payment just happens out-of-band as a " +
64
- "regular XRPL Payment instead of an inline x402 header.",
51
+ "Start async invoice flow: returns invoice_id, payTo address, deepLink, QR, " +
52
+ "and expiry. Pay via XRPL Payment, then poll get_status, then call get_results.",
65
53
  inputSchema: {
66
54
  type: "object",
67
55
  properties: {},
@@ -74,18 +62,15 @@ export const telemetry = {
74
62
  },
75
63
  {
76
64
  name: "xrpl_telemetry_get_status",
77
- description: "Paid flow step 2 (no extra charge, polls invoice from step 1). " +
78
- "Poll the status of an invoice from xrpl_telemetry_get_quote. " +
79
- "Returns paid (bool), amount, ledger_index when settled, and " +
80
- "expiry. The MCP wrapper itself doesn't require a payment header " +
81
- "(the operator's check is just reading the validated XRPL ledger " +
82
- "for the deposit transaction).",
65
+ description: "Paid flow step 2 (no extra charge). " +
66
+ "Poll invoice status from get_quote. Returns paid (bool), amount, " +
67
+ "ledger_index, and expiry.",
83
68
  inputSchema: {
84
69
  type: "object",
85
70
  properties: {
86
71
  invoice_id: {
87
72
  type: "string",
88
- description: "Invoice id from the /quote response.",
73
+ description: "Invoice id from get_quote.",
89
74
  },
90
75
  },
91
76
  required: ["invoice_id"],
@@ -97,11 +82,9 @@ export const telemetry = {
97
82
  },
98
83
  {
99
84
  name: "xrpl_telemetry_get_results",
100
- description: "Paid flow step 3 (no extra charge, returns results from settled invoice). " +
101
- "Fetch the full TelemetryPayload for an invoice once paid. Same " +
102
- "shape as xrpl_telemetry_snapshot. The MCP wrapper doesn't need " +
103
- "a payment header here because the $0.10 already settled when " +
104
- "the caller paid the deeplink in step 2 of the flow.",
85
+ description: "Paid flow step 3 (no extra charge). " +
86
+ "Fetch full Telemetry snapshot payload once invoice is paid. Same shape as " +
87
+ "xrpl_telemetry_snapshot.",
105
88
  inputSchema: {
106
89
  type: "object",
107
90
  properties: {
@@ -120,14 +103,8 @@ export const telemetry = {
120
103
  {
121
104
  name: "xrpl_telemetry_settlement_totals",
122
105
  description: "Free. " +
123
- "Aggregate XRPL settlement volume rollup: USD-denominated " +
124
- "Payment volume across XRP and RLUSD legs over 24h / 7d / 30d, " +
125
- "annualized run rate, payment counts, coverage block describing " +
126
- "the first and latest hour bucket recorded by the settlement " +
127
- "walker. Walker is a continuous async loop (not a slow-task); " +
128
- "see /healthz checks.settlement_walker for freshness. Bootstrapping " +
129
- "flag surfaces in the settlement block during the first 7d / 30d " +
130
- "post-deploy. Free, public.",
106
+ "XRPL settlement volume rollup: 24h/7d/30d USD volume across XRP and RLUSD, " +
107
+ "annualized run rate, and payment counts.",
131
108
  inputSchema: {
132
109
  type: "object",
133
110
  properties: {},
@@ -140,16 +117,14 @@ export const telemetry = {
140
117
  {
141
118
  name: "xrpl_telemetry_settlement_series",
142
119
  description: "Free. " +
143
- "Time-series of XRPL settlement volume: per-hour USD volume " +
144
- "stacked by currency leg (XRP at ledger-close spot, RLUSD at " +
145
- "$1.00) plus payment count. Complements the rollup endpoint; use " +
146
- "this for charting or change-point detection. Free, public.",
120
+ "Per-hour XRPL settlement volume time-series stacked by currency (XRP, RLUSD) " +
121
+ "with payment counts. For charting or change-point detection.",
147
122
  inputSchema: {
148
123
  type: "object",
149
124
  properties: {
150
125
  hours: {
151
126
  type: "integer",
152
- description: "Trailing hour count (1-720). Default 168 (7 days).",
127
+ description: "Trailing hours. Default 168 (7d).",
153
128
  minimum: 1,
154
129
  maximum: 720,
155
130
  default: 168,
@@ -164,17 +139,14 @@ export const telemetry = {
164
139
  {
165
140
  name: "xrpl_telemetry_dex_pair_volume",
166
141
  description: "Free. " +
167
- "Per-pair DEX volume rollup on XRPL: 24h, 7d, fill counts, " +
168
- "volume by source (orderbook OfferCreate vs AMM), annualized run " +
169
- "rate. Curated pair set: XRP/RLUSD plus secondary pools. Reads " +
170
- "partial during the first week post-deploy; bootstrapping flag " +
171
- "surfaces this. Free, public.",
142
+ "Per-pair DEX volume on XRPL: 24h and 7d volume, fill counts, orderbook vs AMM " +
143
+ "source split, and annualized run rate.",
172
144
  inputSchema: {
173
145
  type: "object",
174
146
  properties: {
175
147
  pair: {
176
148
  type: "string",
177
- description: "Optional pair filter (e.g. 'XRP/RLUSD'). Omit for all tracked pairs.",
149
+ description: "Pair filter, e.g. 'XRP/RLUSD'. Omit for all.",
178
150
  },
179
151
  },
180
152
  additionalProperties: false,
package/dist/services/telemetry.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"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"}
package/dist/services/trust.js CHANGED
@@ -17,12 +17,8 @@ export const trust = {
17
17
  {
18
18
  name: "xrpl_trust_list_domains",
19
19
  description: "Paid ($0.10 USD). " +
20
- "Enumerate all XRPL PermissionedDomain (XLS-80) ledger objects on " +
21
- "validated mainnet. Each record carries domain_id, owner_address, " +
22
- "owner_label (XRPScan), accepted_credentials[] (with hex-decoded " +
23
- "credential_type when ASCII-printable), institutional_issuer_count, " +
24
- "and full ledger metadata. Walk_status indicates snapshot " +
25
- "completeness. $0.10 USD per call paid via x402.",
20
+ "List all XRPL PermissionedDomain (XLS-80) objects on mainnet with owner, " +
21
+ "accepted credentials, and institutional issuer counts. Paginated.",
26
22
  inputSchema: {
27
23
  type: "object",
28
24
  properties: {
@@ -39,7 +35,7 @@ export const trust = {
39
35
  },
40
36
  payment_signature: {
41
37
  type: "string",
42
- description: "x402 v2 PAYMENT-SIGNATURE header.",
38
+ description: "x402 payment header.",
43
39
  },
44
40
  },
45
41
  additionalProperties: false,
@@ -51,23 +47,19 @@ export const trust = {
51
47
  {
52
48
  name: "xrpl_trust_get_domain",
53
49
  description: "Paid ($0.10 USD). " +
54
- "Drill down on a single PermissionedDomain by 64-hex LedgerIndex. " +
55
- "Returns the list-view fields plus lifecycle (created_at, " +
56
- "last_modified_at, modification_count, walked from PreviousTxnID " +
57
- "meta chain), permissioned_market (XLS-81 owner-side offers + " +
58
- "AMMs), and identity (XLS-40 DID + parsed .well-known/" +
59
- "xrp-ledger.toml when published). $0.10 USD per call.",
50
+ "Deep dive on one PermissionedDomain by 64-hex ID: lifecycle history, " +
51
+ "permissioned market activity (XLS-81), and DID/TOML identity.",
60
52
  inputSchema: {
61
53
  type: "object",
62
54
  properties: {
63
55
  domain_id: {
64
56
  type: "string",
65
- description: "64-character hex LedgerIndex of the PermissionedDomain object.",
57
+ description: "64-hex LedgerIndex of the domain.",
66
58
  pattern: "^[A-Fa-f0-9]{64}$",
67
59
  },
68
60
  payment_signature: {
69
61
  type: "string",
70
- description: "x402 v2 PAYMENT-SIGNATURE header.",
62
+ description: "x402 payment header.",
71
63
  },
72
64
  },
73
65
  required: ["domain_id"],
@@ -80,17 +72,14 @@ export const trust = {
80
72
  {
81
73
  name: "xrpl_trust_credential_issuers",
82
74
  description: "Paid ($0.10 USD). " +
83
- "Aggregated view of every distinct credential issuer referenced " +
84
- "across all PermissionedDomain objects. Each entry: issuer_address, " +
85
- "issuer_label, domains_referencing (count), credential_types_issued " +
86
- "(sorted unique). Useful for ranking which institutional issuers " +
87
- "are most adopted on-chain. $0.10 USD per call.",
75
+ "All credential issuers across PermissionedDomains: address, label, " +
76
+ "referencing domain count, and credential types issued.",
88
77
  inputSchema: {
89
78
  type: "object",
90
79
  properties: {
91
80
  payment_signature: {
92
81
  type: "string",
93
- description: "x402 v2 PAYMENT-SIGNATURE header.",
82
+ description: "x402 payment header.",
94
83
  },
95
84
  },
96
85
  additionalProperties: false,
@@ -102,20 +91,14 @@ export const trust = {
102
91
  {
103
92
  name: "xrpl_trust_recent_events",
104
93
  description: "Paid ($0.10 USD). " +
105
- "XLS-70/80/81 lifecycle event stream sourced from XR-Trust's " +
106
- "long-lived XRPL WebSocket subscribe loop. Each event carries " +
107
- "tx_type (PermissionedDomainSet/Delete, CredentialCreate/Accept/" +
108
- "Delete, OfferCreate/OfferCancel, AMMCreate/etc.), tx_hash, " +
109
- "account, domain_id, ledger_index, and tx_type-specific payload " +
110
- "(credential_type for XLS-70, taker_gets/pays for XLS-81). " +
111
- "Cursor via since=trust_lifecycle_<n>. $0.10 USD per call.",
94
+ "XLS-70/80/81 lifecycle event stream: domain creates/deletes, credential " +
95
+ "activity, permissioned offers and AMM events. Cursor-paginated.",
112
96
  inputSchema: {
113
97
  type: "object",
114
98
  properties: {
115
99
  since: {
116
100
  type: "string",
117
- description: "Event-id cursor (e.g. 'trust_lifecycle_42'); only events " +
118
- "after this id are returned. Optional.",
101
+ description: "Event-id cursor, e.g. 'trust_lifecycle_42'.",
119
102
  },
120
103
  limit: {
121
104
  type: "integer",
@@ -125,12 +108,11 @@ export const trust = {
125
108
  },
126
109
  tx_type: {
127
110
  type: "string",
128
- description: "Comma-separated filter on TransactionType (e.g. " +
129
- "'PermissionedDomainSet,CredentialCreate'). Optional.",
111
+ description: "Comma-separated TransactionType filter.",
130
112
  },
131
113
  payment_signature: {
132
114
  type: "string",
133
- description: "x402 v2 PAYMENT-SIGNATURE header.",
115
+ description: "x402 payment header.",
134
116
  },
135
117
  },
136
118
  additionalProperties: false,
@@ -142,12 +124,8 @@ export const trust = {
142
124
  {
143
125
  name: "xrpl_trust_list_operators_index",
144
126
  description: "Free. " +
145
- "Lightweight rollup of every PermissionedDomain operator " +
146
- "indexed by XR-Trust: operator address, owner label, jurisdiction, " +
147
- "operator_status (active/proposed/etc.), domain count, credential " +
148
- "issuer count, and last-event timestamp. Paginated. Use this as " +
149
- "the index before drilling into a single operator via " +
150
- "xrpl_trust_operator_drilldown. Free, public.",
127
+ "Index of all PermissionedDomain operators: address, label, jurisdiction, " +
128
+ "status, domain count, issuer count. Paginated.",
151
129
  inputSchema: {
152
130
  type: "object",
153
131
  properties: {
@@ -164,7 +142,7 @@ export const trust = {
164
142
  },
165
143
  status: {
166
144
  type: "string",
167
- description: "Filter on operator_status (all|active|proposed). Default 'all'.",
145
+ description: "all|active|proposed.",
168
146
  default: "all",
169
147
  },
170
148
  },
@@ -177,18 +155,15 @@ export const trust = {
177
155
  {
178
156
  name: "xrpl_trust_operator_drilldown",
179
157
  description: "Free. " +
180
- "Deep-dive on one PermissionedDomain operator: full domain " +
181
- "list with accepted-credentials breakdown, jurisdiction, owner " +
182
- "DID brief (XLS-40 + linked TOML metadata), institutional issuer " +
183
- "set, recent lifecycle event timeline. Flagship XLS-80 visibility " +
184
- "surface; complements the paid /scan path with operator-level " +
185
- "context. Free, public.",
158
+ "Deep dive on one PermissionedDomain operator: domains, credentials, " +
159
+ "jurisdiction, DID identity, institutional issuers, and lifecycle events.",
186
160
  inputSchema: {
187
161
  type: "object",
188
162
  properties: {
189
163
  owner_address: {
190
164
  type: "string",
191
- description: "XRPL classic address of the operator (r-prefix).",
165
+ description: "XRPL r-address of the operator.",
166
+ pattern: "^r[1-9A-HJ-NP-Za-km-z]{24,34}$",
192
167
  },
193
168
  },
194
169
  required: ["owner_address"],
@@ -201,21 +176,15 @@ export const trust = {
201
176
  {
202
177
  name: "xrpl_trust_operator_attribution",
203
178
  description: "Free. " +
204
- "Auto-walked institutional attribution for one PermissionedDomain " +
205
- "operator: parent funder address + XRPScan well-known label (Bitso, " +
206
- "Coinbase, etc.), decoded accepted-credential types (e.g. EUROP_KYC, " +
207
- "USDC_KYC), per-credentialed-subject IOU trustline issuer cross-" +
208
- "reference (which stablecoin or asset is gated), and a one-sentence " +
209
- "plain-English summary plus a confidence tier (high|medium|low). " +
210
- "Walk fires automatically on every PermissionedDomainSet from the " +
211
- "subscribe loop; backfilled on Trust startup for pre-existing " +
212
- "operators. 404 if no walk recorded. Free, public.",
179
+ "Institutional attribution for one PermissionedDomain operator: parent funder, " +
180
+ "credential types, gated assets, plain-English summary, and confidence tier.",
213
181
  inputSchema: {
214
182
  type: "object",
215
183
  properties: {
216
184
  operator_address: {
217
185
  type: "string",
218
- description: "XRPL classic address of the PD operator (r-prefix).",
186
+ description: "XRPL r-address of the operator.",
187
+ pattern: "^r[1-9A-HJ-NP-Za-km-z]{24,34}$",
219
188
  },
220
189
  },
221
190
  required: ["operator_address"],
@@ -228,24 +197,17 @@ export const trust = {
228
197
  {
229
198
  name: "xrpl_trust_usage_summary",
230
199
  description: "Free. " +
231
- "Ecosystem-wide aggregate of XLS-70/80 + XLS-81 PermissionedDomain " +
232
- "activity over a configurable window (default 30 days, max 365). " +
233
- "One row of totals across every domain on mainnet: live domain count, " +
234
- "operator count, credential creates/accepts/revokes, permissioned " +
235
- "offer creates/cancels, permissioned payments, AMM events, domain " +
236
- "lifecycle events, count of operators with auto-walked institutional " +
237
- "attribution. Ships a short narrative line. Use this to track " +
238
- "institutional adoption velocity on XRPL's permissioned stack. " +
239
- "Per-operator detail stays on the paid drill-down. Free, public.",
200
+ "Ecosystem-wide PermissionedDomain activity aggregate: domain count, " +
201
+ "operator count, credential and market event totals over a configurable window.",
240
202
  inputSchema: {
241
203
  type: "object",
242
204
  properties: {
243
205
  window_days: {
244
206
  type: "integer",
207
+ description: "Trailing days.",
245
208
  minimum: 1,
246
209
  maximum: 365,
247
210
  default: 30,
248
- description: "Aggregation window in days. Default 30.",
249
211
  },
250
212
  },
251
213
  additionalProperties: false,
@@ -257,13 +219,8 @@ export const trust = {
257
219
  {
258
220
  name: "xrpl_trust_jurisdictions",
259
221
  description: "Free. " +
260
- "Jurisdiction rollup across XRPL's permissioned stack. For " +
261
- "every ISO-3166-1 alpha-2 country code attributed to at least one " +
262
- "operator or credential issuer, returns the count per kind plus an " +
263
- "explicit unattributed bucket with workflow hints. Jurisdiction " +
264
- "inferred from KNOWN_JURISDICTIONS override, self-attested TOML " +
265
- "country field, or ccTLD of org_url / source_toml_url / XRPScan " +
266
- "resolved domain. gTLDs are never auto-attributed. Free, public.",
222
+ "Jurisdiction rollup across XRPL's permissioned stack: per-country operator " +
223
+ "and issuer counts with an unattributed bucket.",
267
224
  inputSchema: {
268
225
  type: "object",
269
226
  properties: {},
package/dist/services/trust.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/services/trust.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,iCAAiC;IAC1C,WAAW,EAAE,6CAA6C;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IACzU,KAAK,EAAE;QACL;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EACT,oBAAoB;gBACpB,mEAAmE;gBACnE,mEAAmE;gBACnE,kEAAkE;gBAClE,qEAAqE;gBACrE,2DAA2D;gBAC3D,iDAAiD;YACnD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,OAAO,EAAE,GAAG;qBACb;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;qBACX;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;qBACjD;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACT,oBAAoB;gBACpB,mEAAmE;gBACnE,2DAA2D;gBAC3D,kEAAkE;gBAClE,+DAA+D;gBAC/D,uDAAuD;gBACvD,sDAAsD;YACxD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,gEAAgE;wBAClE,OAAO,EAAE,mBAAmB;qBAC7B;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;qBACjD;iBACF;gBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;gBACvB,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,IAAI,EAAE,+BAA+B;YACrC,WAAW,EACT,oBAAoB;gBACpB,iEAAiE;gBACjE,qEAAqE;gBACrE,qEAAqE;gBACrE,kEAAkE;gBAClE,gDAAgD;YAClD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;qBACjD;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,sBAAsB;YAC5B,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,oBAAoB;gBACpB,8DAA8D;gBAC9D,+DAA+D;gBAC/D,iEAAiE;gBACjE,6DAA6D;gBAC7D,iEAAiE;gBACjE,4DAA4D;gBAC5D,2DAA2D;YAC7D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,2DAA2D;4BAC3D,uCAAuC;qBAC1C;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,OAAO,EAAE,GAAG;qBACb;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,kDAAkD;4BAClD,sDAAsD;qBACzD;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;qBACjD;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,IAAI,EAAE,iCAAiC;YACvC,WAAW,EACT,QAAQ;gBACR,0DAA0D;gBAC1D,oEAAoE;gBACpE,mEAAmE;gBACnE,iEAAiE;gBACjE,uDAAuD;gBACvD,8CAA8C;YAChD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,OAAO,EAAE,GAAG;qBACb;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;qBACX;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iEAAiE;wBAC9E,OAAO,EAAE,KAAK;qBACf;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,uCAAuC;YAC7C,QAAQ,EAAE,MAAM;SACjB;QACD;YACE,IAAI,EAAE,+BAA+B;YACrC,WAAW,EACT,QAAQ;gBACR,4DAA4D;gBAC5D,gEAAgE;gBAChE,kEAAkE;gBAClE,mEAAmE;gBACnE,+DAA+D;gBAC/D,wBAAwB;YAC1B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,aAAa,EAAE;wBACb,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,kDAAkD;qBAChE;iBACF;gBACD,QAAQ,EAAE,CAAC,eAAe,CAAC;gBAC3B,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iDAAiD;YACvD,QAAQ,EAAE,MAAM;SACjB;QACD;YACE,IAAI,EAAE,iCAAiC;YACvC,WAAW,EACT,QAAQ;gBACR,mEAAmE;gBACnE,qEAAqE;gBACrE,sEAAsE;gBACtE,iEAAiE;gBACjE,qEAAqE;gBACrE,kEAAkE;gBAClE,mEAAmE;gBACnE,+DAA+D;gBAC/D,mDAAmD;YACrD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,gBAAgB,EAAE;wBAChB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qDAAqD;qBACnE;iBACF;gBACD,QAAQ,EAAE,CAAC,kBAAkB,CAAC;gBAC9B,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gEAAgE;YACtE,QAAQ,EAAE,MAAM;SACjB;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,QAAQ;gBACR,oEAAoE;gBACpE,kEAAkE;gBAClE,uEAAuE;gBACvE,mEAAmE;gBACnE,mEAAmE;gBACnE,sEAAsE;gBACtE,+DAA+D;gBAC/D,gEAAgE;gBAChE,iEAAiE;YACnE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,WAAW,EAAE;wBACX,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,OAAO,EAAE,EAAE;wBACX,WAAW,EAAE,yCAAyC;qBACvD;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qCAAqC;YAC3C,QAAQ,EAAE,MAAM;SACjB;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,QAAQ;gBACR,4DAA4D;gBAC5D,mEAAmE;gBACnE,oEAAoE;gBACpE,iEAAiE;gBACjE,iEAAiE;gBACjE,iEAAiE;gBACjE,iEAAiE;YACnE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;gBACd,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,MAAM;SACjB;KACF;CACF,CAAC"}
1
+ {"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/services/trust.ts"],"names":[],"mappings":"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"}
package/dist/services/vault.js CHANGED
@@ -16,36 +16,18 @@ export const vault = {
16
16
  {
17
17
  name: "xrpl_vault_scan",
18
18
  description: "Paid ($0.10 USD). " +
19
- "Per-issuer real-world-asset deep dive on the XRP Ledger. Accepts " +
20
- "{issuer: <wallet OR logical_label OR currency>} and returns the " +
21
- "issuer's metadata, current obligations + net-circulating supply " +
22
- "(treasury-adjusted where applicable), trustline count, last-24h " +
23
- "mint and burn flow, AMM-of-RWA pool exposure (every XLS-30 pool " +
24
- "containing this issuer's IOU with native-unit balances + LP " +
25
- "supply), and a daily history series that accrues over time. " +
26
- "Tracked issuer set covers Ondo OUSG (permissioned + public), " +
27
- "Schuman EUROP, Braza USDB, Braza BBRL, SG-FORGE EURCV, Guggenheim " +
28
- "DCP (Zeconomy SPV), Justoken JMWH (in MWh, not USD), OpenEden " +
29
- "TBL, Ripple RLUSD, AUDD, Circle USDCAllow, Ctrl Alt DIA-L-COL1, " +
30
- "Ctrl Alt DLD-25-24722-IAHG, Quantoz EURQ, plus Archax abrdn USD " +
31
- "Liquidity Fund as rails-only for first-mint capture. $0.10 USD per call paid via " +
32
- "x402 v2 (XRP/RLUSD on XRPL via t54 facilitator, or USDC on Base via " +
33
- "Coinbase facilitator).",
19
+ "Per-issuer RWA deep dive: supply, mint/burn flow, AMM exposure, and daily " +
20
+ "history. Accepts wallet address, issuer label, or currency code.",
34
21
  inputSchema: {
35
22
  type: "object",
36
23
  properties: {
37
24
  issuer: {
38
25
  type: "string",
39
- description: "Wallet (r-prefix XRPL classic address; exact match) OR " +
40
- "logical_label (e.g. 'Ondo OUSG', 'Justoken JMWH'; " +
41
- "case-insensitive) OR currency code (e.g. 'OUSG', 'TBL', " +
42
- "'RLUSD'; case-insensitive). Resolution priority: wallet > " +
43
- "logical_label > currency. Returns 404 when no tracked " +
44
- "issuer matches.",
26
+ description: "r-address, label (e.g. 'Ondo OUSG'), or currency code (e.g. 'RLUSD').",
45
27
  },
46
28
  payment_signature: {
47
29
  type: "string",
48
- description: "x402 v2 PAYMENT-SIGNATURE header.",
30
+ description: "x402 payment header.",
49
31
  },
50
32
  },
51
33
  required: ["issuer"],
@@ -60,22 +42,14 @@ export const vault = {
60
42
  {
61
43
  name: "xrpl_vault_daily_flow",
62
44
  description: "Free. " +
63
- "Cross-issuer daily flow series built from Vault's accruing " +
64
- "snapshots. Returns settlement_events_daily (mint + burn event " +
65
- "counts per UTC day, stacked by logical_label, currency-agnostic " +
66
- "so BRL/EUR/AUD/MWh issuers contribute alongside USD ones) and " +
67
- "usd_pegged_net_flow_daily (sums net dollar inflow per UTC day " +
68
- "across asset classes at or near 1 USD: fiat_stable_usd, " +
69
- "treasuries, commercial_paper, money_market). EUR/BRL/AUD/MWh " +
70
- "issuers appear in per_issuer_series in native units but are " +
71
- "deliberately omitted from the USD aggregate. Cross-issuer view " +
72
- "complementing the paid per-issuer /scan deep dive. Free, public.",
45
+ "Cross-issuer daily RWA flow series: mint/burn event counts per day and " +
46
+ "USD-pegged net inflow aggregate. Complements the paid per-issuer scan.",
73
47
  inputSchema: {
74
48
  type: "object",
75
49
  properties: {
76
50
  days: {
77
51
  type: "integer",
78
- description: "Trailing day count (1-90). Default 30.",
52
+ description: "Trailing days.",
79
53
  minimum: 1,
80
54
  maximum: 90,
81
55
  default: 30,
package/dist/services/vault.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/services/vault.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,iCAAiC;IAC1C,WAAW,EAAE,6CAA6C;IAC1D,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACjL,KAAK,EAAE;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,oBAAoB;gBACpB,mEAAmE;gBACnE,kEAAkE;gBAClE,kEAAkE;gBAClE,kEAAkE;gBAClE,kEAAkE;gBAClE,8DAA8D;gBAC9D,8DAA8D;gBAC9D,+DAA+D;gBAC/D,oEAAoE;gBACpE,gEAAgE;gBAChE,kEAAkE;gBAClE,kEAAkE;gBAClE,mFAAmF;gBACnF,sEAAsE;gBACtE,wBAAwB;YAC1B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,yDAAyD;4BACzD,oDAAoD;4BACpD,0DAA0D;4BAC1D,4DAA4D;4BAC5D,wDAAwD;4BACxD,iBAAiB;qBACpB;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;qBACjD;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,aAAa;YACvB,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACT,QAAQ;gBACR,6DAA6D;gBAC7D,gEAAgE;gBAChE,kEAAkE;gBAClE,gEAAgE;gBAChE,gEAAgE;gBAChE,0DAA0D;gBAC1D,+DAA+D;gBAC/D,8DAA8D;gBAC9D,iEAAiE;gBACjE,kEAAkE;YACpE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,wCAAwC;wBACrD,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,OAAO,EAAE,EAAE;qBACZ;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,MAAM;SACjB;KACF;CACF,CAAC"}
1
+ {"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/services/vault.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,iCAAiC;IAC1C,WAAW,EAAE,6CAA6C;IAC1D,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACjL,KAAK,EAAE;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,oBAAoB;gBACpB,4EAA4E;gBAC5E,kEAAkE;YACpE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,uEAAuE;qBACrF;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sBAAsB;qBACpC;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,aAAa;YACvB,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACT,QAAQ;gBACR,yEAAyE;gBACzE,wEAAwE;YAC1E,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,gBAAgB;wBAC7B,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,OAAO,EAAE,EAAE;qBACZ;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,MAAM;SACjB;KACF;CACF,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xrpl-utilities/mcp",
3
- "version": "0.2.110",
3
+ "version": "0.2.112",
4
4
  "mcpName": "io.github.XRPL-Utilities/mcp",
5
5
  "description": "Model Context Protocol server for the XRPL-Utilities portfolio: Sentinel (wallet classifier), Pulse (signal feed), Telemetry (supply + utility floor), Trust (XLS-70/80/81 directory), Vault (RWA tracker), and Flows (ETF AUM vs XRPL flow correlation). Exposes each service's read endpoints as MCP tools so AI agents can discover and use them via stdio (Claude Desktop) or HTTP/SSE (hosted at mcp.xrpl-utilities.io). Stateless passthrough. Caller provides their own x402 payment header.",
6
6
  "license": "MIT",