lampamazaza-new-intents-sdk 0.47.1

package/dist/src/lib/estimate-fee.cjs

@@ -0,0 +1,96 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_apis = require('./tokensUsdPricesHttpClient/apis.cjs');
+let lampamazaza_internal_utils = require("lampamazaza-internal-utils");
+
+//#region src/lib/estimate-fee.ts
+/**
+* Helper to extract a specific fee from FeeEstimation's underlyingFees.
+* Throws if the route's fee object doesn't exist (invariant: bridges must populate their fees during estimation).
+* Returns the fee value which may be undefined for optional fees within the route object.
+*
+* @example
+* ```typescript
+* const relayerFee = getUnderlyingFee(feeEstimation, RouteEnum.HotBridge, 'relayerFee');
+* const storageDepositFee = getUnderlyingFee(feeEstimation, RouteEnum.OmniBridge, 'storageDepositFee');
+* ```
+* @throws {Error} If the route's fee object is not found in underlyingFees
+*/
+function getUnderlyingFee(feeEstimation, route, feeKey) {
+	const routeFees = feeEstimation.underlyingFees?.[route];
+	if (routeFees === void 0) throw new Error(`Missing underlying fees for route "${String(route)}". Fee estimation must populate underlyingFees before creating withdrawal intents.`);
+	return routeFees[feeKey];
+}
+/**
+* ExactIn fallback with 1.2x multiplier
+*/
+async function getFeeQuote({ feeAmount, feeAssetId, tokenAssetId, quoteOptions, envConfig, logger, solverRelayApiKey }) {
+	try {
+		return await lampamazaza_internal_utils.solverRelay.getQuote({
+			quoteParams: {
+				defuse_asset_identifier_in: tokenAssetId,
+				defuse_asset_identifier_out: feeAssetId,
+				exact_amount_out: feeAmount.toString(),
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
+			},
+			config: {
+				baseURL: envConfig.solverRelayBaseURL,
+				logBalanceSufficient: false,
+				logger,
+				solverRelayApiKey
+			}
+		});
+	} catch (err) {
+		if (!(err instanceof lampamazaza_internal_utils.QuoteError)) throw err;
+		logger?.info("Can't get exact out quote, trying to get exact in quote with x1.2");
+		const prices = await require_apis.tokens({ envConfig });
+		const feeAssetPrice = prices.items.find((t) => t.defuse_asset_id === feeAssetId);
+		const tokenAssetPrice = prices.items.find((t) => t.defuse_asset_id === tokenAssetId);
+		if (feeAssetPrice == null || tokenAssetPrice == null) throw err;
+		const USD_SCALE = 1e6;
+		const feePriceScaled = BigInt(Math.round(feeAssetPrice.price * USD_SCALE));
+		const tokenPriceScaled = BigInt(Math.round(tokenAssetPrice.price * USD_SCALE));
+		const feeDecimals = BigInt(feeAssetPrice.decimals);
+		const tokenDecimals = BigInt(tokenAssetPrice.decimals);
+		const num = feeAmount * feePriceScaled * 12n * 10n ** tokenDecimals;
+		const den = tokenPriceScaled * 10n ** feeDecimals * 10n;
+		let exactAmountIn = num / den;
+		if (num % den !== 0n) exactAmountIn += 1n;
+		if (exactAmountIn === 0n) exactAmountIn = 1n;
+		const quote = await lampamazaza_internal_utils.solverRelay.getQuote({
+			quoteParams: {
+				defuse_asset_identifier_in: tokenAssetId,
+				defuse_asset_identifier_out: feeAssetId,
+				exact_amount_in: exactAmountIn.toString(),
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
+			},
+			config: {
+				baseURL: envConfig.solverRelayBaseURL,
+				logBalanceSufficient: false,
+				logger,
+				solverRelayApiKey
+			}
+		});
+		const RATIO_SCALE = 1000n;
+		const actualRatio = BigInt(quote.amount_out) * RATIO_SCALE / feeAmount;
+		const actualRatioNumber = Number(actualRatio) / Number(RATIO_SCALE);
+		if (actualRatio > 1500n) {
+			logger?.warn(`Quote amount_out ratio is too high: ${actualRatioNumber.toFixed(2)}x`);
+			throw err;
+		}
+		if (BigInt(quote.amount_out) < feeAmount) {
+			logger?.warn(`Quote amount_out (${quote.amount_out}) is less than feeAmount (${feeAmount}), exact_amount_in: ${exactAmountIn}, fee asset price: ${feeAssetPrice.price} USD, token asset price: ${tokenAssetPrice.price} USD`);
+			throw err;
+		}
+		return quote;
+	}
+}
+
+//#endregion
+exports.getFeeQuote = getFeeQuote;
+exports.getUnderlyingFee = getUnderlyingFee;

