@hsuite/smart-engines-cli 1.0.0

package/dist/libs/multi-chain-core/src/settlement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/multi-chain-core/src/settlement/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAmC;AAMnC,0GAE2D;AADzD,wJAAA,gCAAgC,OAAA;AAOlC,0GAG2D;AAFzD,wJAAA,gCAAgC,OAAA;AAChC,wJAAA,gCAAgC,OAAA;AAMlC,mEAKkC;AAJhC,8HAAA,oBAAoB,OAAA;AACpB,sJAAA,4CAA4C,OAAA;AAC5C,2IAAA,iCAAiC,OAAA;AACjC,iJAAA,uCAAuC,OAAA;AAGzC,yDAG6B;AAF3B,qHAAA,gBAAgB,OAAA;AAChB,4HAAA,uBAAuB,OAAA;AAQzB,yEAKqC;AAJnC,oIAAA,uBAAuB,OAAA;AACvB,0IAAA,6BAA6B,OAAA;AAC7B,yIAAA,4BAA4B,OAAA;AAC5B,oIAAA,uBAAuB,OAAA;AAEzB,iEAIiC;AAH/B,4HAAA,mBAAmB,OAAA;AACnB,gIAAA,uBAAuB,OAAA;AACvB,+HAAA,sBAAsB,OAAA;AAGxB,4CAA0B;AAC1B,iFAAuE;AAA9D,qIAAA,oBAAoB,OAAA;AAC7B,qEAImC;AAHjC,mIAAA,wBAAwB,OAAA;AACxB,uIAAA,4BAA4B,OAAA;AAC5B,kIAAA,uBAAuB,OAAA;AAOzB,4DAGkC;AAFhC,2HAAA,wBAAwB,OAAA;AACxB,wIAAA,qCAAqC,OAAA;AAGvC,0DAGiC;AAF/B,wHAAA,sBAAsB,OAAA;AACtB,0HAAA,wBAAwB,OAAA;AAG1B,4DAAoE;AAA3D,2HAAA,wBAAwB,OAAA;AACjC,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA"}

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-audit-publisher.interface.d.ts

@@ -0,0 +1,11 @@
+export type SettlementAuditEnvelope = {
+    eventType: string;
+    payload: Record<string, unknown>;
+    payerAccountId: string;
+};
+export type ISettlementAuditPublisher = {
+    publish(envelope: SettlementAuditEnvelope): Promise<void>;
+};
+export declare const SETTLEMENT_AUDIT_PUBLISHER_TOKEN = "SETTLEMENT_AUDIT_PUBLISHER";
+export declare const SETTLEMENT_AUDIT_HCS_PUBLISH_ENV = "SETTLEMENT_AUDIT_HCS_PUBLISH";
+//# sourceMappingURL=settlement-audit-publisher.interface.d.ts.map

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-audit-publisher.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-audit-publisher.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/interfaces/settlement-audit-publisher.interface.ts"],"names":[],"mappings":"AAuCA,MAAM,MAAM,uBAAuB,GAAG;IAEpC,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMjC,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAQF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D,CAAC;AAGF,eAAO,MAAM,gCAAgC,+BACf,CAAC;AAQ/B,eAAO,MAAM,gCAAgC,iCACb,CAAC"}

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-audit-publisher.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETTLEMENT_AUDIT_HCS_PUBLISH_ENV = exports.SETTLEMENT_AUDIT_PUBLISHER_TOKEN = void 0;
+exports.SETTLEMENT_AUDIT_PUBLISHER_TOKEN = 'SETTLEMENT_AUDIT_PUBLISHER';
+exports.SETTLEMENT_AUDIT_HCS_PUBLISH_ENV = 'SETTLEMENT_AUDIT_HCS_PUBLISH';
+//# sourceMappingURL=settlement-audit-publisher.interface.js.map

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-audit-publisher.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-audit-publisher.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/interfaces/settlement-audit-publisher.interface.ts"],"names":[],"mappings":";;;AA+Da,QAAA,gCAAgC,GAC3C,4BAA4B,CAAC;AAQlB,QAAA,gCAAgC,GAC3C,8BAA8B,CAAC"}

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-route.interface.d.ts

