Platform wallet withdrawal

WalletWithdrawal is an atomic, loan-independent component for moving assets held by the user’s platform wallet. It uses live wallet positions instead of asking the application to supply asset balances. This is different from WithdrawCollateral, which removes collateral from a specific loan and is constrained by that loan’s health factor.

Install

npx shadcn@latest add https://ui.satsterminal.com/r/wallet-withdrawal.json

The registry installs BorrowProvider and the required shadcn primitives when they are not already present.

WalletWithdrawal requires @satsterminal-sdk/borrow 1.7.2 or later. Earlier versions do not return the asynchronous EVM withdrawal transaction ID correctly.

Render

import { WalletWithdrawal } from "@/components/wallet-withdrawal";

<BorrowProvider apiKey={apiKey} wallet={walletProvider} autoRestore autoStart>
  <WalletWithdrawal
    defaultEvmAddress={connectedEvmAddress}
    onTransactionCreated={(transactionId) => {
      console.log("Withdrawal created", transactionId);
    }}
  />
</BorrowProvider>

SDK methods

Method	Responsibility
`getWalletPositions()`	Loads platform-wallet assets, balances, symbols, and chains
`withdrawToEVM()`	Creates a sponsored same-chain transfer to an EVM address
`getWithdrawStatus()`	Tracks the withdrawal and exposes the final transaction hash

EVM destination

Transfers the selected asset on its existing source chain.
Validates the destination as an EVM address.
Uses the platform wallet at index 0.
Gas is sponsored by the platform.

Balance and status behavior

The component prevents zero, negative, and over-balance submissions. The Max action uses the live position balance. After submission, it polls the asynchronous transaction, exposes an explorer link when the final hash is available, and refreshes wallet positions on completion.

<WalletWithdrawal
  pollIntervalMs={5_000}
  onComplete={(progress) => {
    console.log(progress.stage, progress.transactionHash);
  }}
/>

An asset visible in the platform wallet is selectable only when sponsored EVM transfer is configured for that asset and chain.

Overview

Suite

UI Components

Swaps

Borrow

Bridge

Earn

Platform Wallet Withdrawal

Platform wallet withdrawal

Install

Render

SDK methods

EVM destination

Balance and status behavior

​Platform wallet withdrawal

​Install

​Render

​SDK methods

​EVM destination

​Balance and status behavior

Platform wallet withdrawal

Install

Render

SDK methods

EVM destination

Balance and status behavior