@trinaryex/sdk 2.0.0 → 3.0.0

package/DESIGN.md

@@ -10,8 +10,9 @@ swagger. Remaining: npm publish (CI release workflow ready; needs NPM_TOKEN + pu
 first module, with room to grow into a higher-level, full-featured client.
 **Audience:** players and bots trading on Trinary Exchange via an API key.
 **Target (MVP):** **testnet only**, the **`stillness`** tenant; **only the most-recent (v1)
-`triexbook` contracts** are supported. Item↔currency (CRED) markets via `multicoin_pool`
-("pools"); coin-pools are out of scope for now.
+[CLOB contracts](https://github.com/loash-industries/trinary-exchange)** are supported.
+Item↔currency (CRED) markets via `multicoin_pool` ("pools"); coin-pools are out of scope
+for now.
 **Models after:** [`@trinaryex/keyspace`](https://www.npmjs.com/package/@trinaryex/keyspace)
 (client + `executor` pattern, `queries`/`transactions` split, zod validation, vite build,
 semantic-release).
@@ -20,11 +21,11 @@ semantic-release).
 
 ## 1. What this SDK is (and isn't)
 
-Trinary Exchange is a Sui-based, DeepBook-style market for an EVE-Frontier game economy.
+Trinary Exchange is a Sui-based order-book market for an EVE-Frontier game economy.
 Players trade **items** (multicoin balances, priced in the **CRED** trade currency) and
 **currency** at **trade hubs** (Smart Storage Units / SSUs) through on-chain order books
-(the `triexbook` DeepBook fork), settling through a per-player **balance manager** (the
-on-chain trading account).
+(the [Trinary Exchange CLOB Move contracts](https://github.com/loash-industries/trinary-exchange)),
+settling through a per-player **balance manager** (the on-chain trading account).
 
 The SDK gives a player/bot one object to:
 
@@ -110,7 +111,7 @@ on the free/standard tier).
                     │     (fetch + x-api-key + zod validate)       │      (Postgres read models)
                     │                                              │
                     │   transactions.ts ──build PTB──► executor()  │───► player's wallet / keypair
-                    │     (pure @mysten/sui Transaction builders)  │      └─► Sui network (triexbook)
+                    │     (pure @mysten/sui Transaction builders)  │      └─► Sui network (CLOB contracts)
                     └────────────────────────────────────────────┘
 ```
 
@@ -139,7 +140,7 @@ executor: (tx) => signAndExecuteTransaction({ transaction: tx })
 
 Executor results are **normalized** (`execute.ts`): both the v2 core-client
 `TransactionResult` and the legacy `{ digest, objectChanges }` shape work, and on-chain
-aborts are rethrown as typed `TransactionFailed` errors with the triexbook abort code
+aborts are rethrown as typed `TransactionFailed` errors with the CLOB abort code
 translated (§11 of TRIEX_SYSTEM_DESIGN). Include `effects` + `objectTypes` (v2) or
 `objectChanges` (legacy) so created objects — e.g. a freshly-created `BalanceManager` —
 are captured for read-your-writes.
@@ -216,7 +217,7 @@ const client = new TriexClient({
   network: 'testnet',                            // selects package-id bundle
   executor: (tx) => signAndExecuteTransaction({ transaction: tx, options: { showObjectChanges: true } }),
   // packageIds optional — resolved from `network` defaults, overridable:
-  // packageIds: { triexbook, multicoin, warehouseReceipts, credCoinType, clock: '0x6', ... }
+  // packageIds: { triex, multicoin, warehouseReceipts, credCoinType, clock: '0x6', ... }
 })
 ```
 
@@ -279,18 +280,18 @@ pure functions `(args) => Transaction`; the facade fills object IDs from indexer
 
 | Builder | Move target | Notes |
 |---|---|---|
-| `newBalanceManager` | `${triexbook}::balance_manager::new()` | returns BM; `transferObjects([bm], self)` when freshly created |
-| `depositCoin` | `${triexbook}::balance_manager::deposit<T>(bm, coin)` | coin prepared via list/merge/split of wallet coins |
-| `depositMulticoinObject` | `${triexbook}::balance_manager::deposit_multicoin(bm, object)` | deposit an owned multicoin `Balance` object (wallet receipts) into BM |
-| `withdrawAllCoin` | `${triexbook}::balance_manager::withdraw_all<T>(bm)` → `transferObjects` | #13 |
-| `withdrawAllMulticoin` | `${triexbook}::balance_manager::withdraw_all_multicoin(bm, collectionId, assetId)` | #12 step 1 |
+| `newBalanceManager` | `${triex}::balance_manager::new()` | returns BM; `transferObjects([bm], self)` when freshly created |
+| `depositCoin` | `${triex}::balance_manager::deposit<T>(bm, coin)` | coin prepared via list/merge/split of wallet coins |
+| `depositMulticoinObject` | `${triex}::balance_manager::deposit_multicoin(bm, object)` | deposit an owned multicoin `Balance` object (wallet receipts) into BM |
+| `withdrawAllCoin` | `${triex}::balance_manager::withdraw_all<T>(bm)` → `transferObjects` | #13 |
+| `withdrawAllMulticoin` | `${triex}::balance_manager::withdraw_all_multicoin(bm, collectionId, assetId)` | #12 step 1 |
 | `redeemReceipt` | `${warehouseReceipts}::receipt::redeem_receipt(balance, ssu, character, vaultConfig, collection, isOwner)` | #12 step 2 (BM item → hangar) |
-| `ownerProof` | `${triexbook}::balance_manager::generate_proof_as_owner(bm)` | required before placing/withdrawing |
-| `placeLimitOrderItem` | `${triexbook}::multicoin_pool::place_limit_order<Quote>(pool, bm, proof, orderType, selfMatch, price, qty, isBid, expireTs, clock)` | items (multicoin) |
-| `placeMarketOrderItem` | `${triexbook}::multicoin_pool::place_market_order<Quote>(pool, bm, proof, selfMatch, qty, isBid, clock)` | items (multicoin) |
-| `cancelOrderItem` | `${triexbook}::multicoin_pool::cancel_order<Quote>(pool, bm, proof, orderId u64, clock)` | implemented (+ `cancel_all_orders`, `modify_order`) |
-| `withdrawCoin` | `${triexbook}::balance_manager::withdraw<T>(bm, amount)` | partial currency withdraw |
-| `withdrawSettledAmounts` | `${triexbook}::multicoin_pool::withdraw_settled_amounts<Quote>(pool, bm, proof)` | claim post-fill proceeds into the BM |
+| `ownerProof` | `${triex}::balance_manager::generate_proof_as_owner(bm)` | required before placing/withdrawing |
+| `placeLimitOrderItem` | `${triex}::multicoin_pool::place_limit_order<Quote>(pool, bm, proof, orderType, selfMatch, price, qty, isBid, expireTs, clock)` | items (multicoin) |
+| `placeMarketOrderItem` | `${triex}::multicoin_pool::place_market_order<Quote>(pool, bm, proof, selfMatch, qty, isBid, clock)` | items (multicoin) |
+| `cancelOrderItem` | `${triex}::multicoin_pool::cancel_order<Quote>(pool, bm, proof, orderId u64, clock)` | implemented (+ `cancel_all_orders`, `modify_order`) |
+| `withdrawCoin` | `${triex}::balance_manager::withdraw<T>(bm, amount)` | partial currency withdraw |
+| `withdrawSettledAmounts` | `${triex}::multicoin_pool::withdraw_settled_amounts<Quote>(pool, bm, proof)` | claim post-fill proceeds into the BM |
 
 > `<Quote>` is the CRED coin type (`credCoinType`). Item markets are `multicoin_pool`; the
 > item is identified by `collectionId` + `assetId` (u64), not a Move type parameter.
@@ -351,8 +352,8 @@ back into the SSU/hangar (needs `ssu`, `character`, `vaultConfig`, `collection`,
 
 ## 7. Money math (`money.ts`)
 
-- **Coin (currency-pair) pools:** `quote = base * price / TRIEXBOOK_PRICE_SCALING`
-  where `TRIEXBOOK_PRICE_SCALING = 1_000_000_000` (1e9).
+- **Coin (currency-pair) pools:** `quote = base * price / TRIEX_PRICE_SCALING`
+  where `TRIEX_PRICE_SCALING = 1_000_000_000` (1e9).
 - **Multicoin (item) pools:** scaling factor `1` → `quote = price * quantity` (confirmed
   against the production app, which passes the unscaled price straight to
   `place_limit_order`; TRIEX_SYSTEM_DESIGN §7's blanket "all prices ×1e9" describes coin

package/README.md

@@ -5,9 +5,10 @@
 
 The official TypeScript trading SDK for
 [**Trinary Exchange**](https://trinary.exchange/), the player-built
-**EVE Frontier marketplace** — a Sui-based, DeepBook-style order-book market
-for trading items and currency across EVE Frontier trade hubs. Players and
-bots read live **EVE Frontier market data** through the
+**EVE Frontier marketplace** — a Sui-based order-book market for trading
+items and currency across EVE Frontier trade hubs, built on the
+[Trinary Exchange CLOB Move contracts](https://github.com/loash-industries/trinary-exchange).
+Players and bots read live **EVE Frontier market data** through the
 [Trinary Exchange API](https://docs.trinary.exchange/) and trade by signing
 on-chain transactions with their own wallet or keypair.
 
@@ -251,6 +252,8 @@ node --env-file=.env scripts/integration.mjs  # write paths on testnet (uses gas
 - [API documentation](https://docs.trinary.exchange/) — REST reference,
   guides, and [API keys](https://docs.trinary.exchange/docs/api-keys) for the
   Trinary Exchange trading API
+- [Trinary Exchange CLOB contracts](https://github.com/loash-industries/trinary-exchange)
+  — the Sui Move order-book contracts this SDK talks to
 - [`@trinaryex/sdk` on npm](https://www.npmjs.com/package/@trinaryex/sdk)
 - [Design notes](./DESIGN.md) — architecture, scope, and verification history
 

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { AccountApi, BalancesApi, MarketApi, OrdersApi, } from './TriexClie
 export { ReadOnlyClient } from './ReadOnlyClient';
 export { TriexError, TriexClientError, explainMoveAbort } from './errors';
 export { DEFAULT_INDEXER_URL, CLOCK_ID, STILLNESS_PACKAGE_IDS, NETWORK_PRESETS, resolvePackageIds, } from './config';
-export { toBase, fromBase, computeItemQuote, computeBidQuoteDeposit, estimateMarketBuyCost, marketBuyRoundingBuffer, TRIEXBOOK_PRICE_SCALING, MULTICOIN_PRICE_SCALING, FEE_RATE_SCALING, GTC_EXPIRE, } from './money';
+export { toBase, fromBase, computeItemQuote, computeBidQuoteDeposit, estimateMarketBuyCost, marketBuyRoundingBuffer, TRIEX_PRICE_SCALING, MULTICOIN_PRICE_SCALING, FEE_RATE_SCALING, GTC_EXPIRE, } from './money';
 export { IndexerClient } from './queries';
 export * as transactions from './transactions';
 export { getWalletCurrencyBalance, getBalanceManagerCurrencyBalance, getBalanceManagerItemBalance, getRegistryMulticoinCollectionId, findOwnedItemReceipts, fetchCharacterInfo, fetchSsuOwnerInfo, fetchInventorySlotQuantity, toSsuObjectId, getObjectRef, } from './onchain';

package/dist/index.js

@@ -10,7 +10,7 @@ var r = Object.defineProperty, i = (e, t) => {
 	});
 	return t || r(n, Symbol.toStringTag, { value: "Module" }), n;
 }, a = "https://api.trinary.exchange", o = "0x6", s = {
-	triexbook: "0x291b9da738dffedd18d7c5049e5e6792270202e03f3c9d9db4c7097670bf6eb2",
+	triex: "0x291b9da738dffedd18d7c5049e5e6792270202e03f3c9d9db4c7097670bf6eb2",
 	triexRegistry: "0x14a58f254b8243bf3f74c057d81cc310498b3d0fe3781650ad58405d7e5f17e4",
 	multicoin: "0x99a4c039477ac7e7affcb5a5609dd23c29ab69e9436e740d94a4e168c2506cfb",
 	warehouseReceipts: "0x0c9d4414aa12eaa1ebf9d32437c1e6403fbf941ffcdca5b9ca16d1769313417e",
@@ -186,7 +186,7 @@ async function T(e, t, n) {
 		include: { json: !0 }
 	}).catch(() => null))?.object?.json, i = S(te(r?.balances)?.id);
 	if (!i) return 0n;
-	let a = `${t.triexbook}::balance_manager::BalanceKey<${t.credCoinType}>`, o = await C(e).getDynamicField({
+	let a = `${t.triex}::balance_manager::BalanceKey<${t.credCoinType}>`, o = await C(e).getDynamicField({
 		parentId: i,
 		name: {
 			type: a,
@@ -196,7 +196,7 @@ async function T(e, t, n) {
 	return o ? BigInt(ee.parse(o.dynamicField.value.bcs)) : 0n;
 }
 async function ie(e, t, n, r, i) {
-	let a = `${t.triexbook}::balance_manager::MultiCoinBalanceKey`, o = await C(e).getDynamicObjectField({
+	let a = `${t.triex}::balance_manager::MultiCoinBalanceKey`, o = await C(e).getDynamicObjectField({
 		parentId: n,
 		name: {
 			type: a,
@@ -215,7 +215,7 @@ async function ie(e, t, n, r, i) {
 	};
 }
 async function E(e, n) {
-	let r = `${n.triexbook}::registry::MultiCoinCollectionKey`, i = await C(e).getDynamicField({
+	let r = `${n.triex}::registry::MultiCoinCollectionKey`, i = await C(e).getDynamicField({
 		parentId: n.triexRegistry,
 		name: {
 			type: r,
@@ -335,46 +335,46 @@ var ae = /* @__PURE__ */ i({
 });
 function j(e, t) {
 	return e.moveCall({
-		target: `${t.triexbook}::balance_manager::new`,
+		target: `${t.triex}::balance_manager::new`,
 		arguments: []
 	});
 }
 function M(e, t, n) {
 	return e.moveCall({
-		target: `${t.triexbook}::balance_manager::generate_proof_as_owner`,
+		target: `${t.triex}::balance_manager::generate_proof_as_owner`,
 		arguments: [n]
 	});
 }
 function N(e, t, n, r, i = t.credCoinType) {
 	e.moveCall({
-		target: `${t.triexbook}::balance_manager::deposit`,
+		target: `${t.triex}::balance_manager::deposit`,
 		typeArguments: [i],
 		arguments: [n, r]
 	});
 }
 function oe(e, t, n, r) {
 	e.moveCall({
-		target: `${t.triexbook}::balance_manager::deposit_multicoin`,
+		target: `${t.triex}::balance_manager::deposit_multicoin`,
 		arguments: [n, e.object(r)]
 	});
 }
 function se(e, t, n, r, i = t.credCoinType) {
 	return e.moveCall({
-		target: `${t.triexbook}::balance_manager::withdraw`,
+		target: `${t.triex}::balance_manager::withdraw`,
 		typeArguments: [i],
 		arguments: [n, e.pure.u64(r)]
 	});
 }
 function ce(e, t, n, r = t.credCoinType) {
 	return e.moveCall({
-		target: `${t.triexbook}::balance_manager::withdraw_all`,
+		target: `${t.triex}::balance_manager::withdraw_all`,
 		typeArguments: [r],
 		arguments: [n]
 	});
 }
 function le(e, t, n, r, i) {
 	return e.moveCall({
-		target: `${t.triexbook}::balance_manager::withdraw_all_multicoin`,
+		target: `${t.triex}::balance_manager::withdraw_all_multicoin`,
 		arguments: [
 			n,
 			e.pure.id(r),
@@ -422,13 +422,13 @@ function P(e, t, n, r) {
 			s
 		]
 	}), e.moveCall({
-		target: `${t.triexbook}::balance_manager::deposit_multicoin`,
+		target: `${t.triex}::balance_manager::deposit_multicoin`,
 		arguments: [n, c]
 	});
 }
 function F(e, t, n) {
 	e.moveCall({
-		target: `${t.triexbook}::multicoin_pool::place_limit_order`,
+		target: `${t.triex}::multicoin_pool::place_limit_order`,
 		typeArguments: [t.credCoinType],
 		arguments: [
 			e.object(n.poolId),
@@ -446,7 +446,7 @@ function F(e, t, n) {
 }
 function I(e, t, n) {
 	e.moveCall({
-		target: `${t.triexbook}::multicoin_pool::place_market_order`,
+		target: `${t.triex}::multicoin_pool::place_market_order`,
 		typeArguments: [t.credCoinType],
 		arguments: [
 			e.object(n.poolId),
@@ -461,7 +461,7 @@ function I(e, t, n) {
 }
 function L(e, t, n) {
 	e.moveCall({
-		target: `${t.triexbook}::multicoin_pool::cancel_order`,
+		target: `${t.triex}::multicoin_pool::cancel_order`,
 		typeArguments: [t.credCoinType],
 		arguments: [
 			e.object(n.poolId),
@@ -474,7 +474,7 @@ function L(e, t, n) {
 }
 function R(e, t, n) {
 	e.moveCall({
-		target: `${t.triexbook}::multicoin_pool::cancel_all_orders`,
+		target: `${t.triex}::multicoin_pool::cancel_all_orders`,
 		typeArguments: [t.credCoinType],
 		arguments: [
 			e.object(n.poolId),
@@ -486,7 +486,7 @@ function R(e, t, n) {
 }
 function z(e, t, n) {
 	e.moveCall({
-		target: `${t.triexbook}::multicoin_pool::modify_order`,
+		target: `${t.triex}::multicoin_pool::modify_order`,
 		typeArguments: [t.credCoinType],
 		arguments: [
 			e.object(n.poolId),
@@ -500,7 +500,7 @@ function z(e, t, n) {
 }
 function B(e, t, n) {
 	e.moveCall({
-		target: `${t.triexbook}::multicoin_pool::withdraw_settled_amounts`,
+		target: `${t.triex}::multicoin_pool::withdraw_settled_amounts`,
 		typeArguments: [n.quoteCoinType ?? t.credCoinType],
 		arguments: [
 			e.object(n.poolId),
@@ -1099,7 +1099,7 @@ var X = class {
 	}
 	async resolveBalanceManagerId(e) {
 		if (this.cachedBalanceManagerId) return this.cachedBalanceManagerId;
-		let t = `${this.ids.triexbook}::balance_manager::BalanceManager`, n = (await this.suiClient.core.listOwnedObjects({
+		let t = `${this.ids.triex}::balance_manager::BalanceManager`, n = (await this.suiClient.core.listOwnedObjects({
 			owner: e,
 			type: t,
 			limit: 1
@@ -1587,4 +1587,4 @@ async function et(e, t) {
 	}
 }
 //#endregion
-export { o as CLOCK_ID, a as DEFAULT_INDEXER_URL, W as FEE_RATE_SCALING, fe as GTC_EXPIRE, X as IndexerClient, U as MULTICOIN_PRICE_SCALING, c as NETWORK_PRESETS, Ge as ReadOnlyClient, s as STILLNESS_PACKAGE_IDS, de as TRIEXBOOK_PRICE_SCALING, ze as TriexClient, d as TriexClientError, u as TriexError, Ke as aggregateLevels, $ as bestAsk, Q as bestBid, K as computeBidQuoteDeposit, G as computeItemQuote, Ye as depth, ge as estimateMarketBuyCost, m as executeAndNormalize, p as explainMoveAbort, O as fetchCharacterInfo, A as fetchInventorySlotQuantity, k as fetchSsuOwnerInfo, g as findCreatedObject, D as findOwnedItemReceipts, me as fromBase, T as getBalanceManagerCurrencyBalance, ie as getBalanceManagerItemBalance, ne as getObjectRef, E as getRegistryMulticoinCollectionId, re as getWalletCurrencyBalance, Ze as iterateDiscovery, Qe as iterateFills, $e as iterateTrades, he as marketBuyRoundingBuffer, qe as midPrice, h as normalizeExecuteResult, V as prepareWalletCoinInput, l as resolvePackageIds, H as sourceItemsIntoBalanceManager, Je as spread, pe as toBase, w as toSsuObjectId, ae as transactions, et as untilIndexed, Xe as vwap };
+export { o as CLOCK_ID, a as DEFAULT_INDEXER_URL, W as FEE_RATE_SCALING, fe as GTC_EXPIRE, X as IndexerClient, U as MULTICOIN_PRICE_SCALING, c as NETWORK_PRESETS, Ge as ReadOnlyClient, s as STILLNESS_PACKAGE_IDS, de as TRIEX_PRICE_SCALING, ze as TriexClient, d as TriexClientError, u as TriexError, Ke as aggregateLevels, $ as bestAsk, Q as bestBid, K as computeBidQuoteDeposit, G as computeItemQuote, Ye as depth, ge as estimateMarketBuyCost, m as executeAndNormalize, p as explainMoveAbort, O as fetchCharacterInfo, A as fetchInventorySlotQuantity, k as fetchSsuOwnerInfo, g as findCreatedObject, D as findOwnedItemReceipts, me as fromBase, T as getBalanceManagerCurrencyBalance, ie as getBalanceManagerItemBalance, ne as getObjectRef, E as getRegistryMulticoinCollectionId, re as getWalletCurrencyBalance, Ze as iterateDiscovery, Qe as iterateFills, $e as iterateTrades, he as marketBuyRoundingBuffer, qe as midPrice, h as normalizeExecuteResult, V as prepareWalletCoinInput, l as resolvePackageIds, H as sourceItemsIntoBalanceManager, Je as spread, pe as toBase, w as toSsuObjectId, ae as transactions, et as untilIndexed, Xe as vwap };

package/dist/money.d.ts

@@ -1,4 +1,4 @@
-export declare const TRIEXBOOK_PRICE_SCALING = 1000000000n;
+export declare const TRIEX_PRICE_SCALING = 1000000000n;
 export declare const MULTICOIN_PRICE_SCALING = 1n;
 export declare const FEE_RATE_SCALING = 1000000000n;
 export declare const GTC_EXPIRE = 18446744073709551615n;

package/dist/types.d.ts

@@ -19,7 +19,7 @@ export interface TxResult {
 }
 export type TriexNetwork = 'testnet';
 export interface PackageIds {
-    triexbook: string;
+    triex: string;
     triexRegistry: string;
     multicoin: string;
     warehouseReceipts: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trinaryex/sdk",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Trading SDK for Trinary Exchange — market data, order books, and on-chain trading (Sui) for bots, analytics tools, and CLIs.",
   "type": "module",
   "main": "dist/index.js",
@@ -104,7 +104,7 @@
     "marketplace",
     "market-data",
     "trading-bot",
-    "deepbook"
+    "clob"
   ],
   "sideEffects": false,
   "repository": {