@@ -0,0 +1,27 @@
+export type SettlementQuote = {
+    route: string;
+    estimatedOutput: string;
+    estimatedDurationMs: number;
+    slippageBps: number;
+};
+export type SettlementRouteResult = {
+    success: boolean;
+    outputAmount: string;
+    txIds: string[];
+    route: string;
+    durationMs: number;
+    error?: string;
+};
+export type SettlementVerifyResult = {
+    verified: boolean;
+    reason?: string;
+    observedAmount?: string;
+};
+export type ISettlementRoute = {
+    readonly name: string;
+    canHandle(sourceChain: string, sourceAsset: string, targetAsset: string): boolean;
+    estimateRate(sourceChain: string, sourceAsset: string, amount: string): Promise<SettlementQuote>;
+    execute(request: any): Promise<SettlementRouteResult>;
+    verifyDestination?(request: any, routeResult: SettlementRouteResult): Promise<SettlementVerifyResult>;
+};
+//# sourceMappingURL=settlement-route.interface.d.ts.map

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-route.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-route.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/interfaces/settlement-route.interface.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAeF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAClF,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACjG,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAatD,iBAAiB,CAAC,CAChB,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC,CAAC"}

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-route.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=settlement-route.interface.js.map

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-route.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-route.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/interfaces/settlement-route.interface.ts"],"names":[],"mappings":""}

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-rules-validator.interface.d.ts

@@ -0,0 +1,13 @@
+import type { ValidationResult } from '@hsuite/smart-engines-rules-engine';
+export type SettlementRulesContext = {
+    ruleId?: string;
+    agentId?: string;
+    smartAppId?: string;
+    rulesConfig?: Record<string, unknown>;
+};
+export type SettlementAction = 'settlement.execute';
+export type ISettlementRulesValidator = {
+    validateSettlement(rulesContext: SettlementRulesContext, action: SettlementAction, params: Record<string, unknown>): Promise<ValidationResult>;
+};
+export declare const SETTLEMENT_RULES_VALIDATOR_TOKEN = "SETTLEMENT_RULES_VALIDATOR";
+//# sourceMappingURL=settlement-rules-validator.interface.d.ts.map

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-rules-validator.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-rules-validator.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/interfaces/settlement-rules-validator.interface.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAO3E,MAAM,MAAM,sBAAsB,GAAG;IAEnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC;AAOF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD,MAAM,MAAM,yBAAyB,GAAG;IAWtC,kBAAkB,CAChB,YAAY,EAAE,sBAAsB,EACpC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B,CAAC;AAGF,eAAO,MAAM,gCAAgC,+BAA+B,CAAC"}

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-rules-validator.interface.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETTLEMENT_RULES_VALIDATOR_TOKEN = void 0;
+exports.SETTLEMENT_RULES_VALIDATOR_TOKEN = 'SETTLEMENT_RULES_VALIDATOR';
+//# sourceMappingURL=settlement-rules-validator.interface.js.map

package/dist/libs/multi-chain-core/src/settlement/interfaces/settlement-rules-validator.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-rules-validator.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/interfaces/settlement-rules-validator.interface.ts"],"names":[],"mappings":";;;AAuDa,QAAA,gCAAgC,GAAG,4BAA4B,CAAC"}

package/dist/libs/multi-chain-core/src/settlement/route-selector.service.d.ts

