@toon-protocol/connector 3.3.0 → 3.3.2

package/dist/http/admin-api.d.ts

@@ -0,0 +1,182 @@
+import type { Router } from 'express';
+import { Logger } from '../utils/logger';
+import { RoutingTable } from '../routing/routing-table';
+import { BTPClientManager } from '../btp/btp-client-manager';
+import { AdminSettlementConfig, PeerConfig as SettlementPeerConfig } from '../settlement/types';
+import type { AdminChannelStatus } from '../settlement/types';
+import type { ChannelManager } from '../settlement/channel-manager';
+import type { PaymentChannelSDK } from '../settlement/payment-channel-sdk';
+import type { AccountManager } from '../settlement/account-manager';
+import type { SettlementMonitor } from '../settlement/settlement-monitor';
+import type { ClaimReceiver } from '../settlement/claim-receiver';
+import type { SentClaimsQueries } from '../settlement/sent-claims-queries';
+import type { PacketSenderFn, IsReadyFn } from './ilp-send-handler';
+import type { IlpMetricsRegistry } from '../observability/metrics-registry';
+export interface AdminAPIConfig {
+    routingTable: RoutingTable;
+    btpClientManager: BTPClientManager;
+    logger: Logger;
+    apiKey?: string;
+    allowedIPs?: string[];
+    trustProxy?: boolean;
+    nodeId: string;
+    settlementPeers?: Map<string, SettlementPeerConfig>;
+    channelManager?: ChannelManager;
+    paymentChannelSDK?: PaymentChannelSDK;
+    accountManager?: AccountManager;
+    settlementMonitor?: SettlementMonitor;
+    claimReceiver?: ClaimReceiver;
+    sentClaimsQueries?: SentClaimsQueries;
+    packetSender?: PacketSenderFn;
+    isReady?: IsReadyFn;
+    defaultSettlementTokenId?: string;
+    metricsRegistry?: IlpMetricsRegistry;
+    resolveTokenMetadata?: (blockchain: 'evm' | 'solana' | 'mina', tokenAddress: string) => Promise<{
+        assetCode: string;
+        assetScale: number;
+    }>;
+    connectorFeePercentage?: number;
+}
+export interface AddPeerRequest {
+    id: string;
+    url: string;
+    authToken: string;
+    routes?: Array<{
+        prefix: string;
+        priority?: number;
+    }>;
+    settlement?: AdminSettlementConfig;
+}
+export interface AddRouteRequest {
+    prefix: string;
+    nextHop: string;
+    priority?: number;
+}
+export interface BalanceResponse {
+    peerId: string;
+    balances: Array<{
+        tokenId: string;
+        debitBalance: string;
+        creditBalance: string;
+        netBalance: string;
+    }>;
+}
+export interface AdminEarningsByAsset {
+    assetCode: string;
+    assetScale: number;
+    claimsReceivedTotal: string;
+    claimsSentTotal: string;
+    netBalance: string;
+    lastClaimAt: string | null;
+}
+export interface AdminEarningsJsonPeer {
+    peerId: string;
+    byAsset: AdminEarningsByAsset[];
+}
+export interface AdminEarningsConnectorFee {
+    assetCode: string;
+    assetScale: number;
+    total: string;
+}
+export interface AdminEarningsRecentClaim {
+    peerId: string;
+    assetCode: string;
+    assetScale: number;
+    amount: string;
+    direction: 'inbound' | 'outbound';
+    at: string;
+}
+export interface AdminEarningsJsonResponse {
+    uptimeSeconds: number;
+    peers: AdminEarningsJsonPeer[];
+    connectorFees: AdminEarningsConnectorFee[];
+    recentClaims: AdminEarningsRecentClaim[];
+    timestamp: string;
+}
+export interface AdminMetricsJsonPeer {
+    peerId: string;
+    connected: boolean;
+    packetsForwarded: number;
+    packetsRejected: number;
+    bytesSent: number;
+    lastPacketAt: string | null;
+}
+export interface AdminMetricsJsonResponse {
+    uptimeSeconds: number;
+    aggregate: {
+        packetsForwarded: number;
+        packetsRejected: number;
+        bytesSent: number;
+    };
+    peers: AdminMetricsJsonPeer[];
+    timestamp: string;
+}
+export interface SettlementStateResponse {
+    peerId: string;
+    tokenId: string;
+    state: string;
+}
+export declare function createAdminRouter(config: AdminAPIConfig): Promise<Router>;
+export interface AdminServerConfig {
+    port?: number;
+    host?: string;
+    apiKey?: string;
+    enabled?: boolean;
+}
+export declare const CHAIN_FORMAT_REGEX: RegExp;
+export interface OpenChannelRequest {
+    peerId: string;
+    chain: string;
+    token?: string;
+    tokenNetwork?: string;
+    initialDeposit: string;
+    settlementTimeout?: number;
+    peerAddress?: string;
+}
+export interface OpenChannelResponse {
+    channelId: string;
+    chain: string;
+    status: AdminChannelStatus;
+    deposit: string;
+}
+export interface ChannelSummary {
+    channelId: string;
+    peerId: string;
+    chain: string;
+    status: AdminChannelStatus;
+    deposit: string;
+    lastActivity: string;
+}
+export interface ChannelDetailResponse {
+    channelId: string;
+    status: AdminChannelStatus;
+    deposit: string;
+    [key: string]: unknown;
+}
+export interface DepositRequest {
+    amount: string;
+    token?: string;
+}
+export interface DepositResponse {
+    channelId: string;
+    newDeposit: string;
+    status: AdminChannelStatus;
+}
+export interface CloseChannelRequest {
+    cooperative?: boolean;
+}
+export interface CloseChannelResponse {
+    channelId: string;
+    status: AdminChannelStatus;
+    txHash?: string;
+}
+export declare function validateDepositRequest(body: Record<string, unknown>): {
+    valid: boolean;
+    error?: string;
+};
+export declare function validateSettlementConfig(s: AdminSettlementConfig): string | null;
+export declare function validateOpenChannelRequest(body: Record<string, unknown>): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=admin-api.d.ts.map

package/dist/http/admin-api.d.ts.map

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