package/dist/src/lib/estimate-fee.js

@@ -0,0 +1,94 @@
+import { tokens } from "./tokensUsdPricesHttpClient/apis.js";
+import { QuoteError, solverRelay } from "lampamazaza-internal-utils";
+
+//#region src/lib/estimate-fee.ts
+/**
+* Helper to extract a specific fee from FeeEstimation's underlyingFees.
+* Throws if the route's fee object doesn't exist (invariant: bridges must populate their fees during estimation).
+* Returns the fee value which may be undefined for optional fees within the route object.
+*
+* @example
+* ```typescript
+* const relayerFee = getUnderlyingFee(feeEstimation, RouteEnum.HotBridge, 'relayerFee');
+* const storageDepositFee = getUnderlyingFee(feeEstimation, RouteEnum.OmniBridge, 'storageDepositFee');
+* ```
+* @throws {Error} If the route's fee object is not found in underlyingFees
+*/
+function getUnderlyingFee(feeEstimation, route, feeKey) {
+	const routeFees = feeEstimation.underlyingFees?.[route];
+	if (routeFees === void 0) throw new Error(`Missing underlying fees for route "${String(route)}". Fee estimation must populate underlyingFees before creating withdrawal intents.`);
+	return routeFees[feeKey];
+}
+/**
+* ExactIn fallback with 1.2x multiplier
+*/
+async function getFeeQuote({ feeAmount, feeAssetId, tokenAssetId, quoteOptions, envConfig, logger, solverRelayApiKey }) {
+	try {
+		return await solverRelay.getQuote({
+			quoteParams: {
+				defuse_asset_identifier_in: tokenAssetId,
+				defuse_asset_identifier_out: feeAssetId,
+				exact_amount_out: feeAmount.toString(),
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
+			},
+			config: {
+				baseURL: envConfig.solverRelayBaseURL,
+				logBalanceSufficient: false,
+				logger,
+				solverRelayApiKey
+			}
+		});
+	} catch (err) {
+		if (!(err instanceof QuoteError)) throw err;
+		logger?.info("Can't get exact out quote, trying to get exact in quote with x1.2");
+		const prices = await tokens({ envConfig });
+		const feeAssetPrice = prices.items.find((t) => t.defuse_asset_id === feeAssetId);
+		const tokenAssetPrice = prices.items.find((t) => t.defuse_asset_id === tokenAssetId);
+		if (feeAssetPrice == null || tokenAssetPrice == null) throw err;
+		const USD_SCALE = 1e6;
+		const feePriceScaled = BigInt(Math.round(feeAssetPrice.price * USD_SCALE));
+		const tokenPriceScaled = BigInt(Math.round(tokenAssetPrice.price * USD_SCALE));
+		const feeDecimals = BigInt(feeAssetPrice.decimals);
+		const tokenDecimals = BigInt(tokenAssetPrice.decimals);
+		const num = feeAmount * feePriceScaled * 12n * 10n ** tokenDecimals;
+		const den = tokenPriceScaled * 10n ** feeDecimals * 10n;
+		let exactAmountIn = num / den;
+		if (num % den !== 0n) exactAmountIn += 1n;
+		if (exactAmountIn === 0n) exactAmountIn = 1n;
+		const quote = await solverRelay.getQuote({
+			quoteParams: {
+				defuse_asset_identifier_in: tokenAssetId,
+				defuse_asset_identifier_out: feeAssetId,
+				exact_amount_in: exactAmountIn.toString(),
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
+			},
+			config: {
+				baseURL: envConfig.solverRelayBaseURL,
+				logBalanceSufficient: false,
+				logger,
+				solverRelayApiKey
+			}
+		});
+		const RATIO_SCALE = 1000n;
+		const actualRatio = BigInt(quote.amount_out) * RATIO_SCALE / feeAmount;
+		const actualRatioNumber = Number(actualRatio) / Number(RATIO_SCALE);
+		if (actualRatio > 1500n) {
+			logger?.warn(`Quote amount_out ratio is too high: ${actualRatioNumber.toFixed(2)}x`);
+			throw err;
+		}
+		if (BigInt(quote.amount_out) < feeAmount) {
+			logger?.warn(`Quote amount_out (${quote.amount_out}) is less than feeAmount (${feeAmount}), exact_amount_in: ${exactAmountIn}, fee asset price: ${feeAssetPrice.price} USD, token asset price: ${tokenAssetPrice.price} USD`);
+			throw err;
+		}
+		return quote;
+	}
+}
+
+//#endregion
+export { getFeeQuote, getUnderlyingFee };

