@toon-protocol/connector 1.7.1

package/dist/settlement/channel-manager.d.ts

@@ -0,0 +1,66 @@
+import { EventEmitter } from 'events';
+import type { Logger } from 'pino';
+import { PaymentChannelSDK } from './payment-channel-sdk';
+import { SettlementExecutor } from './settlement-executor';
+import type { AdminChannelStatus } from './types';
+export interface ChannelManagerConfig {
+    nodeId: string;
+    defaultSettlementTimeout: number;
+    initialDepositMultiplier: number;
+    idleChannelThreshold: number;
+    minDepositThreshold: number;
+    idleCheckInterval: number;
+    tokenAddressMap: Map<string, string>;
+    peerIdToAddressMap: Map<string, string>;
+    registryAddress: string;
+    rpcUrl: string;
+    privateKey: string;
+}
+export interface ChannelMetadata {
+    channelId: string;
+    peerId: string;
+    tokenId: string;
+    tokenAddress: string;
+    chain: string;
+    createdAt: Date;
+    lastActivityAt: Date;
+    status: AdminChannelStatus;
+}
+export interface ChannelOpenOptions {
+    initialDeposit?: bigint;
+    settlementTimeout?: number;
+    chain?: string;
+    peerAddress?: string;
+}
+export declare class ChannelManager extends EventEmitter {
+    private readonly config;
+    private readonly paymentChannelSDK;
+    private readonly settlementExecutor;
+    private readonly logger;
+    private readonly channelMetadata;
+    private readonly peerChannelIndex;
+    private idleCheckTimer?;
+    constructor(config: ChannelManagerConfig, paymentChannelSDK: PaymentChannelSDK, settlementExecutor: SettlementExecutor, logger: Logger);
+    start(): void;
+    stop(): void;
+    ensureChannelExists(peerId: string, tokenId: string, options?: ChannelOpenOptions): Promise<string>;
+    getChannelForPeer(peerId: string, tokenId: string): ChannelMetadata | null;
+    getChannelById(channelId: string): ChannelMetadata | null;
+    registerExternalChannel(params: {
+        channelId: string;
+        peerId: string;
+        tokenAddress: string;
+        tokenNetworkAddress: string;
+        chainId: number;
+        status: AdminChannelStatus;
+    }): ChannelMetadata;
+    getAllChannels(): ChannelMetadata[];
+    markChannelActivity(channelId: string): Promise<void>;
+    private openChannelForPeer;
+    private checkIdleChannels;
+    private isChannelIdle;
+    private closeIdleChannel;
+    private scheduleChallengeSettle;
+    private settleAfterChallenge;
+}
+//# sourceMappingURL=channel-manager.d.ts.map

package/dist/settlement/channel-manager.d.ts.map

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

