@recoillink/deploy-sdk 0.0.0-stage → 11.0.1

package/dist/utils/validation.test.js

@@ -0,0 +1,160 @@
+import { expect } from 'chai';
+import { ProtocolType } from '@recoillink/provider-sdk';
+import { UnsupportedIsmTypeError, validateIsmConfig, validateIsmType, } from './validation.js';
+describe('validateIsmType', () => {
+    it('accepts compositeIsm on Sealevel', () => {
+        expect(() => {
+            validateIsmType('compositeIsm', 'solanamainnet', 'configuration', ProtocolType.Sealevel);
+        }).to.not.throw();
+    });
+    for (const protocol of [
+        ProtocolType.Radix,
+        ProtocolType.Aleo,
+        ProtocolType.Cosmos,
+        ProtocolType.CosmosNative,
+        ProtocolType.Starknet,
+    ]) {
+        it(`rejects compositeIsm on ${protocol}`, () => {
+            expect(() => {
+                validateIsmType('compositeIsm', 'somechain', 'configuration', protocol);
+            }).to.throw(UnsupportedIsmTypeError);
+        });
+    }
+    it('accepts routingMessageIdMultisigIsm on Sealevel', () => {
+        expect(() => {
+            validateIsmType('routingMessageIdMultisigIsm', 'solanamainnet', 'configuration', ProtocolType.Sealevel);
+        }).to.not.throw();
+    });
+    for (const protocol of [
+        ProtocolType.Radix,
+        ProtocolType.Aleo,
+        ProtocolType.Cosmos,
+        ProtocolType.CosmosNative,
+        ProtocolType.Starknet,
+    ]) {
+        it(`rejects routingMessageIdMultisigIsm on ${protocol}`, () => {
+            expect(() => {
+                validateIsmType('routingMessageIdMultisigIsm', 'somechain', 'configuration', protocol);
+            }).to.throw(UnsupportedIsmTypeError);
+        });
+    }
+    it('rejects messageIdMultisigIsm on Sealevel with a pointer to routingMessageIdMultisigIsm', () => {
+        expect(() => {
+            validateIsmType('messageIdMultisigIsm', 'solanamainnet', 'configuration', ProtocolType.Sealevel);
+        }).to.throw(UnsupportedIsmTypeError, /messageIdMultisigIsm is unsupported on sealevel, use routingMessageIdMultisigIsm instead/);
+    });
+    it('does not list messageIdMultisigIsm as supported on Sealevel', () => {
+        expect(() => {
+            validateIsmType('notARealIsm', 'solanamainnet', 'configuration', ProtocolType.Sealevel);
+        }).to.throw(UnsupportedIsmTypeError, /Supported types: (?!.*\bmessageIdMultisigIsm\b)/);
+    });
+    for (const protocol of [
+        ProtocolType.Radix,
+        ProtocolType.Aleo,
+        ProtocolType.Cosmos,
+        ProtocolType.CosmosNative,
+        ProtocolType.Starknet,
+    ]) {
+        it(`still accepts messageIdMultisigIsm on ${protocol}`, () => {
+            expect(() => {
+                validateIsmType('messageIdMultisigIsm', 'somechain', 'configuration', protocol);
+            }).to.not.throw();
+        });
+    }
+    it('accepts messageIdMultisigIsm when no protocol is given', () => {
+        expect(() => {
+            validateIsmType('messageIdMultisigIsm', 'somechain');
+        }).to.not.throw();
+    });
+    it('accepts protocol-agnostic ISM types on any Alt-VM protocol', () => {
+        expect(() => {
+            validateIsmType('testIsm', 'somechain', 'configuration', ProtocolType.Radix);
+        }).to.not.throw();
+    });
+    it('rejects unknown ISM types', () => {
+        expect(() => {
+            validateIsmType('notARealIsm', 'somechain', 'configuration', ProtocolType.Sealevel);
+        }).to.throw(UnsupportedIsmTypeError);
+    });
+});
+describe('validateIsmType legacy calls (no protocol)', () => {
+    it('accepts a 2-arg call (chain only, default context)', () => {
+        expect(() => {
+            validateIsmType('testIsm', 'somechain');
+        }).to.not.throw();
+    });
+    it('accepts a 3-arg call with an explicit context string in the old position', () => {
+        expect(() => {
+            validateIsmType('testIsm', 'somechain', 'core config');
+        }).to.not.throw();
+    });
+    it('rejects compositeIsm with a clear "protocol required" error when protocol is omitted', () => {
+        // compositeIsm never existed as a supported type before protocol
+        // awareness was added — there's no legacy call shape to preserve
+        // permissiveness for. Omitting protocol must still reject it (just
+        // with a clearer reason), not silently accept it for every protocol.
+        expect(() => {
+            validateIsmType('compositeIsm', 'somechain', 'core config');
+        }).to.throw(UnsupportedIsmTypeError, /requires the chain's protocol/);
+    });
+    it('still rejects a genuinely unsupported type with no protocol given', () => {
+        expect(() => {
+            validateIsmType('notARealIsm', 'somechain', 'core config');
+        }).to.throw(UnsupportedIsmTypeError);
+    });
+});
+describe('validateIsmConfig', () => {
+    it('rejects compositeIsm nested in a domainRoutingIsm on a non-Sealevel chain', () => {
+        const config = {
+            type: 'domainRoutingIsm',
+            owner: '0x0',
+            domains: {
+                ethereum: {
+                    type: 'compositeIsm',
+                    owner: '0x0',
+                    root: { type: 'test', accept: true },
+                },
+            },
+        };
+        expect(() => {
+            validateIsmConfig(config, 'somechain', 'configuration', ProtocolType.Radix);
+        }).to.throw(UnsupportedIsmTypeError);
+    });
+    it('accepts a legacy 2-arg call with no context/protocol', () => {
+        expect(() => {
+            validateIsmConfig({ type: 'testIsm' }, 'somechain');
+        }).to.not.throw();
+    });
+});
+describe('validateIsmConfig routingMessageIdMultisigIsm', () => {
+    const V1 = '0x1111111111111111111111111111111111111111';
+    const V2 = '0x2222222222222222222222222222222222222222';
+    const cases = [
+        {
+            name: 'accepts a valid domain',
+            domains: { validators: [V1, V2], threshold: 2 },
+        },
+        {
+            name: 'rejects an invalid domain, labelled with domain, chain and context',
+            domains: { validators: [V1], threshold: 2 },
+            error: /^routingMessageIdMultisigIsm domain 'ethereum' on solanamainnet in configuration.*threshold 2/,
+        },
+    ];
+    for (const c of cases) {
+        it(c.name, () => {
+            const config = {
+                type: 'routingMessageIdMultisigIsm',
+                owner: 'owner',
+                domains: { ethereum: c.domains },
+            };
+            const run = () => {
+                validateIsmConfig(config, 'solanamainnet', 'configuration', ProtocolType.Sealevel);
+            };
+            if (c.error)
+                expect(run).to.throw(c.error);
+            else
+                expect(run).to.not.throw();
+        });
+    }
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/utils/validation.test.js.map

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

package/dist/warp/warp-reader.d.ts

@@ -0,0 +1,57 @@
+import { ChainMetadataForAltVM } from '@recoillink/provider-sdk';
+import { ArtifactReader } from '@recoillink/provider-sdk/artifact';
+import { ChainLookup } from '@recoillink/provider-sdk/chain';
+import { DeployedWarpAddress, DeployedWarpArtifact, DerivedWarpConfig, IRawWarpArtifactManager, WarpArtifactConfig } from '@recoillink/provider-sdk/warp';
+import { IsmReader } from '../ism/generic-ism.js';
+/**
+ * Generic Warp Token Reader that can read any warp token type by detecting its type
+ * and expanding nested ISM artifacts if present.
+ */
+export declare class WarpTokenReader implements ArtifactReader<WarpArtifactConfig, DeployedWarpAddress> {
+    protected readonly artifactManager: IRawWarpArtifactManager;
+    protected readonly chainMetadata: ChainMetadataForAltVM;
+    protected readonly chainLookup: ChainLookup;
+    protected readonly ismReader: IsmReader;
+    constructor(artifactManager: IRawWarpArtifactManager, chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup);
+    read(address: string): Promise<DeployedWarpArtifact>;
+    /**
+     * Expands an ISM artifact by recursively reading it if underived.
+     * Returns undefined if no ISM is configured.
+     */
+    private expandIsmArtifact;
+    /**
+     * Expands a Hook artifact by recursively reading it if underived.
+     * Returns undefined if no Hook is configured.
+     */
+    private expandHookArtifact;
+    /**
+     * Expands a Fee artifact by reading it if underived.
+     * Builds FeeReadContext from the warp config's remote routers and CC routers.
+     * Returns undefined only when no feeArtifact is provided. Deployed artifacts
+     * are returned as-is. Underived artifacts are read via the fee reader.
+     * Throws if a fee artifact exists but the protocol has no fee artifact manager.
+     */
+    private expandFeeArtifact;
+    /**
+     * Backward compatibility method that converts DeployedWarpArtifact to DerivedWarpConfig.
+     * This allows WarpTokenReader to be used as a drop-in replacement for the old AltVMWarpRouteReader.
+     */
+    deriveWarpConfig(address: string): Promise<DerivedWarpConfig>;
+}
+/**
+ * Factory function to create a WarpTokenReader instance.
+ * This helper centralizes the creation of artifact managers and warp token readers,
+ * making it easier to instantiate readers across the codebase.
+ *
+ * @param chainMetadata Chain metadata for the target chain (protocol type is extracted from metadata.protocol)
+ * @param chainLookup Chain lookup interface for resolving chain names and domain IDs
+ * @returns A WarpTokenReader instance
+ *
+ * @example
+ * ```typescript
+ * const reader = createWarpTokenReader(chainMetadata, chainLookup);
+ * const warpConfig = await reader.read(warpTokenAddress);
+ * ```
+ */
+export declare function createWarpTokenReader(chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup): WarpTokenReader;
+//# sourceMappingURL=warp-reader.d.ts.map

package/dist/warp/warp-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-reader.d.ts","sourceRoot":"","sources":["../../src/warp/warp-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,cAAc,EAGf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAgB7D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAGnB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,SAAS,EAAmB,MAAM,uBAAuB,CAAC;AAEnE;;;GAGG;AACH,qBAAa,eAAgB,YAAW,cAAc,CACpD,kBAAkB,EAClB,mBAAmB,CACpB;IAIG,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,uBAAuB;IAC3D,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB;IACvD,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW;IAL7C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAExC,YACqB,eAAe,EAAE,uBAAuB,EACxC,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,EAG5C;IAEK,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmCzD;IAED;;;OAGG;YACW,iBAAiB;IAuB/B;;;OAGG;YACW,kBAAkB;IAwBhC;;;;;;OAMG;YACW,iBAAiB;IA2B/B;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAGlE;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,GACvB,eAAe,CAMjB"}

package/dist/warp/warp-reader.js

@@ -0,0 +1,135 @@
+import { getProtocolProvider, } from '@recoillink/provider-sdk';
+import { assert } from '@recoillink/utils';
+import { isArtifactDeployed, isArtifactUnderived, } from '@recoillink/provider-sdk/artifact';
+import { buildFeeReadContextFromWarpArtifactConfig, warpArtifactToDerivedConfig, } from '@recoillink/provider-sdk/warp';
+import { createFeeReader } from '../fee/fee-reader.js';
+import { createHookReader } from '../hook/hook-reader.js';
+import { createIsmReader } from '../ism/generic-ism.js';
+/**
+ * Generic Warp Token Reader that can read any warp token type by detecting its type
+ * and expanding nested ISM artifacts if present.
+ */
+export class WarpTokenReader {
+    artifactManager;
+    chainMetadata;
+    chainLookup;
+    ismReader;
+    constructor(artifactManager, chainMetadata, chainLookup) {
+        this.artifactManager = artifactManager;
+        this.chainMetadata = chainMetadata;
+        this.chainLookup = chainLookup;
+        this.ismReader = createIsmReader(chainMetadata, chainLookup);
+    }
+    async read(address) {
+        // Read warp token via artifactManager - detects type and returns raw config
+        const rawArtifact = await this.artifactManager.readWarpToken(address);
+        // Create hook reader with mailbox context from the warp config
+        const hookReader = createHookReader(this.chainMetadata, this.chainLookup, {
+            mailbox: rawArtifact.config.mailbox,
+        });
+        // Expand nested ISM artifact if present
+        const expandedIsmArtifact = await this.expandIsmArtifact(rawArtifact.config.interchainSecurityModule);
+        // Expand nested Hook artifact if present
+        const expandedHookArtifact = await this.expandHookArtifact(hookReader, rawArtifact.config.hook);
+        // Expand nested Fee artifact if present
+        const expandedFeeArtifact = await this.expandFeeArtifact(rawArtifact.config, rawArtifact.config.fee);
+        return {
+            ...rawArtifact,
+            config: {
+                ...rawArtifact.config,
+                interchainSecurityModule: expandedIsmArtifact,
+                hook: expandedHookArtifact,
+                fee: expandedFeeArtifact,
+            },
+        };
+    }
+    /**
+     * Expands an ISM artifact by recursively reading it if underived.
+     * Returns undefined if no ISM is configured.
+     */
+    async expandIsmArtifact(ismArtifact) {
+        if (!ismArtifact) {
+            return undefined;
+        }
+        // If ISM is underived (just an address), read it recursively to get full config
+        if (isArtifactUnderived(ismArtifact)) {
+            return this.ismReader.read(ismArtifact.deployed.address);
+        }
+        // If already a full deployed artifact, use as-is
+        if (isArtifactDeployed(ismArtifact)) {
+            return ismArtifact;
+        }
+        // NEW state should not occur in read artifacts
+        throw new Error(`Unexpected ISM artifact state 'new' when reading warp token ISM configuration`);
+    }
+    /**
+     * Expands a Hook artifact by recursively reading it if underived.
+     * Returns undefined if no Hook is configured.
+     */
+    async expandHookArtifact(hookReader, hookArtifact) {
+        if (!hookArtifact) {
+            return undefined;
+        }
+        // If Hook is underived (just an address), read it recursively to get full config
+        if (isArtifactUnderived(hookArtifact)) {
+            return hookReader.read(hookArtifact.deployed.address);
+        }
+        // If already a full deployed artifact, use as-is
+        if (isArtifactDeployed(hookArtifact)) {
+            return hookArtifact;
+        }
+        // NEW state should not occur in read artifacts
+        throw new Error(`Unexpected Hook artifact state 'new' when reading warp token Hook configuration`);
+    }
+    /**
+     * Expands a Fee artifact by reading it if underived.
+     * Builds FeeReadContext from the warp config's remote routers and CC routers.
+     * Returns undefined only when no feeArtifact is provided. Deployed artifacts
+     * are returned as-is. Underived artifacts are read via the fee reader.
+     * Throws if a fee artifact exists but the protocol has no fee artifact manager.
+     */
+    async expandFeeArtifact(warpConfig, feeArtifact) {
+        if (!feeArtifact) {
+            return undefined;
+        }
+        if (isArtifactDeployed(feeArtifact)) {
+            return feeArtifact;
+        }
+        if (isArtifactUnderived(feeArtifact)) {
+            const context = buildFeeReadContextFromWarpArtifactConfig(warpConfig);
+            const feeReader = createFeeReader(this.chainMetadata, context);
+            assert(feeReader, `Fee artifact present on warp config but protocol ${this.chainMetadata.protocol} has no fee artifact manager`);
+            return feeReader.read(feeArtifact.deployed.address);
+        }
+        throw new Error(`Unexpected Fee artifact state 'new' when reading warp token Fee configuration`);
+    }
+    /**
+     * Backward compatibility method that converts DeployedWarpArtifact to DerivedWarpConfig.
+     * This allows WarpTokenReader to be used as a drop-in replacement for the old AltVMWarpRouteReader.
+     */
+    async deriveWarpConfig(address) {
+        const artifact = await this.read(address);
+        return warpArtifactToDerivedConfig(artifact, this.chainLookup);
+    }
+}
+/**
+ * Factory function to create a WarpTokenReader instance.
+ * This helper centralizes the creation of artifact managers and warp token readers,
+ * making it easier to instantiate readers across the codebase.
+ *
+ * @param chainMetadata Chain metadata for the target chain (protocol type is extracted from metadata.protocol)
+ * @param chainLookup Chain lookup interface for resolving chain names and domain IDs
+ * @returns A WarpTokenReader instance
+ *
+ * @example
+ * ```typescript
+ * const reader = createWarpTokenReader(chainMetadata, chainLookup);
+ * const warpConfig = await reader.read(warpTokenAddress);
+ * ```
+ */
+export function createWarpTokenReader(chainMetadata, chainLookup) {
+    const protocolProvider = getProtocolProvider(chainMetadata.protocol);
+    const artifactManager = protocolProvider.createWarpArtifactManager(chainMetadata);
+    return new WarpTokenReader(artifactManager, chainMetadata, chainLookup);
+}
+//# sourceMappingURL=warp-reader.js.map

package/dist/warp/warp-reader.js.map

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

package/dist/warp/warp-writer.d.ts

@@ -0,0 +1,67 @@
+import { ChainMetadataForAltVM } from '@recoillink/provider-sdk';
+import { ISigner } from '@recoillink/provider-sdk/altvm';
+import { ArtifactNew, ArtifactWriter } from '@recoillink/provider-sdk/artifact';
+import { ChainLookup } from '@recoillink/provider-sdk/chain';
+import { AnnotatedTx, TxReceipt } from '@recoillink/provider-sdk/module';
+import { DeployedWarpAddress, DeployedWarpArtifact, IRawWarpArtifactManager, WarpArtifactConfig } from '@recoillink/provider-sdk/warp';
+import { HookWriter } from '../hook/hook-writer.js';
+import { IsmWriter } from '../ism/generic-ism-writer.js';
+import { WarpTokenReader } from './warp-reader.js';
+/**
+ * Factory function to create a WarpTokenWriter instance.
+ *
+ * @param chainMetadata Chain metadata for the target chain
+ * @param chainLookup Chain lookup interface for resolving chain names and domain IDs
+ * @param signer Signer interface for signing transactions
+ * @returns A WarpTokenWriter instance
+ *
+ * @example
+ * ```typescript
+ * const writer = createWarpTokenWriter(chainMetadata, chainLookup, signer);
+ * const [deployed, receipts] = await writer.create(warpArtifact);
+ * ```
+ */
+export declare function createWarpTokenWriter(chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>): WarpTokenWriter;
+/**
+ * WarpTokenWriter handles creation and updates of warp tokens using the Artifact API.
+ * It delegates to protocol-specific artifact writers for individual warp token types.
+ *
+ * Key features:
+ * - Extends WarpTokenReader to inherit read() functionality
+ * - Works with pure Artifact API (WarpArtifactConfig)
+ * - Handles nested ISM deployment after warp token deployment
+ * - Delegates to typed writers from artifact manager for specific warp token types
+ * - Protocol-agnostic through artifact manager abstraction
+ */
+export declare class WarpTokenWriter extends WarpTokenReader implements ArtifactWriter<WarpArtifactConfig, DeployedWarpAddress> {
+    protected readonly artifactManager: IRawWarpArtifactManager;
+    protected readonly chainMetadata: ChainMetadataForAltVM;
+    protected readonly chainLookup: ChainLookup;
+    protected readonly signer: ISigner<AnnotatedTx, TxReceipt>;
+    protected readonly ismWriter: IsmWriter;
+    protected readonly hookWriterFactory: (mailbox: string) => HookWriter;
+    constructor(artifactManager: IRawWarpArtifactManager, chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>);
+    /**
+     * Creates a new warp token by deploying it on-chain.
+     * If the warp token has a new nested ISM artifact, deploys it after the
+     * router so its config can use the router address.
+     *
+     * @param artifact The warp token configuration to deploy
+     * @returns A tuple of [deployed artifact, transaction receipts]
+     */
+    create(artifact: ArtifactNew<WarpArtifactConfig>): Promise<[DeployedWarpArtifact, TxReceipt[]]>;
+    /**
+     * Updates an existing warp token to match the desired configuration.
+     * Warp tokens are mutable - supports remote router enrollment/unenrollment,
+     * ISM updates, and owner changes.
+     *
+     * The protocol-specific writer will read the current on-chain state and compare
+     * with the expected config to generate the necessary update transactions.
+     *
+     * @param artifact The desired warp token state (must include deployed address)
+     * @returns Array of transactions needed to perform the update
+     * @throws Error if the token type cannot be changed (e.g., collateral -> synthetic)
+     */
+    update(artifact: DeployedWarpArtifact): Promise<AnnotatedTx[]>;
+}
+//# sourceMappingURL=warp-writer.d.ts.map

package/dist/warp/warp-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-writer.d.ts","sourceRoot":"","sources":["../../src/warp/warp-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EACL,WAAW,EAGX,cAAc,EAIf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAsB7D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EAEvB,kBAAkB,EAGnB,MAAM,+BAA+B,CAAC;AAUvC,OAAO,EAAE,UAAU,EAAoB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAmB,MAAM,8BAA8B,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,GACtC,eAAe,CAWjB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eACX,SAAQ,eACR,YAAW,cAAc,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;uBAMpC,eAAe,EAAE,uBAAuB;uBACxC,aAAa,EAAE,qBAAqB;uBACpC,WAAW,EAAE,WAAW;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC;IAP5D,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IACxC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC;IAEtE,YAC8B,eAAe,EAAE,uBAAuB,EACxC,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,EACjC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAM3D;IAED;;;;;;;OAOG;IACG,MAAM,CACV,QAAQ,EAAE,WAAW,CAAC,kBAAkB,CAAC,GACxC,OAAO,CAAC,CAAC,oBAAoB,EAAE,SAAS,EAAE,CAAC,CAAC,CA0K9C;IAED;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiNnE;CACF"}