@toon-protocol/connector 3.3.0 → 3.3.2

package/dist/settlement/in-memory-ledger-client.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryLedgerClient = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("node:fs/promises"));
+const path = tslib_1.__importStar(require("node:path"));
+const tigerbeetle_errors_1 = require("./tigerbeetle-errors");
+const DEFAULT_PERSIST_INTERVAL_MS = 30_000;
+class InMemoryLedgerClient {
+    _logger;
+    _accounts = new Map();
+    _dirty = false;
+    _persistTimer = null;
+    _initialized = false;
+    _snapshotPath;
+    _persistIntervalMs;
+    constructor(config, _logger) {
+        this._logger = _logger;
+        this._snapshotPath = config.snapshotPath;
+        this._persistIntervalMs = config.persistIntervalMs ?? DEFAULT_PERSIST_INTERVAL_MS;
+    }
+    async initialize() {
+        if (this._initialized) {
+            this._logger.warn('InMemoryLedgerClient already initialized, skipping');
+            return;
+        }
+        this._logger.info({ snapshotPath: this._snapshotPath, persistIntervalMs: this._persistIntervalMs }, 'Initializing InMemoryLedgerClient');
+        await fs.mkdir(path.dirname(this._snapshotPath), { recursive: true });
+        await this._restoreSnapshot();
+        this._persistTimer = setInterval(() => {
+            this._persistSnapshot().catch((err) => {
+                this._logger.error({ err }, 'Unexpected error in persistence timer callback');
+            });
+        }, this._persistIntervalMs);
+        if (this._persistTimer.unref) {
+            this._persistTimer.unref();
+        }
+        this._initialized = true;
+        this._logger.info({ accountCount: this._accounts.size }, 'InMemoryLedgerClient initialized');
+    }
+    async close() {
+        if (this._persistTimer) {
+            clearInterval(this._persistTimer);
+            this._persistTimer = null;
+        }
+        await this._persistSnapshot();
+        this._initialized = false;
+        this._logger.info('InMemoryLedgerClient closed');
+    }
+    async createAccountsBatch(accounts) {
+        this._ensureInitialized();
+        let created = 0;
+        for (const spec of accounts) {
+            if (!this._accounts.has(spec.id)) {
+                this._accounts.set(spec.id, { debits_posted: 0n, credits_posted: 0n });
+                created++;
+            }
+        }
+        if (created > 0) {
+            this._dirty = true;
+            this._logger.debug({ created, total: accounts.length }, 'Accounts created in in-memory ledger');
+        }
+    }
+    async createTransfersBatch(transfers) {
+        this._ensureInitialized();
+        for (const transfer of transfers) {
+            if (transfer.amount <= 0n) {
+                throw new tigerbeetle_errors_1.TigerBeetleTransferError(`Transfer amount must be positive, got ${transfer.amount}`, transfer.id, transfer.debit_account_id, transfer.credit_account_id);
+            }
+            if (!this._accounts.has(transfer.debit_account_id)) {
+                throw new tigerbeetle_errors_1.TigerBeetleTransferError(`Debit account not found: ${transfer.debit_account_id}`, transfer.id, transfer.debit_account_id, transfer.credit_account_id);
+            }
+            if (!this._accounts.has(transfer.credit_account_id)) {
+                throw new tigerbeetle_errors_1.TigerBeetleTransferError(`Credit account not found: ${transfer.credit_account_id}`, transfer.id, transfer.debit_account_id, transfer.credit_account_id);
+            }
+        }
+        for (const transfer of transfers) {
+            const debitAccount = this._accounts.get(transfer.debit_account_id);
+            const creditAccount = this._accounts.get(transfer.credit_account_id);
+            debitAccount.debits_posted += transfer.amount;
+            creditAccount.credits_posted += transfer.amount;
+        }
+        this._dirty = true;
+        this._logger.debug({ transferCount: transfers.length }, 'Transfers applied in in-memory ledger');
+    }
+    async getAccountBalance(accountId) {
+        this._ensureInitialized();
+        const account = this._accounts.get(accountId);
+        if (!account) {
+            throw new tigerbeetle_errors_1.TigerBeetleAccountError(`Account not found: ${accountId}`, accountId);
+        }
+        return {
+            debits: account.debits_posted,
+            credits: account.credits_posted,
+            balance: account.credits_posted - account.debits_posted,
+        };
+    }
+    async getAccountsBatch(accountIds) {
+        this._ensureInitialized();
+        const balances = new Map();
+        for (const id of accountIds) {
+            const account = this._accounts.get(id);
+            if (account) {
+                balances.set(id, {
+                    debits: account.debits_posted,
+                    credits: account.credits_posted,
+                    balance: account.credits_posted - account.debits_posted,
+                });
+            }
+        }
+        return balances;
+    }
+    async _persistSnapshot() {
+        if (!this._dirty) {
+            return;
+        }
+        const tmpPath = `${this._snapshotPath}.tmp`;
+        try {
+            const snapshot = [];
+            for (const [id, account] of this._accounts) {
+                snapshot.push([
+                    id.toString(),
+                    {
+                        debits_posted: account.debits_posted.toString(),
+                        credits_posted: account.credits_posted.toString(),
+                    },
+                ]);
+            }
+            await fs.writeFile(tmpPath, JSON.stringify(snapshot), 'utf-8');
+            await fs.rename(tmpPath, this._snapshotPath);
+            this._dirty = false;
+            this._logger.debug({ accountCount: this._accounts.size, path: this._snapshotPath }, 'Snapshot persisted');
+        }
+        catch (err) {
+            this._logger.error({ err, path: this._snapshotPath }, 'Failed to persist snapshot, will retry on next interval');
+        }
+    }
+    async _restoreSnapshot() {
+        try {
+            await fs.access(this._snapshotPath);
+        }
+        catch {
+            const tmpPath = `${this._snapshotPath}.tmp`;
+            try {
+                await fs.access(tmpPath);
+                this._logger.warn({ tmpPath }, 'Found orphaned .tmp snapshot without main file, starting fresh');
+            }
+            catch {
+            }
+            this._logger.info('No existing snapshot found, starting with empty ledger');
+            return;
+        }
+        try {
+            const data = await fs.readFile(this._snapshotPath, 'utf-8');
+            const entries = JSON.parse(data);
+            this._accounts = new Map();
+            for (const [idStr, balances] of entries) {
+                this._accounts.set(BigInt(idStr), {
+                    debits_posted: BigInt(balances.debits_posted),
+                    credits_posted: BigInt(balances.credits_posted),
+                });
+            }
+            this._logger.info({ accountCount: this._accounts.size, path: this._snapshotPath }, 'Snapshot restored');
+        }
+        catch (err) {
+            this._logger.error({ err, path: this._snapshotPath }, 'Failed to restore snapshot, starting with empty ledger');
+            this._accounts = new Map();
+        }
+    }
+    _ensureInitialized() {
+        if (!this._initialized) {
+            throw new tigerbeetle_errors_1.TigerBeetleConnectionError('InMemoryLedgerClient not initialized. Call initialize() first.');
+        }
+    }
+}
+exports.InMemoryLedgerClient = InMemoryLedgerClient;
+//# sourceMappingURL=in-memory-ledger-client.js.map

