@toon-protocol/connector 3.3.1 → 3.3.2

package/dist/settlement/settlement-executor.js

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettlementExecutor = void 0;
+const tslib_1 = require("tslib");
+const events_1 = tslib_1.__importDefault(require("events"));
+const btp_claim_types_1 = require("../btp/btp-claim-types");
+class SettlementExecutor extends events_1.default {
+    config;
+    accountManager;
+    chainProviderRegistry;
+    settlementMonitor;
+    logger;
+    boundHandleSettlement;
+    perPacketClaimService = null;
+    claimReceiver = null;
+    channelManager = null;
+    settlementChain = Promise.resolve();
+    stopping = false;
+    constructor(config, accountManager, chainProviderRegistry, settlementMonitor, logger) {
+        super();
+        this.config = config;
+        this.accountManager = accountManager;
+        this.chainProviderRegistry = chainProviderRegistry;
+        this.settlementMonitor = settlementMonitor;
+        this.logger = logger.child({ component: 'settlement-executor' });
+        this.boundHandleSettlement = this.handleSettlement.bind(this);
+        this.logger.info({
+            nodeId: config.nodeId,
+            defaultSettlementTimeout: config.defaultSettlementTimeout,
+        }, 'Settlement executor initialized');
+    }
+    setPerPacketClaimService(service) {
+        this.perPacketClaimService = service;
+        this.logger.info('PerPacketClaimService set for on-chain settlement');
+    }
+    setClaimReceiver(receiver) {
+        this.claimReceiver = receiver;
+        this.logger.info('ClaimReceiver set for on-chain settlement');
+    }
+    setChannelManager(channelManager) {
+        this.channelManager = channelManager;
+        this.logger.info('ChannelManager set for channel lookup');
+    }
+    start() {
+        this.stopping = false;
+        this.settlementChain = Promise.resolve();
+        this.settlementMonitor.on('SETTLEMENT_REQUIRED', this.boundHandleSettlement);
+        this.logger.info('Settlement executor started');
+    }
+    async stop() {
+        this.stopping = true;
+        this.settlementMonitor.off('SETTLEMENT_REQUIRED', this.boundHandleSettlement);
+        await this.settlementChain;
+        this.logger.info('Settlement executor stopped (all in-flight settlements drained)');
+    }
+    handleSettlement(event) {
+        if (this.stopping) {
+            this.logger.warn({ peerId: event.peerId, tokenId: event.tokenId }, 'Settlement event ignored during shutdown');
+            return;
+        }
+        this.settlementChain = this.settlementChain.then(() => this._processSettlement(event));
+    }
+    async _processSettlement(event) {
+        this.logger.info({
+            peerId: event.peerId,
+            tokenId: event.tokenId,
+            currentBalance: event.currentBalance.toString(),
+            threshold: event.threshold.toString(),
+            exceedsBy: event.exceedsBy.toString(),
+        }, 'Settlement event received');
+        this.settlementMonitor.markSettlementInProgress(event.peerId, event.tokenId);
+        this.logger.info({ peerId: event.peerId, tokenId: event.tokenId }, 'Marked settlement in progress');
+        try {
+            await this.executeSettlement(event);
+            this.settlementMonitor.markSettlementCompleted(event.peerId, event.tokenId);
+            this.logger.info({ peerId: event.peerId, tokenId: event.tokenId }, 'Settlement completed, state reset to IDLE');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const errorStack = error instanceof Error ? error.stack : undefined;
+            this.logger.error({
+                errorMessage,
+                errorStack,
+                errorType: error?.constructor?.name,
+                peerId: event.peerId,
+                tokenId: event.tokenId,
+            }, 'Settlement failed');
+        }
+    }
+    async executeSettlement(event) {
+        const { peerId, tokenId, currentBalance } = event;
+        this.logger.info({ peerId, tokenId, currentBalance: currentBalance.toString() }, 'Executing settlement');
+        const chain = this.config.peerIdToChainMap.get(peerId);
+        if (!chain) {
+            throw new Error(`No chain configured for peer: ${peerId}`);
+        }
+        const provider = this.chainProviderRegistry.getProviderForPeer({ peerId, chain });
+        if (!provider) {
+            throw new Error(`No provider registered for chain: ${chain} (peer: ${peerId})`);
+        }
+        const tokenAddress = this.config.tokenAddressMap.get(tokenId);
+        if (!tokenAddress) {
+            this.logger.error({ tokenId, availableTokens: Array.from(this.config.tokenAddressMap.keys()) }, 'Token address not found');
+            throw new Error(`Token address not found for tokenId: ${tokenId}`);
+        }
+        this.logger.debug({ tokenId, tokenAddress, chain }, 'Token address resolved');
+        this.logger.debug({ peerId, tokenId }, 'Searching for existing channel');
+        const channelId = await this.findChannelForPeer(peerId, tokenId);
+        if (!channelId) {
+            this.logger.info({ peerId, tokenId, tokenAddress }, 'No existing channel found, opening new channel');
+            await this.openChannelAndSettle(peerId, tokenId, tokenAddress, currentBalance, provider);
+        }
+        else {
+            this.logger.info({ peerId, tokenId, channelId }, 'Using existing channel for settlement');
+            await this.settleViaExistingChannel(channelId, peerId, tokenId, currentBalance, provider);
+        }
+    }
+    async findChannelForPeer(peerId, tokenId) {
+        try {
+            if (!this.channelManager) {
+                this.logger.warn({ peerId }, 'ChannelManager not set, cannot look up channels');
+                return null;
+            }
+            const metadata = this.channelManager.getChannelForPeer(peerId, tokenId);
+            if (!metadata) {
+                return null;
+            }
+            if (metadata.status === 'open') {
+                return metadata.channelId;
+            }
+            return null;
+        }
+        catch (error) {
+            this.logger.error({ error, peerId, tokenId }, 'Failed to find channel for peer');
+            return null;
+        }
+    }
+    async openChannelAndSettle(peerId, tokenId, tokenAddress, amount, provider) {
+        const initialDeposit = amount * BigInt(this.config.initialDepositMultiplier);
+        const peerAddress = this.config.peerIdToAddressMap.get(peerId);
+        if (!peerAddress) {
+            throw new Error(`Peer address not found for peerId: ${peerId}`);
+        }
+        this.logger.info({
+            peerId,
+            tokenId,
+            tokenAddress,
+            peerAddress,
+            initialDeposit: initialDeposit.toString(),
+        }, 'Opening new payment channel');
+        const { channelId, txHash } = await this.retryWithBackoff(async () => await provider.openChannel(peerAddress, this.config.defaultSettlementTimeout), 'openChannel', this.config.maxRetries);
+        this.logger.info({
+            channelId,
+            peerId,
+            tokenId,
+            txHash,
+        }, 'Channel opened, depositing initial funds');
+        await this.retryWithBackoff(async () => await provider.deposit(channelId, initialDeposit.toString()), 'deposit', this.config.maxRetries);
+        this.logger.info({
+            channelId,
+            peerId,
+            tokenId,
+            initialDeposit: initialDeposit.toString(),
+        }, 'Channel funded for settlement');
+        await this.accountManager.recordSettlement(peerId, tokenId, amount);
+        this.logger.info({ peerId, tokenId, amount: amount.toString() }, 'TigerBeetle balance updated after channel deposit');
+        this.emit('CHANNEL_ACTIVITY', { channelId });
+        return channelId;
+    }
+    async settleViaExistingChannel(channelId, peerId, tokenId, amount, provider) {
+        const receivedClaim = this.claimReceiver
+            ? await this.claimReceiver.getLatestVerifiedClaimForChannel(peerId, channelId)
+            : null;
+        const sentClaim = this.perPacketClaimService?.getLatestClaim(channelId) ?? null;
+        const latestClaim = receivedClaim ?? sentClaim;
+        if (!latestClaim || !(0, btp_claim_types_1.isEVMClaim)(latestClaim)) {
+            this.logger.error({ channelId, peerId }, 'No per-packet claim available for settlement — cannot compute balance proof without chain-specific state');
+            throw new Error(`No per-packet claim available for channel ${channelId}`);
+        }
+        const balanceProofParams = {
+            channelId,
+            nonce: latestClaim.nonce,
+            transferredAmount: latestClaim.transferredAmount,
+            lockedAmount: latestClaim.lockedAmount,
+            locksRoot: latestClaim.locksRoot,
+        };
+        const claimSignature = latestClaim.signature;
+        this.logger.info({
+            channelId,
+            nonce: latestClaim.nonce,
+            transferred: latestClaim.transferredAmount,
+        }, 'Using latest per-packet claim for on-chain settlement (claimFromChannel)');
+        await this.retryWithBackoff(async () => await provider.claimFromChannel(channelId, balanceProofParams, claimSignature), 'claimFromChannel', this.config.maxRetries);
+        this.logger.info({ channelId, amount: amount.toString() }, 'Claim from channel completed — channel remains open');
+        await this.accountManager.recordSettlement(peerId, tokenId, amount);
+        if (this.perPacketClaimService) {
+            this.perPacketClaimService.resetChannel(channelId);
+        }
+        this.logger.info({ peerId, tokenId, amount: amount.toString() }, 'Accounting balance updated after claim');
+        this.emit('CHANNEL_ACTIVITY', { channelId });
+    }
+    async retryWithBackoff(operation, operationName, maxRetries) {
+        let lastError;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (!this.isRetryableError(lastError)) {
+                    this.logger.error({ error: lastError, operationName }, 'Non-retryable error, aborting');
+                    throw lastError;
+                }
+                if (attempt < maxRetries) {
+                    const delayMs = this.config.retryDelayMs * 2 ** (attempt - 1);
+                    this.logger.warn({ attempt, maxRetries, operationName, delayMs, error: lastError.message }, 'Retrying settlement operation');
+                    await new Promise((resolve) => setTimeout(resolve, delayMs));
+                }
+            }
+        }
+        this.logger.error({ operationName, maxRetries }, 'Max retries exhausted');
+        throw lastError;
+    }
+    isRetryableError(error) {
+        const errorMessage = error.message.toLowerCase();
+        if (errorMessage.includes('timeout') ||
+            errorMessage.includes('network') ||
+            errorMessage.includes('gas price') ||
+            errorMessage.includes('nonce too low') ||
+            errorMessage.includes('replacement') ||
+            errorMessage.includes('already known') ||
+            errorMessage.includes('nonce has already been used')) {
+            return true;
+        }
+        if (errorMessage.includes('insufficient funds') ||
+            errorMessage.includes('channel closed') ||
+            errorMessage.includes('invalid signature') ||
+            errorMessage.includes('challenge not expired') ||
+            error.constructor.name === 'ChallengeNotExpiredError') {
+            return false;
+        }
+        return false;
+    }
+    registerPeerChain(peerId, chainId) {
+        const existingChain = this.config.peerIdToChainMap.get(peerId);
+        this.config.peerIdToChainMap.set(peerId, chainId);
+        if (existingChain && existingChain !== chainId) {
+            this.logger.info({ event: 'peer_chain_updated', peerId, oldChain: existingChain, newChain: chainId }, 'Peer chain mapping updated');
+        }
+        else if (!existingChain) {
+            this.logger.info({ event: 'peer_chain_registered', peerId, chainId }, 'Peer chain mapping registered');
+        }
+    }
+    registerPeerAddress(peerId, address) {
+        if (!this.config.peerIdToAddressMap.has(peerId)) {
+            this.config.peerIdToAddressMap.set(peerId, address);
+            this.logger.info({ event: 'peer_address_registered', peerId }, 'Peer settlement address registered');
+        }
+    }
+    getSettlementState(peerId, tokenId) {
+        return this.settlementMonitor.getSettlementState(peerId, tokenId);
+    }
+}
+exports.SettlementExecutor = SettlementExecutor;
+//# sourceMappingURL=settlement-executor.js.map

