lampamazaza-new-internal-utils 0.24.3

package/dist/poaBridge/poaBridgeHttpClient/runtime.js

@@ -0,0 +1,47 @@
+import { config } from "../../config.js";
+import { request } from "../../utils/request.js";
+import { handleRPCResponse } from "../../utils/handleRPCResponse.js";
+import { RETRY_CONFIGS } from "../../utils/retry.js";
+import * as v from "valibot";
+
+//#region src/poaBridge/poaBridgeHttpClient/runtime.ts
+const rpcResponseSchema = v.union([v.object({
+	jsonrpc: v.literal("2.0"),
+	id: v.string(),
+	result: v.unknown()
+}), v.object({
+	jsonrpc: v.literal("2.0"),
+	id: v.string(),
+	error: v.pipe(v.string(), v.transform((v$1) => {
+		return {
+			code: -1,
+			data: null,
+			message: v$1
+		};
+	}))
+})]);
+async function jsonRPCRequest(method, params, config$1) {
+	const baseURL = config$1?.baseURL ?? config.env.poaBridgeBaseURL;
+	const url = new URL("rpc", baseURL);
+	url.searchParams.set("method", String(method));
+	const body = {
+		id: config$1?.requestId ?? "dontcare",
+		jsonrpc: "2.0",
+		method,
+		params: params !== void 0 ? [params] : void 0
+	};
+	return handleRPCResponse(await request({
+		url,
+		body,
+		...config$1,
+		fetchOptions: {
+			...config$1?.fetchOptions,
+			method: "POST"
+		},
+		retryOptions: config$1?.retryOptions ?? RETRY_CONFIGS.THIRTY_SECS_AGGRESSIVE,
+		logger: config$1?.logger
+	}), body, rpcResponseSchema);
+}
+
+//#endregion
+export { jsonRPCRequest };

package/dist/poaBridge/poaBridgeHttpClient/types.d.cts