@@ -0,0 +1,28 @@
+import type { ISettlementRoute, SettlementRouteResult } from './interfaces/settlement-route.interface';
+import { TSSSigningCoordinator } from '../tss/tss-signing.coordinator';
+export declare const SETTLEMENT_QUORUM_ROUTE_SELECTION_FLAG_TOKEN = "SETTLEMENT_QUORUM_ROUTE_SELECTION_FLAG";
+export declare const SETTLEMENT_QUORUM_ENTITY_ID_TOKEN = "SETTLEMENT_QUORUM_ENTITY_ID";
+export declare const SETTLEMENT_QUORUM_SIGNER_NODE_IDS_TOKEN = "SETTLEMENT_QUORUM_SIGNER_NODE_IDS";
+export type QuorumRouteResult = {
+    result: SettlementRouteResult;
+    attestation?: {
+        blsSignature: string;
+        signerNodeIds: string[];
+        messageHash: string;
+    };
+    attestationDeferredReason?: string;
+};
+export declare class RouteSelectorService {
+    private readonly tssCoordinator?;
+    private readonly quorumFlagEnabled?;
+    private readonly quorumEntityId?;
+    private readonly quorumSignerNodeIds?;
+    private readonly logger;
+    private readonly routes;
+    constructor(routes: ISettlementRoute[], tssCoordinator?: TSSSigningCoordinator | undefined, quorumFlagEnabled?: boolean | undefined, quorumEntityId?: string | undefined, quorumSignerNodeIds?: string[] | undefined);
+    getRouteByName(routeName: string): ISettlementRoute | undefined;
+    selectRoute(sourceChain: string, sourceAsset: string, targetAsset: string): ISettlementRoute | null;
+    executeWithFallback(request: any): Promise<SettlementRouteResult>;
+    selectAndExecuteWithQuorum(request: any): Promise<QuorumRouteResult>;
+}
+//# sourceMappingURL=route-selector.service.d.ts.map

package/dist/libs/multi-chain-core/src/settlement/route-selector.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-selector.service.d.ts","sourceRoot":"","sources":["../../../../../../../libs/multi-chain-core/src/settlement/route-selector.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAEhB,qBAAqB,EACtB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAKvE,eAAO,MAAM,4CAA4C,2CACf,CAAC;AAK3C,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAG/E,eAAO,MAAM,uCAAuC,sCACf,CAAC;AAWtC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,WAAW,CAAC,EAAE;QAEZ,YAAY,EAAE,MAAM,CAAC;QAErB,aAAa,EAAE,MAAM,EAAE,CAAC;QAExB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,qBACa,oBAAoB;IAMjB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAG5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAGnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAGhC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAdvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAG1C,MAAM,EAAE,gBAAgB,EAAE,EACG,cAAc,CAAC,EAAE,qBAAqB,YAAA,EAGlD,iBAAiB,CAAC,EAAE,OAAO,YAAA,EAG3B,cAAc,CAAC,EAAE,MAAM,YAAA,EAGvB,mBAAmB,CAAC,EAAE,MAAM,EAAE,YAAA;IAUjD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAQ/D,WAAW,CACT,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,gBAAgB,GAAG,IAAI;IASpB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoDjE,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA4J3E"}

package/dist/libs/multi-chain-core/src/settlement/route-selector.service.js