package/dist/settlement/in-memory-ledger-client.js.map

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

package/dist/settlement/ledger-client.d.ts

@@ -0,0 +1,22 @@
+import type { AccountBalance } from './tigerbeetle-client';
+export type { AccountBalance } from './tigerbeetle-client';
+export interface ILedgerClient {
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    createAccountsBatch(accounts: Array<{
+        id: bigint;
+        ledger: number;
+        code: number;
+        flags?: number;
+    }>): Promise<void>;
+    createTransfersBatch(transfers: Array<{
+        id: bigint;
+        debit_account_id: bigint;
+        credit_account_id: bigint;
+        amount: bigint;
+        [key: string]: unknown;
+    }>): Promise<void>;
+    getAccountBalance(accountId: bigint): Promise<AccountBalance>;
+    getAccountsBatch(accountIds: bigint[]): Promise<Map<bigint, AccountBalance>>;
+}
+//# sourceMappingURL=ledger-client.d.ts.map

package/dist/settlement/ledger-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-client.d.ts","sourceRoot":"","sources":["../../src/settlement/ledger-client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,aAAa;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,mBAAmB,CACjB,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC5E,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,oBAAoB,CAClB,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,GACD,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9D,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAC9E"}

package/dist/settlement/ledger-client.js

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

package/dist/settlement/ledger-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-client.js","sourceRoot":"","sources":["../../src/settlement/ledger-client.ts"],"names":[],"mappings":""}

package/dist/settlement/metrics-collector.d.ts