@@ -0,0 +1,161 @@
+import { RpcRequestError } from "../../errors/request.cjs";
+import { ILogger } from "../../logger.cjs";
+import { BaseTokenInfo } from "../../types/base.cjs";
+import { RetryOptions } from "../../utils/retry.cjs";
+import { RequestErrorType } from "../../utils/request.cjs";
+import { BlockchainEnum } from "../constants/blockchains.cjs";
+
+//#region src/poaBridge/poaBridgeHttpClient/types.d.ts
+type RequestConfig = {
+  requestId?: string | undefined;
+  timeout?: number | undefined;
+  fetchOptions?: Omit<RequestInit, "body"> | undefined;
+  baseURL?: string | undefined;
+  retryOptions?: RetryOptions;
+  logger?: ILogger;
+};
+type JSONRPCRequest<Method, Params> = {
+  id: string;
+  jsonrpc: "2.0";
+  method: Method;
+  params: Params[];
+};
+type JSONRPCResponse<Result> = {
+  id: string;
+  jsonrpc: "2.0";
+  result: Result;
+};
+type JSONRPCErrorType = RequestErrorType | RpcRequestError;
+type GetSupportedTokensRequest = JSONRPCRequest<"supported_tokens", {
+  chains?: string[];
+}>;
+type GetSupportedTokensResponse = JSONRPCResponse<{
+  tokens: {
+    /**
+     * Raw asset id.
+     * Example: "nep245:v2_1.omni.hot.tg:1117_3tsdfyziyc7EJbP2aULWSKU4toBaAcN4FdTgfm5W1mC4ouR"
+     */
+    intents_token_id: string;
+    /**
+     * Token standard extracted from intents_token_id (the part before the first colon).
+     * In most cases it is either "nep245" or "nep141"
+     */
+    standard: string;
+    /**
+     * Contract ID extracted from intents_token_id (the part between the first and second colon).
+     * Example: "v2_1.omni.hot.tg"
+     */
+    near_token_id: string;
+    /**
+     * Token ID extracted from intents_token_id (the part after the second colon).
+     * Only present for "nep245" standard tokens.
+     * Example: "1117_3tsdfyziyc7EJbP2aULWSKU4toBaAcN4FdTgfm5W1mC4ouR"
+     */
+    multi_token_id?: string;
+    /**
+     * Symbol
+     */
+    asset_name: string;
+    decimals: number;
+    min_deposit_amount: string;
+    min_withdrawal_amount: string;
+    withdrawal_fee: string;
+    /**
+     * Internal POA Bridge identifier.
+     * @deprecated This identifier is for internal use only and should not be used in client code.
+     * @internal
+     */
+    defuse_asset_identifier: string;
+  }[];
+}>;
+type DepositNetworkMemo = {
+  deposit_mode: "MEMO";
+} | null;
+type GetDepositAddressRequest = JSONRPCRequest<"deposit_address", {
+  account_id: string;
+  /** Chain is joined blockchain and network (e.g. eth:8453) */
+  chain: string;
+  /** Stellar blockchain specific */
+  deposit_mode?: "MEMO" | "SIMPLE";
+}>;
+type GetDepositAddressResponse = JSONRPCResponse<{
+  address: string;
+  chain: string;
+  /** Stellar blockchain specific */
+  memo?: string;
+}>;
+type DepositStatus = {
+  tx_hash: string;
+  chain: string;
+  defuse_asset_identifier: string;
+  near_token_id: string;
+  decimals: number;
+  amount: number;
+  account_id: string;
+  address: string;
+  status: "COMPLETED" | "PENDING" | "FAILED";
+};
+type GetDepositStatusRequest = JSONRPCRequest<"recent_deposits", {
+  account_id: string;
+  chain?: string;
+}>;
+type GetDepositStatusResponse = JSONRPCResponse<{
+  deposits: DepositStatus[];
+}>;
+type WithdrawalStatusRequest = JSONRPCRequest<"withdrawal_status", {
+  withdrawal_hash: string;
+}>;
+type WithdrawalStatusResponseOk = JSONRPCResponse<{
+  withdrawals: {
+    status: "COMPLETED" | "PENDING";
+    data: {
+      tx_hash: string;
+      transfer_tx_hash: string | null;
+      chain: string;
+      defuse_asset_identifier: string;
+      near_token_id: string;
+      decimals: number;
+      amount: number;
+      account_id: string;
+      address: string;
+      created: string;
+    };
+  }[];
+}>;
+type HotOmniWithdrawRequest = JSONRPCRequest<"hot_omni_withdraw", {
+  account_id: string;
+  tx_hash: string;
+  receiver: string;
+  chain_id: string;
+}>;
+type HotOmniWithdrawResponse = JSONRPCResponse<{
+  status: "COMPLETED" | "PENDING";
+  data: {
+    transfer_tx_hash: string | null;
+  };
+}[]>;
+type TokenBalances = {
+  symbol: string;
+  address: string;
+  nearAddress: string;
+  decimals: number;
+  totalSupply: string;
+  vaultBalance: string;
+  coldWalletBalance: string;
+  balanceOnDefuse: string;
+};
+type BridgeBalanceResponse = TokenBalances[];
+type GetWithdrawalEstimateRequest = JSONRPCRequest<"withdrawal_estimate", {
+  token: string;
+  address: string;
+  chain: BlockchainEnum;
+}>;
+type WithdrawalEstimateResponse = {
+  token: BaseTokenInfo;
+  tokenAddress: string;
+  userAddress: string;
+  withdrawalFee: string;
+  withdrawalFeeDecimals: number;
+};
+//#endregion
+export { BridgeBalanceResponse, DepositNetworkMemo, DepositStatus, GetDepositAddressRequest, GetDepositAddressResponse, GetDepositStatusRequest, GetDepositStatusResponse, GetSupportedTokensRequest, GetSupportedTokensResponse, GetWithdrawalEstimateRequest, HotOmniWithdrawRequest, HotOmniWithdrawResponse, JSONRPCErrorType, JSONRPCRequest, JSONRPCResponse, RequestConfig, TokenBalances, WithdrawalEstimateResponse, WithdrawalStatusRequest, WithdrawalStatusResponseOk };

package/dist/poaBridge/poaBridgeHttpClient/types.d.ts

