@trinaryex/sdk 1.0.0

package/dist/transactions.d.ts

@@ -0,0 +1,76 @@
+import { Transaction, TransactionResult, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { PackageIds } from './types';
+export declare function newBalanceManager(tx: Transaction, ids: PackageIds): TransactionResult;
+export declare function generateProofAsOwner(tx: Transaction, ids: PackageIds, bm: TransactionObjectArgument): TransactionResult;
+export declare function depositCoin(tx: Transaction, ids: PackageIds, bm: TransactionObjectArgument, coin: TransactionObjectArgument, coinType?: string): void;
+export declare function depositMulticoinObject(tx: Transaction, ids: PackageIds, bm: TransactionObjectArgument, itemObjectId: string): void;
+export declare function withdrawCoin(tx: Transaction, ids: PackageIds, bm: TransactionObjectArgument, amount: bigint, coinType?: string): TransactionResult;
+export declare function withdrawAllCoin(tx: Transaction, ids: PackageIds, bm: TransactionObjectArgument, coinType?: string): TransactionResult;
+export declare function withdrawAllMulticoin(tx: Transaction, ids: PackageIds, bm: TransactionObjectArgument, collectionId: string, assetId: bigint): TransactionResult;
+export declare function redeemReceipt(tx: Transaction, ids: PackageIds, balance: TransactionObjectArgument, args: {
+    ssuObjectId: string;
+    characterId: string;
+    vaultConfigId: string;
+    collectionId: string;
+    isOwner: boolean;
+}): void;
+export interface HangarSourceArgs {
+    ssuObjectId: string;
+    characterId: string;
+    capRef: {
+        objectId: string;
+        version: string;
+        digest: string;
+    };
+    capTypeArg: string;
+    vaultConfigId: string;
+    vaultCollectionId: string;
+    assetId: bigint;
+    amount: number;
+}
+export declare function sourceItemsFromHangar(tx: Transaction, ids: PackageIds, bm: TransactionObjectArgument, args: HangarSourceArgs): void;
+export interface PlaceLimitOrderArgs {
+    poolId: string;
+    bm: TransactionObjectArgument;
+    proof: TransactionObjectArgument;
+    price: bigint;
+    quantity: bigint;
+    isBid: boolean;
+    orderType?: number;
+    selfMatchingOption?: number;
+    expireTimestamp: bigint;
+}
+export declare function placeLimitOrderItem(tx: Transaction, ids: PackageIds, args: PlaceLimitOrderArgs): void;
+export interface PlaceMarketOrderArgs {
+    poolId: string;
+    bm: TransactionObjectArgument;
+    proof: TransactionObjectArgument;
+    quantity: bigint;
+    isBid: boolean;
+    selfMatchingOption?: number;
+}
+export declare function placeMarketOrderItem(tx: Transaction, ids: PackageIds, args: PlaceMarketOrderArgs): void;
+export declare function cancelOrderItem(tx: Transaction, ids: PackageIds, args: {
+    poolId: string;
+    bm: TransactionObjectArgument;
+    proof: TransactionObjectArgument;
+    orderId: bigint;
+}): void;
+export declare function cancelAllOrdersItem(tx: Transaction, ids: PackageIds, args: {
+    poolId: string;
+    bm: TransactionObjectArgument;
+    proof: TransactionObjectArgument;
+}): void;
+export declare function modifyOrderItem(tx: Transaction, ids: PackageIds, args: {
+    poolId: string;
+    bm: TransactionObjectArgument;
+    proof: TransactionObjectArgument;
+    orderId: bigint;
+    newQuantity: bigint;
+}): void;
+export declare function withdrawSettledAmounts(tx: Transaction, ids: PackageIds, args: {
+    poolId: string;
+    bm: TransactionObjectArgument;
+    proof: TransactionObjectArgument;
+    quoteCoinType?: string;
+}): void;

package/dist/types.d.ts

@@ -0,0 +1,172 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { ClientWithCoreApi } from '@mysten/sui/client';
+import { z } from 'zod';
+import { AssetBalanceSchema, CollectionHubSchema, DiscoveryOrderSchema, DiscoveryResultSchema, FillSchema, FillsPageSchema, HubItemSchema, HubItemsPageSchema, HubLocationSchema, HubVaultSchema, InventoryBalancesSchema, OpenOrderSchema, OpenOrdersPageSchema, OrderbookOrderSchema, PoolMetadataSchema, SweepableItemSchema, SweepablePoolSchema, SweepableSchema, TradeSchema, TradesPageSchema } from './schemas';
+export interface ObjectChange {
+    type: string;
+    objectId?: string;
+    objectType?: string;
+    [key: string]: unknown;
+}
+export type TransactionExecutor = (tx: Transaction) => Promise<unknown>;
+export interface TxResult {
+    digest: string;
+    createdObjects: {
+        objectId: string;
+        objectType: string;
+    }[];
+    raw: unknown;
+}
+export type TriexNetwork = 'testnet';
+export interface PackageIds {
+    triexbook: string;
+    triexRegistry: string;
+    multicoin: string;
+    warehouseReceipts: string;
+    credCoinType: string;
+    world: string;
+    worldOriginal: string;
+    clock: string;
+}
+export interface TriexClientConfig {
+    suiClient: ClientWithCoreApi;
+    apiKey: string;
+    executor?: TransactionExecutor;
+    address?: string;
+    indexerUrl?: string;
+    network?: TriexNetwork;
+    packageIds?: Partial<PackageIds>;
+}
+export interface ReadOnlyClientConfig {
+    apiKey: string;
+    indexerUrl?: string;
+    network?: TriexNetwork;
+    packageIds?: Partial<PackageIds>;
+}
+export type OrderSide = 'buy' | 'sell';
+export type DiscoveryOrder = z.output<typeof DiscoveryOrderSchema>;
+export type DiscoveryResult = z.output<typeof DiscoveryResultSchema>;
+export type OrderbookOrder = z.output<typeof OrderbookOrderSchema>;
+export type PoolMetadata = z.output<typeof PoolMetadataSchema>;
+export type HubVaultInfo = z.output<typeof HubVaultSchema>;
+export type HubLocation = z.output<typeof HubLocationSchema>;
+export type HubItem = z.output<typeof HubItemSchema>;
+export type HubItemsPage = z.output<typeof HubItemsPageSchema>;
+export type CollectionHub = z.output<typeof CollectionHubSchema>;
+export type AssetBalance = z.output<typeof AssetBalanceSchema>;
+export type InventoryBalances = z.output<typeof InventoryBalancesSchema>;
+export type OpenOrder = z.output<typeof OpenOrderSchema>;
+export type OpenOrdersPage = z.output<typeof OpenOrdersPageSchema>;
+export type Fill = z.output<typeof FillSchema>;
+export type FillsPage = z.output<typeof FillsPageSchema>;
+export type Trade = z.output<typeof TradeSchema>;
+export type TradesPage = z.output<typeof TradesPageSchema>;
+export type SweepablePool = z.output<typeof SweepablePoolSchema>;
+export type SweepableItem = z.output<typeof SweepableItemSchema>;
+export type Sweepable = z.output<typeof SweepableSchema>;
+export interface Orderbook {
+    poolId: string;
+    bids: OrderbookOrder[];
+    asks: OrderbookOrder[];
+}
+export interface TradeHubDetail {
+    hubId: string;
+    collectionId: string;
+    vaultConfigId: string;
+    location: HubLocation | null;
+}
+export interface TradingAccount {
+    balanceManagerId: string;
+    owner: string;
+}
+export interface CurrencyBalances {
+    wallet: bigint;
+    balanceManager: bigint;
+    balanceManagerId: string | null;
+}
+export interface EnsureAccountResult {
+    balanceManagerId: string;
+    created: boolean;
+}
+export interface DiscoveryFilters {
+    storageUnitIds?: string[];
+    assetId?: string;
+    balanceManagerId?: string;
+    side?: 'buy' | 'sell' | 'both';
+    publicOnly?: boolean;
+    cursor?: string;
+    limit?: number;
+}
+export interface BalancesAtHubParams {
+    storageUnitId: string;
+    address?: string;
+    inventoryKey?: string;
+    vaultIds?: string[];
+}
+export interface HistoryPageParams {
+    before?: number;
+    after?: number;
+    limit?: number;
+}
+export interface FillsParams extends HistoryPageParams {
+    poolId?: string;
+    side?: 'maker' | 'taker' | 'all';
+}
+export interface TradesParams extends HistoryPageParams {
+    side?: 'maker' | 'taker' | 'all';
+    assetId?: string;
+}
+export interface DepositCurrencyParams {
+    amount: bigint;
+}
+export interface DepositItemsParams {
+    storageUnitId: string;
+    items: {
+        assetId: string;
+        amount: bigint;
+    }[];
+}
+export interface WithdrawCurrencyParams {
+    amount?: bigint;
+}
+export interface WithdrawItemsParams {
+    storageUnitId: string;
+    items: {
+        assetId: string;
+    }[];
+    characterId?: string;
+}
+export interface LimitOrderParams {
+    storageUnitId: string;
+    assetId: string;
+    side: OrderSide;
+    price: bigint;
+    quantity: bigint;
+    expireAt?: bigint;
+    orderType?: number;
+    selfMatchingOption?: number;
+    quoteDeposit?: bigint;
+}
+export interface MarketOrderParams {
+    storageUnitId: string;
+    assetId: string;
+    side: OrderSide;
+    quantity: bigint;
+    quoteBudget?: bigint;
+    selfMatchingOption?: number;
+}
+export interface CancelOrderParams {
+    storageUnitId: string;
+    assetId: string;
+    orderId: bigint | string;
+}
+export interface CancelAllOrdersParams {
+    storageUnitId: string;
+    assetId: string;
+}
+export interface ModifyOrderParams extends CancelOrderParams {
+    newQuantity: bigint;
+}
+export interface ClaimSettledParams {
+    poolIds?: string[];
+}

package/dist/wait.d.ts

@@ -0,0 +1,5 @@
+export declare function untilIndexed<T>(probe: () => Promise<T | null | undefined | false>, options?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+    label?: string;
+}): Promise<T>;

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@trinaryex/sdk",
+  "version": "1.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",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "DESIGN.md"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "test:cov": "node --experimental-vm-modules node_modules/.bin/jest --ci --coverage",
+    "prettier": "prettier --write '{src,test}/**/*.ts'",
+    "prettier:check": "prettier --check '{src,test}/**/*.ts'",
+    "lint": "eslint --cache '{src,test}/**/*.ts'",
+    "lint:check": "eslint --cache '{src,test}/**/*.ts'",
+    "lint:fix": "eslint --cache --fix '{src,test}/**/*.ts'",
+    "tscheck": "tsc --noEmit",
+    "release": "semantic-release"
+  },
+  "author": "@blurpesec",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@mysten/sui": "^2.16.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^18.0.0",
+    "@commitlint/config-conventional": "^18.0.0",
+    "@mysten/sui": "^2.16.0",
+    "@semantic-release/changelog": "^6.0.0",
+    "@semantic-release/commit-analyzer": "^13.0.0",
+    "@semantic-release/git": "^10.0.0",
+    "@semantic-release/github": "^10.0.0",
+    "@semantic-release/npm": "^12.0.0",
+    "@semantic-release/release-notes-generator": "^14.0.0",
+    "@types/jest": "^29.0.0",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.3.0",
+    "semantic-release": "^24.0.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.4.2",
+    "vite": "^8.0.10",
+    "vite-plugin-dts": "^5.0.0",
+    "zod": "^4.4.3"
+  },
+  "jest": {
+    "preset": "ts-jest/presets/default-esm",
+    "moduleFileExtensions": [
+      "js",
+      "mjs",
+      "json",
+      "ts"
+    ],
+    "testRegex": ".test.ts$",
+    "transform": {
+      "^.+\\.ts$": [
+        "ts-jest",
+        {
+          "useESM": true,
+          "diagnostics": false
+        }
+      ]
+    },
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "collectCoverageFrom": [
+      "src/**/*.{ts,js}"
+    ],
+    "testEnvironment": "node",
+    "coverageDirectory": "./coverage"
+  },
+  "keywords": [
+    "trinary-exchange",
+    "trading",
+    "sdk",
+    "sui",
+    "orderbook",
+    "eve-frontier",
+    "deepbook"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/loash-industries/sdk.git"
+  }
+}