> For the complete documentation index, see [llms.txt](https://docs.smithii.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smithii.io/products/tools/near/wrapper.md).

# Wrapper on NEAR

Convert NEAR to wNEAR and back, always 1:1, with the official wrap.near contract and a single wallet approval.

The Wrapper on NEAR converts **NEAR into wNEAR and back**, always 1:1. wNEAR is NEAR "wrapped" as a NEP-141 token, held in the official **`wrap.near`** contract. You need it because native NEAR is not a token: NEAR DEXs and DeFi apps (such as Rhea, formerly Ref Finance) work with wNEAR, not with NEAR.

Use it if you need wNEAR to add liquidity, swap or use protocols that only accept NEP-141 tokens. Rhea pools for tokens created with Smithii are paired against wNEAR.

## Open the tool

* [Open the Wrapper on NEAR](https://tools.smithii.io/wrap-token/near)

## How it works

1. **Connect** a NEAR wallet.
2. **Choose the direction**: the tool opens in "Wrap" (NEAR to wNEAR). The round button in the middle switches to "Unwrap" (wNEAR to NEAR) and back. Switching direction clears the amount.
3. **Enter the amount** in the top card ("You Wrap" or "You Unwrap"). The bottom card ("You Receive") shows the same amount, because the conversion is 1:1. There are **50%** and **MAX** shortcuts, and your NEAR and wNEAR balances are shown.
4. Click **Wrap** or **Unwrap** and approve in your wallet. The Smithii fee payment and the conversion go in **a single wallet request**.
5. **Success screen**: it shows the amount converted and a link to the transaction on NearBlocks.

## Features and options

### Wrap and unwrap

* **Wrap**: your wallet calls `near_deposit` on `wrap.near` with the amount as a deposit. The contract creates the same amount of wNEAR for your account.
* **Unwrap**: your wallet calls `near_withdraw` on `wrap.near` (with one yoctoNEAR, a tiny amount the contract requires). The contract burns that wNEAR and returns the same amount of NEAR. You can unwrap **any amount** up to your wNEAR balance; you don't have to unwrap everything.

### MAX

**MAX when wrapping** keeps aside what you need for the Smithii fee, the gas margin and the `wrap.near` registration if it doesn't exist yet, so the full wrap always fits. If your balance is equal to or below that reserve, the card tells you there is nothing to wrap.

### Storage (registration in wrap.near)

Like any NEP-141 token, wNEAR only keeps balances for **registered** accounts. The **first time** an account wraps, the Wrapper adds a `storage_deposit` of **0.00125 NEAR** in the same operation, before the wrap, so the full amount is wrapped. This is a protocol cost, not a Smithii fee: it goes to `wrap.near` and is only paid once. Value checked on-chain on 2026-10-26.

### If something fails

If the fee was paid but the conversion did not complete, the fee is **saved in your browser** and the next wrap or unwrap attempt **does not charge it again** ("Smithii Fee: Already paid"). If your wallet doesn't confirm whether the payment was sent, the tool checks the chain before charging again. If it can't tell, it asks you to check the activity on NearBlocks and offers to discard the pending payment. The notice that the fee is kept only exists in that browser.

## Limits

| Item   | Limit                                                                                                                              |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| Amount | Greater than 0                                                                                                                     |
| Wrap   | Your wallet must hold the amount plus the fee, a gas margin (unused gas is returned) and, the first time, the storage registration |
| Unwrap | Not above your wNEAR balance; you need NEAR for the fee and the gas                                                                |

## Fees

The Smithii fee is charged **per operation**, both when wrapping and when unwrapping.

| Action                 | Smithii fee |
| ---------------------- | ----------- |
| Wrap (NEAR to wNEAR)   | 0.12 NEAR   |
| Unwrap (wNEAR to NEAR) | 0.12 NEAR   |

Not a Smithii fee: **0.00125 NEAR** for the `wrap.near` registration the first time (see above).

Network gas is paid separately. Fees were checked on 2026-10-26 and can change: the tool shows the exact amount before you sign.

## Good to know

* **1:1**: the NEAR you wrap stays in the official `wrap.near` contract and there is no conversion fee. You receive exactly the same amount.
* **No custody by Smithii**: wNEAR is issued by `wrap.near`, not by Smithii. The Wrapper only prepares the calls and charges its fee. You can always unwrap directly on `wrap.near` without the tool.
* **Keep some NEAR in your wallet**: wrapping your whole balance leaves the account with no NEAR to pay gas for future operations. MAX already keeps a reserve, but keep a bit more if you plan to keep operating.
* **Unwrapping also has a fee**: if you only need to unwrap, the cost is 0.12 NEAR plus gas.

{% hint style="warning" %}
A pending fee is never charged twice, but that memory lives in your browser. If you switch browser or clear your data, it is not recovered automatically.
{% endhint %}

## FAQ

### What is wNEAR and why do I need it?

It is NEAR as a NEP-141 token, in `wrap.near`. DEXs like Rhea trade with wNEAR, not with native NEAR.

### How much does it cost to wrap or unwrap?

0.12 NEAR in Smithii fees per operation, plus gas. The first time you use `wrap.near`, 0.00125 NEAR of registration is added.

### Do I always get the same amount I send?

Yes, 1:1 in both directions. The tool applies no conversion fee.

### Can I unwrap only part?

Yes, any amount up to your wNEAR balance.

### What happens if it fails after I pay the fee?

The fee is saved in your browser and the next attempt does not charge it again.

### Do I have to approve twice in my wallet?

No: the fee and the conversion are signed in a single request.

## Related

* [Wrapper overview](https://docs.smithii.io/products/tools/compare/wrapper.md)
* [Liquidity Pool on NEAR](https://docs.smithii.io/products/tools/near/liquidity-pool.md)
* [Token Creator on NEAR](https://docs.smithii.io/products/tools/near/token-creator.md)
* [wNEAR](https://smithii.io/en/wrapped-near/)
