near-kit 0.0.0 → 0.1.0

package/dist/utils/nep413.js

@@ -0,0 +1,154 @@
+/**
+ * NEP-413: Message signing utilities
+ *
+ * NEP-413 enables off-chain message signing for authentication and ownership verification
+ * without gas fees or blockchain transactions.
+ *
+ * @see https://github.com/near/NEPs/blob/master/neps/nep-0413.md
+ */
+import { ed25519 } from "@noble/curves/ed25519.js";
+import { sha256 } from "@noble/hashes/sha2.js";
+import { base58, base64 } from "@scure/base";
+import { b } from "@zorsh/zorsh";
+import { parsePublicKey } from "./key.js";
+/**
+ * NEP-413 tag prefix: 2^31 + 413 = 2147484061
+ *
+ * This prefix ensures that signed messages cannot be confused with valid transactions.
+ * The tag makes the message too long to be a valid signer account ID.
+ */
+export const NEP413_TAG = 2147484061;
+/**
+ * NEP-413 message payload schema
+ *
+ * Fields are serialized in this order:
+ * 1. message: string - The message to sign
+ * 2. nonce: [u8; 32] - 32-byte nonce for replay protection
+ * 3. recipient: string - Recipient identifier (e.g., "alice.near" or "myapp.com")
+ * 4. callbackUrl: Option<string> - Optional callback URL for web wallets
+ */
+export const Nep413PayloadSchema = b.struct({
+    message: b.string(),
+    nonce: b.array(b.u8(), 32),
+    recipient: b.string(),
+    callbackUrl: b.option(b.string()),
+});
+/**
+ * Serialize NEP-413 message parameters for signing
+ *
+ * Serialization steps:
+ * 1. Serialize the tag (2147484061) as u32
+ * 2. Serialize the payload (message, nonce, recipient, callbackUrl)
+ * 3. Concatenate: tag_bytes + payload_bytes
+ * 4. Hash with SHA256
+ *
+ * @param params - Message signing parameters
+ * @returns Serialized and hashed message ready for signing
+ *
+ * @example
+ * ```typescript
+ * const nonce = crypto.getRandomValues(new Uint8Array(32))
+ * const hash = serializeNep413Message({
+ *   message: "Login to MyApp",
+ *   recipient: "myapp.near",
+ *   nonce,
+ * })
+ * const signature = keyPair.sign(hash)
+ * ```
+ */
+export function serializeNep413Message(params) {
+    if (params.nonce.length !== 32) {
+        throw new Error("Nonce must be exactly 32 bytes");
+    }
+    // Serialize tag as u32
+    const tagBytes = b.u32().serialize(NEP413_TAG);
+    // Serialize payload
+    const payloadBytes = Nep413PayloadSchema.serialize({
+        message: params.message,
+        nonce: Array.from(params.nonce),
+        recipient: params.recipient,
+        callbackUrl: null, // Optional, not typically used in direct signing
+    });
+    // Concatenate tag + payload
+    const combined = new Uint8Array(tagBytes.length + payloadBytes.length);
+    combined.set(tagBytes, 0);
+    combined.set(payloadBytes, tagBytes.length);
+    // Hash the combined bytes
+    return sha256(combined);
+}
+/**
+ * Verify a NEP-413 signed message
+ *
+ * Verification steps:
+ * 1. Reconstruct the payload from parameters
+ * 2. Serialize and hash (tag + payload)
+ * 3. Verify the signature against the hash using the public key
+ *
+ * @param signedMessage - The signed message to verify
+ * @param params - Original message parameters (must match what was signed)
+ * @returns true if signature is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const isValid = verifyNep413Signature(signedMessage, {
+ *   message: "Login to MyApp",
+ *   recipient: "myapp.near",
+ *   nonce,
+ * })
+ * if (isValid) {
+ *   console.log("Signature verified!")
+ * }
+ * ```
+ */
+export function verifyNep413Signature(signedMessage, params) {
+    try {
+        // Parse the public key
+        const publicKey = parsePublicKey(signedMessage.publicKey);
+        // Only Ed25519 is currently supported
+        if (publicKey.keyType !== 0) {
+            throw new Error("Only Ed25519 keys are supported for NEP-413");
+        }
+        // Reconstruct the hashed payload
+        const hash = serializeNep413Message(params);
+        // Decode the signature
+        // Try base64 first (most common), fallback to base58
+        let signatureBytes;
+        try {
+            signatureBytes = base64.decode(signedMessage.signature);
+        }
+        catch {
+            try {
+                // Remove ed25519: prefix if present
+                const sig = signedMessage.signature.replace("ed25519:", "");
+                signatureBytes = base58.decode(sig);
+            }
+            catch {
+                return false;
+            }
+        }
+        // Verify the signature
+        return ed25519.verify(signatureBytes, hash, publicKey.data);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate a random nonce for NEP-413 message signing
+ *
+ * @returns 32-byte random nonce
+ *
+ * @example
+ * ```typescript
+ * const nonce = generateNep413Nonce()
+ * const signedMessage = await near.signMessage({
+ *   message: "Login to MyApp",
+ *   recipient: "myapp.near",
+ *   nonce,
+ * })
+ * ```
+ */
+export function generateNep413Nonce() {
+    return crypto.getRandomValues(new Uint8Array(32));
+}
+//# sourceMappingURL=nep413.js.map

package/dist/utils/nep413.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Zod validation schemas and helpers for NEAR types.
+ *
+ * @remarks
+ * These schemas power runtime validation for account IDs, public/private keys,
+ * amounts, and gas while keeping the developer-facing API ergonomic via
+ * helpers like {@link validateAccountId} and {@link normalizeAmount}.
+ */
+import { z } from "zod";
+/**
+ * Schema for validating NEAR account IDs.
+ *
+ * Rules:
+ * - Length: 2-64 characters
+ * - Characters: lowercase alphanumeric, hyphens, underscores, and dots
+ * - Pattern: subdomain-like structure (e.g., alice.near, contract.mainnet)
+ */
+export declare const AccountIdSchema: z.ZodString;
+export type AccountId = z.infer<typeof AccountIdSchema>;
+/**
+ * Schema for validating NEAR public keys.
+ *
+ * Supports:
+ * - Ed25519: "ed25519:..." (base58 encoded)
+ * - Secp256k1: "secp256k1:..." (base58 encoded)
+ */
+export declare const PublicKeySchema: z.ZodString;
+export type PublicKeyString = z.infer<typeof PublicKeySchema>;
+/**
+ * Type-safe private key string using template literal types.
+ *
+ * Provides compile-time type safety for private keys.
+ * Supports both ed25519 and secp256k1 keys.
+ *
+ * @example
+ * ```typescript
+ * const key: PrivateKey = 'ed25519:...'     // ✅ Valid
+ * const key: PrivateKey = 'secp256k1:...'   // ✅ Valid
+ * const key: PrivateKey = 'alice.near'      // ❌ Type error at compile time
+ *
+ * // Function signature ensures type safety
+ * function signWith(key: PrivateKey) { ... }
+ * signWith('ed25519:abc')      // ✅ Valid
+ * signWith('secp256k1:abc')    // ✅ Valid
+ * signWith('alice.near')       // ❌ Type error
+ * ```
+ */
+export type PrivateKey = `ed25519:${string}` | `secp256k1:${string}`;
+/**
+ * Schema for validating NEAR private keys.
+ *
+ * Supports:
+ * - Ed25519: "ed25519:..." (base58 encoded, 64 bytes)
+ * - Secp256k1: "secp256k1:..." (base58 encoded, 96 bytes)
+ */
+export declare const PrivateKeySchema: z.ZodString;
+export type PrivateKeyString = z.infer<typeof PrivateKeySchema>;
+/**
+ * Schema for NEAR amounts with explicit units.
+ *
+ * Accepts:
+ * - String with unit: "10 NEAR", "1000000 yocto"
+ * - Created via Amount.NEAR(10) or Amount.yocto(1000000n)
+ * - Raw bigint: 1000000n (treated as yoctoNEAR)
+ *
+ * Rejects bare numbers to prevent unit confusion.
+ * Normalizes to yoctoNEAR string.
+ */
+export declare const AmountSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodBigInt]>, z.ZodTransform<string, string | bigint>>;
+export type Amount = z.input<typeof AmountSchema>;
+/**
+ * Schema for gas amounts.
+ *
+ * Accepts:
+ * - String with unit: "30 Tgas", Gas.Tgas(30)
+ * - Raw gas number strings for advanced use
+ *
+ * Normalizes to raw gas string.
+ */
+export declare const GasSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export type Gas = z.input<typeof GasSchema>;
+/**
+ * Validate account ID (throws on invalid).
+ */
+export declare function validateAccountId(accountId: string): string;
+/**
+ * Check if account ID is valid (boolean).
+ */
+export declare function isValidAccountId(accountId: string): boolean;
+/**
+ * Validate public key (throws on invalid).
+ */
+export declare function validatePublicKey(key: string): string;
+/**
+ * Check if public key is valid (boolean).
+ */
+export declare function isValidPublicKey(key: string): boolean;
+/**
+ * Validate private key (throws on invalid).
+ */
+export declare function validatePrivateKey(key: string): string;
+/**
+ * Check if private key is valid (boolean).
+ */
+export declare function isPrivateKey(key: string): boolean;
+/**
+ * Normalize amount to yoctoNEAR string.
+ */
+export declare function normalizeAmount(amount: Amount): string;
+/**
+ * Normalize gas to gas string.
+ */
+export declare function normalizeGas(gas: Gas): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAyBvB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAazB,CAAA;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAIvD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,aAaoB,CAAA;AAEhD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAI7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,MAAM,EAAE,GAAG,aAAa,MAAM,EAAE,CAAA;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,aAaoB,CAAA;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAI/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,qGAIrB,CAAA;AAEJ,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAIjD;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,wDAEpB,CAAA;AAEF,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAI3C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAE7C"}

package/dist/utils/validation.js

@@ -0,0 +1,150 @@
+/**
+ * Zod validation schemas and helpers for NEAR types.
+ *
+ * @remarks
+ * These schemas power runtime validation for account IDs, public/private keys,
+ * amounts, and gas while keeping the developer-facing API ergonomic via
+ * helpers like {@link validateAccountId} and {@link normalizeAmount}.
+ */
+import { z } from "zod";
+import { ACCOUNT_ID_REGEX, ED25519_KEY_PREFIX, MAX_ACCOUNT_ID_LENGTH, MIN_ACCOUNT_ID_LENGTH, SECP256K1_KEY_PREFIX, } from "../core/constants.js";
+import { parseAmount } from "./amount.js";
+import { parseGas } from "./gas.js";
+// ==================== Base58 Validation ====================
+/**
+ * Check if a string is valid base58 encoding.
+ * @internal
+ */
+function isValidBase58(str) {
+    const base58Regex = /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+$/;
+    return base58Regex.test(str);
+}
+// ==================== Account ID Schema ====================
+/**
+ * Schema for validating NEAR account IDs.
+ *
+ * Rules:
+ * - Length: 2-64 characters
+ * - Characters: lowercase alphanumeric, hyphens, underscores, and dots
+ * - Pattern: subdomain-like structure (e.g., alice.near, contract.mainnet)
+ */
+export const AccountIdSchema = z
+    .string()
+    .min(MIN_ACCOUNT_ID_LENGTH, `Account ID must be at least ${MIN_ACCOUNT_ID_LENGTH} characters`)
+    .max(MAX_ACCOUNT_ID_LENGTH, `Account ID must be at most ${MAX_ACCOUNT_ID_LENGTH} characters`)
+    .regex(ACCOUNT_ID_REGEX, "Account ID must contain only lowercase alphanumeric characters, hyphens, underscores, and dots");
+// ==================== Public Key Schema ====================
+/**
+ * Schema for validating NEAR public keys.
+ *
+ * Supports:
+ * - Ed25519: "ed25519:..." (base58 encoded)
+ * - Secp256k1: "secp256k1:..." (base58 encoded)
+ */
+export const PublicKeySchema = z
+    .string()
+    .refine((key) => key.startsWith(ED25519_KEY_PREFIX) ||
+    key.startsWith(SECP256K1_KEY_PREFIX), "Public key must start with 'ed25519:' or 'secp256k1:'")
+    .refine((key) => {
+    const keyData = key.startsWith(ED25519_KEY_PREFIX)
+        ? key.slice(ED25519_KEY_PREFIX.length)
+        : key.slice(SECP256K1_KEY_PREFIX.length);
+    return isValidBase58(keyData);
+}, "Public key must be valid base58 encoding");
+/**
+ * Schema for validating NEAR private keys.
+ *
+ * Supports:
+ * - Ed25519: "ed25519:..." (base58 encoded, 64 bytes)
+ * - Secp256k1: "secp256k1:..." (base58 encoded, 96 bytes)
+ */
+export const PrivateKeySchema = z
+    .string()
+    .refine((key) => key.startsWith(ED25519_KEY_PREFIX) ||
+    key.startsWith(SECP256K1_KEY_PREFIX), "Private key must start with 'ed25519:' or 'secp256k1:'")
+    .refine((key) => {
+    const keyData = key.startsWith(ED25519_KEY_PREFIX)
+        ? key.slice(ED25519_KEY_PREFIX.length)
+        : key.slice(SECP256K1_KEY_PREFIX.length);
+    return keyData.length > 0 && isValidBase58(keyData);
+}, "Private key must be valid base58 encoding");
+// ==================== Amount Schema ====================
+/**
+ * Schema for NEAR amounts with explicit units.
+ *
+ * Accepts:
+ * - String with unit: "10 NEAR", "1000000 yocto"
+ * - Created via Amount.NEAR(10) or Amount.yocto(1000000n)
+ * - Raw bigint: 1000000n (treated as yoctoNEAR)
+ *
+ * Rejects bare numbers to prevent unit confusion.
+ * Normalizes to yoctoNEAR string.
+ */
+export const AmountSchema = z
+    .union([z.string(), z.bigint()])
+    .transform((amount) => {
+    return parseAmount(amount);
+});
+// ==================== Gas Schema ====================
+/**
+ * Schema for gas amounts.
+ *
+ * Accepts:
+ * - String with unit: "30 Tgas", Gas.Tgas(30)
+ * - Raw gas number strings for advanced use
+ *
+ * Normalizes to raw gas string.
+ */
+export const GasSchema = z.string().transform((gas) => {
+    return parseGas(gas);
+});
+// ==================== Helper Functions ====================
+/**
+ * Validate account ID (throws on invalid).
+ */
+export function validateAccountId(accountId) {
+    return AccountIdSchema.parse(accountId);
+}
+/**
+ * Check if account ID is valid (boolean).
+ */
+export function isValidAccountId(accountId) {
+    return AccountIdSchema.safeParse(accountId).success;
+}
+/**
+ * Validate public key (throws on invalid).
+ */
+export function validatePublicKey(key) {
+    return PublicKeySchema.parse(key);
+}
+/**
+ * Check if public key is valid (boolean).
+ */
+export function isValidPublicKey(key) {
+    return PublicKeySchema.safeParse(key).success;
+}
+/**
+ * Validate private key (throws on invalid).
+ */
+export function validatePrivateKey(key) {
+    return PrivateKeySchema.parse(key);
+}
+/**
+ * Check if private key is valid (boolean).
+ */
+export function isPrivateKey(key) {
+    return PrivateKeySchema.safeParse(key).success;
+}
+/**
+ * Normalize amount to yoctoNEAR string.
+ */
+export function normalizeAmount(amount) {
+    return AmountSchema.parse(amount);
+}
+/**
+ * Normalize gas to gas string.
+ */
+export function normalizeGas(gas) {
+    return GasSchema.parse(gas);
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/dist/wallets/adapters.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Wallet adapters for NEAR wallet integrations.
+ *
+ * Provides adapter functions to integrate with popular NEAR wallets:
+ * - `@near-wallet-selector/core`
+ * - `@hot-labs/near-connect`
+ *
+ * These adapters use duck typing / structural compatibility to work with
+ * wallet interfaces. While the actual wallet packages use `@near-js` types
+ * (which are classes), our types (plain objects) are structurally compatible
+ * and work correctly at runtime. See `tests/wallets/type-compatibility.test.ts`
+ * for verification.
+ */
+import type { WalletConnection } from "../core/types.js";
+import type { HotConnectConnector } from "./types.js";
+type WalletSelectorWallet = {
+    getAccounts(): Promise<Array<{
+        accountId: string;
+        publicKey?: string;
+    }>>;
+    signAndSendTransaction(params: {
+        signerId?: string;
+        receiverId?: string;
+        actions: unknown[];
+    }): Promise<unknown>;
+    signMessage?(params: {
+        message: string;
+        recipient: string;
+        nonce: Buffer;
+        callbackUrl?: string;
+        state?: string;
+    }): Promise<unknown>;
+};
+/**
+ * Adapter for @near-wallet-selector/core
+ *
+ * Converts a wallet-selector Wallet instance to the WalletConnection interface.
+ *
+ * @param wallet - Wallet instance from wallet-selector
+ * @returns WalletConnection interface compatible with near-ts
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-ts'
+ * import { setupWalletSelector } from '@near-wallet-selector/core'
+ * import { fromWalletSelector } from 'near-ts/wallets'
+ *
+ * const selector = await setupWalletSelector({
+ *   network: 'mainnet',
+ *   modules: [...]
+ * })
+ * const wallet = await selector.wallet()
+ *
+ * const near = new Near({
+ *   network: 'mainnet',
+ *   wallet: fromWalletSelector(wallet)
+ * })
+ * ```
+ */
+export declare function fromWalletSelector(wallet: WalletSelectorWallet): WalletConnection;
+/**
+ * Adapter for @hot-labs/near-connect (HOT Connect)
+ *
+ * Converts a HOT Connect NearConnector instance to the WalletConnection interface.
+ *
+ * @param connector - NearConnector instance from HOT Connect
+ * @returns WalletConnection interface compatible with near-ts
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-ts'
+ * import { NearConnector } from '@hot-labs/near-connect'
+ * import { fromHotConnect } from 'near-ts/wallets'
+ *
+ * const connector = new NearConnector({ network: 'mainnet' })
+ *
+ * // Wait for user to connect their wallet
+ * connector.on('wallet:signIn', async () => {
+ *   const near = new Near({
+ *     network: 'mainnet',
+ *     wallet: fromHotConnect(connector)
+ *   })
+ *
+ *   // Use near-ts with the connected wallet
+ *   await near.call('contract.near', 'method', { arg: 'value' })
+ * })
+ * ```
+ */
+/**
+ * Adapter for @hot-labs/near-connect (HOT Connect)
+ *
+ * Converts a HOT Connect NearConnector instance to the WalletConnection interface.
+ *
+ * @param connector - NearConnector instance from HOT Connect
+ * @returns WalletConnection interface compatible with near-kit
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-kit'
+ * import { NearConnector } from '@hot-labs/near-connect'
+ * import { fromHotConnect } from 'near-kit/wallets'
+ *
+ * const connector = new NearConnector({ network: 'mainnet' })
+ *
+ * // Wait for user to connect their wallet
+ * connector.on('wallet:signIn', async () => {
+ *   const near = new Near({
+ *     network: 'mainnet',
+ *     wallet: fromHotConnect(connector)
+ *   })
+ *
+ *   // Use near-kit with the connected wallet
+ *   await near.call('contract.near', 'method', { arg: 'value' })
+ * })
+ * ```
+ */
+export declare function fromHotConnect(connector: HotConnectConnector): WalletConnection;
+export {};
+//# sourceMappingURL=adapters.d.ts.map

package/dist/wallets/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/wallets/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAIV,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAQnB,KAAK,oBAAoB,GAAG;IAC1B,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IACxE,sBAAsB,CAAC,MAAM,EAAE;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,OAAO,EAAE,CAAA;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpB,WAAW,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,oBAAoB,GAC3B,gBAAgB,CA8ClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,mBAAmB,GAC7B,gBAAgB,CAqKlB"}