near-kit 0.0.0 → 0.2.0

package/dist/errors/index.js

@@ -0,0 +1,366 @@
+/**
+ * Error classes for the NEAR client library.
+ *
+ * @remarks
+ * All errors in this module extend {@link NearError}, which carries a stable
+ * `code` string and optional `data` field. Many errors also expose a
+ * `retryable` flag to indicate whether the operation is safe to retry.
+ */
+/**
+ * Base error class for all NEAR-related errors.
+ *
+ * Provides a stable `code` and optional `data` payload for structured error
+ * handling. Concrete error subclasses in this module narrow down specific
+ * failure scenarios (network issues, contract panics, invalid transactions, etc.).
+ */
+export class NearError extends Error {
+    constructor(message, code, data) {
+        super(message);
+        this.name = "NearError";
+        this.code = code;
+        this.data = data;
+        Object.setPrototypeOf(this, NearError.prototype);
+    }
+}
+/**
+ * Thrown when an account has insufficient balance for an operation
+ */
+export class InsufficientBalanceError extends NearError {
+    constructor(required, available) {
+        super(`Insufficient balance: required ${required} NEAR, available ${available} NEAR`, "INSUFFICIENT_BALANCE");
+        this.name = "InsufficientBalanceError";
+        this.required = required;
+        this.available = available;
+        Object.setPrototypeOf(this, InsufficientBalanceError.prototype);
+    }
+}
+/**
+ * Thrown when a contract function call fails
+ */
+export class FunctionCallError extends NearError {
+    constructor(contractId, methodName, panic, logs = []) {
+        const methodPart = methodName ? `.${methodName}` : "";
+        const message = panic
+            ? `Contract call failed: ${contractId}${methodPart} - ${panic}`
+            : `Contract call failed: ${contractId}${methodPart}`;
+        super(message, "FUNCTION_CALL_ERROR");
+        this.name = "FunctionCallError";
+        this.contractId = contractId;
+        if (methodName !== undefined) {
+            this.methodName = methodName;
+        }
+        this.logs = logs;
+        if (panic !== undefined) {
+            this.panic = panic;
+        }
+        Object.setPrototypeOf(this, FunctionCallError.prototype);
+    }
+}
+/**
+ * Thrown when a network request fails
+ */
+export class NetworkError extends NearError {
+    constructor(message, statusCode, retryable = true) {
+        super(message, "NETWORK_ERROR", { statusCode });
+        this.name = "NetworkError";
+        if (statusCode !== undefined) {
+            this.statusCode = statusCode;
+        }
+        this.retryable = retryable;
+        Object.setPrototypeOf(this, NetworkError.prototype);
+    }
+}
+/**
+ * Thrown when a key is invalid or malformed
+ */
+export class InvalidKeyError extends NearError {
+    constructor(message) {
+        super(message, "INVALID_KEY");
+        this.name = "InvalidKeyError";
+        Object.setPrototypeOf(this, InvalidKeyError.prototype);
+    }
+}
+/**
+ * Thrown when an account does not exist
+ */
+export class AccountDoesNotExistError extends NearError {
+    constructor(accountId) {
+        super(`Account does not exist: ${accountId}`, "ACCOUNT_NOT_FOUND");
+        this.name = "AccountDoesNotExistError";
+        this.accountId = accountId;
+        Object.setPrototypeOf(this, AccountDoesNotExistError.prototype);
+    }
+}
+/**
+ * Thrown when an access key does not exist
+ */
+export class AccessKeyDoesNotExistError extends NearError {
+    constructor(accountId, publicKey) {
+        super(`Access key does not exist: ${publicKey} for account ${accountId}`, "ACCESS_KEY_NOT_FOUND");
+        this.name = "AccessKeyDoesNotExistError";
+        this.accountId = accountId;
+        this.publicKey = publicKey;
+        Object.setPrototypeOf(this, AccessKeyDoesNotExistError.prototype);
+    }
+}
+/**
+ * Thrown when an account ID is invalid
+ */
+export class InvalidAccountIdError extends NearError {
+    constructor(accountId, reason) {
+        const message = reason
+            ? `Invalid account ID: ${accountId} - ${reason}`
+            : `Invalid account ID: ${accountId}`;
+        super(message, "INVALID_ACCOUNT_ID");
+        this.name = "InvalidAccountIdError";
+        this.accountId = accountId;
+        Object.setPrototypeOf(this, InvalidAccountIdError.prototype);
+    }
+}
+/**
+ * Thrown when transaction signing fails
+ */
+export class SignatureError extends NearError {
+    constructor(message) {
+        super(message, "SIGNATURE_ERROR");
+        this.name = "SignatureError";
+        Object.setPrototypeOf(this, SignatureError.prototype);
+    }
+}
+/**
+ * Thrown when gas limit is exceeded
+ */
+export class GasLimitExceededError extends NearError {
+    constructor(gasUsed, gasLimit) {
+        super(`Gas limit exceeded: used ${gasUsed}, limit ${gasLimit}`, "GAS_LIMIT_EXCEEDED");
+        this.name = "GasLimitExceededError";
+        this.gasUsed = gasUsed;
+        this.gasLimit = gasLimit;
+        Object.setPrototypeOf(this, GasLimitExceededError.prototype);
+    }
+}
+/**
+ * Thrown when a transaction times out
+ */
+export class TransactionTimeoutError extends NearError {
+    constructor(transactionHash) {
+        super(`Transaction timed out: ${transactionHash}`, "TRANSACTION_TIMEOUT");
+        this.name = "TransactionTimeoutError";
+        this.transactionHash = transactionHash;
+        Object.setPrototypeOf(this, TransactionTimeoutError.prototype);
+    }
+}
+/**
+ * Thrown when wallet operations fail
+ */
+export class WalletError extends NearError {
+    constructor(message) {
+        super(message, "WALLET_ERROR");
+        this.name = "WalletError";
+        Object.setPrototypeOf(this, WalletError.prototype);
+    }
+}
+/**
+ * Thrown when a requested block cannot be found
+ * Suggests using an archival node for old blocks
+ */
+export class UnknownBlockError extends NearError {
+    constructor(blockReference) {
+        super(`Block not found: ${blockReference}. It may have been garbage-collected. Try an archival node for blocks older than 5 epochs.`, "UNKNOWN_BLOCK");
+        this.name = "UnknownBlockError";
+        this.blockReference = blockReference;
+        Object.setPrototypeOf(this, UnknownBlockError.prototype);
+    }
+}
+/**
+ * Thrown when account ID format is invalid
+ */
+export class InvalidAccountError extends NearError {
+    constructor(accountId) {
+        super(`Invalid account ID format: ${accountId}`, "INVALID_ACCOUNT");
+        this.name = "InvalidAccountError";
+        this.accountId = accountId;
+        Object.setPrototypeOf(this, InvalidAccountError.prototype);
+    }
+}
+/**
+ * Thrown when the requested shard is not available on this node
+ */
+export class ShardUnavailableError extends NearError {
+    constructor(message) {
+        super(message ||
+            "The requested shard is not tracked by this node. Try a different node.", "UNAVAILABLE_SHARD");
+        this.retryable = true;
+        this.name = "ShardUnavailableError";
+        Object.setPrototypeOf(this, ShardUnavailableError.prototype);
+    }
+}
+/**
+ * Thrown when the node is still syncing
+ */
+export class NodeNotSyncedError extends NearError {
+    constructor(message) {
+        super(message ||
+            "Node is still syncing. Wait for sync to complete or try a different node.", "NOT_SYNCED");
+        this.retryable = true;
+        this.name = "NodeNotSyncedError";
+        Object.setPrototypeOf(this, NodeNotSyncedError.prototype);
+    }
+}
+/**
+ * Thrown when an account has no contract deployed
+ */
+export class ContractNotDeployedError extends NearError {
+    constructor(accountId) {
+        super(`No contract deployed on account: ${accountId}`, "NO_CONTRACT_CODE");
+        this.name = "ContractNotDeployedError";
+        this.accountId = accountId;
+        Object.setPrototypeOf(this, ContractNotDeployedError.prototype);
+    }
+}
+/**
+ * Thrown when contract state is too large to return
+ */
+export class ContractStateTooLargeError extends NearError {
+    constructor(accountId) {
+        super(`Contract state too large (>50kb) for account ${accountId}. Try a node with larger limits.`, "TOO_LARGE_CONTRACT_STATE");
+        this.name = "ContractStateTooLargeError";
+        this.accountId = accountId;
+        Object.setPrototypeOf(this, ContractStateTooLargeError.prototype);
+    }
+}
+/**
+ * Thrown when a view function call execution fails
+ */
+export class ContractExecutionError extends NearError {
+    constructor(contractId, methodName, details) {
+        const message = methodName
+            ? `Contract execution failed: ${contractId}.${methodName}`
+            : `Contract execution failed: ${contractId}`;
+        super(message, "CONTRACT_EXECUTION_ERROR", details);
+        this.name = "ContractExecutionError";
+        this.contractId = contractId;
+        if (methodName !== undefined) {
+            this.methodName = methodName;
+        }
+        if (details !== undefined) {
+            this.details = details;
+        }
+        Object.setPrototypeOf(this, ContractExecutionError.prototype);
+    }
+}
+/**
+ * Thrown when a chunk cannot be found
+ */
+export class UnknownChunkError extends NearError {
+    constructor(chunkReference) {
+        super(`Chunk not found: ${chunkReference}. It may have been garbage-collected. Try an archival node.`, "UNKNOWN_CHUNK");
+        this.name = "UnknownChunkError";
+        this.chunkReference = chunkReference;
+        Object.setPrototypeOf(this, UnknownChunkError.prototype);
+    }
+}
+/**
+ * Thrown when an invalid shard ID is provided
+ */
+export class InvalidShardIdError extends NearError {
+    constructor(shardId) {
+        super(`Invalid shard ID: ${shardId}. Provide a valid shard ID within the network's range.`, "INVALID_SHARD_ID");
+        this.name = "InvalidShardIdError";
+        this.shardId = shardId;
+        Object.setPrototypeOf(this, InvalidShardIdError.prototype);
+    }
+}
+/**
+ * Thrown when an epoch cannot be found
+ */
+export class UnknownEpochError extends NearError {
+    constructor(blockReference) {
+        super(`Epoch not found for block: ${blockReference}. The block may be invalid or too old. Try an archival node.`, "UNKNOWN_EPOCH");
+        this.name = "UnknownEpochError";
+        this.blockReference = blockReference;
+        Object.setPrototypeOf(this, UnknownEpochError.prototype);
+    }
+}
+/**
+ * Thrown when transaction nonce is invalid
+ * This happens when a transaction uses a nonce that has already been used
+ */
+export class InvalidNonceError extends NearError {
+    constructor(txNonce, akNonce) {
+        super(`Invalid transaction nonce: transaction nonce ${txNonce} must be greater than access key nonce ${akNonce}`, "INVALID_NONCE");
+        this.retryable = true; // Can retry with updated nonce
+        this.name = "InvalidNonceError";
+        this.txNonce = txNonce;
+        this.akNonce = akNonce;
+        Object.setPrototypeOf(this, InvalidNonceError.prototype);
+    }
+}
+/**
+ * Thrown when a transaction is invalid
+ * Check details for specific reasons like ShardCongested or ShardStuck
+ */
+export class InvalidTransactionError extends NearError {
+    constructor(message, details) {
+        super(message, "INVALID_TRANSACTION", details);
+        this.name = "InvalidTransactionError";
+        this.details = details;
+        // Check if this is a retryable transaction error
+        const detailsObj = details;
+        this.shardCongested = !!detailsObj?.ShardCongested;
+        this.shardStuck = !!detailsObj?.ShardStuck;
+        this.retryable = this.shardCongested || this.shardStuck;
+        Object.setPrototypeOf(this, InvalidTransactionError.prototype);
+    }
+}
+/**
+ * Thrown when a receipt cannot be found
+ */
+export class UnknownReceiptError extends NearError {
+    constructor(receiptId) {
+        super(`Receipt not found: ${receiptId}. It may not have been observed on this node.`, "UNKNOWN_RECEIPT");
+        this.name = "UnknownReceiptError";
+        this.receiptId = receiptId;
+        Object.setPrototypeOf(this, UnknownReceiptError.prototype);
+    }
+}
+/**
+ * Thrown when request parameters cannot be parsed
+ */
+export class ParseError extends NearError {
+    constructor(message, details) {
+        super(`Request validation failed: ${message}. Check that all parameters are valid.`, "PARSE_ERROR", details);
+        this.name = "ParseError";
+        Object.setPrototypeOf(this, ParseError.prototype);
+    }
+}
+/**
+ * Thrown when a request times out (408)
+ * This is always retryable - resubmit the identical transaction
+ */
+export class TimeoutError extends NearError {
+    constructor(message, transactionHash) {
+        super(message ||
+            "Request timed out. The transaction may still be processed. Resubmit the identical transaction.", "TIMEOUT_ERROR");
+        this.retryable = true;
+        this.name = "TimeoutError";
+        if (transactionHash !== undefined) {
+            this.transactionHash = transactionHash;
+        }
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+/**
+ * Thrown when the RPC server encounters an internal error (500)
+ * This is always retryable
+ */
+export class InternalServerError extends NearError {
+    constructor(message, details) {
+        super(message ||
+            "Internal server error. The node may be overloaded. Try again or use a different node.", "INTERNAL_ERROR", details);
+        this.retryable = true;
+        this.name = "InternalServerError";
+        Object.setPrototypeOf(this, InternalServerError.prototype);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * near-kit - A simple, intuitive TypeScript library for interacting with NEAR Protocol
+ */
+export type { Contract, ContractMethods } from "./contracts/contract.js";
+export { DelegateAction, SignedDelegate, } from "./core/actions.js";
+export { Near } from "./core/near.js";
+export { DELEGATE_ACTION_PREFIX, type SignedDelegateAction, serializeDelegateAction, serializeSignedDelegate, } from "./core/schema.js";
+export { TransactionBuilder } from "./core/transaction.js";
+export type { CallOptions, FinalExecutionOutcome, KeyConfig, KeyPair, KeyStore, NearConfig, NetworkConfig, PublicKey, SendOptions, Signature, SignedMessage, SignMessageParams, TxExecutionStatus, WalletAccount, WalletConnection, WalletSignInOptions, } from "./core/types.js";
+export { AccessKeyDoesNotExistError, AccountDoesNotExistError, FunctionCallError, GasLimitExceededError, InsufficientBalanceError, InvalidAccountIdError, InvalidKeyError, NearError, NetworkError, SignatureError, TransactionTimeoutError, WalletError, } from "./errors/index.js";
+export type { LegacyCredential, NearCliCredential, Network, } from "./keys/index.js";
+export { InMemoryKeyStore, RotatingKeyStore, } from "./keys/index.js";
+export type { SandboxOptions } from "./sandbox/index.js";
+export { Amount, formatAmount, formatGas, Gas, generateKey, generateNep413Nonce, generateSeedPhrase, isPrivateKey, isValidAccountId, isValidPublicKey, type PrivateKey, parseAmount, parseGas, parseKey, parseSeedPhrase, validatePrivateKey, verifyNep413Signature, } from "./utils/index.js";
+export { fromHotConnect, fromWalletSelector } from "./wallets/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAExE,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE1D,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAU,EACV,aAAa,EACb,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,GACR,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAKjB,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,OAAO,EACL,MAAM,EACN,YAAY,EACZ,SAAS,EACT,GAAG,EACH,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,UAAU,EACf,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * near-kit - A simple, intuitive TypeScript library for interacting with NEAR Protocol
+ */
+// Delegate actions
+export { DelegateAction, SignedDelegate, } from "./core/actions.js";
+// Main class
+export { Near } from "./core/near.js";
+export { DELEGATE_ACTION_PREFIX, serializeDelegateAction, serializeSignedDelegate, } from "./core/schema.js";
+export { TransactionBuilder } from "./core/transaction.js";
+// Errors
+export { AccessKeyDoesNotExistError, AccountDoesNotExistError, FunctionCallError, GasLimitExceededError, InsufficientBalanceError, InvalidAccountIdError, InvalidKeyError, NearError, NetworkError, SignatureError, TransactionTimeoutError, WalletError, } from "./errors/index.js";
+// Key stores
+export { InMemoryKeyStore, RotatingKeyStore,
+// Node.js-only keystores not exported by default (browser environments don't support them)
+// For Node.js/Bun:
+//   import { FileKeyStore } from "near-kit/keys/file"
+//   import { NativeKeyStore } from "near-kit/keys/native"
+ } from "./keys/index.js";
+// Utilities
+export { Amount, formatAmount, formatGas, Gas, generateKey, generateNep413Nonce, generateSeedPhrase, isPrivateKey, isValidAccountId, isValidPublicKey, parseAmount, parseGas, parseKey, parseSeedPhrase, validatePrivateKey, verifyNep413Signature, } from "./utils/index.js";
+// Wallet adapters
+export { fromHotConnect, fromWalletSelector } from "./wallets/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACrC,OAAO,EACL,sBAAsB,EAEtB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAoB1D,SAAS;AACT,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAO1B,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,gBAAgB;AAChB,2FAA2F;AAC3F,mBAAmB;AACnB,sDAAsD;AACtD,0DAA0D;EAC3D,MAAM,iBAAiB,CAAA;AAIxB,YAAY;AACZ,OAAO,EACL,MAAM,EACN,YAAY,EACZ,SAAS,EACT,GAAG,EACH,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAEhB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AACzB,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/keys/credential-schemas.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Zod schemas for NEAR CLI credential file formats
+ *
+ * NEAR CLI stores credentials in `~/.near-credentials/` with the following structure:
+ *
+ * ## Directory Structure
+ * ```
+ * ~/.near-credentials/
+ *   ├── mainnet/
+ *   │   ├── account.near.json              # Single key per account
+ *   │   └── account.near/                   # Multiple keys per account
+ *   │       └── ed25519_PublicKeyBase58.json
+ *   ├── testnet/
+ *   │   └── account.testnet.json
+ *   └── implicit/
+ *       └── accountId.json
+ * ```
+ *
+ * ## File Format
+ * Each credential file contains:
+ * - `account_id` (optional): Named account ID
+ * - `public_key`: Public key in format "ed25519:Base58EncodedKey"
+ * - `private_key`: Private key in format "ed25519:Base58EncodedKey"
+ * - `seed_phrase_hd_path` (optional): BIP32 derivation path (e.g., "m/44'/397'/0'")
+ * - `master_seed_phrase` (optional): BIP39 seed phrase
+ * - `implicit_account_id` (optional): Implicit account ID (hex of public key)
+ *
+ * @see https://github.com/near/near-cli
+ */
+import { z } from "zod";
+/**
+ * Schema for NEAR CLI credential file
+ *
+ * This matches the format used by near-cli and near-cli-rs for storing
+ * account credentials on the filesystem.
+ *
+ * @example
+ * ```json
+ * {
+ *   "account_id": "example.testnet",
+ *   "public_key": "ed25519:8nFkHgRePSGD9UsK3Hx6234567890abcdefghijklmnop",
+ *   "private_key": "ed25519:3D4c2v8K5x...",
+ *   "seed_phrase_hd_path": "m/44'/397'/0'",
+ *   "master_seed_phrase": "word1 word2 word3 ...",
+ *   "implicit_account_id": "1234567890abcdef..."
+ * }
+ * ```
+ */
+export declare const NearCliCredentialSchema: z.ZodObject<{
+    account_id: z.ZodOptional<z.ZodString>;
+    public_key: z.ZodString;
+    private_key: z.ZodString;
+    seed_phrase_hd_path: z.ZodOptional<z.ZodString>;
+    master_seed_phrase: z.ZodOptional<z.ZodString>;
+    implicit_account_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * TypeScript type for NEAR CLI credential
+ */
+export type NearCliCredential = z.infer<typeof NearCliCredentialSchema>;
+/**
+ * Legacy format used by some tools (uses "secret_key" instead of "private_key")
+ * This is supported for reading only, not writing
+ */
+export declare const LegacyCredentialSchema: z.ZodObject<{
+    account_id: z.ZodOptional<z.ZodString>;
+    public_key: z.ZodString;
+    secret_key: z.ZodString;
+    seed_phrase_hd_path: z.ZodOptional<z.ZodString>;
+    master_seed_phrase: z.ZodOptional<z.ZodString>;
+    implicit_account_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * TypeScript type for legacy credential format
+ */
+export type LegacyCredential = z.infer<typeof LegacyCredentialSchema>;
+/**
+ * Network identifiers supported by NEAR
+ */
+export declare const NetworkSchema: z.ZodEnum<{
+    mainnet: "mainnet";
+    testnet: "testnet";
+    localnet: "localnet";
+    betanet: "betanet";
+}>;
+/**
+ * TypeScript type for network identifier
+ */
+export type Network = z.infer<typeof NetworkSchema>;
+/**
+ * Parse a credential file, supporting both modern and legacy formats
+ *
+ * @param data - Raw JSON data from credential file
+ * @returns Parsed credential with normalized field names
+ * @throws {z.ZodError} If the data doesn't match any supported format
+ */
+export declare function parseCredentialFile(data: unknown): NearCliCredential;
+//# sourceMappingURL=credential-schemas.d.ts.map

package/dist/keys/credential-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-schemas.d.ts","sourceRoot":"","sources":["../../src/keys/credential-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,uBAAuB;;;;;;;iBAoClC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;iBAOjC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;EAKxB,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEnD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAoBpE"}

package/dist/keys/credential-schemas.js

@@ -0,0 +1,128 @@
+/**
+ * Zod schemas for NEAR CLI credential file formats
+ *
+ * NEAR CLI stores credentials in `~/.near-credentials/` with the following structure:
+ *
+ * ## Directory Structure
+ * ```
+ * ~/.near-credentials/
+ *   ├── mainnet/
+ *   │   ├── account.near.json              # Single key per account
+ *   │   └── account.near/                   # Multiple keys per account
+ *   │       └── ed25519_PublicKeyBase58.json
+ *   ├── testnet/
+ *   │   └── account.testnet.json
+ *   └── implicit/
+ *       └── accountId.json
+ * ```
+ *
+ * ## File Format
+ * Each credential file contains:
+ * - `account_id` (optional): Named account ID
+ * - `public_key`: Public key in format "ed25519:Base58EncodedKey"
+ * - `private_key`: Private key in format "ed25519:Base58EncodedKey"
+ * - `seed_phrase_hd_path` (optional): BIP32 derivation path (e.g., "m/44'/397'/0'")
+ * - `master_seed_phrase` (optional): BIP39 seed phrase
+ * - `implicit_account_id` (optional): Implicit account ID (hex of public key)
+ *
+ * @see https://github.com/near/near-cli
+ */
+import { z } from "zod";
+/**
+ * Schema for NEAR CLI credential file
+ *
+ * This matches the format used by near-cli and near-cli-rs for storing
+ * account credentials on the filesystem.
+ *
+ * @example
+ * ```json
+ * {
+ *   "account_id": "example.testnet",
+ *   "public_key": "ed25519:8nFkHgRePSGD9UsK3Hx6234567890abcdefghijklmnop",
+ *   "private_key": "ed25519:3D4c2v8K5x...",
+ *   "seed_phrase_hd_path": "m/44'/397'/0'",
+ *   "master_seed_phrase": "word1 word2 word3 ...",
+ *   "implicit_account_id": "1234567890abcdef..."
+ * }
+ * ```
+ */
+export const NearCliCredentialSchema = z.object({
+    /**
+     * Named account ID (optional)
+     * @example "example.testnet"
+     */
+    account_id: z.string().optional(),
+    /**
+     * Public key in NEAR format
+     * @example "ed25519:8nFkHgRePSGD9UsK3Hx6nWKXGQ7Kd7k3k7k3k7k3k7k3"
+     */
+    public_key: z.string(),
+    /**
+     * Private key in NEAR format (note: uses "private_key", not "secret_key")
+     * @example "ed25519:3D4c2v8K5x..."
+     */
+    private_key: z.string(),
+    /**
+     * BIP32 derivation path (optional)
+     * @example "m/44'/397'/0'"
+     */
+    seed_phrase_hd_path: z.string().optional(),
+    /**
+     * BIP39 seed phrase (optional)
+     * @example "witch collapse practice feed shame open despair creek road again ice least"
+     */
+    master_seed_phrase: z.string().optional(),
+    /**
+     * Implicit account ID (optional) - hex representation of the public key
+     * @example "e3cb032dbb6e8f45239c79652ba94172378f940d340b429ce5076d1a2f7366e2"
+     */
+    implicit_account_id: z.string().optional(),
+});
+/**
+ * Legacy format used by some tools (uses "secret_key" instead of "private_key")
+ * This is supported for reading only, not writing
+ */
+export const LegacyCredentialSchema = z.object({
+    account_id: z.string().optional(),
+    public_key: z.string(),
+    secret_key: z.string(), // Legacy field name
+    seed_phrase_hd_path: z.string().optional(),
+    master_seed_phrase: z.string().optional(),
+    implicit_account_id: z.string().optional(),
+});
+/**
+ * Network identifiers supported by NEAR
+ */
+export const NetworkSchema = z.enum([
+    "mainnet",
+    "testnet",
+    "betanet",
+    "localnet",
+]);
+/**
+ * Parse a credential file, supporting both modern and legacy formats
+ *
+ * @param data - Raw JSON data from credential file
+ * @returns Parsed credential with normalized field names
+ * @throws {z.ZodError} If the data doesn't match any supported format
+ */
+export function parseCredentialFile(data) {
+    // Try modern format first
+    const modernResult = NearCliCredentialSchema.safeParse(data);
+    if (modernResult.success) {
+        return modernResult.data;
+    }
+    // Try legacy format
+    const legacyResult = LegacyCredentialSchema.safeParse(data);
+    if (legacyResult.success) {
+        // Convert legacy format to modern format
+        const { secret_key, ...rest } = legacyResult.data;
+        return {
+            ...rest,
+            private_key: secret_key,
+        };
+    }
+    // Neither format matched, throw the modern format error
+    throw modernResult.error;
+}
+//# sourceMappingURL=credential-schemas.js.map

package/dist/keys/credential-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-schemas.js","sourceRoot":"","sources":["../../src/keys/credential-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IAEtB;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IAEvB;;;OAGG;IACH,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE1C;;;OAGG;IACH,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEzC;;;OAGG;IACH,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAA;AAOF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,oBAAoB;IAC5C,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAA;AAOF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAClC,SAAS;IACT,SAAS;IACT,SAAS;IACT,UAAU;CACX,CAAC,CAAA;AAOF;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,0BAA0B;IAC1B,MAAM,YAAY,GAAG,uBAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5D,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,oBAAoB;IACpB,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAC3D,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QACzB,yCAAyC;QACzC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,CAAC,IAAI,CAAA;QACjD,OAAO;YACL,GAAG,IAAI;YACP,WAAW,EAAE,UAAU;SACxB,CAAA;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,YAAY,CAAC,KAAK,CAAA;AAC1B,CAAC"}