@olane/o-node 0.7.12-alpha.39 → 0.7.12-alpha.40

package/dist/o-core/src/router/o-request-preparation.js

@@ -0,0 +1,75 @@
+import { oObject } from '../core/o-object.js';
+import { oRouterRequest } from './o-request.router.js';
+import { JSONRPC_VERSION, oProtocolMethods } from '@olane/o-protocol';
+/**
+ * Handles request transformation and preparation for routing.
+ * Manages payload wrapping/unwrapping, parameter merging, and request envelope handling.
+ */
+export class oRequestPreparation extends oObject {
+    /**
+     * Prepares a routing request by applying overrides and updating addresses.
+     * @param originalRequest The original router request
+     * @param requestOverride Optional request override from resolvers
+     * @param targetAddress The final target address
+     * @returns The prepared routing request
+     */
+    prepareRequest(originalRequest, requestOverride, targetAddress) {
+        const finalRequest = requestOverride || originalRequest;
+        const req = new oRouterRequest({
+            method: finalRequest.method,
+            params: finalRequest.params,
+            id: finalRequest.id,
+            jsonrpc: JSONRPC_VERSION,
+            stream: originalRequest.stream,
+        });
+        // Update target address in request
+        if (finalRequest && targetAddress) {
+            finalRequest.params.address = targetAddress.toString();
+        }
+        return req;
+    }
+    /**
+     * Applies handshake-specific transformations to a request.
+     * @param request The routing request to modify
+     * @param requestOverride The request override from resolvers
+     */
+    applyHandshakeTransform(request, requestOverride) {
+        const params = request.params.payload.params;
+        const { method } = request.params.payload;
+        try {
+            if (requestOverride) {
+                // This is likely a method resolver, so we need to override the method
+                // Let's specify the method in the request params to optimize on context window
+                params.tool = request.params?.payload?.method;
+            }
+        }
+        catch (e) {
+            this.logger.error('Error assigning tool to handshake: ', e);
+        }
+        // Update the method to be the handshake
+        request.params.payload.method = oProtocolMethods.HANDSHAKE;
+        return request;
+    }
+    /**
+     * Merges parameters from original payload and resolver overrides.
+     * @param request The routing request to modify
+     * @param originalPayload The original request payload
+     */
+    applyParameterMerge(request, originalPayload) {
+        const params = request.params.payload.params;
+        request.params.payload.params = {
+            ...originalPayload.params, // initial params
+            ...params, // overloaded params
+        };
+        return request;
+    }
+    /**
+     * Checks if the request is a handshake request.
+     * @param method The method to check
+     * @param handshakeMethod The handshake method constant
+     * @returns True if this is a handshake request
+     */
+    isHandshakeRequest(method, handshakeMethod) {
+        return method === handshakeMethod;
+    }
+}

package/dist/o-core/src/router/o-request.router.d.ts

@@ -0,0 +1,18 @@
+import { oProtocolMethods, RequestId, oRouterRequestInterface, RequestParams, JSONRPC_VERSION } from '@olane/o-protocol';
+import { Stream } from '@olane/o-config';
+import { oRequest } from '../connection/o-request.js';
+export declare class oRouterRequest extends oRequest implements oRouterRequestInterface {
+    jsonrpc: typeof JSONRPC_VERSION;
+    method: oProtocolMethods.ROUTE;
+    stream?: Stream | undefined;
+    params: RequestParams & {
+        address: string;
+        payload: {
+            [key: string]: unknown;
+        };
+    };
+    constructor(config: oRouterRequestInterface & {
+        id: RequestId;
+    });
+}
+//# sourceMappingURL=o-request.router.d.ts.map

package/dist/o-core/src/router/o-request.router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-request.router.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/router/o-request.router.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,uBAAuB,EACvB,aAAa,EACb,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,qBAAa,cACX,SAAQ,QACR,YAAW,uBAAuB;IAElC,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,aAAa,GAAG;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YACP,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;gBACU,MAAM,EAAE,uBAAuB,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE;CAQhE"}

package/dist/o-core/src/router/o-request.router.js

@@ -0,0 +1,12 @@
+import { JSONRPC_VERSION, } from '@olane/o-protocol';
+import { oRequest } from '../connection/o-request.js';
+export class oRouterRequest extends oRequest {
+    constructor(config) {
+        super(config);
+        this.jsonrpc = JSONRPC_VERSION;
+        this.method = config.method;
+        this.params = config.params;
+        this.stream = config.stream;
+        this.id = config.id;
+    }
+}

