near-kit 0.0.0 → 0.1.0

package/dist/keys/file-keystore.d.ts

@@ -0,0 +1,130 @@
+/**
+ * File-based key store implementation compatible with NEAR CLI.
+ */
+import type { KeyPair, KeyStore } from "../core/types.js";
+import { type Network } from "./credential-schemas.js";
+/**
+ * File-based key store compatible with NEAR CLI format.
+ *
+ * This keystore is fully compatible with the NEAR CLI credential format,
+ * storing keys in `~/.near-credentials/` with network subdirectories.
+ *
+ * ## Directory Structure
+ * ```
+ * ~/.near-credentials/
+ *   ├── mainnet/
+ *   │   └── account.near.json
+ *   ├── testnet/
+ *   │   ├── account.testnet.json
+ *   │   └── account.testnet/              # Multi-key format (read-only)
+ *   │       └── ed25519_PublicKey.json
+ *   └── implicit/
+ *       └── accountId.json
+ * ```
+ *
+ * ## Features
+ * - Compatible with near-cli and near-cli-rs
+ * - Supports network subdirectories (mainnet, testnet, etc.)
+ * - Reads multi-key format (account.near/ed25519_*.json)
+ * - Writes simple format (account.near.json)
+ * - Preserves optional seed phrase fields
+ *
+ * @example
+ * ```typescript
+ * // Default: ~/.near-credentials/testnet/
+ * const keyStore = new FileKeyStore("~/.near-credentials", "testnet")
+ *
+ * // Custom path
+ * const keyStore = new FileKeyStore("/path/to/keys", "mainnet")
+ *
+ * // Add a key
+ * await keyStore.add("example.testnet", keyPair)
+ * ```
+ */
+export declare class FileKeyStore implements KeyStore {
+    private readonly basePath;
+    private readonly network;
+    /**
+     * Create a new file-based keystore.
+     *
+     * @param basePath - Base directory path (default: `"~/.near-credentials"`).
+     * @param network - Network subdirectory (e.g., `"testnet"`, `"mainnet"`).
+     *
+     * @example
+     * ```typescript
+     * // Store in ~/.near-credentials/testnet/
+     * const keyStore = new FileKeyStore("~/.near-credentials", "testnet")
+     *
+     * // Store in custom directory without network subdirectory
+     * const keyStore = new FileKeyStore("/my/keys")
+     * ```
+     */
+    constructor(basePath?: string, network?: Network);
+    /**
+     * Get the directory path for storing keys.
+     * Includes network subdirectory if specified.
+     * @internal
+     */
+    private getNetworkPath;
+    /**
+     * Get the file path for a specific account.
+     * Uses simple format: `{network}/{accountId}.json`.
+     * @internal
+     */
+    private getKeyFilePath;
+    /**
+     * Get the multi-key directory path for an account.
+     * Format: `{network}/{accountId}/`.
+     * @internal
+     */
+    private getMultiKeyDirPath;
+    /**
+     * Add a key to the keystore
+     *
+     * Stores in NEAR CLI format with network subdirectory.
+     * Uses simple format (one file per account).
+     *
+     * @param accountId - NEAR account ID
+     * @param key - Key pair to store
+     * @param options - Optional metadata (seed phrase, derivation path)
+     */
+    add(accountId: string, key: KeyPair, options?: {
+        seedPhrase?: string;
+        derivationPath?: string;
+        implicitAccountId?: string;
+    }): Promise<void>;
+    /**
+     * Get a key from the keystore
+     *
+     * Attempts to read in this order:
+     * 1. Simple format: {network}/{accountId}.json
+     * 2. Multi-key format: {network}/{accountId}/ed25519_*.json (first match)
+     *
+     * @param accountId - NEAR account ID
+     * @returns Key pair if found, null otherwise
+     */
+    get(accountId: string): Promise<KeyPair | null>;
+    /**
+     * Try to read from multi-key directory format.
+     * Format: `{network}/{accountId}/ed25519_*.json`.
+     * @internal
+     */
+    private getFromMultiKeyDir;
+    /**
+     * Remove a key from the keystore
+     *
+     * Removes both simple format file and multi-key directory if they exist
+     *
+     * @param accountId - NEAR account ID
+     */
+    remove(accountId: string): Promise<void>;
+    /**
+     * List all account IDs in the keystore
+     *
+     * Returns account IDs from both simple format files and multi-key directories
+     *
+     * @returns Array of account IDs
+     */
+    list(): Promise<string[]>;
+}
+//# sourceMappingURL=file-keystore.d.ts.map

