@hyperlane-xyz/rebalancer 0.1.0-beta.5a8bd28ab

package/README.md

@@ -0,0 +1,178 @@
+# @hyperlane-xyz/rebalancer
+
+Hyperlane Warp Route Collateral Rebalancer Service - maintains optimal collateral distribution across chains for Hyperlane warp routes.
+
+## Overview
+
+The rebalancer monitors collateral balances across warp route deployments and automatically transfers tokens between chains to maintain configured target balances. It supports both manual one-off rebalances and continuous daemon mode for production deployments.
+
+## Features
+
+- **Multi-Protocol Support**: Protocol-agnostic design supporting EVM chains (Cosmos, Sealevel, etc. when movable collateral contracts available)
+- **Flexible Strategies**: Weighted and minimum-amount rebalancing strategies
+- **Safety Features**: Inflight guards, semaphores, and comprehensive validation
+- **Observability**: Built-in Prometheus metrics and structured logging
+- **Dual Mode**: Manual CLI execution or continuous daemon service
+- **Bridge Support**: Integration with Portal, Hyperlane, and other bridge providers
+
+## Installation
+
+```bash
+# From monorepo root
+yarn install
+
+# Build the package
+yarn workspace @hyperlane-xyz/rebalancer build
+```
+
+## Usage
+
+### Manual Rebalancing (CLI)
+
+Execute a one-off rebalance using the CLI:
+
+```bash
+# Via CLI package
+yarn workspace @hyperlane-xyz/cli hyperlane warp rebalancer \
+  --config /path/to/rebalancer-config.yaml \
+  --manual \
+  --origin ethereum \
+  --destination arbitrum \
+  --amount 1000
+```
+
+### Daemon Mode (Service)
+
+Run as a continuous service (typically in K8s):
+
+```bash
+# Set environment variables
+export REBALANCER_CONFIG_FILE=/path/to/rebalancer-config.yaml
+export HYP_KEY=your_private_key
+export COINGECKO_API_KEY=your_api_key
+
+# Start the service
+yarn workspace @hyperlane-xyz/rebalancer start
+
+# Or with direct node
+node dist/service.js
+```
+
+### Programmatic Usage
+
+```typescript
+import { RebalancerService } from '@hyperlane-xyz/rebalancer';
+
+const service = new RebalancerService(
+  multiProvider,
+  multiProtocolProvider,
+  registry,
+  rebalancerConfig,
+  {
+    mode: 'daemon',
+    checkFrequency: 60_000,
+    withMetrics: true,
+    coingeckoApiKey: process.env.COINGECKO_API_KEY,
+    logger: console,
+  },
+);
+
+// Start daemon
+await service.start();
+
+// Or execute manual rebalance
+await service.executeManual({
+  origin: 'ethereum',
+  destination: 'arbitrum',
+  amount: '1000',
+});
+```
+
+## Configuration
+
+The rebalancer uses a YAML configuration file. See example:
+
+```yaml
+warpRouteId: ETH/ethereum-arbitrum-optimism
+strategy:
+  rebalanceStrategy: weighted
+  chains:
+    ethereum:
+      weight: 60
+      bridge: hyperlane
+    arbitrum:
+      weight: 20
+      bridge: hyperlane
+    optimism:
+      weight: 20
+      bridge: portal
+```
+
+## Architecture
+
+### Package Structure
+
+```
+typescript/rebalancer/
+├── src/
+│   ├── core/
+│   │   ├── RebalancerService.ts    # Main orchestrator
+│   │   ├── Rebalancer.ts           # Core rebalancing logic
+│   │   ├── WithInflightGuard.ts    # Concurrency protection
+│   │   └── WithSemaphore.ts        # Semaphore wrapper
+│   ├── strategy/
+│   │   ├── WeightedStrategy.ts     # Weighted distribution
+│   │   └── MinAmountStrategy.ts    # Minimum threshold strategy
+│   ├── monitor/
+│   │   └── Monitor.ts              # Balance monitoring
+│   ├── metrics/
+│   │   └── Metrics.ts              # Prometheus metrics collection
+│   ├── config/
+│   │   └── RebalancerConfig.ts     # Config loading/validation
+│   ├── utils/
+│   ├── interfaces/
+│   ├── service.ts                  # Service entry point
+│   └── index.ts                    # Public API
+```
+
+### Dependencies
+
+- `@hyperlane-xyz/sdk`: Core SDK with MultiProvider and WarpCore
+- `@hyperlane-xyz/provider-sdk`: Protocol-agnostic provider abstractions
+- `@hyperlane-xyz/utils`: Shared utilities and types
+- `prom-client`: Prometheus metrics
+- `pino`: Structured logging
+
+## Development
+
+### Running Tests
+
+```bash
+yarn workspace @hyperlane-xyz/rebalancer test
+```
+
+### Local Development
+
+```bash
+# Watch mode
+yarn workspace @hyperlane-xyz/rebalancer dev
+
+# Start with test config
+HYP_KEY=your_test_key \
+REBALANCER_CONFIG_FILE=./test-config.yaml \
+yarn workspace @hyperlane-xyz/rebalancer start:dev
+```
+
+## Migration from CLI
+
+This package replaces the rebalancer functionality previously embedded in `@hyperlane-xyz/cli`. Key changes:
+
+1. **Dedicated Package**: Now a standalone service package
+2. **Direct Entry Point**: K8s deployments use `service.ts` directly (no CLI wrapper)
+3. **Metrics Included**: Prometheus metrics stay with the service
+4. **Protocol-Agnostic**: Aligned with multi-VM architecture
+5. **Dual Mode Support**: Single codebase for both manual and daemon modes
+
+## License
+
+Apache-2.0