package/dist/o-core/src/router/o-resolver-chain.d.ts

@@ -0,0 +1,32 @@
+import { oAddress } from './o-address.js';
+import { oAddressResolver } from './o-address-resolver.js';
+import { oObject } from '../core/o-object.js';
+import { RouteResponse } from './interfaces/route.response.js';
+import { ResolveRequest } from './interfaces/resolve.request.js';
+/**
+ * Manages a chain of address resolvers using the Chain of Responsibility pattern.
+ * Sequentially executes registered resolvers to transform addresses and routing requests.
+ */
+export declare class oResolverChain extends oObject {
+    private readonly resolvers;
+    /**
+     * Registers a resolver in the chain.
+     * @param resolver The resolver to add
+     * @param isPriority If true, adds to the front of the chain; otherwise appends to the end
+     */
+    addResolver(resolver: oAddressResolver, isPriority?: boolean): void;
+    /**
+     * Checks if any resolver in the chain supports the given address.
+     * @param address The address to check
+     * @returns True if at least one resolver supports this address
+     */
+    supportsAddress(address: oAddress): boolean;
+    /**
+     * Executes the resolver chain to transform an address and request.
+     * Each resolver in sequence can modify the nextHopAddress, targetAddress, and request.
+     * @param request The resolve request containing address, node, and optional request override
+     * @returns The final route response after all resolvers have executed
+     */
+    resolve(request: ResolveRequest): Promise<RouteResponse>;
+}
+//# sourceMappingURL=o-resolver-chain.d.ts.map

package/dist/o-core/src/router/o-resolver-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-resolver-chain.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/router/o-resolver-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,OAAO;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,GAAE,OAAe;IAQnE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAQ3C;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA+B/D"}

package/dist/o-core/src/router/o-resolver-chain.js

@@ -0,0 +1,62 @@
+import { oAddress } from './o-address.js';
+import { oObject } from '../core/o-object.js';
+/**
+ * Manages a chain of address resolvers using the Chain of Responsibility pattern.
+ * Sequentially executes registered resolvers to transform addresses and routing requests.
+ */
+export class oResolverChain extends oObject {
+    constructor() {
+        super(...arguments);
+        this.resolvers = [];
+    }
+    /**
+     * Registers a resolver in the chain.
+     * @param resolver The resolver to add
+     * @param isPriority If true, adds to the front of the chain; otherwise appends to the end
+     */
+    addResolver(resolver, isPriority = false) {
+        if (isPriority) {
+            this.resolvers.unshift(resolver);
+        }
+        else {
+            this.resolvers.push(resolver);
+        }
+    }
+    /**
+     * Checks if any resolver in the chain supports the given address.
+     * @param address The address to check
+     * @returns True if at least one resolver supports this address
+     */
+    supportsAddress(address) {
+        return this.resolvers.some((r) => address.transports.some((t) => {
+            return r.transportTypes.some((r) => r === t.type);
+        }));
+    }
+    /**
+     * Executes the resolver chain to transform an address and request.
+     * Each resolver in sequence can modify the nextHopAddress, targetAddress, and request.
+     * @param request The resolve request containing address, node, and optional request override
+     * @returns The final route response after all resolvers have executed
+     */
+    async resolve(request) {
+        let resolvedAddress = new oAddress(request.address.toString(), request.address.transports);
+        let targetAddress = resolvedAddress;
+        let requestOverride = request.request;
+        for (const resolver of this.resolvers) {
+            const { nextHopAddress, targetAddress: resolverTargetAddress, requestOverride: resolverRequestOverride, } = await resolver.resolve({
+                address: resolvedAddress,
+                targetAddress: targetAddress,
+                node: request.node,
+                request: requestOverride,
+            });
+            requestOverride = resolverRequestOverride || requestOverride;
+            targetAddress = resolverTargetAddress || targetAddress;
+            resolvedAddress = nextHopAddress;
+        }
+        return {
+            nextHopAddress: resolvedAddress,
+            targetAddress: targetAddress,
+            requestOverride: requestOverride,
+        };
+    }
+}

package/dist/o-core/src/router/o-router.d.ts

