@trinaryex/sdk 4.0.0 → 5.0.0

package/DESIGN.md

@@ -115,7 +115,7 @@ throws on live data.
 | Platform aggregates | `GET /v1/stats` | `market.stats` | 50 |
 | Characters | `GET /v1/characters/{id}`, `/address/{a}`, `/name/{n}`, `/batch` | `characters.get` / `byAddress` / `byName` / `batch` | 20 / 20 / 20 / 50 |
 | Tribes | `GET /v1/world/tribes/{tribe_id}` | `characters.tribe` | 20 |
-| World items & recipes (CDN, static) | `GET /v1/world/items`, `/{asset_id}`, `/v1/world/recipes`, `/{recipe_id}` | `world.items` / `item` / `recipes` / `recipesFor` | 20 each |
+| World items & recipes (CDN, static) | `GET /v1/world/items`, `/{asset_id}`, `/v1/world/recipes`, `/{item_id}` | `world.items` / `item` / `recipes` / `recipesFor` | 20 each |
 | Routing (location-api) | `GET /v1/routing/route`, `/compare`, `/stats` | `routing.route` / `compare` / `stats` | 100 / 300 / 20 |
 
 Notes that change how results are read:
@@ -345,8 +345,8 @@ client.characters.tribe(tribeId): Promise<Tribe>
 // world reference data (static — cache it)
 client.world.items(): Promise<WorldItem[]>
 client.world.item(assetId): Promise<ItemInfo>
-client.world.recipes(): Promise<Recipe[]>
-client.world.recipesFor(productAssetId): Promise<Recipe[]>          // [] when not craftable
+client.world.recipes(): Promise<Blueprint[]>                        // includes `reverse` — skip when costing
+client.world.recipesFor(assetId): Promise<ItemBlueprints>           // { producedBy, usedIn }; both [] when untouched
 
 // orders (#10, #11) — each auto-ensures BM + deposits any deficit in one PTB
 client.orders.limit({ storageUnitId, assetId, side, price, quantity, expireAt? }): Promise<TxResult>   // #10
@@ -747,7 +747,7 @@ GET /v1/world/items                                   20 CU  world.items
 GET /v1/world/items/{asset_id}                        20 CU  world.item
 GET /v1/world/items/search                            50 CU  market.searchItems
 GET /v1/world/recipes                                 20 CU  world.recipes         (CDN)
-GET /v1/world/recipes/{recipe_id}                     20 CU  world.recipesFor      (CDN)
+GET /v1/world/recipes/{item_id}                       20 CU  world.recipesFor      (CDN)
 # Star map & routing (location-api)
 GET /v1/spatial/systems/{solar_system}                20 CU  spatial.system
 GET /v1/spatial/systems                               50 CU  spatial.systems

package/README.md

@@ -258,7 +258,9 @@ const [who] = await client.characters.batch({ addresses: [wallet] })
 
 // Static reference data — fetch once, cache.
 const items = await client.world.items()            // assetId strings
