← Back to Home

WrapCrypto.xyz Documentation

Introduction

WrapCrypto.xyz is a cross-chain token wrapping interface for converting native tokens like SOL, ETH, and MATIC into their wrapped equivalents (WSOL, WETH, WMATIC) across major L1 and L2 networks. This page explains how to use the app, how wrapping works under the hood, and how teams can incorporate WrapCrypto into their own flows.

Concepts Overview

Native vs. wrapped tokens

Native tokens are the "base" assets of a blockchain:

  • Solana: SOL
  • Ethereum: ETH
  • Polygon: MATIC

Wrapped tokens are representations of these assets that follow the chain's token standard:

  • WSOL is a wrapped SPL token representation of SOL.
  • WETH is an ERC-20 representation of ETH.
  • WMATIC is an ERC-20 representation of MATIC.

Smart contracts, DeFi protocols, and many dApps expect tokens to follow these standards (SPL, ERC-20), which is why wrapping is necessary.

What WrapCrypto.xyz does (and does not do)

WrapCrypto.xyz:

  • Wraps native tokens into their wrapped equivalents.
  • Unwraps wrapped tokens back to their native form.
  • Supports mainnets and testnets across several chains.
  • Provides onboarding guidance for Phantom and MetaMask.

WrapCrypto.xyz does NOT:

  • Perform swaps or trades.
  • Route through AMMs or order books.
  • Take custody of user funds.

Supported Networks & Assets

Solana

Native:SOL
Wrapped:WSOL (SPL)
Wallet:Phantom
Networks:Mainnet, Devnet

Ethereum

Native:ETH
Wrapped:WETH (ERC-20)
Wallet:MetaMask
Networks:Mainnet, Sepolia

Base

Native:ETH
Wrapped:WETH (ERC-20)
Wallet:MetaMask
Networks:Base Mainnet, Base Sepolia

Arbitrum

Native:ETH
Wrapped:WETH (ERC-20)
Wallet:MetaMask
Networks:Arbitrum One, Arbitrum Sepolia

Polygon

Native:MATIC
Wrapped:WMATIC (ERC-20)
Wallet:MetaMask
Networks:Polygon Mainnet, Polygon Amoy

Optimism

Native:ETH
Wrapped:WETH (ERC-20)
Wallet:MetaMask
Networks:Optimism Mainnet, Optimism Sepolia

Using WrapCrypto.xyz (User Guide)

1. Select environment and network

  1. Open WrapCrypto.xyz and navigate to the app.
  2. Choose Mainnet or Testnet in the environment toggle.
  3. Select the network you want to use (e.g. Solana, Ethereum, Base, etc.).

The app uses this selection to know which wallet type and token pair to show.

2. Connect your wallet

For Solana:

  • The app will suggest Phantom.
  • Connect Phantom when prompted.
  • If you want to use Devnet, enable "Testnet Mode" in Phantom's settings.

For EVM chains:

  • The app will suggest MetaMask.
  • Connect MetaMask when prompted.
  • Ensure that you are on the correct network (e.g. Sepolia, Base Sepolia, etc.).

3. Wrap tokens

  1. Switch to the "Wrap" tab.
  2. Enter the amount of native token you want to wrap.
  3. Verify the "From" and "To" tokens, e.g. SOL → WSOL or ETH → WETH.
  4. Click the Wrap button.
  5. Approve the transaction in your wallet.

Once confirmed, your wrapped token balance should increase and your native token balance should decrease by the same amount (minus any network fees).

4. Unwrap tokens

  1. Switch to the "Unwrap" tab.
  2. Enter the amount of wrapped token you want to convert back.
  3. Verify the "From" and "To" tokens, e.g. WSOL → SOL or WETH → ETH.
  4. Click the Unwrap button.
  5. Approve the transaction in your wallet.

After confirmation, your native token balance should increase and the wrapped balance should decrease accordingly.

Testnet Usage

Phantom testnet setup (Solana)

  1. Open Phantom.
  2. Go to Settings → Developer Settings.
  3. Enable Testnet Mode.
  4. Choose Devnet as the active network.
  5. Request test SOL from a Devnet faucet if needed.

MetaMask testnet setup (EVM networks)

  1. Open MetaMask.
  2. Open the network selector and go to Settings or "Show test networks".
  3. Enable display of test networks.
  4. Select the desired testnet (Sepolia, Base Sepolia, Arbitrum Sepolia, Amoy, Optimism Sepolia).
  5. Request test ETH or MATIC from the appropriate faucet.

Once set up, select Testnet in the WrapCrypto environment toggle and the app will align with your wallet network.

Developer Notes

Use cases for developers

Developers can:

  • Use WrapCrypto as a recommended tool for onboarding users to WSOL/WETH/WMATIC.
  • Link directly to the app with a preselected network (e.g. ?chain=solana&env=testnet) if your implementation supports URL parameters.
  • Integrate documentation links to WrapCrypto in tutorials or workshops.

Integration ideas

"Before you start this tutorial, wrap some of your SOL into WSOL using WrapCrypto.xyz."

"To provide liquidity to this pool, first wrap your ETH into WETH at WrapCrypto.xyz."

"For testnet demos, enable testnets in your wallet and wrap small amounts via WrapCrypto."

Troubleshooting

Common issues

Contact & Feedback

If you encounter issues, want to propose features, or plan an integration with WrapCrypto.xyz:

Launch WrapCrypto App