package/dist/config/RebalancerConfig.d.ts

@@ -0,0 +1,12 @@
+import { type StrategyConfig } from '@hyperlane-xyz/sdk';
+export declare class RebalancerConfig {
+    readonly warpRouteId: string;
+    readonly strategyConfig: StrategyConfig;
+    constructor(warpRouteId: string, strategyConfig: StrategyConfig);
+    /**
+     * Loads config from a file
+     * @param configFilePath Path to the config file
+     */
+    static load(configFilePath: string): RebalancerConfig;
+}
+//# sourceMappingURL=RebalancerConfig.d.ts.map

package/dist/config/RebalancerConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebalancerConfig.d.ts","sourceRoot":"","sources":["../../src/config/RebalancerConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAK5B,qBAAa,gBAAgB;aAET,WAAW,EAAE,MAAM;aACnB,cAAc,EAAE,cAAc;gBAD9B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc;IAGhD;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM;CAiBnC"}

package/dist/config/RebalancerConfig.js

@@ -0,0 +1,29 @@
+import { fromZodError } from 'zod-validation-error';
+import { RebalancerConfigSchema, } from '@hyperlane-xyz/sdk';
+import { isObjEmpty } from '@hyperlane-xyz/utils';
+import { readYamlOrJson } from '../utils/files.js';
+export class RebalancerConfig {
+    warpRouteId;
+    strategyConfig;
+    constructor(warpRouteId, strategyConfig) {
+        this.warpRouteId = warpRouteId;
+        this.strategyConfig = strategyConfig;
+    }
+    /**
+     * Loads config from a file
+     * @param configFilePath Path to the config file
+     */
+    static load(configFilePath) {
+        const config = readYamlOrJson(configFilePath);
+        const validationResult = RebalancerConfigSchema.safeParse(config);
+        if (!validationResult.success) {
+            throw new Error(fromZodError(validationResult.error).message);
+        }
+        const { warpRouteId, strategy } = validationResult.data;
+        if (isObjEmpty(strategy.chains)) {
+            throw new Error('No chains configured');
+        }
+        return new RebalancerConfig(warpRouteId, strategy);
+    }
+}
+//# sourceMappingURL=RebalancerConfig.js.map

package/dist/config/RebalancerConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebalancerConfig.js","sourceRoot":"","sources":["../../src/config/RebalancerConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAEL,sBAAsB,GAEvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,OAAO,gBAAgB;IAET;IACA;IAFlB,YACkB,WAAmB,EACnB,cAA8B;QAD9B,gBAAW,GAAX,WAAW,CAAQ;QACnB,mBAAc,GAAd,cAAc,CAAgB;IAC7C,CAAC;IAEJ;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,cAAsB;QAChC,MAAM,MAAM,GAA8B,cAAc,CAAC,cAAc,CAAC,CAAC;QAEzE,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAElE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC;QAExD,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,IAAI,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/config/RebalancerConfig.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RebalancerConfig.test.d.ts.map

