@fastnear/intents 1.6.0

package/dist/esm/types-BQpqppU6.d.ts

@@ -0,0 +1,343 @@
+/**
+ * Protocol types for NEAR Intents (the verifier contract `intents.near`,
+ * the 1Click swap API, and the solver relay).
+ *
+ * Sources of truth:
+ * - 1Click OpenAPI: https://1click.chaindefuser.com/docs/v0/openapi.yaml
+ * - Verifier docs:  https://docs.near-intents.org/integration/verifier-contract
+ * - Solver relay:   https://docs.near-intents.org/integration/market-makers/message-bus/rpc.md
+ */
+/** The NEAR Intents verifier contract (mainnet). */
+declare const INTENTS_CONTRACT_ID = "intents.near";
+/** Hosted 1Click swap API base URL. */
+declare const ONE_CLICK_BASE_URL = "https://1click.chaindefuser.com";
+/** Hosted solver relay JSON-RPC endpoint. */
+declare const SOLVER_RELAY_URL = "https://solver-relay-v2.chaindefuser.com/rpc";
+/**
+ * A multi-token id inside the verifier's NEP-245 ledger:
+ * `nep141:<contract>`, `nep171:<contract>:<token_id>`, or
+ * `nep245:<contract>:<token_id>`.
+ */
+type IntentsTokenId = string;
+/**
+ * Trade intent: per-token balance deltas for the signer. Negative amounts are
+ * paid by the signer, positive amounts are received. The verifier requires all
+ * diffs in a batch to sum to zero per token, so a counterparty (solver) signs
+ * the mirror diff.
+ */
+interface TokenDiffIntent {
+    intent: "token_diff";
+    diff: Record<IntentsTokenId, string>;
+    memo?: string;
+    referral?: string;
+}
+/** Internal ledger transfer to another intents.near account. */
+interface TransferIntent {
+    intent: "transfer";
+    receiver_id: string;
+    tokens: Record<IntentsTokenId, string>;
+    memo?: string;
+}
+/**
+ * Withdraw a NEP-141 token out of the verifier. `token` is the plain token
+ * contract id (no `nep141:` prefix). Omit `msg` for refundable ft_transfer
+ * semantics; passing `msg` switches to ft_transfer_call with no refund.
+ */
+interface FtWithdrawIntent {
+    intent: "ft_withdraw";
+    token: string;
+    receiver_id: string;
+    amount: string;
+    memo?: string;
+    msg?: string;
+    storage_deposit?: string;
+}
+interface NftWithdrawIntent {
+    intent: "nft_withdraw";
+    token: string;
+    receiver_id: string;
+    token_id: string;
+    memo?: string;
+    msg?: string;
+    storage_deposit?: string;
+}
+interface MtWithdrawIntent {
+    intent: "mt_withdraw";
+    token: string;
+    receiver_id: string;
+    token_ids: string[];
+    amounts: string[];
+    memo?: string;
+    msg?: string;
+    storage_deposit?: string;
+}
+/** The only way to withdraw native NEAR: unwraps internal wNEAR on exit. */
+interface NativeWithdrawIntent {
+    intent: "native_withdraw";
+    receiver_id: string;
+    amount: string;
+}
+/**
+ * Pay a NEP-145 storage_deposit on a token contract from the signer's
+ * internal wNEAR balance (registers a receiver before a withdrawal lands).
+ */
+interface StorageDepositIntent {
+    intent: "storage_deposit";
+    contract_id: string;
+    account_id: string;
+    amount: string;
+}
+type Intent = TokenDiffIntent | TransferIntent | FtWithdrawIntent | NftWithdrawIntent | MtWithdrawIntent | NativeWithdrawIntent | StorageDepositIntent;
+/**
+ * The inner message that gets signed. For the `nep413` standard this JSON
+ * string becomes the NEP-413 `message`, while the verifying contract and
+ * replay nonce live in the NEP-413 envelope (`recipient` / `nonce`).
+ */
+interface IntentMessage {
+    signer_id: string;
+    /** ISO-8601 timestamp after which the signed intent is invalid. */
+    deadline: string;
+    intents: Intent[];
+}
+/**
+ * A NEP-413-signed intent as `intents.near`, the solver relay, and 1Click
+ * accept it. Note the encodings: `nonce` is base64 of 32 bytes, while
+ * `signature` and `public_key` are `ed25519:<base58>` strings — NOT the
+ * base64 signature NEAR wallets return.
+ */
+interface SignedIntentNep413 {
+    standard: "nep413";
+    payload: {
+        message: string;
+        nonce: string;
+        recipient: string;
+        callbackUrl?: string;
+    };
+    public_key: string;
+    signature: string;
+}
+/**
+ * Any signed payload standard the verifier accepts. This package produces
+ * `nep413`; the other variants (erc191, tip191, raw_ed25519, webauthn,
+ * ton_connect, sep53) are documented pass-through shapes.
+ */
+type SignedIntent = SignedIntentNep413 | {
+    standard: string;
+    [key: string]: unknown;
+};
+/**
+ * An unsigned NEP-413 payload, as returned by 1Click's generate-intent
+ * endpoint (nonce is base64 of 32 bytes when it arrives as a string).
+ */
+interface UnsignedNep413Payload {
+    message: string;
+    nonce: string | Uint8Array;
+    recipient: string;
+    callbackUrl?: string;
+}
+/**
+ * What signPayload accepts: a bare unsigned payload or the
+ * { standard, payload } wrapper 1Click's generate-intent returns.
+ */
+type GeneratedUnsignedIntent = UnsignedNep413Payload | {
+    standard: string;
+    payload: UnsignedNep413Payload;
+};
+interface SignPayloadOptions {
+    /**
+     * The verifying contract the payload's recipient must equal. Defaults to
+     * intents.near — a server response naming any other recipient throws
+     * instead of being signed. Set explicitly to sign for a different
+     * (e.g. staging) verifier deployment.
+     */
+    expectedRecipient?: string;
+}
+/** The signer surface shared by the wallet and local-key implementations. */
+interface IntentSigner {
+    /** Build and sign an intent message this client composes itself. */
+    signIntents(params: SignIntentsParams): Promise<SignedIntentNep413>;
+    /**
+     * Sign a pre-built NEP-413 payload verbatim — the 1Click generate-intent
+     * flow, where the server chooses the message, nonce, and recipient. The
+     * recipient is pinned to intents.near unless options.expectedRecipient
+     * overrides it, so a malicious or buggy server cannot redirect the
+     * signature to another contract.
+     */
+    signPayload(payload: GeneratedUnsignedIntent, options?: SignPayloadOptions): Promise<SignedIntentNep413>;
+}
+interface SignIntentsParams {
+    intents: Intent[];
+    /** Defaults to the connected wallet account / the local signer account. */
+    signerId?: string;
+    /** ISO-8601; defaults to 5 minutes from now. */
+    deadline?: string;
+    /** 32 bytes; defaults to crypto-random. */
+    nonce?: Uint8Array;
+    /** Defaults to intents.near. Override only for a different verifier deployment. */
+    verifyingContract?: string;
+}
+type OneClickSwapType = "EXACT_INPUT" | "EXACT_OUTPUT" | "FLEX_INPUT" | "ANY_INPUT";
+type OneClickDepositType = "ORIGIN_CHAIN" | "INTENTS" | "CONFIDENTIAL_INTENTS";
+type OneClickRecipientType = "DESTINATION_CHAIN" | "INTENTS" | "CONFIDENTIAL_INTENTS";
+type OneClickDepositMode = "SIMPLE" | "MEMO";
+interface OneClickToken {
+    assetId: string;
+    decimals: number;
+    blockchain: string;
+    symbol: string;
+    price?: number;
+    priceUpdatedAt?: string;
+    contractAddress?: string;
+    coingeckoId?: string;
+}
+interface OneClickAppFee {
+    /** intents.near account that collects the fee. */
+    recipient: string;
+    /** Basis points. */
+    fee: number;
+}
+interface OneClickQuoteRequest {
+    /** true = price preview only (no depositAddress); false commits the quote. */
+    dry: boolean;
+    swapType: OneClickSwapType;
+    /** Basis points, e.g. 100 = 1%. */
+    slippageTolerance: number;
+    originAsset: string;
+    destinationAsset: string;
+    /** Base units of the exact side selected by swapType. */
+    amount: string;
+    depositType: OneClickDepositType;
+    refundTo: string;
+    refundType: OneClickDepositType;
+    recipient: string;
+    recipientType: OneClickRecipientType;
+    /** ISO-8601. */
+    deadline: string;
+    depositMode?: OneClickDepositMode;
+    referral?: string;
+    quoteWaitingTimeMs?: number;
+    appFees?: OneClickAppFee[];
+    insured?: boolean;
+    connectedWallets?: unknown[];
+    sessionId?: string;
+    virtualChainRecipient?: string;
+    virtualChainRefundRecipient?: string;
+    customRecipientMsg?: string;
+}
+interface OneClickQuote {
+    depositAddress?: string;
+    depositMemo?: string;
+    chainDepositAddresses?: Array<{
+        chain: string;
+        depositAddress?: string;
+        memo?: string;
+    }>;
+    amountIn: string;
+    amountInFormatted?: string;
+    amountInUsd?: string;
+    minAmountIn?: string;
+    amountOut: string;
+    amountOutFormatted?: string;
+    amountOutUsd?: string;
+    minAmountOut?: string;
+    deadline?: string;
+    timeWhenInactive?: string;
+    timeEstimate?: number;
+    refundFee?: string;
+    withdrawFee?: string;
+    virtualChainRecipient?: string;
+    virtualChainRefundRecipient?: string;
+    customRecipientMsg?: string;
+}
+interface OneClickQuoteResponse {
+    correlationId?: string;
+    timestamp: string;
+    /** Server-signed quote (verifiable per the 1Click docs). */
+    signature: string;
+    quoteRequest: OneClickQuoteRequest;
+    quote: OneClickQuote;
+}
+type OneClickStatus = "KNOWN_DEPOSIT_TX" | "PENDING_DEPOSIT" | "INCOMPLETE_DEPOSIT" | "PROCESSING" | "SUCCESS" | "REFUNDED" | "FAILED";
+interface OneClickStatusResponse {
+    correlationId?: string;
+    quoteResponse: OneClickQuoteResponse;
+    status: OneClickStatus;
+    updatedAt: string;
+    swapDetails?: {
+        intentHashes?: string[];
+        nearTxHashes?: string[];
+        originChainTxHashes?: Array<{
+            hash: string;
+            explorerUrl?: string;
+        }>;
+        destinationChainTxHashes?: Array<{
+            hash: string;
+            explorerUrl?: string;
+        }>;
+        amountIn?: string;
+        amountInFormatted?: string;
+        amountInUsd?: string;
+        amountOut?: string;
+        amountOutFormatted?: string;
+        amountOutUsd?: string;
+        slippage?: number;
+        depositedAmount?: string;
+        refundedAmount?: string;
+        refundReason?: string;
+        withdrawFee?: string;
+        referral?: string;
+    };
+}
+interface OneClickSubmitDepositRequest {
+    txHash: string;
+    depositAddress: string;
+    nearSenderAccount?: string;
+    memo?: string;
+}
+type OneClickSigningStandard = "nep413" | "erc191" | "raw_ed25519" | "webauthn" | "ton_connect" | "sep53" | "tip191";
+interface OneClickGenerateIntentRequest {
+    signerId: string;
+    depositAddress: string;
+    standard?: OneClickSigningStandard;
+}
+interface OneClickGenerateIntentResponse {
+    /** Unsigned payload to sign — pass it to an IntentSigner's signPayload. */
+    intent: GeneratedUnsignedIntent;
+    correlationId?: string;
+}
+interface OneClickSubmitIntentResponse {
+    intentHash: string;
+    correlationId?: string;
+}
+interface RelayQuoteParams {
+    defuse_asset_identifier_in: IntentsTokenId;
+    defuse_asset_identifier_out: IntentsTokenId;
+    exact_amount_in?: string;
+    exact_amount_out?: string;
+    /** Milliseconds; relay default is 60000. */
+    min_deadline_ms?: number;
+}
+interface RelayQuote {
+    quote_hash: string;
+    defuse_asset_identifier_in: IntentsTokenId;
+    defuse_asset_identifier_out: IntentsTokenId;
+    amount_in: string;
+    amount_out: string;
+    expiration_time: string;
+}
+type RelayIntentStatus = "PENDING" | "TX_BROADCASTED" | "SETTLED" | "NOT_FOUND_OR_NOT_VALID";
+interface RelayPublishResult {
+    status: string;
+    intent_hash: string;
+}
+interface RelayStatusResult {
+    intent_hash: string;
+    status: RelayIntentStatus;
+    status_details?: string;
+    data?: {
+        hash?: string;
+    };
+    filled_amounts?: string[];
+}
+
+export { SOLVER_RELAY_URL as A, type SignIntentsParams as B, type SignPayloadOptions as C, type StorageDepositIntent as D, type TransferIntent as E, type FtWithdrawIntent as F, type GeneratedUnsignedIntent as G, type Intent as I, type MtWithdrawIntent as M, type NativeWithdrawIntent as N, type OneClickToken as O, type RelayIntentStatus as R, type SignedIntent as S, type TokenDiffIntent as T, type UnsignedNep413Payload as U, type OneClickQuoteRequest as a, type OneClickQuoteResponse as b, type OneClickStatusResponse as c, type OneClickSubmitDepositRequest as d, type OneClickGenerateIntentRequest as e, type OneClickGenerateIntentResponse as f, type OneClickSubmitIntentResponse as g, type IntentMessage as h, type IntentSigner as i, type SignedIntentNep413 as j, type IntentsTokenId as k, INTENTS_CONTRACT_ID as l, type NftWithdrawIntent as m, ONE_CLICK_BASE_URL as n, type OneClickAppFee as o, type OneClickDepositMode as p, type OneClickDepositType as q, type OneClickQuote as r, type OneClickRecipientType as s, type OneClickSigningStandard as t, type OneClickStatus as u, type OneClickSwapType as v, type RelayPublishResult as w, type RelayQuote as x, type RelayQuoteParams as y, type RelayStatusResult as z };