package/dist/settlement/settlement-executor.js.map

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

package/dist/settlement/settlement-monitor.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from 'events';
+import type { Logger } from 'pino';
+import type { SettlementThresholdConfig } from '../config/types';
+import { SettlementState } from '../config/types';
+import type { ClaimReceiver } from './claim-receiver';
+export interface SettlementMonitorConfig {
+    thresholds?: SettlementThresholdConfig;
+    peers: string[];
+    tokenIds: string[];
+}
+export declare class SettlementMonitor extends EventEmitter {
+    private readonly _config;
+    private readonly _logger;
+    private readonly _settlementStates;
+    private readonly _lastSettlementTime;
+    private _claimReceiver;
+    private readonly _boundHandleClaimReceived;
+    private _isRunning;
+    constructor(config: SettlementMonitorConfig, logger: Logger);
+    setClaimReceiver(claimReceiver: ClaimReceiver): void;
+    start(): void;
+    stop(): void;
+    private _getThresholdForPeer;
+    private _handleClaimReceived;
+    getSettlementState(peerId: string, tokenId: string): SettlementState;
+    markSettlementInProgress(peerId: string, tokenId: string): void;
+    markSettlementCompleted(peerId: string, tokenId: string): void;
+    getAllSettlementStates(): Map<string, SettlementState>;
+}
+//# sourceMappingURL=settlement-monitor.d.ts.map