@@ -0,0 +1,19 @@
+import { oAddress } from './o-address.js';
+import { oObject } from '../core/o-object.js';
+import { oResolverChain } from './o-resolver-chain.js';
+import { oAddressResolver } from './o-address-resolver.js';
+import { oRequest } from '../connection/o-request.js';
+import type { oCore } from '../core/o-core.js';
+import { RouteResponse } from './interfaces/route.response.js';
+import { oRouterRequest } from './o-request.router.js';
+export declare abstract class oRouter extends oObject {
+    addressResolution: oResolverChain;
+    constructor();
+    abstract translate(addressWithLeaderTransports: oAddress, node: oCore): Promise<RouteResponse>;
+    abstract isInternal(addressWithLeaderTransports: oAddress, node: oCore): boolean;
+    abstract route(request: oRouterRequest, node: oCore): Promise<RouteResponse>;
+    protected abstract forward(address: oAddress, request: oRequest | oRouterRequest, node: oCore): Promise<any>;
+    addResolver(resolver: oAddressResolver, isPriority?: boolean): void;
+    supportsAddress(address: oAddress): boolean;
+}
+//# sourceMappingURL=o-router.d.ts.map

package/dist/o-core/src/router/o-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-router.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/router/o-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,8BAAsB,OAAQ,SAAQ,OAAO;IACpC,iBAAiB,EAAG,cAAc,CAAC;;IAQ1C,QAAQ,CAAC,SAAS,CAChB,2BAA2B,EAAE,QAAQ,EACrC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,aAAa,CAAC;IAGzB,QAAQ,CAAC,UAAU,CACjB,2BAA2B,EAAE,QAAQ,EACrC,IAAI,EAAE,KAAK,GACV,OAAO;IAKV,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC;IAG5E,SAAS,CAAC,QAAQ,CAAC,OAAO,CACxB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,QAAQ,GAAG,cAAc,EAClC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,GAAG,CAAC;IAEf,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,GAAE,OAAe,GAAG,IAAI;IAI1E,eAAe,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;CAG5C"}

package/dist/o-core/src/router/o-router.js

@@ -0,0 +1,14 @@
+import { oObject } from '../core/o-object.js';
+import { oResolverChain } from './o-resolver-chain.js';
+export class oRouter extends oObject {
+    constructor() {
+        super();
+        this.addressResolution = new oResolverChain();
+    }
+    addResolver(resolver, isPriority = false) {
+        this.addressResolution.addResolver(resolver, isPriority);
+    }
+    supportsAddress(address) {
+        return this.addressResolution.supportsAddress(address);
+    }
+}

package/dist/o-core/src/router/o-routing-policy.d.ts

@@ -0,0 +1,36 @@
+import { oAddress } from './o-address.js';
+import { oObject } from '../core/o-object.js';
+import type { oCore } from '../core/o-core.js';
+import { RouteResponse } from './interfaces/route.response.js';
+/**
+ * Provides routing policy decisions based on network topology and address characteristics.
+ * Determines whether addresses are internal/external, when to route to leaders, etc.
+ *
+ * This layer separates network topology awareness from address resolution logic,
+ * making routing decisions testable without network calls.
+ */
+export declare abstract class oRoutingPolicy extends oObject {
+    /**
+     * Determines if an address is internal to the current network/hierarchy.
+     * @param address The address to check
+     * @param node The current node context
+     * @returns True if the address is internal, false if external
+     */
+    abstract isInternalAddress(address: oAddress, node: oCore): boolean;
+    /**
+     * Determines if the given address points to the node itself.
+     * @param address The address to check
+     * @param node The current node context
+     * @returns True if this is a self-reference
+     */
+    isSelfAddress(address: oAddress, node: oCore): boolean;
+    /**
+     * Checks if an address should be routed to a leader node.
+     * Returns a RouteResponse if leader routing is required, null otherwise.
+     * @param address The address to evaluate
+     * @param node The current node context
+     * @returns RouteResponse for leader routing, or null if not applicable
+     */
+    abstract getExternalRoutingStrategy(address: oAddress, node: oCore): RouteResponse | null;
+}
+//# sourceMappingURL=o-routing-policy.d.ts.map

package/dist/o-core/src/router/o-routing-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-routing-policy.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/router/o-routing-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D;;;;;;GAMG;AACH,8BAAsB,cAAe,SAAQ,OAAO;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO;IAEnE;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO;IAItD;;;;;;OAMG;IACH,QAAQ,CAAC,0BAA0B,CACjC,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,GACV,aAAa,GAAG,IAAI;CACxB"}

package/dist/o-core/src/router/o-routing-policy.js