package/dist/esm/types.js

@@ -0,0 +1,11 @@
+/* ⋈ 🏃🏻💨 FastNear intents - ESM (@fastnear/intents version 1.6.0) */
+/* https://www.npmjs.com/package/@fastnear/intents/v/1.6.0 */
+const INTENTS_CONTRACT_ID = "intents.near";
+const ONE_CLICK_BASE_URL = "https://1click.chaindefuser.com";
+const SOLVER_RELAY_URL = "https://solver-relay-v2.chaindefuser.com/rpc";
+export {
+  INTENTS_CONTRACT_ID,
+  ONE_CLICK_BASE_URL,
+  SOLVER_RELAY_URL
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts"],"sourcesContent":["/**\n * Protocol types for NEAR Intents (the verifier contract `intents.near`,\n * the 1Click swap API, and the solver relay).\n *\n * Sources of truth:\n * - 1Click OpenAPI: https://1click.chaindefuser.com/docs/v0/openapi.yaml\n * - Verifier docs:  https://docs.near-intents.org/integration/verifier-contract\n * - Solver relay:   https://docs.near-intents.org/integration/market-makers/message-bus/rpc.md\n */\n\n/** The NEAR Intents verifier contract (mainnet). */\nexport const INTENTS_CONTRACT_ID = \"intents.near\";\n\n/** Hosted 1Click swap API base URL. */\nexport const ONE_CLICK_BASE_URL = \"https://1click.chaindefuser.com\";\n\n/** Hosted solver relay JSON-RPC endpoint. */\nexport const SOLVER_RELAY_URL = \"https://solver-relay-v2.chaindefuser.com/rpc\";\n\n/**\n * A multi-token id inside the verifier's NEP-245 ledger:\n * `nep141:<contract>`, `nep171:<contract>:<token_id>`, or\n * `nep245:<contract>:<token_id>`.\n */\nexport type IntentsTokenId = string;\n\n// ---------------------------------------------------------------------------\n// Intent types executed by intents.near\n// ---------------------------------------------------------------------------\n\n/**\n * Trade intent: per-token balance deltas for the signer. Negative amounts are\n * paid by the signer, positive amounts are received. The verifier requires all\n * diffs in a batch to sum to zero per token, so a counterparty (solver) signs\n * the mirror diff.\n */\nexport interface TokenDiffIntent {\n  intent: \"token_diff\";\n  diff: Record<IntentsTokenId, string>;\n  memo?: string;\n  referral?: string;\n}\n\n/** Internal ledger transfer to another intents.near account. */\nexport interface TransferIntent {\n  intent: \"transfer\";\n  receiver_id: string;\n  tokens: Record<IntentsTokenId, string>;\n  memo?: string;\n}\n\n/**\n * Withdraw a NEP-141 token out of the verifier. `token` is the plain token\n * contract id (no `nep141:` prefix). Omit `msg` for refundable ft_transfer\n * semantics; passing `msg` switches to ft_transfer_call with no refund.\n */\nexport interface FtWithdrawIntent {\n  intent: \"ft_withdraw\";\n  token: string;\n  receiver_id: string;\n  amount: string;\n  memo?: string;\n  msg?: string;\n  storage_deposit?: string;\n}\n\nexport interface NftWithdrawIntent {\n  intent: \"nft_withdraw\";\n  token: string;\n  receiver_id: string;\n  token_id: string;\n  memo?: string;\n  msg?: string;\n  storage_deposit?: string;\n}\n\nexport interface MtWithdrawIntent {\n  intent: \"mt_withdraw\";\n  token: string;\n  receiver_id: string;\n  token_ids: string[];\n  amounts: string[];\n  memo?: string;\n  msg?: string;\n  storage_deposit?: string;\n}\n\n/** The only way to withdraw native NEAR: unwraps internal wNEAR on exit. */\nexport interface NativeWithdrawIntent {\n  intent: \"native_withdraw\";\n  receiver_id: string;\n  amount: string;\n}\n\n/**\n * Pay a NEP-145 storage_deposit on a token contract from the signer's\n * internal wNEAR balance (registers a receiver before a withdrawal lands).\n */\nexport interface StorageDepositIntent {\n  intent: \"storage_deposit\";\n  contract_id: string;\n  account_id: string;\n  amount: string;\n}\n\nexport type Intent =\n  | TokenDiffIntent\n  | TransferIntent\n  | FtWithdrawIntent\n  | NftWithdrawIntent\n  | MtWithdrawIntent\n  | NativeWithdrawIntent\n  | StorageDepositIntent;\n\n/**\n * The inner message that gets signed. For the `nep413` standard this JSON\n * string becomes the NEP-413 `message`, while the verifying contract and\n * replay nonce live in the NEP-413 envelope (`recipient` / `nonce`).\n */\nexport interface IntentMessage {\n  signer_id: string;\n  /** ISO-8601 timestamp after which the signed intent is invalid. */\n  deadline: string;\n  intents: Intent[];\n}\n\n// ---------------------------------------------------------------------------\n// Signed payloads (MultiPayload)\n// ---------------------------------------------------------------------------\n\n/**\n * A NEP-413-signed intent as `intents.near`, the solver relay, and 1Click\n * accept it. Note the encodings: `nonce` is base64 of 32 bytes, while\n * `signature` and `public_key` are `ed25519:<base58>` strings — NOT the\n * base64 signature NEAR wallets return.\n */\nexport interface SignedIntentNep413 {\n  standard: \"nep413\";\n  payload: {\n    message: string;\n    nonce: string;\n    recipient: string;\n    callbackUrl?: string;\n  };\n  public_key: string;\n  signature: string;\n}\n\n/**\n * Any signed payload standard the verifier accepts. This package produces\n * `nep413`; the other variants (erc191, tip191, raw_ed25519, webauthn,\n * ton_connect, sep53) are documented pass-through shapes.\n */\nexport type SignedIntent =\n  | SignedIntentNep413\n  | { standard: string; [key: string]: unknown };\n\n/**\n * An unsigned NEP-413 payload, as returned by 1Click's generate-intent\n * endpoint (nonce is base64 of 32 bytes when it arrives as a string).\n */\nexport interface UnsignedNep413Payload {\n  message: string;\n  nonce: string | Uint8Array;\n  recipient: string;\n  callbackUrl?: string;\n}\n\n/**\n * What signPayload accepts: a bare unsigned payload or the\n * { standard, payload } wrapper 1Click's generate-intent returns.\n */\nexport type GeneratedUnsignedIntent =\n  | UnsignedNep413Payload\n  | { standard: string; payload: UnsignedNep413Payload };\n\nexport interface SignPayloadOptions {\n  /**\n   * The verifying contract the payload's recipient must equal. Defaults to\n   * intents.near — a server response naming any other recipient throws\n   * instead of being signed. Set explicitly to sign for a different\n   * (e.g. staging) verifier deployment.\n   */\n  expectedRecipient?: string;\n}\n\n/** The signer surface shared by the wallet and local-key implementations. */\nexport interface IntentSigner {\n  /** Build and sign an intent message this client composes itself. */\n  signIntents(params: SignIntentsParams): Promise<SignedIntentNep413>;\n  /**\n   * Sign a pre-built NEP-413 payload verbatim — the 1Click generate-intent\n   * flow, where the server chooses the message, nonce, and recipient. The\n   * recipient is pinned to intents.near unless options.expectedRecipient\n   * overrides it, so a malicious or buggy server cannot redirect the\n   * signature to another contract.\n   */\n  signPayload(\n    payload: GeneratedUnsignedIntent,\n    options?: SignPayloadOptions,\n  ): Promise<SignedIntentNep413>;\n}\n\nexport interface SignIntentsParams {\n  intents: Intent[];\n  /** Defaults to the connected wallet account / the local signer account. */\n  signerId?: string;\n  /** ISO-8601; defaults to 5 minutes from now. */\n  deadline?: string;\n  /** 32 bytes; defaults to crypto-random. */\n  nonce?: Uint8Array;\n  /** Defaults to intents.near. Override only for a different verifier deployment. */\n  verifyingContract?: string;\n}\n\n// ---------------------------------------------------------------------------\n// 1Click API shapes (v0)\n// ---------------------------------------------------------------------------\n\nexport type OneClickSwapType =\n  | \"EXACT_INPUT\"\n  | \"EXACT_OUTPUT\"\n  | \"FLEX_INPUT\"\n  | \"ANY_INPUT\";\n\nexport type OneClickDepositType =\n  | \"ORIGIN_CHAIN\"\n  | \"INTENTS\"\n  | \"CONFIDENTIAL_INTENTS\";\n\nexport type OneClickRecipientType =\n  | \"DESTINATION_CHAIN\"\n  | \"INTENTS\"\n  | \"CONFIDENTIAL_INTENTS\";\n\nexport type OneClickDepositMode = \"SIMPLE\" | \"MEMO\";\n\nexport interface OneClickToken {\n  assetId: string;\n  decimals: number;\n  blockchain: string;\n  symbol: string;\n  price?: number;\n  priceUpdatedAt?: string;\n  contractAddress?: string;\n  coingeckoId?: string;\n}\n\nexport interface OneClickAppFee {\n  /** intents.near account that collects the fee. */\n  recipient: string;\n  /** Basis points. */\n  fee: number;\n}\n\nexport interface OneClickQuoteRequest {\n  /** true = price preview only (no depositAddress); false commits the quote. */\n  dry: boolean;\n  swapType: OneClickSwapType;\n  /** Basis points, e.g. 100 = 1%. */\n  slippageTolerance: number;\n  originAsset: string;\n  destinationAsset: string;\n  /** Base units of the exact side selected by swapType. */\n  amount: string;\n  depositType: OneClickDepositType;\n  refundTo: string;\n  refundType: OneClickDepositType;\n  recipient: string;\n  recipientType: OneClickRecipientType;\n  /** ISO-8601. */\n  deadline: string;\n  depositMode?: OneClickDepositMode;\n  referral?: string;\n  quoteWaitingTimeMs?: number;\n  appFees?: OneClickAppFee[];\n  insured?: boolean;\n  connectedWallets?: unknown[];\n  sessionId?: string;\n  virtualChainRecipient?: string;\n  virtualChainRefundRecipient?: string;\n  customRecipientMsg?: string;\n}\n\nexport interface OneClickQuote {\n  depositAddress?: string;\n  depositMemo?: string;\n  chainDepositAddresses?: Array<{ chain: string; depositAddress?: string; memo?: string }>;\n  amountIn: string;\n  amountInFormatted?: string;\n  amountInUsd?: string;\n  minAmountIn?: string;\n  amountOut: string;\n  amountOutFormatted?: string;\n  amountOutUsd?: string;\n  minAmountOut?: string;\n  deadline?: string;\n  timeWhenInactive?: string;\n  timeEstimate?: number;\n  refundFee?: string;\n  withdrawFee?: string;\n  virtualChainRecipient?: string;\n  virtualChainRefundRecipient?: string;\n  customRecipientMsg?: string;\n}\n\nexport interface OneClickQuoteResponse {\n  correlationId?: string;\n  timestamp: string;\n  /** Server-signed quote (verifiable per the 1Click docs). */\n  signature: string;\n  quoteRequest: OneClickQuoteRequest;\n  quote: OneClickQuote;\n}\n\nexport type OneClickStatus =\n  | \"KNOWN_DEPOSIT_TX\"\n  | \"PENDING_DEPOSIT\"\n  | \"INCOMPLETE_DEPOSIT\"\n  | \"PROCESSING\"\n  | \"SUCCESS\"\n  | \"REFUNDED\"\n  | \"FAILED\";\n\nexport interface OneClickStatusResponse {\n  correlationId?: string;\n  quoteResponse: OneClickQuoteResponse;\n  status: OneClickStatus;\n  updatedAt: string;\n  swapDetails?: {\n    intentHashes?: string[];\n    nearTxHashes?: string[];\n    originChainTxHashes?: Array<{ hash: string; explorerUrl?: string }>;\n    destinationChainTxHashes?: Array<{ hash: string; explorerUrl?: string }>;\n    amountIn?: string;\n    amountInFormatted?: string;\n    amountInUsd?: string;\n    amountOut?: string;\n    amountOutFormatted?: string;\n    amountOutUsd?: string;\n    slippage?: number;\n    depositedAmount?: string;\n    refundedAmount?: string;\n    refundReason?: string;\n    withdrawFee?: string;\n    referral?: string;\n  };\n}\n\nexport interface OneClickSubmitDepositRequest {\n  txHash: string;\n  depositAddress: string;\n  nearSenderAccount?: string;\n  memo?: string;\n}\n\nexport type OneClickSigningStandard =\n  | \"nep413\"\n  | \"erc191\"\n  | \"raw_ed25519\"\n  | \"webauthn\"\n  | \"ton_connect\"\n  | \"sep53\"\n  | \"tip191\";\n\nexport interface OneClickGenerateIntentRequest {\n  signerId: string;\n  depositAddress: string;\n  standard?: OneClickSigningStandard;\n}\n\nexport interface OneClickGenerateIntentResponse {\n  /** Unsigned payload to sign — pass it to an IntentSigner's signPayload. */\n  intent: GeneratedUnsignedIntent;\n  correlationId?: string;\n}\n\nexport interface OneClickSubmitIntentResponse {\n  intentHash: string;\n  correlationId?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Solver relay JSON-RPC shapes\n// ---------------------------------------------------------------------------\n\nexport interface RelayQuoteParams {\n  defuse_asset_identifier_in: IntentsTokenId;\n  defuse_asset_identifier_out: IntentsTokenId;\n  exact_amount_in?: string;\n  exact_amount_out?: string;\n  /** Milliseconds; relay default is 60000. */\n  min_deadline_ms?: number;\n}\n\nexport interface RelayQuote {\n  quote_hash: string;\n  defuse_asset_identifier_in: IntentsTokenId;\n  defuse_asset_identifier_out: IntentsTokenId;\n  amount_in: string;\n  amount_out: string;\n  expiration_time: string;\n}\n\nexport type RelayIntentStatus =\n  | \"PENDING\"\n  | \"TX_BROADCASTED\"\n  | \"SETTLED\"\n  | \"NOT_FOUND_OR_NOT_VALID\";\n\nexport interface RelayPublishResult {\n  status: string;\n  intent_hash: string;\n}\n\nexport interface RelayStatusResult {\n  intent_hash: string;\n  status: RelayIntentStatus;\n  status_details?: string;\n  data?: { hash?: string };\n  filled_amounts?: string[];\n}\n"],"mappings":";;AAWO,MAAM,sBAAsB;AAG5B,MAAM,qBAAqB;AAG3B,MAAM,mBAAmB;","names":[]}