package/dist/settlement/settlement-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-monitor.d.ts","sourceRoot":"","sources":["../../src/settlement/settlement-monitor.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,yBAAyB,EAA0B,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,kBAAkB,CAAC;AAW1E,MAAM,WAAW,uBAAuB;IAMtC,UAAU,CAAC,EAAE,yBAAyB,CAAC;IAOvC,KAAK,EAAE,MAAM,EAAE,CAAC;IAOhB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAsCD,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA+B;IACjE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAsC;IAChF,OAAO,CAAC,UAAU,CAAU;gBAQhB,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM;IAuC3D,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAapD,KAAK,IAAI,IAAI;IAuBb,IAAI,IAAI,IAAI;IAwBZ,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,oBAAoB;IA+E5B,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe;IAcpE,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiB/D,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAe9D,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;CAIvD"}

package/dist/settlement/settlement-monitor.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettlementMonitor = void 0;
+const events_1 = require("events");
+const types_1 = require("../config/types");
+class SettlementMonitor extends events_1.EventEmitter {
+    _config;
+    _logger;
+    _settlementStates;
+    _lastSettlementTime;
+    _claimReceiver;
+    _boundHandleClaimReceived;
+    _isRunning;
+    constructor(config, logger) {
+        super();
+        this._config = config;
+        this._logger = logger.child({ component: 'settlement-monitor' });
+        this._settlementStates = new Map();
+        this._lastSettlementTime = new Map();
+        this._claimReceiver = null;
+        this._boundHandleClaimReceived = this._handleClaimReceived.bind(this);
+        this._isRunning = false;
+        for (const peerId of this._config.peers) {
+            for (const tokenId of this._config.tokenIds) {
+                const stateKey = `${peerId}:${tokenId}`;
+                this._settlementStates.set(stateKey, types_1.SettlementState.IDLE);
+            }
+        }
+        this._logger.info({
+            defaultThreshold: this._config.thresholds?.defaultThreshold?.toString(),
+            peerCount: this._config.peers.length,
+            tokenCount: this._config.tokenIds.length,
+        }, 'Settlement monitor initialized (event-driven)');
+    }
+    setClaimReceiver(claimReceiver) {
+        this._claimReceiver = claimReceiver;
+        this._logger.info('ClaimReceiver set for event-driven settlement monitoring');
+    }
+    start() {
+        if (this._isRunning) {
+            throw new Error('Settlement monitor already running');
+        }
+        this._isRunning = true;
+        if (this._claimReceiver) {
+            this._claimReceiver.on('CLAIM_RECEIVED', this._boundHandleClaimReceived);
+            this._logger.info('Settlement monitor started (subscribed to ClaimReceiver events)');
+        }
+        else {
+            this._logger.warn('Settlement monitor started without ClaimReceiver — no events will be processed. ' +
+                'Call setClaimReceiver() and restart to enable event-driven settlement.');
+        }
+    }
+    stop() {
+        if (this._claimReceiver) {
+            this._claimReceiver.off('CLAIM_RECEIVED', this._boundHandleClaimReceived);
+        }
+        this._isRunning = false;
+        this._logger.info('Settlement monitor stopped');
+    }
+    _getThresholdForPeer(peerId, tokenId) {
+        if (!this._config.thresholds) {
+            return undefined;
+        }
+        const tokenSpecificThreshold = this._config.thresholds.perTokenThresholds
+            ?.get(peerId)
+            ?.get(tokenId);
+        if (tokenSpecificThreshold !== undefined) {
+            return tokenSpecificThreshold;
+        }
+        const perPeerThreshold = this._config.thresholds.perPeerThresholds?.get(peerId);
+        if (perPeerThreshold !== undefined) {
+            return perPeerThreshold;
+        }
+        return this._config.thresholds.defaultThreshold;
+    }
+    _handleClaimReceived(event) {
+        try {
+            const { peerId, channelId, cumulativeAmount } = event;
+            this._logger.debug({ peerId, channelId, cumulativeAmount: cumulativeAmount.toString() }, 'Processing claim for settlement threshold check');
+            for (const tokenId of this._config.tokenIds) {
+                const threshold = this._getThresholdForPeer(peerId, tokenId);
+                if (!threshold) {
+                    continue;
+                }
+                const stateKey = `${peerId}:${tokenId}`;
+                const currentState = this._settlementStates.get(stateKey) ?? types_1.SettlementState.IDLE;
+                if (cumulativeAmount > threshold) {
+                    if (currentState === types_1.SettlementState.IDLE) {
+                        const exceedsBy = cumulativeAmount - threshold;
+                        const triggerEvent = {
+                            peerId,
+                            tokenId,
+                            currentBalance: cumulativeAmount,
+                            threshold,
+                            exceedsBy,
+                            timestamp: new Date(),
+                        };
+                        this.emit('SETTLEMENT_REQUIRED', triggerEvent);
+                        this._settlementStates.set(stateKey, types_1.SettlementState.SETTLEMENT_PENDING);
+                        this._logger.warn({
+                            peerId,
+                            tokenId,
+                            channelId,
+                            cumulativeAmount: cumulativeAmount.toString(),
+                            threshold: threshold.toString(),
+                            exceedsBy: exceedsBy.toString(),
+                        }, 'Settlement threshold exceeded — triggering claimFromChannel()');
+                    }
+                    else {
+                        this._logger.debug({ peerId, tokenId, state: currentState }, 'Settlement already pending/in-progress, skipping duplicate trigger');
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this._logger.error({
+                error: error instanceof Error ? error.message : String(error),
+            }, 'Settlement threshold check failed for claim event');
+        }
+    }
+    getSettlementState(peerId, tokenId) {
+        const stateKey = `${peerId}:${tokenId}`;
+        return this._settlementStates.get(stateKey) ?? types_1.SettlementState.IDLE;
+    }
+    markSettlementInProgress(peerId, tokenId) {
+        const stateKey = `${peerId}:${tokenId}`;
+        this._settlementStates.set(stateKey, types_1.SettlementState.SETTLEMENT_IN_PROGRESS);
+        this._logger.info({ peerId, tokenId }, 'Settlement marked in progress');
+    }
+    markSettlementCompleted(peerId, tokenId) {
+        const stateKey = `${peerId}:${tokenId}`;
+        this._settlementStates.set(stateKey, types_1.SettlementState.IDLE);
+        this._lastSettlementTime.set(stateKey, Date.now());
+        this._logger.info({ peerId, tokenId }, 'Settlement completed, state reset to IDLE');
+    }
+    getAllSettlementStates() {
+        return new Map(this._settlementStates);
+    }
+}
+exports.SettlementMonitor = SettlementMonitor;
+//# sourceMappingURL=settlement-monitor.js.map

package/dist/settlement/settlement-monitor.js.map

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

package/dist/settlement/solana-payment-channel-sdk.d.ts

@@ -0,0 +1,79 @@
+import type { Logger } from '../utils/logger';
+import { generateKeyPairSigner } from '@solana/kit';
+import type { TransactionSigner, Instruction } from '@solana/kit';
+interface Ed25519KeyPair {
+    readonly publicKey: unknown;
+    readonly privateKey: unknown;
+}
+export interface SolanaChannelState {
+    participantA: string;
+    participantB: string;
+    tokenMint: string;
+    depositA: bigint;
+    depositB: bigint;
+    transferredAmountA: bigint;
+    transferredAmountB: bigint;
+    nonceA: bigint;
+    nonceB: bigint;
+    challengeDuration: bigint;
+    state: 'opened' | 'closed' | 'settled';
+    closeTimestamp: bigint;
+    bump: number;
+}
+export declare class SolanaChannelError extends Error {
+    readonly code: number;
+    readonly errorName: string;
+    constructor(message: string, code: number, errorName: string);
+}
+export declare function mapProgramError(code: number): SolanaChannelError;
+export declare function parseSolanaError(err: unknown): never;
+export declare function deserializeChannelState(data: Uint8Array): SolanaChannelState;
+export declare function buildEd25519PrecompileInstruction(signature: Uint8Array, pubkey: Uint8Array, message: Uint8Array): Instruction;
+export declare class SolanaPaymentChannelSDK {
+    private readonly _rpc;
+    private readonly _rpcSubscriptions;
+    private readonly _programId;
+    private readonly _logger;
+    constructor(rpcUrl: string, programId: string, logger: Logger);
+    static deriveChannelPDA(participantA: string, participantB: string, tokenMint: string, programId: string): {
+        pda: string;
+        bump: number;
+    };
+    static deriveVaultPDA(channelPDA: string, programId: string): {
+        pda: string;
+        bump: number;
+    };
+    static _buildBalanceProofMessage(channelPDA: string, nonce: bigint, transferredAmount: bigint): Uint8Array;
+    static signBalanceProof(channelPDA: string, nonce: bigint, transferredAmount: bigint, keypair: Ed25519KeyPair): Promise<Uint8Array>;
+    openChannel(payer: TransactionSigner, participantA: string, participantB: string, tokenMint: string, challengeDuration: bigint): Promise<{
+        channelPDA: string;
+        txSignature: string;
+    }>;
+    deposit(depositor: TransactionSigner, channelPDA: string, depositorTokenAccount: string, amount: bigint): Promise<{
+        txSignature: string;
+    }>;
+    claimFromChannel(claimer: TransactionSigner, channelPDA: string, nonce: bigint, transferredAmount: bigint, signature: Uint8Array): Promise<{
+        txSignature: string;
+    }>;
+    closeChannel(closer: TransactionSigner, channelPDA: string): Promise<{
+        txSignature: string;
+    }>;
+    settleChannel(caller: TransactionSigner, channelPDA: string, participantAToken: string, participantBToken: string, rentRecipient: string): Promise<{
+        txSignature: string;
+    }>;
+    forceCloseExpired(caller: TransactionSigner, channelPDA: string, participantAToken: string, participantBToken: string, rentRecipient: string): Promise<{
+        txSignature: string;
+    }>;
+    getMintMetadata(mintAddress: string): Promise<{
+        assetCode: string;
+        assetScale: number;
+    }>;
+    getChannelState(channelPDA: string): Promise<SolanaChannelState>;
+    subscribeToChannel(channelPDA: string, callback: (state: SolanaChannelState) => void): {
+        unsubscribe: () => void;
+    };
+    private _runSubscriptionLoop;
+    private _sendTransaction;
+}
+export { generateKeyPairSigner };
+//# sourceMappingURL=solana-payment-channel-sdk.d.ts.map

package/dist/settlement/solana-payment-channel-sdk.d.ts.map

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