package/dist/settlement/channel-manager.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelManager = void 0;
+const events_1 = require("events");
+class ChannelManager extends events_1.EventEmitter {
+    config;
+    paymentChannelSDK;
+    settlementExecutor;
+    logger;
+    channelMetadata;
+    peerChannelIndex;
+    idleCheckTimer;
+    constructor(config, paymentChannelSDK, settlementExecutor, logger) {
+        super();
+        this.config = config;
+        this.paymentChannelSDK = paymentChannelSDK;
+        this.settlementExecutor = settlementExecutor;
+        this.channelMetadata = new Map();
+        this.peerChannelIndex = new Map();
+        this.idleCheckTimer = undefined;
+        this.logger = logger.child({ component: 'channel-manager' });
+        this.logger.info({ nodeId: config.nodeId }, 'Channel manager initialized');
+        this.settlementExecutor.on('CHANNEL_ACTIVITY', ({ channelId }) => {
+            void this.markChannelActivity(channelId);
+        });
+    }
+    start() {
+        this.idleCheckTimer = setInterval(() => this.checkIdleChannels(), this.config.idleCheckInterval * 1000);
+        this.logger.info({ idleCheckInterval: this.config.idleCheckInterval }, 'Channel manager started');
+    }
+    stop() {
+        if (this.idleCheckTimer) {
+            clearInterval(this.idleCheckTimer);
+            this.idleCheckTimer = undefined;
+        }
+        this.logger.info('Channel manager stopped');
+    }
+    async ensureChannelExists(peerId, tokenId, options) {
+        const channelId = this.peerChannelIndex.get(peerId)?.get(tokenId);
+        if (channelId) {
+            const metadata = this.channelMetadata.get(channelId);
+            if (metadata && metadata.status !== 'closed') {
+                this.logger.info({ peerId, tokenId, channelId }, 'Ensured channel exists (existing)');
+                return channelId;
+            }
+        }
+        const newChannelId = await this.openChannelForPeer(peerId, tokenId, options);
+        this.logger.info({ peerId, tokenId, channelId: newChannelId }, 'Ensured channel exists (new)');
+        return newChannelId;
+    }
+    getChannelForPeer(peerId, tokenId) {
+        const channelId = this.peerChannelIndex.get(peerId)?.get(tokenId);
+        if (!channelId) {
+            return null;
+        }
+        return this.channelMetadata.get(channelId) ?? null;
+    }
+    getChannelById(channelId) {
+        return this.channelMetadata.get(channelId) ?? null;
+    }
+    registerExternalChannel(params) {
+        const existing = this.channelMetadata.get(params.channelId);
+        if (existing) {
+            this.logger.debug({ channelId: params.channelId }, 'External channel already registered, returning existing');
+            return existing;
+        }
+        let tokenId = params.tokenAddress;
+        for (const [id, address] of this.config.tokenAddressMap.entries()) {
+            if (address.toLowerCase() === params.tokenAddress.toLowerCase()) {
+                tokenId = id;
+                break;
+            }
+        }
+        const metadata = {
+            channelId: params.channelId,
+            peerId: params.peerId,
+            tokenId,
+            tokenAddress: params.tokenAddress,
+            chain: `evm:${params.chainId}`,
+            createdAt: new Date(),
+            lastActivityAt: new Date(),
+            status: 'open',
+        };
+        this.channelMetadata.set(params.channelId, metadata);
+        if (!this.peerChannelIndex.has(params.peerId)) {
+            this.peerChannelIndex.set(params.peerId, new Map());
+        }
+        this.peerChannelIndex.get(params.peerId).set(tokenId, params.channelId);
+        this.logger.info({
+            channelId: params.channelId,
+            peerId: params.peerId,
+            chainId: params.chainId,
+            tokenNetworkAddress: params.tokenNetworkAddress,
+        }, 'External channel registered');
+        return metadata;
+    }
+    getAllChannels() {
+        return Array.from(this.channelMetadata.values());
+    }
+    async markChannelActivity(channelId) {
+        const metadata = this.channelMetadata.get(channelId);
+        if (!metadata) {
+            this.logger.warn({ channelId }, 'Cannot mark activity: channel not found');
+            return;
+        }
+        metadata.lastActivityAt = new Date();
+        this.logger.debug({ channelId }, 'Channel activity marked');
+    }
+    async openChannelForPeer(peerId, tokenId, options) {
+        const tokenAddress = this.config.tokenAddressMap.get(tokenId);
+        if (!tokenAddress) {
+            throw new Error(`Token address not found for tokenId: ${tokenId}`);
+        }
+        const peerAddress = options?.peerAddress || this.config.peerIdToAddressMap.get(peerId);
+        if (!peerAddress) {
+            throw new Error(`Peer address not found for peerId: ${peerId}`);
+        }
+        this.logger.info({ peerId, peerAddress, source: options?.peerAddress ? 'options' : 'config' }, 'Resolved peer address for channel opening');
+        const settlementTimeout = options?.settlementTimeout ?? this.config.defaultSettlementTimeout;
+        let initialDeposit;
+        if (options?.initialDeposit !== undefined) {
+            initialDeposit = options.initialDeposit;
+        }
+        else {
+            const defaultInitialDeposit = BigInt(1000000000000000000);
+            initialDeposit = defaultInitialDeposit * BigInt(this.config.initialDepositMultiplier);
+        }
+        const { channelId, txHash } = await this.paymentChannelSDK.openChannel(peerAddress, tokenAddress, settlementTimeout, initialDeposit);
+        this.logger.info('Channel opened with transaction', { channelId, txHash });
+        const metadata = {
+            channelId,
+            peerId,
+            tokenId,
+            tokenAddress,
+            chain: options?.chain ?? '',
+            createdAt: new Date(),
+            lastActivityAt: new Date(),
+            status: 'open',
+        };
+        this.channelMetadata.set(channelId, metadata);
+        if (!this.peerChannelIndex.has(peerId)) {
+            this.peerChannelIndex.set(peerId, new Map());
+        }
+        this.peerChannelIndex.get(peerId).set(tokenId, channelId);
+        this.logger.info({ channelId, peerId, tokenId, initialDeposit: initialDeposit.toString() }, 'Channel opened');
+        return channelId;
+    }
+    async checkIdleChannels() {
+        for (const metadata of this.channelMetadata.values()) {
+            if (metadata.status !== 'open') {
+                continue;
+            }
+            if (!this.isChannelIdle(metadata)) {
+                continue;
+            }
+            this.logger.info({ channelId: metadata.channelId, peerId: metadata.peerId }, 'Idle channel detected');
+            await this.closeIdleChannel(metadata.channelId);
+        }
+    }
+    isChannelIdle(metadata) {
+        const idleDuration = Date.now() - metadata.lastActivityAt.getTime();
+        return idleDuration > this.config.idleChannelThreshold * 1000;
+    }
+    async closeIdleChannel(channelId) {
+        const metadata = this.channelMetadata.get(channelId);
+        if (!metadata) {
+            this.logger.error({ channelId }, 'Cannot close channel: metadata not found');
+            return;
+        }
+        metadata.status = 'closing';
+        try {
+            await this.paymentChannelSDK.closeChannel(channelId, metadata.tokenAddress);
+            this.scheduleChallengeSettle(channelId, this.config.defaultSettlementTimeout);
+            this.logger.info({
+                channelId,
+                peerId: metadata.peerId,
+                settlementTimeout: this.config.defaultSettlementTimeout,
+            }, 'Channel close initiated, grace period started');
+        }
+        catch (error) {
+            this.logger.error({ channelId, error }, 'Failed to close channel');
+            metadata.status = 'open';
+            throw error;
+        }
+    }
+    scheduleChallengeSettle(channelId, settlementTimeout) {
+        const settleDelayMs = settlementTimeout * 1000;
+        setTimeout(async () => {
+            await this.settleAfterChallenge(channelId);
+        }, settleDelayMs);
+        this.logger.info({ channelId, settlementTimeout }, 'Scheduled settle after challenge period');
+    }
+    async settleAfterChallenge(channelId) {
+        const metadata = this.channelMetadata.get(channelId);
+        if (!metadata) {
+            this.logger.warn({ channelId }, 'Cannot settle: metadata not found');
+            return;
+        }
+        if (metadata.status !== 'closing') {
+            this.logger.warn({ channelId, status: metadata.status }, 'Channel not in closing state, skipping settle');
+            return;
+        }
+        try {
+            await this.paymentChannelSDK.settleChannel(channelId, metadata.tokenAddress);
+            metadata.status = 'closed';
+            this.logger.info({ channelId }, 'Channel settled after challenge period');
+        }
+        catch (error) {
+            this.logger.error({ channelId, error }, 'Failed to settle channel after challenge period');
+        }
+    }
+}
+exports.ChannelManager = ChannelManager;
+//# sourceMappingURL=channel-manager.js.map

