Configuration Options

These are the properties accepted by the Near class constructor.

const near = new Near({
  network: "testnet",
  privateKey: "...",
})

Network

Controls which NEAR network to connect to.

string | NetworkConfig

required

The network to connect to.Presets: "mainnet", "testnet", "localnet"Custom config:

{
  networkId: "my-private-net",
  rpcUrl: "http://127.0.0.1:3030"
}

Sandbox: Passing a Sandbox instance automatically configures RPC and the root account key.

string

Override the RPC URL for a preset network (e.g., to use a specific provider like Infura or Lava).

Record<string, string>

Custom HTTP headers for RPC requests.

{ "Authorization": "Bearer ..." }

Credentials & Signing

near-kit checks these in order: wallet > signer > privateKey > keyStore.

string

A single private key (ed25519:...). Useful for scripts.

KeyStore

A storage backend for multiple keys.

KeyStore	Environment	Description
`InMemoryKeyStore`	Any	Default, keys in memory
`FileKeyStore`	Node.js	Stores in `~/.near-credentials`
`NativeKeyStore`	Node.js	macOS Keychain / Windows Credential Manager
`RotatingKeyStore`	Any	For high-concurrency apps

WalletAdapter

A wrapper around a browser wallet.

wallet: fromHotConnect(connector)

(hash: Uint8Array) => Promise<Signature>

A custom signing function. Use this for hardware wallets, KMS, or multi-sig logic.

string

The account ID to use when calling near.transaction() without arguments.

Execution Behavior

string

default:"EXECUTED_OPTIMISTIC"

Controls how long .send() waits before returning.

Value	Description
`"INCLUDED"`	Return as soon as the network accepts it (fastest, no result value)
`"EXECUTED_OPTIMISTIC"`	Transaction is executed and result is available (default)
`"FINAL"`	Wait for BFT finality (safest, slowest)

object

Configuration for automatic retries on network errors.

Show properties

number

default:4

Maximum retries for retryable network errors (429, 503, etc).

number

default:1000

Initial backoff delay in milliseconds.

Getting Started

Essentials

React

Building dApps

Advanced

Reference

Configuration Options

Network

Credentials & Signing

Execution Behavior

​Network

​Credentials & Signing

​Execution Behavior

Network

Credentials & Signing

Execution Behavior