near-kit 0.0.0 → 0.2.0

package/dist/keys/rotating-keystore.js

@@ -0,0 +1,240 @@
+import { parseKey } from "../utils/key.js";
+/**
+ * Rotating key store that cycles through multiple keys per account.
+ *
+ * This keystore enables high-throughput concurrent transactions by rotating
+ * through multiple access keys for a single account. Each transaction uses
+ * a different key in round-robin fashion, eliminating nonce collisions.
+ *
+ * ## Use Cases
+ * - **High-throughput applications**: Send many concurrent transactions without nonce collisions
+ * - **Load balancing**: Distribute transaction load across multiple access keys
+ * - **Key rotation**: Seamlessly rotate keys without downtime
+ *
+ * ## How It Works
+ * - Each account can have multiple keys registered
+ * - `get()` returns the next key in round-robin order
+ * - Each key has independent nonce tracking via NonceManager
+ * - No nonce collisions between concurrent transactions
+ *
+ * @example
+ * ```typescript
+ * // Create keystore with multiple keys for one account
+ * const keyStore = new RotatingKeyStore()
+ * await keyStore.add("alice.near", parseKey("ed25519:key1..."))
+ * await keyStore.add("alice.near", parseKey("ed25519:key2..."))
+ * await keyStore.add("alice.near", parseKey("ed25519:key3..."))
+ *
+ * const near = new Near({ network: "testnet", keyStore })
+ *
+ * // Send 100 concurrent transactions - no nonce collisions!
+ * await Promise.all(
+ *   Array(100).fill(0).map(() =>
+ *     near.transaction("alice.near")
+ *       .transfer("bob.near", "0.1")
+ *       .send()
+ *   )
+ * )
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Initialize with keys
+ * const keyStore = new RotatingKeyStore({
+ *   "alice.near": [
+ *     "ed25519:key1...",
+ *     "ed25519:key2...",
+ *     "ed25519:key3..."
+ *   ]
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Query rotation state
+ * const keys = await keyStore.getAll("alice.near")
+ * console.log(`Account has ${keys.length} keys`)
+ *
+ * const index = keyStore.getCurrentIndex("alice.near")
+ * console.log(`Currently at key index ${index}`)
+ * ```
+ */
+export class RotatingKeyStore {
+    /**
+     * Create a new rotating keystore.
+     *
+     * @param initialKeys - Optional initial keys to populate the store.
+     *   Maps account IDs to arrays of private key strings.
+     *
+     * @example
+     * ```typescript
+     * const keyStore = new RotatingKeyStore({
+     *   "alice.near": ["ed25519:key1...", "ed25519:key2..."],
+     *   "bob.near": ["ed25519:key3..."]
+     * })
+     * ```
+     */
+    constructor(initialKeys) {
+        this.keys = new Map();
+        this.counters = new Map();
+        if (initialKeys) {
+            for (const [accountId, keyStrings] of Object.entries(initialKeys)) {
+                for (const keyString of keyStrings) {
+                    const keyPair = parseKey(keyString);
+                    const existing = this.keys.get(accountId) ?? [];
+                    existing.push(keyPair);
+                    this.keys.set(accountId, existing);
+                }
+            }
+        }
+    }
+    /**
+     * Get the next key for an account using round-robin rotation.
+     *
+     * Each call to `get()` advances to the next key in the rotation.
+     * This is the core mechanism that enables concurrent transactions
+     * without nonce collisions.
+     *
+     * @param accountId - NEAR account ID
+     * @returns Next key in rotation, or null if no keys exist for account
+     *
+     * @example
+     * ```typescript
+     * // First call returns key1, second returns key2, third returns key3, fourth returns key1...
+     * const key1 = await keyStore.get("alice.near")
+     * const key2 = await keyStore.get("alice.near")
+     * const key3 = await keyStore.get("alice.near")
+     * const key4 = await keyStore.get("alice.near") // Back to key1
+     * ```
+     */
+    async get(accountId) {
+        const accountKeys = this.keys.get(accountId);
+        if (!accountKeys || accountKeys.length === 0) {
+            return null;
+        }
+        // Get current counter and increment for next call
+        const counter = this.counters.get(accountId) ?? 0;
+        const key = accountKeys[counter % accountKeys.length];
+        this.counters.set(accountId, counter + 1);
+        // We know key exists because we checked accountKeys.length > 0 above
+        return key ?? null;
+    }
+    /**
+     * Add a key to an account's rotation pool.
+     *
+     * If the account already has keys, the new key is appended to the rotation.
+     * If this is the first key for the account, it becomes the starting key.
+     *
+     * @param accountId - NEAR account ID
+     * @param key - Key pair to add to rotation
+     * @param options - Optional metadata (preserved but not used for rotation)
+     *
+     * @example
+     * ```typescript
+     * await keyStore.add("alice.near", keyPair1)
+     * await keyStore.add("alice.near", keyPair2) // Now rotates between both
+     * ```
+     */
+    async add(accountId, key, _options) {
+        const existing = this.keys.get(accountId) ?? [];
+        existing.push(key);
+        this.keys.set(accountId, existing);
+    }
+    /**
+     * Remove all keys for an account from the rotation pool.
+     *
+     * This also resets the rotation counter for the account.
+     *
+     * @param accountId - NEAR account ID
+     *
+     * @example
+     * ```typescript
+     * await keyStore.remove("alice.near")
+     * ```
+     */
+    async remove(accountId) {
+        this.keys.delete(accountId);
+        this.counters.delete(accountId);
+    }
+    /**
+     * List all account IDs in the keystore.
+     *
+     * @returns Array of account IDs that have at least one key
+     *
+     * @example
+     * ```typescript
+     * const accounts = await keyStore.list()
+     * console.log(`Managing keys for: ${accounts.join(", ")}`)
+     * ```
+     */
+    async list() {
+        return Array.from(this.keys.keys());
+    }
+    /**
+     * Get all keys for an account (non-rotating).
+     *
+     * Returns all keys in the rotation pool without advancing the counter.
+     * Useful for inspecting or managing the key pool.
+     *
+     * @param accountId - NEAR account ID
+     * @returns Array of all key pairs for the account, or empty array if none exist
+     *
+     * @example
+     * ```typescript
+     * const keys = await keyStore.getAll("alice.near")
+     * console.log(`Account has ${keys.length} keys in rotation`)
+     * ```
+     */
+    async getAll(accountId) {
+        return this.keys.get(accountId) ?? [];
+    }
+    /**
+     * Get the current rotation index for an account.
+     *
+     * The index indicates which key will be returned on the next `get()` call.
+     *
+     * @param accountId - NEAR account ID
+     * @returns Current counter value (0-based index into key array)
+     *
+     * @example
+     * ```typescript
+     * const index = keyStore.getCurrentIndex("alice.near")
+     * const totalKeys = (await keyStore.getAll("alice.near")).length
+     * console.log(`Next key: ${index % totalKeys}`)
+     * ```
+     */
+    getCurrentIndex(accountId) {
+        return this.counters.get(accountId) ?? 0;
+    }
+    /**
+     * Reset the rotation counter for an account.
+     *
+     * The next `get()` call will return the first key in the rotation.
+     *
+     * @param accountId - NEAR account ID
+     *
+     * @example
+     * ```typescript
+     * keyStore.resetCounter("alice.near")
+     * const key = await keyStore.get("alice.near") // Returns first key
+     * ```
+     */
+    resetCounter(accountId) {
+        this.counters.set(accountId, 0);
+    }
+    /**
+     * Clear all keys and counters from the keystore.
+     *
+     * Useful for testing cleanup or resetting state.
+     *
+     * @example
+     * ```typescript
+     * keyStore.clear()
+     * ```
+     */
+    clear() {
+        this.keys.clear();
+        this.counters.clear();
+    }
+}
+//# sourceMappingURL=rotating-keystore.js.map

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

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