package/dist/settlement/channel-manager.js.map

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

package/dist/settlement/claim-receiver-db-schema.d.ts

@@ -0,0 +1,4 @@
+import type { Database } from 'better-sqlite3';
+export declare const RECEIVED_CLAIMS_SCHEMA = "\n  CREATE TABLE IF NOT EXISTS received_claims (\n    message_id TEXT PRIMARY KEY,\n    peer_id TEXT NOT NULL,\n    blockchain TEXT NOT NULL,\n    channel_id TEXT NOT NULL,\n    claim_data TEXT NOT NULL,\n    verified BOOLEAN NOT NULL,\n    received_at INTEGER NOT NULL,\n    redeemed_at INTEGER,\n    redemption_tx_hash TEXT\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_received_claims_peer ON received_claims(peer_id);\n  CREATE INDEX IF NOT EXISTS idx_received_claims_blockchain_channel ON received_claims(blockchain, channel_id);\n  CREATE INDEX IF NOT EXISTS idx_received_claims_redeemed ON received_claims(redeemed_at) WHERE redeemed_at IS NOT NULL;\n";
+export declare function initializeClaimReceiverSchema(db: Database): void;
+//# sourceMappingURL=claim-receiver-db-schema.d.ts.map

package/dist/settlement/claim-receiver-db-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-receiver-db-schema.d.ts","sourceRoot":"","sources":["../../src/settlement/claim-receiver-db-schema.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAQ/C,eAAO,MAAM,sBAAsB,mpBAgBlC,CAAC;AAOF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAEhE"}