@@ -0,0 +1,29 @@
+export interface MetricsConfig {
+    slidingWindowDuration: number;
+    maxAttempts: number;
+    cleanupInterval: number;
+}
+export interface SettlementAttempt {
+    method: 'evm';
+    success: boolean;
+    timestamp: number;
+}
+export interface CircuitBreakerState {
+    isOpen: boolean;
+    failureRate: number;
+}
+export declare class MetricsCollector {
+    private attempts;
+    private config;
+    private cleanupIntervalId?;
+    constructor(config?: Partial<MetricsConfig>);
+    recordSuccess(method: 'evm'): void;
+    recordFailure(method: 'evm'): void;
+    getSuccessRate(method: string): number;
+    getRecentFailureRate(method: string): number;
+    getCircuitBreakerState(method: string): CircuitBreakerState;
+    destroy(): void;
+    private recordAttempt;
+    private cleanupExpiredAttempts;
+}
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/settlement/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../../src/settlement/metrics-collector.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,iBAAiB,CAAC,CAAiB;gBAE/B,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAkB3C,aAAa,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI;IAOlC,aAAa,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI;IAQlC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAetC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAkB5C,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB;IAW3D,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,sBAAsB;CAS/B"}

package/dist/settlement/metrics-collector.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsCollector = void 0;
+class MetricsCollector {
+    attempts;
+    config;
+    cleanupIntervalId;
+    constructor(config) {
+        this.config = {
+            slidingWindowDuration: config?.slidingWindowDuration ?? 3600000,
+            maxAttempts: config?.maxAttempts ?? 1000,
+            cleanupInterval: config?.cleanupInterval ?? 300000,
+        };
+        this.attempts = new Map();
+        this.cleanupIntervalId = setInterval(() => {
+            this.cleanupExpiredAttempts();
+        }, this.config.cleanupInterval);
+    }
+    recordSuccess(method) {
+        this.recordAttempt(method, true);
+    }
+    recordFailure(method) {
+        this.recordAttempt(method, false);
+    }
+    getSuccessRate(method) {
+        const methodAttempts = this.attempts.get(method) ?? [];
+        if (methodAttempts.length === 0) {
+            return 1.0;
+        }
+        const successCount = methodAttempts.filter((a) => a.success).length;
+        return successCount / methodAttempts.length;
+    }
+    getRecentFailureRate(method) {
+        const now = Date.now();
+        const windowStart = now - this.config.slidingWindowDuration;
+        const methodAttempts = this.attempts.get(method) ?? [];
+        const recentAttempts = methodAttempts.filter((a) => a.timestamp >= windowStart);
+        if (recentAttempts.length === 0) {
+            return 0.0;
+        }
+        const failureCount = recentAttempts.filter((a) => !a.success).length;
+        return failureCount / recentAttempts.length;
+    }
+    getCircuitBreakerState(method) {
+        const failureRate = this.getRecentFailureRate(method);
+        return {
+            isOpen: failureRate > 0.1,
+            failureRate,
+        };
+    }
+    destroy() {
+        if (this.cleanupIntervalId) {
+            clearInterval(this.cleanupIntervalId);
+            this.cleanupIntervalId = undefined;
+        }
+    }
+    recordAttempt(method, success) {
+        const attempt = {
+            method,
+            success,
+            timestamp: Date.now(),
+        };
+        const methodAttempts = this.attempts.get(method) ?? [];
+        methodAttempts.push(attempt);
+        if (methodAttempts.length > this.config.maxAttempts) {
+            methodAttempts.shift();
+        }
+        this.attempts.set(method, methodAttempts);
+        this.cleanupExpiredAttempts();
+    }
+    cleanupExpiredAttempts() {
+        const now = Date.now();
+        const windowStart = now - this.config.slidingWindowDuration;
+        for (const [method, methodAttempts] of this.attempts.entries()) {
+            const validAttempts = methodAttempts.filter((a) => a.timestamp >= windowStart);
+            this.attempts.set(method, validAttempts);
+        }
+    }
+}
+exports.MetricsCollector = MetricsCollector;
+//# sourceMappingURL=metrics-collector.js.map

package/dist/settlement/metrics-collector.js.map

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

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