-const bom = await client.world.recipesFor('77753')  // [] if not craftable
+const { producedBy, usedIn } = await client.world.recipesFor('77753')
+// producedBy: the blueprints that make it (inputs, outputs, kind, facilities)
+// usedIn: the blueprints that consume it — both [] if no blueprint touches it
 
 // Routes take system NAMES — see the note below.
 const route = await client.routing.route({

package/dist/ReadOnlyClient.d.ts

@@ -1,7 +1,7 @@
 import { OrgsApi } from './armature/OrgsApi';
 import { CoinsReadApi } from './coins/CoinsApi';
 import { IndexerClient } from './queries';
-import { AssemblyEnriched, AssemblyOwner, AutocompleteSystems, TradingAccountOwner, 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, Character, CharacterLookup, DisplayPrice, DisplayPriceParams, DisplayPricesParams, FillDetail, HubEconomics, ItemInfo, OrderDetail, OrderLookupParams, PlatformStats, PoolFees, RecentTradesPage, RecentTradesParams, Recipe, Route, RouteComparison, RouteParams, RouteShipParams, RoutingStats, Tribe, WorldItem } from './types';
+import { AssemblyEnriched, AssemblyOwner, AutocompleteSystems, TradingAccountOwner, 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, Character, CharacterLookup, DisplayPrice, DisplayPriceParams, DisplayPricesParams, FillDetail, HubEconomics, ItemInfo, ItemBlueprints, Blueprint, OrderDetail, OrderLookupParams, PlatformStats, PoolFees, RecentTradesPage, RecentTradesParams, Route, RouteComparison, RouteParams, RouteShipParams, RoutingStats, Tribe, WorldItem } from './types';
 export declare class ReadOnlyClient {
     readonly ids: PackageIds;
     readonly indexer: IndexerClient;
@@ -82,8 +82,8 @@ export declare class ReadOnlyClient {
     tribe(tribeId: number): Promise<Tribe>;
     worldItems(): Promise<WorldItem[]>;
     worldItem(assetId: string): Promise<ItemInfo>;
-    recipes(): Promise<Recipe[]>;
-    recipesFor(productAssetId: string): Promise<Recipe[]>;
+    recipes(): Promise<Blueprint[]>;
+    recipesFor(assetId: string): Promise<ItemBlueprints>;
     route(params: RouteParams): Promise<Route>;
     compareRoutes(params: RouteShipParams): Promise<RouteComparison>;
     routingStats(): Promise<RoutingStats>;

package/dist/TriexClient.d.ts

@@ -5,7 +5,7 @@ import { OrgsWriteApi } from './armature/OrgsApi';
 import { CoinsApi } from './coins/CoinsApi';
 import { TradingFees } from './onchain';
 import { IndexerClient } from './queries';
-import { AssemblyEnriched, AssemblyOwner, AutocompleteSystems, TradingAccountOwner, BatchSystems, BatchSystemsParams, CoordinateSearch, CoordinateSearchParams, BalancesAtHubParams, CancelAllOrdersParams, CancelOrderParams, CancelOrdersParams, ClaimOperatorShareParams, ClaimSettledParams, CreatePoolParams, CreatePoolResult, MintCapParams, MintCapResult, PoolSelector, RevokeCapParams, TradingAccountCaps, TradingFeesParams, 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, Character, CharacterLookup, DisplayPrice, DisplayPriceParams, DisplayPricesParams, FillDetail, HubEconomics, ItemInfo, OrderDetail, OrderLookupParams, PlatformStats, PoolFees, RecentTradesPage, RecentTradesParams, Recipe, Route, RouteComparison, RouteParams, RouteShipParams, RoutingStats, Tribe, WorldItem } from './types';
+import { AssemblyEnriched, AssemblyOwner, AutocompleteSystems, TradingAccountOwner, BatchSystems, BatchSystemsParams, CoordinateSearch, CoordinateSearchParams, BalancesAtHubParams, CancelAllOrdersParams, CancelOrderParams, CancelOrdersParams, ClaimOperatorShareParams, ClaimSettledParams, CreatePoolParams, CreatePoolResult, MintCapParams, MintCapResult, PoolSelector, RevokeCapParams, TradingAccountCaps, TradingFeesParams, 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, Character, CharacterLookup, DisplayPrice, DisplayPriceParams, DisplayPricesParams, FillDetail, HubEconomics, ItemInfo, ItemBlueprints, Blueprint, OrderDetail, OrderLookupParams, PlatformStats, PoolFees, RecentTradesPage, RecentTradesParams, Route, RouteComparison, RouteParams, RouteShipParams, RoutingStats, Tribe, WorldItem } from './types';
 export declare class TriexClient {
     readonly suiClient: ClientWithCoreApi;
     readonly ids: PackageIds;
@@ -155,8 +155,8 @@ declare class WorldApi {
     constructor(c: TriexClient);
     items(): Promise<WorldItem[]>;
     item(assetId: string): Promise<ItemInfo>;
-    recipes(): Promise<Recipe[]>;
-    recipesFor(productAssetId: string): Promise<Recipe[]>;
+    recipes(): Promise<Blueprint[]>;
+    recipesFor(assetId: string): Promise<ItemBlueprints>;
 }
 declare class OrdersApi {
     private readonly c;

package/dist/index.d.ts

@@ -22,8 +22,8 @@ export type { BookLevel } from './book';
 export { iterateDiscovery, iterateFills, iterateHubLocations, iterateItemLocations, iterateOpenOrders, iterateOrgDirectory, iterateRecentTrades, iterateTrades, } from './paging';
 export type { IterateOptions } from './paging';
 export { untilIndexed } from './wait';
-export { DISPLAY_PRICE_TIERS, JUMP_TYPES, ORDER_STATUSES, ORDER_TYPES, ROUTE_OPTIMIZATIONS, } from './schemas';
-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, TradingAccountOwner, 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, CancelOrdersParams, PoolSelector, TradingFeesParams, MintCapParams, MintCapResult, RevokeCapParams, TradingAccountCaps, CreatePoolParams, CreatePoolResult, ClaimOperatorShareParams, OrderDetail, OrderDetailFill, OrderParty, OrderCharacter, OrderHub, OrderCurrency, OrderLookupParams, FillDetail, RecentTrade, RecentTradesPage, RecentTradesParams, DisplayPrice, DisplayPriceParams, DisplayPricesParams, HubEconomics, PoolFees, PlatformStats, StatsQuoteVolume, StatsTopItem, StatsTopOrg, Character, CharacterLookup, Tribe, WorldItem, ItemInfo, Recipe, RecipeMaterial, Route, RouteComparison, RouteOptimization, RouteParams, RouteShipParams, RoutingStats, Waypoint, } from './types';
+export { BLUEPRINT_KINDS, DISPLAY_PRICE_TIERS, JUMP_TYPES, ORDER_STATUSES, ORDER_TYPES, ROUTE_OPTIMIZATIONS, } from './schemas';
+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, TradingAccountOwner, 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, CancelOrdersParams, PoolSelector, TradingFeesParams, MintCapParams, MintCapResult, RevokeCapParams, TradingAccountCaps, CreatePoolParams, CreatePoolResult, ClaimOperatorShareParams, OrderDetail, OrderDetailFill, OrderParty, OrderCharacter, OrderHub, OrderCurrency, OrderLookupParams, FillDetail, RecentTrade, RecentTradesPage, RecentTradesParams, DisplayPrice, DisplayPriceParams, DisplayPricesParams, HubEconomics, PoolFees, PlatformStats, StatsQuoteVolume, StatsTopItem, StatsTopOrg, Character, CharacterLookup, Tribe, WorldItem, ItemInfo, Blueprint, BlueprintItem, BlueprintFacility, ItemBlueprints, Route, RouteComparison, RouteOptimization, RouteParams, RouteShipParams, RoutingStats, Waypoint, } from './types';
 export type { OwnedItemReceipt, CharacterInfo, SsuOwnerInfo, ObjectRef, OwnedTradingAccountCap, FeeTier, AccountFeeRates, TradingFees, } from './onchain';
 export type { TradingAccountCapKind, SwapWithTradingAccountArgs, } from './transactions';
 export { POOL_CREATION_FEE } from './transactions';