@loafmarkets/shared-types 1.0.1

package/README.md

@@ -0,0 +1,91 @@
+# Shared Types
+
+Shared contracts (TypeScript interfaces + protobuf schemas) used by the Loaf Markets backend, frontend, and matching engine.
+
+## Repository layout
+
+```
+Shared-Types/
+├── proto/             # trading.proto (matching engine contracts)
+├── src/
+│   └── index.ts       # TypeScript schemas and interfaces shared across services
+├── dist/              # Build output (generated via `pnpm run build`)
+├── package.json       # npm package settings
+└── tsconfig.json
+```
+
+## Getting started
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build once to emit dist/
+pnpm run build
+
+# Run type-check only
+pnpm exec tsc --noEmit
+```
+
+## Consuming the package
+
+In any Loaf service repo:
+
+```bash
+pnpm add @loafmarkets/shared-types@<version>
+```
+
+Then import types from TypeScript:
+
+```ts
+import type { OrderApiRequestBody, propertySchema } from '@loafmarkets/shared-types';
+```
+
+To use the protobuf definition (for gRPC or codegen):
+
+```
+node_modules/@loafmarkets/shared-types/proto/trading.proto
+```
+
+## Making changes
+
+1. **Modify contracts** in `src/index.ts` (TypeScript) or `proto/trading.proto`.
+2. **Run tests/build** locally:
+   ```bash
+   pnpm run build
+   ```
+3. **Update version** in `package.json` following semver (e.g., bump patch for backward-compatible additions).
+4. **Document changes** in the commit message or a CHANGELOG entry if you maintain one.
+
+## Release process
+
+```bash
+# Ensure working tree is clean
+git status
+
+# Build artifacts
+pnpm run build
+
+# Commit and push
+git commit -am "feat: add XYZ contract"
+git push origin main
+
+# Tag the release (match package.json version)
+git tag v<version>
+git push origin v<version>
+
+# Publish to registry
+pnpm publish --tag latest
+```
+
+Once published, update each consumer repository:
+
+```bash
+pnpm add @loafmarkets/shared-types@<version>
+```
+
+## Notes
+
+- `dist/` and `node_modules/` should never be committed; they are generated during install/publish.
+- The `prepare` script ensures `pnpm install` (even from Git) builds `dist/`, so consumers always have compiled output.
+- Use Renovate/Dependabot to automate dependency bump PRs in downstream repos.

package/dist/index.d.ts

@@ -0,0 +1,255 @@
+import { z } from 'zod';
+export declare const MARKET_ORDER_PRICE = 0;
+export declare const ORDER_QUANTITY_MAX_DECIMALS: 8;
+export declare const ORDER_PRICE_MAX_DECIMALS: 2;
+export type OrderSide = 'BUY' | 'SELL';
+export type OrderType = 'MARKET' | 'LIMIT';
+export type OrderStatus = 'PENDING' | 'OPEN' | 'PARTIALLY_FILLED' | 'FILLED' | 'CANCELLED' | 'REJECTED' | 'EXPIRED';
+export type TimeInForce = 'GTC' | 'IOC' | 'FOK' | 'GTD';
+export declare const orderBodySchema: z.ZodObject<{
+    propertyId: z.ZodNumber;
+    price: z.ZodNumber;
+    quantity: z.ZodNumber;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    type: z.ZodDefault<z.ZodEnum<{
+        MARKET: "MARKET";
+        LIMIT: "LIMIT";
+    }>>;
+    timeInForce: z.ZodDefault<z.ZodEnum<{
+        GTC: "GTC";
+        IOC: "IOC";
+        FOK: "FOK";
+        GTD: "GTD";
+    }>>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    nonce: z.ZodString;
+    walletAddress: z.ZodString;
+    signature: z.ZodString;
+}, z.core.$strip>;
+export type OrderApiRequestBody = z.infer<typeof orderBodySchema>;
+export declare const sessionSignerOrderBodySchema: z.ZodObject<{
+    propertyId: z.ZodNumber;
+    price: z.ZodNumber;
+    quantity: z.ZodNumber;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    type: z.ZodDefault<z.ZodEnum<{
+        MARKET: "MARKET";
+        LIMIT: "LIMIT";
+    }>>;
+    timeInForce: z.ZodDefault<z.ZodEnum<{
+        GTC: "GTC";
+        IOC: "IOC";
+        FOK: "FOK";
+        GTD: "GTD";
+    }>>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    nonce: z.ZodString;
+    walletAddress: z.ZodString;
+    tokenName: z.ZodString;
+}, z.core.$strip>;
+export type SessionSignerOrderRequestBody = z.infer<typeof sessionSignerOrderBodySchema>;
+export interface SessionSignerInfo {
+    quorumId: string;
+    policyId: string | undefined;
+    enabled: boolean;
+}
+export interface SessionSignerStatus {
+    enabled: boolean;
+    reason?: string;
+}
+export interface OrderApiResponse {
+    success: boolean;
+    orderId: number;
+    errorMessage?: string;
+}
+export interface OrderNonceResponse {
+    nonce: string;
+    expiresAt: string;
+}
+export declare const cancelOrderBodySchema: z.ZodObject<{
+    orderId: z.ZodNumber;
+}, z.core.$strip>;
+export type CancelOrderRequestBody = z.infer<typeof cancelOrderBodySchema>;
+export interface CancelOrderResponse {
+    success: boolean;
+    orderId: number;
+    errorMessage?: string;
+}
+export interface OrderHistoryItem {
+    readonly id: number;
+    readonly propertyId: number;
+    readonly side: OrderSide;
+    readonly type: OrderType;
+    readonly timeInForce: TimeInForce;
+    readonly quantity: number;
+    readonly limitPrice: number | null;
+    readonly status: OrderStatus;
+    readonly filledQuantity: number;
+    readonly averageFillPrice: number | null;
+    readonly rejectionReason: string | null;
+    readonly expiresAt: string | null;
+    readonly filledAt: string | null;
+    readonly cancelledAt: string | null;
+    readonly createdAt: string;
+}
+export interface OrderPositionMetrics {
+    readonly propertyId: number;
+    readonly netPosition: number;
+    readonly averageEntryPrice: number | null;
+    readonly realizedPnl: number;
+    readonly unrealizedPnl: number;
+    readonly totalPnl: number;
+}
+export interface TradeHistoryItem {
+    readonly tradeId: number;
+    readonly propertyId: number;
+    readonly side: OrderSide;
+    readonly quantity: number;
+    readonly price: number;
+    readonly fee: number;
+    readonly executedAt: string;
+}
+export interface PortfolioBalance {
+    readonly assetType: string;
+    readonly available: number;
+    readonly frozen: number;
+    readonly total: number;
+}
+export interface OrderHistoryResponse {
+    readonly orders: readonly OrderHistoryItem[];
+    readonly total: number;
+    readonly page: number;
+    readonly pageSize: number;
+}
+export interface TradeHistoryResponse {
+    readonly trades: readonly TradeHistoryItem[];
+    readonly total: number;
+    readonly page: number;
+    readonly pageSize: number;
+}
+export interface PortfolioResponse {
+    readonly orderHistory: readonly OrderHistoryItem[];
+    readonly tradeHistory: readonly TradeHistoryItem[];
+    readonly metrics: readonly OrderPositionMetrics[];
+    readonly balances: readonly PortfolioBalance[];
+}
+export interface PriceLevel {
+    price: number;
+    quantity: number;
+}
+export interface OrderBook {
+    property_id: number;
+    bids: PriceLevel[];
+    asks: PriceLevel[];
+}
+export interface UserProfileResponse {
+    readonly userId: string;
+    readonly user_type: 'INVESTOR' | 'HOMEOWNER' | 'ADMIN' | 'MARKET_MAKER';
+    readonly kycVerified: boolean;
+}
+export declare const propertySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    tokenName: z.ZodString;
+    address: z.ZodString;
+    price: z.ZodNumber;
+    imageUrl: z.ZodString;
+}, z.core.$strip>;
+export declare const propertyListSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    tokenName: z.ZodString;
+    address: z.ZodString;
+    price: z.ZodNumber;
+    imageUrl: z.ZodString;
+}, z.core.$strip>>;
+export type Property = z.infer<typeof propertySchema>;
+export interface Candle {
+    readonly time: number;
+    readonly open: number;
+    readonly high: number;
+    readonly low: number;
+    readonly close: number;
+    readonly volume?: number;
+}
+export interface PropertyResponse {
+    readonly property: Property;
+    readonly orderBook: OrderBook | null;
+    readonly candlesticks: readonly Candle[];
+}
+interface BaseWebSocketMessage {
+    timestamp: string;
+}
+export interface ConnectionMessage extends BaseWebSocketMessage {
+    type: 'connection';
+    message: string;
+}
+export interface EchoMessage extends BaseWebSocketMessage {
+    type: 'echo';
+    data: unknown;
+}
+export interface TestMessage extends BaseWebSocketMessage {
+    type: 'test';
+    message: string;
+}
+export interface ErrorMessage extends BaseWebSocketMessage {
+    type: 'error';
+    message: string;
+    code?: string;
+}
+export interface OrderbookUpdateMessage extends BaseWebSocketMessage {
+    type: 'orderbook_update';
+    propertyId: number;
+    bids: PriceLevel[];
+    asks: PriceLevel[];
+}
+export interface OrderStatusMessage extends BaseWebSocketMessage {
+    type: 'order_status';
+    orderId: number;
+    status: OrderStatus;
+}
+export interface MarketDataMessage extends BaseWebSocketMessage {
+    type: 'market_data';
+    propertyId: number;
+    lastPrice: number;
+    volume24h: number;
+    priceChange24h: number;
+}
+export interface CandleUpdateMessage extends BaseWebSocketMessage {
+    type: 'candle_update';
+    propertyId: number;
+    candle: Candle;
+}
+export interface SubscribeMessage extends BaseWebSocketMessage {
+    type: 'subscribe';
+    channels: string[];
+}
+export interface UnsubscribeMessage extends BaseWebSocketMessage {
+    type: 'unsubscribe';
+    channels: string[];
+}
+export interface SubscriptionConfirmMessage extends BaseWebSocketMessage {
+    type: 'subscription_confirmed';
+    channels: string[];
+}
+export interface PortfolioUpdateMessage extends BaseWebSocketMessage {
+    type: 'portfolio_update';
+    userId: number;
+    totalValue: number;
+    totalPnL: number;
+    pnLPercentage: number;
+    holdings: Array<{
+        propertyId: number;
+        quantity: number;
+        avgPrice: number;
+        currentPrice: number;
+        pnL: number;
+    }>;
+}
+export type WebSocketMessage = ConnectionMessage | EchoMessage | TestMessage | ErrorMessage | OrderbookUpdateMessage | OrderStatusMessage | MarketDataMessage | CandleUpdateMessage | PortfolioUpdateMessage | SubscribeMessage | UnsubscribeMessage | SubscriptionConfirmMessage;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+// -----------------------------------------------------------------------------
+// Orders & Trading
+// -----------------------------------------------------------------------------
+export const MARKET_ORDER_PRICE = 0;
+export const ORDER_QUANTITY_MAX_DECIMALS = 8;
+export const ORDER_PRICE_MAX_DECIMALS = 2;
+const orderSideEnum = z.enum(['BUY', 'SELL']);
+const orderTypeEnum = z.enum(['MARKET', 'LIMIT']);
+const timeInForceEnum = z.enum(['GTC', 'IOC', 'FOK', 'GTD']);
+const DECIMAL_SEPARATOR = '.';
+function hasExcessDecimals(value, maxDecimals) {
+    const [, fractional = ''] = value.toString().split(DECIMAL_SEPARATOR);
+    return fractional.length > maxDecimals;
+}
+const baseOrderSchema = z
+    .object({
+    propertyId: z.number().int().positive(),
+    price: z.number().nonnegative(),
+    quantity: z.number().positive(),
+    side: orderSideEnum,
+    type: orderTypeEnum.default('MARKET'),
+    timeInForce: timeInForceEnum.default('GTC'),
+    expiresAt: z.string().optional(),
+    nonce: z.string(),
+    walletAddress: z.string(),
+})
+    .superRefine((data, ctx) => {
+    // LIMIT orders must have a positive price
+    if (data.type === 'LIMIT' && (typeof data.price !== 'number' || data.price <= 0)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'Limit orders require a positive price',
+            path: ['price'],
+        });
+    }
+    // MARKET orders must have price = MARKET_ORDER_PRICE
+    if (data.type === 'MARKET' && data.price !== MARKET_ORDER_PRICE) {
+        ctx.addIssue({
+            code: 'custom',
+            message: `Market orders must have price = ${MARKET_ORDER_PRICE}`,
+            path: ['price'],
+        });
+    }
+    // GTD requires expiresAt
+    if (data.timeInForce === 'GTD' && !data.expiresAt) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'GTD orders require an expiration timestamp',
+            path: ['expiresAt'],
+        });
+    }
+    if (hasExcessDecimals(data.quantity, ORDER_QUANTITY_MAX_DECIMALS)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: `Quantity must have at most ${ORDER_QUANTITY_MAX_DECIMALS} decimal places`,
+            path: ['quantity'],
+        });
+    }
+    if (data.type === 'LIMIT' && hasExcessDecimals(data.price, ORDER_PRICE_MAX_DECIMALS)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: `Limit price must have at most ${ORDER_PRICE_MAX_DECIMALS} decimal places`,
+            path: ['price'],
+        });
+    }
+});
+// Schema for orders signed client-side (signature provided in request)
+export const orderBodySchema = baseOrderSchema.safeExtend({
+    signature: z.string(),
+});
+// Schema for orders signed server-side via session signer
+export const sessionSignerOrderBodySchema = baseOrderSchema.safeExtend({
+    tokenName: z.string(),
+});
+export const cancelOrderBodySchema = z.object({
+    orderId: z.number().int().positive(),
+});
+// -----------------------------------------------------------------------------
+// Properties
+// -----------------------------------------------------------------------------
+export const propertySchema = z.object({
+    id: z.number().int(),
+    tokenName: z.string(),
+    address: z.string(),
+    price: z.number(),
+    imageUrl: z.string(),
+});
+export const propertyListSchema = z.array(propertySchema);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@loafmarkets/shared-types",
+  "version": "1.0.1",
+  "description": "Shared contracts for Loaf Markets frontend, backend, and matching engine.",
+  "type": "module",
+  "private": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./proto/trading.proto": "./proto/trading.proto"
+  },
+  "files": [
+    "dist",
+    "proto"
+  ],
+  "keywords": [],
+  "author": "Cohen",
+  "dependencies": {
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "rimraf": "^6.1.2",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist"
+  }
+}

package/proto/trading.proto

@@ -0,0 +1,172 @@
+syntax = "proto3";
+
+package loaf.trading;
+
+// Order message
+message Order {
+    uint64 order_id = 1;
+    uint32 user_id = 2;
+    uint32 property_id = 3;
+    uint64 price = 4;
+    uint32 quantity = 5;
+    OrderSide side = 6;
+    OrderType type = 7;
+    TimeInForce time_in_force = 8;
+    string expires_at = 9;
+    string signature = 10;
+    string wallet_address = 11;
+}
+
+enum OrderSide {
+    BUY = 0;
+    SELL = 1;
+}
+
+enum OrderType {
+    MARKET = 0;
+    LIMIT = 1;
+}
+
+enum TimeInForce {
+    GTC = 0;
+    IOC = 1;
+    FOK = 2;
+    GTD = 3;
+}
+
+// enum OrderStatus {
+//     PENDING = 0;
+//     PARTIALLY_FILLED = 1;
+//     FILLED = 2;
+//     CANCELLED = 3;
+//     REJECTED = 4;
+// }
+
+
+// Trade execution
+message TradeExecution {
+    uint64 trade_id = 1;
+    uint64 buy_order_id = 2;
+    uint64 sell_order_id = 3;
+    uint32 property_id = 4;
+    string property_token_address = 5;
+    double price = 6;
+    double quantity = 7;
+    double fee_amount = 8;
+    string buyer_wallet = 9;
+    string seller_wallet = 10;
+    OrderSide side = 11;
+    int64 timestamp = 12;
+    int64 deadline = 13;
+    string buyer_signature = 14;
+    string seller_signature = 15;
+    string cpp_signature = 16;
+}
+
+// Order book
+message PriceLevel {
+  double price = 1;
+  double quantity = 2;
+}
+
+message OrderBookSnapshot {
+  uint32 property_id = 1;
+  repeated PriceLevel bids = 2;
+  repeated PriceLevel asks = 3;
+  repeated uint64 cancelled_order_ids = 4;
+}
+
+// Quote book
+message QuoteLevel {
+  OrderSide side = 1;
+  OrderType type = 2;
+  uint64 price = 3;
+  uint32 quantity = 4;
+}
+
+message QuoteBook {
+  uint32 property_id = 1;
+  repeated QuoteLevel bids = 2;
+  repeated QuoteLevel asks = 3;
+}
+
+
+// --------------------------------------------------------------
+// Service 1: OrderService (for Node.js Backend)
+// --------------------------------------------------------------
+
+service OrderService {
+    rpc SubmitOrder(SubmitOrderRequest) returns (SubmitOrderResponse);
+    rpc CancelOrder(CancelOrderRequest) returns (CancelOrderResponse);
+    rpc GetOrderStatus(GetOrderStatusRequest) returns (Order);
+}
+
+message SubmitOrderRequest {
+    uint32 user_id = 1;
+    uint32 property_id = 2;
+    uint64 price = 3;
+    uint32 quantity = 4;
+    OrderSide side = 5;
+    OrderType type = 6;
+    TimeInForce time_in_force = 7;
+    string expires_at = 8;
+    uint64 order_id = 9;
+    string signature = 10;
+    string wallet_address = 11;
+}
+
+message SubmitOrderResponse {
+    bool success = 1;
+    uint64 order_id = 2;
+    string error_message = 3;
+}
+
+message GetOrderStatusRequest {
+    // string order_id = 1;
+    // string user_id = 2;
+}
+
+message CancelOrderRequest {
+    uint64 order_id = 1;
+    uint32 property_id = 2;
+}
+
+message CancelOrderResponse {
+    bool success = 1;
+    uint64 order_id = 2;
+    string error_message = 3;
+}
+
+// --------------------------------------------------------------
+// Service 2: TradingService (for Market Maker)
+// --------------------------------------------------------------
+
+// service TradingService {
+//     rpc StreamTradingData(stream MarketMakerMessage) returns (stream EngineMessage);
+// }
+
+// message MarketMakerMessage {
+//     oneof message {
+//         MarketMakerRegistration registration = 1;
+//         Quote quote = 2;
+//         TradeAck trade_ack = 3;
+//     }
+// }
+
+// message EngineMessage {
+//     oneof message {
+//         Order order = 1;
+//         TradeExecution trade_execution = 2;
+//     }
+// }
+
+// message MarketMakerRegistration {
+//     string market_maker_id = 1;
+//     repeated string property_ids = 2;
+// }
+
+// message TradeAck {
+//     string trade_id = 1;
+//     bool acknowledged = 2;
+//     string error_message = 3;
+// }