near-kit 0.0.0 → 0.2.0

package/dist/core/actions.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Transaction action factories.
+ *
+ * Provides low-level, type-safe helpers for creating NEAR transaction actions.
+ * Most applications should use {@link TransactionBuilder} rather than calling
+ * these functions directly; they are exported for advanced and custom tooling.
+ */
+import type { AccessKeyPermissionBorsh, AddKeyAction, ClassicAction, CreateAccountAction, DeleteAccountAction, DeleteKeyAction, DeployContractAction, DeployGlobalContractAction, FunctionCallAction, SignedDelegateAction, StakeAction, TransferAction, UseGlobalContractAction } from "./schema.js";
+import type { Ed25519PublicKey, PublicKey, Secp256k1PublicKey, Signature } from "./types.js";
+/**
+ * Delegate action for NEP-366 meta-transactions.
+ *
+ * Represents a set of classic actions signed by one account to be executed
+ * by another (typically a relayer).
+ */
+export declare class DelegateAction {
+    senderId: string;
+    receiverId: string;
+    actions: ClassicAction[];
+    nonce: bigint;
+    maxBlockHeight: bigint;
+    publicKey: PublicKey;
+    constructor(senderId: string, receiverId: string, actions: ClassicAction[], nonce: bigint, maxBlockHeight: bigint, publicKey: PublicKey);
+}
+/**
+ * Delegate action plus signature.
+ */
+export declare class SignedDelegate {
+    delegateAction: DelegateAction;
+    signature: Signature;
+    constructor(delegateAction: DelegateAction, signature: Signature);
+}
+/**
+ * Create a transfer action.
+ *
+ * @param deposit - Amount in yoctoNEAR as bigint.
+ */
+export declare function transfer(deposit: bigint): TransferAction;
+/**
+ * Create a function call action.
+ *
+ * @param methodName - Contract method name.
+ * @param args - Serialized arguments as bytes.
+ * @param gas - Gas attached (raw units).
+ * @param deposit - Attached deposit in yoctoNEAR.
+ */
+export declare function functionCall(methodName: string, args: Uint8Array, gas: bigint, deposit: bigint): FunctionCallAction;
+/**
+ * Create an account creation action.
+ */
+export declare function createAccount(): CreateAccountAction;
+/**
+ * Create a delete account action.
+ */
+export declare function deleteAccount(beneficiaryId: string): DeleteAccountAction;
+/**
+ * Create a deploy contract action.
+ *
+ * @param code - WASM bytes of the contract to deploy.
+ */
+export declare function deployContract(code: Uint8Array): DeployContractAction;
+/**
+ * Create a stake action.
+ *
+ * @param amount - Amount to stake in yoctoNEAR.
+ * @param publicKey - Validator public key.
+ */
+export declare function stake(amount: bigint, publicKey: Ed25519PublicKey): {
+    stake: {
+        stake: bigint;
+        publicKey: {
+            ed25519Key: {
+                data: number[];
+            };
+        };
+    };
+};
+export declare function stake(amount: bigint, publicKey: Secp256k1PublicKey): {
+    stake: {
+        stake: bigint;
+        publicKey: {
+            secp256k1Key: {
+                data: number[];
+            };
+        };
+    };
+};
+export declare function stake(amount: bigint, publicKey: PublicKey): StakeAction;
+/**
+ * Create an add key action.
+ *
+ * @param publicKey - Public key to add.
+ * @param permission - Access key permission in Borsh format.
+ */
+export declare function addKey(publicKey: Ed25519PublicKey, permission: AccessKeyPermissionBorsh): {
+    addKey: {
+        publicKey: {
+            ed25519Key: {
+                data: number[];
+            };
+        };
+        accessKey: {
+            nonce: bigint;
+            permission: AccessKeyPermissionBorsh;
+        };
+    };
+};
+export declare function addKey(publicKey: Secp256k1PublicKey, permission: AccessKeyPermissionBorsh): {
+    addKey: {
+        publicKey: {
+            secp256k1Key: {
+                data: number[];
+            };
+        };
+        accessKey: {
+            nonce: bigint;
+            permission: AccessKeyPermissionBorsh;
+        };
+    };
+};
+export declare function addKey(publicKey: PublicKey, permission: AccessKeyPermissionBorsh): AddKeyAction;
+/**
+ * Create a delete key action.
+ *
+ * @param publicKey - Public key to remove.
+ */
+export declare function deleteKey(publicKey: Ed25519PublicKey): {
+    deleteKey: {
+        publicKey: {
+            ed25519Key: {
+                data: number[];
+            };
+        };
+    };
+};
+export declare function deleteKey(publicKey: Secp256k1PublicKey): {
+    deleteKey: {
+        publicKey: {
+            secp256k1Key: {
+                data: number[];
+            };
+        };
+    };
+};
+export declare function deleteKey(publicKey: PublicKey): DeleteKeyAction;
+/**
+ * Publish a global contract that can be reused by multiple accounts
+ *
+ * @param code - The compiled contract code bytes
+ * @param accountId - Optional account ID. If provided, creates a mutable contract (can be updated).
+ *                    If omitted, creates an immutable contract (identified by code hash).
+ * @returns DeployGlobalContractAction
+ *
+ * @example
+ * ```typescript
+ * // Publish immutable contract (identified by code hash)
+ * publishContract(contractCode)
+ *
+ * // Publish mutable contract (identified by account, can be updated)
+ * publishContract(contractCode, "my-publisher.near")
+ * ```
+ */
+export declare function publishContract(code: Uint8Array, accountId?: string): DeployGlobalContractAction;
+/**
+ * Deploy a contract to this account from previously published code in the global registry
+ *
+ * @param reference - Reference to the published contract, either:
+ *                    - { codeHash: Uint8Array | string } - Reference by code hash (Uint8Array or base58 string)
+ *                    - { accountId: string } - Reference by the account that published it
+ * @returns UseGlobalContractAction
+ *
+ * @example
+ * ```typescript
+ * // Deploy from code hash (Uint8Array)
+ * deployFromPublished({ codeHash: hashBytes })
+ *
+ * // Deploy from code hash (base58 string)
+ * deployFromPublished({ codeHash: "5FzD8..." })
+ *
+ * // Deploy from account ID
+ * deployFromPublished({ accountId: "contract-publisher.near" })
+ * ```
+ */
+export declare function deployFromPublished(reference: {
+    codeHash: string | Uint8Array;
+} | {
+    accountId: string;
+}): UseGlobalContractAction;
+/**
+ * Create a signed delegate action for meta-transactions
+ */
+export declare function signedDelegate(delegateAction: DelegateAction, signature: Signature): SignedDelegateAction;
+//# sourceMappingURL=actions.d.ts.map

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

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