@@ -0,0 +1,251 @@
+"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 __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var RouteSelectorService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteSelectorService = exports.SETTLEMENT_QUORUM_SIGNER_NODE_IDS_TOKEN = exports.SETTLEMENT_QUORUM_ENTITY_ID_TOKEN = exports.SETTLEMENT_QUORUM_ROUTE_SELECTION_FLAG_TOKEN = void 0;
+const common_1 = require("@nestjs/common");
+const crypto = __importStar(require("crypto"));
+const tss_signing_coordinator_1 = require("../tss/tss-signing.coordinator");
+exports.SETTLEMENT_QUORUM_ROUTE_SELECTION_FLAG_TOKEN = 'SETTLEMENT_QUORUM_ROUTE_SELECTION_FLAG';
+exports.SETTLEMENT_QUORUM_ENTITY_ID_TOKEN = 'SETTLEMENT_QUORUM_ENTITY_ID';
+exports.SETTLEMENT_QUORUM_SIGNER_NODE_IDS_TOKEN = 'SETTLEMENT_QUORUM_SIGNER_NODE_IDS';
+let RouteSelectorService = RouteSelectorService_1 = class RouteSelectorService {
+    tssCoordinator;
+    quorumFlagEnabled;
+    quorumEntityId;
+    quorumSignerNodeIds;
+    logger = new common_1.Logger(RouteSelectorService_1.name);
+    routes;
+    constructor(routes, tssCoordinator, quorumFlagEnabled, quorumEntityId, quorumSignerNodeIds) {
+        this.tssCoordinator = tssCoordinator;
+        this.quorumFlagEnabled = quorumFlagEnabled;
+        this.quorumEntityId = quorumEntityId;
+        this.quorumSignerNodeIds = quorumSignerNodeIds;
+        this.routes = routes;
+    }
+    getRouteByName(routeName) {
+        return this.routes.find((r) => r.name === routeName);
+    }
+    selectRoute(sourceChain, sourceAsset, targetAsset) {
+        return this.routes.find((r) => r.canHandle(sourceChain, sourceAsset, targetAsset)) ?? null;
+    }
+    async executeWithFallback(request) {
+        const sourceChain = request.sourceChain;
+        const sourceAsset = request.sourceAsset?.symbol;
+        const eligible = this.routes.filter((r) => r.canHandle(sourceChain, sourceAsset, 'HSUITE'));
+        for (const route of eligible) {
+            try {
+                this.logger.log(`Attempting settlement via ${route.name}`);
+                const result = await route.execute(request);
+                if (result.success)
+                    return result;
+                this.logger.warn(`Settlement via ${route.name} returned failure: ${result.error}`);
+            }
+            catch (err) {
+                this.logger.warn(`Settlement via ${route.name} threw: ${err instanceof Error ? err.message : 'Unknown'}`);
+            }
+        }
+        return {
+            success: false,
+            outputAmount: '0',
+            txIds: [],
+            route: 'none',
+            durationMs: 0,
+            error: 'All settlement routes failed',
+        };
+    }
+    async selectAndExecuteWithQuorum(request) {
+        const flagOn = this.quorumFlagEnabled === true;
+        if (!flagOn) {
+            const result = await this.executeWithFallback(request);
+            return {
+                result,
+                attestationDeferredReason: 'SETTLEMENT_QUORUM_ROUTE_SELECTION feature flag is off',
+            };
+        }
+        if (!this.tssCoordinator) {
+            const result = await this.executeWithFallback(request);
+            return {
+                result,
+                attestationDeferredReason: 'TSSSigningCoordinator is not bound',
+            };
+        }
+        if (!this.quorumEntityId) {
+            const result = await this.executeWithFallback(request);
+            return {
+                result,
+                attestationDeferredReason: 'SETTLEMENT_QUORUM_ENTITY_ID is not configured',
+            };
+        }
+        if (!this.quorumSignerNodeIds || this.quorumSignerNodeIds.length === 0) {
+            const result = await this.executeWithFallback(request);
+            return {
+                result,
+                attestationDeferredReason: 'SETTLEMENT_QUORUM_SIGNER_NODE_IDS is not configured',
+            };
+        }
+        const sourceChain = request.sourceChain;
+        const sourceAsset = request.sourceAsset?.symbol;
+        const eligible = this.routes.filter((r) => r.canHandle(sourceChain, sourceAsset, 'HSUITE'));
+        if (eligible.length === 0) {
+            return {
+                result: {
+                    success: false,
+                    outputAmount: '0',
+                    txIds: [],
+                    route: 'none',
+                    durationMs: 0,
+                    error: 'No eligible routes for quorum selection',
+                },
+                attestationDeferredReason: 'no eligible routes',
+            };
+        }
+        const candidates = [];
+        for (const r of eligible) {
+            try {
+                const quote = await r.estimateRate(sourceChain, sourceAsset, String(request.sourceAmount));
+                candidates.push({ route: r, quote });
+            }
+            catch (err) {
+                this.logger.debug(`estimateRate threw on ${r.name}: ${err instanceof Error ? err.message : 'unknown'}`);
+                candidates.push({ route: r });
+            }
+        }
+        candidates.sort((a, b) => {
+            const av = parseFloat(a.quote?.estimatedOutput ?? '-1');
+            const bv = parseFloat(b.quote?.estimatedOutput ?? '-1');
+            return bv - av;
+        });
+        const chosen = candidates[0];
+        const messageObj = {
+            kind: 'settlement.route.attestation',
+            settlementId: request.settlementId,
+            sourceChain,
+            sourceAsset,
+            sourceAmount: String(request.sourceAmount),
+            chosenRoute: chosen.route.name,
+            candidates: candidates.map((c) => ({
+                route: c.route.name,
+                estimatedOutput: c.quote?.estimatedOutput,
+            })),
+        };
+        const messageBytes = Buffer.from(JSON.stringify(messageObj));
+        const messageHash = crypto.createHash('sha256').update(messageBytes).digest('hex');
+        let attestation;
+        try {
+            const sigs = await this.tssCoordinator.signWithTSS(this.quorumEntityId, messageBytes, this.quorumSignerNodeIds, 'settlement');
+            const aggregated = sigs?.[0];
+            if (!aggregated) {
+                return {
+                    result: {
+                        success: false,
+                        outputAmount: '0',
+                        txIds: [],
+                        route: chosen.route.name,
+                        durationMs: 0,
+                        error: 'TSS attestation produced no aggregated signature',
+                    },
+                    attestationDeferredReason: 'no aggregated signature',
+                };
+            }
+            const sigField = aggregated.signature ??
+                aggregated.blsSignature ??
+                aggregated.aggregatedSignature ??
+                '';
+            attestation = {
+                blsSignature: typeof sigField === 'string' ? sigField : Buffer.from(sigField).toString('hex'),
+                signerNodeIds: this.quorumSignerNodeIds,
+                messageHash,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger.error(`TSS attestation failed for route choice: ${msg}`);
+            return {
+                result: {
+                    success: false,
+                    outputAmount: '0',
+                    txIds: [],
+                    route: chosen.route.name,
+                    durationMs: 0,
+                    error: `TSS attestation failed: ${msg}`,
+                },
+                attestationDeferredReason: 'attestation threw',
+            };
+        }
+        this.logger.log(`Route ${chosen.route.name} attested by ${this.quorumSignerNodeIds.length} signers; executing`);
+        let result;
+        try {
+            result = await chosen.route.execute(request);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result = {
+                success: false,
+                outputAmount: '0',
+                txIds: [],
+                route: chosen.route.name,
+                durationMs: 0,
+                error: `attested route execute threw: ${msg}`,
+            };
+        }
+        return { result, attestation };
+    }
+};
+exports.RouteSelectorService = RouteSelectorService;
+exports.RouteSelectorService = RouteSelectorService = RouteSelectorService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(exports.SETTLEMENT_QUORUM_ROUTE_SELECTION_FLAG_TOKEN)),
+    __param(3, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Inject)(exports.SETTLEMENT_QUORUM_ENTITY_ID_TOKEN)),
+    __param(4, (0, common_1.Optional)()),
+    __param(4, (0, common_1.Inject)(exports.SETTLEMENT_QUORUM_SIGNER_NODE_IDS_TOKEN)),
+    __metadata("design:paramtypes", [Array, tss_signing_coordinator_1.TSSSigningCoordinator, Boolean, String, Array])
+], RouteSelectorService);
+//# sourceMappingURL=route-selector.service.js.map