package/dist/settlement/claim-receiver-db-schema.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECEIVED_CLAIMS_SCHEMA = void 0;
+exports.initializeClaimReceiverSchema = initializeClaimReceiverSchema;
+exports.RECEIVED_CLAIMS_SCHEMA = `
+  CREATE TABLE IF NOT EXISTS received_claims (
+    message_id TEXT PRIMARY KEY,
+    peer_id TEXT NOT NULL,
+    blockchain TEXT NOT NULL,
+    channel_id TEXT NOT NULL,
+    claim_data TEXT NOT NULL,
+    verified BOOLEAN NOT NULL,
+    received_at INTEGER NOT NULL,
+    redeemed_at INTEGER,
+    redemption_tx_hash TEXT
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_received_claims_peer ON received_claims(peer_id);
+  CREATE INDEX IF NOT EXISTS idx_received_claims_blockchain_channel ON received_claims(blockchain, channel_id);
+  CREATE INDEX IF NOT EXISTS idx_received_claims_redeemed ON received_claims(redeemed_at) WHERE redeemed_at IS NOT NULL;
+`;
+function initializeClaimReceiverSchema(db) {
+    db.exec(exports.RECEIVED_CLAIMS_SCHEMA);
+}
+//# sourceMappingURL=claim-receiver-db-schema.js.map

package/dist/settlement/claim-receiver-db-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-receiver-db-schema.js","sourceRoot":"","sources":["../../src/settlement/claim-receiver-db-schema.ts"],"names":[],"mappings":";;;AAyCA,sEAEC;AAzBY,QAAA,sBAAsB,GAAG;;;;;;;;;;;;;;;;CAgBrC,CAAC;AAOF,SAAgB,6BAA6B,CAAC,EAAY;IACxD,EAAE,CAAC,IAAI,CAAC,8BAAsB,CAAC,CAAC;AAClC,CAAC"}

package/dist/settlement/claim-receiver.d.ts

@@ -0,0 +1,31 @@
+import type { Database } from 'better-sqlite3';
+import type { Logger } from 'pino';
+import type { BTPServer } from '../btp/btp-server';
+import type { PaymentChannelSDK } from './payment-channel-sdk';
+import type { ChannelManager } from './channel-manager';
+import { type BTPClaimMessage, type BlockchainType } from '../btp/btp-claim-types';
+export declare const ERRORS: {
+    readonly MISSING_SELF_DESCRIBING_FIELDS: "Missing self-describing fields for unknown channel (chainId, tokenNetworkAddress, tokenAddress required)";
+    readonly CHANNEL_NOT_FOUND: "Channel does not exist on-chain";
+    readonly CHANNEL_NOT_OPENED: "Channel not in opened state";
+    readonly SIGNER_NOT_PARTICIPANT: "Signer is not a channel participant";
+    readonly ON_CHAIN_VERIFICATION_FAILED: "On-chain channel verification failed";
+};
+export interface ClaimVerificationResult {
+    valid: boolean;
+    messageId: string;
+    error?: string;
+}
+export declare class ClaimReceiver {
+    private readonly db;
+    private readonly evmChannelSDK;
+    private readonly logger;
+    private readonly channelManager?;
+    constructor(db: Database, evmChannelSDK: PaymentChannelSDK, logger: Logger, channelManager?: ChannelManager | undefined);
+    registerWithBTPServer(btpServer: BTPServer): void;
+    private handleClaimMessage;
+    private verifyEVMClaim;
+    private _persistReceivedClaim;
+    getLatestVerifiedClaim(peerId: string, blockchain: BlockchainType, channelId: string): Promise<BTPClaimMessage | null>;
+}
+//# sourceMappingURL=claim-receiver.d.ts.map

package/dist/settlement/claim-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-receiver.d.ts","sourceRoot":"","sources":["../../src/settlement/claim-receiver.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EAGpB,MAAM,wBAAwB,CAAC;AAMhC,eAAO,MAAM,MAAM;;;;;;CAOT,CAAC;AAKX,MAAM,WAAW,uBAAuB;IAEtC,KAAK,EAAE,OAAO,CAAC;IAEf,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuBD,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAHf,EAAE,EAAE,QAAQ,EACZ,aAAa,EAAE,iBAAiB,EAChC,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,cAAc,YAAA;IAWlD,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;YA4BnC,kBAAkB;YA8ClB,cAAc;IAiM5B,OAAO,CAAC,qBAAqB;IAsDvB,sBAAsB,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CA0BnC"}

