near-kit 0.0.0 → 0.1.0

package/dist/core/config-schemas.js

@@ -0,0 +1,169 @@
+/**
+ * Zod schemas for NEAR client configuration.
+ *
+ * @remarks
+ * These schemas validate network, call options, and {@link NearConfig} input.
+ * Most applications should use the higher-level {@link Near} API and treat
+ * these schemas as an implementation detail.
+ */
+import { z } from "zod";
+import { PrivateKeySchema } from "../utils/validation.js";
+import { NETWORK_PRESETS } from "./constants.js";
+// ==================== Network Config Schema ====================
+/**
+ * Schema for network presets (mainnet, testnet, localnet)
+ */
+export const NetworkPresetSchema = z.enum(["mainnet", "testnet", "localnet"]);
+/**
+ * Schema for custom network configuration
+ */
+export const CustomNetworkConfigSchema = z.object({
+    rpcUrl: z.string().url("RPC URL must be a valid URL"),
+    networkId: z.string().min(1, "Network ID is required"),
+    nodeUrl: z.string().url("Node URL must be a valid URL").optional(),
+    walletUrl: z.string().url("Wallet URL must be a valid URL").optional(),
+    helperUrl: z.string().url("Helper URL must be a valid URL").optional(),
+});
+/**
+ * Schema for network configuration (preset or custom)
+ */
+export const NetworkConfigSchema = z.union([
+    NetworkPresetSchema,
+    CustomNetworkConfigSchema,
+]);
+// ==================== Transaction Execution Status Schema ====================
+/**
+ * Schema for transaction execution status
+ */
+export const TxExecutionStatusSchema = z.enum([
+    "NONE",
+    "INCLUDED",
+    "EXECUTED_OPTIMISTIC",
+    "INCLUDED_FINAL",
+    "EXECUTED",
+    "FINAL",
+]);
+// ==================== Call Options Schema ====================
+/**
+ * Schema for function call options
+ */
+export const CallOptionsSchema = z.object({
+    gas: z.string().optional(),
+    attachedDeposit: z.union([z.string(), z.bigint()]).optional(),
+    signerId: z.string().optional(),
+    waitUntil: TxExecutionStatusSchema.optional(),
+});
+// ==================== Block Reference Schema ====================
+/**
+ * Block reference for RPC queries
+ *
+ * Specify either `finality` OR `blockId` (not both).
+ * If both are provided, `blockId` takes precedence.
+ *
+ * @example
+ * ```typescript
+ * // Query at final block (default)
+ * await near.view('contract.near', 'get_value')
+ *
+ * // Query at optimistic for latest state
+ * await near.view('contract.near', 'get_value', {}, {
+ *   finality: 'optimistic'
+ * })
+ *
+ * // Query at specific block height
+ * await near.view('contract.near', 'get_value', {}, {
+ *   blockId: 27912554
+ * })
+ *
+ * // Query at specific block hash
+ * await near.view('contract.near', 'get_value', {}, {
+ *   blockId: '3Xz2wM9rigMXzA2c5vgCP8wTgFBaePucgUmVYPkMqhRL'
+ * })
+ * ```
+ */
+export const BlockReferenceSchema = z.object({
+    /**
+     * Finality level for the query
+     *
+     * - `optimistic`: Block that might be skipped (~1s after submission). Use for latest state.
+     * - `near-final`: Irreversible unless a validator is slashed (~2s after submission)
+     * - `final`: Fully finalized and irreversible (~3s after submission). DEFAULT for view calls.
+     *
+     * @default "final" for view calls, "optimistic" for account/key queries
+     * @see https://docs.near.org/api/rpc/setup#using-finality-param
+     */
+    finality: z.enum(["optimistic", "near-final", "final"]).optional(),
+    /**
+     * Block ID to query at - can be block number or block hash
+     *
+     * Use block number (e.g., `27912554`) or block hash
+     * (e.g., `'3Xz2wM9rigMXzA2c5vgCP8wTgFBaePucgUmVYPkMqhRL'`) to query
+     * historical state.
+     *
+     * Mutually exclusive with `finality`. If both are provided, `blockId` takes precedence.
+     */
+    blockId: z.union([z.number(), z.string()]).optional(),
+});
+// ==================== Near Config Schema ====================
+/**
+ * Schema for key store configuration
+ */
+export const KeyStoreConfigSchema = z.union([
+    z.string(), // File path
+    z.record(z.string(), z.string()), // { accountId: privateKey }
+    z.any(), // KeyStore interface - too complex for Zod validation
+]);
+/**
+ * Schema for signer function
+ */
+export const SignerSchema = z.any(); // Function schema validation - simplified
+/**
+ * Schema for RPC retry configuration
+ */
+export const RpcRetryConfigSchema = z
+    .object({
+    maxRetries: z.number().int().min(0),
+    initialDelayMs: z.number().int().min(0),
+})
+    .partial();
+/**
+ * Schema for NEAR client configuration
+ */
+export const NearConfigSchema = z.object({
+    network: NetworkConfigSchema.optional(),
+    rpcUrl: z.string().url("RPC URL must be a valid URL").optional(),
+    headers: z.record(z.string(), z.string()).optional(),
+    keyStore: KeyStoreConfigSchema.optional(),
+    signer: SignerSchema.optional(),
+    privateKey: z.union([PrivateKeySchema, z.instanceof(Uint8Array)]).optional(),
+    wallet: z.any().optional(), // WalletConnection interface
+    defaultSignerId: z.string().optional(),
+    defaultWaitUntil: TxExecutionStatusSchema.optional(),
+    retryConfig: RpcRetryConfigSchema.optional(),
+});
+// ==================== Helper Functions ====================
+/**
+ * Resolve network configuration with validation
+ */
+export function resolveNetworkConfig(network) {
+    // Default to mainnet
+    if (!network) {
+        const envNetwork = typeof process !== "undefined" ? process.env["NEAR_NETWORK"] : undefined;
+        if (envNetwork &&
+            (envNetwork === "mainnet" ||
+                envNetwork === "testnet" ||
+                envNetwork === "localnet")) {
+            return NETWORK_PRESETS[envNetwork];
+        }
+        return NETWORK_PRESETS.mainnet;
+    }
+    // Validate and parse network config
+    const validated = NetworkConfigSchema.parse(network);
+    // Network preset
+    if (typeof validated === "string") {
+        return NETWORK_PRESETS[validated];
+    }
+    // Custom network config (already validated)
+    return validated;
+}
+//# sourceMappingURL=config-schemas.js.map