@@ -0,0 +1,73 @@
+import type { Logger } from '../utils/logger';
+export interface MinaChannelState {
+    participantA: string;
+    participantB: string;
+    channelState: number;
+    depositTotal: bigint;
+    balanceCommitment: string;
+    nonceField: bigint;
+    closedAtSlot: bigint;
+    settlementTimeout: bigint;
+    tokenId: string;
+    channelHash: string;
+}
+export declare const MINA_ERROR_CODES: {
+    readonly COMPILE_FAILED: 1001;
+    readonly TRANSACTION_FAILED: 1002;
+    readonly PROOF_GENERATION_FAILED: 1003;
+    readonly INVALID_CHANNEL_STATE: 1004;
+    readonly ACCOUNT_NOT_FOUND: 1005;
+    readonly INVALID_PROOF: 1006;
+    readonly ARCHIVE_NODE_ERROR: 1007;
+    readonly INVALID_PARAMETERS: 1008;
+    readonly O1JS_NOT_AVAILABLE: 9999;
+};
+export declare class MinaChannelError extends Error {
+    readonly code: number;
+    readonly errorName: string;
+    constructor(message: string, code: number, errorName: string);
+}
+export interface MinaOpenChannelResult {
+    zkAppAddress: string;
+    txHash: string;
+}
+export interface MinaTxResult {
+    txHash: string;
+}
+export interface MinaSubscription {
+    unsubscribe(): void;
+}
+export declare function _resetModuleCaches(): void;
+export declare class MinaPaymentChannelSDK {
+    private readonly _zkAppAddress;
+    private readonly _logger;
+    private readonly _signerPrivateKey?;
+    readonly graphqlUrl: string;
+    private _compiled;
+    private _verificationKey;
+    get verificationKey(): any;
+    private _networkInitialized;
+    private readonly _participantCache;
+    constructor(graphqlUrl: string, _zkAppAddress: string, _logger: Logger, _signerPrivateKey?: string | undefined);
+    private _requireSignerKey;
+    private _setNetwork;
+    private _getZkApp;
+    private _wrapError;
+    private _deserializeSignature;
+    getSignerPublicKey(): Promise<string>;
+    compileContract(): Promise<void>;
+    openChannel(participantA: string, participantB: string, timeout: number, tokenId?: string): Promise<MinaOpenChannelResult>;
+    deposit(channelAddress: string, amount: bigint): Promise<MinaTxResult>;
+    claimFromChannel(channelAddress: string, newBalanceA: bigint, newBalanceB: bigint, salt: bigint, nonce: bigint, signatureA: string, signatureB: string): Promise<MinaTxResult>;
+    closeChannel(channelAddress: string, finalBalanceA: bigint, finalBalanceB: bigint, salt: bigint, nonce: bigint, signatureA: string, signatureB: string): Promise<MinaTxResult>;
+    settleChannel(channelAddress: string, balanceA: bigint, balanceB: bigint, salt: bigint, participantA: string, participantB: string, nonce: bigint): Promise<MinaTxResult>;
+    getChannelState(channelAddress: string): Promise<MinaChannelState>;
+    getChannelEvents(channelAddress: string): Promise<Array<{
+        type: string;
+        data: Record<string, unknown>;
+    }>>;
+    signBalanceProof(channelAddress: string, balanceA: bigint, balanceB: bigint, salt: bigint, nonce: bigint): Promise<string>;
+    verifyBalanceProof(channelAddress: string, balanceCommitment: string, proof: string, nonce: bigint): Promise<boolean>;
+    subscribeToChannel(channelAddress: string, callback: (state: MinaChannelState) => void, pollIntervalMs?: number): MinaSubscription;
+}
+//# sourceMappingURL=mina-payment-channel-sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mina-payment-channel-sdk.d.ts","sourceRoot":"","sources":["../../src/settlement/mina-payment-channel-sdk.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAW9C,MAAM,WAAW,gBAAgB;IAE/B,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,MAAM,CAAC;IAErB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,UAAU,EAAE,MAAM,CAAC;IAEnB,YAAY,EAAE,MAAM,CAAC;IAErB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAKX,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAO7D;AAOD,MAAM,WAAW,qBAAqB;IAEpC,YAAY,EAAE,MAAM,CAAC;IAErB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,YAAY;IAE3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,gBAAgB;IAE/B,WAAW,IAAI,IAAI,CAAC;CACrB;AAiED,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAkBD,qBAAa,qBAAqB;IA+B9B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IA/BrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAG5B,OAAO,CAAC,SAAS,CAAS;IAI1B,OAAO,CAAC,gBAAgB,CAAa;IAOrC,IAAI,eAAe,IAAI,GAAG,CAEzB;IAGD,OAAO,CAAC,mBAAmB,CAAS;IAGpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;gBAGF,UAAU,EAAE,MAAM,EACD,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,YAAA;IAa7C,OAAO,CAAC,iBAAiB;YAgBX,WAAW;YAcX,SAAS;IAqBvB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,qBAAqB;IAyCvB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBrC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA2ChC,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC;IA6D3B,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+CtE,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC;IA0FlB,YAAY,CAChB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC;IAqDlB,aAAa,CACjB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAyDlB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0DlE,gBAAgB,CACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAqC5D,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC;IAwDZ,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IA2HnB,kBAAkB,CAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,EAC3C,cAAc,GAAE,MAAiC,GAChD,gBAAgB;CAsDpB"}