@trinaryex/sdk 3.7.0 → 3.9.0

package/DESIGN.md

@@ -261,6 +261,14 @@ client.market.assembliesEnriched({ assemblyIds }): Promise<AssemblyEnriched[]> /
 client.market.solarSystemNames({ solarSystemIds }): Promise<SolarSystemName[]> // batch ≤200
 client.account.owners({ balanceManagerIds }): Promise<BalanceManagerOwner[]>   // batch ≤200: player:/ou: tagged
 
+// spatial — the star map (Universe | Solar Systems); no account or signer
+client.spatial.system(nameOrId): Promise<SolarSystem>                 // coords + constellation + region
+client.spatial.systems({ solarSystemIds | solarSystemNames }): Promise<BatchSystems>  // max 100, ids XOR names
+client.spatial.nearbySystems({ solarSystem, radiusLy, limit? }): Promise<NearbySystems>  // origin excluded
+client.spatial.systemsNearCoordinates({ x, y, z, radiusLy, limit? }): Promise<CoordinateSearch>
+client.spatial.autocompleteSystems(query, opts?): Promise<AutocompleteSystems>  // prefix index, ids only
+client.spatial.stats(): Promise<SpatialStats>                         // star-map coverage
+
 // order status (#14) — epoch-ms before/after paging
 client.orders.openOrders(params?): Promise<OpenOrdersPage>
 client.orders.fills(params?): Promise<FillsPage>

package/README.md

@@ -208,6 +208,7 @@ explainMoveAbort(rawError) // "No liquidity available (EEmptyOrderbook)" | null
 | `market` | `discover` · `hub` · `itemsAtHub` · `resolvePool` · `orderbook` · `poolMetadata` |
 | `market` (locations) | `hubLocations` · `itemLocations` · `nearbyHubs` · `nearbyHubsBySystem` · `hubsEnriched` · `assemblyOwners` · `assembliesEnriched` · `solarSystemNames` |
 | `orders` | `limit` · `market` · `cancel` · `cancelAll` · `modify` · `openOrders` · `fills` · `trades` |
+| `spatial` | `system` · `systems` · `nearbySystems` · `systemsNearCoordinates` · `autocompleteSystems` · `stats` |
 | helpers | `aggregateLevels` · `midPrice` · `spread` · `depth` · `vwap` · `estimateMarketBuyCost` · `iterateDiscovery/Fills/Trades` · `untilIndexed` · `explainMoveAbort` · `toBase` / `fromBase` |
 
 Runnable examples live in [`examples/`](./examples).

package/dist/ReadOnlyClient.d.ts

@@ -1,5 +1,5 @@
 import { IndexerClient } from './queries';