package/dist/core/actions.js

@@ -0,0 +1,195 @@
+/**
+ * Transaction action factories.
+ *
+ * Provides low-level, type-safe helpers for creating NEAR transaction actions.
+ * Most applications should use {@link TransactionBuilder} rather than calling
+ * these functions directly; they are exported for advanced and custom tooling.
+ */
+import { base58 } from "@scure/base";
+import { publicKeyToZorsh, signatureToZorsh } from "./schema.js";
+// ==================== Delegate Actions ====================
+/**
+ * Delegate action for NEP-366 meta-transactions.
+ *
+ * Represents a set of classic actions signed by one account to be executed
+ * by another (typically a relayer).
+ */
+export class DelegateAction {
+    constructor(senderId, receiverId, actions, nonce, maxBlockHeight, publicKey) {
+        this.senderId = senderId;
+        this.receiverId = receiverId;
+        this.actions = actions;
+        this.nonce = nonce;
+        this.maxBlockHeight = maxBlockHeight;
+        this.publicKey = publicKey;
+    }
+}
+/**
+ * Delegate action plus signature.
+ */
+export class SignedDelegate {
+    constructor(delegateAction, signature) {
+        this.delegateAction = delegateAction;
+        this.signature = signature;
+    }
+}
+// ==================== Action Factory Functions ====================
+/**
+ * Create a transfer action.
+ *
+ * @param deposit - Amount in yoctoNEAR as bigint.
+ */
+export function transfer(deposit) {
+    return {
+        transfer: { deposit },
+    };
+}
+/**
+ * Create a function call action.
+ *
+ * @param methodName - Contract method name.
+ * @param args - Serialized arguments as bytes.
+ * @param gas - Gas attached (raw units).
+ * @param deposit - Attached deposit in yoctoNEAR.
+ */
+export function functionCall(methodName, args, gas, deposit) {
+    return {
+        functionCall: { methodName, args, gas, deposit },
+    };
+}
+/**
+ * Create an account creation action.
+ */
+export function createAccount() {
+    return {
+        createAccount: {},
+    };
+}
+/**
+ * Create a delete account action.
+ */
+export function deleteAccount(beneficiaryId) {
+    return {
+        deleteAccount: { beneficiaryId },
+    };
+}
+/**
+ * Create a deploy contract action.
+ *
+ * @param code - WASM bytes of the contract to deploy.
+ */
+export function deployContract(code) {
+    return {
+        deployContract: { code },
+    };
+}
+export function stake(amount, publicKey) {
+    return {
+        stake: {
+            stake: amount,
+            publicKey: publicKeyToZorsh(publicKey),
+        },
+    };
+}
+export function addKey(publicKey, permission) {
+    return {
+        addKey: {
+            publicKey: publicKeyToZorsh(publicKey),
+            accessKey: { nonce: BigInt(0), permission },
+        },
+    };
+}
+export function deleteKey(publicKey) {
+    return {
+        deleteKey: {
+            publicKey: publicKeyToZorsh(publicKey),
+        },
+    };
+}
+/**
+ * Publish a global contract that can be reused by multiple accounts
+ *
+ * @param code - The compiled contract code bytes
+ * @param accountId - Optional account ID. If provided, creates a mutable contract (can be updated).
+ *                    If omitted, creates an immutable contract (identified by code hash).
+ * @returns DeployGlobalContractAction
+ *
+ * @example
+ * ```typescript
+ * // Publish immutable contract (identified by code hash)
+ * publishContract(contractCode)
+ *
+ * // Publish mutable contract (identified by account, can be updated)
+ * publishContract(contractCode, "my-publisher.near")
+ * ```
+ */
+export function publishContract(code, accountId) {
+    const deployMode = accountId ? { AccountId: {} } : { CodeHash: {} };
+    return {
+        deployGlobalContract: {
+            code,
+            deployMode,
+        },
+    };
+}
+/**
+ * Deploy a contract to this account from previously published code in the global registry
+ *
+ * @param reference - Reference to the published contract, either:
+ *                    - { codeHash: Uint8Array | string } - Reference by code hash (Uint8Array or base58 string)
+ *                    - { accountId: string } - Reference by the account that published it
+ * @returns UseGlobalContractAction
+ *
+ * @example
+ * ```typescript
+ * // Deploy from code hash (Uint8Array)
+ * deployFromPublished({ codeHash: hashBytes })
+ *
+ * // Deploy from code hash (base58 string)
+ * deployFromPublished({ codeHash: "5FzD8..." })
+ *
+ * // Deploy from account ID
+ * deployFromPublished({ accountId: "contract-publisher.near" })
+ * ```
+ */
+export function deployFromPublished(reference) {
+    let contractIdentifier;
+    if ("accountId" in reference) {
+        contractIdentifier = { AccountId: reference.accountId };
+    }
+    else {
+        // Handle codeHash - could be string (base58) or Uint8Array
+        const hashBytes = typeof reference.codeHash === "string"
+            ? base58.decode(reference.codeHash)
+            : reference.codeHash;
+        // Validate hash is 32 bytes
+        if (hashBytes.length !== 32) {
+            throw new Error(`Code hash must be 32 bytes, got ${hashBytes.length} bytes`);
+        }
+        contractIdentifier = { CodeHash: Array.from(hashBytes) };
+    }
+    return {
+        useGlobalContract: {
+            contractIdentifier,
+        },
+    };
+}
+/**
+ * Create a signed delegate action for meta-transactions
+ */
+export function signedDelegate(delegateAction, signature) {
+    return {
+        signedDelegate: {
+            delegateAction: {
+                senderId: delegateAction.senderId,
+                receiverId: delegateAction.receiverId,
+                actions: delegateAction.actions,
+                nonce: delegateAction.nonce,
+                maxBlockHeight: delegateAction.maxBlockHeight,
+                publicKey: publicKeyToZorsh(delegateAction.publicKey),
+            },
+            signature: signatureToZorsh(signature),
+        },
+    };
+}
+//# sourceMappingURL=actions.js.map