package/dist/config/RebalancerConfig.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebalancerConfig.test.d.ts","sourceRoot":"","sources":["../../src/config/RebalancerConfig.test.ts"],"names":[],"mappings":""}

package/dist/config/RebalancerConfig.test.js

@@ -0,0 +1,325 @@
+import { expect } from 'chai';
+import { ethers } from 'ethers';
+import { rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { RebalancerMinAmountType, RebalancerStrategyOptions, } from '@hyperlane-xyz/sdk';
+import { writeYamlOrJson } from '../utils/files.js';
+import { RebalancerConfig } from './RebalancerConfig.js';
+const TEST_CONFIG_PATH = join(tmpdir(), 'rebalancer-config-test.yaml');
+describe('RebalancerConfig', () => {
+    let data;
+    beforeEach(() => {
+        data = {
+            warpRouteId: 'warpRouteId',
+            strategy: {
+                rebalanceStrategy: RebalancerStrategyOptions.Weighted,
+                chains: {
+                    chain1: {
+                        weighted: {
+                            weight: 100,
+                            tolerance: 0,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1,
+                    },
+                    chain2: {
+                        weighted: {
+                            weight: 100,
+                            tolerance: 0,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1,
+                    },
+                },
+            },
+        };
+        writeYamlOrJson(TEST_CONFIG_PATH, data);
+    });
+    afterEach(() => {
+        rmSync(TEST_CONFIG_PATH, { force: true });
+    });
+    it('should throw when the config file does not exist', () => {
+        rmSync(TEST_CONFIG_PATH, { force: true });
+        expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(`File doesn't exist at ${TEST_CONFIG_PATH}`);
+    });
+    it('should load config from file', () => {
+        expect(RebalancerConfig.load(TEST_CONFIG_PATH)).to.deep.equal({
+            warpRouteId: 'warpRouteId',
+            strategyConfig: {
+                rebalanceStrategy: RebalancerStrategyOptions.Weighted,
+                chains: {
+                    chain1: {
+                        weighted: {
+                            weight: 100n,
+                            tolerance: 0n,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1000,
+                    },
+                    chain2: {
+                        weighted: {
+                            weight: 100n,
+                            tolerance: 0n,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1000,
+                    },
+                },
+            },
+        });
+    });
+    it('should throw if chains are not configured', () => {
+        data.strategy.chains = {};
+        writeYamlOrJson(TEST_CONFIG_PATH, data);
+        expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw('No chains configured');
+    });
+    it('should throw if no warp route id is configured', () => {
+        // @ts-ignore
+        delete data.warpRouteId;
+        writeYamlOrJson(TEST_CONFIG_PATH, data);
+        expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw('Validation error: Required at "warpRouteId"');
+    });
+    it('should load relative params without modifications', () => {
+        data = {
+            warpRouteId: 'warpRouteId',
+            strategy: {
+                rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
+                chains: {
+                    chain1: {
+                        minAmount: {
+                            min: '0.2',
+                            target: 0.3,
+                            type: RebalancerMinAmountType.Relative,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1,
+                    },
+                    chain2: {
+                        minAmount: {
+                            min: '0.2',
+                            target: 0.3,
+                            type: RebalancerMinAmountType.Relative,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1,
+                    },
+                },
+            },
+        };
+        writeYamlOrJson(TEST_CONFIG_PATH, data);
+        expect(RebalancerConfig.load(TEST_CONFIG_PATH).strategyConfig.chains.chain1).to.deep.equal({
+            ...data.strategy.chains.chain1,
+            bridgeLockTime: 1000,
+        });
+    });
+    it('should load absolute params without modifications', () => {
+        data = {
+            warpRouteId: 'warpRouteId',
+            strategy: {
+                rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
+                chains: {
+                    chain1: {
+                        minAmount: {
+                            min: '100000',
+                            target: 140000,
+                            type: RebalancerMinAmountType.Absolute,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1,
+                    },
+                    chain2: {
+                        minAmount: {
+                            min: '100000',
+                            target: 140000,
+                            type: RebalancerMinAmountType.Absolute,
+                        },
+                        bridge: ethers.constants.AddressZero,
+                        bridgeLockTime: 1,
+                    },
+                },
+            },
+        };
+        writeYamlOrJson(TEST_CONFIG_PATH, data);
+        expect(RebalancerConfig.load(TEST_CONFIG_PATH).strategyConfig.chains.chain1).to.deep.equal({
+            ...data.strategy.chains.chain1,
+            bridgeLockTime: 1000,
+        });
+    });
+    describe('override functionality', () => {
+        it('should parse a config with overrides', () => {
+            data = {
+                warpRouteId: 'warpRouteId',
+                strategy: {
+                    rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
+                    chains: {
+                        chain1: {
+                            minAmount: {
+                                min: 1000,
+                                target: 1100,
+                                type: RebalancerMinAmountType.Absolute,
+                            },
+                            bridge: ethers.constants.AddressZero,
+                            bridgeLockTime: 1,
+                            override: {
+                                chain2: {
+                                    bridge: '0x1234567890123456789012345678901234567890',
+                                },
+                            },
+                        },
+                        chain2: {
+                            minAmount: {
+                                min: 2000,
+                                target: 2200,
+                                type: RebalancerMinAmountType.Absolute,
+                            },
+                            bridge: ethers.constants.AddressZero,
+                            bridgeLockTime: 1,
+                        },
+                        chain3: {
+                            minAmount: {
+                                min: 3000,
+                                target: 3300,
+                                type: RebalancerMinAmountType.Absolute,
+                            },
+                            bridge: ethers.constants.AddressZero,
+                            bridgeLockTime: 1,
+                        },
+                    },
+                },
+            };
+            writeYamlOrJson(TEST_CONFIG_PATH, data);
+            const config = RebalancerConfig.load(TEST_CONFIG_PATH);
+            expect(config.strategyConfig.chains.chain1).to.have.property('override');
+            const override = config.strategyConfig.chains.chain1.override;
+            expect(override).to.not.be.undefined;
+            expect(override).to.have.property('chain2');
+            const toChain2Override = override.chain2;
+            expect(toChain2Override).to.have.property('bridge');
+            expect(toChain2Override.bridge).to.equal('0x1234567890123456789012345678901234567890');
+        });
+        it('should throw when an override references a non-existent chain', () => {
+            data = {
+                warpRouteId: 'warpRouteId',
+                strategy: {
+                    rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
+                    chains: {
+                        chain1: {
+                            minAmount: {
+                                min: 1000,
+                                target: 1100,
+                                type: RebalancerMinAmountType.Absolute,
+                            },
+                            bridge: ethers.constants.AddressZero,
+                            bridgeLockTime: 1,
+                            override: {
+                                chain2: {
+                                    bridge: '0x1234567890123456789012345678901234567890',
+                                },
+                                chain3: {
+                                    bridgeMinAcceptedAmount: 1000,
+                                },
+                            },
+                        },
+                        chain2: {
+                            minAmount: {
+                                min: 2000,
+                                target: 2200,
+                                type: RebalancerMinAmountType.Absolute,
+                            },
+                            bridge: ethers.constants.AddressZero,
+                            bridgeLockTime: 1,
+                        },
+                    },
+                },
+            };
+            writeYamlOrJson(TEST_CONFIG_PATH, data);
+            expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw("Chain 'chain1' has an override for 'chain3', but 'chain3' is not defined in the config");
+        });
+        it('should throw when an override references itself', () => {
+            data = {
+                warpRouteId: 'warpRouteId',
+                strategy: {
+                    rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
+                    chains: {
+                        chain1: {
+                            minAmount: {
+                                min: 1000,
+                                target: 1100,
+                                type: RebalancerMinAmountType.Absolute,
+                            },
+                            bridge: ethers.constants.AddressZero,
+                            bridgeLockTime: 1,
+                            override: {
+                                chain1: {
+                                    bridgeMinAcceptedAmount: 1000,
+                                },
+                            },
+                        },
+                        chain2: {
+                            minAmount: {
+                                min: 2000,
+                                target: 2200,
+                                type: RebalancerMinAmountType.Absolute,
+                            },
+                            bridge: ethers.constants.AddressZero,
+                            bridgeLockTime: 1,
+                        },
+                    },
+                },
+            };
+            writeYamlOrJson(TEST_CONFIG_PATH, data);
+            expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw("Chain 'chain1' has an override for 'chain1', but 'chain1' is self-referencing");
+        });
+        it('should allow multiple chain overrides', () => {
+            data.strategy.chains.chain1 = {
+                bridge: ethers.constants.AddressZero,
+                bridgeMinAcceptedAmount: 3000,
+                bridgeLockTime: 1,
+                weighted: {
+                    weight: 100,
+                    tolerance: 0,
+                },
+                override: {
+                    chain2: {
+                        bridgeMinAcceptedAmount: 4000,
+                    },
+                    chain3: {
+                        bridge: '0x1234567890123456789012345678901234567890',
+                    },
+                },
+            };
+            data.strategy.chains.chain2 = {
+                bridge: ethers.constants.AddressZero,
+                bridgeMinAcceptedAmount: 5000,
+                bridgeLockTime: 1,
+                weighted: {
+                    weight: 100,
+                    tolerance: 0,
+                },
+            };
+            data.strategy.chains.chain3 = {
+                bridge: ethers.constants.AddressZero,
+                bridgeMinAcceptedAmount: 6000,
+                bridgeLockTime: 1,
+                weighted: {
+                    weight: 100,
+                    tolerance: 0,
+                },
+            };
+            writeYamlOrJson(TEST_CONFIG_PATH, data);
+            const config = RebalancerConfig.load(TEST_CONFIG_PATH);
+            const chain1Overrides = config.strategyConfig.chains.chain1.override;
+            expect(chain1Overrides).to.not.be.undefined;
+            expect(chain1Overrides).to.have.property('chain2');
+            expect(chain1Overrides).to.have.property('chain3');
+            const chain2Overrides = chain1Overrides.chain2;
+            expect(chain2Overrides).to.have.property('bridgeMinAcceptedAmount');
+            expect(chain2Overrides.bridgeMinAcceptedAmount).to.equal(4000);
+            const chain3Overrides = chain1Overrides.chain3;
+            expect(chain3Overrides).to.have.property('bridge');
+            expect(chain3Overrides.bridge).to.equal('0x1234567890123456789012345678901234567890');
+        });
+    });
+});
+//# sourceMappingURL=RebalancerConfig.test.js.map

package/dist/config/RebalancerConfig.test.js.map

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

package/dist/core/Rebalancer.d.ts

@@ -0,0 +1,23 @@
+import { Logger } from 'pino';
+import { type ChainMap, type ChainMetadata, type MultiProvider, type Token, type WarpCore } from '@hyperlane-xyz/sdk';
+import type { IRebalancer } from '../interfaces/IRebalancer.js';
+import type { RebalancingRoute } from '../interfaces/IStrategy.js';
+import { Metrics } from '../metrics/Metrics.js';
+import { type BridgeConfigWithOverride } from '../utils/index.js';
+export declare class Rebalancer implements IRebalancer {
+    private readonly bridges;
+    private readonly warpCore;
+    private readonly chainMetadata;
+    private readonly tokensByChainName;
+    private readonly multiProvider;
+    private readonly metrics?;
+    private readonly logger;
+    constructor(bridges: ChainMap<BridgeConfigWithOverride>, warpCore: WarpCore, chainMetadata: ChainMap<ChainMetadata>, tokensByChainName: ChainMap<Token>, multiProvider: MultiProvider, logger: Logger, metrics?: Metrics | undefined);
+    rebalance(routes: RebalancingRoute[]): Promise<void>;
+    private prepareTransactions;
+    private prepareTransaction;
+    private validateRoute;
+    private executeTransactions;
+    private filterTransactions;
+}
+//# sourceMappingURL=Rebalancer.d.ts.map

package/dist/core/Rebalancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rebalancer.d.ts","sourceRoot":"","sources":["../../src/core/Rebalancer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAGlB,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAW,YAAW,WAAW;IAG1C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAR3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAC3C,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,EACtC,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,EAClC,aAAa,EAAE,aAAa,EAC7C,MAAM,EAAE,MAAM,EACG,OAAO,CAAC,qBAAS;IAK9B,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAwD5C,mBAAmB;YAuBnB,kBAAkB;YAuFlB,aAAa;YAmHb,mBAAmB;IAkHjC,OAAO,CAAC,kBAAkB;CAoC3B"}