@moveindustries/near-intents-sdk 0.0.1 → 0.0.3

package/README.md

@@ -19,12 +19,13 @@ configure({ jwt: process.env.ONE_CLICK_JWT }); // jwt optional; omit configure()
 
 // 1. Quote: USDC on Ethereum -> USDCx on Movement. Destination is pinned to Movement.
 const res = await quoteDeposit({
-  originChain: "ethereum",  // "ethereum" | "polygon" | "tron"
+  originChain: "ethereum",  // "ethereum" | "polygon" | "tron" | "near"
   originAsset: "usdc",      // "usdc" | "usdt"  (tron is usdt-only)
   destinationAsset: "usdcx", // "usdcx" | "move"
   amount: "1000000",        // 1.0 USDC, in the origin asset's smallest units
   recipient: "0xYourMovementAddress",
   refundTo: "0xYourEthereumAddress",
+  minAmountOut: "995000",   // required floor in the destination asset's smallest units; throws if the quote's guaranteed output is lower. Pass "0" to opt out.
   // slippageTolerance: 100, // basis points, defaults to 100 (1%); raise it for `destinationAsset: "move"`
 });
 const { depositAddress, amountOut, deadline } = res.quote;
@@ -32,9 +33,11 @@ const { depositAddress, amountOut, deadline } = res.quote;
 // 2. (Optional) Build the unsigned deposit transfer; your wallet signs + broadcasts it.
 const depositTx = prepareDepositTx("ethereum", "usdc", res);
 // EVM: { family: "evm", to, value, data }   Tron: { family: "tron", contractAddress, function, parameter }
+// NEAR: { family: "near", receiverId, methodName: "ft_transfer", args, gas, deposit }
 
 // 3. (Optional) After broadcasting, hand 1Click the tx hash to speed up deposit detection.
 await submitDeposit(depositAddress!, "0xYourDepositTxHash");
+// For a NEAR origin, also pass the signing account: submitDeposit(depositAddress!, txHash, { nearSenderAccount: "you.near" })
 
 // 4. Read execution status. Poll on your own cadence until isTerminal(status).
 const { status } = await getStatus(depositAddress!);
@@ -45,7 +48,7 @@ The SDK never signs, broadcasts, or holds keys — step 2 returns an *unsigned*
 
 ## Supported routes
 
-Backed by Movement's own solver: origins **Polygon, Ethereum, Tron** (USDC + USDT; Tron is USDT-only) → **USDCx** or **MOVE** on Movement.
+Backed by Movement's own solver: origins **Polygon, Ethereum, Tron, NEAR** (USDC + USDT; Tron is USDT-only) → **USDCx** or **MOVE** on Movement.
 
 ## Install
 

package/dist/deposit.d.ts

@@ -12,6 +12,18 @@ export type TronDepositTx = {
     function: "transfer(address,uint256)";
     parameter: [string, string];
 };
-export type DepositTx = EvmDepositTx | TronDepositTx;
+/** Unsigned NEP-141 `ft_transfer` call. `deposit` is the mandatory 1-yoctoNEAR security deposit. */
+export type NearDepositTx = {
+    family: "near";
+    receiverId: string;
+    methodName: "ft_transfer";
+    args: {
+        receiver_id: string;
+        amount: string;
+    };
+    gas: string;
+    deposit: "1";
+};
+export type DepositTx = EvmDepositTx | TronDepositTx | NearDepositTx;
 /** Unsigned transfer of the quote's `amountIn` to its `depositAddress`. The caller signs and broadcasts. */
 export declare function prepareDepositTx(origin: OriginKey, originAsset: StableKey, quote: QuoteResponse): DepositTx;

package/dist/deposit.js

@@ -1,5 +1,7 @@
 import { resolveOrigin, family } from "./registry.js";
 const pad32 = (hex) => hex.replace(/^0x/, "").toLowerCase().padStart(64, "0");
