@solana-program/token-wrap 2.4.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana-program/token-wrap",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Javascript helpers for interacting with the Solana Token Wrap program",
   "author": "Anza Maintainers <maintainers@anza.xyz>",
   "license": "Apache-2.0",
@@ -18,7 +18,8 @@
   },
   "files": [
     "./dist/src",
-    "./dist/types"
+    "./dist/types",
+    "./src/"
   ],
   "publishConfig": {
     "access": "public",
@@ -32,26 +33,27 @@
     "url": "https://github.com/solana-program/token-wrap/issues"
   },
   "peerDependencies": {
-    "@solana/kit": "^6.0.0"
+    "@solana/kit": "^6.10.0"
   },
   "dependencies": {
-    "@solana-program/system": "^0.11.0",
-    "@solana-program/token": "^0.10.0",
-    "@solana-program/token-2022": "^0.9.0"
+    "@solana-program/system": "^0.12.2",
+    "@solana-program/token": "^0.14.0",
+    "@solana-program/token-2022": "^0.12.0",
+    "@solana/program-client-core": "^6.10.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@solana/kit": "^6.0.0",
+    "@eslint/js": "^10.0.1",
+    "@solana/kit": "^6.10.0",
     "@tsconfig/strictest": "^2.0.8",
-    "@types/node": "^25.0.3",
-    "eslint": "^9.39.2",
+    "@types/node": "^25.9.3",
+    "eslint": "^10.5.0",
     "eslint-config-prettier": "^10.1.8",
-    "prettier": "^3.8.1",
+    "prettier": "^3.8.4",
     "tsup": "^8.5.1",
-    "tsx": "^4.21.0",
-    "typedoc": "^0.28.15",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.49.0"
+    "tsx": "^4.22.4",
+    "typedoc": "^0.28.19",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.61.1"
   },
   "scripts": {
     "build": "tsc && tsup",
@@ -60,6 +62,7 @@
     "lint:fix": "eslint --fix --ext js,ts,tsx src",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
+    "test": "exit 0",
     "example:single-signer": "tsx src/examples/single-signer.ts",
     "example:multisig": "tsx src/examples/multisig.ts"
   }

package/src/create-mint.ts

