@sleet-js/fastintear-custom-client-setup-with-other-custom-functions 0.0.1

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 sleet.near
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# fastintear-custom-client-setup-with-other-custom-functions
+a custom fastintear near client setup and functions for interacting with common smart contracts to assist in dapp development.
+
+ℹ️ expected for use in browser environment
+
+ℹ️ developed for internal use and i don't have time to documnet everything
+
+ℹ️ no error handling
+
+ℹ️ not an exchustive list of functions, but i can add based on request
+
+---
+
+develop and publish this package
+```bash
+bun install
+# bun run index.ts
+bun publish --dry-run
+bunx npm login
+bun publish --access public
+```
+
+---
+
+### FEATURES
+
+- dynamic network support
+- typescript
+- svelte auth and network button
+
+## HOW TO USE
+
+import
+```js
+import { nearClient } from '@sleet-js/fastintear-custom-client-setup-with-other-custom-functions';
+```
+
+
+---
+
+This project was created using `bun init` in bun v1.2.12. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+
+copyright 2025 by sleet.near

package/TODO.md

@@ -0,0 +1,8 @@
+# TO DO
+
+- [ ] add more ref functions
+- [ ] add ft funtions
+
+---
+
+copyright 2025 by sleet.near

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@sleet-js/fastintear-custom-client-setup-with-other-custom-functions",
+  "description": "a custom fastintear near client setup",
+  "version": "0.0.1",
+  "module": "src/index.ts",
+  "homepage": "https://sleet-js.near.page",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sleet-js/fastintear-custom-client-setup-with-other-custom-functions.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@sleet-js/ft-methods-const": "^0.0.5",
+    "@sleet-js/ref-exchange-methods-const": "^0.0.2",
+    "fastintear": "^0.3.8",
+    "svelte": "^5.46.1",
+    "zod": "^4.2.1"
+  }
+}

package/src/createNearClient.ts

@@ -0,0 +1,38 @@
+// src/ts/fastintear/createNearClient.ts
+// This file handles near client setup
+// and has function to getStoredNetworkId
+// ===========================================
+import { createNearClient } from "fastintear";
+import * as near from "fastintear";
+// ===========================================
+// used for network toggle
+export const NETWORK_STORAGE_KEY = "network_id";
+//
+export function getStoredNetworkId(): "mainnet" | "testnet" {
+  const raw = localStorage.getItem(NETWORK_STORAGE_KEY);
+  const value = (raw || "mainnet").trim().toLowerCase();
+  // also global near needs to be configured. easiest to make sure right everytime we need
+  near.config({ networkId: value });
+  return value === "testnet" ? "testnet" : "mainnet";
+}
+// ===========================================
+// Multiple clients with different configurations
+const near_mainnetClient = createNearClient({ networkId: "mainnet" });
+const near_testnetClient = createNearClient({ networkId: "testnet" });
+//
+export function nearClient() {
+  const networkId = getStoredNetworkId();
+  const client =
+    networkId === "testnet" ? near_testnetClient : near_mainnetClient;
+
+  console.log("[nearClient] networkId:", networkId);
+  console.log(
+    "[nearClient] client:",
+    networkId === "testnet" ? "near_testnetClient" : "near_mainnetClient",
+  );
+
+  return client;
+}
+// ================================================
+// ================================================
+// copyright 2025 by sleet.near

package/src/index.ts

@@ -0,0 +1,27 @@
+// nearClient
+export {
+  nearClient,
+  getStoredNetworkId,
+  NETWORK_STORAGE_KEY,
+} from "./createNearClient";
+// network
+export {
+  toggleNetwork,
+  setNetwork_mainnet,
+  setNetwork_testnet,
+} from "./network/index";
+// ref
+export { ref_contractId_for_network } from "./ref/ref_const";
+export {
+  ref_get_number_of_pools_function,
+  ref_get_pool_function,
+  ref_get_pools_function,
+  ref_add_simple_pool_function,
+} from "./ref/ref_functions";
+// other
+export { get_nearClient_accountId } from "./other/accountId"
+export { delete_key_fun, get_key_list_fun } from "./other/keys"
+export type { ACCESS_KEY_INTERFACE } from "./other/key_types"
+// ================================================
+// ================================================
+// copyright 2025 by sleet.near

