@totemsdk/omnia-host 0.7.0 → 0.8.0

package/dist/api/methods.d.ts

@@ -34,4 +34,9 @@ export interface HostApiContext {
     /** Boot-time signed EdgeServiceManifest. */
     manifest?: unknown;
 }
+/**
+ * CAN-006: a fully serializable channel-state view so RPC/HTTP consumers can
+ * read everything they need without reaching into `getStore()`/`getMethods()`.
+ */
+export declare function channelStateView(channel: OmniaChannel): Record<string, unknown>;
 export declare function createHostMethods(context: HostApiContext): Map<string, JsonRpcHandler>;

package/dist/api/methods.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.channelStateView = channelStateView;
 exports.createHostMethods = createHostMethods;
 const omnia_1 = require("@totemsdk/omnia");
 const omnia_router_1 = require("@totemsdk/omnia-router");
@@ -17,6 +18,57 @@ function channelSummary(channel) {
         currentSequence: channel.currentSequence,
     };
 }
+/** Recursively JSON-safe: bigint → decimal string, bytes → 0x-hex. */
+function jsonSafe(value) {
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (value instanceof Uint8Array)
+        return `0x${Buffer.from(value).toString('hex')}`;
+    if (Array.isArray(value))
+        return value.map(jsonSafe);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [key, val] of Object.entries(value))
+            out[key] = jsonSafe(val);
+        return out;
+    }
+    return value;
+}
+/**
+ * CAN-006: a fully serializable channel-state view so RPC/HTTP consumers can
+ * read everything they need without reaching into `getStore()`/`getMethods()`.
+ */
+function channelStateView(channel) {
+    return jsonSafe({
+        channelId: channel.channelId,
+        status: channel.status,
+        channelType: channel.channelType,
+        tokenId: channel.tokenId,
+        tokenScale: channel.tokenScale ?? 0,
+        totalValue: channel.totalValue,
+        currentSequence: channel.currentSequence,
+        fundingAddress: channel.fundingAddress,
+        fundingTxId: channel.fundingTxId,
+        fundingCoinId: channel.fundingCoinId,
+        parties: channel.parties,
+        balances: channel.balances,
+        pendingHTLCs: channel.pendingHTLCs,
+        latestState: channel.latestState
+            ? {
+                sequence: channel.latestState.sequence,
+                balances: channel.latestState.balances,
+                pendingHTLCs: channel.latestState.pendingHTLCs?.length ?? 0,
+                stateVariables: channel.latestState.stateVariables,
+                transactionHex: channel.latestState.transactionHex,
+                signatures: Object.keys(channel.latestState.signatures ?? {}),
+                signingIndices: channel.latestState.signingIndices,
+            }
+            : null,
+        stateLogLength: channel.stateLog?.length ?? 0,
+        createdAt: channel.createdAt,
+        updatedAt: channel.updatedAt,
+    });
+}
 function paramsObject(params) {
     if (!params || typeof params !== 'object' || Array.isArray(params))
         return {};
@@ -149,6 +201,15 @@ function createHostMethods(context) {
         return { channels };
     };
     register('totem_omniaGetChannels', getChannels, 'omnia/getChannels');
+    const getChannelState = (raw) => {
+        const params = paramsObject(raw);
+        const channelId = requiredString(params, 'channelId');
+        const channel = context.channels.get(channelId);
+        if (!channel)
+            throw new Error(`Channel ${channelId} not found`);
+        return channelStateView(channel);
+    };
+    register('totem_omniaGetChannelState', getChannelState, 'omnia/getChannelState');
     const getRoute = async (raw) => {
         context.refreshRouting?.();
         const params = paramsObject(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totemsdk/omnia-host",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Durable Omnia node daemon for channel lifecycle, routing, and control APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,16 +23,16 @@
     "better-sqlite3": "^12.2.0",
     "ws": "^8.21.1",
     "@totemsdk/chain-provider": "^0.2.1",
+    "@totemsdk/identity": "^1.0.1",
     "@totemsdk/core": "^1.2.11",
     "@totemsdk/manifest": "^2.0.0",
     "@totemsdk/omnia": "^2.0.1",
-    "@totemsdk/identity": "^1.0.1",
-    "@totemsdk/omnia-router": "^0.3.0",
     "@totemsdk/omnia-factory": "^0.5.0",
-    "@totemsdk/omnia-vtxo": "^0.5.0",
+    "@totemsdk/omnia-router": "^0.3.0",
     "@totemsdk/omnia-splice": "^0.3.0",
-    "@totemsdk/storage": "^0.1.0",
+    "@totemsdk/omnia-vtxo": "^0.5.0",
     "@totemsdk/minima-rpc": "^0.2.2",
+    "@totemsdk/storage": "^0.1.0",
     "@totemsdk/wots-lease": "^1.0.1"
   },
   "devDependencies": {