+/** 30 Tgas — generous for a plain `ft_transfer`, which calls no other contract. */
+const NEAR_FT_TRANSFER_GAS = "30000000000000";
 /** Unsigned transfer of the quote's `amountIn` to its `depositAddress`. The caller signs and broadcasts. */
 export function prepareDepositTx(origin, originAsset, quote) {
     const { tokenAddress } = resolveOrigin(origin, originAsset);
@@ -8,8 +10,12 @@ export function prepareDepositTx(origin, originAsset, quote) {
         throw new Error("quote has no depositAddress (dry run?)");
     if (!tokenAddress)
         throw new Error(`no verified L1 token address for ${origin}/${originAsset} (see tasks.md precondition)`);
-    if (family(origin) === "tron") {
+    const fam = family(origin);
+    if (fam === "tron") {
         return { family: "tron", contractAddress: tokenAddress, function: "transfer(address,uint256)", parameter: [depositAddress, amountIn] };
     }
+    if (fam === "near") {
+        return { family: "near", receiverId: tokenAddress, methodName: "ft_transfer", args: { receiver_id: depositAddress, amount: amountIn }, gas: NEAR_FT_TRANSFER_GAS, deposit: "1" };
+    }
     return { family: "evm", to: tokenAddress, value: "0x0", data: "0xa9059cbb" + pad32(depositAddress) + pad32(BigInt(amountIn).toString(16)) };
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { configure, quoteDeposit, type QuoteDepositParams } from "./quote.js";
-export { prepareDepositTx, type DepositTx, type EvmDepositTx, type TronDepositTx } from "./deposit.js";
+export { prepareDepositTx, type DepositTx, type EvmDepositTx, type TronDepositTx, type NearDepositTx } from "./deposit.js";
 export { submitDeposit } from "./submit.js";
 export { getStatus, isTerminal } from "./status.js";
 export { listTokens, type SupportedToken } from "./tokens.js";

package/dist/quote.d.ts

@@ -8,6 +8,7 @@ export type QuoteDepositParams = {
     recipient: string;
     refundTo: string;
     slippageTolerance?: number;
+    minAmountOut: string;
     deadline?: string;
     dry?: boolean;
 };

package/dist/quote.js

@@ -15,7 +15,10 @@ export async function quoteDeposit(p) {
     const deadline = p.deadline ?? new Date(Date.now() + 600_000).toISOString();
     if (Date.parse(deadline) <= Date.now())
         throw new Error(`deadline is in the past: ${deadline}`);
-    return OneClickService.getQuote({
+    if (!/^[0-9]+$/.test(p.minAmountOut)) {
+        throw new Error(`minAmountOut must be a non-negative integer string ("0" opts out of the floor): ${p.minAmountOut}`);
+    }
+    const res = await OneClickService.getQuote({
         dry: p.dry ?? false,
         swapType: QuoteRequest.swapType.EXACT_INPUT,
         slippageTolerance: p.slippageTolerance ?? 100,
@@ -29,4 +32,12 @@ export async function quoteDeposit(p) {
         refundType: QuoteRequest.refundType.ORIGIN_CHAIN,
         deadline,
     });
+    // Guard against a poorly-priced quote: compare the caller's floor against the quote's
+    // guaranteed output (minAmountOut after slippage), not the expected amountOut, so the check
+    // holds even in the worst-case execution the quote permits. A floor of 0 opts out.
+    const floor = BigInt(p.minAmountOut);
+    if (floor > 0n && BigInt(res.quote.minAmountOut) < floor) {
+        throw new Error(`quote below floor: guaranteed minAmountOut ${res.quote.minAmountOut} < minAmountOut ${p.minAmountOut}`);
+    }
+    return res;
 }

package/dist/registry.d.ts

@@ -48,8 +48,20 @@ export declare const ORIGINS: {
             readonly tokenAddress: "41a614f803b6fd780986a42c78ec9c7f77e6ded13c";
         };
     };
+    readonly near: {
+        readonly usdc: {
+            readonly assetId: "nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1";
+            readonly decimals: 6;
+            readonly tokenAddress: "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1";
+        };
+        readonly usdt: {
+            readonly assetId: "nep141:usdt.tether-token.near";
+            readonly decimals: 6;
+            readonly tokenAddress: "usdt.tether-token.near";
+        };
+    };
 };
-export declare const family: (origin: OriginKey) => "evm" | "tron";
+export declare const family: (origin: OriginKey) => "evm" | "tron" | "near";
 export declare function resolveOrigin(origin: string, originAsset: string): AssetEntry;
 export declare function resolveDest(destinationAsset: string): AssetEntry;
 export declare function normalizeRecipient(addr: string): string;

package/dist/registry.js

@@ -2,11 +2,13 @@ export const MOVEMENT = {
     usdcx: { assetId: "nep141:movement-6f9a70ef4605e7d9174f1abf8d8d3c15012f48f3.omft.near", decimals: 6 },
     move: { assetId: "nep141:movement.omft.near", decimals: 8 },
 };
-// tokenAddress is the L1 token contract the deposit transfer targets. Provenance (the omft assetId hex
-// equals the L1 contract only on EVM — never derive a non-EVM contract from it):
+// tokenAddress is the token contract the deposit transfer targets. Provenance (the omft assetId hex
+// equals the token contract only on EVM — never derive a non-EVM contract from it):
 //   ethereum USDC 0xa0b8…eb48 / USDT 0xdac1…1ec7  — canonical Ethereum contracts (also embedded in the assetId).
 //   polygon  USDC 0x3c49…3359 (native USDC, NOT USDC.e) / USDT 0xc213…8e8f — canonical Polygon contracts.
 //   tron     USDT 41a614f803… (TR7NHqje…)          — canonical TRC-20 USDT; NOT the omft assetId hex (a bridge id).
+//   near     USDC 17208628…6133a1 / USDT usdt.tether-token.near — canonical NEAR NEP-141 accounts; here the
+//            assetId's nep141: suffix already *is* the token contract (no bridge wrapping), unlike the others.
 export const ORIGINS = {
     ethereum: {
         usdc: { assetId: "nep141:eth-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.omft.near", decimals: 6, tokenAddress: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" },
@@ -19,8 +21,12 @@ export const ORIGINS = {
     tron: {
         usdt: { assetId: "nep141:tron-d28a265909efecdcee7c5028585214ea0b96f015.omft.near", decimals: 6, tokenAddress: "41a614f803b6fd780986a42c78ec9c7f77e6ded13c" },
     },
+    near: {
+        usdc: { assetId: "nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1", decimals: 6, tokenAddress: "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1" },
+        usdt: { assetId: "nep141:usdt.tether-token.near", decimals: 6, tokenAddress: "usdt.tether-token.near" },
+    },
 };
-export const family = (origin) => (origin === "tron" ? "tron" : "evm");
+export const family = (origin) => origin === "tron" ? "tron" : origin === "near" ? "near" : "evm";
 export function resolveOrigin(origin, originAsset) {
     const e = ORIGINS[origin]?.[originAsset];
     if (!e)

package/dist/submit.d.ts

@@ -3,7 +3,11 @@ import { type SubmitDepositTxResponse } from "@defuse-protocol/one-click-sdk-typ
  * Hand 1Click the deposit tx hash so it can start processing without waiting to
  * detect the deposit on the origin chain. Optional speed-up — status tracking works
  * without it. Goes between broadcasting the deposit and reading status.
+ *
+ * `nearSenderAccount` is required by the 1Click API for NEAR-origin deposits (the
+ * account that signed the `ft_transfer`); ignored for other origins.
  */
 export declare function submitDeposit(depositAddress: string, txHash: string, opts?: {
     memo?: string;
+    nearSenderAccount?: string;
 }): Promise<SubmitDepositTxResponse>;

package/dist/submit.js

@@ -3,7 +3,10 @@ import { OneClickService } from "@defuse-protocol/one-click-sdk-typescript";
  * Hand 1Click the deposit tx hash so it can start processing without waiting to
  * detect the deposit on the origin chain. Optional speed-up — status tracking works
  * without it. Goes between broadcasting the deposit and reading status.
+ *
+ * `nearSenderAccount` is required by the 1Click API for NEAR-origin deposits (the
+ * account that signed the `ft_transfer`); ignored for other origins.
  */
 export async function submitDeposit(depositAddress, txHash, opts = {}) {
-    return OneClickService.submitDepositTx({ depositAddress, txHash, memo: opts.memo });
+    return OneClickService.submitDepositTx({ depositAddress, txHash, memo: opts.memo, nearSenderAccount: opts.nearSenderAccount });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moveindustries/near-intents-sdk",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Thin SDK: USDT/USDC -> Movement USDCx/MOVE over NEAR Intents 1Click.",
   "type": "module",
   "main": "dist/index.js",