package/src/network/README.md

@@ -0,0 +1,11 @@
+# network
+
+I wanted network setting to be easy. no reloading.
+
+the client gets the network every time we use it.
+
+and we can set the setwork in a varity of ways, basicly however you want to set the local storge item.
+
+---
+
+copyright 2025 by sleet.near

package/src/network/index.ts

@@ -0,0 +1,21 @@
+import { NETWORK_STORAGE_KEY } from "../createNearClient";
+// ===========================================
+let NETWORK_ID: string;
+//
+export function toggleNetwork() {
+  const savedNetwork = localStorage.getItem(NETWORK_STORAGE_KEY) || "mainnet";
+  NETWORK_ID = savedNetwork;
+  const newNetwork = NETWORK_ID === "mainnet" ? "testnet" : "mainnet";
+  NETWORK_ID = newNetwork;
+  localStorage.setItem(NETWORK_STORAGE_KEY, newNetwork);
+  console.info(newNetwork);
+}
+//
+export function setNetwork_mainnet() {
+  let NETWORK_ID = "mainnet";
+  localStorage.setItem(NETWORK_STORAGE_KEY, NETWORK_ID);
+}
+export function setNetwork_testnet() {
+  let NETWORK_ID = "testnet";
+  localStorage.setItem(NETWORK_STORAGE_KEY, NETWORK_ID);
+}

package/src/other/accountId.ts

@@ -0,0 +1,13 @@
+import { nearClient } from "../createNearClient";
+// ==========================================
+// ==========================================
+// handy when you need a string.
+export function get_nearClient_accountId() {
+  const accountId: string = nearClient().accountId() ?? "";
+  console.log("accountId");
+  console.log(accountId);
+  return typeof accountId === "string" ? accountId : accountId;
+}
+// ================================================
+// ================================================
+// copyright 2025 by sleet.near

package/src/other/key_types.ts

@@ -0,0 +1,24 @@
+// ACCESS_KEY_INTERFACE
+export interface ACCESS_KEY_INTERFACE {
+  access_key: {
+    nonce: number; // large integer; if you need BigInt, change to bigint
+    permission: AccessKeyPermission;
+  };
+  public_key: string; // e.g. "ed25519:..."
+}
+// ===============================================
+// Permission can be either FullAccess or FunctionCall
+type AccessKeyPermission = FullAccessPermission | FunctionCallPermission;
+interface FullAccessPermission {
+  // When it's full access, NEAR returns: { permission: "FullAccess" }
+  // Represented here as a discriminated union
+  FullAccess: Record<string, never>;
+}
+interface FunctionCallPermission {
+  FunctionCall: {
+    // On NEAR RPC these large numeric strings are yoctoNEAR, so keep as string to avoid precision loss
+    allowance?: string; // optional: sometimes not present
+    method_names: string[];
+    receiver_id: string;
+  };
+}

package/src/other/keys.ts

@@ -0,0 +1,30 @@
+import { nearClient } from "../createNearClient";
+import type { ACCESS_KEY_INTERFACE } from "./key_types";
+// ==========================================
+// args list:
+// - publicKey
+// - account_id
+// ==========================================
+// delete_key_fun
+export async function delete_key_fun(accountId: string, publicKey: string) {
+  await nearClient().sendTx({
+    receiverId: accountId,
+    actions: [
+      nearClient().actions.deleteKey({
+        publicKey: publicKey,
+      }),
+    ],
+  });
+}
+// ==========================================
+// get_key_list_fun
+export async function get_key_list_fun(account_id: string) {
+  const response = await nearClient().sendRpc("query", {
+    request_type: "view_access_key_list",
+    account_id,
+    finality: "final",
+  });
+  const keys: ACCESS_KEY_INTERFACE[] = response.result.keys;
+  return keys;
+}
+// ==========================================