package/dist/settlement/claim-receiver.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaimReceiver = exports.ERRORS = void 0;
+const btp_types_1 = require("../btp/btp-types");
+const btp_claim_types_1 = require("../btp/btp-claim-types");
+exports.ERRORS = {
+    MISSING_SELF_DESCRIBING_FIELDS: 'Missing self-describing fields for unknown channel (chainId, tokenNetworkAddress, tokenAddress required)',
+    CHANNEL_NOT_FOUND: 'Channel does not exist on-chain',
+    CHANNEL_NOT_OPENED: 'Channel not in opened state',
+    SIGNER_NOT_PARTICIPANT: 'Signer is not a channel participant',
+    ON_CHAIN_VERIFICATION_FAILED: 'On-chain channel verification failed',
+};
+class ClaimReceiver {
+    db;
+    evmChannelSDK;
+    logger;
+    channelManager;
+    constructor(db, evmChannelSDK, logger, channelManager) {
+        this.db = db;
+        this.evmChannelSDK = evmChannelSDK;
+        this.logger = logger;
+        this.channelManager = channelManager;
+    }
+    registerWithBTPServer(btpServer) {
+        btpServer.onMessage(async (peerId, message) => {
+            if (!(0, btp_types_1.isBTPData)(message)) {
+                return;
+            }
+            for (const protocolData of message.data.protocolData) {
+                if (protocolData.protocolName === 'payment-channel-claim') {
+                    await this.handleClaimMessage(peerId, protocolData);
+                }
+            }
+        });
+        this.logger.info('ClaimReceiver registered with BTP server');
+    }
+    async handleClaimMessage(peerId, protocolData) {
+        const childLogger = this.logger.child({ peerId, protocol: 'claim-receiver' });
+        try {
+            const claimMessage = JSON.parse(protocolData.data.toString('utf8'));
+            (0, btp_claim_types_1.validateClaimMessage)(claimMessage);
+            const messageId = claimMessage.messageId;
+            const blockchain = claimMessage.blockchain;
+            childLogger.info({ messageId, blockchain }, 'Received claim message');
+            if (!(0, btp_claim_types_1.isEVMClaim)(claimMessage)) {
+                throw new Error(`Unsupported blockchain type: ${blockchain}. Only EVM is supported.`);
+            }
+            const verificationResult = await this.verifyEVMClaim(claimMessage, peerId);
+            if (verificationResult.valid) {
+                this._persistReceivedClaim(peerId, claimMessage, true);
+                childLogger.info({ messageId }, 'Claim verified and stored');
+            }
+            else {
+                this._persistReceivedClaim(peerId, claimMessage, false);
+                childLogger.warn({ messageId, error: verificationResult.error }, 'Claim verification failed');
+            }
+        }
+        catch (error) {
+            childLogger.error({ error }, 'Failed to parse claim message');
+        }
+    }
+    async verifyEVMClaim(claim, peerId) {
+        try {
+            const balanceProof = {
+                channelId: claim.channelId,
+                nonce: claim.nonce,
+                transferredAmount: BigInt(claim.transferredAmount),
+                lockedAmount: BigInt(claim.lockedAmount),
+                locksRoot: claim.locksRoot,
+            };
+            this.logger.debug({ channelId: claim.channelId }, 'Checking channel existence in metadata');
+            const knownChannel = this.channelManager?.getChannelById(claim.channelId);
+            if (!knownChannel && this.channelManager) {
+                this.logger.info({ channelId: claim.channelId }, 'Unknown channel detected, starting on-chain verification');
+                if (claim.chainId === undefined || !claim.tokenNetworkAddress || !claim.tokenAddress) {
+                    this.logger.warn({ channelId: claim.channelId, signerAddress: claim.signerAddress }, exports.ERRORS.MISSING_SELF_DESCRIBING_FIELDS);
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: exports.ERRORS.MISSING_SELF_DESCRIBING_FIELDS,
+                    };
+                }
+                let channelState;
+                try {
+                    channelState = await this.evmChannelSDK.getChannelStateByNetwork(claim.channelId, claim.tokenNetworkAddress);
+                }
+                catch (error) {
+                    this.logger.warn({ channelId: claim.channelId, signerAddress: claim.signerAddress, error }, exports.ERRORS.ON_CHAIN_VERIFICATION_FAILED);
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: exports.ERRORS.ON_CHAIN_VERIFICATION_FAILED,
+                    };
+                }
+                if (!channelState.exists) {
+                    this.logger.warn({ channelId: claim.channelId, signerAddress: claim.signerAddress }, exports.ERRORS.CHANNEL_NOT_FOUND);
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: exports.ERRORS.CHANNEL_NOT_FOUND,
+                    };
+                }
+                if (channelState.state !== 1) {
+                    this.logger.warn({ channelId: claim.channelId, signerAddress: claim.signerAddress }, exports.ERRORS.CHANNEL_NOT_OPENED);
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: exports.ERRORS.CHANNEL_NOT_OPENED,
+                    };
+                }
+                const signerLower = claim.signerAddress.toLowerCase();
+                if (signerLower !== channelState.participant1.toLowerCase() &&
+                    signerLower !== channelState.participant2.toLowerCase()) {
+                    this.logger.warn({ channelId: claim.channelId, signerAddress: claim.signerAddress }, exports.ERRORS.SIGNER_NOT_PARTICIPANT);
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: exports.ERRORS.SIGNER_NOT_PARTICIPANT,
+                    };
+                }
+                this.logger.info({
+                    channelId: claim.channelId,
+                    participant1: channelState.participant1,
+                    participant2: channelState.participant2,
+                    state: channelState.state,
+                }, 'On-chain channel verified successfully');
+                const sigValid = await this.evmChannelSDK.verifyBalanceProofWithDomain(balanceProof, claim.signature, claim.signerAddress, claim.chainId, claim.tokenNetworkAddress);
+                if (!sigValid) {
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: 'Invalid EIP-712 signature',
+                    };
+                }
+                this.channelManager.registerExternalChannel({
+                    channelId: claim.channelId,
+                    peerId,
+                    tokenAddress: claim.tokenAddress,
+                    tokenNetworkAddress: claim.tokenNetworkAddress,
+                    chainId: claim.chainId,
+                    status: 'open',
+                });
+                this.logger.info({ channelId: claim.channelId, peerId }, 'External channel registered');
+            }
+            else {
+                const isValid = await this.evmChannelSDK.verifyBalanceProof(balanceProof, claim.signature, claim.signerAddress);
+                if (!isValid) {
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: 'Invalid EIP-712 signature',
+                    };
+                }
+            }
+            const latestClaim = await this.getLatestVerifiedClaim(peerId, 'evm', claim.channelId);
+            if (latestClaim && (0, btp_claim_types_1.isEVMClaim)(latestClaim)) {
+                if (claim.nonce <= latestClaim.nonce) {
+                    return {
+                        valid: false,
+                        messageId: claim.messageId,
+                        error: 'Nonce not monotonically increasing',
+                    };
+                }
+            }
+            return { valid: true, messageId: claim.messageId };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                messageId: claim.messageId,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    _persistReceivedClaim(peerId, claim, verified) {
+        try {
+            const channelId = claim.channelId;
+            const stmt = this.db.prepare(`
+        INSERT INTO received_claims (
+          message_id,
+          peer_id,
+          blockchain,
+          channel_id,
+          claim_data,
+          verified,
+          received_at,
+          redeemed_at,
+          redemption_tx_hash
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `);
+            stmt.run(claim.messageId, peerId, claim.blockchain, channelId, JSON.stringify(claim), verified ? 1 : 0, Date.now(), null, null);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('UNIQUE constraint failed')) {
+                this.logger.warn({ messageId: claim.messageId }, 'Duplicate claim message ignored (idempotency)');
+            }
+            else {
+                this.logger.error({ error }, 'Failed to persist claim to database');
+            }
+        }
+    }
+    async getLatestVerifiedClaim(peerId, blockchain, channelId) {
+        try {
+            const stmt = this.db.prepare(`
+        SELECT claim_data
+        FROM received_claims
+        WHERE peer_id = ?
+          AND blockchain = ?
+          AND channel_id = ?
+          AND verified = 1
+          AND redeemed_at IS NULL
+        ORDER BY received_at DESC
+        LIMIT 1
+      `);
+            const row = stmt.get(peerId, blockchain, channelId);
+            if (!row) {
+                return null;
+            }
+            return JSON.parse(row.claim_data);
+        }
+        catch (error) {
+            this.logger.error({ error }, 'Failed to query latest verified claim');
+            return null;
+        }
+    }
+}
+exports.ClaimReceiver = ClaimReceiver;
+//# sourceMappingURL=claim-receiver.js.map

package/dist/settlement/claim-receiver.js.map

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