@0xmonaco/core 1.0.43 → 1.0.44

package/dist/api/vault/api.d.ts

@@ -23,7 +23,7 @@
  * console.log(`Deposit transaction: ${result.hash}`);
  * ```
  */
-import type { ApplicationsAPI, Balance, DepositTarget, ProfileAPI, TransactionResult, VaultAPI, WithdrawalRetryOptions, WithdrawalSource, WithdrawResult } from "@0xmonaco/types";
+import type { ApplicationsAPI, Balance, DepositOptions, DepositTarget, ProfileAPI, TransactionResult, VaultAPI, WithdrawalRetryOptions, WithdrawalSource, WithdrawResult } from "@0xmonaco/types";
 import { type Address, type Chain, type PublicClient, type WalletClient } from "viem";
 import { BaseAPI } from "../base";
 /**
@@ -139,8 +139,11 @@ export declare class VaultAPIImpl extends BaseAPI implements VaultAPI {
      * standard ERC20 assets. The wrapped-native asset (e.g. WSEI, flagged
      * `wrappedNative` in the balances API) is deposited in native coin via the
      * payable `depositNative` — the vault wraps it into the ERC20 on entry — so
-     * no approval is needed and `amount` is sent as msg.value. Withdrawals of the
-     * wrapped-native asset pay out native coin (the vault unwraps).
+     * no approval is needed and `amount` is sent as msg.value. A wallet holding
+     * the wrapped ERC20 itself can pass `options.asErc20` to deposit it through
+     * the standard `approve()` + `depositERC20` path instead. Either way,
+     * withdrawals of the wrapped-native asset pay out native coin (the vault
+     * unwraps).
      *
      * @param assetId - The asset identifier (UUID) to deposit
      * @param amount - The amount of tokens to deposit (as bigint)
@@ -149,6 +152,9 @@ export declare class VaultAPIImpl extends BaseAPI implements VaultAPI {
      *   wallet; `"margin"` routes the deposit into the parent margin account's
      *   collateral (auto-creating the account if needed). Margin deposits that
      *   cannot be routed safely fall back to spot.
+     * @param options - Deposit options; `asErc20` deposits the wrapped-native
+     *   asset as its ERC20 via `depositERC20` (requires approval) instead of in
+     *   native coin. No effect on other assets.
      * @returns Promise resolving to TransactionResult with transaction details
      * @throws {ContractError} When deposit fails or approval is insufficient
      * @throws {APIError} When the asset is not found or the assetId is invalid
@@ -182,7 +188,7 @@ export declare class VaultAPIImpl extends BaseAPI implements VaultAPI {
      * const receipt = await sdk.waitForTransaction(result.hash);
      * ```
      */
-    deposit(assetId: string, amount: bigint, autoWait?: boolean, target?: DepositTarget): Promise<TransactionResult>;
+    deposit(assetId: string, amount: bigint, autoWait?: boolean, target?: DepositTarget, options?: DepositOptions): Promise<TransactionResult>;
     /**
      * Polls `GET /api/v1/withdrawals/{index}` until the gateway can serve the
      * `executeWithdrawal` calldata, then returns it with the vault address.
@@ -325,13 +331,17 @@ export declare class VaultAPIImpl extends BaseAPI implements VaultAPI {
      * Compares the current allowance with the requested amount to determine if
      * the user needs to approve more tokens before performing operations.
      *
-     * The wrapped-native asset (e.g. WSEI) never needs approval: its deposits
-     * are made in native coin via the payable `depositNative` (the vault wraps
-     * on entry), so no ERC20 allowance is consumed and this method returns
-     * `false` without reading the chain.
+     * The wrapped-native asset (e.g. WSEI) does not need approval by default:
+     * its deposits are made in native coin via the payable `depositNative` (the
+     * vault wraps on entry), so no ERC20 allowance is consumed and this method
+     * returns `false` without reading the chain. An `options.asErc20` deposit of
+     * that asset goes through `depositERC20` and consumes a real allowance, so
+     * pass the same options here to check it.
      *
      * @param assetId - The asset identifier (UUID) to check for
      * @param amount - The amount to check approval for (as bigint)
+     * @param options - Deposit options the approval is for; with `asErc20` the
+     *   wrapped-native asset's real ERC20 allowance is read.
      * @returns Promise resolving to true if approval is needed, false otherwise
      * @throws {ContractError} When approval check fails or asset not found
      *
@@ -348,6 +358,6 @@ export declare class VaultAPIImpl extends BaseAPI implements VaultAPI {
      * }
      * ```
      */
-    needsApproval(assetId: string, amount: bigint): Promise<boolean>;
+    needsApproval(assetId: string, amount: bigint, options?: DepositOptions): Promise<boolean>;
     private waitForTransaction;
 }

package/dist/api/vault/api.js