@@ -0,0 +1,161 @@
+import { RpcRequestError } from "../../errors/request.js";
+import { ILogger } from "../../logger.js";
+import { BaseTokenInfo } from "../../types/base.js";
+import { RetryOptions } from "../../utils/retry.js";
+import { RequestErrorType } from "../../utils/request.js";
+import { BlockchainEnum } from "../constants/blockchains.js";
+
+//#region src/poaBridge/poaBridgeHttpClient/types.d.ts
+type RequestConfig = {
+  requestId?: string | undefined;
+  timeout?: number | undefined;
+  fetchOptions?: Omit<RequestInit, "body"> | undefined;
+  baseURL?: string | undefined;
+  retryOptions?: RetryOptions;
+  logger?: ILogger;
+};
+type JSONRPCRequest<Method, Params> = {
+  id: string;
+  jsonrpc: "2.0";
+  method: Method;
+  params: Params[];
+};
+type JSONRPCResponse<Result> = {
+  id: string;
+  jsonrpc: "2.0";
+  result: Result;
+};
+type JSONRPCErrorType = RequestErrorType | RpcRequestError;
+type GetSupportedTokensRequest = JSONRPCRequest<"supported_tokens", {
+  chains?: string[];
+}>;
+type GetSupportedTokensResponse = JSONRPCResponse<{
+  tokens: {
+    /**
+     * Raw asset id.
+     * Example: "nep245:v2_1.omni.hot.tg:1117_3tsdfyziyc7EJbP2aULWSKU4toBaAcN4FdTgfm5W1mC4ouR"
+     */
+    intents_token_id: string;
+    /**
+     * Token standard extracted from intents_token_id (the part before the first colon).
+     * In most cases it is either "nep245" or "nep141"
+     */
+    standard: string;
+    /**
+     * Contract ID extracted from intents_token_id (the part between the first and second colon).
+     * Example: "v2_1.omni.hot.tg"
+     */
+    near_token_id: string;
+    /**
+     * Token ID extracted from intents_token_id (the part after the second colon).
+     * Only present for "nep245" standard tokens.
+     * Example: "1117_3tsdfyziyc7EJbP2aULWSKU4toBaAcN4FdTgfm5W1mC4ouR"
+     */
+    multi_token_id?: string;
+    /**
+     * Symbol
+     */
+    asset_name: string;
+    decimals: number;
+    min_deposit_amount: string;
+    min_withdrawal_amount: string;
+    withdrawal_fee: string;
+    /**
+     * Internal POA Bridge identifier.
+     * @deprecated This identifier is for internal use only and should not be used in client code.
+     * @internal
+     */
+    defuse_asset_identifier: string;
+  }[];
+}>;
+type DepositNetworkMemo = {
+  deposit_mode: "MEMO";
+} | null;
+type GetDepositAddressRequest = JSONRPCRequest<"deposit_address", {
+  account_id: string;
+  /** Chain is joined blockchain and network (e.g. eth:8453) */
+  chain: string;
+  /** Stellar blockchain specific */
+  deposit_mode?: "MEMO" | "SIMPLE";
+}>;
+type GetDepositAddressResponse = JSONRPCResponse<{
+  address: string;
+  chain: string;
+  /** Stellar blockchain specific */
+  memo?: string;
+}>;
+type DepositStatus = {
+  tx_hash: string;
+  chain: string;
+  defuse_asset_identifier: string;
+  near_token_id: string;
+  decimals: number;
+  amount: number;
+  account_id: string;
+  address: string;
+  status: "COMPLETED" | "PENDING" | "FAILED";
+};
+type GetDepositStatusRequest = JSONRPCRequest<"recent_deposits", {
+  account_id: string;
+  chain?: string;
+}>;
+type GetDepositStatusResponse = JSONRPCResponse<{
+  deposits: DepositStatus[];
+}>;
+type WithdrawalStatusRequest = JSONRPCRequest<"withdrawal_status", {
+  withdrawal_hash: string;
+}>;
+type WithdrawalStatusResponseOk = JSONRPCResponse<{
+  withdrawals: {
+    status: "COMPLETED" | "PENDING";
+    data: {
+      tx_hash: string;
+      transfer_tx_hash: string | null;
+      chain: string;
+      defuse_asset_identifier: string;
+      near_token_id: string;
+      decimals: number;
+      amount: number;
+      account_id: string;
+      address: string;
+      created: string;
+    };
+  }[];
+}>;
+type HotOmniWithdrawRequest = JSONRPCRequest<"hot_omni_withdraw", {
+  account_id: string;
+  tx_hash: string;
+  receiver: string;
+  chain_id: string;
+}>;
+type HotOmniWithdrawResponse = JSONRPCResponse<{
+  status: "COMPLETED" | "PENDING";
+  data: {
+    transfer_tx_hash: string | null;
+  };
+}[]>;
+type TokenBalances = {
+  symbol: string;
+  address: string;
+  nearAddress: string;
+  decimals: number;
+  totalSupply: string;
+  vaultBalance: string;
+  coldWalletBalance: string;
+  balanceOnDefuse: string;
+};
+type BridgeBalanceResponse = TokenBalances[];
+type GetWithdrawalEstimateRequest = JSONRPCRequest<"withdrawal_estimate", {
+  token: string;
+  address: string;
+  chain: BlockchainEnum;
+}>;
+type WithdrawalEstimateResponse = {
+  token: BaseTokenInfo;
+  tokenAddress: string;
+  userAddress: string;
+  withdrawalFee: string;
+  withdrawalFeeDecimals: number;
+};
+//#endregion
+export { BridgeBalanceResponse, DepositNetworkMemo, DepositStatus, GetDepositAddressRequest, GetDepositAddressResponse, GetDepositStatusRequest, GetDepositStatusResponse, GetSupportedTokensRequest, GetSupportedTokensResponse, GetWithdrawalEstimateRequest, HotOmniWithdrawRequest, HotOmniWithdrawResponse, JSONRPCErrorType, JSONRPCRequest, JSONRPCResponse, RequestConfig, TokenBalances, WithdrawalEstimateResponse, WithdrawalStatusRequest, WithdrawalStatusResponseOk };

