How to Wrap and Unwrap SOL on the Solana Blockchain

·

The Solana Token Program allows native SOL to be wrapped, enabling it to be treated like any other SPL token. This functionality is essential for interacting with decentralized applications (dApps), smart contracts, and protocols that exclusively handle tokenized assets.

Wrapped SOL is held in an account associated with a specific mint address known as the "Native Mint": So11111111111111111111111111111111111111112. This guide provides a clear, step-by-step breakdown of the entire process.

Understanding Wrapped SOL

Wrapping SOL converts the native cryptocurrency of the Solana blockchain into an SPL token standard. This conversion is crucial because many DeFi protocols, decentralized exchanges, and smart contracts are built to interact with SPL tokens, not the native SOL currency itself.

By wrapping SOL, you gain the ability to use it seamlessly across the entire Solana ecosystem. The wrapped version maintains a 1:1 value parity with native SOL.

Prerequisites for Wrapping SOL

Before you begin, ensure you have the following:

Step-by-Step Guide to Wrapping SOL

1. Create an Associated Token Account (ATA)

An Associated Token Account (ATA) is a specialized account that holds tokens for a specific user and mint. It is a PDA (Program Derived Address) derived from a user's wallet address and a token mint address. You need an ATA to hold your wrapped SOL.

The getOrCreateAssociatedTokenAccount function is used to find an existing ATA or create a new one if it doesn't exist.

const tokenAccount = await getOrCreateAssociatedTokenAccount(
    connection,       // Connection to the Solana cluster
    payer,            // Keypair of the account paying for the transaction
    mint,             // PublicKey of the mint (Use NATIVE_MINT for SOL)
    owner,            // PublicKey of the ATA's owner
    allowOwnerOffCurve, // Boolean, allows the owner account to be a PDA
    commitment,       // Optional commitment level for querying state
    confirmOptions,   // Options for confirming the transaction
    programId,        // SPL Token program ID
    associatedTokenProgramId // Associated Token program ID
);

2. Build the Transaction Instructions

Wrapping SOL is a two-step process executed in a single transaction:

  1. Transfer native SOL to the newly created ATA.
  2. Invoke the syncNative instruction to update the token balance of the ATA to reflect the received SOL.

First, create the syncNative instruction.

const syncNativeIx = createSyncNativeInstruction(
    tokenAccount,  // The ATA address where the SOL was sent
    programId      // SPL Token program ID
);

Then, build the complete transaction by combining a system instruction to transfer SOL with the syncNative instruction.

// Create a transfer instruction to send SOL to the ATA
const transferInstruction = SystemProgram.transfer({
    fromPubkey: payer.publicKey,
    toPubkey: tokenAccount.address,
    lamports: LAMPORTS_PER_SOL, // Amount of SOL to wrap (1 SOL in this case)
});

// Add both instructions to a new transaction
const transaction = new Transaction().add(transferInstruction, syncNativeIx);

3. Send and Confirm the Transaction

Sign and broadcast the transaction to the Solana network. The sendAndConfirmTransaction function handles this process.

const signature = await sendAndConfirmTransaction(
    connection,     // Connection to the Solana cluster
    transaction,    // The transaction object containing the instructions
    [payer]         // Array of signers (the payer in this case)
);
console.log('Transaction confirmed with signature:', signature);

👉 Explore more strategies for transaction management

Upon successful confirmation, your ATA will hold the wrapped SOL balance.

How to Unwrap SOL

Unwrapping converts your wrapped SOL back into native SOL. This is achieved by closing the ATA that holds the wrapped SOL. When an ATA is closed, its token balance is destroyed, and the equivalent amount of native SOL (minus rent exemption) is sent back to a specified account.

Close the Associated Token Account

Use the closeAccount instruction to unwind your position.

await closeAccount(
    connection,     // Connection to the Solana cluster
    payer,          // Keypair paying the transaction fee
    tokenAccount,   // PublicKey of the ATA to be closed
    destination,    // PublicKey to receive the closed account's rent exemption
    authority       // Keypair authorizing the close operation (usually the owner)
);

After closing the account, the native SOL will be available in your destination wallet.

Estimating Transaction Costs

It's good practice to estimate the cost (in lamports) of a transaction before sending it. This helps manage fees and avoid errors.

// Calculate the estimated fee for a transaction
const estimatedFee = await transaction.getEstimatedFee(connection);
console.log(`Estimated transaction cost: ${estimatedFee} lamports`);

Transaction costs are typically minimal on Solana, but checking them can prevent surprises during network congestion.

Frequently Asked Questions

What is the difference between native SOL and wrapped SOL?
Native SOL is the fundamental currency of the Solana blockchain, used for paying transaction fees and staking. Wrapped SOL (wSOL) is an SPL token that represents SOL on a 1:1 basis, allowing it to be used in smart contracts and applications that only support the SPL token standard.

Why would I need to wrap my SOL?
You need to wrap SOL to interact with most DeFi protocols on Solana, such as decentralized exchanges (DEXs) like Orca or Raydium, lending platforms, and NFT marketplaces. These applications are built to work with SPL tokens.

Is there a risk of losing my SOL when wrapping or unwrapping?
The process is trustless and executed by Solana's native programs, so the risk is very low if the instructions are followed correctly. The primary risk is user error, such as sending SOL to an incorrect address. Always double-check recipient addresses.

Are there fees for wrapping and unwrapping SOL?
You will pay standard Solana network transaction fees (a fraction of a cent) for the transactions that create the ATA, wrap, and unwrap the SOL. There are no additional protocol fees for the wrapping process itself.

Can I wrap fractional amounts of SOL?
Yes, you can wrap any amount of SOL, down to a single lamport (0.000000001 SOL). The same principles apply regardless of the amount.

What happens to the rent exemption when I unwrap SOL?
When you close the ATA, the lamports that were used for the rent exemption are returned to the destination account you specify. This means you get back the initial deposit you made to create the account, minus the transaction fees.
👉 Get advanced methods for managing crypto assets