@signals-protocol/v1-sdk 1.0.0 → 1.2.0

package/dist/share/position-image.js

@@ -0,0 +1,337 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPositionVNode = buildPositionVNode;
+const h_1 = require("./h");
+const assets_1 = require("./assets");
+const format_1 = require("./format");
+function buildPositionVNode(input) {
+    const { positionId, lowerTick, upperTick, currentQuantity, currentCost, totalQuantityBought, totalCosts, totalProceeds, outcome, closingPriceDate, isSettled, settlementTick, owner, theme, hideWallet, hideAmounts, currentValue, } = input;
+    const isDark = theme === "dark";
+    const isOpen = outcome === "OPEN";
+    // Entry: OPEN uses currentCost, settled uses totalCosts (currentCost is zeroed after claim)
+    const entry = isOpen ? Number(currentCost) / 1e6 : Number(totalCosts) / 1e6;
+    // PnL calculation:
+    // - LOSS: payout = 0
+    // - OPEN with currentValue: use SDK close proceeds
+    // - OPEN without currentValue: max payout fallback (currentQuantity)
+    // - WIN (settled): totalQuantityBought (full range payout)
+    // - CLOSED (early exit settled): totalProceeds
+    let value;
+    if (outcome === "LOSS") {
+        value = 0;
+    }
+    else if (isOpen && currentValue != null) {
+        value = currentValue;
+    }
+    else if (isOpen) {
+        value = Number(currentQuantity) / 1e6;
+    }
+    else if (outcome === "WIN") {
+        value = Number(totalQuantityBought) / 1e6;
+    }
+    else if (outcome === "CLOSED") {
+        value = Number(totalProceeds) / 1e6;
+    }
+    else {
+        value = 0;
+    }
+    // Snap sub-cent PnL to zero (floating-point noise from SDK calculations)
+    const rawPnl = value - entry;
+    const pnl = Math.abs(rawPnl) < 0.005 ? 0 : rawPnl;
+    const pnlPercent = entry > 0 ? pnl / entry : 0;
+    const payoutLabel = isOpen ? "Current Value" : "Payout";
+    const textPrimary = isDark ? "#ffffff" : "#000000";
+    const textSecondary = isDark
+        ? "rgba(255,255,255,0.70)"
+        : "rgba(0,0,0,0.60)";
+    const textMuted = isDark ? "rgba(255,255,255,0.65)" : "rgba(0,0,0,0.55)";
+    const pnlColor = (0, format_1.getPnlColor)(pnl, textMuted);
+    const payoutDisplayValue = outcome === "LOSS"
+        ? "$0.00"
+        : isOpen && currentValue != null
+            ? "$" +
+                currentValue.toLocaleString("en-US", {
+                    minimumFractionDigits: 2,
+                    maximumFractionDigits: 2,
+                })
+            : isOpen
+                ? (0, format_1.formatUSDC)(currentQuantity)
+                : outcome === "WIN"
+                    ? (0, format_1.formatUSDC)(totalQuantityBought)
+                    : (0, format_1.formatUSDC)(totalProceeds);
+    const children = [];
+    // Background gradient
+    children.push((0, h_1.h)("div", {
+        style: {
+            position: "absolute",
+            top: 0,
+            left: 0,
+            right: 0,
+            bottom: 0,
+            background: isDark
+                ? "linear-gradient(135deg, #0d1528, #0e1633)"
+                : "linear-gradient(135deg, #fbfdff, #f0f6ff)",
+            display: "flex",
+        },
+    }));
+    // Blue radial glow
+    children.push((0, h_1.h)("div", {
+        style: {
+            position: "absolute",
+            top: 0,
+            left: 0,
+            right: 0,
+            bottom: 0,
+            background: isDark
+                ? "radial-gradient(circle at 25% 20%, rgba(45,136,255,0.15), transparent 65%)"
+                : "radial-gradient(circle at 22% 18%, rgba(185,221,255,0.30), transparent 40%)",
+            display: "flex",
+        },
+    }));
+    // PnL glow
+    children.push((0, h_1.h)("div", {
+        style: {
+            position: "absolute",
+            top: 0,
+            left: 0,
+            right: 0,
+            bottom: 0,
+            background: pnl >= 0
+                ? isDark
+                    ? "radial-gradient(circle at 85% 75%, rgba(0,191,64,0.25), transparent 45%)"
+                    : "radial-gradient(circle at 85% 75%, rgba(88,230,131,0.30), transparent 45%)"
+                : isDark
+                    ? "radial-gradient(circle at 85% 75%, rgba(239,68,68,0.25), transparent 45%)"
+                    : "radial-gradient(circle at 85% 75%, rgba(252,165,165,0.30), transparent 45%)",
+            display: "flex",
+        },
+    }));
+    // LogoStrokeSVG watermark
+    children.push((0, h_1.h)("div", {
+        style: {
+            position: "absolute",
+            right: 8,
+            top: 8,
+            bottom: 8,
+            display: "flex",
+        },
+    }, (0, assets_1.buildLogoStrokeSVG)(614, theme)));
+    // Content
+    const contentChildren = [];
+    // Logo + "Signals"
+    contentChildren.push((0, h_1.h)("div", {
+        style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 8,
+            marginBottom: 24,
+        },
+    }, (0, h_1.h)("img", {
+        src: assets_1.SIGNALS_LOGO_URI,
+        width: 34,
+        height: 32,
+        style: { display: "flex" },
+    }), (0, h_1.h)("span", {
+        style: {
+            fontSize: 28,
+            fontWeight: 700,
+            color: "#1444c2",
+            display: "flex",
+        },
+    }, "Signals")));
+    // Range section
+    const rangeItems = [
+        (0, h_1.h)("div", { style: { display: "flex", flexDirection: "column" } }, (0, h_1.h)("div", {
+            style: {
+                fontSize: 17,
+                color: textSecondary,
+                marginBottom: 4,
+                display: "flex",
+            },
+        }, "Range"), (0, h_1.h)("div", {
+            style: {
+                fontSize: 34,
+                fontWeight: 700,
+                color: textPrimary,
+                display: "flex",
+            },
+        }, (0, format_1.formatPriceRange)(lowerTick, upperTick))),
+    ];
+    if (isSettled && settlementTick != null) {
+        rangeItems.push((0, h_1.h)("div", { style: { display: "flex", flexDirection: "column" } }, (0, h_1.h)("div", {
+            style: {
+                fontSize: 17,
+                color: textSecondary,
+                marginBottom: 4,
+                display: "flex",
+            },
+        }, "Actual Price"), (0, h_1.h)("div", {
+            style: {
+                fontSize: 34,
+                fontWeight: 700,
+                color: textPrimary,
+                display: "flex",
+            },
+        }, (0, format_1.formatPrice)(settlementTick))));
+    }
+    contentChildren.push((0, h_1.h)("div", { style: { display: "flex", gap: 48, marginBottom: 20 } }, ...rangeItems));
+    // PnL (dominant)
+    const pnlChildren = [
+        (0, h_1.h)("div", {
+            style: {
+                fontSize: 17,
+                color: textSecondary,
+                marginBottom: 2,
+                display: "flex",
+            },
+        }, "PnL"),
+    ];
+    if (hideAmounts) {
+        pnlChildren.push((0, h_1.h)("div", {
+            style: {
+                fontSize: 90,
+                fontWeight: 700,
+                color: pnlColor,
+                lineHeight: 1,
+                display: "flex",
+            },
+        }, `${pnl > 0 ? "+" : pnl < 0 ? "-" : ""}${(0, format_1.percForm)(Math.abs(pnlPercent))}`));
+    }
+    else {
+        pnlChildren.push((0, h_1.h)("div", { style: { display: "flex", alignItems: "flex-end", gap: 8 } }, (0, h_1.h)("div", {
+            style: {
+                fontSize: 90,
+                fontWeight: 700,
+                color: pnlColor,
+                lineHeight: 1,
+                display: "flex",
+            },
+        }, (0, format_1.formatUsdPnl)(pnl)), (0, h_1.h)("div", {
+            style: {
+                fontSize: 34,
+                fontWeight: 700,
+                color: pnlColor,
+                marginBottom: 8,
+                display: "flex",
+            },
+        }, `(${(0, format_1.percForm)(pnlPercent)})`)));
+    }
+    contentChildren.push((0, h_1.h)("div", {
+        style: {
+            display: "flex",
+            flexDirection: "column",
+            marginBottom: 16,
+        },
+    }, ...pnlChildren));
+    // Date / Entry / Payout row
+    const infoItems = [
+        (0, h_1.h)("div", { style: { display: "flex", flexDirection: "column" } }, (0, h_1.h)("div", {
+            style: {
+                fontSize: 17,
+                color: textSecondary,
+                marginBottom: 4,
+                display: "flex",
+            },
+        }, "Date"), (0, h_1.h)("div", {
+            style: {
+                fontSize: 28,
+                fontWeight: 700,
+                color: textPrimary,
+                display: "flex",
+            },
+        }, closingPriceDate)),
+    ];
+    if (!hideAmounts) {
+        infoItems.push((0, h_1.h)("div", { style: { display: "flex", flexDirection: "column" } }, (0, h_1.h)("div", {
+            style: {
+                fontSize: 17,
+                color: textSecondary,
+                marginBottom: 4,
+                display: "flex",
+            },
+        }, "Entry"), (0, h_1.h)("div", {
+            style: {
+                fontSize: 28,
+                fontWeight: 700,
+                color: textPrimary,
+                display: "flex",
+            },
+        }, isOpen ? (0, format_1.formatUSDC)(currentCost) : (0, format_1.formatUSDC)(totalCosts))));
+        infoItems.push((0, h_1.h)("div", { style: { display: "flex", flexDirection: "column" } }, (0, h_1.h)("div", {
+            style: {
+                fontSize: 17,
+                color: textSecondary,
+                marginBottom: 4,
+                display: "flex",
+            },
+        }, payoutLabel), (0, h_1.h)("div", {
+            style: {
+                fontSize: 28,
+                fontWeight: 700,
+                color: textPrimary,
+                display: "flex",
+            },
+        }, payoutDisplayValue)));
+    }
+    contentChildren.push((0, h_1.h)("div", { style: { display: "flex", gap: 48, marginBottom: 12 } }, ...infoItems));
+    // Owner
+    if (!hideWallet && owner) {
+        contentChildren.push((0, h_1.h)("div", {
+            style: {
+                display: "flex",
+                flexDirection: "column",
+                marginBottom: 8,
+            },
+        }, (0, h_1.h)("div", {
+            style: {
+                fontSize: 17,
+                color: textSecondary,
+                marginBottom: 4,
+                display: "flex",
+            },
+        }, "Owner"), (0, h_1.h)("div", {
+            style: {
+                fontSize: 22,
+                fontWeight: 700,
+                color: textPrimary,
+                display: "flex",
+            },
+        }, owner.slice(0, 7))));
+    }
+    // Spacer
+    contentChildren.push((0, h_1.h)("div", { style: { flex: 1, display: "flex" } }));
+    // Footer
+    contentChildren.push((0, h_1.h)("div", {
+        style: {
+            display: "flex",
+            justifyContent: "space-between",
+            alignItems: "flex-end",
+        },
+    }, (0, h_1.h)("div", { style: { display: "flex", flexDirection: "column" } }, (0, h_1.h)("span", {
+        style: { fontSize: 17, color: textMuted, display: "flex" },
+    }, "@signalswtf"), (0, h_1.h)("span", {
+        style: { fontSize: 17, color: textMuted, display: "flex" },
+    }, "Range-Based Bitcoin Price Prediction Market")), (0, h_1.h)("span", {
+        style: { fontSize: 17, color: textMuted, display: "flex" },
+    }, `#${positionId}`)));
+    children.push((0, h_1.h)("div", {
+        style: {
+            display: "flex",
+            flexDirection: "column",
+            position: "relative",
+            width: "100%",
+            height: "100%",
+            padding: "32px 40px 28px",
+        },
+    }, ...contentChildren));
+    return (0, h_1.h)("div", {
+        style: {
+            width: 1200,
+            height: 630,
+            display: "flex",
+            fontFamily: "Inter",
+            position: "relative",
+            overflow: "hidden",
+        },
+    }, ...children);
+}

