@paystage/trade-preflight 0.0.0-stage → 0.1.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 +97 -2
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +8 -0
- package/dist/cli.js.map +1 -0
- package/dist/evaluate.d.ts +4 -0
- package/dist/evaluate.d.ts.map +1 -0
- package/dist/evaluate.js +169 -0
- package/dist/evaluate.js.map +1 -0
- package/dist/fetch.d.ts +15 -0
- package/dist/fetch.d.ts.map +1 -0
- package/dist/fetch.js +57 -0
- package/dist/fetch.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -0
- package/dist/policy.d.ts +39 -0
- package/dist/policy.d.ts.map +1 -0
- package/dist/policy.js +21 -0
- package/dist/policy.js.map +1 -0
- package/dist/server.d.ts +4 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +59 -0
- package/dist/server.js.map +1 -0
- package/dist/types.d.ts +56 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/package.json +34 -4
- package/server.json +25 -0
package/README.md
CHANGED
|
@@ -1,3 +1,98 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @paystage/trade-preflight
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
MCP tool: evaluate HIP-3 / trade.xyz orders against a local `TradePolicy` before trading.
|
|
4
|
+
|
|
5
|
+
> Not financial advice. This is a local policy gate only — it does not place orders, route
|
|
6
|
+
> orders, or recommend trades. It evaluates a proposed order against rules you define and
|
|
7
|
+
> returns a decision.
|
|
8
|
+
|
|
9
|
+
Published on npm as **`@paystage/trade-preflight@0.1.0`**.
|
|
10
|
+
|
|
11
|
+
## What it does
|
|
12
|
+
|
|
13
|
+
Given a proposed HIP-3 / trade.xyz order and a local policy file, the server returns one of:
|
|
14
|
+
|
|
15
|
+
- `allow` — the order satisfies every rule in the policy
|
|
16
|
+
- `review` — the order needs a human or higher-level check before proceeding
|
|
17
|
+
- `do_not_trade` — the order violates a hard rule in the policy
|
|
18
|
+
|
|
19
|
+
The decision is deterministic and local. No network calls are required to evaluate a policy;
|
|
20
|
+
the tool is a gate you put in front of your own order flow.
|
|
21
|
+
|
|
22
|
+
## Install
|
|
23
|
+
|
|
24
|
+
Run directly with `npx`:
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
npx -y @paystage/trade-preflight
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Or install it:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
npm install @paystage/trade-preflight
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
The package exposes a `stdio` MCP server (bin: `paystage-trade-preflight`).
|
|
37
|
+
|
|
38
|
+
## MCP configuration
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"mcpServers": {
|
|
43
|
+
"paystage-trade-preflight": {
|
|
44
|
+
"command": "npx",
|
|
45
|
+
"args": ["-y", "@paystage/trade-preflight"]
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
No environment variables are required. The policy is passed as a tool argument.
|
|
52
|
+
|
|
53
|
+
## Tool
|
|
54
|
+
|
|
55
|
+
### `evaluate_hip3_trade`
|
|
56
|
+
|
|
57
|
+
Evaluates a proposed HIP-3 / trade.xyz order against a local `TradePolicy`.
|
|
58
|
+
|
|
59
|
+
Inputs (shape):
|
|
60
|
+
|
|
61
|
+
- `order` — the proposed order (market, side, size, price/limit, etc.)
|
|
62
|
+
- `policy` — the local `TradePolicy` object (or a path to it, depending on your setup)
|
|
63
|
+
|
|
64
|
+
Output:
|
|
65
|
+
|
|
66
|
+
- `decision` — `allow` | `review` | `do_not_trade`
|
|
67
|
+
- `reasons` — list of rule results explaining the decision
|
|
68
|
+
|
|
69
|
+
Example policy shape:
|
|
70
|
+
|
|
71
|
+
```json
|
|
72
|
+
{
|
|
73
|
+
"version": 1,
|
|
74
|
+
"max_notional": { "value": "100.00", "asset": "USDC", "decimals": 6 },
|
|
75
|
+
"allowed_markets": ["BTC-USD", "ETH-USD"],
|
|
76
|
+
"allowed_sides": ["buy", "sell"],
|
|
77
|
+
"max_leverage": 1,
|
|
78
|
+
"unknown_market": "review"
|
|
79
|
+
}
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Decisions
|
|
83
|
+
|
|
84
|
+
| Decision | Meaning |
|
|
85
|
+
| --- | --- |
|
|
86
|
+
| `allow` | Order satisfies all policy rules. |
|
|
87
|
+
| `review` | Order needs a human or higher-level check. |
|
|
88
|
+
| `do_not_trade` | Order violates a hard policy rule. |
|
|
89
|
+
|
|
90
|
+
## Links
|
|
91
|
+
|
|
92
|
+
- Website: [paystage.xyz](https://paystage.xyz)
|
|
93
|
+
- HIP-3 context: [docs.trade.xyz](https://docs.trade.xyz)
|
|
94
|
+
- Source: [github.com/base-buzz/paystage](https://github.com/base-buzz/paystage) (`packages/trade-preflight`)
|
|
95
|
+
|
|
96
|
+
## License
|
|
97
|
+
|
|
98
|
+
MIT
|
package/dist/cli.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
|
package/dist/cli.js
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { startServer } from "./server.js";
|
|
3
|
+
startServer().catch((error) => {
|
|
4
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
5
|
+
process.stderr.write(`paystage-trade-preflight fatal: ${message}\n`);
|
|
6
|
+
process.exit(1);
|
|
7
|
+
});
|
|
8
|
+
//# sourceMappingURL=cli.js.map
|
package/dist/cli.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACrC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { EvaluateTradeResult, Snapshot, TradeProposal } from "./types.js";
|
|
2
|
+
import type { TradePolicy } from "./policy.js";
|
|
3
|
+
export declare function evaluateTrade(proposal: TradeProposal, snapshot: Snapshot, policy: TradePolicy): EvaluateTradeResult;
|
|
4
|
+
//# sourceMappingURL=evaluate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqD/C,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,WAAW,GAClB,mBAAmB,CA8JrB"}
|
package/dist/evaluate.js
ADDED
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
const DECISION_RANK = {
|
|
2
|
+
allow: 0,
|
|
3
|
+
review: 1,
|
|
4
|
+
do_not_trade: 2,
|
|
5
|
+
};
|
|
6
|
+
function worse(a, b) {
|
|
7
|
+
return DECISION_RANK[a] >= DECISION_RANK[b] ? a : b;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Parse a decimal string to a JS number. Returns NaN on failure.
|
|
11
|
+
* Uses Number() which is fine for the magnitudes involved here.
|
|
12
|
+
*/
|
|
13
|
+
function toNumber(value) {
|
|
14
|
+
if (value === undefined || value === null)
|
|
15
|
+
return NaN;
|
|
16
|
+
if (typeof value === "number")
|
|
17
|
+
return value;
|
|
18
|
+
const trimmed = value.trim();
|
|
19
|
+
if (trimmed === "")
|
|
20
|
+
return NaN;
|
|
21
|
+
const n = Number(trimmed);
|
|
22
|
+
return Number.isFinite(n) ? n : NaN;
|
|
23
|
+
}
|
|
24
|
+
function formatDecimal(n) {
|
|
25
|
+
if (!Number.isFinite(n))
|
|
26
|
+
return "NaN";
|
|
27
|
+
// Avoid scientific notation for typical trade sizes.
|
|
28
|
+
if (Math.abs(n) >= 1e-6 && Math.abs(n) < 1e21) {
|
|
29
|
+
return n.toString();
|
|
30
|
+
}
|
|
31
|
+
return n.toExponential();
|
|
32
|
+
}
|
|
33
|
+
function findAssetIndex(universe, name) {
|
|
34
|
+
for (let i = 0; i < universe.length; i++) {
|
|
35
|
+
if (universe[i]?.name === name)
|
|
36
|
+
return i;
|
|
37
|
+
}
|
|
38
|
+
return -1;
|
|
39
|
+
}
|
|
40
|
+
function isDelisted(meta) {
|
|
41
|
+
if (meta.isDelisted === true)
|
|
42
|
+
return true;
|
|
43
|
+
// Hyperliquid marks delisted assets with maxLeverage 0 in some cases.
|
|
44
|
+
if (typeof meta.maxLeverage === "number" && meta.maxLeverage <= 0) {
|
|
45
|
+
return true;
|
|
46
|
+
}
|
|
47
|
+
return false;
|
|
48
|
+
}
|
|
49
|
+
export function evaluateTrade(proposal, snapshot, policy) {
|
|
50
|
+
const reasons = [];
|
|
51
|
+
let decision = "allow";
|
|
52
|
+
const bump = (d, reason) => {
|
|
53
|
+
decision = worse(decision, d);
|
|
54
|
+
reasons.push(reason);
|
|
55
|
+
};
|
|
56
|
+
// 1. dex allowlist
|
|
57
|
+
if (!policy.allowed_dexes.includes(proposal.dex)) {
|
|
58
|
+
bump("do_not_trade", `dex "${proposal.dex}" is not in allowed_dexes [${policy.allowed_dexes.join(", ")}]`);
|
|
59
|
+
}
|
|
60
|
+
// 2. asset in universe / not delisted
|
|
61
|
+
const idx = findAssetIndex(snapshot.meta.universe, proposal.asset);
|
|
62
|
+
const assetMeta = idx >= 0 ? snapshot.meta.universe[idx] : undefined;
|
|
63
|
+
if (!assetMeta) {
|
|
64
|
+
bump(policy.unknown_asset, `asset "${proposal.asset}" not found in ${snapshot.dex} universe`);
|
|
65
|
+
}
|
|
66
|
+
else if (isDelisted(assetMeta)) {
|
|
67
|
+
bump(policy.unknown_asset, `asset "${proposal.asset}" appears delisted (maxLeverage=${assetMeta.maxLeverage})`);
|
|
68
|
+
}
|
|
69
|
+
// 3. asset allowlist
|
|
70
|
+
if (!policy.allowed_assets.includes(proposal.asset)) {
|
|
71
|
+
bump(policy.unknown_asset, `asset "${proposal.asset}" is not in allowed_assets`);
|
|
72
|
+
}
|
|
73
|
+
// 4. leverage
|
|
74
|
+
const leverage = proposal.leverage ?? 1;
|
|
75
|
+
if (!Number.isFinite(leverage) || leverage <= 0) {
|
|
76
|
+
bump("do_not_trade", `invalid leverage ${String(proposal.leverage)}`);
|
|
77
|
+
}
|
|
78
|
+
else {
|
|
79
|
+
if (leverage > policy.max_leverage) {
|
|
80
|
+
bump("do_not_trade", `leverage ${leverage} exceeds policy max_leverage ${policy.max_leverage}`);
|
|
81
|
+
}
|
|
82
|
+
if (assetMeta && typeof assetMeta.maxLeverage === "number") {
|
|
83
|
+
if (leverage > assetMeta.maxLeverage) {
|
|
84
|
+
bump("do_not_trade", `leverage ${leverage} exceeds asset maxLeverage ${assetMeta.maxLeverage} for ${proposal.asset}`);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
// 5. notional
|
|
89
|
+
const ctx = idx >= 0 ? snapshot.assetCtxs[idx] : undefined;
|
|
90
|
+
const markPxStr = ctx?.markPx;
|
|
91
|
+
const markPx = toNumber(markPxStr);
|
|
92
|
+
const size = toNumber(proposal.size);
|
|
93
|
+
let notionalUsdc;
|
|
94
|
+
if (!Number.isFinite(size) || size <= 0) {
|
|
95
|
+
bump("do_not_trade", `invalid size "${proposal.size}"`);
|
|
96
|
+
}
|
|
97
|
+
else if (!Number.isFinite(markPx) || markPx <= 0) {
|
|
98
|
+
bump("do_not_trade", `missing or invalid markPx for ${proposal.asset} (got ${String(markPxStr)})`);
|
|
99
|
+
}
|
|
100
|
+
else {
|
|
101
|
+
notionalUsdc = size * markPx;
|
|
102
|
+
const maxNotional = toNumber(policy.max_notional_usdc);
|
|
103
|
+
if (!Number.isFinite(maxNotional)) {
|
|
104
|
+
bump("do_not_trade", `policy max_notional_usdc is not a valid number: "${policy.max_notional_usdc}"`);
|
|
105
|
+
}
|
|
106
|
+
else if (notionalUsdc > maxNotional) {
|
|
107
|
+
bump("do_not_trade", `notional ${formatDecimal(notionalUsdc)} USDC exceeds max_notional_usdc ${policy.max_notional_usdc}`);
|
|
108
|
+
}
|
|
109
|
+
else if (policy.require_review_above_notional_usdc !== undefined) {
|
|
110
|
+
const reviewAbove = toNumber(policy.require_review_above_notional_usdc);
|
|
111
|
+
if (!Number.isFinite(reviewAbove)) {
|
|
112
|
+
bump("do_not_trade", `policy require_review_above_notional_usdc is not a valid number: "${policy.require_review_above_notional_usdc}"`);
|
|
113
|
+
}
|
|
114
|
+
else if (notionalUsdc > reviewAbove) {
|
|
115
|
+
bump("review", `notional ${formatDecimal(notionalUsdc)} USDC exceeds require_review_above_notional_usdc ${policy.require_review_above_notional_usdc}`);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
// 6. funding
|
|
120
|
+
const fundingStr = ctx?.funding;
|
|
121
|
+
const funding = toNumber(fundingStr);
|
|
122
|
+
if (Number.isFinite(funding)) {
|
|
123
|
+
const maxAbsFunding = toNumber(policy.max_abs_funding);
|
|
124
|
+
if (!Number.isFinite(maxAbsFunding)) {
|
|
125
|
+
bump("do_not_trade", `policy max_abs_funding is not a valid number: "${policy.max_abs_funding}"`);
|
|
126
|
+
}
|
|
127
|
+
else if (Math.abs(funding) > maxAbsFunding) {
|
|
128
|
+
bump("review", `|funding| ${formatDecimal(Math.abs(funding))} exceeds max_abs_funding ${policy.max_abs_funding}`);
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
else if (ctx) {
|
|
132
|
+
// ctx exists but funding unparseable — fail closed to review.
|
|
133
|
+
bump("review", `funding for ${proposal.asset} is missing or invalid (got ${String(fundingStr)})`);
|
|
134
|
+
}
|
|
135
|
+
if (reasons.length === 0) {
|
|
136
|
+
reasons.push("all checks passed");
|
|
137
|
+
}
|
|
138
|
+
const summary = buildSummary(decision, proposal, notionalUsdc, markPxStr, fundingStr);
|
|
139
|
+
const result = {
|
|
140
|
+
decision,
|
|
141
|
+
reasons,
|
|
142
|
+
summary,
|
|
143
|
+
};
|
|
144
|
+
if (assetMeta)
|
|
145
|
+
result.asset = assetMeta.name;
|
|
146
|
+
if (markPxStr !== undefined)
|
|
147
|
+
result.markPx = markPxStr;
|
|
148
|
+
if (notionalUsdc !== undefined) {
|
|
149
|
+
result.notionalUsdc = formatDecimal(notionalUsdc);
|
|
150
|
+
}
|
|
151
|
+
if (fundingStr !== undefined)
|
|
152
|
+
result.funding = fundingStr;
|
|
153
|
+
return result;
|
|
154
|
+
}
|
|
155
|
+
function buildSummary(decision, proposal, notionalUsdc, markPx, funding) {
|
|
156
|
+
const parts = [];
|
|
157
|
+
parts.push(`${decision.toUpperCase()}: ${proposal.side} ${proposal.size} ${proposal.asset} on ${proposal.dex}`);
|
|
158
|
+
if (notionalUsdc !== undefined) {
|
|
159
|
+
parts.push(`notional≈${formatDecimal(notionalUsdc)} USDC`);
|
|
160
|
+
}
|
|
161
|
+
if (markPx !== undefined) {
|
|
162
|
+
parts.push(`markPx=${markPx}`);
|
|
163
|
+
}
|
|
164
|
+
if (funding !== undefined) {
|
|
165
|
+
parts.push(`funding=${funding}`);
|
|
166
|
+
}
|
|
167
|
+
return parts.join(" | ");
|
|
168
|
+
}
|
|
169
|
+
//# sourceMappingURL=evaluate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"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"}
|
package/dist/fetch.d.ts
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { Snapshot } from "./types.js";
|
|
2
|
+
export declare const DEFAULT_INFO_URL = "https://api.hyperliquid.xyz/info";
|
|
3
|
+
export declare const DEFAULT_DEX = "xyz";
|
|
4
|
+
export interface FetchOptions {
|
|
5
|
+
dex?: string;
|
|
6
|
+
infoUrl?: string;
|
|
7
|
+
fetchImpl?: typeof fetch;
|
|
8
|
+
signal?: AbortSignal;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Fetch HIP-3 meta + asset contexts for a dex from the Hyperliquid info endpoint.
|
|
12
|
+
* POST {type:"metaAndAssetCtxs", dex}
|
|
13
|
+
*/
|
|
14
|
+
export declare function fetchMetaAndAssetCtxs(dexOrOptions?: string | FetchOptions, maybeOptions?: FetchOptions): Promise<Snapshot>;
|
|
15
|
+
//# sourceMappingURL=fetch.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AACnE,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAOD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,GAAE,MAAM,GAAG,YAA0B,EACjD,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CA6DnB"}
|
package/dist/fetch.js
ADDED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
export const DEFAULT_INFO_URL = "https://api.hyperliquid.xyz/info";
|
|
2
|
+
export const DEFAULT_DEX = "xyz";
|
|
3
|
+
/**
|
|
4
|
+
* Fetch HIP-3 meta + asset contexts for a dex from the Hyperliquid info endpoint.
|
|
5
|
+
* POST {type:"metaAndAssetCtxs", dex}
|
|
6
|
+
*/
|
|
7
|
+
export async function fetchMetaAndAssetCtxs(dexOrOptions = DEFAULT_DEX, maybeOptions = {}) {
|
|
8
|
+
const opts = typeof dexOrOptions === "string"
|
|
9
|
+
? { ...maybeOptions, dex: dexOrOptions }
|
|
10
|
+
: dexOrOptions;
|
|
11
|
+
const dex = opts.dex ?? DEFAULT_DEX;
|
|
12
|
+
const infoUrl = opts.infoUrl ?? DEFAULT_INFO_URL;
|
|
13
|
+
const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
|
|
14
|
+
if (typeof fetchImpl !== "function") {
|
|
15
|
+
throw new Error("No fetch implementation available");
|
|
16
|
+
}
|
|
17
|
+
const res = await fetchImpl(infoUrl, {
|
|
18
|
+
method: "POST",
|
|
19
|
+
headers: { "content-type": "application/json" },
|
|
20
|
+
body: JSON.stringify({ type: "metaAndAssetCtxs", dex }),
|
|
21
|
+
signal: opts.signal,
|
|
22
|
+
});
|
|
23
|
+
if (!res.ok) {
|
|
24
|
+
throw new Error(`Hyperliquid info request failed: ${res.status} ${res.statusText}`);
|
|
25
|
+
}
|
|
26
|
+
const raw = (await res.json());
|
|
27
|
+
// API returns a tuple: [meta, assetCtxs]
|
|
28
|
+
let meta;
|
|
29
|
+
let assetCtxs;
|
|
30
|
+
if (Array.isArray(raw) && raw.length === 2) {
|
|
31
|
+
meta = raw[0];
|
|
32
|
+
assetCtxs = raw[1];
|
|
33
|
+
}
|
|
34
|
+
else if (raw &&
|
|
35
|
+
typeof raw === "object" &&
|
|
36
|
+
"meta" in raw &&
|
|
37
|
+
"assetCtxs" in raw) {
|
|
38
|
+
const obj = raw;
|
|
39
|
+
meta = obj.meta;
|
|
40
|
+
assetCtxs = obj.assetCtxs;
|
|
41
|
+
}
|
|
42
|
+
else {
|
|
43
|
+
throw new Error("Unexpected metaAndAssetCtxs response shape");
|
|
44
|
+
}
|
|
45
|
+
if (!meta || !Array.isArray(meta.universe)) {
|
|
46
|
+
throw new Error("metaAndAssetCtxs response missing meta.universe");
|
|
47
|
+
}
|
|
48
|
+
if (!Array.isArray(assetCtxs)) {
|
|
49
|
+
throw new Error("metaAndAssetCtxs response missing assetCtxs");
|
|
50
|
+
}
|
|
51
|
+
return {
|
|
52
|
+
dex,
|
|
53
|
+
meta: meta,
|
|
54
|
+
assetCtxs: assetCtxs,
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=fetch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAcjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,eAAsC,WAAW,EACjD,eAA6B,EAAE;IAE/B,MAAM,IAAI,GACR,OAAO,YAAY,KAAK,QAAQ;QAC9B,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE;QACxC,CAAC,CAAC,YAAY,CAAC;IAEnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC;IAErD,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;QACnC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC;QACvD,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,oCAAoC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;IAE1C,yCAAyC;IACzC,IAAI,IAAiC,CAAC;IACtC,IAAI,SAAoB,CAAC;IAEzB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,IAAI,GAAG,GAAG,CAAC,CAAC,CAAgC,CAAC;QAC7C,SAAS,GAAG,GAAG,CAAC,CAAC,CAAc,CAAC;IAClC,CAAC;SAAM,IACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACb,WAAW,IAAI,GAAG,EAClB,CAAC;QACD,MAAM,GAAG,GAAG,GAA0B,CAAC;QACvC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAChB,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;QACL,GAAG;QACH,IAAI,EAAE,IAAwB;QAC9B,SAAS,EAAE,SAAkC;KAC9C,CAAC;AACJ,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export type { Decision, Side, OrderType, TradeProposal, AssetMeta, AssetCtx, Meta, Snapshot, EvaluateTradeResult, } from "./types.js";
|
|
2
|
+
export { TradePolicySchema, parseTradePolicy, safeParseTradePolicy, } from "./policy.js";
|
|
3
|
+
export type { TradePolicy } from "./policy.js";
|
|
4
|
+
export { fetchMetaAndAssetCtxs, DEFAULT_INFO_URL, DEFAULT_DEX, } from "./fetch.js";
|
|
5
|
+
export type { FetchOptions } from "./fetch.js";
|
|
6
|
+
export { evaluateTrade } from "./evaluate.js";
|
|
7
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,aAAa,EACb,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
|
package/dist/policy.d.ts
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const TradePolicySchema: z.ZodObject<{
|
|
3
|
+
version: z.ZodLiteral<1>;
|
|
4
|
+
allowed_dexes: z.ZodArray<z.ZodString, "many">;
|
|
5
|
+
allowed_assets: z.ZodArray<z.ZodString, "many">;
|
|
6
|
+
max_notional_usdc: z.ZodString;
|
|
7
|
+
max_leverage: z.ZodNumber;
|
|
8
|
+
max_abs_funding: z.ZodString;
|
|
9
|
+
require_review_above_notional_usdc: z.ZodOptional<z.ZodString>;
|
|
10
|
+
unknown_asset: z.ZodDefault<z.ZodEnum<["review", "do_not_trade"]>>;
|
|
11
|
+
}, "strip", z.ZodTypeAny, {
|
|
12
|
+
version: 1;
|
|
13
|
+
allowed_dexes: string[];
|
|
14
|
+
allowed_assets: string[];
|
|
15
|
+
max_notional_usdc: string;
|
|
16
|
+
max_leverage: number;
|
|
17
|
+
max_abs_funding: string;
|
|
18
|
+
unknown_asset: "review" | "do_not_trade";
|
|
19
|
+
require_review_above_notional_usdc?: string | undefined;
|
|
20
|
+
}, {
|
|
21
|
+
version: 1;
|
|
22
|
+
allowed_dexes: string[];
|
|
23
|
+
allowed_assets: string[];
|
|
24
|
+
max_notional_usdc: string;
|
|
25
|
+
max_leverage: number;
|
|
26
|
+
max_abs_funding: string;
|
|
27
|
+
require_review_above_notional_usdc?: string | undefined;
|
|
28
|
+
unknown_asset?: "review" | "do_not_trade" | undefined;
|
|
29
|
+
}>;
|
|
30
|
+
export type TradePolicy = z.infer<typeof TradePolicySchema>;
|
|
31
|
+
export declare function parseTradePolicy(input: unknown): TradePolicy;
|
|
32
|
+
export declare function safeParseTradePolicy(input: unknown): {
|
|
33
|
+
success: true;
|
|
34
|
+
data: TradePolicy;
|
|
35
|
+
} | {
|
|
36
|
+
success: false;
|
|
37
|
+
error: z.ZodError;
|
|
38
|
+
};
|
|
39
|
+
//# sourceMappingURL=policy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE5D;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GAEZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACpC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAExC"}
|
package/dist/policy.js
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
const decimalString = z
|
|
3
|
+
.string()
|
|
4
|
+
.regex(/^-?\d+(\.\d+)?$/, "must be a decimal string");
|
|
5
|
+
export const TradePolicySchema = z.object({
|
|
6
|
+
version: z.literal(1),
|
|
7
|
+
allowed_dexes: z.array(z.string()).min(1),
|
|
8
|
+
allowed_assets: z.array(z.string()).min(1),
|
|
9
|
+
max_notional_usdc: decimalString,
|
|
10
|
+
max_leverage: z.number().int().positive(),
|
|
11
|
+
max_abs_funding: decimalString,
|
|
12
|
+
require_review_above_notional_usdc: decimalString.optional(),
|
|
13
|
+
unknown_asset: z.enum(["review", "do_not_trade"]).default("do_not_trade"),
|
|
14
|
+
});
|
|
15
|
+
export function parseTradePolicy(input) {
|
|
16
|
+
return TradePolicySchema.parse(input);
|
|
17
|
+
}
|
|
18
|
+
export function safeParseTradePolicy(input) {
|
|
19
|
+
return TradePolicySchema.safeParse(input);
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,EAAE;KACR,KAAK,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,iBAAiB,EAAE,aAAa;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACzC,eAAe,EAAE,aAAa;IAC9B,kCAAkC,EAAE,aAAa,CAAC,QAAQ,EAAE;IAC5D,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;CAC1E,CAAC,CAAC;AAIH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAId,OAAO,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC"}
|
package/dist/server.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBpE,wBAAgB,YAAY,IAAI,SAAS,CAkDxC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}
|
package/dist/server.js
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
3
|
+
import { z } from "zod";
|
|
4
|
+
import { parseTradePolicy } from "./policy.js";
|
|
5
|
+
import { fetchMetaAndAssetCtxs } from "./fetch.js";
|
|
6
|
+
import { evaluateTrade } from "./evaluate.js";
|
|
7
|
+
const TradeProposalSchema = z.object({
|
|
8
|
+
dex: z.string(),
|
|
9
|
+
asset: z.string(),
|
|
10
|
+
side: z.enum(["buy", "sell"]),
|
|
11
|
+
size: z.string(),
|
|
12
|
+
leverage: z.number().optional(),
|
|
13
|
+
order_type: z.enum(["limit", "market"]).optional(),
|
|
14
|
+
limit_px: z.string().optional(),
|
|
15
|
+
});
|
|
16
|
+
const SnapshotSchema = z.object({
|
|
17
|
+
dex: z.string(),
|
|
18
|
+
meta: z.object({ universe: z.array(z.record(z.unknown())) }).passthrough(),
|
|
19
|
+
assetCtxs: z.array(z.record(z.unknown())),
|
|
20
|
+
});
|
|
21
|
+
export function createServer() {
|
|
22
|
+
const server = new McpServer({
|
|
23
|
+
name: "paystage-trade-preflight",
|
|
24
|
+
version: "0.0.0",
|
|
25
|
+
});
|
|
26
|
+
server.registerTool("evaluate_hip3_trade", {
|
|
27
|
+
description: "Evaluate a Hyperliquid HIP-3 (trade.xyz) order against a TradePolicy before an agent trades. Returns decision allow | review | do_not_trade.",
|
|
28
|
+
inputSchema: {
|
|
29
|
+
proposal: TradeProposalSchema,
|
|
30
|
+
policy: z.unknown(),
|
|
31
|
+
snapshot: SnapshotSchema.optional(),
|
|
32
|
+
},
|
|
33
|
+
}, async (args) => {
|
|
34
|
+
try {
|
|
35
|
+
const policy = parseTradePolicy(args.policy);
|
|
36
|
+
const snapshot = args.snapshot !== undefined
|
|
37
|
+
? SnapshotSchema.parse(args.snapshot)
|
|
38
|
+
: await fetchMetaAndAssetCtxs(args.proposal.dex || "xyz");
|
|
39
|
+
const result = evaluateTrade(args.proposal, snapshot, policy);
|
|
40
|
+
return {
|
|
41
|
+
content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
catch (error) {
|
|
45
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
46
|
+
return {
|
|
47
|
+
isError: true,
|
|
48
|
+
content: [{ type: "text", text: `Error: ${message}` }],
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
return server;
|
|
53
|
+
}
|
|
54
|
+
export async function startServer() {
|
|
55
|
+
const server = createServer();
|
|
56
|
+
const transport = new StdioServerTransport();
|
|
57
|
+
await server.connect(transport);
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
export type Decision = "allow" | "review" | "do_not_trade";
|
|
2
|
+
export type Side = "buy" | "sell";
|
|
3
|
+
export type OrderType = "limit" | "market";
|
|
4
|
+
export interface TradeProposal {
|
|
5
|
+
dex: string;
|
|
6
|
+
asset: string;
|
|
7
|
+
side: Side;
|
|
8
|
+
size: string;
|
|
9
|
+
leverage?: number;
|
|
10
|
+
order_type?: OrderType;
|
|
11
|
+
limit_px?: string;
|
|
12
|
+
}
|
|
13
|
+
export interface AssetMeta {
|
|
14
|
+
name: string;
|
|
15
|
+
szDecimals: number;
|
|
16
|
+
maxLeverage: number;
|
|
17
|
+
marginTableId?: number;
|
|
18
|
+
growthMode?: string;
|
|
19
|
+
lastFeeScaleChangeTime?: string;
|
|
20
|
+
deployerFeeScale?: string;
|
|
21
|
+
isDelisted?: boolean;
|
|
22
|
+
[key: string]: unknown;
|
|
23
|
+
}
|
|
24
|
+
export interface AssetCtx {
|
|
25
|
+
funding: string;
|
|
26
|
+
openInterest: string;
|
|
27
|
+
prevDayPx?: string;
|
|
28
|
+
dayNtlVlm?: string;
|
|
29
|
+
premium?: string;
|
|
30
|
+
oraclePx?: string;
|
|
31
|
+
markPx: string;
|
|
32
|
+
midPx?: string;
|
|
33
|
+
impactPxs?: string[];
|
|
34
|
+
dayBaseVlm?: string;
|
|
35
|
+
[key: string]: unknown;
|
|
36
|
+
}
|
|
37
|
+
export interface Meta {
|
|
38
|
+
universe: AssetMeta[];
|
|
39
|
+
collateralToken?: number;
|
|
40
|
+
[key: string]: unknown;
|
|
41
|
+
}
|
|
42
|
+
export interface Snapshot {
|
|
43
|
+
dex: string;
|
|
44
|
+
meta: Meta;
|
|
45
|
+
assetCtxs: AssetCtx[];
|
|
46
|
+
}
|
|
47
|
+
export interface EvaluateTradeResult {
|
|
48
|
+
decision: Decision;
|
|
49
|
+
reasons: string[];
|
|
50
|
+
summary: string;
|
|
51
|
+
asset?: string;
|
|
52
|
+
markPx?: string;
|
|
53
|
+
notionalUsdc?: string;
|
|
54
|
+
funding?: string;
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAE3D,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAElC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
|
package/package.json
CHANGED
|
@@ -1,6 +1,36 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@paystage/trade-preflight",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "MCP tool: evaluate HIP-3/trade.xyz orders against a local TradePolicy before trading",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"paystage-trade-preflight": "dist/index.js"
|
|
9
|
+
},
|
|
10
|
+
"main": "dist/index.js",
|
|
11
|
+
"files": [
|
|
12
|
+
"dist",
|
|
13
|
+
"README.md",
|
|
14
|
+
"server.json"
|
|
15
|
+
],
|
|
16
|
+
"mcpName": "xyz.paystage/trade-preflight",
|
|
17
|
+
"publishConfig": {
|
|
18
|
+
"access": "public"
|
|
19
|
+
},
|
|
20
|
+
"scripts": {
|
|
21
|
+
"build": "tsc -p tsconfig.json",
|
|
22
|
+
"start": "node dist/index.js",
|
|
23
|
+
"prepublishOnly": "npm run build"
|
|
24
|
+
},
|
|
25
|
+
"dependencies": {
|
|
26
|
+
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
27
|
+
"zod": "^3.23.8"
|
|
28
|
+
},
|
|
29
|
+
"devDependencies": {
|
|
30
|
+
"typescript": "^5.5.4",
|
|
31
|
+
"@types/node": "^20.14.0"
|
|
32
|
+
},
|
|
33
|
+
"engines": {
|
|
34
|
+
"node": ">=18"
|
|
35
|
+
}
|
|
36
|
+
}
|
package/server.json
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
|
+
"name": "xyz.paystage/trade-preflight",
|
|
4
|
+
"title": "PayStage Trade Preflight",
|
|
5
|
+
"description": "MCP tool: evaluate HIP-3/trade.xyz orders against a local TradePolicy before trading",
|
|
6
|
+
"version": "0.1.0",
|
|
7
|
+
"websiteUrl": "https://paystage.xyz",
|
|
8
|
+
"repository": {
|
|
9
|
+
"url": "https://github.com/base-buzz/paystage",
|
|
10
|
+
"source": "github",
|
|
11
|
+
"subfolder": "packages/trade-preflight"
|
|
12
|
+
},
|
|
13
|
+
"packages": [
|
|
14
|
+
{
|
|
15
|
+
"registryType": "npm",
|
|
16
|
+
"registryBaseUrl": "https://registry.npmjs.org",
|
|
17
|
+
"identifier": "@paystage/trade-preflight",
|
|
18
|
+
"version": "0.1.0",
|
|
19
|
+
"transport": {
|
|
20
|
+
"type": "stdio"
|
|
21
|
+
},
|
|
22
|
+
"environmentVariables": []
|
|
23
|
+
}
|
|
24
|
+
]
|
|
25
|
+
}
|