useVault

import { useVault } from "@0xmonaco/react";

const { 
  approve,
  deposit,
  withdraw,
  retryWithdrawal,
  listPendingWithdrawals,
  getAllowance,
  needsApproval
} = useVault();

Vault Operations

(assetId, amount, autoWait?) => Promise<TransactionResult>

Deposit tokens into vault. Use asset UUID from sdk.profile.getUserBalances().

(assetId, amount, autoWait?, source?) => Promise<WithdrawResult>

Withdraw tokens from vault. Use asset UUID from sdk.profile.getUserBalances(). source is "spot" or "margin"; see sdk.vault.withdraw.

(withdrawalIndex, autoWait?) => Promise<WithdrawResult>

Retry the on-chain submission of a withdrawal that never landed. It does not create a new withdrawal; see sdk.vault.retryWithdrawal.

(params?) => Promise<ListPendingWithdrawalsResponse>

List the caller’s withdrawals still awaiting on-chain confirmation, newest first, cursor-paginated with pageSize and pageToken. Wraps sdk.withdrawals.listPendingWithdrawals.

Token Approvals

(assetId, amount, autoWait?) => Promise<TransactionResult>

Approve vault to spend tokens. Use asset UUID from trading pairs.

(assetId) => Promise<bigint>

Check current token allowance by asset UUID

(assetId, amount) => Promise<boolean>

Check if approval is needed for an asset UUID

Validation Requirements

All vault operations include built-in validation to prevent common errors:

Required Parameters: Asset ID must be a non-empty string, and amount must be greater than 0.

Validation Checks:

Operation	Validation	Error Message
`deposit()`	SDK available	”SDK not available”
	Asset ID non-empty	”Asset ID is required and cannot be empty”
	Amount > 0n	”Amount must be greater than 0”
`withdraw()`	SDK available	”SDK not available”
	Asset ID non-empty	”Asset ID is required and cannot be empty”
	Amount > 0n	”Amount must be greater than 0”
`retryWithdrawal()`	SDK available	”SDK not available”
	Index is a non-negative integer	”withdrawalIndex must be a non-negative integer”
`listPendingWithdrawals()`	SDK available	”SDK not available”
`approve()`	SDK available	”SDK not available”
	Asset ID non-empty	”Asset ID is required and cannot be empty”
	Amount > 0n	”Amount must be greater than 0”
`getAllowance()`	SDK available	”SDK not available”
	Asset ID non-empty	”Asset ID is required and cannot be empty”
`needsApproval()`	SDK available	”SDK not available”
	Asset ID non-empty	”Asset ID is required and cannot be empty”
	Amount > 0n	”Amount must be greater than 0”

Example with error handling:

import { useVault } from "@0xmonaco/react";

function DepositButton({ assetId, amount }: { assetId: string; amount: bigint }) {
  const { deposit } = useVault();

  const handleDeposit = async () => {
    try {
      // Validation happens automatically
      const result = await deposit(assetId, amount);
      console.log('Deposit successful:', result.transactionHash);
    } catch (error) {
      // Handle validation errors
      if (error.message.includes('Asset ID is required')) {
        alert('Please select an asset');
      } else if (error.message.includes('Amount must be greater')) {
        alert('Please enter a valid amount');
      } else if (error.message.includes('SDK not available')) {
        alert('SDK is still loading, please wait');
      } else {
        console.error('Deposit failed:', error);
      }
    }
  };

  return <button onClick={handleDeposit}>Deposit</button>;
}

Learn

Build

Libraries

APIs

Resources

Vault Operations

Token Approvals

Validation Requirements

​Vault Operations

​Token Approvals

​Validation Requirements

Vault Operations

Token Approvals

Validation Requirements