package/dist/core/actions.js.map

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

package/dist/core/config-schemas.d.ts

@@ -0,0 +1,179 @@
+/**
+ * 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 { type PrivateKey } from "../utils/validation.js";
+/**
+ * Schema for network presets (mainnet, testnet, localnet)
+ */
+export declare const NetworkPresetSchema: z.ZodEnum<{
+    mainnet: "mainnet";
+    testnet: "testnet";
+    localnet: "localnet";
+}>;
+/**
+ * Schema for custom network configuration
+ */
+export declare const CustomNetworkConfigSchema: z.ZodObject<{
+    rpcUrl: z.ZodString;
+    networkId: z.ZodString;
+    nodeUrl: z.ZodOptional<z.ZodString>;
+    walletUrl: z.ZodOptional<z.ZodString>;
+    helperUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for network configuration (preset or custom)
+ */
+export declare const NetworkConfigSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    mainnet: "mainnet";
+    testnet: "testnet";
+    localnet: "localnet";
+}>, z.ZodObject<{
+    rpcUrl: z.ZodString;
+    networkId: z.ZodString;
+    nodeUrl: z.ZodOptional<z.ZodString>;
+    walletUrl: z.ZodOptional<z.ZodString>;
+    helperUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type NetworkPreset = z.infer<typeof NetworkPresetSchema>;
+export type CustomNetworkConfig = z.infer<typeof CustomNetworkConfigSchema>;
+export type NetworkConfig = z.infer<typeof NetworkConfigSchema>;
+/**
+ * Schema for transaction execution status
+ */
+export declare const TxExecutionStatusSchema: z.ZodEnum<{
+    NONE: "NONE";
+    INCLUDED: "INCLUDED";
+    EXECUTED_OPTIMISTIC: "EXECUTED_OPTIMISTIC";
+    INCLUDED_FINAL: "INCLUDED_FINAL";
+    EXECUTED: "EXECUTED";
+    FINAL: "FINAL";
+}>;
+/**
+ * Schema for function call options
+ */
+export declare const CallOptionsSchema: z.ZodObject<{
+    gas: z.ZodOptional<z.ZodString>;
+    attachedDeposit: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBigInt]>>;
+    signerId: z.ZodOptional<z.ZodString>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        NONE: "NONE";
+        INCLUDED: "INCLUDED";
+        EXECUTED_OPTIMISTIC: "EXECUTED_OPTIMISTIC";
+        INCLUDED_FINAL: "INCLUDED_FINAL";
+        EXECUTED: "EXECUTED";
+        FINAL: "FINAL";
+    }>>;
+}, z.core.$strip>;
+export type CallOptions = z.infer<typeof CallOptionsSchema>;
+/**
+ * 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 declare const BlockReferenceSchema: z.ZodObject<{
+    finality: z.ZodOptional<z.ZodEnum<{
+        optimistic: "optimistic";
+        "near-final": "near-final";
+        final: "final";
+    }>>;
+    blockId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+}, z.core.$strip>;
+export type BlockReference = z.infer<typeof BlockReferenceSchema>;
+/**
+ * Schema for key store configuration
+ */
+export declare const KeyStoreConfigSchema: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>, z.ZodAny]>;
+/**
+ * Schema for signer function
+ */
+export declare const SignerSchema: z.ZodAny;
+/**
+ * Schema for RPC retry configuration
+ */
+export declare const RpcRetryConfigSchema: z.ZodObject<{
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    initialDelayMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Inferred type for RPC retry configuration input
+ * Allows partial configuration with optional fields that can be undefined
+ */
+export type RpcRetryConfigInput = z.infer<typeof RpcRetryConfigSchema>;
+/**
+ * Schema for NEAR client configuration
+ */
+export declare const NearConfigSchema: z.ZodObject<{
+    network: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        mainnet: "mainnet";
+        testnet: "testnet";
+        localnet: "localnet";
+    }>, z.ZodObject<{
+        rpcUrl: z.ZodString;
+        networkId: z.ZodString;
+        nodeUrl: z.ZodOptional<z.ZodString>;
+        walletUrl: z.ZodOptional<z.ZodString>;
+        helperUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    rpcUrl: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    keyStore: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>, z.ZodAny]>>;
+    signer: z.ZodOptional<z.ZodAny>;
+    privateKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>]>>;
+    wallet: z.ZodOptional<z.ZodAny>;
+    defaultSignerId: z.ZodOptional<z.ZodString>;
+    defaultWaitUntil: z.ZodOptional<z.ZodEnum<{
+        NONE: "NONE";
+        INCLUDED: "INCLUDED";
+        EXECUTED_OPTIMISTIC: "EXECUTED_OPTIMISTIC";
+        INCLUDED_FINAL: "INCLUDED_FINAL";
+        EXECUTED: "EXECUTED";
+        FINAL: "FINAL";
+    }>>;
+    retryConfig: z.ZodOptional<z.ZodObject<{
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        initialDelayMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type NearConfigBase = z.infer<typeof NearConfigSchema>;
+export type NearConfig = Omit<NearConfigBase, "privateKey"> & {
+    privateKey?: PrivateKey | Uint8Array;
+};
+/**
+ * Resolve network configuration with validation
+ */
+export declare function resolveNetworkConfig(network?: NetworkConfig): {
+    rpcUrl: string;
+    networkId: string;
+    walletUrl?: string | undefined;
+    helperUrl?: string | undefined;
+};
+export {};
+//# sourceMappingURL=config-schemas.d.ts.map

package/dist/core/config-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schemas.d.ts","sourceRoot":"","sources":["../../src/core/config-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,wBAAwB,CAAA;AAK1E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;EAA6C,CAAA;AAE7E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;mBAG9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAI/D;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAA;AAIF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;iBAK5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAI3D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,oBAAoB;;;;;;;iBAuB/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAIjE;;GAEG;AACH,eAAO,MAAM,oBAAoB,qFAI/B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;iBAKrB,CAAA;AAEZ;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEtE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW3B,CAAA;AAGF,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AACtD,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG;IAC5D,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;CACrC,CAAA;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B,CA0BA"}