@@ -0,0 +1,19 @@
+import { oObject } from '../core/o-object.js';
+/**
+ * Provides routing policy decisions based on network topology and address characteristics.
+ * Determines whether addresses are internal/external, when to route to leaders, etc.
+ *
+ * This layer separates network topology awareness from address resolution logic,
+ * making routing decisions testable without network calls.
+ */
+export class oRoutingPolicy extends oObject {
+    /**
+     * Determines if the given address points to the node itself.
+     * @param address The address to check
+     * @param node The current node context
+     * @returns True if this is a self-reference
+     */
+    isSelfAddress(address, node) {
+        return node.address.equals(address);
+    }
+}

package/dist/o-core/src/transports/custom.transport.d.ts

@@ -0,0 +1,6 @@
+import { oTransport } from './o-transport.js';
+export declare class oCustomTransport extends oTransport {
+    constructor(value: string);
+    toString(): string;
+}
+//# sourceMappingURL=custom.transport.d.ts.map

package/dist/o-core/src/transports/custom.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.transport.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/transports/custom.transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,KAAK,EAAE,MAAM;IAIzB,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/o-core/src/transports/custom.transport.js

@@ -0,0 +1,10 @@
+import { TransportType } from './interfaces/transport-type.enum.js';
+import { oTransport } from './o-transport.js';
+export class oCustomTransport extends oTransport {
+    constructor(value) {
+        super(value, TransportType.CUSTOM);
+    }
+    toString() {
+        return this.value.toString();
+    }
+}

package/dist/o-core/src/transports/index.d.ts

@@ -0,0 +1,4 @@
+export * from './o-transport.js';
+export * from './custom.transport.js';
+export * from './interfaces/transport-type.enum.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/o-core/src/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/transports/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC"}

package/dist/o-core/src/transports/index.js

@@ -0,0 +1,3 @@
+export * from './o-transport.js';
+export * from './custom.transport.js';
+export * from './interfaces/transport-type.enum.js';

package/dist/o-core/src/transports/interfaces/transport-type.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum TransportType {
+    LIBP2P = "libp2p",
+    CUSTOM = "custom"
+}
+//# sourceMappingURL=transport-type.enum.d.ts.map

package/dist/o-core/src/transports/interfaces/transport-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-type.enum.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/transports/interfaces/transport-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB"}

package/dist/o-core/src/transports/interfaces/transport-type.enum.js

@@ -0,0 +1,5 @@
+export var TransportType;
+(function (TransportType) {
+    TransportType["LIBP2P"] = "libp2p";
+    TransportType["CUSTOM"] = "custom";
+})(TransportType || (TransportType = {}));

package/dist/o-core/src/transports/o-transport.d.ts

@@ -0,0 +1,10 @@
+import { oObject } from '../core/o-object.js';
+import { TransportType } from './interfaces/transport-type.enum.js';
+export declare abstract class oTransport extends oObject {
+    readonly value: any;
+    readonly type: TransportType;
+    constructor(value: any, type?: TransportType);
+    abstract toString(): string;
+    toJSON(): any;
+}
+//# sourceMappingURL=o-transport.d.ts.map

package/dist/o-core/src/transports/o-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-transport.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/transports/o-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,8BAAsB,UAAW,SAAQ,OAAO;IAC9C,SAAgB,KAAK,EAAE,GAAG,CAAC;IAC3B,SAAgB,IAAI,EAAE,aAAa,CAAwB;gBAE/C,KAAK,EAAE,GAAG,EAAE,IAAI,GAAE,aAAoC;IAMlE,QAAQ,CAAC,QAAQ,IAAI,MAAM;IAE3B,MAAM,IAAI,GAAG;CAMd"}

package/dist/o-core/src/transports/o-transport.js

@@ -0,0 +1,16 @@
+import { oObject } from '../core/o-object.js';
+import { TransportType } from './interfaces/transport-type.enum.js';
+export class oTransport extends oObject {
+    constructor(value, type = TransportType.LIBP2P) {
+        super();
+        this.type = TransportType.LIBP2P;
+        this.value = value;
+        this.type = type;
+    }
+    toJSON() {
+        return {
+            value: this.value,
+            type: this.type,
+        };
+    }
+}

package/dist/o-core/src/utils/core.utils.d.ts