@@ -0,0 +1,125 @@
+import {
+    Address,
+    fetchEncodedAccount,
+    GetAccountInfoApi,
+    GetMinimumBalanceForRentExemptionApi,
+    Instruction,
+    KeyPairSigner,
+    Rpc,
+} from '@solana/kit';
+import { getMintSize, TOKEN_2022_PROGRAM_ADDRESS, extension } from '@solana-program/token-2022';
+import { getTransferSolInstruction } from '@solana-program/system';
+import { findBackpointerPda, findWrappedMintPda, getBackpointerSize, getCreateMintInstruction } from './generated';
+
+export interface CreateMintArgs {
+    rpc: Rpc<GetAccountInfoApi & GetMinimumBalanceForRentExemptionApi>;
+    unwrappedMint: Address;
+    wrappedTokenProgram: Address;
+    payer: KeyPairSigner;
+    idempotent?: boolean;
+}
+
+export interface CreateMintResult {
+    wrappedMint: Address;
+    backpointer: Address;
+    fundedWrappedMintLamports: bigint;
+    fundedBackpointerLamports: bigint;
+    ixs: Instruction[];
+}
+
+// The on-chain program adds these two extensions by default. We must account for
+// their size here. The `getMintSize` function from the library expects extension
+// data objects, but since the size of these extensions is fixed, we can pass
+// dummy/default values.
+const DEFAULT_EXTENSIONS = [
+    extension('ConfidentialTransferMint', {
+        autoApproveNewAccounts: true,
+        authority: null,
+        auditorElgamalPubkey: null,
+    }),
+    extension('MetadataPointer', {
+        authority: null,
+        metadataAddress: null,
+    }),
+];
+
+export async function createMint({
+    rpc,
+    unwrappedMint,
+    wrappedTokenProgram,
+    payer,
+    idempotent = false,
+}: CreateMintArgs): Promise<CreateMintResult> {
+    const [wrappedMint] = await findWrappedMintPda({
+        unwrappedMint,
+        wrappedTokenProgram: wrappedTokenProgram,
+    });
+    const [backpointer] = await findBackpointerPda({ wrappedMint });
+
+    const instructions: Instruction[] = [];
+
+    // Fund wrapped mint account if needed
+    let fundedWrappedMintLamports = 0n;
+
+    let mintSize = BigInt(getMintSize());
+    if (wrappedTokenProgram === TOKEN_2022_PROGRAM_ADDRESS) {
+        mintSize = BigInt(getMintSize(DEFAULT_EXTENSIONS));
+    }
+
+    const [wrappedMintAccount, wrappedMintRent] = await Promise.all([
+        fetchEncodedAccount(rpc, wrappedMint),
+        rpc.getMinimumBalanceForRentExemption(mintSize).send(),
+    ]);
+
+    const wrappedMintLamports = wrappedMintAccount.exists ? wrappedMintAccount.lamports : 0n;
+    if (wrappedMintLamports < wrappedMintRent) {
+        fundedWrappedMintLamports = wrappedMintRent - wrappedMintLamports;
+        instructions.push(
+            getTransferSolInstruction({
+                source: payer,
+                destination: wrappedMint,
+                amount: fundedWrappedMintLamports,
+            }),
+        );
+    }
+
+    // Fund backpointer account if needed
+    let fundedBackpointerLamports = 0n;
+
+    const backpointerSize = BigInt(getBackpointerSize());
+    const [backpointerAccount, backpointerRent] = await Promise.all([
+        fetchEncodedAccount(rpc, backpointer),
+        rpc.getMinimumBalanceForRentExemption(backpointerSize).send(),
+    ]);
+
+    const backpointerLamports = backpointerAccount.exists ? backpointerAccount.lamports : 0n;
+    if (backpointerLamports < backpointerRent) {
+        fundedBackpointerLamports = backpointerRent - backpointerLamports;
+        instructions.push(
+            getTransferSolInstruction({
+                source: payer,
+                destination: backpointer,
+                amount: fundedBackpointerLamports,
+            }),
+        );
+    }
+
+    // Add create_mint instruction
+    instructions.push(
+        getCreateMintInstruction({
+            wrappedMint,
+            backpointer,
+            unwrappedMint,
+            wrappedTokenProgram,
+            idempotent,
+        }),
+    );
+
+    return {
+        wrappedMint,
+        backpointer,
+        ixs: instructions,
+        fundedWrappedMintLamports,
+        fundedBackpointerLamports,
+    };
+}

package/src/examples/multisig.ts