-import { AssemblyEnriched, AssemblyOwner, BalanceManagerOwner, BalancesAtHubParams, DiscoveryFilters, DiscoveryResult, FillsPage, FillsParams, HistoryPageParams, HubEnriched, HubItemOrderbook, HubItemsPage, HubLocationFilters, HubLocationPage, ItemSearchPage, InventoryBalances, LocationPageParams, NearbyHub, NearbyHubsParams, NearbyHubsBySystemParams, OpenOrdersPage, PackageIds, PoolMetadata, ReadOnlyClientConfig, SolarSystemName, Sweepable, TradeHubDetail, TradesPage, TradesParams } from './types';
+import { AssemblyEnriched, AssemblyOwner, AutocompleteSystems, BalanceManagerOwner, BatchSystems, BatchSystemsParams, CoordinateSearch, CoordinateSearchParams, BalancesAtHubParams, DiscoveryFilters, DiscoveryResult, FillsPage, FillsParams, HistoryPageParams, HubEnriched, HubItemOrderbook, HubItemsPage, HubLocationFilters, HubLocationPage, ItemSearchPage, InventoryBalances, LocationPageParams, NearbyHub, NearbyHubsParams, NearbyHubsBySystemParams, NearbySystems, NearbySystemsParams, OpenOrdersPage, PackageIds, PoolMetadata, ReadOnlyClientConfig, SolarSystem, SolarSystemName, SpatialStats, Sweepable, TradeHubDetail, TradesPage, TradesParams } from './types';
 export declare class ReadOnlyClient {
     readonly ids: PackageIds;
     readonly indexer: IndexerClient;
@@ -38,6 +38,14 @@ export declare class ReadOnlyClient {
     accountOwners(params: {
         balanceManagerIds: string[];
     }): Promise<BalanceManagerOwner[]>;
+    spatialSystem(solarSystem: string): Promise<SolarSystem>;
+    spatialSystems(params: BatchSystemsParams): Promise<BatchSystems>;
+    spatialNearbySystems(params: NearbySystemsParams): Promise<NearbySystems>;
+    spatialSystemsNearCoordinates(params: CoordinateSearchParams): Promise<CoordinateSearch>;
+    spatialAutocompleteSystems(query: string, opts?: {
+        limit?: number;
+    }): Promise<AutocompleteSystems>;
+    spatialStats(): Promise<SpatialStats>;
     balancesAtHub(params: BalancesAtHubParams & {
         balanceManagerId?: string;
     }): Promise<InventoryBalances>;

package/dist/TriexClient.d.ts

@@ -1,7 +1,7 @@
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { ClientWithCoreApi } from '@mysten/sui/client';
 import { IndexerClient } from './queries';
-import { AssemblyEnriched, AssemblyOwner, BalanceManagerOwner, BalancesAtHubParams, CancelAllOrdersParams, CancelOrderParams, ClaimSettledParams, CurrencyBalances, DepositCurrencyParams, DepositItemsParams, DiscoveryFilters, DiscoveryResult, EnsureAccountResult, FillsPage, FillsParams, HistoryPageParams, HubEnriched, HubItemOrderbook, HubItemsPage, HubLocationFilters, HubLocationPage, ItemSearchPage, InventoryBalances, LimitOrderParams, LocationPageParams, MarketOrderParams, ModifyOrderParams, NearbyHub, NearbyHubsParams, NearbyHubsBySystemParams, OpenOrdersPage, PackageIds, PoolMetadata, SolarSystemName, Sweepable, TradeHubDetail, TradesPage, TradesParams, TradingAccount, TransactionExecutor, TriexClientConfig, TxResult, WithdrawCurrencyParams, WithdrawItemsParams } from './types';
+import { AssemblyEnriched, AssemblyOwner, AutocompleteSystems, BalanceManagerOwner, BatchSystems, BatchSystemsParams, CoordinateSearch, CoordinateSearchParams, BalancesAtHubParams, CancelAllOrdersParams, CancelOrderParams, ClaimSettledParams, CurrencyBalances, DepositCurrencyParams, DepositItemsParams, DiscoveryFilters, DiscoveryResult, EnsureAccountResult, FillsPage, FillsParams, HistoryPageParams, HubEnriched, HubItemOrderbook, HubItemsPage, HubLocationFilters, HubLocationPage, ItemSearchPage, InventoryBalances, LimitOrderParams, LocationPageParams, MarketOrderParams, ModifyOrderParams, NearbyHub, NearbyHubsParams, NearbyHubsBySystemParams, NearbySystems, NearbySystemsParams, OpenOrdersPage, PackageIds, PoolMetadata, SolarSystem, SolarSystemName, SpatialStats, Sweepable, TradeHubDetail, TradesPage, TradesParams, TradingAccount, TransactionExecutor, TriexClientConfig, TxResult, WithdrawCurrencyParams, WithdrawItemsParams } from './types';
 export declare class TriexClient {
     readonly suiClient: ClientWithCoreApi;
     readonly ids: PackageIds;
@@ -13,6 +13,7 @@ export declare class TriexClient {
     readonly balances: BalancesApi;
     readonly market: MarketApi;
     readonly orders: OrdersApi;
+    readonly spatial: SpatialApi;
     constructor(config: TriexClientConfig);
     requireExecutor(): TransactionExecutor;
     requireAddress(override?: string): string;
@@ -84,6 +85,18 @@ declare class MarketApi {
         solarSystemIds: number[];
     }): Promise<SolarSystemName[]>;
 }
+declare class SpatialApi {
+    private readonly c;
+    constructor(c: TriexClient);
+    system(solarSystem: string): Promise<SolarSystem>;
+    systems(params: BatchSystemsParams): Promise<BatchSystems>;
+    nearbySystems(params: NearbySystemsParams): Promise<NearbySystems>;
+    systemsNearCoordinates(params: CoordinateSearchParams): Promise<CoordinateSearch>;
+    autocompleteSystems(query: string, opts?: {
+        limit?: number;
+    }): Promise<AutocompleteSystems>;
+    stats(): Promise<SpatialStats>;
+}
 declare class OrdersApi {
     private readonly c;
     constructor(c: TriexClient);
@@ -100,4 +113,4 @@ declare class OrdersApi {
     private depositQuoteDeficit;
     private beginCancelTx;
 }
-export type { AccountApi, BalancesApi, MarketApi, OrdersApi };
+export type { AccountApi, BalancesApi, MarketApi, OrdersApi, SpatialApi };

package/dist/errors.d.ts

@@ -12,6 +12,7 @@ export declare enum TriexError {
     BalanceManagerNotFound = "TRIEX_BALANCE_MANAGER_NOT_FOUND",
     PoolNotFound = "TRIEX_POOL_NOT_FOUND",
     HubNotFound = "TRIEX_HUB_NOT_FOUND",
+    SolarSystemNotFound = "TRIEX_SOLAR_SYSTEM_NOT_FOUND",
     CharacterNotFound = "TRIEX_CHARACTER_NOT_FOUND",
     TransactionFailed = "TRIEX_TRANSACTION_FAILED",
     Timeout = "TRIEX_TIMEOUT",

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { TriexClient } from './TriexClient';
-export type { AccountApi, BalancesApi, MarketApi, OrdersApi, } from './TriexClient';
+export type { AccountApi, BalancesApi, MarketApi, OrdersApi, SpatialApi, } from './TriexClient';
 export { ReadOnlyClient } from './ReadOnlyClient';
 export { TriexError, TriexClientError, explainMoveAbort } from './errors';
 export { DEFAULT_INDEXER_URL, CLOCK_ID, STILLNESS_PACKAGE_IDS, NETWORK_PRESETS, resolvePackageIds, } from './config';
@@ -15,5 +15,5 @@ export type { BookLevel } from './book';
 export { iterateDiscovery, iterateFills, iterateTrades } from './paging';
 export type { IterateOptions } from './paging';
 export { untilIndexed } from './wait';
-export type { TriexNetwork, PackageIds, TriexClientConfig, ReadOnlyClientConfig, TransactionExecutor, ObjectChange, TxResult, OrderSide, TradingAccount, CurrencyBalances, AssetBalance, InventoryBalances, TradeHubDetail, HubVaultInfo, HubLocation, HubLocationPage, HubLocationFilters, LocationPageParams, NearbyHub, NearbyHubsParams, NearbyHubsBySystemParams, HubEnriched, AssemblyOwner, AssemblyEnriched, BalanceManagerOwner, SolarSystemName, HubItem, HubItemsPage, ItemRecipe, ItemRecipeComponent, ItemSearchPage, ItemSearchResult, CollectionHub, Orderbook, HubItemOrderbook, HubItemMarket, OrderbookOrder, PoolMetadata, DiscoveryOrder, DiscoveryResult, DiscoveryFilters, OpenOrder, OpenOrdersPage, Fill, FillsPage, Trade, TradesPage, BalancesAtHubParams, HistoryPageParams, FillsParams, TradesParams, Sweepable, SweepablePool, SweepableItem, EnsureAccountResult, DepositCurrencyParams, DepositItemsParams, WithdrawCurrencyParams, WithdrawItemsParams, LimitOrderParams, MarketOrderParams, CancelOrderParams, CancelAllOrdersParams, ModifyOrderParams, ClaimSettledParams, } from './types';
+export type { TriexNetwork, PackageIds, TriexClientConfig, ReadOnlyClientConfig, TransactionExecutor, ObjectChange, TxResult, OrderSide, TradingAccount, CurrencyBalances, AssetBalance, InventoryBalances, TradeHubDetail, HubVaultInfo, HubLocation, HubLocationPage, HubLocationFilters, LocationPageParams, NearbyHub, NearbyHubsParams, NearbyHubsBySystemParams, HubEnriched, AssemblyOwner, AssemblyEnriched, BalanceManagerOwner, SolarSystemName, Coordinates, SolarSystem, SolarSystemSuggestion, NearbySystem, NearbySystems, NearbySystemsParams, BatchSystems, BatchSystemsParams, CoordinateSearch, CoordinateSearchParams, AutocompleteSystems, SpatialStats, HubItem, HubItemsPage, ItemRecipe, ItemRecipeComponent, ItemSearchPage, ItemSearchResult, CollectionHub, Orderbook, HubItemOrderbook, HubItemMarket, OrderbookOrder, PoolMetadata, DiscoveryOrder, DiscoveryResult, DiscoveryFilters, OpenOrder, OpenOrdersPage, Fill, FillsPage, Trade, TradesPage, BalancesAtHubParams, HistoryPageParams, FillsParams, TradesParams, Sweepable, SweepablePool, SweepableItem, EnsureAccountResult, DepositCurrencyParams, DepositItemsParams, WithdrawCurrencyParams, WithdrawItemsParams, LimitOrderParams, MarketOrderParams, CancelOrderParams, CancelAllOrdersParams, ModifyOrderParams, ClaimSettledParams, } from './types';
 export type { OwnedItemReceipt, CharacterInfo, SsuOwnerInfo, ObjectRef, } from './onchain';