package/dist/poaBridge/waitForWithdrawalCompletion.cjs

@@ -0,0 +1,57 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_base = require('../errors/base.cjs');
+const require_request = require('../errors/request.cjs');
+const require_retry = require('../utils/retry.cjs');
+const require_apis = require('./poaBridgeHttpClient/apis.cjs');
+const require_withdrawal = require('./errors/withdrawal.cjs');
+let _lifeomic_attempt = require("@lifeomic/attempt");
+
+//#region src/poaBridge/waitForWithdrawalCompletion.ts
+async function waitForWithdrawalCompletion({ txHash, withdrawalCriteria, signal, baseURL, retryOptions = require_retry.RETRY_CONFIGS.TWO_MINS_GRADUAL, logger }) {
+	return (0, _lifeomic_attempt.retry)(async () => {
+		const result = await require_apis.getWithdrawalStatus({ withdrawal_hash: txHash }, {
+			baseURL,
+			fetchOptions: { signal },
+			logger
+		});
+		const withdrawal = findMatchingWithdrawal(result.withdrawals, withdrawalCriteria);
+		if (withdrawal == null) throw new require_withdrawal.PoaWithdrawalInvariantError("POA Bridge didn't return withdrawal matching criteria", result, txHash, withdrawalCriteria);
+		if (withdrawal.status === "COMPLETED") {
+			if (withdrawal.data.transfer_tx_hash == null) throw new require_withdrawal.PoaWithdrawalInvariantError("POA Bridge didn't return transfer_tx_hash for COMPLETED withdrawal", result, txHash, withdrawalCriteria);
+			return {
+				destinationTxHash: withdrawal.data.transfer_tx_hash,
+				chain: withdrawal.data.chain
+			};
+		}
+		throw new require_withdrawal.PoaWithdrawalPendingError(result, txHash, withdrawalCriteria);
+	}, {
+		...retryOptions,
+		handleError: (err, context) => {
+			if (isWithdrawalNotFound(err)) {
+				if (context.attemptsRemaining > 0) return;
+				throw new require_withdrawal.PoaWithdrawalNotFoundError(txHash, withdrawalCriteria, err);
+			}
+			if (err instanceof require_withdrawal.PoaWithdrawalPendingError && context.attemptsRemaining > 0) return;
+			if (err instanceof require_base.BaseError && err.walk((err$1) => err$1 instanceof require_request.HttpRequestError || err$1 instanceof require_request.TimeoutError || err$1 instanceof require_request.RpcRequestError)) return;
+			context.abort();
+		}
+	});
+}
+function isWithdrawalNotFound(err) {
+	return err instanceof require_request.RpcRequestError && err.details === "Withdrawals not found";
+}
+/**
+* Finds a withdrawal matching the given criteria.
+*
+* NOTE: Currently only matches by assetId (near_token_id). This means multiple
+* withdrawals of the same token in a single transaction are not supported.
+* POA API doesn't currently support this case either. When support is added,
+* matching could be done by sorting both API results and withdrawal params by
+* amount (fees are equal for same token, so relative ordering is preserved).
+*/
+function findMatchingWithdrawal(withdrawals, criteria) {
+	return withdrawals.find((w) => `nep141:${w.data.near_token_id}` === criteria.assetId);
+}
+
+//#endregion
+exports.waitForWithdrawalCompletion = waitForWithdrawalCompletion;