package/dist/src/lib/hex.cjs

@@ -0,0 +1,11 @@
+
+//#region src/lib/hex.ts
+/**
+* @description verifies value is a non 0x-prefixed hex string
+*/
+function isHex(value) {
+	return value.length % 2 === 0 && /^[0-9A-Fa-f]+$/.test(value);
+}
+
+//#endregion
+exports.default = isHex;

package/dist/src/lib/hex.js

@@ -0,0 +1,10 @@
+//#region src/lib/hex.ts
+/**
+* @description verifies value is a non 0x-prefixed hex string
+*/
+function isHex(value) {
+	return value.length % 2 === 0 && /^[0-9A-Fa-f]+$/.test(value);
+}
+
+//#endregion
+export { isHex as default };

package/dist/src/lib/nep413.cjs

@@ -0,0 +1,42 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let borsher = require("borsher");
+
+//#region src/lib/nep413.ts
+const nep413PayloadSchema = borsher.BorshSchema.Struct({
+	message: borsher.BorshSchema.String,
+	nonce: borsher.BorshSchema.Array(borsher.BorshSchema.u8, 32),
+	recipient: borsher.BorshSchema.String,
+	callback_url: borsher.BorshSchema.Option(borsher.BorshSchema.String)
+});
+/**
+* Client-side utility to serialize and hash NEP-413 messages for EdDSA signature verification.
+* Follows the NEP-413 specification for message serialization and hashing:
+* @see https://github.com/near/NEPs/blob/master/neps/nep-0413.md#specification
+*
+* The resulting hash should be used with EdDSA signing to create a valid NEP-413 signature.
+* Note: This is a browser-only implementation.
+*
+* @param message - Message content to be signed
+* @param recipient - Recipient account ID
+* @param nonce - 32-byte nonce as a Uint8Array
+* @param callback_url - Optional callback URL to be used for the intent
+* @returns Promise resolving to Buffer containing message hash for signing
+*/
+async function hashNEP413Message({ message, recipient, nonce, callback_url }) {
+	const payloadSerialized = (0, borsher.borshSerialize)(nep413PayloadSchema, {
+		message,
+		nonce: Array.from(nonce),
+		recipient,
+		callback_url
+	});
+	const baseInt = 2 ** 31 + 413;
+	const baseIntSerialized = (0, borsher.borshSerialize)(borsher.BorshSchema.u32, baseInt);
+	const combinedData = new Uint8Array(baseIntSerialized.length + payloadSerialized.length);
+	combinedData.set(baseIntSerialized);
+	combinedData.set(payloadSerialized, baseIntSerialized.length);
+	const hashBuffer = await crypto.subtle.digest("SHA-256", combinedData);
+	return new Uint8Array(hashBuffer);
+}
+
+//#endregion
+exports.hashNEP413Message = hashNEP413Message;