package/src/ref/README.md

@@ -0,0 +1,10 @@
+# ref functions
+
+WIP
+
+I have types here as well cause why not.
+
+
+---
+
+copyright 2025 by sleet.near

package/src/ref/ref_const.ts

@@ -0,0 +1,15 @@
+import {
+  ref_mainnet_contractId_const,
+  ref_testnet_contractId_const,
+} from "@sleet-js/ref-exchange-methods-const";
+import { getStoredNetworkId } from "../createNearClient";
+//
+export function ref_contractId_for_network() {
+  const networkId = getStoredNetworkId();
+  const ref_contractId =
+    networkId === "testnet"
+      ? ref_testnet_contractId_const
+      : ref_mainnet_contractId_const;
+  console.log("ref contractId", ref_contractId);
+  return ref_contractId;
+}

package/src/ref/ref_functions.ts

@@ -0,0 +1,79 @@
+// CLEAN REUSABLE FUNCTIONS FOR INTERACTING WITH AND GETTING DATA FROM REF CONTRACT
+// depends on nearClient
+import { nearClient } from "../createNearClient";
+import { ref_exchange_methods_const } from "@sleet-js/ref-exchange-methods-const";
+import { ref_contractId_for_network } from "./ref_const";
+import type { REF_GET_POOL_TYPE } from "./ref_types";
+import {
+  REF_GET_POOL_TYPE_Z_CONST,
+  REF_GET_POOLS_TYPE_Z_CONST,
+} from "./ref_types";
+// ================================================
+interface ref_args_params_interface {
+  pool_id: number;
+  from_index: number;
+  limit: number;
+  fee: number;
+  tokens: string[];
+}
+// ================================================
+// get_number_of_pools_function
+// Fetch the total number of pools
+export async function ref_get_number_of_pools_function(): Promise<number> {
+  const result = await nearClient().view({
+    contractId: ref_contractId_for_network(),
+    methodName: ref_exchange_methods_const.get_number_of_pools,
+    args: {},
+  });
+  return result as number;
+}
+// ================================================
+// get_pool_function
+export async function ref_get_pool_function(
+  pool_id: ref_args_params_interface["pool_id"],
+): Promise<REF_GET_POOL_TYPE> {
+  const result = await nearClient().view({
+    contractId: ref_contractId_for_network(),
+    methodName: ref_exchange_methods_const.get_pool,
+    args: { pool_id: pool_id },
+  });
+
+  return REF_GET_POOL_TYPE_Z_CONST.parse(result);
+}
+// ================================================
+// get_pools_function
+export async function ref_get_pools_function(
+  from_index: ref_args_params_interface["from_index"],
+  limit: ref_args_params_interface["limit"],
+): Promise<REF_GET_POOL_TYPE[]> {
+  const result = await nearClient().view({
+    contractId: ref_contractId_for_network(),
+    methodName: ref_exchange_methods_const.get_pools,
+    args: { from_index, limit },
+  });
+
+  return REF_GET_POOLS_TYPE_Z_CONST.parse(result);
+}
+// ================================================
+// add_simple_pool_function
+export async function ref_add_simple_pool_function(
+  fee: ref_args_params_interface["fee"],
+  tokens: ref_args_params_interface["tokens"],
+) {
+  const result = await nearClient().sendTx({
+    receiverId: ref_contractId_for_network(),
+    actions: [
+      nearClient().actions.functionCall({
+        methodName: ref_exchange_methods_const.add_simple_pool,
+        args: { fee: fee, tokens: tokens },
+        gas: "30000000000000", // 30 TGas
+        deposit: "9000000000000000000000", // 0.009
+      }),
+    ],
+  });
+  console.log(result);
+  return result;
+}
+// ================================================
+// ================================================
+// copyright 2025 by sleet.near