package/dist/poaBridge/waitForWithdrawalCompletion.d.cts

@@ -0,0 +1,31 @@
+import { ILogger } from "../logger.cjs";
+import { RetryOptions } from "../utils/retry.cjs";
+import { JSONRPCErrorType } from "./poaBridgeHttpClient/types.cjs";
+import { PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingErrorType } from "./errors/withdrawal.cjs";
+
+//#region src/poaBridge/waitForWithdrawalCompletion.d.ts
+type WaitForWithdrawalCompletionOkType = {
+  destinationTxHash: string;
+  chain: string;
+};
+type WaitForWithdrawalCompletionErrorType = JSONRPCErrorType | PoaWithdrawalInvariantErrorType | PoaWithdrawalNotFoundErrorType | PoaWithdrawalPendingErrorType;
+type WithdrawalCriteria = {
+  assetId: string;
+};
+declare function waitForWithdrawalCompletion({
+  txHash,
+  withdrawalCriteria,
+  signal,
+  baseURL,
+  retryOptions,
+  logger
+}: {
+  txHash: string;
+  withdrawalCriteria: WithdrawalCriteria;
+  signal: AbortSignal;
+  baseURL?: string;
+  retryOptions?: RetryOptions;
+  logger?: ILogger;
+}): Promise<WaitForWithdrawalCompletionOkType>;
+//#endregion
+export { WaitForWithdrawalCompletionErrorType, WaitForWithdrawalCompletionOkType, WithdrawalCriteria, waitForWithdrawalCompletion };

package/dist/poaBridge/waitForWithdrawalCompletion.d.ts

@@ -0,0 +1,31 @@
+import { ILogger } from "../logger.js";
+import { RetryOptions } from "../utils/retry.js";
+import { JSONRPCErrorType } from "./poaBridgeHttpClient/types.js";
+import { PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingErrorType } from "./errors/withdrawal.js";
+
+//#region src/poaBridge/waitForWithdrawalCompletion.d.ts
+type WaitForWithdrawalCompletionOkType = {
+  destinationTxHash: string;
+  chain: string;
+};
+type WaitForWithdrawalCompletionErrorType = JSONRPCErrorType | PoaWithdrawalInvariantErrorType | PoaWithdrawalNotFoundErrorType | PoaWithdrawalPendingErrorType;
+type WithdrawalCriteria = {
+  assetId: string;
+};
+declare function waitForWithdrawalCompletion({
+  txHash,
+  withdrawalCriteria,
+  signal,
+  baseURL,
+  retryOptions,
+  logger
+}: {
+  txHash: string;
+  withdrawalCriteria: WithdrawalCriteria;
+  signal: AbortSignal;
+  baseURL?: string;
+  retryOptions?: RetryOptions;
+  logger?: ILogger;
+}): Promise<WaitForWithdrawalCompletionOkType>;
+//#endregion
+export { WaitForWithdrawalCompletionErrorType, WaitForWithdrawalCompletionOkType, WithdrawalCriteria, waitForWithdrawalCompletion };