package/dist/esm/verifier.js

@@ -0,0 +1,124 @@
+/* ⋈ 🏃🏻💨 FastNear intents - ESM (@fastnear/intents version 1.6.0) */
+/* https://www.npmjs.com/package/@fastnear/intents/v/1.6.0 */
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { INTENTS_CONTRACT_ID } from "./types.js";
+const FT_TRANSFER_CALL_GAS = "100000000000000";
+const WITHDRAW_GAS = "100000000000000";
+const WRAP_NEAR_GAS = "30000000000000";
+const ONE_YOCTO = "1";
+const WRAP_NEAR_CONTRACT_ID = "wrap.near";
+function ftDepositAction({
+  amount,
+  creditTo,
+  msg,
+  verifierId = INTENTS_CONTRACT_ID,
+  gas = FT_TRANSFER_CALL_GAS
+}) {
+  if (creditTo !== void 0 && msg !== void 0) {
+    throw new Error("Pass either creditTo or msg, not both");
+  }
+  return {
+    type: "FunctionCall",
+    methodName: "ft_transfer_call",
+    args: {
+      receiver_id: verifierId,
+      amount,
+      msg: msg ?? creditTo ?? ""
+    },
+    gas,
+    deposit: ONE_YOCTO
+  };
+}
+__name(ftDepositAction, "ftDepositAction");
+function wrapNearAction({
+  amountYocto,
+  gas = WRAP_NEAR_GAS
+}) {
+  return {
+    type: "FunctionCall",
+    methodName: "near_deposit",
+    args: {},
+    gas,
+    deposit: amountYocto
+  };
+}
+__name(wrapNearAction, "wrapNearAction");
+function ftWithdrawAction({
+  token,
+  receiverId,
+  amount,
+  memo,
+  msg,
+  storageDeposit,
+  gas = WITHDRAW_GAS
+}) {
+  if (token.includes(":")) {
+    throw new Error(
+      `ft_withdraw takes the plain token contract id, not a prefixed multi-token id: ${token}`
+    );
+  }
+  return {
+    type: "FunctionCall",
+    methodName: "ft_withdraw",
+    args: {
+      token,
+      receiver_id: receiverId,
+      amount,
+      ...memo !== void 0 ? { memo } : {},
+      ...msg !== void 0 ? { msg } : {},
+      ...storageDeposit !== void 0 ? { storage_deposit: storageDeposit } : {}
+    },
+    gas,
+    deposit: ONE_YOCTO
+  };
+}
+__name(ftWithdrawAction, "ftWithdrawAction");
+async function mtBalance({
+  accountId,
+  tokenId,
+  view,
+  verifierId = INTENTS_CONTRACT_ID
+}) {
+  const result = await view({
+    contractId: verifierId,
+    methodName: "mt_balance_of",
+    args: { account_id: accountId, token_id: tokenId }
+  });
+  return String(result ?? "0");
+}
+__name(mtBalance, "mtBalance");
+async function mtBatchBalances({
+  accountId,
+  tokenIds,
+  view,
+  verifierId = INTENTS_CONTRACT_ID
+}) {
+  const result = await view({
+    contractId: verifierId,
+    methodName: "mt_batch_balance_of",
+    args: { account_id: accountId, token_ids: tokenIds }
+  });
+  if (!Array.isArray(result) || result.length !== tokenIds.length) {
+    throw new Error(
+      `mt_batch_balance_of returned ${Array.isArray(result) ? result.length : typeof result} results for ${tokenIds.length} token ids`
+    );
+  }
+  return Object.fromEntries(
+    tokenIds.map((tokenId, index) => [tokenId, String(result[index] ?? "0")])
+  );
+}
+__name(mtBatchBalances, "mtBatchBalances");
+export {
+  FT_TRANSFER_CALL_GAS,
+  ONE_YOCTO,
+  WITHDRAW_GAS,
+  WRAP_NEAR_CONTRACT_ID,
+  WRAP_NEAR_GAS,
+  ftDepositAction,
+  ftWithdrawAction,
+  mtBalance,
+  mtBatchBalances,
+  wrapNearAction
+};
+//# sourceMappingURL=verifier.js.map

