clinch-core 0.1.0

package/dist/src/index.js

@@ -0,0 +1,247 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClinchCore = void 0;
+const events_1 = require("events");
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const js_sha256_1 = require("js-sha256");
+const ws_1 = __importDefault(require("ws"));
+// ============================================================================
+// CONFIGURATION & UTILS
+// ============================================================================
+const PROTOCOL_VERSION = "0.1.0";
+const FIREBASE_CONFIG_URL = "https://clinchprotocol.web.app/network-config.json";
+function toHex(arr) {
+    return Array.from(arr).map(b => b.toString(16).padStart(2, '0')).join('');
+}
+// ============================================================================
+// THE CLINCH CORE LIBRARY
+// ============================================================================
+class ClinchCore extends events_1.EventEmitter {
+    isInitialized = false;
+    config;
+    cachedRegistryUrl = null;
+    jwtToken = null;
+    // Agent Identity Keypair (Long-lived, used for Auth, NEVER for session messages)
+    identityPrivKey;
+    identityPubKey;
+    // Active Sessions & Ephemeral Keys
+    activeSessions = new Map();
+    ws = null;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+        // Generate Identity Key
+        const keyPair = tweetnacl_1.default.sign.keyPair();
+        this.identityPrivKey = keyPair.secretKey;
+        this.identityPubKey = toHex(keyPair.publicKey);
+        if (this.config.registryUrl) {
+            this.cachedRegistryUrl = this.config.registryUrl;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // INITIALIZATION & AUTH
+    // --------------------------------------------------------------------------
+    async initialize(cachedToken) {
+        if (this.isInitialized)
+            return;
+        try {
+            await this.getRegistryUrl();
+            if (cachedToken) {
+                this.jwtToken = cachedToken;
+                this.emit('log', "[Core] Restored session from cached JWT. Skipping PoW.");
+            }
+            else {
+                await this.registerNode();
+            }
+            await this.connectWebSocket();
+            this.isInitialized = true;
+            this.emit('initialized', { pubKey: this.identityPubKey, registry: this.cachedRegistryUrl });
+        }
+        catch (error) {
+            this.emit('error', error);
+            throw error;
+        }
+    }
+    async registerNode() {
+        this.emit('log', "[Core] No cached token found. Requesting PoW challenge...");
+        const challenge = await this.networkRequest('/api/auth/challenge', {}, false);
+        const powSolution = await this.solvePoW(challenge.nonce, challenge.difficulty);
+        const authRes = await this.networkRequest('/api/auth/verify', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                challenge_id: challenge.challenge_id,
+                pow_solution: powSolution,
+                pubKey: this.identityPubKey
+            })
+        }, false);
+        this.jwtToken = authRes.token;
+        this.emit('token_issued', { token: this.jwtToken });
+    }
+    async getRegistryUrl(forceRefresh = false) {
+        if (this.cachedRegistryUrl && !forceRefresh)
+            return this.cachedRegistryUrl;
+        const res = await fetch(FIREBASE_CONFIG_URL);
+        const text = await res.text();
+        try {
+            const config = JSON.parse(text);
+            this.cachedRegistryUrl = config.registry_nodes[PROTOCOL_VERSION];
+            return this.cachedRegistryUrl;
+        }
+        catch (err) {
+            throw new Error(`Failed to parse Firebase config.`);
+        }
+    }
+    async networkRequest(endpoint, options = {}, requireAuth = true) {
+        const baseUrl = await this.getRegistryUrl();
+        const headers = { ...options.headers };
+        if (requireAuth && this.jwtToken) {
+            headers['Authorization'] = `Bearer ${this.jwtToken}`;
+        }
+        const res = await fetch(`${baseUrl}${endpoint}`, { ...options, headers });
+        const text = await res.text();
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status} on ${endpoint}: ${text}`);
+        return JSON.parse(text);
+    }
+    // --------------------------------------------------------------------------
+    // WEBSOCKET CONNECTION
+    // --------------------------------------------------------------------------
+    async connectWebSocket() {
+        return new Promise((resolve, reject) => {
+            const wsUrl = this.cachedRegistryUrl.replace(/^http/, 'ws');
+            this.ws = new ws_1.default(wsUrl);
+            this.ws.on('open', () => {
+                this.ws.send(JSON.stringify({ type: 'AUTH', token: this.jwtToken }));
+            });
+            this.ws.on('message', (data) => {
+                const msg = JSON.parse(data.toString());
+                if (msg.type === 'AUTH_SUCCESS') {
+                    this.emit('log', '[Core] WebSocket authenticated & listening.');
+                    resolve();
+                }
+                if (msg.type === 'CALLBACK') {
+                    this.emit('callback_received', {
+                        sessionId: msg.session_id,
+                        payload: msg.payload
+                    });
+                    this.ws.send(JSON.stringify({ type: 'ACK', id: msg.id }));
+                }
+                if (msg.type === 'ERROR') {
+                    this.emit('error', new Error(msg.message));
+                }
+            });
+            this.ws.on('error', (err) => {
+                this.emit('error', err);
+                reject(err);
+            });
+            this.ws.on('close', () => {
+                this.emit('log', '[Core] WebSocket disconnected.');
+            });
+        });
+    }
+    disconnect() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // PROTOCOL OPERATIONS
+    // --------------------------------------------------------------------------
+    async search(query, mode) {
+        let url = `/api/discover?category=${encodeURIComponent(query)}`;
+        if (mode)
+            url += `&mode=${encodeURIComponent(mode)}`;
+        return await this.networkRequest(url);
+    }
+    async negotiate(address, constraints) {
+        const parsed = this.parseAddress(address);
+        const ephemeralKeys = tweetnacl_1.default.sign.keyPair();
+        const ephemeralPubHex = toHex(ephemeralKeys.publicKey);
+        const initPayload = {
+            clinch_version: PROTOCOL_VERSION,
+            mode: parsed.mode,
+            constraints,
+            session_pub_key: ephemeralPubHex,
+            timestamp_utc: new Date().toISOString()
+        };
+        const msgUint8 = new TextEncoder().encode(JSON.stringify(initPayload));
+        const signature = toHex(tweetnacl_1.default.sign.detached(msgUint8, ephemeralKeys.secretKey));
+        const signedPayload = { ...initPayload, sig: signature };
+        const response = await this.networkRequest(`/api/route/${parsed.domain}/handshake`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(signedPayload)
+        });
+        const sessionId = response.session_id;
+        this.activeSessions.set(sessionId, {
+            sessionId,
+            sellerId: parsed.domain,
+            keyPair: ephemeralKeys,
+            status: 'ACTIVE'
+        });
+        this.emit('session_started', { sessionId, sellerId: parsed.domain });
+        return sessionId;
+    }
+    async exitSession(sessionId) {
+        const session = this.activeSessions.get(sessionId);
+        if (!session)
+            throw new Error("Session not found or not active");
+        const res = await this.networkRequest(`/api/route/${sessionId}/exit`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ seller_id: session.sellerId })
+        });
+        session.status = 'EXITED';
+        session.exitTokenHash = res.token_hash;
+        this.emit('session_exited', { sessionId, token_hash: res.token_hash });
+        return res.token_hash;
+    }
+    // --------------------------------------------------------------------------
+    // UTILITIES
+    // --------------------------------------------------------------------------
+    parseAddress(address) {
+        const parts = address.split('.');
+        if (parts.length < 2)
+            throw new Error("Invalid Address Format. Expected MODE.DOMAIN.anp");
+        return {
+            mode: parts[0],
+            domain: parts.slice(1).join('.').toLowerCase(),
+            route: '/'
+        };
+    }
+    async solvePoW(nonce, difficultyBits) {
+        this.emit('pow_started', { difficulty: difficultyBits });
+        let counter = 0;
+        const CHUNK_SIZE = 5000;
+        while (true) {
+            for (let i = 0; i < CHUNK_SIZE; i++) {
+                const attempt = counter.toString();
+                const hashArray = js_sha256_1.sha256.create().update(nonce + this.identityPubKey + attempt).array();
+                if (this.hasLeadingZeroBits(hashArray, difficultyBits)) {
+                    this.emit('pow_solved', { attempts: counter });
+                    return attempt;
+                }
+                counter++;
+            }
+            await new Promise(resolve => setTimeout(resolve, 0));
+        }
+    }
+    hasLeadingZeroBits(hash, bits) {
+        let zeroBits = 0;
+        for (const byte of hash) {
+            if (byte === 0)
+                zeroBits += 8;
+            else {
+                zeroBits += Math.clz32(byte) - 24;
+                break;
+            }
+        }
+        return zeroBits >= bits;
+    }
+}
+exports.ClinchCore = ClinchCore;

package/dist/src/index.js.map

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

package/dist/test.js

@@ -0,0 +1,70 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./src/index");
+const fs = __importStar(require("fs"));
+const TOKEN_FILE = './clinch-identity.txt';
+const myHostAi = {
+    async evaluateOffer() { return { action: 'counter' }; }
+};
+async function run() {
+    console.log("=== CLINCH CORE: CACHED AUTH RUN ===\n");
+    const clinch = new index_1.ClinchCore();
+    let savedToken;
+    if (fs.existsSync(TOKEN_FILE)) {
+        savedToken = fs.readFileSync(TOKEN_FILE, 'utf-8');
+        console.log("📂 Found saved JWT on disk!");
+    }
+    clinch.on('pow_started', (d) => console.log(`⚙️ Hard PoW Started (Difficulty: ${d.difficulty})...`));
+    clinch.on('pow_solved', (d) => console.log(`🔓 PoW Solved in ${d.attempts} attempts!`));
+    clinch.on('token_issued', (data) => {
+        console.log(`💾 Core issued new JWT. Saving to disk...`);
+        fs.writeFileSync(TOKEN_FILE, data.token);
+    });
+    try {
+        await clinch.initialize(myHostAi, savedToken);
+        console.log('✅ Core Initialized!');
+        console.log('\n--- Searching (Requires Auth) ---');
+        const searchRes = await clinch.search('iphone');
+        console.log('🔍 Results:', searchRes.results);
+        console.log('\n--- Negotiating (Requires Auth) ---');
+        const sessionId = await clinch.negotiate('ANP-A.AMAZON.DEALS', { max_price: 500 });
+        console.log('🤝 Session ID:', sessionId);
+    }
+    catch (e) {
+        console.error("Test Failed:", e.message || e);
+    }
+}
+run();

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "clinch-core",
+  "version": "0.1.0",
+
+  "description": "Clinch Protocol Edge Client",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "Clinch Protocol Project",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@types/ws": "^8.18.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "js-sha256": "^0.11.1",
+    "tweetnacl": "^1.0.3",
+    "ws": "^8.20.1"
+  },
+  "peerDependencies":{
+    "node-llama-cpp": "^3.18.1"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,46 @@
+import { EventEmitter } from 'events';
+import nacl from 'tweetnacl';
+export interface ParsedAddress {
+    mode: string;
+    domain: string;
+    route: string;
+}
+export interface ClinchConfig {
+    registryUrl?: string;
+}
+export interface ConstraintVector {
+    intent: string;
+    category?: string;
+    max_price_usd_bracket?: string;
+    [key: string]: any;
+}
+export interface SessionState {
+    sessionId: string;
+    sellerId: string;
+    keyPair: nacl.SignKeyPair;
+    status: 'ACTIVE' | 'EXITED' | 'CLOSED';
+    exitTokenHash?: string;
+}
+export declare class ClinchCore extends EventEmitter {
+    private isInitialized;
+    private config;
+    private cachedRegistryUrl;
+    jwtToken: string | null;
+    private identityPrivKey;
+    identityPubKey: string;
+    private activeSessions;
+    private ws;
+    constructor(config?: ClinchConfig);
+    initialize(cachedToken?: string): Promise<void>;
+    private registerNode;
+    private getRegistryUrl;
+    private networkRequest;
+    private connectWebSocket;
+    disconnect(): void;
+    search(query: string, mode?: string): Promise<any>;
+    negotiate(address: string, constraints: ConstraintVector): Promise<string>;
+    exitSession(sessionId: string): Promise<string>;
+    parseAddress(address: string): ParsedAddress;
+    private solvePoW;
+    private hasLeadingZeroBits;
+}

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAiB7B,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,qBAAa,UAAW,SAAQ,YAAY;IACxC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,iBAAiB,CAAuB;IAEzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGtC,OAAO,CAAC,eAAe,CAAa;IAC7B,cAAc,EAAE,MAAM,CAAC;IAG9B,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,EAAE,CAA0B;gBAExB,MAAM,GAAE,YAAiB;IAiB/B,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBvC,YAAY;YAoBZ,cAAc;YAcd,cAAc;YAkBd,gBAAgB;IA0CvB,UAAU;IAUX,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAMlD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAsC1E,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB9C,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;YAUrC,QAAQ;IAoBtB,OAAO,CAAC,kBAAkB;CAQ7B"}

package/src/index.js

@@ -0,0 +1,247 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClinchCore = void 0;
+const events_1 = require("events");
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const js_sha256_1 = require("js-sha256");
+const ws_1 = __importDefault(require("ws"));
+// ============================================================================
+// CONFIGURATION & UTILS
+// ============================================================================
+const PROTOCOL_VERSION = "0.1.0";
+const FIREBASE_CONFIG_URL = "https://clinchprotocol.web.app/network-config.json";
+function toHex(arr) {
+    return Array.from(arr).map(b => b.toString(16).padStart(2, '0')).join('');
+}
+// ============================================================================
+// THE CLINCH CORE LIBRARY
+// ============================================================================
+class ClinchCore extends events_1.EventEmitter {
+    isInitialized = false;
+    config;
+    cachedRegistryUrl = null;
+    jwtToken = null;
+    // Agent Identity Keypair (Long-lived, used for Auth, NEVER for session messages)
+    identityPrivKey;
+    identityPubKey;
+    // Active Sessions & Ephemeral Keys
+    activeSessions = new Map();
+    ws = null;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+        // Generate Identity Key
+        const keyPair = tweetnacl_1.default.sign.keyPair();
+        this.identityPrivKey = keyPair.secretKey;
+        this.identityPubKey = toHex(keyPair.publicKey);
+        if (this.config.registryUrl) {
+            this.cachedRegistryUrl = this.config.registryUrl;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // INITIALIZATION & AUTH
+    // --------------------------------------------------------------------------
+    async initialize(cachedToken) {
+        if (this.isInitialized)
+            return;
+        try {
+            await this.getRegistryUrl();
+            if (cachedToken) {
+                this.jwtToken = cachedToken;
+                this.emit('log', "[Core] Restored session from cached JWT. Skipping PoW.");
+            }
+            else {
+                await this.registerNode();
+            }
+            await this.connectWebSocket();
+            this.isInitialized = true;
+            this.emit('initialized', { pubKey: this.identityPubKey, registry: this.cachedRegistryUrl });
+        }
+        catch (error) {
+            this.emit('error', error);
+            throw error;
+        }
+    }
+    async registerNode() {
+        this.emit('log', "[Core] No cached token found. Requesting PoW challenge...");
+        const challenge = await this.networkRequest('/api/auth/challenge', {}, false);
+        const powSolution = await this.solvePoW(challenge.nonce, challenge.difficulty);
+        const authRes = await this.networkRequest('/api/auth/verify', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                challenge_id: challenge.challenge_id,
+                pow_solution: powSolution,
+                pubKey: this.identityPubKey
+            })
+        }, false);
+        this.jwtToken = authRes.token;
+        this.emit('token_issued', { token: this.jwtToken });
+    }
+    async getRegistryUrl(forceRefresh = false) {
+        if (this.cachedRegistryUrl && !forceRefresh)
+            return this.cachedRegistryUrl;
+        const res = await fetch(FIREBASE_CONFIG_URL);
+        const text = await res.text();
+        try {
+            const config = JSON.parse(text);
+            this.cachedRegistryUrl = config.registry_nodes[PROTOCOL_VERSION];
+            return this.cachedRegistryUrl;
+        }
+        catch (err) {
+            throw new Error(`Failed to parse Firebase config.`);
+        }
+    }
+    async networkRequest(endpoint, options = {}, requireAuth = true) {
+        const baseUrl = await this.getRegistryUrl();
+        const headers = { ...options.headers };
+        if (requireAuth && this.jwtToken) {
+            headers['Authorization'] = `Bearer ${this.jwtToken}`;
+        }
+        const res = await fetch(`${baseUrl}${endpoint}`, { ...options, headers });
+        const text = await res.text();
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status} on ${endpoint}: ${text}`);
+        return JSON.parse(text);
+    }
+    // --------------------------------------------------------------------------
+    // WEBSOCKET CONNECTION
+    // --------------------------------------------------------------------------
+    async connectWebSocket() {
+        return new Promise((resolve, reject) => {
+            const wsUrl = this.cachedRegistryUrl.replace(/^http/, 'ws');
+            this.ws = new ws_1.default(wsUrl);
+            this.ws.on('open', () => {
+                this.ws.send(JSON.stringify({ type: 'AUTH', token: this.jwtToken }));
+            });
+            this.ws.on('message', (data) => {
+                const msg = JSON.parse(data.toString());
+                if (msg.type === 'AUTH_SUCCESS') {
+                    this.emit('log', '[Core] WebSocket authenticated & listening.');
+                    resolve();
+                }
+                if (msg.type === 'CALLBACK') {
+                    this.emit('callback_received', {
+                        sessionId: msg.session_id,
+                        payload: msg.payload
+                    });
+                    this.ws.send(JSON.stringify({ type: 'ACK', id: msg.id }));
+                }
+                if (msg.type === 'ERROR') {
+                    this.emit('error', new Error(msg.message));
+                }
+            });
+            this.ws.on('error', (err) => {
+                this.emit('error', err);
+                reject(err);
+            });
+            this.ws.on('close', () => {
+                this.emit('log', '[Core] WebSocket disconnected.');
+            });
+        });
+    }
+    disconnect() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // PROTOCOL OPERATIONS
+    // --------------------------------------------------------------------------
+    async search(query, mode) {
+        let url = `/api/discover?category=${encodeURIComponent(query)}`;
+        if (mode)
+            url += `&mode=${encodeURIComponent(mode)}`;
+        return await this.networkRequest(url);
+    }
+    async negotiate(address, constraints) {
+        const parsed = this.parseAddress(address);
+        const ephemeralKeys = tweetnacl_1.default.sign.keyPair();
+        const ephemeralPubHex = toHex(ephemeralKeys.publicKey);
+        const initPayload = {
+            clinch_version: PROTOCOL_VERSION,
+            mode: parsed.mode,
+            constraints,
+            session_pub_key: ephemeralPubHex,
+            timestamp_utc: new Date().toISOString()
+        };
+        const msgUint8 = new TextEncoder().encode(JSON.stringify(initPayload));
+        const signature = toHex(tweetnacl_1.default.sign.detached(msgUint8, ephemeralKeys.secretKey));
+        const signedPayload = { ...initPayload, sig: signature };
+        const response = await this.networkRequest(`/api/route/${parsed.domain}/handshake`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(signedPayload)
+        });
+        const sessionId = response.session_id;
+        this.activeSessions.set(sessionId, {
+            sessionId,
+            sellerId: parsed.domain,
+            keyPair: ephemeralKeys,
+            status: 'ACTIVE'
+        });
+        this.emit('session_started', { sessionId, sellerId: parsed.domain });
+        return sessionId;
+    }
+    async exitSession(sessionId) {
+        const session = this.activeSessions.get(sessionId);
+        if (!session)
+            throw new Error("Session not found or not active");
+        const res = await this.networkRequest(`/api/route/${sessionId}/exit`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ seller_id: session.sellerId })
+        });
+        session.status = 'EXITED';
+        session.exitTokenHash = res.token_hash;
+        this.emit('session_exited', { sessionId, token_hash: res.token_hash });
+        return res.token_hash;
+    }
+    // --------------------------------------------------------------------------
+    // UTILITIES
+    // --------------------------------------------------------------------------
+    parseAddress(address) {
+        const parts = address.split('.');
+        if (parts.length < 2)
+            throw new Error("Invalid Address Format. Expected MODE.DOMAIN.anp");
+        return {
+            mode: parts[0],
+            domain: parts.slice(1).join('.').toLowerCase(),
+            route: '/'
+        };
+    }
+    async solvePoW(nonce, difficultyBits) {
+        this.emit('pow_started', { difficulty: difficultyBits });
+        let counter = 0;
+        const CHUNK_SIZE = 5000;
+        while (true) {
+            for (let i = 0; i < CHUNK_SIZE; i++) {
+                const attempt = counter.toString();
+                const hashArray = js_sha256_1.sha256.create().update(nonce + this.identityPubKey + attempt).array();
+                if (this.hasLeadingZeroBits(hashArray, difficultyBits)) {
+                    this.emit('pow_solved', { attempts: counter });
+                    return attempt;
+                }
+                counter++;
+            }
+            await new Promise(resolve => setTimeout(resolve, 0));
+        }
+    }
+    hasLeadingZeroBits(hash, bits) {
+        let zeroBits = 0;
+        for (const byte of hash) {
+            if (byte === 0)
+                zeroBits += 8;
+            else {
+                zeroBits += Math.clz32(byte) - 24;
+                break;
+            }
+        }
+        return zeroBits >= bits;
+    }
+}
+exports.ClinchCore = ClinchCore;