package/dist/sandbox/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Sandbox exports
+ */
+export type { SandboxOptions } from "./sandbox.js";
+export { Sandbox } from "./sandbox.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/sandbox/index.js

@@ -0,0 +1,5 @@
+/**
+ * Sandbox exports
+ */
+export { Sandbox } from "./sandbox.js";
+//# sourceMappingURL=index.js.map

package/dist/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/sandbox/sandbox.d.ts

@@ -0,0 +1,55 @@
+/**
+ * NEAR Sandbox - Local testing environment
+ *
+ * Simple, explicit API for running a local NEAR node for testing.
+ */
+export interface SandboxOptions {
+    version?: string;
+    /**
+     * Whether to spawn the sandbox process as detached.
+     * Default: true
+     * Set to false in test environments to prevent the process from being killed by test runners.
+     */
+    detached?: boolean;
+}
+/**
+ * NEAR Sandbox instance
+ *
+ * Manages a local NEAR node for testing. Automatically cleans up on stop().
+ *
+ * @example
+ * ```typescript
+ * const sandbox = await Sandbox.start();
+ * const near = new Near({ network: sandbox });
+ * // ... run tests
+ * await sandbox.stop();
+ * ```
+ */
+export declare class Sandbox {
+    readonly rpcUrl: string;
+    readonly networkId: string;
+    readonly rootAccount: {
+        id: string;
+        secretKey: string;
+    };
+    private process;
+    private homeDir;
+    private constructor();
+    /**
+     * Start a new sandbox instance
+     *
+     * Downloads the sandbox binary if needed, initializes a temporary directory,
+     * and starts the sandbox process.
+     *
+     * @param options - Optional configuration
+     * @returns Promise resolving to a running Sandbox instance
+     */
+    static start(options?: SandboxOptions): Promise<Sandbox>;
+    /**
+     * Stop the sandbox and clean up
+     *
+     * Kills the sandbox process and removes temporary files.
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/sandbox/sandbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAEvD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO;IAcP;;;;;;;;OAQG;WACU,KAAK,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAuDlE;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC5B"}

package/dist/sandbox/sandbox.js

@@ -0,0 +1,341 @@
+/**
+ * NEAR Sandbox - Local testing environment
+ *
+ * Simple, explicit API for running a local NEAR node for testing.
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import { mkdir, mkdtemp, readFile, rm } from "node:fs/promises";
+import { createServer } from "node:net";
+import os from "node:os";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import * as tar from "tar";
+const DEFAULT_VERSION = "2.9.0";
+const BINARY_NAME = "near-sandbox";
+const ARCHIVE_NAME = "near-sandbox.tar.gz";
+const DOWNLOAD_BASE = "https://s3-us-west-1.amazonaws.com/build.nearprotocol.com/nearcore";
+const STARTUP_TIMEOUT = 60000;
+const DOWNLOAD_TIMEOUT = 120000;
+/**
+ * NEAR Sandbox instance
+ *
+ * Manages a local NEAR node for testing. Automatically cleans up on stop().
+ *
+ * @example
+ * ```typescript
+ * const sandbox = await Sandbox.start();
+ * const near = new Near({ network: sandbox });
+ * // ... run tests
+ * await sandbox.stop();
+ * ```
+ */
+export class Sandbox {
+    constructor(rpcUrl, networkId, rootAccount, homeDir, childProcess) {
+        this.rpcUrl = rpcUrl;
+        this.networkId = networkId;
+        this.rootAccount = rootAccount;
+        this.homeDir = homeDir;
+        this.process = childProcess;
+    }
+    /**
+     * Start a new sandbox instance
+     *
+     * Downloads the sandbox binary if needed, initializes a temporary directory,
+     * and starts the sandbox process.
+     *
+     * @param options - Optional configuration
+     * @returns Promise resolving to a running Sandbox instance
+     */
+    static async start(options = {}) {
+        const version = options.version ?? DEFAULT_VERSION;
+        const detached = options.detached ?? true;
+        // 1. Ensure binary is available
+        const binaryPath = await ensureBinary(version);
+        // 2. Create temporary home directory
+        const homeDir = await mkdtemp(path.join(os.tmpdir(), "near-sandbox-"));
+        // 3. Initialize sandbox
+        await runInit(binaryPath, homeDir);
+        // 4. Read validator key
+        const validatorKey = await loadValidatorKey(homeDir);
+        const rootAccount = {
+            id: validatorKey.account_id,
+            secretKey: validatorKey.secret_key ?? validatorKey.private_key ?? "",
+        };
+        // 5. Start sandbox process
+        const port = await findAvailablePort();
+        const networkPort = port + 1;
+        const childProcess = spawn(binaryPath, [
+            "--home",
+            homeDir,
+            "run",
+            "--rpc-addr",
+            `0.0.0.0:${port}`,
+            "--network-addr",
+            `0.0.0.0:${networkPort}`,
+        ], {
+            detached,
+            stdio: detached ? "ignore" : "pipe",
+        });
+        if (!childProcess.pid) {
+            throw new Error("Failed to start sandbox: no PID");
+        }
+        if (detached) {
+            childProcess.unref();
+        }
+        const rpcUrl = `http://127.0.0.1:${port}`;
+        // 6. Wait for RPC to be ready
+        await waitForReady(rpcUrl);
+        return new Sandbox(rpcUrl, "localnet", rootAccount, homeDir, childProcess);
+    }
+    /**
+     * Stop the sandbox and clean up
+     *
+     * Kills the sandbox process and removes temporary files.
+     */
+    async stop() {
+        if (this.process?.pid) {
+            const pid = this.process.pid;
+            try {
+                // Try to kill process group first (for detached processes)
+                process.kill(-pid, "SIGTERM");
+                await sleep(100);
+            }
+            catch {
+                // Try direct kill
+                try {
+                    process.kill(pid, "SIGTERM");
+                    await sleep(100);
+                }
+                catch {
+                    // Try SIGKILL as last resort
+                    try {
+                        process.kill(pid, "SIGKILL");
+                    }
+                    catch {
+                        // Process already dead
+                    }
+                }
+            }
+            this.process = undefined;
+        }
+        // Clean up temporary directory
+        try {
+            await rm(this.homeDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+// ==================== Helper Functions ====================
+/**
+ * Get platform identifier for downloading correct binary.
+ * @internal
+ */
+function getPlatformId() {
+    const system = os.platform();
+    const arch = os.arch();
+    const platform = system === "darwin" ? "Darwin" : "Linux";
+    const normalizedArch = arch === "x64" ? "x86_64" : arch;
+    if (!["x86_64", "arm64"].includes(normalizedArch)) {
+        throw new Error(`Unsupported architecture: ${arch}`);
+    }
+    if (system !== "darwin" && system !== "linux") {
+        throw new Error(`Unsupported platform: ${system}`);
+    }
+    return { system: platform, arch: normalizedArch };
+}
+/**
+ * Get directory for storing sandbox binaries.
+ * @internal
+ */
+function getBinaryDir() {
+    const dir = path.join(os.homedir(), ".near-kit", "sandbox", "bin");
+    return dir;
+}
+/**
+ * Download and extract sandbox binary.
+ * @internal
+ */
+async function downloadBinary(version) {
+    const { system, arch } = getPlatformId();
+    const destDir = getBinaryDir();
+    const filename = `${BINARY_NAME}-${version}`;
+    const dest = path.join(destDir, filename);
+    // Return if already exists
+    if (fs.existsSync(dest)) {
+        return dest;
+    }
+    const url = `${DOWNLOAD_BASE}/${system}-${arch}/${version}/${ARCHIVE_NAME}`;
+    const tmpDir = await mkdtemp(path.join(os.tmpdir(), "near-sandbox-download-"));
+    try {
+        const archivePath = path.join(tmpDir, ARCHIVE_NAME);
+        // Download with timeout
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), DOWNLOAD_TIMEOUT);
+        try {
+            const response = await fetch(url, { signal: controller.signal });
+            if (!response.ok) {
+                throw new Error(`Download failed: ${response.status} ${response.statusText}`);
+            }
+            if (!response.body) {
+                throw new Error("Response body is null");
+            }
+            const stream = fs.createWriteStream(archivePath);
+            // Convert DOM ReadableStream to Node.js ReadableStream
+            await pipeline(Readable.fromWeb(response.body), stream);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        // Extract archive (strip=1 removes top-level directory)
+        await tar.x({ file: archivePath, cwd: tmpDir, strip: 1 });
+        const extracted = path.join(tmpDir, BINARY_NAME);
+        if (!fs.existsSync(extracted)) {
+            throw new Error(`Binary ${BINARY_NAME} not found in archive`);
+        }
+        // Move to final location and make executable
+        await mkdir(path.dirname(dest), { recursive: true });
+        await fs.promises.rename(extracted, dest);
+        await fs.promises.chmod(dest, 0o755);
+        return dest;
+    }
+    catch (error) {
+        throw new Error(`Failed to download binary from ${url}: ${error}`);
+    }
+    finally {
+        await rm(tmpDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Ensure binary is available and return its path.
+ * @internal
+ */
+async function ensureBinary(version) {
+    return await downloadBinary(version);
+}
+/**
+ * Run sandbox init command.
+ * @internal
+ */
+async function runInit(binaryPath, homeDir) {
+    const args = ["--home", homeDir, "init", "--chain-id", "localnet"];
+    return new Promise((resolve, reject) => {
+        const child = spawn(binaryPath, args, { stdio: "pipe" });
+        let stderr = "";
+        child.stderr?.on("data", (data) => {
+            stderr += data.toString();
+        });
+        child.on("exit", (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                // Provide helpful error message for common issues
+                let errorMsg = `Sandbox init failed with code ${code}: ${stderr}`;
+                if (stderr.includes("file descriptor limit")) {
+                    errorMsg +=
+                        "\n\n" +
+                            "The sandbox requires at least 65,535 file descriptors.\n" +
+                            "Current limit can be checked with: ulimit -n\n\n" +
+                            "To fix on Linux, add to /etc/security/limits.conf:\n" +
+                            "  * soft nofile 65535\n" +
+                            "  * hard nofile 65535\n\n" +
+                            "To fix on macOS:\n" +
+                            "  sudo launchctl limit maxfiles 65536 200000\n\n" +
+                            "For Docker, add: --ulimit nofile=65535:65535\n\n" +
+                            "See: https://github.com/r-near/near-kit/blob/main/src/sandbox/README.md";
+                }
+                reject(new Error(errorMsg));
+            }
+        });
+        child.on("error", reject);
+    });
+}
+/**
+ * Load validator key from sandbox home directory.
+ * @internal
+ */
+async function loadValidatorKey(homeDir) {
+    const keyPath = path.join(homeDir, "validator_key.json");
+    try {
+        const data = await readFile(keyPath, "utf8");
+        return JSON.parse(data);
+    }
+    catch (error) {
+        throw new Error(`Failed to read validator key from ${keyPath}: ${error}`);
+    }
+}
+/**
+ * Find an available port by letting the OS choose.
+ * @internal
+ */
+async function findAvailablePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.on("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                reject(new Error("Failed to get port"));
+                return;
+            }
+            const port = address.port;
+            server.close(() => {
+                resolve(port);
+            });
+        });
+    });
+}
+/**
+ * Ping sandbox RPC endpoint to check if it's ready.
+ * @internal
+ */
+async function pingRpc(url, timeoutMs = 1000) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: "status",
+                method: "status",
+                params: [],
+            }),
+            signal: controller.signal,
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Wait for sandbox to be ready.
+ * @internal
+ */
+async function waitForReady(rpcUrl, timeout = STARTUP_TIMEOUT) {
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        if (await pingRpc(rpcUrl)) {
+            return;
+        }
+        await sleep(500);
+    }
+    throw new Error(`Sandbox failed to start within ${timeout}ms`);
+}
+/**
+ * Sleep helper.
+ * @internal
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox/sandbox.js.map

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