@stxapp/stx-typescript 0.6.1 → 0.6.3
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/CHANGELOG.md +8 -0
- package/dist/{chunk-7O5ZGZQI.cjs → chunk-CSHPFQ2V.cjs} +214 -28
- package/dist/chunk-CSHPFQ2V.cjs.map +1 -0
- package/dist/{chunk-P7ZEHWKM.js → chunk-PZUVKPHZ.js} +196 -10
- package/dist/chunk-PZUVKPHZ.js.map +1 -0
- package/dist/{client-wriBXPDx.d.cts → client-Dkd5vesS.d.cts} +13 -8
- package/dist/{client-wriBXPDx.d.ts → client-Dkd5vesS.d.ts} +13 -8
- package/dist/index.cjs +2 -2
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/oauth.cjs +17 -17
- package/dist/oauth.d.cts +2 -2
- package/dist/oauth.d.ts +2 -2
- package/dist/oauth.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-7O5ZGZQI.cjs.map +0 -1
- package/dist/chunk-P7ZEHWKM.js.map +0 -1
|
@@ -809,7 +809,7 @@ function credentialsFromSettings(keyId, privateKey, signer) {
|
|
|
809
809
|
}
|
|
810
810
|
|
|
811
811
|
// src/version.ts
|
|
812
|
-
var VERSION = "0.6.
|
|
812
|
+
var VERSION = "0.6.3";
|
|
813
813
|
var USER_AGENT = `stx-typescript/${VERSION}`;
|
|
814
814
|
var ASYNC_DISPOSE = Symbol.asyncDispose ?? /* @__PURE__ */ Symbol.for("Symbol.asyncDispose");
|
|
815
815
|
|
|
@@ -1187,6 +1187,160 @@ function toBatchOrderResult(raw) {
|
|
|
1187
1187
|
return { ...obj, order, errors, ok: order !== null && !errors?.length };
|
|
1188
1188
|
}
|
|
1189
1189
|
|
|
1190
|
+
// src/legacy-routes.ts
|
|
1191
|
+
function isRouteMissing(err) {
|
|
1192
|
+
return err instanceof STXNotFoundException && err.statusCode === 404 && typeof err.body === "string";
|
|
1193
|
+
}
|
|
1194
|
+
var QUIET = { debug() {
|
|
1195
|
+
}, info() {
|
|
1196
|
+
}, warn() {
|
|
1197
|
+
}, error() {
|
|
1198
|
+
} };
|
|
1199
|
+
var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
1200
|
+
async function channelSnapshot(client, join3, event) {
|
|
1201
|
+
const me = await client._identity();
|
|
1202
|
+
const ws = client.websocket({
|
|
1203
|
+
userId: me.user_id,
|
|
1204
|
+
reconnect: false,
|
|
1205
|
+
channelPingIntervalMs: null,
|
|
1206
|
+
joinTimeoutMs: client.timeoutMs,
|
|
1207
|
+
logger: QUIET
|
|
1208
|
+
});
|
|
1209
|
+
try {
|
|
1210
|
+
const channel = await join3(ws, me);
|
|
1211
|
+
const snapshot = await channel.waitSnapshot(client.timeoutMs);
|
|
1212
|
+
return snapshot[event];
|
|
1213
|
+
} finally {
|
|
1214
|
+
await ws.close();
|
|
1215
|
+
}
|
|
1216
|
+
}
|
|
1217
|
+
async function balanceFromChannel(client) {
|
|
1218
|
+
const payload = await channelSnapshot(
|
|
1219
|
+
client,
|
|
1220
|
+
(ws, me) => ws.balances(me.account_id ? { accountId: me.account_id } : {}),
|
|
1221
|
+
"balances"
|
|
1222
|
+
);
|
|
1223
|
+
if (!payload || typeof payload !== "object") {
|
|
1224
|
+
throw new STXException("The balances channel sent no balance", { path: "/api/v1/account/balance" });
|
|
1225
|
+
}
|
|
1226
|
+
return payload;
|
|
1227
|
+
}
|
|
1228
|
+
function positionsFilter(marketIds) {
|
|
1229
|
+
if (marketIds === void 0 || marketIds === null) return null;
|
|
1230
|
+
const list = typeof marketIds === "string" ? [marketIds] : [...marketIds];
|
|
1231
|
+
if (list.length === 0) return null;
|
|
1232
|
+
const joined = list.join(",");
|
|
1233
|
+
if (joined === "") return null;
|
|
1234
|
+
const ids2 = joined.split(",").map((s) => s.trim());
|
|
1235
|
+
for (const id of ids2) {
|
|
1236
|
+
if (!UUID.test(id)) {
|
|
1237
|
+
throw new STXValidationException(`${id} is not a valid UUID`, {
|
|
1238
|
+
statusCode: 400,
|
|
1239
|
+
body: { error: `${id} is not a valid UUID` },
|
|
1240
|
+
method: "GET",
|
|
1241
|
+
path: "/api/v1/positions"
|
|
1242
|
+
});
|
|
1243
|
+
}
|
|
1244
|
+
}
|
|
1245
|
+
return new Set(ids2.map((id) => id.toLowerCase()));
|
|
1246
|
+
}
|
|
1247
|
+
async function positionsFromChannel(client, query = {}) {
|
|
1248
|
+
const filter = positionsFilter(query.marketIds);
|
|
1249
|
+
const payload = await channelSnapshot(client, (ws) => ws.positions(), "all_positions");
|
|
1250
|
+
const rows = payload && Array.isArray(payload.positions) ? payload.positions : null;
|
|
1251
|
+
if (!rows) throw new STXException("The positions channel sent no positions", { path: "/api/v1/positions" });
|
|
1252
|
+
return filter ? rows.filter((p) => filter.has(String(p.market_id).toLowerCase())) : rows;
|
|
1253
|
+
}
|
|
1254
|
+
var MAX_BATCH_ORDERS = 100;
|
|
1255
|
+
var ORDER_TYPES = ["limit", "market"];
|
|
1256
|
+
var ACTIONS = ["buy", "sell"];
|
|
1257
|
+
var EXPIRATIONS = ["good_till_start", "good_till_time"];
|
|
1258
|
+
function batchRefusal(message) {
|
|
1259
|
+
return new STXValidationException(message, {
|
|
1260
|
+
statusCode: 400,
|
|
1261
|
+
body: { error: message },
|
|
1262
|
+
method: "POST",
|
|
1263
|
+
path: "/api/v1/orders/batched"
|
|
1264
|
+
});
|
|
1265
|
+
}
|
|
1266
|
+
function enumError(field, value, allowed, required) {
|
|
1267
|
+
if (value === void 0 || value === null) return required ? `${field} is required` : void 0;
|
|
1268
|
+
if (typeof value !== "string") return `${field} is invalid`;
|
|
1269
|
+
return allowed.includes(value) ? void 0 : `${field} has invalid value: ${value}`;
|
|
1270
|
+
}
|
|
1271
|
+
function parseDecimal(text) {
|
|
1272
|
+
if (/^[+-]?(inf|infinity|nan)$/i.test(text)) return { special: true };
|
|
1273
|
+
const m = /^([+-]?)(?:(\d+)\.?(\d*)|\.(\d+))(?:[eE]([+-]?\d+))?$/.exec(text);
|
|
1274
|
+
if (!m) return void 0;
|
|
1275
|
+
const int = m[2] ?? "";
|
|
1276
|
+
const frac = m[3] ?? m[4] ?? "";
|
|
1277
|
+
return { special: false, sign: m[1] === "-" ? -1 : 1, digits: int + frac, exp: Number(m[5] ?? 0) - frac.length };
|
|
1278
|
+
}
|
|
1279
|
+
var scaleOf = (exp) => Math.max(0, -exp);
|
|
1280
|
+
function priceError(value) {
|
|
1281
|
+
if (value === void 0 || value === null) return void 0;
|
|
1282
|
+
const format2 = 'price must be a dollar amount as a string, e.g. "30.00"';
|
|
1283
|
+
if (typeof value !== "string") return format2;
|
|
1284
|
+
const d = parseDecimal(value);
|
|
1285
|
+
if (!d || d.special) return format2;
|
|
1286
|
+
if (scaleOf(d.exp) > 7) return "price supports at most 7 decimal places";
|
|
1287
|
+
const trailingZeros = /0*$/.exec(d.digits)[0].length;
|
|
1288
|
+
const significant = /^0*$/.test(d.digits) ? 0 : scaleOf(d.exp + trailingZeros);
|
|
1289
|
+
if (significant > 2) {
|
|
1290
|
+
return `price must be a whole number of cents \u2014 at most 2 decimal places, not counting trailing zeros (got ${JSON.stringify(value)})`;
|
|
1291
|
+
}
|
|
1292
|
+
if (d.sign < 0 || /^0*$/.test(d.digits)) return "price must be greater than 0";
|
|
1293
|
+
return void 0;
|
|
1294
|
+
}
|
|
1295
|
+
function marketIdError(value) {
|
|
1296
|
+
if (value === void 0 || value === null) return "market_id is required";
|
|
1297
|
+
return typeof value === "string" && UUID.test(value) ? void 0 : "market_id is not a valid UUID";
|
|
1298
|
+
}
|
|
1299
|
+
function quantityError(value) {
|
|
1300
|
+
if (value === void 0 || value === null) return "quantity is required";
|
|
1301
|
+
const d = typeof value === "string" ? parseDecimal(value) : void 0;
|
|
1302
|
+
return d && !d.special ? void 0 : 'quantity must be a decimal string, e.g. "10" or "10.00"';
|
|
1303
|
+
}
|
|
1304
|
+
function validateBatch(orders) {
|
|
1305
|
+
if (orders.length === 0) throw batchRefusal("orders must not be empty");
|
|
1306
|
+
if (orders.length > MAX_BATCH_ORDERS) {
|
|
1307
|
+
throw batchRefusal(`orders may contain at most ${MAX_BATCH_ORDERS} orders per batch`);
|
|
1308
|
+
}
|
|
1309
|
+
for (const order of orders) {
|
|
1310
|
+
const { marketId, action, orderType, ...fields } = order;
|
|
1311
|
+
const body = orderBody(marketId, action, orderType, fields);
|
|
1312
|
+
const message = marketIdError(body.market_id) ?? enumError("order_type", body.order_type, ORDER_TYPES, true) ?? enumError("action", body.action, ACTIONS, true) ?? priceError(body.price) ?? quantityError(body.quantity) ?? enumError("expiration", body.expiration, EXPIRATIONS, false) ?? (body.expiration !== void 0 && body.order_type !== "limit" ? "Order expiration is only supported for limit orders." : void 0);
|
|
1313
|
+
if (message) throw batchRefusal(message);
|
|
1314
|
+
}
|
|
1315
|
+
}
|
|
1316
|
+
async function placeOrdersOneByOne(client, orders, opts) {
|
|
1317
|
+
validateBatch(orders);
|
|
1318
|
+
const packet = opts?.geoLocation !== void 0 ? opts.geoLocation : await resolveGeoLocation(client.geoLocation) ?? null;
|
|
1319
|
+
const results = [];
|
|
1320
|
+
let placed = 0;
|
|
1321
|
+
for (let i = 0; i < orders.length; i++) {
|
|
1322
|
+
const { marketId, action, orderType, ...fields } = orders[i];
|
|
1323
|
+
try {
|
|
1324
|
+
const order = await client.placeOrder(marketId, action, orderType, { ...fields, geoLocation: packet });
|
|
1325
|
+
results.push(toBatchOrderResult({ order }));
|
|
1326
|
+
placed += 1;
|
|
1327
|
+
} catch (err) {
|
|
1328
|
+
if (!(err instanceof STXException)) throw err;
|
|
1329
|
+
if (err instanceof STXRejectedException && !(err instanceof STXGeoLocationException)) {
|
|
1330
|
+
results.push(toBatchOrderResult({ errors: [err.message] }));
|
|
1331
|
+
continue;
|
|
1332
|
+
}
|
|
1333
|
+
if (err instanceof STXServerException || err instanceof STXTransportException) throw err;
|
|
1334
|
+
if (placed === 0) throw err;
|
|
1335
|
+
results.push(toBatchOrderResult({ errors: [err.message] }));
|
|
1336
|
+
if (err instanceof STXValidationException) continue;
|
|
1337
|
+
for (let j = i + 1; j < orders.length; j++) results.push(toBatchOrderResult({ errors: [err.message] }));
|
|
1338
|
+
break;
|
|
1339
|
+
}
|
|
1340
|
+
}
|
|
1341
|
+
return results;
|
|
1342
|
+
}
|
|
1343
|
+
|
|
1190
1344
|
// src/client.ts
|
|
1191
1345
|
var NEW_ORDER_FIELDS = {
|
|
1192
1346
|
marketId: "market_id",
|
|
@@ -1263,6 +1417,8 @@ var STX = class _STX {
|
|
|
1263
1417
|
onResponse;
|
|
1264
1418
|
#fetch;
|
|
1265
1419
|
#me;
|
|
1420
|
+
// Exchanges older than v3.3.172: the routes this exchange turned out not to serve.
|
|
1421
|
+
#missingRoutes = /* @__PURE__ */ new Set();
|
|
1266
1422
|
/** Test hook: how retries wait. */
|
|
1267
1423
|
_sleep = sleep;
|
|
1268
1424
|
constructor(opts = {}) {
|
|
@@ -1455,9 +1611,17 @@ var STX = class _STX {
|
|
|
1455
1611
|
return this.#me;
|
|
1456
1612
|
}
|
|
1457
1613
|
/**
|
|
1458
|
-
* The
|
|
1459
|
-
*
|
|
1460
|
-
|
|
1614
|
+
* @internal The cached `me()` when it has both ids, else a fresh `me()`.
|
|
1615
|
+
* Never falls back to `balance()`, so the channel fallbacks can use it.
|
|
1616
|
+
*/
|
|
1617
|
+
async _identity() {
|
|
1618
|
+
if (this.#me?.user_id && this.#me.account_id) return this.#me;
|
|
1619
|
+
return this.me();
|
|
1620
|
+
}
|
|
1621
|
+
/**
|
|
1622
|
+
* The user id from `me()`, fetched once and cached. If `me()` is not
|
|
1623
|
+
* permitted, the id comes from `balance()`, which carries the same
|
|
1624
|
+
* `user_id`.
|
|
1461
1625
|
*/
|
|
1462
1626
|
async userId() {
|
|
1463
1627
|
if (this.#me?.user_id) return this.#me.user_id;
|
|
@@ -1586,7 +1750,15 @@ var STX = class _STX {
|
|
|
1586
1750
|
*/
|
|
1587
1751
|
async placeOrders(orders, opts) {
|
|
1588
1752
|
const body = { orders: orders.map(normalizeOrder) };
|
|
1589
|
-
|
|
1753
|
+
if (this.#missingRoutes.has("batch")) return placeOrdersOneByOne(this, orders, opts);
|
|
1754
|
+
let raw;
|
|
1755
|
+
try {
|
|
1756
|
+
raw = await this.#list("orders_batched_post", { body: await this.#geoBody(body, opts) });
|
|
1757
|
+
} catch (err) {
|
|
1758
|
+
if (!isRouteMissing(err)) throw err;
|
|
1759
|
+
this.#missingRoutes.add("batch");
|
|
1760
|
+
return placeOrdersOneByOne(this, orders, opts);
|
|
1761
|
+
}
|
|
1590
1762
|
return raw.map(toBatchOrderResult);
|
|
1591
1763
|
}
|
|
1592
1764
|
/**
|
|
@@ -1670,15 +1842,29 @@ var STX = class _STX {
|
|
|
1670
1842
|
* `positions` channel sends on join. `position` is positive when long,
|
|
1671
1843
|
* negative when short.
|
|
1672
1844
|
*/
|
|
1673
|
-
positions(query = {}) {
|
|
1674
|
-
|
|
1845
|
+
async positions(query = {}) {
|
|
1846
|
+
if (this.#missingRoutes.has("positions")) return positionsFromChannel(this, query);
|
|
1847
|
+
try {
|
|
1848
|
+
return await this.#list("positions_get", { query: { market_ids: ids(query.marketIds) } });
|
|
1849
|
+
} catch (err) {
|
|
1850
|
+
if (!isRouteMissing(err)) throw err;
|
|
1851
|
+
this.#missingRoutes.add("positions");
|
|
1852
|
+
return positionsFromChannel(this, query);
|
|
1853
|
+
}
|
|
1675
1854
|
}
|
|
1676
1855
|
/**
|
|
1677
1856
|
* `GET /api/v1/account/balance`: balance, liabilities and fee schedule.
|
|
1678
1857
|
* The same object the `balances` channel pushes.
|
|
1679
1858
|
*/
|
|
1680
|
-
balance() {
|
|
1681
|
-
|
|
1859
|
+
async balance() {
|
|
1860
|
+
if (this.#missingRoutes.has("balance")) return balanceFromChannel(this);
|
|
1861
|
+
try {
|
|
1862
|
+
return await this.#one("account_balance_get");
|
|
1863
|
+
} catch (err) {
|
|
1864
|
+
if (!isRouteMissing(err)) throw err;
|
|
1865
|
+
this.#missingRoutes.add("balance");
|
|
1866
|
+
return balanceFromChannel(this);
|
|
1867
|
+
}
|
|
1682
1868
|
}
|
|
1683
1869
|
static #marketStatsQuery(q) {
|
|
1684
1870
|
return {
|
|
@@ -2771,4 +2957,4 @@ export {
|
|
|
2771
2957
|
orderBody,
|
|
2772
2958
|
STX
|
|
2773
2959
|
};
|
|
2774
|
-
//# sourceMappingURL=chunk-
|
|
2960
|
+
//# sourceMappingURL=chunk-PZUVKPHZ.js.map
|