package/dist/src/lib/nep413.d.cts

@@ -0,0 +1,14 @@
+import { BorshSchema } from "borsher";
+
+//#region src/lib/nep413.d.ts
+declare const nep413PayloadSchema: BorshSchema<{
+  message: string;
+  nonce: number[];
+  recipient: string;
+  callback_url: string | null;
+}>;
+type NEP413Payload = typeof nep413PayloadSchema extends BorshSchema<infer T> ? Omit<T, "callback_url"> & {
+  callback_url?: string | null | undefined;
+} : never;
+//#endregion
+export { NEP413Payload };

package/dist/src/lib/nep413.d.ts

@@ -0,0 +1,14 @@
+import { BorshSchema } from "borsher";
+
+//#region src/lib/nep413.d.ts
+declare const nep413PayloadSchema: BorshSchema<{
+  message: string;
+  nonce: number[];
+  recipient: string;
+  callback_url: string | null;
+}>;
+type NEP413Payload = typeof nep413PayloadSchema extends BorshSchema<infer T> ? Omit<T, "callback_url"> & {
+  callback_url?: string | null | undefined;
+} : never;
+//#endregion
+export { NEP413Payload };

package/dist/src/lib/nep413.js

@@ -0,0 +1,41 @@
+import { BorshSchema, borshSerialize } from "borsher";
+
+//#region src/lib/nep413.ts
+const nep413PayloadSchema = BorshSchema.Struct({
+	message: BorshSchema.String,
+	nonce: BorshSchema.Array(BorshSchema.u8, 32),
+	recipient: BorshSchema.String,
+	callback_url: BorshSchema.Option(BorshSchema.String)
+});
+/**
+* Client-side utility to serialize and hash NEP-413 messages for EdDSA signature verification.
+* Follows the NEP-413 specification for message serialization and hashing:
+* @see https://github.com/near/NEPs/blob/master/neps/nep-0413.md#specification
+*
+* The resulting hash should be used with EdDSA signing to create a valid NEP-413 signature.
+* Note: This is a browser-only implementation.
+*
+* @param message - Message content to be signed
+* @param recipient - Recipient account ID
+* @param nonce - 32-byte nonce as a Uint8Array
+* @param callback_url - Optional callback URL to be used for the intent
+* @returns Promise resolving to Buffer containing message hash for signing
+*/
+async function hashNEP413Message({ message, recipient, nonce, callback_url }) {
+	const payloadSerialized = borshSerialize(nep413PayloadSchema, {
+		message,
+		nonce: Array.from(nonce),
+		recipient,
+		callback_url
+	});
+	const baseInt = 2 ** 31 + 413;
+	const baseIntSerialized = borshSerialize(BorshSchema.u32, baseInt);
+	const combinedData = new Uint8Array(baseIntSerialized.length + payloadSerialized.length);
+	combinedData.set(baseIntSerialized);
+	combinedData.set(payloadSerialized, baseIntSerialized.length);
+	const hashBuffer = await crypto.subtle.digest("SHA-256", combinedData);
+	return new Uint8Array(hashBuffer);
+}
+
+//#endregion
+export { hashNEP413Message };

package/dist/src/lib/object.cjs

@@ -0,0 +1,10 @@
+
+//#region src/lib/object.ts
+function pick(obj, keys) {
+	const result = {};
+	for (const key of keys) if (key in obj) result[key] = obj[key];
+	return result;
+}
+
+//#endregion
+exports.pick = pick;

package/dist/src/lib/object.js

