@olane/o-core 0.1.0 → 0.1.2

package/dist/core/core.node.d.ts

@@ -44,6 +44,13 @@ export declare abstract class oCoreNode {
         nextHopAddress: oAddress;
         targetAddress: oAddress;
     }>;
+    /**
+     * Use a tool explicitly
+     * @param addressWithLeaderTransports
+     * @param data
+     * @param config
+     * @returns
+     */
     use(addressWithLeaderTransports: oAddress, data: {
         method?: string;
         params?: {
@@ -55,7 +62,14 @@ export declare abstract class oCoreNode {
     register(): Promise<void>;
     connect(nextHopAddress: oAddress, targetAddress: oAddress): Promise<oConnection>;
     teardown(): Promise<void>;
+    /**
+     * Start the node
+     * @param parent - The parent node
+     */
     start(): Promise<void>;
+    /**
+     * Stop the node
+     */
     stop(): Promise<void>;
 }
 //# sourceMappingURL=core.node.d.ts.map

package/dist/core/core.node.d.ts.map

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

package/dist/core/core.node.js

@@ -6,25 +6,13 @@ import { NodeType } from './interfaces/node-type.enum';
 import { oAddressResolution } from './lib/o-address-resolution';
 import { oDependency } from './o-dependency';
 export class oCoreNode {
-    config;
-    p2pNode;
-    logger;
-    networkConfig;
-    address;
-    staticAddress;
-    peerId;
-    state = NodeState.STOPPED;
-    errors = [];
-    connectionManager;
-    leaders = [];
-    addressResolution;
-    description;
-    dependencies;
-    methods;
-    successCount = 0;
-    errorCount = 0;
     constructor(config) {
         this.config = config;
+        this.state = NodeState.STOPPED;
+        this.errors = [];
+        this.leaders = [];
+        this.successCount = 0;
+        this.errorCount = 0;
         this.logger = new Logger(this.constructor.name +
             (config.name ? `:${config.name}` : '') +
             ':' +
@@ -65,12 +53,17 @@ export class oCoreNode {
     }
     getTransports(address) {
         let leaderTransports = address.libp2pTransports;
+        // check if we already know where we want to go
         if (leaderTransports.length > 0) {
             return leaderTransports;
         }
+        // if leader transports are not provided, then we need to search for them
+        // Assume we are looking for a leader within our network for now
+        // TODO: we need to add some discovery managers that every node can use to find external network resources
         if (leaderTransports.length === 0) {
             this.logger.debug('No leader transports provided, we are going to search within our own network');
             if (!this.config.leader) {
+                // TODO: how do we handle when the node is the leader? // technically we are in the network
                 if (this.type === NodeType.LEADER) {
                     this.logger.debug('Node is a leader, using own transports');
                     leaderTransports = this.transports.map((t) => multiaddr(t));
@@ -90,7 +83,9 @@ export class oCoreNode {
     }
     async handleStaticAddressTranslation(addressInput) {
         let result = addressInput;
+        // handle static address translation
         if (result.value.indexOf('o://leader') === -1) {
+            // TODO: we need to be more dynamic around the o://leader prefix
             const response = await this.use(new oAddress('o://leader/register', result.transports), {
                 method: 'search',
                 params: { staticAddress: result.root },
@@ -99,13 +94,15 @@ export class oCoreNode {
             });
             const searchResults = response.result.data;
             if (searchResults.length > 0) {
+                // the root was found, let's add the rest of the path to the address
                 const remainderPaths = result.paths.split('/').slice(1);
-                let resolvedAddress = searchResults[0].address +
-                    (remainderPaths.length > 0 ? '/' + remainderPaths.join('/') : '');
+                const resolvedAddress = searchResults[0].address +
+                    (remainderPaths.length > 0 ? '/' + remainderPaths.join('/') : ''); // TODO: we need to handle this better
                 result = new oAddress(resolvedAddress, result.transports);
             }
             else {
                 this.logger.warn('Failed to translate static address');
+                // TODO: we need to handle this better
             }
         }
         return result;
@@ -113,6 +110,7 @@ export class oCoreNode {
     async translateAddress(addressWithLeaderTransports) {
         let targetAddress = addressWithLeaderTransports;
         let nextHopAddress = addressWithLeaderTransports;
+        // handle static address translation for search based upon base functionality
         targetAddress = await this.handleStaticAddressTranslation(targetAddress);
         nextHopAddress = await this.addressResolution.resolve(targetAddress);
         const leaderTransports = this.getTransports(nextHopAddress);
@@ -122,10 +120,18 @@ export class oCoreNode {
             targetAddress: targetAddress,
         };
     }
+    /**
+     * Use a tool explicitly
+     * @param addressWithLeaderTransports
+     * @param data
+     * @param config
+     * @returns
+     */
     async use(addressWithLeaderTransports, data, config = {}) {
         const { nextHopAddress, targetAddress } = await this.translateAddress(addressWithLeaderTransports);
         this.logger.debug('Using address: ', targetAddress.toString());
         const connection = await this.connect(nextHopAddress, targetAddress);
+        // communicate the payload to the target node
         const response = await connection.send({
             address: targetAddress?.toString() || '',
             payload: data,
@@ -134,9 +140,11 @@ export class oCoreNode {
     }
     async advertiseToNetwork() {
         this.logger.debug('Advertising to network our static and absolute addresses...');
+        // advertise the absolute address to the network with timeout
         const absoluteAddressCid = await this.address.toCID();
         this.logger.debug('Advertising absolute address: ', absoluteAddressCid);
         try {
+            // Add timeout to prevent hanging
             const providePromise = this.p2pNode.services.dht.provide(absoluteAddressCid);
             const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Advertise Content routing provide timeout')), 5000));
             await Promise.race([providePromise, timeoutPromise]);
@@ -145,9 +153,11 @@ export class oCoreNode {
         catch (error) {
             this.logger.warn('Failed to advertise absolute address (this is normal for isolated nodes):', error.message);
         }
+        // advertise the static address to the network with timeout
         const staticAddressCid = await this.staticAddress.toCID();
         this.logger.debug('Advertising static address: ', staticAddressCid);
         try {
+            // Add timeout to prevent hanging
             const providePromise = this.p2pNode.services.dht.provide(staticAddressCid);
             const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Content routing provide timeout')), 5000));
             await Promise.race([providePromise, timeoutPromise]);
@@ -158,9 +168,14 @@ export class oCoreNode {
         }
     }
     async connectToParent() {
+        // ensure we have modified the address to be a child address if the parent address is provided
         if (this.parent) {
             this.logger.debug('Connecting to parent: ' + this.parent.toString());
             await this.connect(this.parent, this.parent);
+            // this.address = CoreUtils.childAddress(this.parentAddress, this.address);
+            // await new Promise((resolve) => setTimeout(resolve, 1_000));
+            // this.logger.debug('Modified address to: ' + this.address.toString());
+            // TODO: let's ask the parent to route us to the leader
             this.logger.debug('Successfully connected to parent');
         }
         else {
@@ -173,7 +188,9 @@ export class oCoreNode {
             return;
         }
         this.logger.debug('Registering node...');
+        // connect to the parent node to establish identity
         await this.connectToParent();
+        // register with the leader global registry
         if (!this.config.leader) {
             this.logger.warn('No leaders found, skipping registration');
             return;
@@ -192,6 +209,7 @@ export class oCoreNode {
         await this.use(address, params, {
             noIndex: true,
         });
+        // TODO: handle the response from the leader
     }
     async connect(nextHopAddress, targetAddress) {
         if (!this.connectionManager) {
@@ -205,6 +223,7 @@ export class oCoreNode {
             callerAddress: this.address,
         })
             .catch((error) => {
+            // TODO: we need to handle this better and document
             if (error.message === 'Can not dial self') {
                 this.logger.error('Make sure you are entering the network not directly through the leader node.');
             }
@@ -222,6 +241,10 @@ export class oCoreNode {
             await this.p2pNode.stop();
         }
     }
+    /**
+     * Start the node
+     * @param parent - The parent node
+     */
     async start() {
         if (this.state !== NodeState.STOPPED) {
             this.logger.warn('Node is not stopped, skipping start');
@@ -244,6 +267,9 @@ export class oCoreNode {
             await this.teardown();
         }
     }
+    /**
+     * Stop the node
+     */
     async stop() {
         this.logger.debug('Stop node called...');
         this.state = NodeState.STOPPING;
@@ -259,4 +285,3 @@ export class oCoreNode {
         }
     }
 }
-//# sourceMappingURL=core.node.js.map

package/dist/core/defaults/config.js

@@ -3,4 +3,3 @@ import os from 'os';
 export const DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.olane');
 export const DEFAULT_NETWORKS_PATH = path.join(DEFAULT_CONFIG_PATH, 'networks');
 export const DEFAULT_CONFIG_FILE = path.join(DEFAULT_CONFIG_PATH, 'config.json');
-//# sourceMappingURL=config.js.map

package/dist/core/defaults/index.js

@@ -1,2 +1 @@
 export * from './config';
-//# sourceMappingURL=index.js.map

package/dist/core/graceful-shutdown.d.ts

@@ -0,0 +1,25 @@
+import { Logger } from './utils';
+export interface CleanupFunction {
+    (): Promise<void> | void;
+}
+export interface GracefulShutdownOptions {
+    timeout?: number;
+    logger?: Logger;
+    onTimeout?: () => void;
+}
+/**
+ * Sets up signal handlers for graceful shutdown
+ * @param cleanup Cleanup function to run on shutdown
+ * @param options Configuration options for graceful shutdown
+ */
+export declare function setupGracefulShutdown(cleanup: CleanupFunction, options?: GracefulShutdownOptions): void;
+/**
+ * Creates a cleanup function that stops multiple resources
+ * @param resources Array of resources with stop methods
+ * @param logger Logger instance for logging
+ */
+export declare function createMultiResourceCleanup(resources: Array<{
+    stop(): Promise<void> | void;
+    address?: string;
+}>, logger?: Logger): CleanupFunction;
+//# sourceMappingURL=graceful-shutdown.d.ts.map

package/dist/core/graceful-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../../src/core/graceful-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,WAAW,eAAe;IAC9B,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,uBAA4B,GACpC,IAAI,CAmEN;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACpE,MAAM,GAAE,MAA2C,GAClD,eAAe,CAmBjB"}

package/dist/core/graceful-shutdown.js

@@ -0,0 +1,84 @@
+import { Logger } from './utils';
+/**
+ * Sets up signal handlers for graceful shutdown
+ * @param cleanup Cleanup function to run on shutdown
+ * @param options Configuration options for graceful shutdown
+ */
+export function setupGracefulShutdown(cleanup, options = {}) {
+    const { timeout = 30000, // 30 seconds default timeout
+    logger = new Logger('GracefulShutdown'), onTimeout, } = options;
+    let isShuttingDown = false;
+    const performCleanup = async (signal) => {
+        if (isShuttingDown) {
+            logger.debug('Shutdown already in progress, skipping...');
+            return;
+        }
+        isShuttingDown = true;
+        logger.info(`Received ${signal}, initiating graceful shutdown...`);
+        try {
+            // Set up timeout for cleanup operations
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`Cleanup timeout after ${timeout}ms`));
+                }, timeout);
+            });
+            // Perform cleanup with timeout
+            await Promise.race([Promise.resolve(cleanup()), timeoutPromise]);
+            logger.info('Graceful shutdown completed successfully');
+        }
+        catch (error) {
+            logger.error('Error during graceful shutdown:', error);
+            if (onTimeout) {
+                onTimeout();
+            }
+        }
+        finally {
+            logger.info('Process exiting');
+            process.exit(0);
+        }
+    };
+    // Handle SIGINT (Ctrl+C)
+    process.on('SIGINT', () => performCleanup('SIGINT'));
+    // Handle SIGTERM (termination signal)
+    process.on('SIGTERM', () => performCleanup('SIGTERM'));
+    // Handle SIGUSR2 (Node.js restart signal)
+    process.on('SIGUSR2', () => performCleanup('SIGUSR2'));
+    // Handle uncaught exceptions
+    process.on('uncaughtException', (error) => {
+        logger.error('Uncaught Exception:', error);
+        performCleanup('uncaughtException');
+    });
+    // Handle unhandled promise rejections
+    process.on('unhandledRejection', (reason, promise) => {
+        logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
+        performCleanup('unhandledRejection');
+    });
+    // Handle process exit (synchronous cleanup)
+    process.on('exit', (code) => {
+        logger.info(`Process exiting with code: ${code}`);
+    });
+}
+/**
+ * Creates a cleanup function that stops multiple resources
+ * @param resources Array of resources with stop methods
+ * @param logger Logger instance for logging
+ */
+export function createMultiResourceCleanup(resources, logger = new Logger('MultiResourceCleanup')) {
+    return async () => {
+        logger.info(`Stopping ${resources.length} resources...`);
+        const stopPromises = resources.map(async (resource) => {
+            try {
+                const resourceName = resource.address || resource.constructor.name;
+                logger.debug(`Stopping resource: ${resourceName}`);
+                await Promise.resolve(resource.stop());
+                logger.debug(`Successfully stopped resource: ${resourceName}`);
+            }
+            catch (error) {
+                const resourceName = resource.address || resource.constructor.name;
+                logger.error(`Error stopping resource ${resourceName}:`, error);
+            }
+        });
+        await Promise.allSettled(stopPromises);
+        logger.info('All resources stopped');
+    };
+}

package/dist/core/index.d.ts

@@ -7,4 +7,5 @@ export * from './utils/logger';
 export * from './lib';
 export * from './o-parameter';
 export * from './defaults';
+export * from './graceful-shutdown';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -7,4 +7,4 @@ export * from './utils/logger';
 export * from './lib';
 export * from './o-parameter';
 export * from './defaults';
-//# sourceMappingURL=index.js.map
+export * from './graceful-shutdown';

package/dist/core/interfaces/connection-manager.config.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=connection-manager.config.js.map

package/dist/core/interfaces/connection-send-params.interface.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=connection-send-params.interface.js.map

package/dist/core/interfaces/core-config.interface.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=core-config.interface.js.map

package/dist/core/interfaces/index.js

@@ -3,4 +3,3 @@ export * from './node-type.enum';
 export * from './restricted-addresses.enum';
 export * from './state.enum';
 export * from './use-options.interface';
-//# sourceMappingURL=index.js.map

package/dist/core/interfaces/node-type.enum.js

@@ -8,4 +8,3 @@ export var NodeType;
     NodeType["HUMAN"] = "human";
     NodeType["UNKNOWN"] = "unknown";
 })(NodeType || (NodeType = {}));
-//# sourceMappingURL=node-type.enum.js.map

package/dist/core/interfaces/restricted-addresses.enum.js

@@ -16,4 +16,3 @@ export const RestrictedAddressesList = [
     TOOL_ADRESS,
     AGENT_ADRESS,
 ];
-//# sourceMappingURL=restricted-addresses.enum.js.map

package/dist/core/interfaces/state.enum.js

@@ -6,4 +6,3 @@ export var NodeState;
     NodeState["STOPPED"] = "STOPPED";
     NodeState["ERROR"] = "ERROR";
 })(NodeState || (NodeState = {}));
-//# sourceMappingURL=state.enum.js.map

package/dist/core/interfaces/use-options.interface.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=use-options.interface.js.map

package/dist/core/lib/index.js

@@ -5,4 +5,3 @@ export * from './o-connection-manager';
 export * from './o-address-resolution';
 export * from './o-address-resolver';
 export * from './resolvers';
-//# sourceMappingURL=index.js.map

package/dist/core/lib/o-address-resolution.js

@@ -1,6 +1,8 @@
 import { oAddress } from '../o-address';
 export class oAddressResolution {
-    resolvers = [];
+    constructor() {
+        this.resolvers = [];
+    }
     addResolver(resolver) {
         this.resolvers.push(resolver);
     }
@@ -14,7 +16,10 @@ export class oAddressResolution {
         for (const resolver of this.resolvers) {
             resolvedAddress = await resolver.resolve(resolvedAddress);
         }
+        // // ensure we have the transports from the original address
+        // if (address.transports.length > 0) {
+        //   resolvedAddress.setTransports(address.transports as Multiaddr[]);
+        // }
         return resolvedAddress;
     }
 }
-//# sourceMappingURL=o-address-resolution.js.map

package/dist/core/lib/o-address-resolver.js

@@ -1,9 +1,6 @@
 import { Logger } from '../';
 import { oAddress } from '../o-address';
 export class oAddressResolver {
-    address;
-    p2pNode;
-    logger;
     constructor(address, p2pNode) {
         this.address = address;
         this.p2pNode = p2pNode;
@@ -22,8 +19,10 @@ export class oAddressResolver {
         return targetAddress.toString()?.includes('o://leader') === false;
     }
     determineNextHopAddress(targetAddress) {
+        // do we have to start at the root leader or continue forward?
         const startAtLeader = targetAddress.protocol?.includes(this.address.protocol) === false;
         const prefix = startAtLeader ? 'o://' : this.address.value + '/';
+        // determine the next hop
         const remainingPath = startAtLeader
             ? targetAddress.protocol
             : targetAddress.protocol.replace(this.address.protocol + '/', '');
@@ -35,4 +34,3 @@ export class oAddressResolver {
         return address;
     }
 }
-//# sourceMappingURL=o-address-resolver.js.map

package/dist/core/lib/o-connection-manager.d.ts

@@ -6,6 +6,11 @@ export declare class oConnectionManager {
     private logger;
     private p2pNode;
     constructor(config: oConnectionManagerConfig);
+    /**
+     * Connect to a given address
+     * @param address - The address to connect to
+     * @returns The connection object
+     */
     connect(config: {
         address: oAddress;
         nextHopAddress: oAddress;

package/dist/core/lib/o-connection-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-connection-manager.d.ts","sourceRoot":"","sources":["../../../src/core/lib/o-connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAGnF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,wBAAwB;IAUtC,OAAO,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,QAAQ,CAAC;QAClB,cAAc,EAAE,QAAQ,CAAC;QACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;KAC1B,GAAG,OAAO,CAAC,WAAW,CAAC;IAqCxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAe3D"}
+{"version":3,"file":"o-connection-manager.d.ts","sourceRoot":"","sources":["../../../src/core/lib/o-connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAGnF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,wBAAwB;IAK5C;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,QAAQ,CAAC;QAClB,cAAc,EAAE,QAAQ,CAAC;QACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;KAC1B,GAAG,OAAO,CAAC,WAAW,CAAC;IAqCxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAe3D"}

package/dist/core/lib/o-connection-manager.js

@@ -1,14 +1,32 @@
 import { oConnection } from './o-connection';
 export class oConnectionManager {
-    cache = new Map();
-    logger;
-    p2pNode;
     constructor(config) {
+        this.cache = new Map();
         this.logger = config.logger;
         this.p2pNode = config.p2pNode;
     }
+    /**
+     * Connect to a given address
+     * @param address - The address to connect to
+     * @returns The connection object
+     */
     async connect(config) {
         const { address, nextHopAddress, callerAddress } = config;
+        // check if we already have a connection to this address
+        // TODO: how can we enable caching of connections & connection lifecycles
+        // if (this.isCached(nextHopAddress)) {
+        //   const cachedConnection = this.getCachedConnection(nextHopAddress);
+        //   if (cachedConnection) {
+        //     this.logger.debug(
+        //       'Using cached connection for address: ' + address.toString(),
+        //     );
+        //     return cachedConnection;
+        //   } else {
+        //     // cached item is not valid, remove it
+        //     this.cache.delete(nextHopAddress.toString());
+        //   }
+        // }
+        // first time setup connection
         try {
             const p2pConnection = await this.p2pNode.dial(nextHopAddress.libp2pTransports);
             const connection = new oConnection({
@@ -17,6 +35,7 @@ export class oConnectionManager {
                 p2pConnection: p2pConnection,
                 callerAddress: callerAddress,
             });
+            // this.cache.set(address.toString(), connection);
             return connection;
         }
         catch (error) {
@@ -44,4 +63,3 @@ export class oConnectionManager {
         return null;
     }
 }
-//# sourceMappingURL=o-connection-manager.js.map

package/dist/core/lib/o-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/core/lib/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiC,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAEtF,qBAAa,WAAW;IASpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAW;IAC1C,OAAO,CAAC,cAAc,CAAa;gBAGhB,MAAM,EAAE;QACvB,cAAc,EAAE,QAAQ,CAAC;QACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;QACzB,OAAO,EAAE,QAAQ,CAAC;QAClB,aAAa,EAAE,UAAU,CAAC;KAC3B;IAgBG,IAAI,CAAC,MAAM,KAAA;IAUjB,QAAQ;IAOR,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAyB/D,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAqB/C,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAMpD,KAAK;CAKZ"}
+{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/core/lib/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiC,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAEtF,qBAAa,WAAW;IASpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAW;IAC1C,OAAO,CAAC,cAAc,CAAa;gBAGhB,MAAM,EAAE;QACvB,cAAc,EAAE,QAAQ,CAAC;QACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;QACzB,OAAO,EAAE,QAAQ,CAAC;QAClB,aAAa,EAAE,UAAU,CAAC;KAC3B;IAgBG,IAAI,CAAC,MAAM,EAAE,GAAG;IAUtB,QAAQ;IAOR,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAyB/D,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAqB/C,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAMpD,KAAK;CAKZ"}

package/dist/core/lib/o-connection.js

@@ -5,15 +5,9 @@ import { oRequest } from './o-request';
 import { oProtocolMethods } from '@olane/o-protocol';
 import { oResponse } from './o-response';
 export class oConnection {
-    config;
-    id;
-    logger;
-    p2pConnection;
-    address;
-    nextHopAddress;
-    requestCounter = 0;
     constructor(config) {
         this.config = config;
+        this.requestCounter = 0;
         this.id = uuidv4();
         this.address = config.address;
         this.nextHopAddress = config.nextHopAddress;
@@ -37,6 +31,7 @@ export class oConnection {
         if (this.config.p2pConnection.status !== 'open') {
             throw new Error('Connection is not valid');
         }
+        // do nothing
     }
     createRequest(method, params) {
         return new oRequest({
@@ -49,19 +44,35 @@ export class oConnection {
             id: this.requestCounter++,
         });
     }
+    // async start() {
+    //   this.logger.debug('Starting handshake, address: ' + this.address.value);
+    //   const params = this.createRequest(oProtocolMethods.ROUTE, {
+    //     address: this.address.value,
+    //     payload: {
+    //       method: oProtocolMethods.HANDSHAKE,
+    //       params: {},
+    //     },
+    //   });
+    //   const request = new oRequest(params);
+    //   return this.transmit(request);
+    // }
     async transmit(request) {
         const stream = await this.p2pConnection.newStream(this.nextHopAddress.protocol);
+        // Create a pushable stream
         const pushableStream = pushable();
         pushableStream.push(new TextEncoder().encode(request.toString()));
         pushableStream.end();
+        // Send the data
         await stream.sink(pushableStream);
         const res = await this.read(stream.source);
+        // process the response
         const response = new oResponse({
             ...res.result,
         });
         return response;
     }
     async send(data) {
+        // proxy through the router tool
         const request = this.createRequest(oProtocolMethods.ROUTE, data);
         return this.transmit(request);
     }
@@ -71,4 +82,3 @@ export class oConnection {
         this.logger.debug('Connection closed');
     }
 }
-//# sourceMappingURL=o-connection.js.map

package/dist/core/lib/o-request.js

@@ -1,9 +1,5 @@
 import { JSONRPC_VERSION, } from '@olane/o-protocol';
 export class oRequest {
-    jsonrpc;
-    method;
-    params;
-    id;
     constructor(config) {
         this.jsonrpc = JSONRPC_VERSION;
         this.method = config.method;
@@ -28,4 +24,3 @@ export class oRequest {
         return new oRequest(json);
     }
 }
-//# sourceMappingURL=o-request.js.map

package/dist/core/lib/o-response.js

@@ -1,8 +1,5 @@
 import { JSONRPC_VERSION, } from '@olane/o-protocol';
 export class oResponse {
-    jsonrpc;
-    id;
-    result;
     constructor(config) {
         this.jsonrpc = JSONRPC_VERSION;
         this.id = config.id;
@@ -19,4 +16,3 @@ export class oResponse {
         return JSON.stringify(this);
     }
 }
-//# sourceMappingURL=o-response.js.map

package/dist/core/lib/resolvers/anything.resolver.js

@@ -6,8 +6,9 @@ export class oAnythingResolver extends oAddressResolver {
     }
     async resolve(address, node) {
         const nextHopAddress = this.determineNextHopAddress(address);
+        // at this point, the next-hop resolver did not work so we can trust that the
+        // next hop should be contained within the current node as an abstraction
         this.logger.debug('Resolving anything address: ', address);
         return new oAddress(nextHopAddress.toString(), (address.transports || []).concat(this.transports));
     }
 }
-//# sourceMappingURL=anything.resolver.js.map