@diap/sdk 0.1.1 → 0.1.2

package/dist/did-builder.d.ts

@@ -0,0 +1,62 @@
+/**
+ * DID 构建器
+ * 构建和发布符合 W3C DID 规范的 DID 文档
+ * 基于 Rust SDK 的实现逻辑
+ */
+import type { DIDDocument, DIDPublishResult, EncryptedPeerID } from './types/did.js';
+import type { KeyPair } from './types/key.js';
+import type { IpfsClient } from './ipfs-client.js';
+/**
+ * DID 构建器
+ */
+export declare class DIDBuilder {
+    private ipfsClient;
+    private services;
+    constructor(ipfsClient: IpfsClient);
+    /**
+     * 添加服务端点
+     */
+    addService(serviceType: string, endpoint: any): this;
+    /**
+     * 添加 PubSub 服务
+     */
+    addPubsubService(serviceType: string, endpoint: any, topics: string[], addresses: string[]): this;
+    /**
+     * 构建 DID 文档
+     */
+    buildDIDDocument(keypair: KeyPair, encryptedPeerId: EncryptedPeerID): DIDDocument;
+    /**
+     * 构建包含 PubSub 信息的 DID 文档
+     */
+    buildDIDDocumentWithPubsub(keypair: KeyPair, encryptedPeerId: EncryptedPeerID, pubsubTopics: string[], networkAddresses: string[]): DIDDocument;
+    /**
+     * 派生 did:key 格式的 DID
+     */
+    private deriveDIDKey;
+    /**
+     * 创建并发布 DID 文档
+     */
+    createAndPublish(keypair: KeyPair, peerId: string): Promise<DIDPublishResult>;
+    /**
+     * 创建并发布包含 PubSub 信息的 DID 文档
+     */
+    createAndPublishWithPubsub(keypair: KeyPair, peerId: string, pubsubTopics: string[], networkAddresses: string[]): Promise<DIDPublishResult>;
+    /**
+     * 上传 DID 文档到 IPFS
+     */
+    private uploadDIDDocument;
+}
+/**
+ * 从 IPFS CID 获取 DID 文档
+ */
+export declare function getDIDDocumentFromCID(ipfsClient: IpfsClient, cid: string): Promise<DIDDocument>;
+/**
+ * 验证 DID 文档完整性
+ * 支持多种哈希算法：SHA-256, SHA-512, Blake2b-512, Blake2s-256
+ */
+export declare function verifyDIDDocumentIntegrity(didDoc: DIDDocument, expectedCid: string): Promise<boolean>;
+/**
+ * 验证 DID 文档完整性（同步版本，仅做结构验证）
+ */
+export declare function verifyDIDDocumentIntegritySync(didDoc: DIDDocument): boolean;
+//# sourceMappingURL=did-builder.d.ts.map

package/dist/did-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-builder.d.ts","sourceRoot":"","sources":["../src/did-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EAGX,gBAAgB,EAChB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD;;GAEG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,QAAQ,CAAiB;gBAEb,UAAU,EAAE,UAAU;IAE1C;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;IAUpD;;OAEG;IACH,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB,IAAI;IAYP;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,GAAG,WAAW;IAsCjF;;OAEG;IACH,0BAA0B,CACxB,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,MAAM,EAAE,EACtB,gBAAgB,EAAE,MAAM,EAAE,GACzB,WAAW;IA0Cd;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoCnF;;OAEG;IACG,0BAA0B,CAC9B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,EACtB,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,gBAAgB,CAAC;IAoC5B;;OAEG;YACW,iBAAiB;CAKhC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,CAAC,CAStB;AAYD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CA+DlB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAY3E"}

package/dist/did-builder.js

