@lucid-agents/opencode-x402-plugin 0.1.0

package/dist/index.js

@@ -0,0 +1,491 @@
+/**
+ * OpenCode x402 Auth Plugin
+ *
+ * Enables OpenCode to authenticate with the x402 Inference Router using
+ * wallet-signed ERC-2612 permits for crypto-native payment.
+ *
+ * @example
+ * ```json
+ * // opencode.json
+ * {
+ *   "plugins": ["opencode-x402-auth"],
+ *   "provider": {
+ *     "x402": {
+ *       "npm": "@ai-sdk/openai-compatible",
+ *       "options": { "baseURL": "http://localhost:8080/v1" }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+import { createWalletClient, http, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base, baseSepolia, mainnet } from "viem/chains";
+import { PermitCache, shouldInvalidatePermit } from "./cache";
+// ============================================================================
+// Constants
+// ============================================================================
+/** USDC contract addresses by network */
+const USDC_ADDRESSES = {
+    "eip155:8453": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base Mainnet
+    "eip155:84532": "0x036CbD53842c5426634e7929541eC2318f3dCF7e", // Base Sepolia
+    "eip155:1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // Ethereum Mainnet
+};
+/** Chain configs by CAIP-2 identifier */
+const CHAINS = {
+    "eip155:8453": base,
+    "eip155:84532": baseSepolia,
+    "eip155:1": mainnet,
+};
+/** Default permit cap in token units ($0.10 USDC = 100,000 with 6 decimals) */
+const DEFAULT_PERMIT_CAP = "100000";
+/** Default permit validity (1 hour) */
+const DEFAULT_VALIDITY_SECONDS = 3600;
+// ============================================================================
+// EIP-712 Signing
+// ============================================================================
+/**
+ * EIP-712 domain for ERC-2612 Permit
+ */
+function getPermitDomain(tokenName, tokenVersion, chainId, verifyingContract) {
+    return {
+        name: tokenName,
+        version: tokenVersion,
+        chainId,
+        verifyingContract,
+    };
+}
+/**
+ * EIP-712 types for ERC-2612 Permit
+ */
+const PERMIT_TYPES = {
+    Permit: [
+        { name: "owner", type: "address" },
+        { name: "spender", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" },
+    ],
+};
+/**
+ * Generate a random nonce for the permit
+ */
+function generateNonce() {
+    const randomBytes = new Uint8Array(32);
+    crypto.getRandomValues(randomBytes);
+    // Use first 8 bytes as a numeric nonce (sufficient uniqueness)
+    const view = new DataView(randomBytes.buffer);
+    return view.getBigUint64(0, false).toString();
+}
+/**
+ * Sign an ERC-2612 permit using the wallet
+ */
+async function signPermit(wallet, account, config, permitCap) {
+    const chainId = parseInt(config.network.split(":")[1]);
+    const deadline = Math.floor(Date.now() / 1000) + DEFAULT_VALIDITY_SECONDS;
+    const nonce = generateNonce();
+    const domain = getPermitDomain(config.tokenName, config.tokenVersion, chainId, config.asset);
+    const message = {
+        owner: account.address,
+        spender: config.facilitatorSigner,
+        value: BigInt(permitCap),
+        nonce: BigInt(nonce),
+        deadline: BigInt(deadline),
+    };
+    const signature = await wallet.signTypedData({
+        account,
+        domain,
+        types: PERMIT_TYPES,
+        primaryType: "Permit",
+        message,
+    });
+    return {
+        signature,
+        nonce,
+        deadline: deadline.toString(),
+    };
+}
+/**
+ * Create a complete x402 payment payload
+ */
+async function createPaymentPayload(wallet, account, config, permitCap) {
+    const { signature, nonce, deadline } = await signPermit(wallet, account, config, permitCap);
+    const payload = {
+        x402Version: 2,
+        accepted: {
+            scheme: "upto",
+            network: config.network,
+            asset: config.asset,
+            payTo: config.payTo,
+            extra: {
+                name: config.tokenName,
+                version: config.tokenVersion,
+            },
+        },
+        payload: {
+            authorization: {
+                from: account.address,
+                to: config.facilitatorSigner,
+                value: permitCap,
+                validBefore: deadline,
+                nonce,
+            },
+            signature,
+        },
+    };
+    // Base64 encode for the header
+    return btoa(JSON.stringify(payload));
+}
+// ============================================================================
+// Permit Cache Helpers
+// ============================================================================
+async function createCachedPermit(wallet, account, config, permitCap) {
+    const { signature, nonce, deadline } = await signPermit(wallet, account, config, permitCap);
+    const payload = {
+        x402Version: 2,
+        accepted: {
+            scheme: "upto",
+            network: config.network,
+            asset: config.asset,
+            payTo: config.payTo,
+            extra: {
+                name: config.tokenName,
+                version: config.tokenVersion,
+            },
+        },
+        payload: {
+            authorization: {
+                from: account.address,
+                to: config.facilitatorSigner,
+                value: permitCap,
+                validBefore: deadline,
+                nonce,
+            },
+            signature,
+        },
+    };
+    return {
+        paymentSig: btoa(JSON.stringify(payload)),
+        deadline: parseInt(deadline, 10),
+        maxValue: permitCap,
+        nonce,
+        network: config.network,
+        asset: config.asset,
+        payTo: config.payTo,
+    };
+}
+function parseErrorResponse(data) {
+    if (!data || typeof data !== "object") {
+        return null;
+    }
+    const record = data;
+    if (typeof record.code === "string" || typeof record.error === "string") {
+        return {
+            code: typeof record.code === "string" ? record.code : undefined,
+            error: typeof record.error === "string"
+                ? record.error
+                : typeof record.message === "string"
+                    ? record.message
+                    : undefined,
+            message: typeof record.message === "string" ? record.message : undefined,
+        };
+    }
+    const nested = record.error;
+    if (nested && typeof nested === "object") {
+        const nestedRecord = nested;
+        return {
+            code: typeof nestedRecord.code === "string"
+                ? nestedRecord.code
+                : typeof nestedRecord.type === "string"
+                    ? nestedRecord.type
+                    : undefined,
+            error: typeof nestedRecord.message === "string"
+                ? nestedRecord.message
+                : typeof nestedRecord.error === "string"
+                    ? nestedRecord.error
+                    : undefined,
+            message: typeof nestedRecord.message === "string" ? nestedRecord.message : undefined,
+        };
+    }
+    return null;
+}
+async function extractErrorResponse(response) {
+    try {
+        const data = await response.clone().json();
+        return parseErrorResponse(data);
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Router Configuration
+// ============================================================================
+/** Cached router config */
+let cachedRouterConfig = null;
+let cachedRouterUrl = null;
+/**
+ * Fetch router configuration from /v1/config endpoint
+ */
+async function fetchRouterConfig(routerUrl) {
+    // Return cached config if URL hasn't changed
+    if (cachedRouterConfig && cachedRouterUrl === routerUrl) {
+        return cachedRouterConfig;
+    }
+    const response = await fetch(`${routerUrl}/v1/config`);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch router config: ${response.status}`);
+    }
+    const data = (await response.json());
+    // Extract config from nested response structure
+    // The API returns networks[] array with payment config per network
+    const network = data.networks?.[0];
+    const eip712 = data.eip712_config;
+    const config = {
+        network: network?.network_id || "eip155:8453",
+        asset: network?.asset?.address || USDC_ADDRESSES["eip155:8453"],
+        payTo: network?.pay_to || "",
+        facilitatorSigner: network?.pay_to || "", // Same as payTo for now
+        tokenName: eip712?.domain_name || "USD Coin",
+        tokenVersion: eip712?.domain_version || "2",
+    };
+    cachedRouterConfig = config;
+    cachedRouterUrl = routerUrl;
+    return config;
+}
+/**
+ * Clear the router config cache (for testing)
+ */
+export function clearRouterConfigCache() {
+    cachedRouterConfig = null;
+    cachedRouterUrl = null;
+}
+/**
+ * Get default router config for a network (fallback)
+ */
+function getDefaultConfig(network) {
+    return {
+        network,
+        asset: USDC_ADDRESSES[network] || USDC_ADDRESSES["eip155:8453"],
+        payTo: "", // Must be fetched from router
+        facilitatorSigner: "", // Must be fetched from router
+        tokenName: "USD Coin",
+        tokenVersion: "2",
+    };
+}
+// ============================================================================
+// Plugin Implementation
+// ============================================================================
+/**
+ * OpenCode x402 Auth Plugin
+ *
+ * Provides wallet-based authentication for x402 payment protocol.
+ * Signs ERC-2612 permits to authorize spending on each request.
+ */
+export async function X402AuthPlugin({ client }) {
+    return {
+        auth: {
+            provider: "x402",
+            /**
+             * Loader function - called to configure authentication for requests
+             */
+            loader: async (getAuth, provider) => {
+                const auth = await getAuth();
+                // No auth configured yet
+                if (!auth || auth.type !== "wallet" || !auth.privateKey) {
+                    return {};
+                }
+                // Get router URL from provider options or auth config
+                const routerUrl = provider.options?.baseURL?.replace(/\/v1\/?$/, "") ||
+                    auth.routerUrl ||
+                    "http://localhost:8080";
+                // Initialize wallet
+                const account = privateKeyToAccount(auth.privateKey);
+                const network = auth.network || "eip155:8453";
+                const chain = CHAINS[network] || base;
+                const wallet = createWalletClient({
+                    account,
+                    chain,
+                    transport: http(),
+                });
+                // Get permit cap from config
+                const permitCap = auth.permitCap || DEFAULT_PERMIT_CAP;
+                // Fetch router config
+                let routerConfig;
+                try {
+                    routerConfig = await fetchRouterConfig(routerUrl);
+                }
+                catch (error) {
+                    console.error("[x402-auth] Failed to fetch router config:", error);
+                    routerConfig = getDefaultConfig(network);
+                }
+                const permitCache = new PermitCache();
+                const getOrCreatePermit = async () => {
+                    const cached = permitCache.get(routerConfig.network, routerConfig.asset, routerConfig.payTo);
+                    if (cached) {
+                        return cached;
+                    }
+                    const fresh = await createCachedPermit(wallet, account, routerConfig, permitCap);
+                    permitCache.set(fresh);
+                    return fresh;
+                };
+                // Return custom fetch that injects payment signature
+                return {
+                    fetch: async (input, init) => {
+                        const url = typeof input === "string" ? input : input.toString();
+                        // Only inject payment header for API requests to the router
+                        if (!url.includes("/v1/") || url.includes("/v1/config") || url.includes("/v1/models")) {
+                            return fetch(input, init);
+                        }
+                        try {
+                            const sendWithPermit = async (permit) => {
+                                const headers = new Headers(init?.headers);
+                                headers.set("PAYMENT-SIGNATURE", permit.paymentSig);
+                                return fetch(input, { ...init, headers });
+                            };
+                            const permit = await getOrCreatePermit();
+                            const response = await sendWithPermit(permit);
+                            if (response.status === 402 || response.status === 401) {
+                                const error = await extractErrorResponse(response);
+                                if (error && shouldInvalidatePermit(error)) {
+                                    permitCache.invalidate(routerConfig.network, routerConfig.asset, routerConfig.payTo);
+                                    const refreshed = await getOrCreatePermit();
+                                    return sendWithPermit(refreshed);
+                                }
+                            }
+                            return response;
+                        }
+                        catch (error) {
+                            console.error("[x402-auth] Failed to create payment signature:", error);
+                            // Fall back to request without payment (will get 402)
+                            return fetch(input, init);
+                        }
+                    },
+                };
+            },
+            /**
+             * Authentication methods available in /connect
+             */
+            methods: [
+                {
+                    label: "Connect Wallet (Private Key)",
+                    type: "manual",
+                    authorize: async () => {
+                        return {
+                            instructions: "Enter your wallet private key (0x-prefixed hex string).\n" +
+                                "This will be stored locally and used to sign payment permits.\n" +
+                                "WARNING: Never share your private key. Use a dedicated wallet for AI spending.",
+                            method: "key",
+                            callback: async (privateKey) => {
+                                try {
+                                    // Validate private key format
+                                    if (!privateKey.startsWith("0x") || privateKey.length !== 66) {
+                                        console.error("[x402-auth] Invalid private key format");
+                                        return { type: "failed" };
+                                    }
+                                    // Verify we can create an account from it
+                                    const account = privateKeyToAccount(privateKey);
+                                    console.log(`[x402-auth] Wallet connected: ${account.address}`);
+                                    // Store auth config
+                                    await client.auth.set({
+                                        path: { id: "x402" },
+                                        body: {
+                                            type: "wallet",
+                                            privateKey,
+                                            routerUrl: "http://localhost:8080",
+                                            permitCap: DEFAULT_PERMIT_CAP,
+                                            network: "eip155:8453",
+                                        },
+                                    });
+                                    return { type: "success", key: account.address };
+                                }
+                                catch (error) {
+                                    console.error("[x402-auth] Failed to connect wallet:", error);
+                                    return { type: "failed" };
+                                }
+                            },
+                        };
+                    },
+                },
+                {
+                    label: "Configure Router URL",
+                    type: "manual",
+                    authorize: async () => {
+                        return {
+                            instructions: "Enter the x402 router URL (e.g., http://localhost:8080 or https://router.example.com)",
+                            method: "key",
+                            callback: async (routerUrl) => {
+                                try {
+                                    // Validate URL
+                                    const url = new URL(routerUrl);
+                                    // Get existing auth
+                                    const existingAuth = await client.auth.get({ path: { id: "x402" } });
+                                    // Update with new router URL
+                                    await client.auth.set({
+                                        path: { id: "x402" },
+                                        body: {
+                                            ...existingAuth,
+                                            type: existingAuth?.type || "wallet",
+                                            routerUrl: url.origin,
+                                        },
+                                    });
+                                    // Clear cached config so it refetches
+                                    cachedRouterConfig = null;
+                                    cachedRouterUrl = null;
+                                    return { type: "success" };
+                                }
+                                catch (error) {
+                                    console.error("[x402-auth] Invalid router URL:", error);
+                                    return { type: "failed" };
+                                }
+                            },
+                        };
+                    },
+                },
+                {
+                    label: "Set Permit Cap",
+                    type: "manual",
+                    authorize: async () => {
+                        return {
+                            instructions: "Enter the maximum USDC spending cap per permit session.\n" +
+                                "Examples: 1 = $1.00, 10 = $10.00, 100 = $100.00\n" +
+                                "This limits how much can be spent before a new permit is needed.",
+                            method: "key",
+                            callback: async (capInput) => {
+                                try {
+                                    const cap = parseFloat(capInput);
+                                    if (isNaN(cap) || cap <= 0) {
+                                        console.error("[x402-auth] Invalid cap amount");
+                                        return { type: "failed" };
+                                    }
+                                    // Convert to USDC units (6 decimals)
+                                    const permitCap = Math.floor(cap * 1_000_000).toString();
+                                    // Get existing auth
+                                    const existingAuth = await client.auth.get({ path: { id: "x402" } });
+                                    // Update with new cap
+                                    await client.auth.set({
+                                        path: { id: "x402" },
+                                        body: {
+                                            ...existingAuth,
+                                            type: existingAuth?.type || "wallet",
+                                            permitCap,
+                                        },
+                                    });
+                                    console.log(`[x402-auth] Permit cap set to $${cap} (${permitCap} units)`);
+                                    return { type: "success" };
+                                }
+                                catch (error) {
+                                    console.error("[x402-auth] Failed to set permit cap:", error);
+                                    return { type: "failed" };
+                                }
+                            },
+                        };
+                    },
+                },
+            ],
+        },
+    };
+}
+// Default export for OpenCode plugin system
+export default X402AuthPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Utility functions for x402 auth plugin
+ * Exported separately for testing
+ */
+import { type WalletClient, type Account, type Chain } from "viem";
+/** Router configuration from /v1/config endpoint */
+export interface RouterConfig {
+    network: string;
+    asset: string;
+    payTo: string;
+    facilitatorSigner: string;
+    tokenName: string;
+    tokenVersion: string;
+}
+/** x402 Payment Payload structure */
+export interface PaymentPayload {
+    x402Version: 2;
+    accepted: {
+        scheme: "upto";
+        network: string;
+        asset: string;
+        payTo: string;
+        extra: {
+            name: string;
+            version: string;
+        };
+    };
+    payload: {
+        authorization: {
+            from: string;
+            to: string;
+            value: string;
+            validBefore: string;
+            nonce: string;
+        };
+        signature: string;
+    };
+}
+/** Router config API response (matches actual /v1/config structure) */
+export interface RouterConfigResponse {
+    api_version?: string;
+    networks?: Array<{
+        network_id?: string;
+        name?: string;
+        chain_id?: number;
+        asset?: {
+            address?: string;
+            symbol?: string;
+            decimals?: number;
+        };
+        pay_to?: string;
+        active?: boolean;
+    }>;
+    payment_required?: boolean;
+    payment_header?: string;
+    eip712_config?: {
+        domain_name?: string;
+        domain_version?: string;
+    };
+}
+/** USDC contract addresses by network */
+export declare const USDC_ADDRESSES: Record<string, `0x${string}`>;
+/** Chain configs by CAIP-2 identifier */
+export declare const CHAINS: Record<string, Chain>;
+/** Default permit cap in token units ($0.10 USDC = 100,000 with 6 decimals) */
+export declare const DEFAULT_PERMIT_CAP = "100000";
+/** Default permit validity (1 hour) */
+export declare const DEFAULT_VALIDITY_SECONDS = 3600;
+/**
+ * EIP-712 domain for ERC-2612 Permit
+ */
+export declare function getPermitDomain(tokenName: string, tokenVersion: string, chainId: number, verifyingContract: `0x${string}`): {
+    readonly name: string;
+    readonly version: string;
+    readonly chainId: number;
+    readonly verifyingContract: `0x${string}`;
+};
+/**
+ * EIP-712 types for ERC-2612 Permit
+ */
+export declare const PERMIT_TYPES: {
+    readonly Permit: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+};
+/**
+ * Generate a random nonce for the permit
+ */
+export declare function generateNonce(): string;
+/**
+ * Sign an ERC-2612 permit using the wallet
+ */
+export declare function signPermit(wallet: WalletClient, account: Account, config: RouterConfig, permitCap: string): Promise<{
+    signature: string;
+    nonce: string;
+    deadline: string;
+}>;
+/**
+ * Create a complete x402 payment payload
+ */
+export declare function createPaymentPayload(wallet: WalletClient, account: Account, config: RouterConfig, permitCap: string): Promise<string>;
+/**
+ * Decode a payment payload from base64
+ */
+export declare function decodePaymentPayload(encoded: string): PaymentPayload;
+/**
+ * Clear the router config cache (for testing)
+ */
+export declare function clearRouterConfigCache(): void;
+/**
+ * Parse router config response into RouterConfig
+ */
+export declare function parseRouterConfigResponse(data: RouterConfigResponse): RouterConfig;
+/**
+ * Fetch router configuration from /v1/config endpoint
+ */
+export declare function fetchRouterConfig(routerUrl: string): Promise<RouterConfig>;
+/**
+ * Get default router config for a network (fallback)
+ */
+export declare function getDefaultConfig(network: string): RouterConfig;
+/**
+ * Validate a private key format
+ */
+export declare function isValidPrivateKey(privateKey: string): boolean;
+/**
+ * Create a wallet client from a private key
+ */
+export declare function createWalletFromPrivateKey(privateKey: `0x${string}`, network?: string): {
+    wallet: WalletClient;
+    account: Account;
+};
+/**
+ * Convert USDC amount to token units (6 decimals)
+ */
+export declare function usdcToUnits(amount: number): string;
+/**
+ * Convert token units to USDC amount
+ */
+export declare function unitsToUsdc(units: string): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,KAAK,EACX,MAAM,MAAM,CAAC;AAQd,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,CAAC,CAAC;IACf,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IACF,OAAO,EAAE;QACP,aAAa,EAAE;YACb,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAMD,yCAAyC;AACzC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,CAIxD,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAIxC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,uCAAuC;AACvC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAM7C;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,KAAK,MAAM,EAAE;;;;;EAQjC;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAQf,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCjE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAEpE;AAUD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,GAAG,YAAY,CAYlF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkBhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAS9D;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,GAAE,MAAsB,GAC9B;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAW5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}