@toon-protocol/connector 3.3.1 → 3.3.3

package/dist/settlement/channel-manager.js

@@ -0,0 +1,226 @@
+"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;
+        }
+        const isEVM = params.chain ? params.chain.startsWith('evm') : true;
+        let tokenId = params.tokenAddress;
+        for (const [id, address] of this.config.tokenAddressMap.entries()) {
+            if (isEVM) {
+                if (address.toLowerCase() === params.tokenAddress.toLowerCase()) {
+                    tokenId = id;
+                    break;
+                }
+            }
+            else {
+                if (address === params.tokenAddress) {
+                    tokenId = id;
+                    break;
+                }
+            }
+        }
+        const chain = params.chain ?? (params.chainId !== undefined ? `evm:${params.chainId}` : '');
+        if (!chain) {
+            this.logger.warn({ channelId: params.channelId, peerId: params.peerId }, 'External channel registered without chain identifier (neither chain nor chainId provided)');
+        }
+        const metadata = {
+            channelId: params.channelId,
+            peerId: params.peerId,
+            tokenId,
+            tokenAddress: params.tokenAddress,
+            chain,
+            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,
+            chain,
+        }, '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,67 @@
+import { EventEmitter } from 'events';
+import type { Database } from 'better-sqlite3';
+import type { Logger } from 'pino';
+import type { BTPServer } from '../btp/btp-server';
+import type { ChainProviderRegistry } from './provider/chain-provider-registry';
+import type { ChannelManager } from './channel-manager';
+import { type BTPClaimMessage, type BlockchainType } from '../btp/btp-claim-types';
+import { type NIP59ClaimWrapper } from './privacy/nip59-claim-wrapper';
+export interface ClaimReceivedEvent {
+    peerId: string;
+    channelId: string;
+    cumulativeAmount: bigint;
+}
+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";
+    readonly INVALID_SIGNATURE: "Invalid balance proof signature";
+    readonly NO_PROVIDER_REGISTERED: "No provider registered for blockchain:";
+};
+export interface ClaimVerificationResult {
+    valid: boolean;
+    messageId: string;
+    error?: string;
+}
+export declare class ClaimReceiver extends EventEmitter {
+    private readonly db;
+    private readonly chainProviderRegistry;
+    private readonly logger;
+    private readonly channelManager?;
+    private readonly peerIdToAddressMap?;
+    private readonly _nip59Wrapper?;
+    private readonly _nodePrivateKey?;
+    constructor(db: Database, chainProviderRegistry: ChainProviderRegistry, logger: Logger, channelManager?: ChannelManager | undefined, peerIdToAddressMap?: Map<string, string> | undefined, _nip59Wrapper?: NIP59ClaimWrapper | undefined, _nodePrivateKey?: Uint8Array | undefined);
+    registerWithBTPServer(btpServer: BTPServer): void;
+    private handleWrappedClaimMessage;
+    private handleClaimMessage;
+    private resolveProvider;
+    private verifyClaim;
+    private verifyEVMClaim;
+    private buildVerifyParams;
+    private verifySolanaClaim;
+    private buildSolanaVerifyParams;
+    private verifyMinaClaim;
+    private buildMinaVerifyParams;
+    private _persistReceivedClaim;
+    getLatestVerifiedClaim(peerId: string, blockchain: BlockchainType, channelId: string): Promise<BTPClaimMessage | null>;
+    getRecentClaims(limit?: number): Promise<Array<{
+        messageId: string;
+        peerId: string;
+        blockchain: BlockchainType;
+        channelId: string;
+        claimData: BTPClaimMessage;
+        receivedAt: number;
+    }>>;
+    getLastClaimAt(peerId: string, blockchain: BlockchainType): Promise<number | null>;
+    getCumulativeInboundByAsset(peerId: string): Promise<Map<string, {
+        blockchain: BlockchainType;
+        tokenAddress: string;
+        total: bigint;
+        lastAt: number;
+    }>>;
+    getLatestVerifiedClaimForChannel(peerId: string, 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":"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"}