@@ -228,8 +228,11 @@ export class VaultAPIImpl extends BaseAPI {
      * standard ERC20 assets. The wrapped-native asset (e.g. WSEI, flagged
      * `wrappedNative` in the balances API) is deposited in native coin via the
      * payable `depositNative` — the vault wraps it into the ERC20 on entry — so
-     * no approval is needed and `amount` is sent as msg.value. Withdrawals of the
-     * wrapped-native asset pay out native coin (the vault unwraps).
+     * no approval is needed and `amount` is sent as msg.value. A wallet holding
+     * the wrapped ERC20 itself can pass `options.asErc20` to deposit it through
+     * the standard `approve()` + `depositERC20` path instead. Either way,
+     * withdrawals of the wrapped-native asset pay out native coin (the vault
+     * unwraps).
      *
      * @param assetId - The asset identifier (UUID) to deposit
      * @param amount - The amount of tokens to deposit (as bigint)
@@ -238,6 +241,9 @@ export class VaultAPIImpl extends BaseAPI {
      *   wallet; `"margin"` routes the deposit into the parent margin account's
      *   collateral (auto-creating the account if needed). Margin deposits that
      *   cannot be routed safely fall back to spot.
+     * @param options - Deposit options; `asErc20` deposits the wrapped-native
+     *   asset as its ERC20 via `depositERC20` (requires approval) instead of in
+     *   native coin. No effect on other assets.
      * @returns Promise resolving to TransactionResult with transaction details
      * @throws {ContractError} When deposit fails or approval is insufficient
      * @throws {APIError} When the asset is not found or the assetId is invalid
@@ -271,21 +277,25 @@ export class VaultAPIImpl extends BaseAPI {
      * const receipt = await sdk.waitForTransaction(result.hash);
      * ```
      */
-    async deposit(assetId, amount, autoWait = true, target = "spot") {
+    async deposit(assetId, amount, autoWait = true, target = "spot", options = {}) {
         if (!this.walletClient) {
             throw new InvalidConfigError("Wallet client not set. Connect a wallet first.", "walletClient");
         }
         // Validate inputs
-        validate(DepositSchema, { assetId, amount, autoWait, target });
+        validate(DepositSchema, { assetId, amount, autoWait, target, options });
         const vaultAddress = await this.getVaultAddress();
         const clientId = await this.getClientId();
         // The on-chain applicationData carries the client id plus, for margin
         // deposits, the routing hint the indexer decodes.
         const applicationData = encodeDepositApplicationData(clientId, target);
         const { tokenAddress, isWrappedNative } = await this.resolveAsset(assetId);
-        if (!isWrappedNative) {
+        // The wrapped-native asset normally deposits in native coin, but asErc20
+        // opts into the standard ERC20 path for wallets holding the wrapped ERC20
+        // itself (the vault accepts it like any enabled token).
+        const useNativePath = isWrappedNative && options.asErc20 !== true;
+        if (!useNativePath) {
             // Check if approval is needed before proceeding
-            const needsApproval = await this.needsApproval(assetId, amount);
+            const needsApproval = await this.needsApproval(assetId, amount, options);
             if (needsApproval) {
                 throw new ContractError(`Approval required before deposit. Please invoke approve() first for asset ${assetId} (token address: ${tokenAddress}).`, {
                     revertReason: "APPROVAL_REQUIRED",
@@ -298,9 +308,10 @@ export class VaultAPIImpl extends BaseAPI {
         }
         // For the wrapped-native asset (e.g. WSEI), use depositNative (payable) — the
         // vault wraps the native coin into the ERC20 on entry, so no allowance is
-        // involved. All other ERC20 tokens go through approve + depositERC20.
+        // involved. All other ERC20 tokens (and asErc20 wrapped-native deposits) go
+        // through approve + depositERC20.
         let hash;
-        if (isWrappedNative) {
+        if (useNativePath) {
             hash = await this.walletClient.writeContract({
                 address: vaultAddress,
                 abi: CONTRACT_ABIS.vault,
@@ -616,13 +627,17 @@ export class VaultAPIImpl extends BaseAPI {
      * Compares the current allowance with the requested amount to determine if
      * the user needs to approve more tokens before performing operations.
      *
-     * The wrapped-native asset (e.g. WSEI) never needs approval: its deposits
-     * are made in native coin via the payable `depositNative` (the vault wraps
-     * on entry), so no ERC20 allowance is consumed and this method returns
-     * `false` without reading the chain.
+     * The wrapped-native asset (e.g. WSEI) does not need approval by default:
+     * its deposits are made in native coin via the payable `depositNative` (the
+     * vault wraps on entry), so no ERC20 allowance is consumed and this method
+     * returns `false` without reading the chain. An `options.asErc20` deposit of
+     * that asset goes through `depositERC20` and consumes a real allowance, so
+     * pass the same options here to check it.
      *
      * @param assetId - The asset identifier (UUID) to check for
      * @param amount - The amount to check approval for (as bigint)
+     * @param options - Deposit options the approval is for; with `asErc20` the
+     *   wrapped-native asset's real ERC20 allowance is read.
      * @returns Promise resolving to true if approval is needed, false otherwise
      * @throws {ContractError} When approval check fails or asset not found
      *
@@ -639,11 +654,12 @@ export class VaultAPIImpl extends BaseAPI {
      * }
      * ```
      */
-    async needsApproval(assetId, amount) {
+    async needsApproval(assetId, amount, options = {}) {
         const { isWrappedNative } = await this.resolveAsset(assetId);
-        if (isWrappedNative) {
+        if (isWrappedNative && options.asErc20 !== true) {
             // Wrapped-native deposits route to the payable depositNative — no ERC20
-            // allowance is consumed, so approval is never needed.
+            // allowance is consumed, so approval is never needed. asErc20 deposits
+            // go through depositERC20 and fall through to the real allowance read.
             return false;
         }
         const allowance = await this.getAllowance(assetId);

package/package.json

@@ -1,12 +1,8 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.43",
+	"version": "1.0.44",
 	"type": "module",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/Monaco-Research/monaco-sdk.git",
-		"directory": "packages/core"
-	},
+	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
 	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -23,8 +19,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.43",
-		"@0xmonaco/types": "1.0.43",
+		"@0xmonaco/contracts": "1.0.44",
+		"@0xmonaco/types": "1.0.44",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"