crypto-quant-signal-mcp 1.1.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +131 -92
- package/dist/facilitator.d.ts +3 -0
- package/dist/facilitator.d.ts.map +1 -0
- package/dist/facilitator.js +99 -0
- package/dist/facilitator.js.map +1 -0
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +536 -18
- package/dist/index.js.map +1 -1
- package/dist/lib/adapters/hyperliquid.d.ts.map +1 -1
- package/dist/lib/adapters/hyperliquid.js +5 -3
- package/dist/lib/adapters/hyperliquid.js.map +1 -1
- package/dist/lib/analytics.d.ts +17 -0
- package/dist/lib/analytics.d.ts.map +1 -0
- package/dist/lib/analytics.js +81 -0
- package/dist/lib/analytics.js.map +1 -0
- package/dist/lib/indicators.d.ts +31 -0
- package/dist/lib/indicators.d.ts.map +1 -1
- package/dist/lib/indicators.js +109 -0
- package/dist/lib/indicators.js.map +1 -1
- package/dist/lib/license.d.ts +20 -1
- package/dist/lib/license.d.ts.map +1 -1
- package/dist/lib/license.js +33 -7
- package/dist/lib/license.js.map +1 -1
- package/dist/lib/performance-db.d.ts +31 -1
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +257 -58
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/x402.d.ts +25 -23
- package/dist/lib/x402.d.ts.map +1 -1
- package/dist/lib/x402.js +229 -38
- package/dist/lib/x402.js.map +1 -1
- package/dist/resources/analytics-summary.d.ts +2 -0
- package/dist/resources/analytics-summary.d.ts.map +1 -0
- package/dist/resources/analytics-summary.js +16 -0
- package/dist/resources/analytics-summary.js.map +1 -0
- package/dist/resources/signal-performance.d.ts +5 -2
- package/dist/resources/signal-performance.d.ts.map +1 -1
- package/dist/resources/signal-performance.js +85 -21
- package/dist/resources/signal-performance.js.map +1 -1
- package/dist/scripts/backfill-outcomes.d.ts +28 -0
- package/dist/scripts/backfill-outcomes.d.ts.map +1 -0
- package/dist/scripts/backfill-outcomes.js +204 -0
- package/dist/scripts/backfill-outcomes.js.map +1 -0
- package/dist/scripts/seed-signals.d.ts +38 -0
- package/dist/scripts/seed-signals.d.ts.map +1 -0
- package/dist/scripts/seed-signals.js +165 -0
- package/dist/scripts/seed-signals.js.map +1 -0
- package/dist/tools/get-market-regime.js +6 -6
- package/dist/tools/get-market-regime.js.map +1 -1
- package/dist/tools/get-trade-signal.d.ts.map +1 -1
- package/dist/tools/get-trade-signal.js +194 -42
- package/dist/tools/get-trade-signal.js.map +1 -1
- package/dist/tools/scan-funding-arb.d.ts.map +1 -1
- package/dist/tools/scan-funding-arb.js +17 -2
- package/dist/tools/scan-funding-arb.js.map +1 -1
- package/dist/types.d.ts +23 -7
- package/dist/types.d.ts.map +1 -1
- package/logo.png +0 -0
- package/package.json +9 -1
- package/server.json +8 -7
- package/smithery.yaml +1 -1
package/README.md
CHANGED
|
@@ -1,55 +1,74 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="logo.png" alt="AlgoVault" width="120" />
|
|
3
|
+
</p>
|
|
4
|
+
|
|
1
5
|
# crypto-quant-signal-mcp
|
|
2
6
|
|
|
3
|
-
AI trading brain for crypto perps — composite signals, funding rate arb scanning, and market regime detection via MCP.
|
|
7
|
+
AI trading brain for crypto perps — composite signals, funding rate arb scanning, and market regime detection via MCP.
|
|
4
8
|
|
|
5
|
-
|
|
9
|
+
[](https://www.npmjs.com/package/crypto-quant-signal-mcp)
|
|
10
|
+
[](https://www.npmjs.com/package/crypto-quant-signal-mcp)
|
|
11
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
12
|
|
|
7
|
-
|
|
13
|
+
---
|
|
8
14
|
|
|
9
|
-
|
|
10
|
-
|------|-------------|
|
|
11
|
-
| `get_trade_signal` | Composite BUY/SELL/HOLD signal combining RSI(14), EMA(9/21), funding rate, OI momentum, and volume |
|
|
12
|
-
| `scan_funding_arb` | Cross-venue funding rate arbitrage scanner (Hyperliquid vs Binance vs Bybit) |
|
|
13
|
-
| `get_market_regime` | Market regime classification with cross-venue funding sentiment |
|
|
14
|
-
| `signal-performance` | Historical signal track record — win rate, Sharpe ratio, profit factor |
|
|
15
|
+
## Try It in 30 Seconds
|
|
15
16
|
|
|
16
|
-
|
|
17
|
+
No code. No API key. No install.
|
|
17
18
|
|
|
18
|
-
|
|
19
|
-
Remote Server (revenue-generating)
|
|
20
|
-
Agent → HTTP POST → api.algovault.com/signal/mcp
|
|
21
|
-
→ x402 payment check → API key check → free tier
|
|
22
|
-
→ MCP Server (Streamable HTTP)
|
|
23
|
-
→ PostgreSQL (signal tracking)
|
|
24
|
-
→ Hyperliquid API
|
|
19
|
+
**Step 1.** Open Claude → Settings → Integrations → Add custom connector
|
|
25
20
|
|
|
26
|
-
|
|
27
|
-
Claude Desktop → stdio → npx crypto-quant-signal-mcp
|
|
28
|
-
→ Same tools, free tier only
|
|
29
|
-
→ SQLite (local signal tracking)
|
|
30
|
-
→ Hyperliquid API
|
|
31
|
-
```
|
|
21
|
+
**Step 2.** Enter the name and URL:
|
|
32
22
|
|
|
33
|
-
|
|
23
|
+
| Field | Value |
|
|
24
|
+
|-------|-------|
|
|
25
|
+
| Name | `Crypto Quant Signal` |
|
|
26
|
+
| URL | `https://api.algovault.com/mcp` |
|
|
34
27
|
|
|
35
|
-
|
|
28
|
+

|
|
29
|
+
|
|
30
|
+
**Step 3.** Ask Claude anything:
|
|
31
|
+
|
|
32
|
+
> "Get me a trade signal for BTC"
|
|
33
|
+
|
|
34
|
+

|
|
35
|
+
|
|
36
|
+
That's it. You now have a crypto quant analyst inside Claude.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## What It Does
|
|
36
41
|
|
|
37
|
-
|
|
42
|
+
| Tool | What you get |
|
|
43
|
+
|------|-------------|
|
|
44
|
+
| `get_trade_signal` | BUY/SELL/HOLD verdict with confidence score. Combines RSI, EMA crossover, funding rate, OI momentum, and volume. |
|
|
45
|
+
| `scan_funding_arb` | Cross-venue funding rate arbitrage opportunities (Hyperliquid vs Binance vs Bybit) with annualized spreads. |
|
|
46
|
+
| `get_market_regime` | Market regime classification — TRENDING_UP, TRENDING_DOWN, RANGING, or VOLATILE — with cross-venue funding sentiment. |
|
|
47
|
+
|
|
48
|
+
Every signal is tracked. Outcomes are measured at 15m, 1h, 4h, and 24h. The track record ships from day one.
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## For Developers
|
|
53
|
+
|
|
54
|
+
### Remote endpoint (recommended)
|
|
55
|
+
|
|
56
|
+
Point any MCP client at:
|
|
38
57
|
```
|
|
39
|
-
https://api.algovault.com/
|
|
58
|
+
https://api.algovault.com/mcp
|
|
40
59
|
```
|
|
41
60
|
|
|
42
|
-
Pay per call
|
|
61
|
+
Supports Streamable HTTP transport. Pay per call with x402 (USDC on Base) — no signup needed.
|
|
43
62
|
|
|
44
|
-
### Local
|
|
63
|
+
### Local install via npx
|
|
45
64
|
|
|
46
65
|
```bash
|
|
47
66
|
npx -y crypto-quant-signal-mcp
|
|
48
67
|
```
|
|
49
68
|
|
|
50
|
-
### Claude Desktop
|
|
69
|
+
### Claude Desktop / Cursor config
|
|
51
70
|
|
|
52
|
-
Add to
|
|
71
|
+
Add to `claude_desktop_config.json`:
|
|
53
72
|
|
|
54
73
|
```json
|
|
55
74
|
{
|
|
@@ -57,89 +76,119 @@ Add to your `claude_desktop_config.json`:
|
|
|
57
76
|
"crypto-quant-signal": {
|
|
58
77
|
"command": "npx",
|
|
59
78
|
"args": ["-y", "crypto-quant-signal-mcp"],
|
|
60
|
-
"env": {
|
|
61
|
-
"TRANSPORT": "stdio",
|
|
62
|
-
"CQS_API_KEY": "your-pro-key-here"
|
|
63
|
-
}
|
|
79
|
+
"env": { "TRANSPORT": "stdio" }
|
|
64
80
|
}
|
|
65
81
|
}
|
|
66
82
|
}
|
|
67
83
|
```
|
|
68
84
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
## Pricing
|
|
72
|
-
|
|
73
|
-
| Feature | Free | Pro ($49/mo) | Enterprise ($299/mo) | x402 (pay per call) |
|
|
74
|
-
|---------|------|-------------|---------------------|---------------------|
|
|
75
|
-
| `get_trade_signal` | BTC + ETH, 1h only | All 200+ perps, all timeframes | Same + SLA | Full access — $0.02/call |
|
|
76
|
-
| `scan_funding_arb` | Top 5 results | Unlimited | Unlimited | Full access — $0.01/call |
|
|
77
|
-
| `get_market_regime` | All assets | All assets | All assets + SLA | Full access — $0.02/call |
|
|
78
|
-
| `signal-performance` | Full access | Full access | Full access | Free |
|
|
79
|
-
| Monthly calls | ~100/day | 15,000/mo | 100,000/mo | Unlimited |
|
|
80
|
-
| Overage | Hard cap | $0.01/call | $0.005/call | N/A |
|
|
81
|
-
|
|
82
|
-
### x402 Micropayments
|
|
83
|
-
|
|
84
|
-
AI agents pay per HTTP call with USDC on Base chain — no signup, no API key, no billing. Payment receipt is the credential.
|
|
85
|
+
### npm install
|
|
85
86
|
|
|
86
|
-
|
|
87
|
+
```bash
|
|
88
|
+
npm install crypto-quant-signal-mcp
|
|
89
|
+
```
|
|
87
90
|
|
|
88
|
-
|
|
91
|
+
---
|
|
89
92
|
|
|
90
|
-
##
|
|
93
|
+
## Pricing
|
|
91
94
|
|
|
92
|
-
|
|
93
|
-
|
|
95
|
+
| Feature | Free | Pro ($49/mo) | x402 (per call) |
|
|
96
|
+
|---------|------|-------------|-----------------|
|
|
97
|
+
| Assets | BTC, ETH | All 200+ HL perps | All 200+ |
|
|
98
|
+
| Timeframes | 1h | 1h, 4h, 1d | All |
|
|
99
|
+
| Funding arb results | Top 5 | Unlimited | Unlimited |
|
|
100
|
+
| Track record | Full access | Full access | Full access |
|
|
101
|
+
| Monthly calls | ~100/day | 15,000/mo | Unlimited |
|
|
102
|
+
| Price | $0 | $49/mo | $0.01-0.02/call |
|
|
94
103
|
|
|
95
|
-
**
|
|
96
|
-
> "Scan for funding rate arbitrage opportunities with at least 10 bps spread"
|
|
104
|
+
**x402 micropayments:** AI agents pay per HTTP call with USDC on Base chain — no signup, no API key, no billing. Payment receipt is the credential. See [x402.org](https://x402.org).
|
|
97
105
|
|
|
98
|
-
**
|
|
99
|
-
> "What's the current market regime for BTC on the 4h chart?"
|
|
106
|
+
**API key:** Set `CQS_API_KEY` env var or pass `Authorization: Bearer <key>` header.
|
|
100
107
|
|
|
101
|
-
|
|
102
|
-
> "Check the market regime for SOL, then get a trade signal. If it's a BUY, also scan for any funding arb opportunities on SOL."
|
|
108
|
+
---
|
|
103
109
|
|
|
104
110
|
## Tools Reference
|
|
105
111
|
|
|
106
112
|
### get_trade_signal
|
|
107
113
|
|
|
108
|
-
|
|
114
|
+
Composite signal from five weighted indicators (v3 scoring):
|
|
115
|
+
|
|
116
|
+
| Indicator | Weight | What it measures |
|
|
117
|
+
|-----------|--------|-----------------|
|
|
118
|
+
| RSI(14) | 30% | Oversold/overbought with 7-tier scoring |
|
|
119
|
+
| EMA(9/21) | 20% | Trend direction via crossover |
|
|
120
|
+
| Funding rate | 20% | Derivatives sentiment + crowding penalty |
|
|
121
|
+
| OI momentum | 15% | New money confirmation |
|
|
122
|
+
| Volume | 20% | Conviction from 24h volume vs moving average |
|
|
109
123
|
|
|
110
|
-
|
|
111
|
-
- **EMA(9/21) crossover** — 30% weight: trend direction
|
|
112
|
-
- **Funding rate** — 20% weight: sentiment from derivatives market
|
|
113
|
-
- **OI momentum** — 15% weight: new money confirmation
|
|
114
|
-
- **Volume** — 10% weight: conviction multiplier
|
|
124
|
+
v3 features: asymmetric thresholds (BUY requires higher conviction than SELL), funding confirmation gate (penalizes BUY when longs are crowded), regime-aware filtering.
|
|
115
125
|
|
|
116
126
|
**Parameters:**
|
|
117
|
-
- `coin` (string, required):
|
|
127
|
+
- `coin` (string, required): e.g. "ETH", "BTC", "SOL"
|
|
118
128
|
- `timeframe` (string, default "1h"): "1h", "4h", or "1d"
|
|
119
|
-
- `includeReasoning` (boolean, default true):
|
|
129
|
+
- `includeReasoning` (boolean, default true): Human-readable explanation
|
|
120
130
|
|
|
121
131
|
### scan_funding_arb
|
|
122
132
|
|
|
123
|
-
Scans
|
|
133
|
+
Scans cross-venue funding rate differences. Normalizes HL hourly rates vs Binance/Bybit 8h rates and annualizes the spread.
|
|
124
134
|
|
|
125
135
|
**Parameters:**
|
|
126
136
|
- `minSpreadBps` (number, default 5): Minimum spread in basis points
|
|
127
|
-
- `limit` (number, default 10): Max results
|
|
137
|
+
- `limit` (number, default 10): Max results
|
|
128
138
|
|
|
129
139
|
### get_market_regime
|
|
130
140
|
|
|
131
|
-
Classifies market conditions using ADX(14), ATR(14)/price volatility ratio,
|
|
141
|
+
Classifies market conditions using ADX(14), ATR(14)/price volatility ratio, swing high/low price structure, and cross-venue funding sentiment.
|
|
132
142
|
|
|
133
143
|
**Parameters:**
|
|
134
|
-
- `coin` (string, required):
|
|
144
|
+
- `coin` (string, required): e.g. "BTC", "ETH"
|
|
135
145
|
- `timeframe` (string, default "4h"): "1h", "4h", or "1d"
|
|
136
146
|
|
|
147
|
+
---
|
|
148
|
+
|
|
137
149
|
## Performance Tracking
|
|
138
150
|
|
|
139
|
-
Every signal
|
|
151
|
+
Every signal is recorded with outcome prices at **15 minutes, 1 hour, 4 hours, and 24 hours**.
|
|
152
|
+
|
|
153
|
+
- **Remote mode:** PostgreSQL — aggregated across all users, backfilled every 15 minutes
|
|
154
|
+
- **Local mode:** SQLite at `~/.crypto-quant-signal/performance.db`
|
|
140
155
|
|
|
141
|
-
|
|
142
|
-
|
|
156
|
+
Only signals with confidence >= 40 and a BUY or SELL verdict are tracked. HOLD signals are not recorded.
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Architecture
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
Remote Server (Hetzner VPS)
|
|
164
|
+
Agent → HTTPS → api.algovault.com/mcp
|
|
165
|
+
→ x402 payment check → API key check → free tier
|
|
166
|
+
→ MCP Server (Streamable HTTP, Express)
|
|
167
|
+
→ PostgreSQL (signal tracking, 15m/1h/4h/24h outcomes)
|
|
168
|
+
→ Hyperliquid public API
|
|
169
|
+
|
|
170
|
+
Local Mode (stdio)
|
|
171
|
+
Claude Desktop → stdio → npx crypto-quant-signal-mcp
|
|
172
|
+
→ Same 3 tools, free tier limits
|
|
173
|
+
→ SQLite (local tracking)
|
|
174
|
+
→ Hyperliquid public API
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
**Exchange adapter pattern:** code against the `ExchangeAdapter` interface, not raw API calls. Hyperliquid today, more exchanges in Phase 2.
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## Suite Compatibility
|
|
182
|
+
|
|
183
|
+
All tools output an `_algovault` metadata block for composability:
|
|
184
|
+
|
|
185
|
+
| Tool | Feeds into (Phase 2+) |
|
|
186
|
+
|------|----------------------|
|
|
187
|
+
| `get_trade_signal` | `crypto-quant-risk-mcp`, `crypto-quant-backtest-mcp` |
|
|
188
|
+
| `scan_funding_arb` | `crypto-quant-risk-mcp`, `crypto-quant-execution-mcp` |
|
|
189
|
+
| `get_market_regime` | `crypto-quant-risk-mcp`, `crypto-quant-backtest-mcp` |
|
|
190
|
+
|
|
191
|
+
---
|
|
143
192
|
|
|
144
193
|
## Self-Hosting
|
|
145
194
|
|
|
@@ -151,23 +200,13 @@ npm ci && npm run build
|
|
|
151
200
|
docker compose up -d
|
|
152
201
|
```
|
|
153
202
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
- **Data source:** Hyperliquid public API (free, no auth required)
|
|
157
|
-
- **Transports:** Streamable HTTP (default, port 3000) + stdio (via `TRANSPORT=stdio`)
|
|
158
|
-
- **Storage:** PostgreSQL (remote) or SQLite (local)
|
|
159
|
-
- **Exchange adapter:** Pluggable — Hyperliquid today, Binance/Bybit adapters in Phase 2
|
|
160
|
-
- **x402 payments:** USDC on Base chain per x402.org spec
|
|
203
|
+
---
|
|
161
204
|
|
|
162
|
-
##
|
|
205
|
+
## Privacy
|
|
163
206
|
|
|
164
|
-
|
|
207
|
+
**Local mode:** No data sent to AlgoVault servers. Signal history stored locally. No telemetry.
|
|
165
208
|
|
|
166
|
-
|
|
167
|
-
|------------|----------------------|
|
|
168
|
-
| `get_trade_signal` | `crypto-quant-risk-mcp`, `crypto-quant-backtest-mcp` |
|
|
169
|
-
| `scan_funding_arb` | `crypto-quant-risk-mcp`, `crypto-quant-execution-mcp` |
|
|
170
|
-
| `get_market_regime` | `crypto-quant-risk-mcp`, `crypto-quant-backtest-mcp` |
|
|
209
|
+
**Remote mode:** Requests logged for analytics (IP hashed, never stored raw). See [privacy policy](https://algovault.com/privacy).
|
|
171
210
|
|
|
172
211
|
## License
|
|
173
212
|
|
|
@@ -175,4 +214,4 @@ MIT
|
|
|
175
214
|
|
|
176
215
|
---
|
|
177
216
|
|
|
178
|
-
Built by [AlgoVault Labs](https://algovault.com)
|
|
217
|
+
Built by [AlgoVault Labs](https://algovault.com) | [Landing page](https://algovault.com) | [API endpoint](https://api.algovault.com/mcp)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../src/facilitator.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
"use strict";
|
|
3
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
4
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
5
|
+
};
|
|
6
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
|
+
/**
|
|
8
|
+
* Self-hosted x402 Facilitator for Base mainnet.
|
|
9
|
+
*
|
|
10
|
+
* Verifies ERC-3009 signatures and settles USDC transfers on-chain.
|
|
11
|
+
* The facilitator wallet only needs ETH for gas (~$0.001-0.01 per tx).
|
|
12
|
+
* USDC flows directly from payer → recipient (your Rabby wallet).
|
|
13
|
+
*
|
|
14
|
+
* Endpoints (matching HTTPFacilitatorClient expectations):
|
|
15
|
+
* POST /verify — verify a payment signature
|
|
16
|
+
* POST /settle — submit the on-chain transfer
|
|
17
|
+
* GET /supported — list supported schemes/networks
|
|
18
|
+
* GET /health — health check
|
|
19
|
+
*
|
|
20
|
+
* Env vars:
|
|
21
|
+
* FACILITATOR_PRIVATE_KEY — hex private key for the gas wallet
|
|
22
|
+
* FACILITATOR_PORT — port to listen on (default: 4022)
|
|
23
|
+
*/
|
|
24
|
+
const express_1 = __importDefault(require("express"));
|
|
25
|
+
const viem_1 = require("viem");
|
|
26
|
+
const accounts_1 = require("viem/accounts");
|
|
27
|
+
const chains_1 = require("viem/chains");
|
|
28
|
+
const facilitator_1 = require("@x402/core/facilitator");
|
|
29
|
+
const evm_1 = require("@x402/evm");
|
|
30
|
+
// Facilitator-side ExactEvmScheme (different from the client-side one)
|
|
31
|
+
const facilitator_2 = require("@x402/evm/exact/facilitator");
|
|
32
|
+
const PORT = parseInt(process.env.FACILITATOR_PORT || '4022', 10);
|
|
33
|
+
const PRIVATE_KEY = process.env.FACILITATOR_PRIVATE_KEY;
|
|
34
|
+
if (!PRIVATE_KEY) {
|
|
35
|
+
console.error('FACILITATOR_PRIVATE_KEY is required');
|
|
36
|
+
process.exit(1);
|
|
37
|
+
}
|
|
38
|
+
// ── EVM Wallet ──
|
|
39
|
+
const account = (0, accounts_1.privateKeyToAccount)(PRIVATE_KEY);
|
|
40
|
+
const viemClient = (0, viem_1.createWalletClient)({
|
|
41
|
+
account,
|
|
42
|
+
chain: chains_1.base,
|
|
43
|
+
transport: (0, viem_1.http)(), // viem default Base RPC
|
|
44
|
+
}).extend(viem_1.publicActions);
|
|
45
|
+
const evmSigner = (0, evm_1.toFacilitatorEvmSigner)({
|
|
46
|
+
address: account.address,
|
|
47
|
+
getCode: (args) => viemClient.getCode(args),
|
|
48
|
+
readContract: (args) => viemClient.readContract({ ...args, args: args.args || [] }),
|
|
49
|
+
verifyTypedData: (args) => viemClient.verifyTypedData(args),
|
|
50
|
+
writeContract: (args) => viemClient.writeContract({ ...args, args: args.args || [] }),
|
|
51
|
+
sendTransaction: (args) => viemClient.sendTransaction(args),
|
|
52
|
+
waitForTransactionReceipt: (args) => viemClient.waitForTransactionReceipt(args),
|
|
53
|
+
});
|
|
54
|
+
// ── Facilitator ──
|
|
55
|
+
const facilitator = new facilitator_1.x402Facilitator();
|
|
56
|
+
facilitator.register('eip155:8453', new facilitator_2.ExactEvmScheme(evmSigner));
|
|
57
|
+
facilitator.onAfterSettle(async (ctx) => {
|
|
58
|
+
console.log(`[settle] tx=${ctx.result.transaction} payer=${ctx.result.payer} success=${ctx.result.success}`);
|
|
59
|
+
});
|
|
60
|
+
facilitator.onSettleFailure(async (ctx) => {
|
|
61
|
+
console.error(`[settle-fail] ${ctx.error.message}`);
|
|
62
|
+
});
|
|
63
|
+
// ── HTTP Server ──
|
|
64
|
+
const app = (0, express_1.default)();
|
|
65
|
+
app.use(express_1.default.json());
|
|
66
|
+
app.post('/verify', async (req, res) => {
|
|
67
|
+
try {
|
|
68
|
+
const { paymentPayload, paymentRequirements } = req.body;
|
|
69
|
+
const result = await facilitator.verify(paymentPayload, paymentRequirements);
|
|
70
|
+
res.json(result);
|
|
71
|
+
}
|
|
72
|
+
catch (err) {
|
|
73
|
+
console.error('verify error:', err);
|
|
74
|
+
res.status(500).json({ error: err instanceof Error ? err.message : 'Unknown error' });
|
|
75
|
+
}
|
|
76
|
+
});
|
|
77
|
+
app.post('/settle', async (req, res) => {
|
|
78
|
+
try {
|
|
79
|
+
const { paymentPayload, paymentRequirements } = req.body;
|
|
80
|
+
const result = await facilitator.settle(paymentPayload, paymentRequirements);
|
|
81
|
+
res.json(result);
|
|
82
|
+
}
|
|
83
|
+
catch (err) {
|
|
84
|
+
console.error('settle error:', err);
|
|
85
|
+
res.status(500).json({ error: err instanceof Error ? err.message : 'Unknown error' });
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
app.get('/supported', (_req, res) => {
|
|
89
|
+
res.json(facilitator.getSupported());
|
|
90
|
+
});
|
|
91
|
+
app.get('/health', (_req, res) => {
|
|
92
|
+
res.json({ status: 'ok', wallet: account.address, network: 'eip155:8453' });
|
|
93
|
+
});
|
|
94
|
+
app.listen(PORT, () => {
|
|
95
|
+
console.log(`x402 facilitator running on http://0.0.0.0:${PORT}`);
|
|
96
|
+
console.log(`Network: Base mainnet (eip155:8453)`);
|
|
97
|
+
console.log(`Gas wallet: ${account.address}`);
|
|
98
|
+
});
|
|
99
|
+
//# sourceMappingURL=facilitator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../src/facilitator.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmuBpE,wBAAgB,mBAAmB,cAElC"}
|