package/src/ref/ref_types.ts

@@ -0,0 +1,22 @@
+import * as z from "zod";
+// ref types
+// ==============================
+// ==============================
+export interface REF_GET_POOL_TYPE {
+  pool_kind: string;
+  token_account_ids: string[];
+  amounts: string[];
+  total_fee: number;
+  shares_total_supply: string;
+  amp: number;
+}
+// ==============================
+export const REF_GET_POOL_TYPE_Z_CONST = z.object({
+  pool_kind: z.string(),
+  token_account_ids: z.array(z.string()),
+  amounts: z.array(z.string()),
+  total_fee: z.number(),
+  shares_total_supply: z.string(),
+  amp: z.number(),
+}) satisfies z.ZodType<REF_GET_POOL_TYPE>;
+export const REF_GET_POOLS_TYPE_Z_CONST = z.array(REF_GET_POOL_TYPE_Z_CONST);

package/src/svelte/button_auth.svelte

@@ -0,0 +1,56 @@
+<!--  -->
+<!-- =========================================== -->
+<!--  -->
+
+<script lang="ts">
+    import { onMount } from "svelte";
+    import { nearClient } from "../createNearClient";
+
+    let isSignedIn: boolean = false;
+    let accountId: string | null = null;
+
+    async function updateAuthStatus() {
+        const status = nearClient().authStatus();
+        isSignedIn = status === "SignedIn";
+        accountId = isSignedIn ? nearClient().accountId() : null;
+    }
+
+    async function handleLogin() {
+        try {
+            await nearClient().requestSignIn();
+            await updateAuthStatus();
+        } catch (error) {
+            console.error("Login failed:", error);
+        }
+    }
+
+    async function handleLogout() {
+        try {
+            await nearClient().signOut();
+            await updateAuthStatus();
+        } catch (error) {
+            console.error("Logout failed:", error);
+        }
+    }
+
+    onMount(async () => {
+        await updateAuthStatus();
+    });
+</script>
+
+<!--  -->
+<!-- =========================================== -->
+<!--  -->
+
+<!-- AUTH_BUTTON -->
+{#if isSignedIn}
+    <button on:click={handleLogout}>
+        LOGOUT {accountId}
+    </button>
+{:else}
+    <button on:click={handleLogin}> LOGIN </button>
+{/if}
+
+<!--  -->
+<!-- =========================================== -->
+<!--  -->

package/src/svelte/button_network_toggle.svelte

@@ -0,0 +1,36 @@
+<!--  -->
+<!-- =========================================== -->
+<!--  -->
+
+<script lang="ts">
+    import { onMount } from "svelte";
+    import { NETWORK_STORAGE_KEY } from "../createNearClient";
+
+    let NETWORK_ID: string = "mainnet";
+
+    onMount(() => {
+        // Initialize network ID from localStorage
+        const savedNetwork = localStorage.getItem("network_id") || "mainnet";
+        NETWORK_ID = savedNetwork;
+    });
+
+    function toggleNetwork() {
+        const newNetwork = NETWORK_ID === "mainnet" ? "testnet" : "mainnet";
+        NETWORK_ID = newNetwork;
+        localStorage.setItem(NETWORK_STORAGE_KEY, newNetwork);
+        console.info(newNetwork);
+    }
+</script>
+
+<!--  -->
+<!-- =========================================== -->
+<!--  -->
+
+<!-- NETWORK_BUTTON -->
+<button on:click={toggleNetwork}>
+    {NETWORK_ID.toUpperCase()}
+</button>
+
+<!--  -->
+<!-- =========================================== -->
+<!--  -->

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  },
+"include": ["src"]
+}