package/dist/share/types.d.ts

@@ -0,0 +1,39 @@
+export interface SatoriNode {
+    type: string;
+    props: Record<string, unknown>;
+}
+export interface PositionImageInput {
+    positionId: number;
+    lowerTick: number;
+    upperTick: number;
+    currentQuantity: string;
+    currentCost: string;
+    totalQuantityBought: string;
+    totalCosts: string;
+    totalProceeds: string;
+    outcome: string;
+    closingPriceDate: string;
+    isSettled: boolean;
+    settlementTick: number | null;
+    owner: string;
+    theme: "light" | "dark";
+    hideWallet: boolean;
+    hideAmounts: boolean;
+    /** Current position value in USDC (NOT raw). null = use max payout fallback. */
+    currentValue: number | null;
+}
+export type BarCategory = "peak" | "high" | "mid" | "low";
+export interface PriceTick {
+    tick: number;
+    factor: bigint;
+    price: number;
+    probability: number;
+}
+export interface DistributionImageInput {
+    distribution: PriceTick[];
+    minTick: number;
+    maxTick: number;
+    tickSpacing: number;
+    closingPriceDate: string;
+    currentPrice?: number;
+}

package/dist/share/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types.d.ts

@@ -24,6 +24,7 @@ export interface MarketRaw {
     minTick: number;
     maxTick: number;
     tickSpacing: number;
+    endTimestamp?: number | string;
     feePolicyDescriptor?: string;
     isSettled?: boolean;
     settlementValue?: string;
@@ -35,6 +36,7 @@ export interface Market {
     minTick: Tick;
     maxTick: Tick;
     tickSpacing: Tick;
+    endTimestamp?: number;
     feePolicyDescriptor?: string;
     isSettled?: boolean;
     settlementValue?: USDCAmount;
@@ -61,6 +63,7 @@ export declare const FeePolicyKind: {
     readonly Null: "null";
     readonly Percentage: "percentage";
     readonly Custom: "custom";
+    readonly ThetaTime: "theta-time";
 };
 export type FeePolicyKind = (typeof FeePolicyKind)[keyof typeof FeePolicyKind];
 interface BaseFeeInfo {
@@ -78,7 +81,14 @@ interface PercentageFeeInfo extends BaseFeeInfo {
 interface CustomFeeInfo extends BaseFeeInfo {
     policy: typeof FeePolicyKind.Custom;
 }
-export type FeeInfo = NullFeeInfo | PercentageFeeInfo | CustomFeeInfo;
+interface ThetaTimeFeeInfo extends BaseFeeInfo {
+    policy: typeof FeePolicyKind.ThetaTime;
+    baseBps: Big;
+    thetaMaxBps: Big;
+    windowSec: Big;
+    beta: Big;
+}
+export type FeeInfo = NullFeeInfo | PercentageFeeInfo | CustomFeeInfo | ThetaTimeFeeInfo;
 /**
  * Convert raw GraphQL market data to SDK calculation format
  * @param raw Raw market data from GraphQL

package/dist/types.js

@@ -14,6 +14,7 @@ exports.FeePolicyKind = {
     Null: "null",
     Percentage: "percentage",
     Custom: "custom",
+    ThetaTime: "theta-time",
 };
 // ============================================================================
 // DATA ADAPTERS (GraphQL ↔ SDK 타입 변환)
@@ -29,6 +30,9 @@ function mapMarket(raw) {
         minTick: raw.minTick,
         maxTick: raw.maxTick,
         tickSpacing: raw.tickSpacing,
+        ...(raw.endTimestamp !== undefined && {
+            endTimestamp: Number(raw.endTimestamp),
+        }),
         ...(raw.feePolicyDescriptor !== undefined && {
             feePolicyDescriptor: raw.feePolicyDescriptor,
         }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signals-protocol/v1-sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Signals v1 SDK for CLMSR market calculations and utilities",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -9,7 +9,10 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "test": "jest",
+    "test:cov": "jest --coverage",
     "test:watch": "jest --watch",
+    "npm:auth": "node scripts/write-npmrc.js",
+    "publish:package": "NPM_CONFIG_USERCONFIG=.npmrc.auth npm publish",
     "lint": "eslint src/**/*.ts",
     "format": "prettier --write src/**/*.ts",
     "clean": "rm -rf dist",