package/dist/libs/multi-chain-core/src/settlement/route-selector.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-selector.service.js","sourceRoot":"","sources":["../../../../../../../libs/multi-chain-core/src/settlement/route-selector.service.ts"],"names":[],"mappings":"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"}

package/dist/libs/multi-chain-core/src/settlement/routes/changenow.route.d.ts

@@ -0,0 +1,22 @@
+import { ChangeNowService } from '../changenow.service';
+import type { ISettlementRoute, SettlementQuote, SettlementRouteResult, SettlementVerifyResult } from '../interfaces/settlement-route.interface';
+export type IDestinationTxLookup = {
+    getTransaction(txId: string): Promise<{
+        id?: string;
+        status?: string;
+        to?: string;
+        amount?: unknown;
+    } | null | undefined>;
+};
+export declare const CHANGENOW_DESTINATION_TX_LOOKUP_TOKEN = "CHANGENOW_DESTINATION_TX_LOOKUP";
+export declare class ChangeNowSettlementRoute implements ISettlementRoute {
+    private readonly changeNow;
+    private readonly destinationTxLookup?;
+    readonly name = "changenow";
+    constructor(changeNow: ChangeNowService, destinationTxLookup?: IDestinationTxLookup | undefined);
+    canHandle(sourceChain: string, _sourceAsset: string, _targetAsset: string): boolean;
+    estimateRate(_sourceChain: string, sourceAsset: string, amount: string): Promise<SettlementQuote>;
+    execute(request: any): Promise<SettlementRouteResult>;
+    verifyDestination(request: any, routeResult: SettlementRouteResult): Promise<SettlementVerifyResult>;
+}
+//# sourceMappingURL=changenow.route.d.ts.map