package/dist/keys/file-keystore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-keystore.d.ts","sourceRoot":"","sources":["../../src/keys/file-keystore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,EAEL,KAAK,OAAO,EAEb,MAAM,yBAAyB,CAAA;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C;;;;;;;;;;;;;;OAcG;gBACS,QAAQ,SAAwB,EAAE,OAAO,CAAC,EAAE,OAAO;IAS/D;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAItB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAItB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;;;;;OASG;IACG,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAC3B,GACA,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;;;;;;;OASG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA0BrD;;;;OAIG;YACW,kBAAkB;IAkChC;;;;;;OAMG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B9C;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAwChC"}

package/dist/keys/file-keystore.js

@@ -0,0 +1,266 @@
+import { parseKey } from "../utils/key.js";
+import { parseCredentialFile, } from "./credential-schemas.js";
+/**
+ * File-based key store compatible with NEAR CLI format.
+ *
+ * This keystore is fully compatible with the NEAR CLI credential format,
+ * storing keys in `~/.near-credentials/` with network subdirectories.
+ *
+ * ## Directory Structure
+ * ```
+ * ~/.near-credentials/
+ *   ├── mainnet/
+ *   │   └── account.near.json
+ *   ├── testnet/
+ *   │   ├── account.testnet.json
+ *   │   └── account.testnet/              # Multi-key format (read-only)
+ *   │       └── ed25519_PublicKey.json
+ *   └── implicit/
+ *       └── accountId.json
+ * ```
+ *
+ * ## Features
+ * - Compatible with near-cli and near-cli-rs
+ * - Supports network subdirectories (mainnet, testnet, etc.)
+ * - Reads multi-key format (account.near/ed25519_*.json)
+ * - Writes simple format (account.near.json)
+ * - Preserves optional seed phrase fields
+ *
+ * @example
+ * ```typescript
+ * // Default: ~/.near-credentials/testnet/
+ * const keyStore = new FileKeyStore("~/.near-credentials", "testnet")
+ *
+ * // Custom path
+ * const keyStore = new FileKeyStore("/path/to/keys", "mainnet")
+ *
+ * // Add a key
+ * await keyStore.add("example.testnet", keyPair)
+ * ```
+ */
+export class FileKeyStore {
+    /**
+     * Create a new file-based keystore.
+     *
+     * @param basePath - Base directory path (default: `"~/.near-credentials"`).
+     * @param network - Network subdirectory (e.g., `"testnet"`, `"mainnet"`).
+     *
+     * @example
+     * ```typescript
+     * // Store in ~/.near-credentials/testnet/
+     * const keyStore = new FileKeyStore("~/.near-credentials", "testnet")
+     *
+     * // Store in custom directory without network subdirectory
+     * const keyStore = new FileKeyStore("/my/keys")
+     * ```
+     */
+    constructor(basePath = "~/.near-credentials", network) {
+        // Expand home directory
+        this.basePath = basePath.replace(/^~/, process.env["HOME"] || process.env["USERPROFILE"] || "");
+        this.network = network;
+    }
+    /**
+     * Get the directory path for storing keys.
+     * Includes network subdirectory if specified.
+     * @internal
+     */
+    getNetworkPath() {
+        return this.network ? `${this.basePath}/${this.network}` : this.basePath;
+    }
+    /**
+     * Get the file path for a specific account.
+     * Uses simple format: `{network}/{accountId}.json`.
+     * @internal
+     */
+    getKeyFilePath(accountId) {
+        return `${this.getNetworkPath()}/${accountId}.json`;
+    }
+    /**
+     * Get the multi-key directory path for an account.
+     * Format: `{network}/{accountId}/`.
+     * @internal
+     */
+    getMultiKeyDirPath(accountId) {
+        return `${this.getNetworkPath()}/${accountId}`;
+    }
+    /**
+     * Add a key to the keystore
+     *
+     * Stores in NEAR CLI format with network subdirectory.
+     * Uses simple format (one file per account).
+     *
+     * @param accountId - NEAR account ID
+     * @param key - Key pair to store
+     * @param options - Optional metadata (seed phrase, derivation path)
+     */
+    async add(accountId, key, options) {
+        const fs = await import("node:fs/promises");
+        // Ensure directory exists
+        const networkPath = this.getNetworkPath();
+        await fs.mkdir(networkPath, { recursive: true });
+        // Create credential data in NEAR CLI format
+        const keyData = {
+            account_id: accountId,
+            public_key: key.publicKey.toString(),
+            private_key: key.secretKey, // Use private_key (not secret_key)
+        };
+        // Add optional fields if provided
+        if (options?.seedPhrase) {
+            keyData.master_seed_phrase = options.seedPhrase;
+        }
+        if (options?.derivationPath) {
+            keyData.seed_phrase_hd_path = options.derivationPath;
+        }
+        if (options?.implicitAccountId) {
+            keyData.implicit_account_id = options.implicitAccountId;
+        }
+        const filePath = this.getKeyFilePath(accountId);
+        await fs.writeFile(filePath, JSON.stringify(keyData, null, 2));
+    }
+    /**
+     * Get a key from the keystore
+     *
+     * Attempts to read in this order:
+     * 1. Simple format: {network}/{accountId}.json
+     * 2. Multi-key format: {network}/{accountId}/ed25519_*.json (first match)
+     *
+     * @param accountId - NEAR account ID
+     * @returns Key pair if found, null otherwise
+     */
+    async get(accountId) {
+        try {
+            const fs = await import("node:fs/promises");
+            // Try simple format first
+            const filePath = this.getKeyFilePath(accountId);
+            try {
+                const content = await fs.readFile(filePath, "utf-8");
+                const keyData = parseCredentialFile(JSON.parse(content));
+                return parseKey(keyData.private_key);
+            }
+            catch (error) {
+                // If simple format fails, try multi-key format
+                if (error.code === "ENOENT") {
+                    return await this.getFromMultiKeyDir(accountId);
+                }
+                throw error;
+            }
+        }
+        catch (error) {
+            // File doesn't exist or can't be read
+            if (error.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Try to read from multi-key directory format.
+     * Format: `{network}/{accountId}/ed25519_*.json`.
+     * @internal
+     */
+    async getFromMultiKeyDir(accountId) {
+        try {
+            const fs = await import("node:fs/promises");
+            const multiKeyDir = this.getMultiKeyDirPath(accountId);
+            // Check if directory exists
+            const stat = await fs.stat(multiKeyDir);
+            if (!stat.isDirectory()) {
+                return null;
+            }
+            // Read all files in the directory
+            const files = await fs.readdir(multiKeyDir);
+            // Find first ed25519 key file
+            const keyFile = files.find((file) => file.startsWith("ed25519_") && file.endsWith(".json"));
+            if (!keyFile) {
+                return null;
+            }
+            // Read and parse the key file
+            const content = await fs.readFile(`${multiKeyDir}/${keyFile}`, "utf-8");
+            const keyData = parseCredentialFile(JSON.parse(content));
+            return parseKey(keyData.private_key);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Remove a key from the keystore
+     *
+     * Removes both simple format file and multi-key directory if they exist
+     *
+     * @param accountId - NEAR account ID
+     */
+    async remove(accountId) {
+        const fs = await import("node:fs/promises");
+        // Remove simple format file
+        const filePath = this.getKeyFilePath(accountId);
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            // Ignore if file doesn't exist
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        // Remove multi-key directory if it exists
+        const multiKeyDir = this.getMultiKeyDirPath(accountId);
+        try {
+            await fs.rm(multiKeyDir, { recursive: true, force: true });
+        }
+        catch (error) {
+            // Ignore if directory doesn't exist
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+    }
+    /**
+     * List all account IDs in the keystore
+     *
+     * Returns account IDs from both simple format files and multi-key directories
+     *
+     * @returns Array of account IDs
+     */
+    async list() {
+        try {
+            const fs = await import("node:fs/promises");
+            const networkPath = this.getNetworkPath();
+            const entries = await fs.readdir(networkPath, { withFileTypes: true });
+            const accountIds = new Set();
+            for (const entry of entries) {
+                if (entry.isFile() && entry.name.endsWith(".json")) {
+                    // Simple format: account.json
+                    accountIds.add(entry.name.replace(".json", ""));
+                }
+                else if (entry.isDirectory()) {
+                    // Multi-key format: account/
+                    // Check if directory contains key files
+                    const dirPath = `${networkPath}/${entry.name}`;
+                    try {
+                        const files = await fs.readdir(dirPath);
+                        const hasKeyFiles = files.some((file) => file.startsWith("ed25519_") && file.endsWith(".json"));
+                        if (hasKeyFiles) {
+                            accountIds.add(entry.name);
+                        }
+                    }
+                    catch {
+                        // Ignore errors reading subdirectories
+                    }
+                }
+            }
+            return Array.from(accountIds).sort();
+        }
+        catch (error) {
+            // Directory doesn't exist
+            if (error.code === "ENOENT") {
+                return [];
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=file-keystore.js.map

package/dist/keys/file-keystore.js.map

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

package/dist/keys/in-memory-keystore.d.ts

@@ -0,0 +1,71 @@
+/**
+ * In-memory key store implementation.
+ */
+import type { KeyPair, KeyStore } from "../core/types.js";
+/**
+ * In-memory key store.
+ *
+ * Keys are stored in memory and lost when the process exits.
+ * Useful for testing, development, and temporary key storage.
+ *
+ * @example
+ * ```typescript
+ * // Empty keystore
+ * const keyStore = new InMemoryKeyStore()
+ *
+ * // Pre-populate with keys
+ * const keyStore = new InMemoryKeyStore({
+ *   "alice.near": "ed25519:...",
+ *   "bob.near": "ed25519:..."
+ * })
+ * ```
+ */
+export declare class InMemoryKeyStore implements KeyStore {
+    private keys;
+    /**
+     * Create a new in-memory keystore.
+     *
+     * @param initialKeys - Optional initial keys to populate the store
+     *
+     * @example
+     * ```typescript
+     * const keyStore = new InMemoryKeyStore({
+     *   "test.near": "ed25519:3D4c2v8K5x..."
+     * })
+     * ```
+     */
+    constructor(initialKeys?: Record<string, string>);
+    /**
+     * Add a key to the keystore
+     *
+     * @param accountId - NEAR account ID
+     * @param key - Key pair to store
+     */
+    add(accountId: string, key: KeyPair): Promise<void>;
+    /**
+     * Get a key from the keystore
+     *
+     * @param accountId - NEAR account ID
+     * @returns Key pair if found, null otherwise
+     */
+    get(accountId: string): Promise<KeyPair | null>;
+    /**
+     * Remove a key from the keystore
+     *
+     * @param accountId - NEAR account ID
+     */
+    remove(accountId: string): Promise<void>;
+    /**
+     * List all account IDs in the keystore
+     *
+     * @returns Array of account IDs
+     */
+    list(): Promise<string[]>;
+    /**
+     * Clear all keys from the keystore
+     *
+     * Useful for testing cleanup.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=in-memory-keystore.d.ts.map

package/dist/keys/in-memory-keystore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-keystore.d.ts","sourceRoot":"","sources":["../../src/keys/in-memory-keystore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAGzD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,IAAI,CAAsB;IAElC;;;;;;;;;;;OAWG;gBACS,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAWhD;;;;;OAKG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;;;;OAKG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIrD;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/keys/in-memory-keystore.js

@@ -0,0 +1,85 @@
+import { parseKey } from "../utils/key.js";
+/**
+ * In-memory key store.
+ *
+ * Keys are stored in memory and lost when the process exits.
+ * Useful for testing, development, and temporary key storage.
+ *
+ * @example
+ * ```typescript
+ * // Empty keystore
+ * const keyStore = new InMemoryKeyStore()
+ *
+ * // Pre-populate with keys
+ * const keyStore = new InMemoryKeyStore({
+ *   "alice.near": "ed25519:...",
+ *   "bob.near": "ed25519:..."
+ * })
+ * ```
+ */
+export class InMemoryKeyStore {
+    /**
+     * Create a new in-memory keystore.
+     *
+     * @param initialKeys - Optional initial keys to populate the store
+     *
+     * @example
+     * ```typescript
+     * const keyStore = new InMemoryKeyStore({
+     *   "test.near": "ed25519:3D4c2v8K5x..."
+     * })
+     * ```
+     */
+    constructor(initialKeys) {
+        this.keys = new Map();
+        if (initialKeys) {
+            for (const [accountId, keyString] of Object.entries(initialKeys)) {
+                const keyPair = parseKey(keyString);
+                this.keys.set(accountId, keyPair);
+            }
+        }
+    }
+    /**
+     * Add a key to the keystore
+     *
+     * @param accountId - NEAR account ID
+     * @param key - Key pair to store
+     */
+    async add(accountId, key) {
+        this.keys.set(accountId, key);
+    }
+    /**
+     * Get a key from the keystore
+     *
+     * @param accountId - NEAR account ID
+     * @returns Key pair if found, null otherwise
+     */
+    async get(accountId) {
+        return this.keys.get(accountId) ?? null;
+    }
+    /**
+     * Remove a key from the keystore
+     *
+     * @param accountId - NEAR account ID
+     */
+    async remove(accountId) {
+        this.keys.delete(accountId);
+    }
+    /**
+     * List all account IDs in the keystore
+     *
+     * @returns Array of account IDs
+     */
+    async list() {
+        return Array.from(this.keys.keys());
+    }
+    /**
+     * Clear all keys from the keystore
+     *
+     * Useful for testing cleanup.
+     */
+    clear() {
+        this.keys.clear();
+    }
+}
+//# sourceMappingURL=in-memory-keystore.js.map

package/dist/keys/in-memory-keystore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-keystore.js","sourceRoot":"","sources":["../../src/keys/in-memory-keystore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,gBAAgB;IAG3B;;;;;;;;;;;OAWG;IACH,YAAY,WAAoC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAA;QAErB,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,GAAY;QACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAA;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC7B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;CACF"}

package/dist/keys/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Key management module.
+ *
+ * @remarks
+ * Includes {@link InMemoryKeyStore} for ephemeral keys, {@link FileKeyStore}
+ * for NEAR-CLI compatible disk storage, and credential schemas for working
+ * with existing NEAR tooling.
+ */
+export * from "./credential-schemas.js";
+export * from "./file-keystore.js";
+export * from "./in-memory-keystore.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/keys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/keys/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA"}

package/dist/keys/index.js

@@ -0,0 +1,18 @@
+/**
+ * Key management module.
+ *
+ * @remarks
+ * Includes {@link InMemoryKeyStore} for ephemeral keys, {@link FileKeyStore}
+ * for NEAR-CLI compatible disk storage, and credential schemas for working
+ * with existing NEAR tooling.
+ */
+export * from "./credential-schemas.js";
+export * from "./file-keystore.js";
+export * from "./in-memory-keystore.js";
+// NativeKeyStore contains native Node.js dependencies and cannot be bundled for browsers
+// For Node.js/Bun environments, import directly:
+// import { NativeKeyStore } from "near-kit/dist/keys/native-keystore.js"
+//
+// For browser environments, use InMemoryKeyStore instead
+// export * from "./native-keystore.js"
+//# sourceMappingURL=index.js.map

package/dist/keys/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/keys/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AAEvC,yFAAyF;AACzF,iDAAiD;AACjD,yEAAyE;AACzE,EAAE;AACF,yDAAyD;AACzD,uCAAuC"}