near-kit 0.0.0 → 0.2.0

package/dist/utils/validation.js

@@ -0,0 +1,150 @@
+/**
+ * Zod validation schemas and helpers for NEAR types.
+ *
+ * @remarks
+ * These schemas power runtime validation for account IDs, public/private keys,
+ * amounts, and gas while keeping the developer-facing API ergonomic via
+ * helpers like {@link validateAccountId} and {@link normalizeAmount}.
+ */
+import { z } from "zod";
+import { ACCOUNT_ID_REGEX, ED25519_KEY_PREFIX, MAX_ACCOUNT_ID_LENGTH, MIN_ACCOUNT_ID_LENGTH, SECP256K1_KEY_PREFIX, } from "../core/constants.js";
+import { parseAmount } from "./amount.js";
+import { parseGas } from "./gas.js";
+// ==================== Base58 Validation ====================
+/**
+ * Check if a string is valid base58 encoding.
+ * @internal
+ */
+function isValidBase58(str) {
+    const base58Regex = /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+$/;
+    return base58Regex.test(str);
+}
+// ==================== Account ID Schema ====================
+/**
+ * Schema for validating NEAR account IDs.
+ *
+ * Rules:
+ * - Length: 2-64 characters
+ * - Characters: lowercase alphanumeric, hyphens, underscores, and dots
+ * - Pattern: subdomain-like structure (e.g., alice.near, contract.mainnet)
+ */
+export const AccountIdSchema = z
+    .string()
+    .min(MIN_ACCOUNT_ID_LENGTH, `Account ID must be at least ${MIN_ACCOUNT_ID_LENGTH} characters`)
+    .max(MAX_ACCOUNT_ID_LENGTH, `Account ID must be at most ${MAX_ACCOUNT_ID_LENGTH} characters`)
+    .regex(ACCOUNT_ID_REGEX, "Account ID must contain only lowercase alphanumeric characters, hyphens, underscores, and dots");
+// ==================== Public Key Schema ====================
+/**
+ * Schema for validating NEAR public keys.
+ *
+ * Supports:
+ * - Ed25519: "ed25519:..." (base58 encoded)
+ * - Secp256k1: "secp256k1:..." (base58 encoded)
+ */
+export const PublicKeySchema = z
+    .string()
+    .refine((key) => key.startsWith(ED25519_KEY_PREFIX) ||
+    key.startsWith(SECP256K1_KEY_PREFIX), "Public key must start with 'ed25519:' or 'secp256k1:'")
+    .refine((key) => {
+    const keyData = key.startsWith(ED25519_KEY_PREFIX)
+        ? key.slice(ED25519_KEY_PREFIX.length)
+        : key.slice(SECP256K1_KEY_PREFIX.length);
+    return isValidBase58(keyData);
+}, "Public key must be valid base58 encoding");
+/**
+ * Schema for validating NEAR private keys.
+ *
+ * Supports:
+ * - Ed25519: "ed25519:..." (base58 encoded, 64 bytes)
+ * - Secp256k1: "secp256k1:..." (base58 encoded, 96 bytes)
+ */
+export const PrivateKeySchema = z
+    .string()
+    .refine((key) => key.startsWith(ED25519_KEY_PREFIX) ||
+    key.startsWith(SECP256K1_KEY_PREFIX), "Private key must start with 'ed25519:' or 'secp256k1:'")
+    .refine((key) => {
+    const keyData = key.startsWith(ED25519_KEY_PREFIX)
+        ? key.slice(ED25519_KEY_PREFIX.length)
+        : key.slice(SECP256K1_KEY_PREFIX.length);
+    return keyData.length > 0 && isValidBase58(keyData);
+}, "Private key must be valid base58 encoding");
+// ==================== Amount Schema ====================
+/**
+ * Schema for NEAR amounts with explicit units.
+ *
+ * Accepts:
+ * - String with unit: "10 NEAR", "1000000 yocto"
+ * - Created via Amount.NEAR(10) or Amount.yocto(1000000n)
+ * - Raw bigint: 1000000n (treated as yoctoNEAR)
+ *
+ * Rejects bare numbers to prevent unit confusion.
+ * Normalizes to yoctoNEAR string.
+ */
+export const AmountSchema = z
+    .union([z.string(), z.bigint()])
+    .transform((amount) => {
+    return parseAmount(amount);
+});
+// ==================== Gas Schema ====================
+/**
+ * Schema for gas amounts.
+ *
+ * Accepts:
+ * - String with unit: "30 Tgas", Gas.Tgas(30)
+ * - Raw gas number strings for advanced use
+ *
+ * Normalizes to raw gas string.
+ */
+export const GasSchema = z.string().transform((gas) => {
+    return parseGas(gas);
+});
+// ==================== Helper Functions ====================
+/**
+ * Validate account ID (throws on invalid).
+ */
+export function validateAccountId(accountId) {
+    return AccountIdSchema.parse(accountId);
+}
+/**
+ * Check if account ID is valid (boolean).
+ */
+export function isValidAccountId(accountId) {
+    return AccountIdSchema.safeParse(accountId).success;
+}
+/**
+ * Validate public key (throws on invalid).
+ */
+export function validatePublicKey(key) {
+    return PublicKeySchema.parse(key);
+}
+/**
+ * Check if public key is valid (boolean).
+ */
+export function isValidPublicKey(key) {
+    return PublicKeySchema.safeParse(key).success;
+}
+/**
+ * Validate private key (throws on invalid).
+ */
+export function validatePrivateKey(key) {
+    return PrivateKeySchema.parse(key);
+}
+/**
+ * Check if private key is valid (boolean).
+ */
+export function isPrivateKey(key) {
+    return PrivateKeySchema.safeParse(key).success;
+}
+/**
+ * Normalize amount to yoctoNEAR string.
+ */
+export function normalizeAmount(amount) {
+    return AmountSchema.parse(amount);
+}
+/**
+ * Normalize gas to gas string.
+ */
+export function normalizeGas(gas) {
+    return GasSchema.parse(gas);
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,8DAA8D;AAE9D;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,WAAW,GACf,iEAAiE,CAAA;IACnE,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED,8DAA8D;AAE9D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,GAAG,CACF,qBAAqB,EACrB,+BAA+B,qBAAqB,aAAa,CAClE;KACA,GAAG,CACF,qBAAqB,EACrB,8BAA8B,qBAAqB,aAAa,CACjE;KACA,KAAK,CACJ,gBAAgB,EAChB,gGAAgG,CACjG,CAAA;AAIH,8DAA8D;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,MAAM,CACL,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;IAClC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,EACtC,uDAAuD,CACxD;KACA,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;IACd,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAChD,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC;QACtC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC,EAAE,0CAA0C,CAAC,CAAA;AA2BhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,MAAM,CACL,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;IAClC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,EACtC,wDAAwD,CACzD;KACA,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;IACd,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAChD,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC;QACtC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAA;AACrD,CAAC,EAAE,2CAA2C,CAAC,CAAA;AAIjD,0DAA0D;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KAC/B,SAAS,CAAC,CAAC,MAAM,EAAU,EAAE;IAC5B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;AAC5B,CAAC,CAAC,CAAA;AAIJ,uDAAuD;AAEvD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAU,EAAE;IAC5D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA;AAIF,6DAA6D;AAE7D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,CAAA;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC"}

package/dist/wallets/adapters.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Wallet adapters for NEAR wallet integrations.
+ *
+ * Provides adapter functions to integrate with popular NEAR wallets:
+ * - `@near-wallet-selector/core`
+ * - `@hot-labs/near-connect`
+ *
+ * These adapters use duck typing / structural compatibility to work with
+ * wallet interfaces. While the actual wallet packages use `@near-js` types
+ * (which are classes), our types (plain objects) are structurally compatible
+ * and work correctly at runtime. See `tests/wallets/type-compatibility.test.ts`
+ * for verification.
+ */
+import type { WalletConnection } from "../core/types.js";
+import type { HotConnectConnector } from "./types.js";
+type WalletSelectorWallet = {
+    getAccounts(): Promise<Array<{
+        accountId: string;
+        publicKey?: string;
+    }>>;
+    signAndSendTransaction(params: {
+        signerId?: string;
+        receiverId?: string;
+        actions: unknown[];
+    }): Promise<unknown>;
+    signMessage?(params: {
+        message: string;
+        recipient: string;
+        nonce: Buffer;
+        callbackUrl?: string;
+        state?: string;
+    }): Promise<unknown>;
+};
+/**
+ * Adapter for @near-wallet-selector/core
+ *
+ * Converts a wallet-selector Wallet instance to the WalletConnection interface.
+ *
+ * @param wallet - Wallet instance from wallet-selector
+ * @returns WalletConnection interface compatible with near-ts
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-ts'
+ * import { setupWalletSelector } from '@near-wallet-selector/core'
+ * import { fromWalletSelector } from 'near-ts/wallets'
+ *
+ * const selector = await setupWalletSelector({
+ *   network: 'mainnet',
+ *   modules: [...]
+ * })
+ * const wallet = await selector.wallet()
+ *
+ * const near = new Near({
+ *   network: 'mainnet',
+ *   wallet: fromWalletSelector(wallet)
+ * })
+ * ```
+ */
+export declare function fromWalletSelector(wallet: WalletSelectorWallet): WalletConnection;
+/**
+ * Adapter for @hot-labs/near-connect (HOT Connect)
+ *
+ * Converts a HOT Connect NearConnector instance to the WalletConnection interface.
+ *
+ * @param connector - NearConnector instance from HOT Connect
+ * @returns WalletConnection interface compatible with near-ts
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-ts'
+ * import { NearConnector } from '@hot-labs/near-connect'
+ * import { fromHotConnect } from 'near-ts/wallets'
+ *
+ * const connector = new NearConnector({ network: 'mainnet' })
+ *
+ * // Wait for user to connect their wallet
+ * connector.on('wallet:signIn', async () => {
+ *   const near = new Near({
+ *     network: 'mainnet',
+ *     wallet: fromHotConnect(connector)
+ *   })
+ *
+ *   // Use near-ts with the connected wallet
+ *   await near.call('contract.near', 'method', { arg: 'value' })
+ * })
+ * ```
+ */
+/**
+ * Adapter for @hot-labs/near-connect (HOT Connect)
+ *
+ * Converts a HOT Connect NearConnector instance to the WalletConnection interface.
+ *
+ * @param connector - NearConnector instance from HOT Connect
+ * @returns WalletConnection interface compatible with near-kit
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-kit'
+ * import { NearConnector } from '@hot-labs/near-connect'
+ * import { fromHotConnect } from 'near-kit/wallets'
+ *
+ * const connector = new NearConnector({ network: 'mainnet' })
+ *
+ * // Wait for user to connect their wallet
+ * connector.on('wallet:signIn', async () => {
+ *   const near = new Near({
+ *     network: 'mainnet',
+ *     wallet: fromHotConnect(connector)
+ *   })
+ *
+ *   // Use near-kit with the connected wallet
+ *   await near.call('contract.near', 'method', { arg: 'value' })
+ * })
+ * ```
+ */
+export declare function fromHotConnect(connector: HotConnectConnector): WalletConnection;
+export {};
+//# sourceMappingURL=adapters.d.ts.map

package/dist/wallets/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/wallets/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAIV,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAQnB,KAAK,oBAAoB,GAAG;IAC1B,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IACxE,sBAAsB,CAAC,MAAM,EAAE;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,OAAO,EAAE,CAAA;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpB,WAAW,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,oBAAoB,GAC3B,gBAAgB,CA8ClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,mBAAmB,GAC7B,gBAAgB,CAqKlB"}

package/dist/wallets/adapters.js

@@ -0,0 +1,267 @@
+/**
+ * Wallet adapters for NEAR wallet integrations.
+ *
+ * Provides adapter functions to integrate with popular NEAR wallets:
+ * - `@near-wallet-selector/core`
+ * - `@hot-labs/near-connect`
+ *
+ * These adapters use duck typing / structural compatibility to work with
+ * wallet interfaces. While the actual wallet packages use `@near-js` types
+ * (which are classes), our types (plain objects) are structurally compatible
+ * and work correctly at runtime. See `tests/wallets/type-compatibility.test.ts`
+ * for verification.
+ */
+/**
+ * Adapter for @near-wallet-selector/core
+ *
+ * Converts a wallet-selector Wallet instance to the WalletConnection interface.
+ *
+ * @param wallet - Wallet instance from wallet-selector
+ * @returns WalletConnection interface compatible with near-ts
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-ts'
+ * import { setupWalletSelector } from '@near-wallet-selector/core'
+ * import { fromWalletSelector } from 'near-ts/wallets'
+ *
+ * const selector = await setupWalletSelector({
+ *   network: 'mainnet',
+ *   modules: [...]
+ * })
+ * const wallet = await selector.wallet()
+ *
+ * const near = new Near({
+ *   network: 'mainnet',
+ *   wallet: fromWalletSelector(wallet)
+ * })
+ * ```
+ */
+export function fromWalletSelector(wallet) {
+    return {
+        async getAccounts() {
+            const accounts = await wallet.getAccounts();
+            return accounts.map((acc) => ({
+                accountId: acc.accountId,
+                ...(acc.publicKey !== undefined && { publicKey: acc.publicKey }),
+            }));
+        },
+        async signAndSendTransaction(params) {
+            // Our Action[] type is structurally compatible with @near-js Action[]
+            // Duck typing works at runtime - see type-compatibility.test.ts
+            const result = await wallet.signAndSendTransaction({
+                ...(params.signerId !== undefined && { signerId: params.signerId }),
+                receiverId: params.receiverId,
+                actions: params.actions,
+            });
+            if (!result) {
+                throw new Error("Wallet did not return transaction outcome");
+            }
+            return result;
+        },
+        async signMessage(params) {
+            if (!wallet.signMessage) {
+                throw new Error("Wallet does not support message signing");
+            }
+            // wallet-selector expects Buffer, convert from Uint8Array
+            const nonce = Buffer.from(params.nonce);
+            const result = await wallet.signMessage({
+                message: params.message,
+                recipient: params.recipient,
+                nonce,
+            });
+            // Browser wallets may return void
+            if (!result) {
+                throw new Error("Wallet did not return signed message");
+            }
+            return result;
+        },
+    };
+}
+/**
+ * Adapter for @hot-labs/near-connect (HOT Connect)
+ *
+ * Converts a HOT Connect NearConnector instance to the WalletConnection interface.
+ *
+ * @param connector - NearConnector instance from HOT Connect
+ * @returns WalletConnection interface compatible with near-ts
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-ts'
+ * import { NearConnector } from '@hot-labs/near-connect'
+ * import { fromHotConnect } from 'near-ts/wallets'
+ *
+ * const connector = new NearConnector({ network: 'mainnet' })
+ *
+ * // Wait for user to connect their wallet
+ * connector.on('wallet:signIn', async () => {
+ *   const near = new Near({
+ *     network: 'mainnet',
+ *     wallet: fromHotConnect(connector)
+ *   })
+ *
+ *   // Use near-ts with the connected wallet
+ *   await near.call('contract.near', 'method', { arg: 'value' })
+ * })
+ * ```
+ */
+/**
+ * Adapter for @hot-labs/near-connect (HOT Connect)
+ *
+ * Converts a HOT Connect NearConnector instance to the WalletConnection interface.
+ *
+ * @param connector - NearConnector instance from HOT Connect
+ * @returns WalletConnection interface compatible with near-kit
+ *
+ * @example
+ * ```typescript
+ * import { Near } from 'near-kit'
+ * import { NearConnector } from '@hot-labs/near-connect'
+ * import { fromHotConnect } from 'near-kit/wallets'
+ *
+ * const connector = new NearConnector({ network: 'mainnet' })
+ *
+ * // Wait for user to connect their wallet
+ * connector.on('wallet:signIn', async () => {
+ *   const near = new Near({
+ *     network: 'mainnet',
+ *     wallet: fromHotConnect(connector)
+ *   })
+ *
+ *   // Use near-kit with the connected wallet
+ *   await near.call('contract.near', 'method', { arg: 'value' })
+ * })
+ * ```
+ */
+export function fromHotConnect(connector) {
+    // Validate that we have a proper connector
+    if (!connector || typeof connector.wallet !== "function") {
+        throw new Error("Invalid HOT Connect instance. Make sure @hot-labs/near-connect is installed and you're passing a NearConnector instance.");
+    }
+    return {
+        async getAccounts() {
+            const wallet = await connector.wallet();
+            const accounts = await wallet.getAccounts();
+            return accounts.map((acc) => ({
+                accountId: acc.accountId,
+                publicKey: acc.publicKey,
+            }));
+        },
+        async signAndSendTransaction(params) {
+            const wallet = await connector.wallet();
+            const convertAction = (action) => {
+                const a = action;
+                if ("functionCall" in a && a["functionCall"]) {
+                    const fc = a["functionCall"];
+                    let args = fc.args;
+                    if (Array.isArray(args) &&
+                        args.every((x) => typeof x === "number")) {
+                        try {
+                            const argsString = new TextDecoder().decode(new Uint8Array(args));
+                            args = JSON.parse(argsString);
+                        }
+                        catch {
+                            // If parsing fails, keep args as raw bytes (may be binary data)
+                        }
+                    }
+                    const argsObject = args && typeof args === "object" && !Array.isArray(args)
+                        ? args
+                        : {};
+                    return {
+                        type: "FunctionCall",
+                        params: {
+                            methodName: fc.methodName,
+                            args: argsObject,
+                            gas: fc.gas.toString(),
+                            deposit: fc.deposit.toString(),
+                        },
+                    };
+                }
+                if ("transfer" in a && a["transfer"]) {
+                    const t = a["transfer"];
+                    return {
+                        type: "Transfer",
+                        params: { deposit: t.deposit.toString() },
+                    };
+                }
+                if ("stake" in a && a["stake"]) {
+                    const s = a["stake"];
+                    return {
+                        type: "Stake",
+                        params: {
+                            stake: s.stake.toString(),
+                            // HOT Connect expects a base58 string; we forward whatever representation
+                            // we have and rely on upstream tooling when stake is used with wallets.
+                            publicKey: String(s.publicKey),
+                        },
+                    };
+                }
+                if ("addKey" in a && a["addKey"]) {
+                    const ak = a["addKey"];
+                    return {
+                        type: "AddKey",
+                        params: {
+                            publicKey: String(ak.publicKey),
+                            accessKey: {
+                                nonce: Number(ak.accessKey.nonce),
+                                permission: ak.accessKey
+                                    .permission,
+                            },
+                        },
+                    };
+                }
+                if ("deleteKey" in a && a["deleteKey"]) {
+                    const dk = a["deleteKey"];
+                    return {
+                        type: "DeleteKey",
+                        params: {
+                            publicKey: String(dk.publicKey),
+                        },
+                    };
+                }
+                if ("deleteAccount" in a && a["deleteAccount"]) {
+                    const da = a["deleteAccount"];
+                    return {
+                        type: "DeleteAccount",
+                        params: {
+                            beneficiaryId: da.beneficiaryId,
+                        },
+                    };
+                }
+                if ("createAccount" in a && a["createAccount"] !== undefined) {
+                    return {
+                        type: "CreateAccount",
+                    };
+                }
+                if ("deployContract" in a && a["deployContract"]) {
+                    const dc = a["deployContract"];
+                    return {
+                        type: "DeployContract",
+                        params: {
+                            code: dc.code,
+                        },
+                    };
+                }
+                throw new Error(`Unsupported action type: ${Object.keys(a).join(", ") || "unknown"}`);
+            };
+            const hotConnectorActions = params.actions.map(convertAction);
+            const result = await wallet.signAndSendTransaction({
+                ...(params.signerId !== undefined && { signerId: params.signerId }),
+                receiverId: params.receiverId,
+                actions: hotConnectorActions,
+            });
+            return result;
+        },
+        async signMessage(params) {
+            const wallet = await connector.wallet();
+            const result = await wallet.signMessage({
+                message: params.message,
+                recipient: params.recipient,
+                nonce: params.nonce,
+            });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/wallets/adapters.js.map

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

package/dist/wallets/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wallet integration adapters for NEAR.
+ *
+ * @remarks
+ * Re-exports the {@link WalletConnection} interface and concrete adapters
+ * {@link fromWalletSelector} and {@link fromHotConnect} for integrating with
+ * common NEAR wallet libraries.
+ */
+export type { WalletConnection } from "../core/types.js";
+export { fromHotConnect, fromWalletSelector } from "./adapters.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wallets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/wallets/index.js

@@ -0,0 +1,2 @@
+export { fromHotConnect, fromWalletSelector } from "./adapters.js";
+//# sourceMappingURL=index.js.map

package/dist/wallets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wallets/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/wallets/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Internal wallet type helpers for near-kit.
+ *
+ * Defines lightweight structural types for external wallet libraries
+ * (e.g. HOT Connect) without taking a hard dependency on their packages.
+ *
+ * @internal
+ */
+import type { FinalExecutionOutcome, SignedMessage } from "../core/types.js";
+/**
+ * HOT Connect action types, mirroring `@hot-labs/near-connect`'s
+ * `types/transactions.ts` definitions.
+ */
+export type HotConnectCreateAccountAction = {
+    type: "CreateAccount";
+};
+export type HotConnectDeployContractAction = {
+    type: "DeployContract";
+    params: {
+        code: Uint8Array;
+    };
+};
+export type HotConnectFunctionCallAction = {
+    type: "FunctionCall";
+    params: {
+        methodName: string;
+        args: Record<string, unknown>;
+        gas: string;
+        deposit: string;
+    };
+};
+export type HotConnectTransferAction = {
+    type: "Transfer";
+    params: {
+        deposit: string;
+    };
+};
+export type HotConnectStakeAction = {
+    type: "Stake";
+    params: {
+        stake: string;
+        publicKey: string;
+    };
+};
+export type HotConnectAddKeyPermission = "FullAccess" | {
+    receiverId: string;
+    allowance?: string;
+    methodNames?: string[];
+};
+export type HotConnectAddKeyAction = {
+    type: "AddKey";
+    params: {
+        publicKey: string;
+        accessKey: {
+            nonce?: number;
+            permission: HotConnectAddKeyPermission;
+        };
+    };
+};
+export type HotConnectDeleteKeyAction = {
+    type: "DeleteKey";
+    params: {
+        publicKey: string;
+    };
+};
+export type HotConnectDeleteAccountAction = {
+    type: "DeleteAccount";
+    params: {
+        beneficiaryId: string;
+    };
+};
+export type HotConnectAction = HotConnectCreateAccountAction | HotConnectDeployContractAction | HotConnectFunctionCallAction | HotConnectTransferAction | HotConnectStakeAction | HotConnectAddKeyAction | HotConnectDeleteKeyAction | HotConnectDeleteAccountAction;
+/**
+ * HOT Connect wallet + connector interfaces (structural).
+ */
+export type HotConnectWallet = {
+    getAccounts(data?: {
+        network?: string;
+    }): Promise<Array<{
+        accountId: string;
+        publicKey: string;
+    }>>;
+    signAndSendTransaction(params: {
+        signerId?: string;
+        receiverId: string;
+        actions: HotConnectAction[];
+        network?: string;
+    }): Promise<FinalExecutionOutcome>;
+    signMessage(params: {
+        message: string;
+        recipient: string;
+        nonce: Uint8Array;
+        network?: string;
+    }): Promise<SignedMessage>;
+};
+export type HotConnectConnector = {
+    wallet(): Promise<HotConnectWallet>;
+};
+//# sourceMappingURL=types.d.ts.map