@acta-markets/ts-sdk 0.0.1-beta

package/dist/ws/types.js

@@ -0,0 +1,13 @@
+/**
+ * WebSocket protocol types for Acta RFQ server.
+ *
+ * Source of truth:
+ * - docs/state-machines-eng.md (protocol spec)
+ * - rust-backend/shared/src/types/ws.rs (as-built reference)
+ *
+ * Notes:
+ * - UUIDs are represented as strings in JSON.
+ * - Rust uses u64 in many places; we model them as `number` for now.
+ *   If/when we need precision beyond JS safe integer, we can migrate to `bigint | string`.
+ */
+export {};

package/dist/ws/wirePolicy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * WS wire policy helpers.
+ *
+ * Source of truth for the policy: docs/wire-policy.md
+ *
+ * As-built WS protocol encodes Rust u64 as JSON numbers. That is only safe in JS if the value is a
+ * safe integer (<= Number.MAX_SAFE_INTEGER). For fields that participate in `order_id` preimage
+ * hashing (nonce/strike/price/quantity), violating this will produce silent precision loss and
+ * order_id mismatches.
+ */
+export declare function assertWsU64Safe(value: number, name: string): void;
+export declare function assertWsI64Safe(value: number, name: string): void;

package/dist/ws/wirePolicy.js

@@ -0,0 +1,30 @@
+/**
+ * WS wire policy helpers.
+ *
+ * Source of truth for the policy: docs/wire-policy.md
+ *
+ * As-built WS protocol encodes Rust u64 as JSON numbers. That is only safe in JS if the value is a
+ * safe integer (<= Number.MAX_SAFE_INTEGER). For fields that participate in `order_id` preimage
+ * hashing (nonce/strike/price/quantity), violating this will produce silent precision loss and
+ * order_id mismatches.
+ */
+export function assertWsU64Safe(value, name) {
+    if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error(`${name} must be an integer number (u64 on wire)`);
+    }
+    if (value < 0) {
+        throw new Error(`${name} must be >= 0 (u64 on wire)`);
+    }
+    if (!Number.isSafeInteger(value)) {
+        throw new Error(`${name} exceeds JS safe integer range; WS wire requires safe integers (see docs/wire-policy.md)`);
+    }
+}
+export function assertWsI64Safe(value, name) {
+    // For our usage (unix seconds), this is safe; still enforce integer.
+    if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error(`${name} must be an integer number (i64 on wire)`);
+    }
+    if (!Number.isSafeInteger(value)) {
+        throw new Error(`${name} exceeds JS safe integer range; WS wire requires safe integers`);
+    }
+}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@acta-markets/ts-sdk",
+  "version": "0.0.1-beta",
+  "description": "TypeScript SDK for Acta Protocol",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/index.js"
+    },
+    "./chain": {
+      "types": "./dist/chain/index.d.ts",
+      "import": "./dist/chain/index.js",
+      "require": "./dist/cjs/chain/index.js",
+      "default": "./dist/chain/index.js"
+    },
+    "./ws": {
+      "types": "./dist/ws/index.d.ts",
+      "import": "./dist/ws/index.js",
+      "require": "./dist/cjs/ws/index.js",
+      "default": "./dist/ws/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "require": "./dist/cjs/types/index.js",
+      "default": "./dist/types/index.js"
+    },
+    "./nonce": {
+      "types": "./dist/nonce.d.ts",
+      "import": "./dist/nonce.js",
+      "require": "./dist/cjs/nonce.js",
+      "default": "./dist/nonce.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "yarn gen:codama && yarn build:esm && yarn build:cjs",
+    "build:esm": "tsc -p tsconfig.build.esm.json",
+    "build:cjs": "tsc -p tsconfig.build.cjs.json && node scripts/write-cjs-package.cjs",
+    "test": "jest --config jest.config.cjs",
+    "test:ws-handshake:integration": "jest --config jest.config.cjs --runInBand src/ws/client.handshake.integration.test.ts",
+    "gen:codama": "npx codama run js && npx codama run rust",
+    "init-devnet": "tsx scripts/init-devnet.ts",
+    "run:script": "tsx",
+    "typecheck:scripts": "tsc -p tsconfig.scripts.json"
+  },
+  "dependencies": {
+    "@solana/addresses": "^5.0.0",
+    "@solana/keys": "^5.0.0",
+    "@solana/kit": "^5.0.0",
+    "@solana/rpc": "^5.0.0",
+    "@solana/rpc-subscriptions": "^5.0.0",
+    "@solana/transactions": "^5.0.0"
+  },
+  "devDependencies": {
+    "@codama/nodes-from-anchor": "^1.3.6",
+    "@codama/renderers-js": "^1.5.5",
+    "@codama/renderers-rust": "^1.2.9",
+    "@coral-xyz/anchor": "^0.29.0",
+    "@noble/ed25519": "^3.0.0",
+    "@solana/web3.js": "^1.90.0",
+    "@types/bn.js": "^5.1.6",
+    "@types/jest": "^29.5.5",
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.18.1",
+    "bs58": "^5.0.0",
+    "codama": "^1.4.4",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.3",
+    "ws": "^8.18.0"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "yarn@1.22.22"
+}