package/dist/poaBridge/waitForWithdrawalCompletion.js

@@ -0,0 +1,56 @@
+import { BaseError } from "../errors/base.js";
+import { HttpRequestError, RpcRequestError, TimeoutError } from "../errors/request.js";
+import { RETRY_CONFIGS } from "../utils/retry.js";
+import { getWithdrawalStatus } from "./poaBridgeHttpClient/apis.js";
+import { PoaWithdrawalInvariantError, PoaWithdrawalNotFoundError, PoaWithdrawalPendingError } from "./errors/withdrawal.js";
+import { retry } from "@lifeomic/attempt";
+
+//#region src/poaBridge/waitForWithdrawalCompletion.ts
+async function waitForWithdrawalCompletion({ txHash, withdrawalCriteria, signal, baseURL, retryOptions = RETRY_CONFIGS.TWO_MINS_GRADUAL, logger }) {
+	return retry(async () => {
+		const result = await getWithdrawalStatus({ withdrawal_hash: txHash }, {
+			baseURL,
+			fetchOptions: { signal },
+			logger
+		});
+		const withdrawal = findMatchingWithdrawal(result.withdrawals, withdrawalCriteria);
+		if (withdrawal == null) throw new PoaWithdrawalInvariantError("POA Bridge didn't return withdrawal matching criteria", result, txHash, withdrawalCriteria);
+		if (withdrawal.status === "COMPLETED") {
+			if (withdrawal.data.transfer_tx_hash == null) throw new PoaWithdrawalInvariantError("POA Bridge didn't return transfer_tx_hash for COMPLETED withdrawal", result, txHash, withdrawalCriteria);
+			return {
+				destinationTxHash: withdrawal.data.transfer_tx_hash,
+				chain: withdrawal.data.chain
+			};
+		}
+		throw new PoaWithdrawalPendingError(result, txHash, withdrawalCriteria);
+	}, {
+		...retryOptions,
+		handleError: (err, context) => {
+			if (isWithdrawalNotFound(err)) {
+				if (context.attemptsRemaining > 0) return;
+				throw new PoaWithdrawalNotFoundError(txHash, withdrawalCriteria, err);
+			}
+			if (err instanceof PoaWithdrawalPendingError && context.attemptsRemaining > 0) return;
+			if (err instanceof BaseError && err.walk((err$1) => err$1 instanceof HttpRequestError || err$1 instanceof TimeoutError || err$1 instanceof RpcRequestError)) return;
+			context.abort();
+		}
+	});
+}
+function isWithdrawalNotFound(err) {
+	return err instanceof RpcRequestError && err.details === "Withdrawals not found";
+}
+/**
+* Finds a withdrawal matching the given criteria.
+*
+* NOTE: Currently only matches by assetId (near_token_id). This means multiple
+* withdrawals of the same token in a single transaction are not supported.
+* POA API doesn't currently support this case either. When support is added,
+* matching could be done by sorting both API results and withdrawal params by
+* amount (fees are equal for same token, so relative ordering is preserved).
+*/
+function findMatchingWithdrawal(withdrawals, criteria) {
+	return withdrawals.find((w) => `nep141:${w.data.near_token_id}` === criteria.assetId);
+}
+
+//#endregion
+export { waitForWithdrawalCompletion };

package/dist/services/blockchainBalanceService.cjs