package/dist/libs/multi-chain-core/src/settlement/routes/changenow.route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changenow.route.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/routes/changenow.route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,0CAA0C,CAAC;AAelD,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACpC,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACvB,CAAC;AAGF,eAAO,MAAM,qCAAqC,oCAAoC,CAAC;AAcvF,qBACa,wBAAyB,YAAW,gBAAgB;IAI7D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAG1B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IANvC,QAAQ,CAAC,IAAI,eAAe;gBAGT,SAAS,EAAE,gBAAgB,EAG3B,mBAAmB,CAAC,EAAE,oBAAoB,YAAA;IAG7D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAO7E,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC;IAgBrB,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkDrD,iBAAiB,CACrB,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,sBAAsB,CAAC;CAkInC"}

package/dist/libs/multi-chain-core/src/settlement/routes/changenow.route.js

@@ -0,0 +1,193 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangeNowSettlementRoute = exports.CHANGENOW_DESTINATION_TX_LOOKUP_TOKEN = void 0;
+const common_1 = require("@nestjs/common");
+const changenow_service_1 = require("../changenow.service");
+exports.CHANGENOW_DESTINATION_TX_LOOKUP_TOKEN = 'CHANGENOW_DESTINATION_TX_LOOKUP';
+const DEFAULT_SLIPPAGE_TOLERANCE_BPS = 200;
+let ChangeNowSettlementRoute = class ChangeNowSettlementRoute {
+    changeNow;
+    destinationTxLookup;
+    name = 'changenow';
+    constructor(changeNow, destinationTxLookup) {
+        this.changeNow = changeNow;
+        this.destinationTxLookup = destinationTxLookup;
+    }
+    canHandle(sourceChain, _sourceAsset, _targetAsset) {
+        return (this.changeNow.isAvailable() &&
+            sourceChain.toLowerCase() !== 'xrpl');
+    }
+    async estimateRate(_sourceChain, sourceAsset, amount) {
+        const started = Date.now();
+        const estimate = await this.changeNow.getEstimate({
+            fromCurrency: sourceAsset,
+            fromNetwork: _sourceChain,
+            fromAmount: amount,
+        });
+        return {
+            route: this.name,
+            estimatedOutput: String(estimate.estimatedAmount),
+            estimatedDurationMs: Date.now() - started + 5 * 60_000,
+            slippageBps: 50,
+        };
+    }
+    async execute(request) {
+        const started = Date.now();
+        try {
+            const exchange = await this.changeNow.createExchange({
+                fromCurrency: request.sourceAsset?.symbol ?? request.fromCurrency,
+                fromNetwork: request.sourceChain ?? request.fromNetwork,
+                fromAmount: String(request.sourceAmount ?? request.amount),
+                toAddress: request.toAddress,
+                toExtraId: request.toExtraId,
+                flow: request.flow,
+            });
+            return {
+                success: true,
+                outputAmount: String(exchange.expectedAmountTo),
+                txIds: [exchange.id],
+                route: this.name,
+                durationMs: Date.now() - started,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                outputAmount: '0',
+                txIds: [],
+                route: this.name,
+                durationMs: Date.now() - started,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    async verifyDestination(request, routeResult) {
+        const exchangeId = routeResult.txIds?.[0];
+        if (!exchangeId) {
+            return {
+                verified: false,
+                reason: 'changenow: no exchange id in route result',
+            };
+        }
+        let status;
+        try {
+            status = await this.changeNow.getExchangeStatus(exchangeId);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { verified: false, reason: `changenow: status query failed: ${msg}` };
+        }
+        if (status?.status !== 'finished') {
+            return {
+                verified: false,
+                reason: `changenow: exchange status is '${status?.status}', expected 'finished'`,
+            };
+        }
+        const expectedAmount = String(status.toAmount ?? 0);
+        if (parseFloat(expectedAmount) <= 0) {
+            return {
+                verified: false,
+                reason: `changenow: status reports non-positive toAmount=${expectedAmount}`,
+            };
+        }
+        if (!this.destinationTxLookup) {
+            return {
+                verified: true,
+                observedAmount: expectedAmount,
+                reason: 'changenow: status=finished; destination-chain re-verification skipped (no tx-lookup adapter bound)',
+            };
+        }
+        const payoutHash = status.payoutHash;
+        if (!payoutHash) {
+            return {
+                verified: false,
+                reason: 'changenow: status=finished but payoutHash absent — cannot re-verify on destination chain',
+            };
+        }
+        let tx;
+        try {
+            tx = await this.destinationTxLookup.getTransaction(payoutHash);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                verified: false,
+                reason: `changenow: destination-chain getTransaction(${payoutHash}) failed: ${msg}`,
+            };
+        }
+        if (!tx) {
+            return {
+                verified: false,
+                reason: `changenow: destination chain has no tx with hash ${payoutHash}`,
+            };
+        }
+        if (tx.status && tx.status !== 'success') {
+            return {
+                verified: false,
+                reason: `changenow: destination tx ${payoutHash} status='${tx.status}', expected 'success'`,
+            };
+        }
+        const observedRaw = tx.amount;
+        let observed;
+        if (typeof observedRaw === 'string') {
+            observed = observedRaw;
+        }
+        else if (typeof observedRaw === 'number') {
+            observed = String(observedRaw);
+        }
+        else if (observedRaw && typeof observedRaw === 'object' && 'value' in observedRaw) {
+            observed = String(observedRaw.value);
+        }
+        if (observed === undefined) {
+            return {
+                verified: true,
+                observedAmount: expectedAmount,
+                reason: `changenow: destination tx ${payoutHash} matched (status=${tx.status ?? 'unknown'}); observed amount unavailable from adapter`,
+            };
+        }
+        const requested = parseFloat(expectedAmount);
+        const got = parseFloat(observed);
+        if (!Number.isFinite(got) || got <= 0) {
+            return {
+                verified: false,
+                reason: `changenow: destination tx ${payoutHash} amount '${observed}' is not a valid positive number`,
+            };
+        }
+        const slippageBps = Math.abs((requested - got) / requested) * 10_000;
+        const tolerance = typeof request?.maxSlippageBps === 'number' && request.maxSlippageBps > 0
+            ? request.maxSlippageBps
+            : DEFAULT_SLIPPAGE_TOLERANCE_BPS;
+        if (slippageBps > tolerance) {
+            return {
+                verified: false,
+                reason: `changenow: destination tx ${payoutHash} amount=${observed} diverges from expected=${expectedAmount} by ${slippageBps.toFixed(0)}bps (tolerance ${tolerance}bps)`,
+                observedAmount: observed,
+            };
+        }
+        return {
+            verified: true,
+            observedAmount: observed,
+            reason: `changenow: destination tx ${payoutHash} verified (amount=${observed}, slippage=${slippageBps.toFixed(0)}bps)`,
+        };
+    }
+};
+exports.ChangeNowSettlementRoute = ChangeNowSettlementRoute;
+exports.ChangeNowSettlementRoute = ChangeNowSettlementRoute = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(exports.CHANGENOW_DESTINATION_TX_LOOKUP_TOKEN)),
+    __metadata("design:paramtypes", [changenow_service_1.ChangeNowService, Object])
+], ChangeNowSettlementRoute);
+//# sourceMappingURL=changenow.route.js.map

package/dist/libs/multi-chain-core/src/settlement/routes/changenow.route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changenow.route.js","sourceRoot":"","sources":["../../../../../../../../libs/multi-chain-core/src/settlement/routes/changenow.route.ts"],"names":[],"mappings":"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"}