@@ -0,0 +1,9 @@
+//#region src/lib/object.ts
+function pick(obj, keys) {
+	const result = {};
+	for (const key of keys) if (key in obj) result[key] = obj[key];
+	return result;
+}
+
+//#endregion
+export { pick };

package/dist/src/lib/parse-defuse-asset-id.cjs

@@ -0,0 +1,15 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_errors = require('../classes/errors.cjs');
+let lampamazaza_internal_utils = require("lampamazaza-internal-utils");
+
+//#region src/lib/parse-defuse-asset-id.ts
+function parseDefuseAssetId(assetId) {
+	try {
+		return lampamazaza_internal_utils.utils.parseDefuseAssetId(assetId);
+	} catch {
+		throw new require_errors.UnsupportedAssetIdError(assetId, "Invalid asset id format.");
+	}
+}
+
+//#endregion
+exports.parseDefuseAssetId = parseDefuseAssetId;

package/dist/src/lib/parse-defuse-asset-id.js

@@ -0,0 +1,14 @@
+import { UnsupportedAssetIdError } from "../classes/errors.js";
+import { utils } from "lampamazaza-internal-utils";
+
+//#region src/lib/parse-defuse-asset-id.ts
+function parseDefuseAssetId(assetId) {
+	try {
+		return utils.parseDefuseAssetId(assetId);
+	} catch {
+		throw new UnsupportedAssetIdError(assetId, "Invalid asset id format.");
+	}
+}
+
+//#endregion
+export { parseDefuseAssetId };

package/dist/src/lib/route-config-factory.cjs

@@ -0,0 +1,43 @@
+const require_route_enum = require('../constants/route-enum.cjs');
+
+//#region src/lib/route-config-factory.ts
+function createInternalTransferRoute() {
+	return { route: require_route_enum.RouteEnum.InternalTransfer };
+}
+function createNearWithdrawalRoute(msg) {
+	return {
+		route: require_route_enum.RouteEnum.NearWithdrawal,
+		msg
+	};
+}
+function createOmniBridgeRoute(chain) {
+	const routeConfig = { route: require_route_enum.RouteEnum.OmniBridge };
+	if (chain) routeConfig.chain = chain;
+	return routeConfig;
+}
+function createVirtualChainRoute(auroraEngineContractId, proxyTokenContractId) {
+	return {
+		route: require_route_enum.RouteEnum.VirtualChain,
+		auroraEngineContractId,
+		proxyTokenContractId
+	};
+}
+function createPoaBridgeRoute() {
+	return { route: require_route_enum.RouteEnum.PoaBridge };
+}
+function createHotBridgeRoute(chain) {
+	return {
+		route: require_route_enum.RouteEnum.HotBridge,
+		chain
+	};
+}
+function createDefaultRoute() {}
+
+//#endregion
+exports.createDefaultRoute = createDefaultRoute;
+exports.createHotBridgeRoute = createHotBridgeRoute;
+exports.createInternalTransferRoute = createInternalTransferRoute;
+exports.createNearWithdrawalRoute = createNearWithdrawalRoute;
+exports.createOmniBridgeRoute = createOmniBridgeRoute;
+exports.createPoaBridgeRoute = createPoaBridgeRoute;
+exports.createVirtualChainRoute = createVirtualChainRoute;

package/dist/src/lib/route-config-factory.d.cts