package/dist/core/config-schemas.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Constants for NEAR Protocol
+ */
+export declare const NETWORK_PRESETS: {
+    readonly mainnet: {
+        readonly rpcUrl: "https://free.rpc.fastnear.com";
+        readonly networkId: "mainnet";
+        readonly walletUrl: "https://wallet.near.org";
+        readonly helperUrl: "https://helper.mainnet.near.org";
+    };
+    readonly testnet: {
+        readonly rpcUrl: "https://rpc.testnet.fastnear.com";
+        readonly networkId: "testnet";
+        readonly walletUrl: "https://wallet.testnet.near.org";
+        readonly helperUrl: "https://helper.testnet.near.org";
+    };
+    readonly localnet: {
+        readonly rpcUrl: "http://localhost:3030";
+        readonly networkId: "localnet";
+        readonly walletUrl: "http://localhost:1234";
+        readonly helperUrl: "http://localhost:3000";
+    };
+};
+export declare const YOCTO_PER_NEAR: bigint;
+export declare const GAS_PER_TGAS: bigint;
+export declare const DEFAULT_FUNCTION_CALL_GAS = "30000000000000";
+export declare const ACCOUNT_ID_REGEX: RegExp;
+export declare const MIN_ACCOUNT_ID_LENGTH = 2;
+export declare const MAX_ACCOUNT_ID_LENGTH = 64;
+export declare const ED25519_KEY_PREFIX = "ed25519:";
+export declare const SECP256K1_KEY_PREFIX = "secp256k1:";
+export declare const RPC_METHODS: {
+    readonly QUERY: "query";
+    readonly BROADCAST_TX_COMMIT: "broadcast_tx_commit";
+    readonly BROADCAST_TX_ASYNC: "broadcast_tx_async";
+    readonly TX_STATUS: "tx";
+    readonly BLOCK: "block";
+    readonly CHUNK: "chunk";
+    readonly VALIDATORS: "validators";
+    readonly GAS_PRICE: "gas_price";
+    readonly STATUS: "status";
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;CAmBlB,CAAA;AAIV,eAAO,MAAM,cAAc,QAAsC,CAAA;AACjE,eAAO,MAAM,YAAY,QAA0B,CAAA;AAInD,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AAIzD,eAAO,MAAM,gBAAgB,QAC4B,CAAA;AACzD,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAIvC,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAC5C,eAAO,MAAM,oBAAoB,eAAe,CAAA;AAIhD,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAA"}

package/dist/core/constants.js

@@ -0,0 +1,49 @@
+/**
+ * Constants for NEAR Protocol
+ */
+// ==================== Network Endpoints ====================
+export const NETWORK_PRESETS = {
+    mainnet: {
+        rpcUrl: "https://free.rpc.fastnear.com",
+        networkId: "mainnet",
+        walletUrl: "https://wallet.near.org",
+        helperUrl: "https://helper.mainnet.near.org",
+    },
+    testnet: {
+        rpcUrl: "https://rpc.testnet.fastnear.com",
+        networkId: "testnet",
+        walletUrl: "https://wallet.testnet.near.org",
+        helperUrl: "https://helper.testnet.near.org",
+    },
+    localnet: {
+        rpcUrl: "http://localhost:3030",
+        networkId: "localnet",
+        walletUrl: "http://localhost:1234",
+        helperUrl: "http://localhost:3000",
+    },
+};
+// ==================== Units ====================
+export const YOCTO_PER_NEAR = BigInt("1000000000000000000000000");
+export const GAS_PER_TGAS = BigInt("1000000000000");
+// ==================== Gas Defaults ====================
+export const DEFAULT_FUNCTION_CALL_GAS = "30000000000000"; // 30 TGas
+// ==================== Account ID Validation ====================
+export const ACCOUNT_ID_REGEX = /^(([a-z\d]+[-_])*[a-z\d]+\.)*([a-z\d]+[-_])*[a-z\d]+$/;
+export const MIN_ACCOUNT_ID_LENGTH = 2;
+export const MAX_ACCOUNT_ID_LENGTH = 64;
+// ==================== Key Formats ====================
+export const ED25519_KEY_PREFIX = "ed25519:";
+export const SECP256K1_KEY_PREFIX = "secp256k1:";
+// ==================== RPC Methods ====================
+export const RPC_METHODS = {
+    QUERY: "query",
+    BROADCAST_TX_COMMIT: "broadcast_tx_commit",
+    BROADCAST_TX_ASYNC: "broadcast_tx_async",
+    TX_STATUS: "tx",
+    BLOCK: "block",
+    CHUNK: "chunk",
+    VALIDATORS: "validators",
+    GAS_PRICE: "gas_price",
+    STATUS: "status",
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8DAA8D;AAE9D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE;QACP,MAAM,EAAE,+BAA+B;QACvC,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,yBAAyB;QACpC,SAAS,EAAE,iCAAiC;KAC7C;IACD,OAAO,EAAE;QACP,MAAM,EAAE,kCAAkC;QAC1C,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,iCAAiC;QAC5C,SAAS,EAAE,iCAAiC;KAC7C;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,uBAAuB;QAC/B,SAAS,EAAE,UAAU;QACrB,SAAS,EAAE,uBAAuB;QAClC,SAAS,EAAE,uBAAuB;KACnC;CACO,CAAA;AAEV,kDAAkD;AAElD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAA;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA;AAEnD,yDAAyD;AAEzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAA,CAAC,UAAU;AAEpE,kEAAkE;AAElE,MAAM,CAAC,MAAM,gBAAgB,GAC3B,uDAAuD,CAAA;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEvC,wDAAwD;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAA;AAEhD,wDAAwD;AAExD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAA"}

package/dist/core/near.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Main NEAR client class
+ */
+import type { ContractMethods } from "../contracts/contract.js";
+import type { Amount } from "../utils/validation.js";
+import { type BlockReference, type NearConfig } from "./config-schemas.js";
+import type { FinalExecutionOutcome, FinalExecutionOutcomeWithReceiptsMap } from "./rpc/rpc-schemas.js";
+import { TransactionBuilder } from "./transaction.js";
+import type { CallOptions, SignedMessage, SignMessageParams } from "./types.js";
+/**
+ * Main client for interacting with the NEAR blockchain.
+ *
+ * Wraps RPC access, key management, wallet integrations, and the fluent
+ * transaction builder. Most applications create one `Near` instance per
+ * network and reuse it for all operations.
+ *
+ * @remarks
+ * Configure the client with {@link NearConfig} to choose networks, key stores,
+ * wallets, and retry behavior. For a guided overview see
+ * `docs/01-getting-started.md` and `docs/02-core-concepts.md`.
+ */
+export declare class Near {
+    private rpc;
+    private keyStore;
+    private signer?;
+    private wallet?;
+    private defaultSignerId?;
+    private defaultWaitUntil;
+    private pendingKeyStoreInit?;
+    constructor(config?: NearConfig);
+    /**
+     * Initialize RPC client from configuration
+     * @internal
+     */
+    private _initializeRpc;
+    /**
+     * Resolve and initialize keystore from configuration
+     * @internal
+     */
+    private _resolveKeyStore;
+    /**
+     * Resolve and initialize signer from configuration
+     * Handles privateKey, custom signer, and sandbox root key auto-detection
+     * @internal
+     */
+    private _resolveSigner;
+    /**
+     * Ensure any pending keystore initialization is complete
+     * @internal
+     */
+    private ensureKeyStoreReady;
+    /**
+     * Resolve key store from config input
+     * @internal
+     */
+    private resolveKeyStore;
+    /**
+     * Get signer ID from options, default, or wallet
+     * @internal
+     */
+    private getSignerId;
+    /**
+     * Call a view function on a contract (read-only, no gas).
+     *
+     * @param contractId - Target contract account ID.
+     * @param methodName - Name of the view method to call.
+     * @param args - Arguments object or raw bytes; defaults to `{}`.
+     * @param options - Optional {@link BlockReference} to specify finality or block.
+     *
+     * @returns Parsed JSON result when the contract returns JSON, otherwise the
+     * raw string value typed as `T`.
+     *
+     * @remarks
+     * - View calls are free and do not require a signer or gas.
+     * - Errors thrown by the contract surface as {@link ContractExecutionError}.
+     *
+     * @see NearConfig.defaultWaitUntil
+     */
+    view<T = unknown>(contractId: string, methodName: string, args?: object | Uint8Array, options?: BlockReference): Promise<T>;
+    /**
+     * Call a change function on a contract (requires signature and gas).
+     *
+     * Uses the connected wallet when available, otherwise falls back to the
+     * configured signer / private key / key store.
+     *
+     * @param contractId - Target contract account ID.
+     * @param methodName - Name of the change method to call.
+     * @param args - Arguments object or raw bytes; defaults to `{}`.
+     * @param options - Call options such as gas, attached deposit, signerId and wait level.
+     *
+     * @returns The decoded contract return value typed as `T`.
+     *
+     * @throws {NearError} If no signer can be resolved.
+     * @throws {FunctionCallError} If the contract panics or returns an error.
+     * @throws {InvalidTransactionError} If the transaction itself is invalid.
+     * @throws {NetworkError} If the RPC request fails after retries.
+     *
+     * @example
+     * ```typescript
+     * await near.call(
+     *   "contract.near",
+     *   "increment",
+     *   { by: 1 },
+     *   { attachedDeposit: "1 yocto", gas: "30 Tgas" },
+     * )
+     * ```
+     */
+    call<T = FinalExecutionOutcome>(contractId: string, methodName: string, args?: object | Uint8Array, options?: CallOptions): Promise<T>;
+    /**
+     * Send NEAR tokens to an account.
+     *
+     * @param receiverId - Account ID that will receive the tokens.
+     * @param amount - Amount to send, expressed as {@link Amount} (e.g. `"10 NEAR"` or `"1 yocto"`).
+     *
+     * @returns The final transaction outcome from the wallet or RPC.
+     *
+     * @throws {NearError} If no signer can be resolved.
+     * @throws {InvalidTransactionError} If the transfer transaction is invalid.
+     * @throws {NetworkError} If the RPC request fails after retries.
+     *
+     * @remarks
+     * This is a convenience wrapper over {@link Near.transaction} with a single
+     * `transfer` action.
+     */
+    send(receiverId: string, amount: Amount): Promise<FinalExecutionOutcome>;
+    /**
+     * Sign a message using NEP-413 standard.
+     *
+     * NEP-413 enables off-chain message signing for authentication and ownership verification
+     * without gas fees or blockchain transactions. Useful for:
+     * - Login/authentication flows
+     * - Proving account ownership
+     * - Signing intents for meta-transactions
+     * - Off-chain authorization
+     *
+     * @param params - Message signing parameters
+     * @param options - Optional signer ID (defaults to first account)
+     * @returns Signed message with account ID, public key, and signature
+     *
+     * @throws {NearError} If no wallet or keystore is configured
+     * @throws {NearError} If the key doesn't support NEP-413 signing
+     *
+     * @see https://github.com/near/NEPs/blob/master/neps/nep-0413.md
+     *
+     * @example
+     * ```typescript
+     * // Sign a message for authentication
+     * const signedMessage = await near.signMessage({
+     *   message: "Login to MyApp",
+     *   recipient: "myapp.near",
+     *   nonce: crypto.getRandomValues(new Uint8Array(32)),
+     * })
+     *
+     * // Send to backend for verification
+     * await fetch("/api/auth", {
+     *   method: "POST",
+     *   body: JSON.stringify(signedMessage),
+     * })
+     * ```
+     */
+    signMessage(params: SignMessageParams | Omit<SignMessageParams, "nonce">, options?: {
+        signerId?: string;
+    }): Promise<SignedMessage>;
+    /**
+     * Get account balance in NEAR.
+     *
+     * @param accountId - Account ID to query.
+     * @param options - Optional {@link BlockReference} to control finality or block.
+     *
+     * @returns Balance formatted as `"X.YY NEAR"`.
+     *
+     * @throws {AccountDoesNotExistError} If the account does not exist.
+     * @throws {NetworkError} If the RPC request fails.
+     *
+     * @remarks
+     * This is a convenience helper over {@link RpcClient.getAccount}. For more
+     * detailed information (storage, locked balance, etc.) call `rpc.getAccount`
+     * directly.
+     */
+    getBalance(accountId: string, options?: BlockReference): Promise<string>;
+    /**
+     * Check if an account exists.
+     *
+     * @param accountId - Account ID to check.
+     * @param options - Optional {@link BlockReference} to control finality or block.
+     *
+     * @returns `true` if the account exists, `false` otherwise.
+     *
+     * @remarks
+     * This method swallows all errors and returns `false` on failure. Use
+     * {@link RpcClient.getAccount} if you need to distinguish error causes.
+     */
+    accountExists(accountId: string, options?: BlockReference): Promise<boolean>;
+    /**
+     * Get transaction status with detailed receipt information
+     *
+     * Queries the status of a transaction by hash using the EXPERIMENTAL_tx_status RPC method,
+     * returning the final transaction result with detailed receipt information.
+     *
+     * @param txHash - Transaction hash to query
+     * @param senderAccountId - Account ID that sent the transaction (used to determine shard)
+     * @param waitUntil - Optional execution level to wait for (default: "EXECUTED_OPTIMISTIC")
+     *
+     * @returns Transaction status with receipts, typed based on waitUntil parameter
+     *
+     * @throws {InvalidTransactionError} If transaction execution failed
+     * @throws {NetworkError} If network request failed
+     *
+     * @example
+     * ```typescript
+     * // Get transaction status with default wait level
+     * const status = await near.getTransactionStatus(
+     *   '7AfonAhbK4ZbdBU9VPcQdrTZVZBXE25HmZAMEABs9To1',
+     *   'alice.near'
+     * )
+     *
+     * // Wait for full finality
+     * const finalStatus = await near.getTransactionStatus(
+     *   '7AfonAhbK4ZbdBU9VPcQdrTZVZBXE25HmZAMEABs9To1',
+     *   'alice.near',
+     *   'FINAL'
+     * )
+     *
+     * // Access receipt details
+     * console.log('Receipts:', finalStatus.receipts)
+     * ```
+     *
+     * @see {@link https://docs.near.org/api/rpc/transactions#transaction-status-with-receipts NEAR RPC Documentation}
+     */
+    getTransactionStatus<W extends "NONE" | "INCLUDED" | "EXECUTED_OPTIMISTIC" | "INCLUDED_FINAL" | "EXECUTED" | "FINAL" = "EXECUTED_OPTIMISTIC">(txHash: string, senderAccountId: string, waitUntil?: W): Promise<W extends keyof FinalExecutionOutcomeWithReceiptsMap ? FinalExecutionOutcomeWithReceiptsMap[W] : never>;
+    /**
+     * Get basic network status information.
+     *
+     * @returns An object containing `chainId`, `latestBlockHeight`, and `syncing` flag.
+     */
+    getStatus(): Promise<{
+        chainId: string;
+        latestBlockHeight: number;
+        syncing: boolean;
+    }>;
+    /**
+     * Batch multiple read operations.
+     *
+     * @param promises - Promises to execute in parallel.
+     *
+     * @returns A tuple of resolved values preserving the input order.
+     *
+     * @remarks
+     * This is a thin wrapper over `Promise.all` with a tuple-friendly signature.
+     * It does not perform any RPC-level batching.
+     */
+    batch<T extends unknown[]>(...promises: Array<Promise<T[number]>>): Promise<T>;
+    /**
+     * Create a transaction builder for the specified signer account.
+     *
+     * The `signerId` determines which account will sign and send this transaction.
+     * This account must have keys available in the configured keyStore, privateKey,
+     * custom signer, or be connected via wallet.
+     *
+     * @param signerId - The account ID that will sign and pay for this transaction
+     *
+     * @returns A transaction builder for chaining actions
+     *
+     * @example
+     * ```typescript
+     * // Alice sends NEAR to Bob
+     * await near.transaction('alice.near')
+     *   .transfer('bob.near', '10 NEAR')
+     *   .send()
+     *
+     * // Alice calls a contract and creates a new account
+     * await near.transaction('alice.near')
+     *   .functionCall('market.near', 'buy', { id: 123 })
+     *   .createAccount('sub.alice.near')
+     *   .transfer('sub.alice.near', '5 NEAR')
+     *   .send()
+     * ```
+     *
+     * @see {@link TransactionBuilder} for available actions
+     */
+    transaction(signerId: string): TransactionBuilder;
+    /**
+     * Create a type-safe contract interface.
+     *
+     * @param contractId - Account ID of the target contract.
+     *
+     * @returns A proxy implementing your {@link ContractMethods} interface.
+     *
+     * @example
+     * ```typescript
+     * type Counter = Contract<{
+     *   view: { get_count: () => Promise<number> }
+     *   call: { increment: () => Promise<void> }
+     * }>
+     *
+     * const counter = near.contract<Counter>("counter.near")
+     * ```
+     */
+    contract<T extends ContractMethods>(contractId: string): T;
+}
+//# sourceMappingURL=near.d.ts.map

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

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