near-kit 0.0.0 → 0.1.0

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

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

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

package/dist/wallets/types.js

@@ -0,0 +1,10 @@
+/**
+ * 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
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/wallets/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/wallets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -1,13 +1,84 @@
 {
   "name": "near-kit",
-  "version": "0.0.0",
-  "description": "Experimental NEAR client toolkit. Name reserved; API my change.",
-  "main": "index.js",
+  "version": "0.1.0",
+  "description": "A simple, intuitive TypeScript library for interacting with NEAR Protocol",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./sandbox": {
+      "import": "./dist/sandbox/index.js",
+      "types": "./dist/sandbox/index.d.ts"
+    },
+    "./keys/file": {
+      "import": "./dist/keys/file-keystore.js",
+      "types": "./dist/keys/file-keystore.d.ts"
+    },
+    "./keys/native": {
+      "import": "./dist/keys/native-keystore.js",
+      "types": "./dist/keys/native-keystore.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit --project tsconfig.typecheck.json",
+    "prepublishOnly": "bun run build",
+    "release": "bun run build && changeset publish",
+    "lefthook": "lefthook install"
   },
-  "keywords": [],
+  "keywords": [
+    "near",
+    "near-protocol",
+    "blockchain",
+    "typescript",
+    "web3"
+  ],
   "author": "",
-  "license": "ISC",
-  "type": "commonjs"
+  "license": "MIT",
+  "peerDependencies": {
+    "@hot-labs/near-connect": ">=0.6.0",
+    "@near-wallet-selector/core": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@hot-labs/near-connect": {
+      "optional": true
+    },
+    "@near-wallet-selector/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.5",
+    "@changesets/cli": "^2.29.7",
+    "@hot-labs/near-connect": "^0.6.9",
+    "@near-js/transactions": "^2.5.1",
+    "@near-js/types": "^2.5.1",
+    "@near-wallet-selector/core": "^10.1.0",
+    "@types/bun": "^1.3.2",
+    "@types/tar": "^6.1.13",
+    "lefthook": "^2.0.4",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@napi-rs/keyring": "^1.2.0",
+    "@noble/curves": "^2.0.1",
+    "@noble/hashes": "^2.0.1",
+    "@scure/base": "^2.0.0",
+    "@scure/bip32": "^2.0.1",
+    "@scure/bip39": "^2.0.1",
+    "@zorsh/zorsh": "^0.3.3",
+    "tar": "^7.5.2",
+    "zod": "^4.1.12"
+  }
 }

package/index.js

@@ -1 +0,0 @@
-module.exports = {};