@@ -0,0 +1,314 @@
+/**
+ * DID 构建器
+ * 构建和发布符合 W3C DID 规范的 DID 文档
+ * 基于 Rust SDK 的实现逻辑
+ */
+import { DIDError } from './types/errors.js';
+import { encodeBase58, encodeBase64 } from './utils/encoding.js';
+import { encryptPeerId } from './libp2p/encrypted-peer-id.js';
+import { logger } from './utils/logger.js';
+import { sha256, sha512 } from '@noble/hashes/sha256';
+import { blake2b, blake2s } from '@noble/hashes/blake2';
+/**
+ * DID 构建器
+ */
+export class DIDBuilder {
+    ipfsClient;
+    services = [];
+    constructor(ipfsClient) {
+        this.ipfsClient = ipfsClient;
+    }
+    /**
+     * 添加服务端点
+     */
+    addService(serviceType, endpoint) {
+        const service = {
+            id: `#${serviceType.toLowerCase()}`,
+            type: serviceType,
+            serviceEndpoint: endpoint,
+        };
+        this.services.push(service);
+        return this;
+    }
+    /**
+     * 添加 PubSub 服务
+     */
+    addPubsubService(serviceType, endpoint, topics, addresses) {
+        const service = {
+            id: `#${serviceType.toLowerCase()}`,
+            type: serviceType,
+            serviceEndpoint: endpoint,
+            pubsubTopics: topics,
+            networkAddresses: addresses,
+        };
+        this.services.push(service);
+        return this;
+    }
+    /**
+     * 构建 DID 文档
+     */
+    buildDIDDocument(keypair, encryptedPeerId) {
+        const publicKeyMultibase = this.deriveDIDKey(keypair.publicKey);
+        const verificationMethod = {
+            id: `${keypair.did}#key-1`,
+            type: 'Ed25519VerificationKey2020',
+            controller: keypair.did,
+            publicKeyMultibase,
+        };
+        const libp2pService = {
+            id: `${keypair.did}#libp2p`,
+            type: 'LibP2PNode',
+            serviceEndpoint: {
+                ciphertext: encodeBase64(encryptedPeerId.ciphertext),
+                nonce: encodeBase64(encryptedPeerId.nonce),
+                signature: encodeBase64(encryptedPeerId.signature),
+                method: encryptedPeerId.method,
+            },
+        };
+        const allServices = [libp2pService, ...this.services];
+        const didDoc = {
+            '@context': [
+                'https://www.w3.org/ns/did/v1',
+                'https://w3id.org/security/suites/ed25519-2020/v1',
+            ],
+            id: keypair.did,
+            verificationMethod: [verificationMethod],
+            authentication: [`${keypair.did}#key-1`],
+            service: allServices,
+            created: new Date().toISOString(),
+        };
+        return didDoc;
+    }
+    /**
+     * 构建包含 PubSub 信息的 DID 文档
+     */
+    buildDIDDocumentWithPubsub(keypair, encryptedPeerId, pubsubTopics, networkAddresses) {
+        const publicKeyMultibase = this.deriveDIDKey(keypair.publicKey);
+        const verificationMethod = {
+            id: `${keypair.did}#key-1`,
+            type: 'Ed25519VerificationKey2020',
+            controller: keypair.did,
+            publicKeyMultibase,
+        };
+        const libp2pService = {
+            id: `${keypair.did}#libp2p`,
+            type: 'libp2p',
+            serviceEndpoint: {
+                ciphertext: encodeBase64(encryptedPeerId.ciphertext),
+                nonce: encodeBase64(encryptedPeerId.nonce),
+                signature: encodeBase64(encryptedPeerId.signature),
+                method: encryptedPeerId.method,
+                protocol: 'libp2p',
+                version: '1.0.0',
+            },
+            pubsubTopics,
+            networkAddresses,
+        };
+        const allServices = [libp2pService, ...this.services];
+        const didDoc = {
+            '@context': [
+                'https://www.w3.org/ns/did/v1',
+                'https://w3id.org/security/suites/ed25519-2020/v1',
+            ],
+            id: keypair.did,
+            verificationMethod: [verificationMethod],
+            authentication: [`${keypair.did}#key-1`],
+            service: allServices,
+            created: new Date().toISOString(),
+        };
+        return didDoc;
+    }
+    /**
+     * 派生 did:key 格式的 DID
+     */
+    deriveDIDKey(publicKey) {
+        if (publicKey.length !== 32) {
+            throw new DIDError('Public key must be 32 bytes for Ed25519');
+        }
+        const prefix = new Uint8Array([0xed, 0x01]);
+        const combined = new Uint8Array(prefix.length + publicKey.length);
+        combined.set(prefix, 0);
+        combined.set(publicKey, prefix.length);
+        const encoded = encodeBase58(combined);
+        return `did:key:z${encoded}`;
+    }
+    /**
+     * 创建并发布 DID 文档
+     */
+    async createAndPublish(keypair, peerId) {
+        try {
+            logger.info('🚀 开始DID发布流程（简化版）');
+            logger.info('步骤1: 加密libp2p PeerID');
+            const encryptedPeerId = encryptPeerId(keypair.privateKey, peerId);
+            logger.info('✓ PeerID已加密');
+            logger.info('步骤2: 构建DID文档');
+            const didDocument = this.buildDIDDocument(keypair, encryptedPeerId);
+            logger.info('✓ DID文档构建完成');
+            logger.info(`  DID: ${didDocument.id}`);
+            logger.info('步骤3: 上传DID文档到IPFS');
+            const uploadResult = await this.uploadDIDDocument(didDocument);
+            logger.info('✓ 上传完成');
+            logger.info(`  CID: ${uploadResult.cid}`);
+            logger.info('✅ DID发布成功');
+            logger.info(`  DID: ${keypair.did}`);
+            logger.info(`  CID: ${uploadResult.cid}`);
+            logger.info('  绑定关系: 通过ZKP验证');
+            return {
+                did: keypair.did,
+                cid: uploadResult.cid,
+                didDocument,
+                encryptedPeerId,
+            };
+        }
+        catch (error) {
+            throw new DIDError('Failed to create and publish DID document', {
+                originalError: error,
+            });
+        }
+    }
+    /**
+     * 创建并发布包含 PubSub 信息的 DID 文档
+     */
+    async createAndPublishWithPubsub(keypair, peerId, pubsubTopics, networkAddresses) {
+        logger.info('🚀 开始DID发布流程（包含PubSub信息）');
+        logger.info('步骤1: 加密libp2p PeerID');
+        const encryptedPeerId = encryptPeerId(keypair.privateKey, peerId);
+        logger.info('✓ PeerID已加密');
+        logger.info('步骤2: 构建包含PubSub信息的DID文档');
+        const didDocument = this.buildDIDDocumentWithPubsub(keypair, encryptedPeerId, pubsubTopics, networkAddresses);
+        logger.info('✓ DID文档构建完成');
+        logger.info(`  DID: ${didDocument.id}`);
+        logger.info('步骤3: 上传DID文档到IPFS');
+        const uploadResult = await this.uploadDIDDocument(didDocument);
+        logger.info('✓ 上传完成');
+        logger.info(`  CID: ${uploadResult.cid}`);
+        logger.info('✅ DID发布成功（包含PubSub信息）');
+        logger.info(`  DID: ${keypair.did}`);
+        logger.info(`  CID: ${uploadResult.cid}`);
+        logger.info(`  PubSub主题: ${pubsubTopics.join(', ')}`);
+        logger.info(`  网络地址: ${networkAddresses.join(', ')}`);
+        return {
+            did: keypair.did,
+            cid: uploadResult.cid,
+            didDocument,
+            encryptedPeerId,
+        };
+    }
+    /**
+     * 上传 DID 文档到 IPFS
+     */
+    async uploadDIDDocument(didDoc) {
+        const json = JSON.stringify(didDoc, null, 2);
+        const result = await this.ipfsClient.upload(json, 'did.json');
+        return { cid: result.cid, size: result.size };
+    }
+}
+/**
+ * 从 IPFS CID 获取 DID 文档
+ */
+export async function getDIDDocumentFromCID(ipfsClient, cid) {
+    logger.info(`从IPFS获取DID文档: ${cid}`);
+    const content = await ipfsClient.get(cid);
+    const didDoc = JSON.parse(content);
+    logger.info(`✓ DID文档获取成功: ${didDoc.id}`);
+    return didDoc;
+}
+/**
+ * Multihash 代码到哈希函数映射
+ */
+const MULTIHASH_CODES = {
+    0x12: 'sha256',
+    0x13: 'sha512',
+    0xb220: 'blake2b512',
+    0xb260: 'blake2s256',
+};
+/**
+ * 验证 DID 文档完整性
+ * 支持多种哈希算法：SHA-256, SHA-512, Blake2b-512, Blake2s-256
+ */
+export async function verifyDIDDocumentIntegrity(didDoc, expectedCid) {
+    logger.info('验证DID文档完整性与CID绑定（支持多种哈希算法）');
+    const json = JSON.stringify(didDoc);
+    logger.debug(`  DID文档大小: ${json.length} 字节`);
+    try {
+        const { CID } = await import('multiformats/cid');
+        const cid = CID.parse(expectedCid);
+        logger.debug(`  CID版本: ${cid.version}`);
+        logger.debug(`  CID codec: ${cid.codec}`);
+        const multihash = cid.multihash;
+        const hashCode = multihash.code;
+        const hashDigest = multihash.digest;
+        logger.debug(`  Multihash code: 0x${hashCode.toString(16)}`);
+        logger.debug(`  Multihash digest: ${toHexString(hashDigest)}`);
+        let computedHash;
+        switch (hashCode) {
+            case 0x12:
+                logger.debug('  使用SHA-256计算哈希');
+                computedHash = new Uint8Array(sha256(new TextEncoder().encode(json)));
+                break;
+            case 0x13:
+                logger.debug('  使用SHA-512计算哈希');
+                computedHash = new Uint8Array(sha512(new TextEncoder().encode(json)));
+                break;
+            case 0xb220:
+                logger.debug('  使用Blake2b-512计算哈希');
+                computedHash = new Uint8Array(blake2b(new TextEncoder().encode(json), 64));
+                break;
+            case 0xb260:
+                logger.debug('  使用Blake2s-256计算哈希');
+                computedHash = new Uint8Array(blake2s(new TextEncoder().encode(json), 32));
+                break;
+            default:
+                logger.warn(`  ⚠️ 不支持的哈希算法: 0x${hashCode.toString(16)}`);
+                logger.debug('  回退到SHA-256');
+                computedHash = new Uint8Array(sha256(new TextEncoder().encode(json)));
+        }
+        logger.debug(`  计算的哈希: ${toHexString(computedHash)}`);
+        const hashesMatch = buffersEqual(computedHash, new Uint8Array(hashDigest));
+        if (hashesMatch) {
+            logger.info('✅ DID文档哈希与CID匹配');
+        }
+        else {
+            logger.warn('❌ DID文档哈希与CID不匹配');
+            logger.debug(`  预期: ${toHexString(hashDigest)}`);
+            logger.debug(`  实际: ${toHexString(computedHash)}`);
+            logger.debug(`  哈希算法: 0x${hashCode.toString(16)}`);
+        }
+        return hashesMatch;
+    }
+    catch (error) {
+        logger.error('验证DID文档完整性失败', { error });
+        return false;
+    }
+}
+/**
+ * 验证 DID 文档完整性（同步版本，仅做结构验证）
+ */
+export function verifyDIDDocumentIntegritySync(didDoc) {
+    try {
+        return (didDoc['@context'] !== undefined &&
+            didDoc.id !== undefined &&
+            didDoc.verificationMethod !== undefined &&
+            Array.isArray(didDoc.verificationMethod) &&
+            didDoc.verificationMethod.length > 0);
+    }
+    catch (error) {
+        return false;
+    }
+}
+function toHexString(bytes) {
+    const buffer = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+    return Array.from(buffer)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+function buffersEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=did-builder.js.map

package/dist/did-builder.js.map

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

package/dist/did-cache.d.ts

@@ -0,0 +1,133 @@
+/**
+ * DIAP TypeScript SDK - DID 文档缓存
+ * 减少 IPFS 请求，提高验证性能
+ * 使用 LRU 驱逐策略和后台清理任务
+ */
+import type { DIDDocument } from './types/did.js';
+/**
+ * 缓存条目
+ */
+export interface CacheEntry {
+    /** DID 文档 */
+    document: DIDDocument;
+    /** CID */
+    cid: string;
+    /** 缓存时间 */
+    cachedAt: number;
+    /** 过期时间 */
+    expiresAt: number;
+    /** 访问次数 */
+    hitCount: number;
+}
+/**
+ * 缓存统计信息
+ */
+export interface CacheStats {
+    /** 总条目数 */
+    totalEntries: number;
+    /** 过期条目数 */
+    expiredEntries: number;
+    /** 总命中次数 */
+    totalHits: number;
+    /** 最大条目数 */
+    maxEntries: number;
+    /** TTL（秒） */
+    ttl: number;
+}
+/**
+ * DID 文档缓存管理器
+ */
+export declare class DIDCache {
+    /** CID -> CacheEntry 缓存 */
+    private cache;
+    /** 缓存有效期（秒） */
+    private ttl;
+    /** 最大缓存条目数 */
+    private maxEntries;
+    /** 后台清理定时器 */
+    private cleanupTimer?;
+    /**
+     * 创建新的 DID 缓存
+     *
+     * @param ttl - 缓存有效期（秒），默认 3600 秒（1小时）
+     * @param maxEntries - 最大缓存条目数，默认 1000
+     */
+    constructor(ttl?: number, maxEntries?: number);
+    /**
+     * 获取 DID 文档
+     */
+    get(cid: string): DIDDocument | null;
+    /**
+     * 存储 DID 文档
+     */
+    put(cid: string, document: DIDDocument): void;
+    /**
+     * 检查缓存是否存在
+     */
+    has(cid: string): boolean;
+    /**
+     * 移除缓存条目
+     */
+    remove(cid: string): DIDDocument | null;
+    /**
+     * 清空缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存统计
+     */
+    stats(): CacheStats;
+    /**
+     * 清理过期条目
+     */
+    cleanupExpired(): number;
+    /**
+     * 驱逐最少使用的条目（LRU）
+     */
+    private evictLru;
+    /**
+     * 获取当前时间戳（秒）
+     */
+    private getCurrentTimestamp;
+    /**
+     * 启动后台清理任务
+     */
+    private startCleanupTask;
+    /**
+     * 停止后台清理任务
+     */
+    stopCleanupTask(): void;
+    /**
+     * 获取缓存条目数
+     */
+    size(): number;
+    /**
+     * 检查缓存是否为空
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取所有缓存的 CID
+     */
+    getAllCids(): string[];
+    /**
+     * 销毁缓存实例
+     */
+    destroy(): void;
+}
+/**
+ * 创建新的 DID 缓存（便捷函数）
+ */
+export declare function createDIDCache(ttl?: number, maxEntries?: number): DIDCache;
+/**
+ * 创建默认配置的 DID 缓存
+ */
+export declare function createDefaultDIDCache(): DIDCache;
+/**
+ * 获取全局 DID 缓存实例
+ */
+export declare function getGlobalDIDCache(): DIDCache;
+/**
+ * 重置全局 DID 缓存
+ */
+export declare function resetGlobalDIDCache(): void;
+//# sourceMappingURL=did-cache.d.ts.map

package/dist/did-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-cache.d.ts","sourceRoot":"","sources":["../src/did-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;GAEG;AACH,qBAAa,QAAQ;IACnB,2BAA2B;IAC3B,OAAO,CAAC,KAAK,CAA0B;IACvC,eAAe;IACf,OAAO,CAAC,GAAG,CAAS;IACpB,cAAc;IACd,OAAO,CAAC,UAAU,CAAS;IAC3B,cAAc;IACd,OAAO,CAAC,YAAY,CAAC,CAAiB;IAEtC;;;;;OAKG;gBACS,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAgB7C;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAwB3C;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAmBpD;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAahC;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAU9C;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;IACI,KAAK,IAAI,UAAU;IAqB1B;;OAEG;IACI,cAAc,IAAI,MAAM;IAkB/B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiBhB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACI,eAAe,IAAI,IAAI;IAQ9B;;OAEG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACI,UAAU,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACI,OAAO,IAAI,IAAI;CAKvB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAE1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAEhD;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,QAAQ,CAK5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C"}