@@ -0,0 +1,13 @@
+import { Chain } from "./caip2.cjs";
+import { HotBridgeRouteConfig, InternalTransferRouteConfig, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, PoaBridgeRouteConfig, VirtualChainRouteConfig } from "../shared-types.cjs";
+
+//#region src/lib/route-config-factory.d.ts
+declare function createInternalTransferRoute(): InternalTransferRouteConfig;
+declare function createNearWithdrawalRoute(msg?: string): NearWithdrawalRouteConfig;
+declare function createOmniBridgeRoute(chain?: Chain): OmniBridgeRouteConfig;
+declare function createVirtualChainRoute(auroraEngineContractId: string, proxyTokenContractId: string | null): VirtualChainRouteConfig;
+declare function createPoaBridgeRoute(): PoaBridgeRouteConfig;
+declare function createHotBridgeRoute(chain: Chain): HotBridgeRouteConfig;
+declare function createDefaultRoute(): undefined;
+//#endregion
+export { createDefaultRoute, createHotBridgeRoute, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/src/lib/route-config-factory.d.ts

@@ -0,0 +1,13 @@
+import { Chain } from "./caip2.js";
+import { HotBridgeRouteConfig, InternalTransferRouteConfig, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, PoaBridgeRouteConfig, VirtualChainRouteConfig } from "../shared-types.js";
+
+//#region src/lib/route-config-factory.d.ts
+declare function createInternalTransferRoute(): InternalTransferRouteConfig;
+declare function createNearWithdrawalRoute(msg?: string): NearWithdrawalRouteConfig;
+declare function createOmniBridgeRoute(chain?: Chain): OmniBridgeRouteConfig;
+declare function createVirtualChainRoute(auroraEngineContractId: string, proxyTokenContractId: string | null): VirtualChainRouteConfig;
+declare function createPoaBridgeRoute(): PoaBridgeRouteConfig;
+declare function createHotBridgeRoute(chain: Chain): HotBridgeRouteConfig;
+declare function createDefaultRoute(): undefined;
+//#endregion
+export { createDefaultRoute, createHotBridgeRoute, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/src/lib/route-config-factory.js

@@ -0,0 +1,37 @@
+import { RouteEnum } from "../constants/route-enum.js";
+
+//#region src/lib/route-config-factory.ts
+function createInternalTransferRoute() {
+	return { route: RouteEnum.InternalTransfer };
+}
+function createNearWithdrawalRoute(msg) {
+	return {
+		route: RouteEnum.NearWithdrawal,
+		msg
+	};
+}
+function createOmniBridgeRoute(chain) {
+	const routeConfig = { route: RouteEnum.OmniBridge };
+	if (chain) routeConfig.chain = chain;
+	return routeConfig;
+}
+function createVirtualChainRoute(auroraEngineContractId, proxyTokenContractId) {
+	return {
+		route: RouteEnum.VirtualChain,
+		auroraEngineContractId,
+		proxyTokenContractId
+	};
+}
+function createPoaBridgeRoute() {
+	return { route: RouteEnum.PoaBridge };
+}
+function createHotBridgeRoute(chain) {
+	return {
+		route: RouteEnum.HotBridge,
+		chain
+	};
+}
+function createDefaultRoute() {}
+
+//#endregion
+export { createDefaultRoute, createHotBridgeRoute, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/src/lib/tokensUsdPricesHttpClient/apis.cjs

@@ -0,0 +1,17 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let lampamazaza_internal_utils = require("lampamazaza-internal-utils");
+
+//#region src/lib/tokensUsdPricesHttpClient/apis.ts
+async function tokens(config) {
+	return (await (0, lampamazaza_internal_utils.request)({
+		url: new URL("tokens", config.envConfig.managerConsoleBaseURL),
+		...config,
+		fetchOptions: {
+			...config.fetchOptions,
+			method: "GET"
+		}
+	})).json();
+}
+
+//#endregion
+exports.tokens = tokens;

package/dist/src/lib/tokensUsdPricesHttpClient/apis.js

@@ -0,0 +1,16 @@
+import { request } from "lampamazaza-internal-utils";
+
+//#region src/lib/tokensUsdPricesHttpClient/apis.ts
+async function tokens(config) {
+	return (await request({
+		url: new URL("tokens", config.envConfig.managerConsoleBaseURL),
+		...config,
+		fetchOptions: {
+			...config.fetchOptions,
+			method: "GET"
+		}
+	})).json();
+}
+
+//#endregion
+export { tokens };