@@ -0,0 +1,34 @@
+import { Stream } from '@olane/o-config';
+import { oAddress } from '../router/o-address.js';
+import { oResponse } from '../connection/o-response.js';
+import { oRequest } from '../connection/o-request.js';
+import { CID } from 'multiformats';
+import { oObject } from '../core/o-object.js';
+export declare class CoreUtils extends oObject {
+    static generatePeerId(): Promise<any>;
+    static doHealthCheck(address: oAddress, node: any): Promise<boolean>;
+    static healthCheck(config: {
+        type?: 'leader' | 'parent' | 'child';
+        address?: oAddress;
+        node: any;
+        timeout?: number;
+    }): Promise<boolean>;
+    static generatePrivateKey(seed: string): Promise<any>;
+    /**
+     * Convert any user phrase to exactly 32 bytes for Ed25519 key generation.
+     * This function uses SHA-256 hashing to ensure:
+     * - Deterministic: Same phrase always produces same seed
+     * - Uniform distribution: Good entropy even for weak phrases
+     * - Exactly 32 bytes: Meets Ed25519 cryptographic requirements
+     */
+    static phraseToSeedBytes(phrase: string): Uint8Array;
+    static phraseToSeed(phrase: string): string;
+    static childAddress(parentAddress: oAddress, childAddress: oAddress): oAddress;
+    static sendResponse(response: oResponse, stream: Stream): Promise<void>;
+    static sendStreamResponse(response: oResponse, stream: Stream): Promise<void>;
+    static processStream(event: any): Promise<any>;
+    static processStreamRequest(event: any): Promise<oRequest>;
+    static processStreamResponse(event: any): Promise<oResponse>;
+    static toCID(data: any): Promise<CID>;
+}
+//# sourceMappingURL=core.utils.d.ts.map

package/dist/o-core/src/utils/core.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.utils.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/utils/core.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAGP,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,qBAAa,SAAU,SAAQ,OAAO;WACvB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC;IAK3C,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;WAkBvD,WAAW,CAAC,MAAM,EAAE;QAC/B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QACrC,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;WA4BP,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ3D;;;;;;OAMG;WACW,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;WAO7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAOpC,YAAY,CACxB,aAAa,EAAE,QAAQ,EACvB,YAAY,EAAE,QAAQ,GACrB,QAAQ;WAIS,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAahD,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAgBtD,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;WAMvC,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;WAKnD,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;WAOrD,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAMnD"}

package/dist/o-core/src/utils/core.utils.js

@@ -0,0 +1,123 @@
+import { generateKeyPairFromSeed, createEd25519PeerId, Uint8ArrayList, } from '@olane/o-config';
+import { createHash } from 'crypto';
+import { oAddress } from '../router/o-address.js';
+import { oResponse } from '../connection/o-response.js';
+import { oRequest } from '../connection/o-request.js';
+import { CID } from 'multiformats';
+import * as json from 'multiformats/codecs/json';
+import { sha256 } from 'multiformats/hashes/sha2';
+import { oObject } from '../core/o-object.js';
+export class CoreUtils extends oObject {
+    static async generatePeerId() {
+        const peerId = await createEd25519PeerId();
+        return peerId;
+    }
+    static doHealthCheck(address, node) {
+        return new Promise(async (resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error('Health check timed out'));
+            }, 30000); // 30 seconds
+            const response = await node.use(new oAddress(address.toString() + '/ping', address.transports));
+            clearTimeout(timer);
+            if (response.result.error) {
+                reject(new Error('Health check failed'));
+            }
+            else {
+                resolve(true);
+            }
+        });
+    }
+    static async healthCheck(config) {
+        if (!config.node) {
+            throw new Error('Node is required');
+        }
+        const { type, address, node } = config;
+        if (type === 'leader') {
+            return CoreUtils.doHealthCheck(node.leader, node);
+        }
+        else if (type === 'parent') {
+            return CoreUtils.doHealthCheck(node.parent, node);
+        }
+        else if (type === 'child') {
+            const children = node.hierarchyManager.getChildren();
+            return (await Promise.all(children.map((child) => CoreUtils.doHealthCheck(child, node)))).every((result) => result === true);
+        }
+        if (address) {
+            return CoreUtils.doHealthCheck(address, node);
+        }
+        throw new Error('Address is required');
+    }
+    static async generatePrivateKey(seed) {
+        // Convert any user phrase to exactly 32 bytes using SHA-256
+        const seedBytes = CoreUtils.phraseToSeedBytes(seed);
+        const privateKey = await generateKeyPairFromSeed('Ed25519', seedBytes);
+        return privateKey;
+    }
+    /**
+     * Convert any user phrase to exactly 32 bytes for Ed25519 key generation.
+     * This function uses SHA-256 hashing to ensure:
+     * - Deterministic: Same phrase always produces same seed
+     * - Uniform distribution: Good entropy even for weak phrases
+     * - Exactly 32 bytes: Meets Ed25519 cryptographic requirements
+     */
+    static phraseToSeedBytes(phrase) {
+        // Use SHA-256 to create a consistent 32-byte hash
+        const hash = createHash('sha256').update(phrase, 'utf8').digest();
+        return new Uint8Array(hash);
+    }
+    // Legacy utility function to convert any phrase into a 32-character hex string
+    static phraseToSeed(phrase) {
+        // Use SHA-256 to create a consistent 32-byte hash
+        const hash = createHash('sha256').update(phrase).digest('hex');
+        // Take the first 32 characters of the hex string
+        return hash.substring(0, 32);
+    }
+    static childAddress(parentAddress, childAddress) {
+        return new oAddress(parentAddress.toString() + '/' + childAddress.paths);
+    }
+    static async sendResponse(response, stream) {
+        if (stream.status !== 'open') {
+            return;
+        }
+        try {
+            await stream.send(new TextEncoder().encode(response.toString()));
+            await stream.close();
+        }
+        catch (error) {
+            console.error('Error sending response: ', error);
+        }
+    }
+    static async sendStreamResponse(response, stream) {
+        const utils = new CoreUtils();
+        if (!stream || stream.status !== 'open') {
+            utils.logger.warn('Stream is not open. Status: ' + stream?.status || 'undefined');
+            return;
+        }
+        try {
+            await stream.send(new TextEncoder().encode(response.toString()));
+        }
+        catch (error) {
+            utils.logger.error('Error sending stream response: ', error);
+        }
+    }
+    static async processStream(event) {
+        const bytes = event.data instanceof Uint8ArrayList ? event.data.subarray() : event.data;
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    static async processStreamRequest(event) {
+        const req = await CoreUtils.processStream(event);
+        return new oRequest(req);
+    }
+    static async processStreamResponse(event) {
+        const res = await CoreUtils.processStream(event);
+        return new oResponse({
+            ...res.result,
+        });
+    }
+    static async toCID(data) {
+        const bytes = json.encode(data);
+        const hash = await sha256.digest(bytes);
+        const cid = CID.create(1, json.code, hash);
+        return cid;
+    }
+}