@@ -0,0 +1,295 @@
+import {
+    address,
+    appendTransactionMessageInstructions,
+    assertIsSendableTransaction,
+    assertIsTransactionWithBlockhashLifetime,
+    createKeyPairSignerFromBytes,
+    createNoopSigner,
+    createSolanaRpc,
+    createSolanaRpcSubscriptions,
+    createTransactionMessage,
+    getBase58Decoder,
+    getSignatureFromTransaction,
+    partiallySignTransactionMessageWithSigners,
+    pipe,
+    sendAndConfirmTransactionFactory,
+    setTransactionMessageFeePayerSigner,
+    setTransactionMessageLifetimeUsingBlockhash,
+    signTransactionMessageWithSigners,
+} from '@solana/kit';
+import { TOKEN_2022_PROGRAM_ADDRESS } from '@solana-program/token-2022';
+import {
+    findWrappedMintAuthorityPda,
+    findWrappedMintPda,
+    combinedMultisigTx,
+    createMint,
+    multisigOfflineSignUnwrap,
+    createEscrowAccount,
+    multisigOfflineSignWrap,
+} from '../index';
+import { createTokenAccount, getOwnerFromAccount } from '../utilities';
+
+// Replace these consts with your own
+const PAYER_KEYPAIR_BYTES = new Uint8Array([
+    242, 30, 38, 177, 152, 71, 235, 193, 93, 30, 119, 131, 42, 186, 202, 7, 45, 250, 126, 135, 107, 137, 38, 91, 202,
+    212, 12, 8, 154, 213, 163, 200, 23, 237, 17, 163, 3, 135, 34, 126, 235, 146, 251, 18, 199, 101, 153, 249, 134, 88,
+    219, 68, 167, 136, 234, 195, 12, 34, 184, 85, 234, 25, 125, 94,
+]);
+
+// Create using CLI: spl-token create-multisig 2 $SIGNER_1_PUBKEY $SIGNER_2_PUBKEY
+const MULTISIG_SPL_TOKEN = address('2XBevFsu4pnZpB9PewYKAJHNyx9dFQf3MaiGBszF5fm8');
+const MULTISIG_SPL_TOKEN_2022 = address('BSdexGFqwmDGeXe4pBXVbQnqrEH5trmo9W3wqoXUQY5Y');
+const SIGNER_A_KEYPAIR_BYTES = new Uint8Array([
+    210, 190, 232, 169, 113, 107, 195, 87, 14, 9, 125, 106, 41, 174, 131, 9, 29, 144, 95, 134, 68, 123, 80, 215, 194,
+    30, 170, 140, 33, 175, 69, 126, 201, 176, 240, 30, 173, 145, 185, 162, 231, 196, 71, 236, 233, 153, 42, 243, 146,
+    82, 70, 153, 129, 194, 156, 110, 84, 18, 71, 143, 38, 244, 232, 58,
+]);
+const SIGNER_B_KEYPAIR_BYTES = new Uint8Array([
+    37, 161, 191, 225, 59, 192, 226, 154, 168, 4, 189, 155, 235, 240, 187, 210, 230, 176, 133, 163, 6, 132, 229, 129,
+    10, 9, 67, 88, 215, 124, 195, 243, 189, 178, 12, 18, 216, 91, 154, 193, 75, 164, 71, 224, 106, 148, 225, 156, 124,
+    241, 250, 51, 27, 8, 37, 111, 60, 187, 219, 161, 55, 42, 129, 236,
+]);
+
+const UNWRAPPED_MINT_ADDRESS = address('F2qGWupzMUQnGfX8e25XZps8d9AGdVde8hLQT2pxsb4M');
+const UNWRAPPED_TOKEN_ACCOUNT = address('94Y9pxekEm59b67PQQwvjb7wbwz689wDZ3dAwhCtJpPS'); // Must be owned by MULTISIG_SPL_TOKEN
+const AMOUNT_TO_WRAP = 100n;
+
+async function main() {
+    const rpc = createSolanaRpc('http://127.0.0.1:8899');
+    const rpcSubscriptions = createSolanaRpcSubscriptions('ws://127.0.0.1:8900');
+    const sendAndConfirm = sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions });
+
+    const payer = await createKeyPairSignerFromBytes(PAYER_KEYPAIR_BYTES);
+    const { value: blockhash } = await rpc.getLatestBlockhash().send();
+
+    // Initialize the wrapped mint
+    const createMintHelper = await createMint({
+        rpc,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        payer,
+        idempotent: true,
+    });
+    const createMintTx = await pipe(
+        createTransactionMessage({ version: 0 }),
+        tx => setTransactionMessageFeePayerSigner(payer, tx),
+        tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+        tx => appendTransactionMessageInstructions(createMintHelper.ixs, tx),
+        tx => signTransactionMessageWithSigners(tx),
+    );
+    assertIsSendableTransaction(createMintTx);
+    assertIsTransactionWithBlockhashLifetime(createMintTx);
+    await sendAndConfirm(createMintTx, { commitment: 'confirmed' });
+    const createMintSignature = getSignatureFromTransaction(createMintTx);
+
+    console.log('======== Create Mint Successful ========');
+    console.log('Wrapped Mint:', createMintHelper.wrappedMint);
+    console.log('Backpointer:', createMintHelper.backpointer);
+    console.log('Funded wrapped mint lamports:', createMintHelper.fundedWrappedMintLamports);
+    console.log('Funded backpointer lamports:', createMintHelper.fundedBackpointerLamports);
+    console.log('Signature:', createMintSignature);
+
+    // === Setup accounts needed for wrap ===
+
+    // Create escrow account that with hold unwrapped tokens
+    const createEscrowHelper = await createEscrowAccount({
+        rpc,
+        payer,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+    });
+    if (createEscrowHelper.kind === 'instructions_to_create') {
+        const createEscrowTx = await pipe(
+            createTransactionMessage({ version: 0 }),
+            tx => setTransactionMessageFeePayerSigner(payer, tx),
+            tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+            tx => appendTransactionMessageInstructions(createEscrowHelper.ixs, tx),
+            tx => signTransactionMessageWithSigners(tx),
+        );
+        assertIsSendableTransaction(createEscrowTx);
+        assertIsTransactionWithBlockhashLifetime(createEscrowTx);
+        await sendAndConfirm(createEscrowTx, { commitment: 'confirmed' });
+        const createEscrowSignature = getSignatureFromTransaction(createEscrowTx);
+
+        console.log('======== Create Escrow Successful ========');
+        console.log('Escrow address:', createEscrowHelper.address);
+        console.log('Signature:', createEscrowSignature);
+    } else {
+        console.log('======== Escrow already exists, skipping creation ========');
+    }
+
+    // Create recipient account where wrapped tokens will be minted to
+    const [wrappedMint] = await findWrappedMintPda({
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+    });
+    const recipientTokenAccountHelper = await createTokenAccount({
+        rpc,
+        payer,
+        mint: wrappedMint,
+        tokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        owner: MULTISIG_SPL_TOKEN_2022,
+    });
+    const recipientTokenAccountTx = await pipe(
+        createTransactionMessage({ version: 0 }),
+        tx => setTransactionMessageFeePayerSigner(payer, tx),
+        tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+        tx => appendTransactionMessageInstructions(recipientTokenAccountHelper.ixs, tx),
+        tx => signTransactionMessageWithSigners(tx),
+    );
+    assertIsSendableTransaction(recipientTokenAccountTx);
+    assertIsTransactionWithBlockhashLifetime(recipientTokenAccountTx);
+    await sendAndConfirm(recipientTokenAccountTx, { commitment: 'confirmed' });
+
+    const unwrappedTokenProgram = await getOwnerFromAccount(rpc, UNWRAPPED_TOKEN_ACCOUNT);
+    const [wrappedMintAuthority] = await findWrappedMintAuthorityPda({ wrappedMint });
+
+    const { value: wrapBlockhash } = await rpc.getLatestBlockhash().send();
+
+    const signerA = await createKeyPairSignerFromBytes(SIGNER_A_KEYPAIR_BYTES);
+    const signerB = await createKeyPairSignerFromBytes(SIGNER_B_KEYPAIR_BYTES);
+
+    // Two signers and the payer sign the transaction independently
+
+    const wrapTxA = await multisigOfflineSignWrap({
+        payer: createNoopSigner(payer.address),
+        unwrappedTokenAccount: UNWRAPPED_TOKEN_ACCOUNT,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        amount: AMOUNT_TO_WRAP,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        recipientWrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+        transferAuthority: MULTISIG_SPL_TOKEN,
+        wrappedMint,
+        wrappedMintAuthority,
+        unwrappedTokenProgram,
+        multiSigners: [signerA, createNoopSigner(signerB.address)],
+        blockhash: wrapBlockhash,
+    });
+    const signedWrapTxA = await partiallySignTransactionMessageWithSigners(wrapTxA);
+    assertIsTransactionWithBlockhashLifetime(signedWrapTxA);
+
+    const wrapTxB = await multisigOfflineSignWrap({
+        payer: createNoopSigner(payer.address),
+        unwrappedTokenAccount: UNWRAPPED_TOKEN_ACCOUNT,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        amount: AMOUNT_TO_WRAP,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        recipientWrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+        transferAuthority: MULTISIG_SPL_TOKEN,
+        wrappedMint,
+        wrappedMintAuthority,
+        unwrappedTokenProgram,
+        multiSigners: [createNoopSigner(signerA.address), signerB],
+        blockhash: wrapBlockhash,
+    });
+    const signedWrapTxB = await partiallySignTransactionMessageWithSigners(wrapTxB);
+    assertIsTransactionWithBlockhashLifetime(signedWrapTxB);
+
+    const wrapTxC = await multisigOfflineSignWrap({
+        payer,
+        unwrappedTokenAccount: UNWRAPPED_TOKEN_ACCOUNT,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        amount: AMOUNT_TO_WRAP,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        recipientWrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+        transferAuthority: MULTISIG_SPL_TOKEN,
+        wrappedMint,
+        wrappedMintAuthority,
+        unwrappedTokenProgram,
+        multiSigners: [createNoopSigner(signerA.address), createNoopSigner(signerB.address)],
+        blockhash: wrapBlockhash,
+    });
+    const signedWrapTxC = await partiallySignTransactionMessageWithSigners(wrapTxC);
+    assertIsTransactionWithBlockhashLifetime(signedWrapTxC);
+
+    // Lastly, all signatures are combined together and broadcast
+
+    const combinedWrapTx = combinedMultisigTx({
+        signedTxs: [signedWrapTxA, signedWrapTxB, signedWrapTxC],
+        blockhash,
+    });
+    await sendAndConfirm(combinedWrapTx, { commitment: 'confirmed' });
+
+    console.log('======== Multisig Wrap Successful ========');
+    for (const [pubkey, signature] of Object.entries(combinedWrapTx.signatures)) {
+        if (signature) {
+            const base58Sig = getBase58Decoder().decode(signature);
+            console.log(`pubkey: ${pubkey}`);
+            console.log(`signature: ${base58Sig}`);
+            console.log('-----');
+        }
+    }
+
+    // Unwraps from the token account owned by MULTISIG_SPL_TOKEN_2022
+
+    const { value: unwrapBlockhash } = await rpc.getLatestBlockhash().send();
+
+    const unwrapTxA = await multisigOfflineSignUnwrap({
+        payer: createNoopSigner(payer.address),
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        amount: AMOUNT_TO_WRAP,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+        recipientUnwrappedToken: UNWRAPPED_TOKEN_ACCOUNT,
+        transferAuthority: MULTISIG_SPL_TOKEN_2022,
+        wrappedMint,
+        wrappedMintAuthority,
+        unwrappedTokenProgram,
+        multiSigners: [signerA, createNoopSigner(signerB.address)],
+        blockhash: unwrapBlockhash,
+    });
+    const signedUnwrapTxA = await partiallySignTransactionMessageWithSigners(unwrapTxA);
+    assertIsTransactionWithBlockhashLifetime(signedUnwrapTxA);
+
+    const unwrapTxB = await multisigOfflineSignUnwrap({
+        payer: createNoopSigner(payer.address),
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        amount: AMOUNT_TO_WRAP,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+        recipientUnwrappedToken: UNWRAPPED_TOKEN_ACCOUNT,
+        transferAuthority: MULTISIG_SPL_TOKEN_2022,
+        wrappedMint,
+        wrappedMintAuthority,
+        unwrappedTokenProgram,
+        multiSigners: [createNoopSigner(signerA.address), signerB],
+        blockhash: unwrapBlockhash,
+    });
+    const signedUnwrapTxB = await partiallySignTransactionMessageWithSigners(unwrapTxB);
+    assertIsTransactionWithBlockhashLifetime(signedUnwrapTxB);
+
+    const unwrapTxC = await multisigOfflineSignUnwrap({
+        payer: payer,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        amount: AMOUNT_TO_WRAP,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+        recipientUnwrappedToken: UNWRAPPED_TOKEN_ACCOUNT,
+        transferAuthority: MULTISIG_SPL_TOKEN_2022,
+        wrappedMint,
+        wrappedMintAuthority,
+        unwrappedTokenProgram,
+        multiSigners: [createNoopSigner(signerA.address), createNoopSigner(signerB.address)],
+        blockhash: unwrapBlockhash,
+    });
+    const signedUnwrapTxC = await partiallySignTransactionMessageWithSigners(unwrapTxC);
+    assertIsTransactionWithBlockhashLifetime(signedUnwrapTxC);
+
+    const combinedUnwrapTx = combinedMultisigTx({
+        signedTxs: [signedUnwrapTxA, signedUnwrapTxB, signedUnwrapTxC],
+        blockhash,
+    });
+    await sendAndConfirm(combinedUnwrapTx, { commitment: 'confirmed' });
+
+    console.log('======== Multisig Unwrap Successful ========');
+    for (const [pubkey, signature] of Object.entries(combinedUnwrapTx.signatures)) {
+        if (signature) {
+            const base58Sig = getBase58Decoder().decode(signature);
+            console.log(`pubkey: ${pubkey}`);
+            console.log(`signature: ${base58Sig}`);
+            console.log('-----');
+        }
+    }
+}
+
+void main();