package/dist/esm/verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/verifier.ts"],"sourcesContent":["import { INTENTS_CONTRACT_ID, type IntentsTokenId } from \"./types.js\";\n\n/** Gas / deposit defaults for verifier interactions. */\nexport const FT_TRANSFER_CALL_GAS = \"100000000000000\"; // 100 TGas\nexport const WITHDRAW_GAS = \"100000000000000\"; // 100 TGas\nexport const WRAP_NEAR_GAS = \"30000000000000\"; // 30 TGas\nexport const ONE_YOCTO = \"1\";\n\n/** wNEAR contract — native NEAR must be wrapped before depositing. */\nexport const WRAP_NEAR_CONTRACT_ID = \"wrap.near\";\n\n/**\n * The flat FastNEAR action shape. near.sendTx serializes these fields\n * directly, and @fastnear/wallet converts flat actions for near-connect\n * wallets — so one shape works on both signing paths.\n */\nexport interface FunctionCallActionShape {\n  type: \"FunctionCall\";\n  methodName: string;\n  args: Record<string, unknown>;\n  gas: string;\n  deposit: string;\n}\n\n/**\n * Build the `ft_transfer_call` action that deposits a NEP-141 token into the\n * verifier. Apply it ON the token contract:\n *\n *   near.sendTx({ receiverId: \"usdt.tether-token.near\",\n *                 actions: [ftDepositAction({ amount })] })\n *\n * `msg` semantics (per the verifier docs): \"\" credits the sender; an\n * account-id string credits that account (`creditTo`); a JSON string enables\n * execute_intents-on-deposit. Native NEAR is rejected by the verifier —\n * wrap it first (see wrapNearAction).\n */\nexport function ftDepositAction({\n  amount,\n  creditTo,\n  msg,\n  verifierId = INTENTS_CONTRACT_ID,\n  gas = FT_TRANSFER_CALL_GAS,\n}: {\n  amount: string;\n  creditTo?: string;\n  msg?: string;\n  verifierId?: string;\n  gas?: string;\n}): FunctionCallActionShape {\n  if (creditTo !== undefined && msg !== undefined) {\n    throw new Error(\"Pass either creditTo or msg, not both\");\n  }\n  return {\n    type: \"FunctionCall\",\n    methodName: \"ft_transfer_call\",\n    args: {\n      receiver_id: verifierId,\n      amount,\n      msg: msg ?? creditTo ?? \"\",\n    },\n    gas,\n    deposit: ONE_YOCTO,\n  };\n}\n\n/**\n * Build the `near_deposit` action that wraps native NEAR into wNEAR.\n * Apply it ON wrap.near:\n *\n *   near.sendTx({ receiverId: \"wrap.near\",\n *                 actions: [wrapNearAction({ amountYocto })] })\n */\nexport function wrapNearAction({\n  amountYocto,\n  gas = WRAP_NEAR_GAS,\n}: {\n  amountYocto: string;\n  gas?: string;\n}): FunctionCallActionShape {\n  return {\n    type: \"FunctionCall\",\n    methodName: \"near_deposit\",\n    args: {},\n    gas,\n    deposit: amountYocto,\n  };\n}\n\n/**\n * Build the direct-call `ft_withdraw` action that moves a NEP-141 token out\n * of the verifier back to a NEAR account. Apply it ON intents.near. `token`\n * is the plain contract id (no `nep141:` prefix). Omit `msg` so failed\n * withdrawals stay refundable.\n */\nexport function ftWithdrawAction({\n  token,\n  receiverId,\n  amount,\n  memo,\n  msg,\n  storageDeposit,\n  gas = WITHDRAW_GAS,\n}: {\n  token: string;\n  receiverId: string;\n  amount: string;\n  memo?: string;\n  msg?: string;\n  storageDeposit?: string;\n  gas?: string;\n}): FunctionCallActionShape {\n  if (token.includes(\":\")) {\n    throw new Error(\n      `ft_withdraw takes the plain token contract id, not a prefixed multi-token id: ${token}`,\n    );\n  }\n  return {\n    type: \"FunctionCall\",\n    methodName: \"ft_withdraw\",\n    args: {\n      token,\n      receiver_id: receiverId,\n      amount,\n      ...(memo !== undefined ? { memo } : {}),\n      ...(msg !== undefined ? { msg } : {}),\n      ...(storageDeposit !== undefined\n        ? { storage_deposit: storageDeposit }\n        : {}),\n    },\n    gas,\n    deposit: ONE_YOCTO,\n  };\n}\n\n/** A near.view-compatible function, injected so this package stays api-free. */\nexport type ViewFunction = (params: {\n  contractId: string;\n  methodName: string;\n  args: Record<string, unknown>;\n}) => Promise<unknown>;\n\n/** Read one internal balance from the verifier's NEP-245 ledger. */\nexport async function mtBalance({\n  accountId,\n  tokenId,\n  view,\n  verifierId = INTENTS_CONTRACT_ID,\n}: {\n  accountId: string;\n  tokenId: IntentsTokenId;\n  view: ViewFunction;\n  verifierId?: string;\n}): Promise<string> {\n  const result = await view({\n    contractId: verifierId,\n    methodName: \"mt_balance_of\",\n    args: { account_id: accountId, token_id: tokenId },\n  });\n  return String(result ?? \"0\");\n}\n\n/**\n * Read many internal balances in one view call. Returns a map keyed by\n * token id (the RPC returns base-unit strings in request order).\n */\nexport async function mtBatchBalances({\n  accountId,\n  tokenIds,\n  view,\n  verifierId = INTENTS_CONTRACT_ID,\n}: {\n  accountId: string;\n  tokenIds: IntentsTokenId[];\n  view: ViewFunction;\n  verifierId?: string;\n}): Promise<Record<IntentsTokenId, string>> {\n  const result = (await view({\n    contractId: verifierId,\n    methodName: \"mt_batch_balance_of\",\n    args: { account_id: accountId, token_ids: tokenIds },\n  })) as unknown[];\n  if (!Array.isArray(result) || result.length !== tokenIds.length) {\n    throw new Error(\n      `mt_batch_balance_of returned ${Array.isArray(result) ? result.length : typeof result} results for ${tokenIds.length} token ids`,\n    );\n  }\n  return Object.fromEntries(\n    tokenIds.map((tokenId, index) => [tokenId, String(result[index] ?? \"0\")]),\n  );\n}\n"],"mappings":";;;;AAAA,SAAS,2BAAgD;AAGlD,MAAM,uBAAuB;AAC7B,MAAM,eAAe;AACrB,MAAM,gBAAgB;AACtB,MAAM,YAAY;AAGlB,MAAM,wBAAwB;AA2B9B,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb,MAAM;AACR,GAM4B;AAC1B,MAAI,aAAa,UAAa,QAAQ,QAAW;AAC/C,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,MAAM;AAAA,MACJ,aAAa;AAAA,MACb;AAAA,MACA,KAAK,OAAO,YAAY;AAAA,IAC1B;AAAA,IACA;AAAA,IACA,SAAS;AAAA,EACX;AACF;AA3BgB;AAoCT,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA,MAAM;AACR,GAG4B;AAC1B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,MAAM,CAAC;AAAA,IACP;AAAA,IACA,SAAS;AAAA,EACX;AACF;AAdgB;AAsBT,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,MAAM;AACR,GAQ4B;AAC1B,MAAI,MAAM,SAAS,GAAG,GAAG;AACvB,UAAM,IAAI;AAAA,MACR,iFAAiF,KAAK;AAAA,IACxF;AAAA,EACF;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,MAAM;AAAA,MACJ;AAAA,MACA,aAAa;AAAA,MACb;AAAA,MACA,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC;AAAA,MACrC,GAAI,QAAQ,SAAY,EAAE,IAAI,IAAI,CAAC;AAAA,MACnC,GAAI,mBAAmB,SACnB,EAAE,iBAAiB,eAAe,IAClC,CAAC;AAAA,IACP;AAAA,IACA;AAAA,IACA,SAAS;AAAA,EACX;AACF;AAtCgB;AAgDhB,eAAsB,UAAU;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AACf,GAKoB;AAClB,QAAM,SAAS,MAAM,KAAK;AAAA,IACxB,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,MAAM,EAAE,YAAY,WAAW,UAAU,QAAQ;AAAA,EACnD,CAAC;AACD,SAAO,OAAO,UAAU,GAAG;AAC7B;AAjBsB;AAuBtB,eAAsB,gBAAgB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AACf,GAK4C;AAC1C,QAAM,SAAU,MAAM,KAAK;AAAA,IACzB,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,MAAM,EAAE,YAAY,WAAW,WAAW,SAAS;AAAA,EACrD,CAAC;AACD,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,SAAS,QAAQ;AAC/D,UAAM,IAAI;AAAA,MACR,gCAAgC,MAAM,QAAQ,MAAM,IAAI,OAAO,SAAS,OAAO,MAAM,gBAAgB,SAAS,MAAM;AAAA,IACtH;AAAA,EACF;AACA,SAAO,OAAO;AAAA,IACZ,SAAS,IAAI,CAAC,SAAS,UAAU,CAAC,SAAS,OAAO,OAAO,KAAK,KAAK,GAAG,CAAC,CAAC;AAAA,EAC1E;AACF;AAxBsB;","names":[]}