package/dist/o-core/src/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './object.utils.js';
+export * from './regex.utils.js';
+export * from './remote.utils.js';
+export * from './logger.js';
+export * from './core.utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/o-core/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/o-core/src/utils/index.js

@@ -0,0 +1,5 @@
+export * from './object.utils.js';
+export * from './regex.utils.js';
+export * from './remote.utils.js';
+export * from './logger.js';
+export * from './core.utils.js';

package/dist/o-core/src/utils/logger.d.ts

@@ -0,0 +1,14 @@
+export declare class Logger {
+    private readonly name;
+    private log;
+    private suffix;
+    constructor(name: string);
+    setNamespace(name: string): void;
+    verbose(...args: any[]): void;
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    alert(...args: any[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/o-core/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/utils/logger.ts"],"names":[],"mappings":"AAGA,qBAAa,MAAM;IAIL,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAc;gBAEC,IAAI,EAAE,MAAM;IAKzC,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAItB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;CAGrB"}

package/dist/o-core/src/utils/logger.js

@@ -0,0 +1,31 @@
+import debug from 'debug';
+import chalk from 'chalk';
+export class Logger {
+    constructor(name) {
+        this.name = name;
+        this.suffix = '';
+        this.suffix = process.env.LOG_ID ? process.env.LOG_ID + ':' : '';
+        this.log = debug('olane-os:' + this.suffix + name);
+    }
+    setNamespace(name) {
+        this.log = debug('olane-os:' + this.suffix + name);
+    }
+    verbose(...args) {
+        this.log(chalk.gray('[VERBOSE]'), ...args);
+    }
+    debug(...args) {
+        this.log(chalk.blue('[DEBUG]'), ...args);
+    }
+    info(...args) {
+        this.log(chalk.green('[INFO]'), ...args);
+    }
+    warn(...args) {
+        this.log(chalk.yellow('[WARN]'), ...args);
+    }
+    error(...args) {
+        this.log(chalk.red('[ERROR]'), ...args);
+    }
+    alert(...args) {
+        this.log(chalk.redBright('[ALERT]'), ...args);
+    }
+}

package/dist/o-core/src/utils/object.utils.d.ts

@@ -0,0 +1,5 @@
+export declare class ObjectUtils {
+    static isObject(obj: any): boolean;
+    static allKeyValues(obj: any, callback: (key: string, value: any) => Promise<any>): Promise<any>;
+}
+//# sourceMappingURL=object.utils.d.ts.map