package/src/examples/single-signer.ts

@@ -0,0 +1,175 @@
+import {
+    address,
+    appendTransactionMessageInstructions,
+    assertIsSendableTransaction,
+    assertIsTransactionWithBlockhashLifetime,
+    createKeyPairSignerFromBytes,
+    createSolanaRpc,
+    createSolanaRpcSubscriptions,
+    createTransactionMessage,
+    getSignatureFromTransaction,
+    pipe,
+    sendAndConfirmTransactionFactory,
+    setTransactionMessageFeePayerSigner,
+    setTransactionMessageLifetimeUsingBlockhash,
+    signTransactionMessageWithSigners,
+} from '@solana/kit';
+import { TOKEN_2022_PROGRAM_ADDRESS } from '@solana-program/token-2022';
+import { createEscrowAccount, findWrappedMintPda, createMint, singleSignerUnwrap, singleSignerWrap } from '../index';
+import { createTokenAccount } from '../utilities';
+
+// Replace these consts with your own
+const PRIVATE_KEY_PAIR = new Uint8Array([
+    242, 30, 38, 177, 152, 71, 235, 193, 93, 30, 119, 131, 42, 186, 202, 7, 45, 250, 126, 135, 107, 137, 38, 91, 202,
+    212, 12, 8, 154, 213, 163, 200, 23, 237, 17, 163, 3, 135, 34, 126, 235, 146, 251, 18, 199, 101, 153, 249, 134, 88,
+    219, 68, 167, 136, 234, 195, 12, 34, 184, 85, 234, 25, 125, 94,
+]);
+const UNWRAPPED_MINT_ADDRESS = address('FAbYm8kdDsyc6csvTXPMBwCJDjTVkZcvrnyVVTSF74hU');
+const UNWRAPPED_TOKEN_ACCOUNT = address('4dSPDdFuTbKTuJDDtTd8SUdbH6QY42hpTPRi6RRzzsPF');
+const AMOUNT_TO_WRAP = 100n;
+
+async function main() {
+    const rpc = createSolanaRpc('http://127.0.0.1:8899');
+    const rpcSubscriptions = createSolanaRpcSubscriptions('ws://127.0.0.1:8900');
+    const sendAndConfirm = sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions });
+
+    const payer = await createKeyPairSignerFromBytes(PRIVATE_KEY_PAIR);
+    const { value: blockhash } = await rpc.getLatestBlockhash().send();
+
+    // Initialize the wrapped mint
+    const createMintHelper = await createMint({
+        rpc,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        payer,
+        idempotent: true,
+    });
+    const createMintTx = await pipe(
+        createTransactionMessage({ version: 0 }),
+        tx => setTransactionMessageFeePayerSigner(payer, tx),
+        tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+        tx => appendTransactionMessageInstructions(createMintHelper.ixs, tx),
+        tx => signTransactionMessageWithSigners(tx),
+    );
+    assertIsSendableTransaction(createMintTx);
+    assertIsTransactionWithBlockhashLifetime(createMintTx);
+    await sendAndConfirm(createMintTx, { commitment: 'confirmed' });
+    const createMintSignature = getSignatureFromTransaction(createMintTx);
+
+    console.log('======== Create Mint Successful ========');
+    console.log('Wrapped Mint:', createMintHelper.wrappedMint);
+    console.log('Backpointer:', createMintHelper.backpointer);
+    console.log('Funded wrapped mint lamports:', createMintHelper.fundedWrappedMintLamports);
+    console.log('Funded backpointer lamports:', createMintHelper.fundedBackpointerLamports);
+    console.log('Signature:', createMintSignature);
+
+    // === Setup accounts needed for wrap ===
+
+    // Create escrow account that with hold unwrapped tokens
+    const createEscrowHelper = await createEscrowAccount({
+        rpc,
+        payer,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+    });
+    if (createEscrowHelper.kind === 'instructions_to_create') {
+        const createEscrowTx = await pipe(
+            createTransactionMessage({ version: 0 }),
+            tx => setTransactionMessageFeePayerSigner(payer, tx),
+            tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+            tx => appendTransactionMessageInstructions(createEscrowHelper.ixs, tx),
+            tx => signTransactionMessageWithSigners(tx),
+        );
+        assertIsSendableTransaction(createEscrowTx);
+        assertIsTransactionWithBlockhashLifetime(createEscrowTx);
+        await sendAndConfirm(createEscrowTx, { commitment: 'confirmed' });
+        const createEscrowSignature = getSignatureFromTransaction(createEscrowTx);
+
+        console.log('======== Create Escrow Successful ========');
+        console.log('Escrow address:', createEscrowHelper.address);
+        console.log('Signature:', createEscrowSignature);
+    } else {
+        console.log('======== Escrow already exists, skipping creation ========');
+    }
+
+    // Create recipient account where wrapped tokens will be minted to
+    const [wrappedMint] = await findWrappedMintPda({
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+    });
+    const recipientTokenAccountHelper = await createTokenAccount({
+        rpc,
+        payer,
+        mint: wrappedMint,
+        tokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        owner: payer.address,
+    });
+    const recipientTokenAccountTx = await pipe(
+        createTransactionMessage({ version: 0 }),
+        tx => setTransactionMessageFeePayerSigner(payer, tx),
+        tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+        tx => appendTransactionMessageInstructions(recipientTokenAccountHelper.ixs, tx),
+        tx => signTransactionMessageWithSigners(tx),
+    );
+    assertIsSendableTransaction(recipientTokenAccountTx);
+    assertIsTransactionWithBlockhashLifetime(recipientTokenAccountTx);
+    await sendAndConfirm(recipientTokenAccountTx, { commitment: 'confirmed' });
+
+    // Execute wrap
+    const wrapHelper = await singleSignerWrap({
+        rpc,
+        payer,
+        unwrappedTokenAccount: UNWRAPPED_TOKEN_ACCOUNT,
+        wrappedTokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+        amount: AMOUNT_TO_WRAP,
+        unwrappedMint: UNWRAPPED_MINT_ADDRESS,
+        recipientWrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+    });
+
+    const wrapTx = await pipe(
+        createTransactionMessage({ version: 0 }),
+        tx => setTransactionMessageFeePayerSigner(payer, tx),
+        tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+        tx => appendTransactionMessageInstructions(wrapHelper.ixs, tx),
+        tx => signTransactionMessageWithSigners(tx),
+    );
+    assertIsSendableTransaction(wrapTx);
+    assertIsTransactionWithBlockhashLifetime(wrapTx);
+    await sendAndConfirm(wrapTx, { commitment: 'confirmed' });
+    const wrapSignature = getSignatureFromTransaction(wrapTx);
+
+    console.log('======== Wrap Successful ========');
+    console.log('Wrap amount:', wrapHelper.amount);
+    console.log('Recipient account:', wrapHelper.recipientWrappedTokenAccount);
+    console.log('Escrow Account:', wrapHelper.escrowAccount);
+    console.log('Signature:', wrapSignature);
+
+    // execute unwrap
+
+    const unwrapHelper = await singleSignerUnwrap({
+        rpc,
+        payer,
+        wrappedTokenAccount: recipientTokenAccountHelper.keyPair.address,
+        amount: AMOUNT_TO_WRAP,
+        recipientUnwrappedToken: UNWRAPPED_TOKEN_ACCOUNT,
+    });
+
+    const unwrapTx = await pipe(
+        createTransactionMessage({ version: 0 }),
+        tx => setTransactionMessageFeePayerSigner(payer, tx),
+        tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+        tx => appendTransactionMessageInstructions(unwrapHelper.ixs, tx),
+        tx => signTransactionMessageWithSigners(tx),
+    );
+    assertIsSendableTransaction(unwrapTx);
+    assertIsTransactionWithBlockhashLifetime(unwrapTx);
+    await sendAndConfirm(unwrapTx, { commitment: 'confirmed' });
+    const unwrapSignature = getSignatureFromTransaction(unwrapTx);
+
+    console.log('======== Unwrap Successful ========');
+    console.log('Unwrapped amount:', unwrapHelper.amount);
+    console.log('Recipient account:', unwrapHelper.recipientUnwrappedToken);
+    console.log('Signature:', unwrapSignature);
+}
+
+void main();