@@ -0,0 +1,40 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_near = require('../utils/near.cjs');
+let valibot = require("valibot");
+valibot = require_rolldown_runtime.__toESM(valibot);
+let _scure_base = require("@scure/base");
+
+//#region src/services/blockchainBalanceService.ts
+const getNearNep141StorageBalance = async ({ contractId, accountId, nearProvider }) => {
+	try {
+		const args = { account_id: accountId };
+		const argsBase64 = _scure_base.base64.encode(new TextEncoder().encode(JSON.stringify(args)));
+		const parsed = require_near.decodeQueryResult(await nearProvider.query({
+			request_type: "call_function",
+			method_name: "storage_balance_of",
+			account_id: contractId,
+			args_base64: argsBase64,
+			finality: "optimistic"
+		}), valibot.union([valibot.null(), valibot.object({ total: valibot.string() })]));
+		return BigInt(parsed?.total || "0");
+	} catch (err) {
+		throw new Error("Error fetching balance", { cause: err });
+	}
+};
+const getNearNep141MinStorageBalance = async ({ contractId, nearProvider }) => {
+	const parsed = require_near.decodeQueryResult(await nearProvider.query({
+		request_type: "call_function",
+		method_name: "storage_balance_bounds",
+		account_id: contractId,
+		args_base64: _scure_base.base64.encode(new TextEncoder().encode(JSON.stringify({}))),
+		finality: "optimistic"
+	}), valibot.object({
+		min: valibot.string(),
+		max: valibot.string()
+	}));
+	return BigInt(parsed.min);
+};
+
+//#endregion
+exports.getNearNep141MinStorageBalance = getNearNep141MinStorageBalance;
+exports.getNearNep141StorageBalance = getNearNep141StorageBalance;

package/dist/services/blockchainBalanceService.d.cts

@@ -0,0 +1,21 @@
+import { providers } from "near-api-js";
+
+//#region src/services/blockchainBalanceService.d.ts
+declare const getNearNep141StorageBalance: ({
+  contractId,
+  accountId,
+  nearProvider
+}: {
+  contractId: string;
+  accountId: string;
+  nearProvider: providers.Provider;
+}) => Promise<bigint>;
+declare const getNearNep141MinStorageBalance: ({
+  contractId,
+  nearProvider
+}: {
+  contractId: string;
+  nearProvider: providers.Provider;
+}) => Promise<bigint>;
+//#endregion
+export { getNearNep141MinStorageBalance, getNearNep141StorageBalance };

package/dist/services/blockchainBalanceService.d.ts

@@ -0,0 +1,21 @@
+import { providers } from "near-api-js";
+
+//#region src/services/blockchainBalanceService.d.ts
+declare const getNearNep141StorageBalance: ({
+  contractId,
+  accountId,
+  nearProvider
+}: {
+  contractId: string;
+  accountId: string;
+  nearProvider: providers.Provider;
+}) => Promise<bigint>;
+declare const getNearNep141MinStorageBalance: ({
+  contractId,
+  nearProvider
+}: {
+  contractId: string;
+  nearProvider: providers.Provider;
+}) => Promise<bigint>;
+//#endregion
+export { getNearNep141MinStorageBalance, getNearNep141StorageBalance };

package/dist/services/blockchainBalanceService.js

@@ -0,0 +1,37 @@
+import { decodeQueryResult } from "../utils/near.js";
+import * as v from "valibot";
+import { base64 } from "@scure/base";
+
+//#region src/services/blockchainBalanceService.ts
+const getNearNep141StorageBalance = async ({ contractId, accountId, nearProvider }) => {
+	try {
+		const args = { account_id: accountId };
+		const argsBase64 = base64.encode(new TextEncoder().encode(JSON.stringify(args)));
+		const parsed = decodeQueryResult(await nearProvider.query({
+			request_type: "call_function",
+			method_name: "storage_balance_of",
+			account_id: contractId,
+			args_base64: argsBase64,
+			finality: "optimistic"
+		}), v.union([v.null(), v.object({ total: v.string() })]));
+		return BigInt(parsed?.total || "0");
+	} catch (err) {
+		throw new Error("Error fetching balance", { cause: err });
+	}
+};
+const getNearNep141MinStorageBalance = async ({ contractId, nearProvider }) => {
+	const parsed = decodeQueryResult(await nearProvider.query({
+		request_type: "call_function",
+		method_name: "storage_balance_bounds",
+		account_id: contractId,
+		args_base64: base64.encode(new TextEncoder().encode(JSON.stringify({}))),
+		finality: "optimistic"
+	}), v.object({
+		min: v.string(),
+		max: v.string()
+	}));
+	return BigInt(parsed.min);
+};
+
+//#endregion
+export { getNearNep141MinStorageBalance, getNearNep141StorageBalance };