@proof-labs/trading-sdk 10.0.0 → 10.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.
@@ -0,0 +1,82 @@
1
+ import { U64_MAX, I64_MAX, hexAddress, invalidRead, marketId, } from "./read-values.js";
2
+ import { Side } from "./types.js";
3
+ /** The node keeps the newest 500 fills per market and serves 100 by default. */
4
+ const DEFAULT_RECENT_TRADES_LIMIT = 100;
5
+ const MAX_RECENT_TRADES_LIMIT = 500;
6
+ function invalid(field, kind = "malformed") {
7
+ return invalidRead(`recent trades.${field}`, kind);
8
+ }
9
+ /** A decimal integer the node renders as text, within [min, max]. */
10
+ function decimal(value, field, min, max) {
11
+ if (typeof value !== "string" ||
12
+ value.length > 20 ||
13
+ !/^(0|-?[1-9][0-9]*)$/.test(value))
14
+ invalid(field);
15
+ const n = BigInt(value);
16
+ if (n < min || n > max)
17
+ invalid(field);
18
+ return n;
19
+ }
20
+ export function recentTradesLimit(market, options) {
21
+ // Caller mistakes are configuration, not gateway faults.
22
+ if (!Number.isInteger(market) || market < 1 || market > 0xffffffff)
23
+ invalid("market", "configuration");
24
+ const limit = options.limit ?? DEFAULT_RECENT_TRADES_LIMIT;
25
+ if (!Number.isSafeInteger(limit) ||
26
+ limit < 1 ||
27
+ limit > MAX_RECENT_TRADES_LIMIT)
28
+ invalid("limit", "configuration");
29
+ return limit;
30
+ }
31
+ /** Newest first. The tape lives in one node's memory: it starts empty after a
32
+ * restart, an unknown market is an empty list, and two nodes behind one
33
+ * gateway can serve different tapes. Use the indexed trade history when
34
+ * completeness matters. */
35
+ export function decodeRecentTrades(value, market, options) {
36
+ const limit = recentTradesLimit(market, options);
37
+ if (!value || typeof value !== "object" || Array.isArray(value))
38
+ invalid("page");
39
+ const rows = value.trades;
40
+ if (!Array.isArray(rows) || rows.length > limit)
41
+ invalid("page size");
42
+ const ids = new Set();
43
+ let previousHeight;
44
+ return rows.map((raw) => {
45
+ if (!raw || typeof raw !== "object" || Array.isArray(raw))
46
+ invalid("trade");
47
+ const row = raw;
48
+ if (typeof row.market !== "string" ||
49
+ !/^[1-9][0-9]{0,9}$/.test(row.market) ||
50
+ Number(row.market) !== market)
51
+ invalid("market mismatch", "binding");
52
+ const fillId = decimal(row.fill_id, "fill id", 0n, U64_MAX);
53
+ if (ids.has(fillId))
54
+ invalid("duplicate trade");
55
+ ids.add(fillId);
56
+ if (!Number.isSafeInteger(row.block_height) ||
57
+ row.block_height < 0)
58
+ invalid("block height");
59
+ const blockHeight = BigInt(row.block_height);
60
+ if (previousHeight !== undefined && blockHeight > previousHeight)
61
+ invalid("unordered trade");
62
+ previousHeight = blockHeight;
63
+ if (!Number.isSafeInteger(row.timestamp) || row.timestamp < 0)
64
+ invalid("timestamp");
65
+ if (row.maker_side !== "buy" && row.maker_side !== "sell")
66
+ invalid("maker side");
67
+ return {
68
+ fillId,
69
+ market: marketId(market),
70
+ price: decimal(row.price, "price", 0n, U64_MAX),
71
+ quantity: decimal(row.quantity, "quantity", 0n, U64_MAX),
72
+ makerOwner: hexAddress(row.maker_owner, "recent trades.maker owner"),
73
+ takerOwner: hexAddress(row.taker_owner, "recent trades.taker owner"),
74
+ makerSide: row.maker_side === "buy" ? Side.Buy : Side.Sell,
75
+ takerFee: decimal(row.taker_fee, "taker fee", -I64_MAX - 1n, I64_MAX),
76
+ makerFee: decimal(row.maker_fee, "maker fee", -I64_MAX - 1n, I64_MAX),
77
+ blockHeight,
78
+ recordedAtMs: row.timestamp,
79
+ };
80
+ });
81
+ }
82
+ //# sourceMappingURL=recent-trades.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recent-trades.js","sourceRoot":"","sources":["../src/recent-trades.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@proof-labs/trading-sdk",
3
- "version": "10.0.0",
3
+ "version": "10.1.0",
4
4
  "description": "TypeScript SDK for Proof Exchange — signing, encoding, querying, and submitting actions.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {