near-kit 0.0.0 → 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Core type definitions for the NEAR client library
+ */
+export type { CustomNetworkConfig, NetworkConfig, NetworkPreset, } from "./config-schemas.js";
+export type NetworkId = "mainnet" | "testnet" | "localnet";
+export type KeyConfig = string | {
+    type: "ed25519";
+    key: string;
+} | {
+    type: "secp256k1";
+    key: string;
+} | {
+    type: "seed";
+    phrase: string;
+    path?: string;
+} | {
+    type: "ledger";
+    path?: string;
+} | {
+    type: "private-key";
+    key: Uint8Array;
+};
+export interface KeyPair {
+    publicKey: PublicKey;
+    secretKey: string;
+    sign(message: Uint8Array): Signature;
+    signNep413Message?(accountId: string, params: SignMessageParams): SignedMessage;
+}
+export declare enum KeyType {
+    ED25519 = 0,
+    SECP256K1 = 1
+}
+export interface PublicKey {
+    keyType: KeyType;
+    data: Uint8Array;
+    toString(): string;
+}
+export interface Ed25519PublicKey extends PublicKey {
+    keyType: KeyType.ED25519;
+}
+export interface Secp256k1PublicKey extends PublicKey {
+    keyType: KeyType.SECP256K1;
+}
+export interface Signature {
+    keyType: KeyType;
+    data: Uint8Array;
+}
+export interface Ed25519Signature extends Signature {
+    keyType: KeyType.ED25519;
+}
+export interface Secp256k1Signature extends Signature {
+    keyType: KeyType.SECP256K1;
+}
+/**
+ * Custom signing function for transactions.
+ *
+ * A Signer is an async function that takes a message (the SHA-256 hash of a
+ * serialized transaction) and returns a cryptographic signature. Use custom
+ * signers to integrate with:
+ *
+ * - Hardware wallets (Ledger, Trezor)
+ * - Key Management Systems (AWS KMS, HashiCorp Vault)
+ * - Multi-signature schemes
+ * - Custom key derivation logic
+ *
+ * @param message - SHA-256 hash of the serialized transaction (32 bytes)
+ * @returns Promise resolving to a signature with key type info
+ *
+ * @example
+ * ```typescript
+ * // Hardware wallet signer
+ * const hwSigner: Signer = async (message) => {
+ *   const sig = await ledger.signTransaction(message)
+ *   return {
+ *     keyType: KeyType.ED25519,
+ *     data: sig
+ *   }
+ * }
+ *
+ * const near = new Near({
+ *   network: 'testnet',
+ *   signer: hwSigner
+ * })
+ *
+ * // All transactions now use hardware wallet
+ * await near.transaction('alice.near').transfer('bob.near', '1').send()
+ * ```
+ *
+ * @see {@link NearConfig.signer} for configuration
+ * @see {@link TransactionBuilder.signWith} to override per-transaction
+ */
+export type Signer = (message: Uint8Array) => Promise<Signature>;
+/**
+ * Function call permission details from RPC
+ *
+ * Fields:
+ * - receiver_id: Account ID that can be called
+ * - method_names: List of method names that can be called (empty array means any)
+ * - allowance: Optional allowance in yoctoNEAR
+ */
+export type { AccessKeyPermission, FunctionCallPermissionDetails, } from "./rpc/rpc-schemas.js";
+import type { Action } from "./schema.js";
+export type { Action };
+/**
+ * Transaction execution status levels for wait_until parameter.
+ *
+ * Determines when the RPC should return a response after submitting a transaction:
+ *
+ * - **NONE**: Don't wait - returns immediately after basic validation (transaction structure is valid)
+ * - **INCLUDED**: Wait until transaction is included in a block (signature validated, nonce updated, converted to receipt)
+ * - **EXECUTED_OPTIMISTIC**: Wait until transaction execution completes (default - fast, works well for sandbox/testnet)
+ * - **INCLUDED_FINAL**: Wait until the block containing the transaction is finalized
+ * - **EXECUTED**: Wait until both INCLUDED_FINAL and EXECUTED_OPTIMISTIC conditions are met
+ * - **FINAL**: Wait until the block with the last non-refund receipt is finalized (full finality guarantee)
+ *
+ * @see {@link https://docs.near.org/api/rpc/transactions#send-transaction-await NEAR RPC Documentation}
+ */
+export type TxExecutionStatus = "NONE" | "INCLUDED" | "EXECUTED_OPTIMISTIC" | "INCLUDED_FINAL" | "EXECUTED" | "FINAL";
+/**
+ * Options for sending a transaction
+ */
+import type { FinalExecutionOutcomeMap } from "./rpc/rpc-schemas.js";
+export interface SendOptions<W extends keyof FinalExecutionOutcomeMap = keyof FinalExecutionOutcomeMap> {
+    /**
+     * Controls when the RPC returns after submitting the transaction.
+     *
+     * **Execution Flow:**
+     *
+     * 1. **NONE**: Transaction validated (structure check only) - no execution started
+     * 2. **INCLUDED**: Transaction included in block, signature validated, nonce updated, receipt created - execution started
+     * 3. **EXECUTED_OPTIMISTIC**: All receipts executed (may include cross-contract calls) - execution complete
+     * 4. **INCLUDED_FINAL**: Block with transaction is finalized
+     * 5. **EXECUTED**: Both INCLUDED_FINAL + EXECUTED_OPTIMISTIC
+     * 6. **FINAL**: Block with last non-refund receipt is finalized
+     *
+     * **Note:** INCLUDED_FINAL may resolve before or after EXECUTED_OPTIMISTIC depending on execution time.
+     *
+     * @default "EXECUTED_OPTIMISTIC"
+     */
+    waitUntil?: W;
+}
+export interface Transaction {
+    signerId: string;
+    publicKey: PublicKey;
+    nonce: bigint;
+    receiverId: string;
+    actions: Action[];
+    blockHash: Uint8Array;
+}
+export interface SignedTransaction {
+    transaction: Transaction;
+    signature: Signature;
+}
+/**
+ * Transaction execution types inferred from validated RPC schemas
+ *
+ * These types match the actual RPC response format and provide runtime validation.
+ *
+ * - ExecutionStatus: Status of transaction/receipt execution (SuccessValue, SuccessReceiptId, or Failure)
+ * - ExecutionOutcome: Details of transaction execution including gas, logs, and status
+ * - ExecutionOutcomeWithId: Execution outcome with transaction/receipt ID and block info
+ * - FinalExecutionOutcome: Complete transaction result including all receipts
+ * - FinalExecutionOutcomeWithReceipts: Extended outcome with full receipt details (from EXPERIMENTAL_tx_status)
+ *
+ * @see {@link https://docs.near.org/api/rpc/transactions NEAR RPC Transaction Documentation}
+ */
+export type { ExecutionMetadata, ExecutionOutcome, ExecutionOutcomeWithId, ExecutionStatus, FinalExecutionOutcome, FinalExecutionOutcomeMap, FinalExecutionOutcomeWithReceipts, FinalExecutionOutcomeWithReceiptsMap, MerklePathItem, Receipt, RpcAction, RpcTransaction, } from "./rpc/rpc-schemas.js";
+import type { FinalExecutionOutcome } from "./rpc/rpc-schemas.js";
+/**
+ * RPC response types with runtime validation via Zod schemas
+ *
+ * These types are inferred from Zod schemas defined in rpc-schemas.ts
+ * and provide both compile-time and runtime type safety.
+ *
+ * - ViewFunctionCallResult: Result from calling a view function on a contract
+ * - AccountView: Account information returned by view_account query
+ * - AccessKeyView: Access key information returned by view_access_key query
+ * - AccessKeyInfoView: Access key with its public key
+ * - StatusResponse: Network status information
+ * - GasPriceResponse: Gas price information
+ * - AccessKeyListResponse: Access key list from view_access_key_list query
+ * - RpcErrorResponse: RPC error response structure
+ */
+export type { AccessKeyInfoView, AccessKeyListResponse, AccessKeyView, AccountView, GasPriceResponse, RpcErrorResponse, StatusResponse, ViewFunctionCallResult, } from "./rpc/rpc-schemas.js";
+export type { NearConfig } from "./config-schemas.js";
+/**
+ * Pluggable key store interface used by {@link Near} and {@link TransactionBuilder}.
+ *
+ * Implementations are responsible for persisting key pairs (in memory, on disk,
+ * in secure hardware, etc.). The bundled implementations are:
+ *
+ * - {@link InMemoryKeyStore} for ephemeral keys
+ * - {@link FileKeyStore} for NEAR-CLI compatible on-disk storage
+ *
+ * @remarks
+ * All methods are asynchronous to support remote or secure storage backends.
+ */
+export interface KeyStore {
+    add(accountId: string, key: KeyPair, options?: {
+        seedPhrase?: string;
+        derivationPath?: string;
+        implicitAccountId?: string;
+    }): Promise<void>;
+    get(accountId: string): Promise<KeyPair | null>;
+    remove(accountId: string): Promise<void>;
+    list(): Promise<string[]>;
+}
+export type { CallOptions } from "./config-schemas.js";
+/**
+ * Base contract method shape used by {@link Contract}.
+ *
+ * @remarks
+ * Library users typically define their own contract interfaces that extend this
+ * structure and then pass them to {@link Near.contract}.
+ */
+export interface ContractMethods {
+    view: Record<string, (...args: unknown[]) => Promise<unknown>>;
+    call: Record<string, (...args: unknown[]) => Promise<unknown>>;
+}
+export interface WalletSignInOptions {
+    contractId?: string;
+    methodNames?: string[];
+    successUrl?: string;
+    failureUrl?: string;
+}
+/**
+ * Account information returned by wallet
+ */
+export interface WalletAccount {
+    accountId: string;
+    publicKey?: string;
+}
+/**
+ * Parameters for signing a message
+ */
+export interface SignMessageParams {
+    message: string;
+    recipient: string;
+    nonce: Uint8Array;
+}
+/**
+ * Signed message result
+ */
+export interface SignedMessage {
+    accountId: string;
+    publicKey: string;
+    signature: string;
+}
+/**
+ * Wallet connection interface
+ * Compatible with both @near-wallet-selector and @hot-labs/near-connect
+ */
+export interface WalletConnection {
+    /**
+     * Get connected accounts from wallet
+     */
+    getAccounts(): Promise<WalletAccount[]>;
+    /**
+     * Sign and send a transaction using the wallet
+     */
+    signAndSendTransaction(params: {
+        signerId?: string;
+        receiverId: string;
+        actions: Action[];
+    }): Promise<FinalExecutionOutcome>;
+    /**
+     * Sign a message using the wallet (optional)
+     */
+    signMessage?(params: SignMessageParams): Promise<SignedMessage>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,9 @@
+/**
+ * Core type definitions for the NEAR client library
+ */
+export var KeyType;
+(function (KeyType) {
+    KeyType[KeyType["ED25519"] = 0] = "ED25519";
+    KeyType[KeyType["SECP256K1"] = 1] = "SECP256K1";
+})(KeyType || (KeyType = {}));
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmCH,MAAM,CAAN,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,2CAAW,CAAA;IACX,+CAAa,CAAA;AACf,CAAC,EAHW,OAAO,KAAP,OAAO,QAGlB"}

package/dist/errors/index.d.ts

@@ -0,0 +1,226 @@
+/**
+ * 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 declare class NearError extends Error {
+    code: string;
+    data?: unknown;
+    constructor(message: string, code: string, data?: unknown);
+}
+/**
+ * Thrown when an account has insufficient balance for an operation
+ */
+export declare class InsufficientBalanceError extends NearError {
+    required: string;
+    available: string;
+    constructor(required: string, available: string);
+}
+/**
+ * Thrown when a contract function call fails
+ */
+export declare class FunctionCallError extends NearError {
+    panic?: string;
+    methodName?: string;
+    contractId: string;
+    logs: string[];
+    constructor(contractId: string, methodName: string | undefined, panic?: string, logs?: string[]);
+}
+/**
+ * Thrown when a network request fails
+ */
+export declare class NetworkError extends NearError {
+    statusCode?: number;
+    retryable: boolean;
+    constructor(message: string, statusCode?: number, retryable?: boolean);
+}
+/**
+ * Thrown when a key is invalid or malformed
+ */
+export declare class InvalidKeyError extends NearError {
+    constructor(message: string);
+}
+/**
+ * Thrown when an account does not exist
+ */
+export declare class AccountDoesNotExistError extends NearError {
+    accountId: string;
+    constructor(accountId: string);
+}
+/**
+ * Thrown when an access key does not exist
+ */
+export declare class AccessKeyDoesNotExistError extends NearError {
+    accountId: string;
+    publicKey: string;
+    constructor(accountId: string, publicKey: string);
+}
+/**
+ * Thrown when an account ID is invalid
+ */
+export declare class InvalidAccountIdError extends NearError {
+    accountId: string;
+    constructor(accountId: string, reason?: string);
+}
+/**
+ * Thrown when transaction signing fails
+ */
+export declare class SignatureError extends NearError {
+    constructor(message: string);
+}
+/**
+ * Thrown when gas limit is exceeded
+ */
+export declare class GasLimitExceededError extends NearError {
+    gasUsed: string;
+    gasLimit: string;
+    constructor(gasUsed: string, gasLimit: string);
+}
+/**
+ * Thrown when a transaction times out
+ */
+export declare class TransactionTimeoutError extends NearError {
+    transactionHash: string;
+    constructor(transactionHash: string);
+}
+/**
+ * Thrown when wallet operations fail
+ */
+export declare class WalletError extends NearError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a requested block cannot be found
+ * Suggests using an archival node for old blocks
+ */
+export declare class UnknownBlockError extends NearError {
+    blockReference: string;
+    constructor(blockReference: string);
+}
+/**
+ * Thrown when account ID format is invalid
+ */
+export declare class InvalidAccountError extends NearError {
+    accountId: string;
+    constructor(accountId: string);
+}
+/**
+ * Thrown when the requested shard is not available on this node
+ */
+export declare class ShardUnavailableError extends NearError {
+    retryable: boolean;
+    constructor(message?: string);
+}
+/**
+ * Thrown when the node is still syncing
+ */
+export declare class NodeNotSyncedError extends NearError {
+    retryable: boolean;
+    constructor(message?: string);
+}
+/**
+ * Thrown when an account has no contract deployed
+ */
+export declare class ContractNotDeployedError extends NearError {
+    accountId: string;
+    constructor(accountId: string);
+}
+/**
+ * Thrown when contract state is too large to return
+ */
+export declare class ContractStateTooLargeError extends NearError {
+    accountId: string;
+    constructor(accountId: string);
+}
+/**
+ * Thrown when a view function call execution fails
+ */
+export declare class ContractExecutionError extends NearError {
+    contractId: string;
+    methodName?: string;
+    details?: unknown;
+    constructor(contractId: string, methodName?: string, details?: unknown);
+}
+/**
+ * Thrown when a chunk cannot be found
+ */
+export declare class UnknownChunkError extends NearError {
+    chunkReference: string;
+    constructor(chunkReference: string);
+}
+/**
+ * Thrown when an invalid shard ID is provided
+ */
+export declare class InvalidShardIdError extends NearError {
+    shardId: number | string;
+    constructor(shardId: number | string);
+}
+/**
+ * Thrown when an epoch cannot be found
+ */
+export declare class UnknownEpochError extends NearError {
+    blockReference: string;
+    constructor(blockReference: string);
+}
+/**
+ * Thrown when transaction nonce is invalid
+ * This happens when a transaction uses a nonce that has already been used
+ */
+export declare class InvalidNonceError extends NearError {
+    txNonce: number;
+    akNonce: number;
+    retryable: boolean;
+    constructor(txNonce: number, akNonce: number);
+}
+/**
+ * Thrown when a transaction is invalid
+ * Check details for specific reasons like ShardCongested or ShardStuck
+ */
+export declare class InvalidTransactionError extends NearError {
+    retryable: boolean;
+    shardCongested: boolean;
+    shardStuck: boolean;
+    details?: unknown;
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Thrown when a receipt cannot be found
+ */
+export declare class UnknownReceiptError extends NearError {
+    receiptId: string;
+    constructor(receiptId: string);
+}
+/**
+ * Thrown when request parameters cannot be parsed
+ */
+export declare class ParseError extends NearError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Thrown when a request times out (408)
+ * This is always retryable - resubmit the identical transaction
+ */
+export declare class TimeoutError extends NearError {
+    retryable: boolean;
+    transactionHash?: string;
+    constructor(message?: string, transactionHash?: string);
+}
+/**
+ * Thrown when the RPC server encounters an internal error (500)
+ * This is always retryable
+ */
+export declare class InternalServerError extends NearError {
+    retryable: boolean;
+    constructor(message?: string, details?: unknown);
+}
+//# sourceMappingURL=index.d.ts.map

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

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