@fogo/sessions-sdk 0.0.29 → 0.0.31

package/cjs/connection.d.ts

@@ -1,6 +1,6 @@
-import type { Transaction, Instruction, TransactionWithLifetime, Rpc, GetLatestBlockhashApi } from "@solana/kit";
+import type { GetLatestBlockhashApi, Instruction, Rpc, Transaction, TransactionWithLifetime } from "@solana/kit";
 import type { TransactionError } from "@solana/web3.js";
-import { Keypair, Connection as Web3Connection, TransactionInstruction, VersionedTransaction, PublicKey } from "@solana/web3.js";
+import { Keypair, PublicKey, TransactionInstruction, VersionedTransaction, Connection as Web3Connection } from "@solana/web3.js";
 export declare enum Network {
     Testnet = 0,
     Mainnet = 1

package/cjs/index.d.ts

@@ -1,12 +1,12 @@
-import type { TransactionError, VersionedTransaction } from "@solana/web3.js";
+import type { TransactionError, TransactionInstruction, VersionedTransaction } from "@solana/web3.js";
 import { Connection, PublicKey } from "@solana/web3.js";
 import type { Chain } from "@wormhole-foundation/sdk";
 import BN from "bn.js";
 import { z } from "zod";
 import type { TransactionOrInstructions, TransactionResult } from "./connection.js";
 import type { SendTransactionOptions, SessionContext } from "./context.js";
-export { type SessionContext, type SendTransactionOptions, createSessionContext, } from "./context.js";
-export { type TransactionResult, type Connection, type TransactionOrInstructions, Network, TransactionResultType, createSessionConnection, } from "./connection.js";
+export { type Connection, createSessionConnection, Network, type TransactionOrInstructions, type TransactionResult, TransactionResultType, } from "./connection.js";
+export { createSessionContext, type SendTransactionOptions, type SessionContext, } from "./context.js";
 type EstablishSessionOptions = {
     context: SessionContext;
     walletPublicKey: PublicKey;
@@ -2228,6 +2228,9 @@ export type Session = {
     sessionKey: CryptoKeyPair;
     walletPublicKey: PublicKey;
     payer: PublicKey;
+    getSystemProgramSessionWrapInstruction: (amount: bigint) => TransactionInstruction;
+    getSessionWrapInstructions: (amount: bigint) => TransactionInstruction[];
+    getSessionUnwrapInstructions: () => TransactionInstruction[];
     sendTransaction: (instructions: TransactionOrInstructions, extraConfig?: SendTransactionOptions) => Promise<TransactionResult>;
     sessionInfo: NonNullable<z.infer<typeof sessionInfoSchema>>;
 };
@@ -2258,6 +2261,18 @@ type SendTransferOptions = {
     feeConfig: Awaited<ReturnType<typeof getTransferFee>>;
 };
 export declare const sendTransfer: (options: SendTransferOptions) => Promise<TransactionResult>;
+type SendNativeTransferOptions = {
+    context: SessionContext;
+    walletPublicKey: PublicKey;
+    signMessage: (message: Uint8Array) => Promise<{
+        signedMessage: Uint8Array;
+        signature: Uint8Array;
+    }>;
+    amount: bigint;
+    recipient: PublicKey;
+    feeConfig: Awaited<ReturnType<typeof getTransferFee>>;
+};
+export declare const sendNativeTransfer: (options: SendNativeTransferOptions) => Promise<TransactionResult>;
 type SendBridgeOutOptions = {
     context: SessionContext;
     sessionKey: CryptoKeyPair;

package/cjs/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyLogInToken = exports.createLogInToken = exports.bridgeIn = exports.bridgeOut = exports.sendTransfer = exports.getBridgeOutFee = exports.getTransferFee = exports.SessionResultType = exports.getDomainRecordAddress = exports.AuthorizedTokens = exports.AuthorizedProgramsType = exports.getSessionAccount = exports.reestablishSession = exports.revokeSession = exports.replaceSession = exports.establishSession = exports.createSessionConnection = exports.TransactionResultType = exports.Network = exports.createSessionContext = void 0;
+exports.verifyLogInToken = exports.createLogInToken = exports.bridgeIn = exports.bridgeOut = exports.sendNativeTransfer = exports.sendTransfer = exports.getBridgeOutFee = exports.getTransferFee = exports.SessionResultType = exports.getDomainRecordAddress = exports.AuthorizedTokens = exports.AuthorizedProgramsType = exports.getSessionAccount = exports.reestablishSession = exports.revokeSession = exports.replaceSession = exports.establishSession = exports.createSessionContext = exports.TransactionResultType = exports.Network = exports.createSessionConnection = void 0;
 const anchor_1 = require("@coral-xyz/anchor");
 const sessions_idls_1 = require("@fogo/sessions-idls");
 const mpl_token_metadata_1 = require("@metaplex-foundation/mpl-token-metadata");
@@ -26,19 +26,20 @@ const zod_1 = require("zod");
 const connection_js_1 = require("./connection.js");
 const context_js_1 = require("./context.js");
 const crypto_js_1 = require("./crypto.js");
-var context_js_2 = require("./context.js");
-Object.defineProperty(exports, "createSessionContext", { enumerable: true, get: function () { return context_js_2.createSessionContext; } });
+const instructions_js_1 = require("./instructions.js");
 var connection_js_2 = require("./connection.js");
+Object.defineProperty(exports, "createSessionConnection", { enumerable: true, get: function () { return connection_js_2.createSessionConnection; } });
 Object.defineProperty(exports, "Network", { enumerable: true, get: function () { return connection_js_2.Network; } });
 Object.defineProperty(exports, "TransactionResultType", { enumerable: true, get: function () { return connection_js_2.TransactionResultType; } });
-Object.defineProperty(exports, "createSessionConnection", { enumerable: true, get: function () { return connection_js_2.createSessionConnection; } });
+var context_js_2 = require("./context.js");
+Object.defineProperty(exports, "createSessionContext", { enumerable: true, get: function () { return context_js_2.createSessionContext; } });
 const MESSAGE_HEADER = `Fogo Sessions:
 Signing this intent will allow this app to interact with your on-chain balances. Please make sure you trust this app and the domain in the message matches the domain of the current web application.
 `;
 const UNLIMITED_TOKEN_PERMISSIONS_VALUE = "this app may spend any amount of any token";
 const TOKENLESS_PERMISSIONS_VALUE = "this app may not spend any tokens";
 const CURRENT_MAJOR = "0";
-const CURRENT_MINOR = "3";
+const CURRENT_MINOR = "4";
 const CURRENT_INTENT_TRANSFER_MAJOR = "0";
 const CURRENT_INTENT_TRANSFER_MINOR = "2";
 const CURRENT_BRIDGE_OUT_MAJOR = "0";
@@ -130,6 +131,11 @@ const createSession = async (context, walletPublicKey, sessionKey) => {
             walletPublicKey,
             sessionKey,
             payer: context.payer,
+            getSystemProgramSessionWrapInstruction: (amount) => (0, instructions_js_1.createSystemProgramSessionWrapInstruction)(sessionPublicKey, walletPublicKey, amount),
+            getSessionWrapInstructions: (amount) => (0, instructions_js_1.createSessionWrapInstructions)(sessionPublicKey, walletPublicKey, amount),
+            getSessionUnwrapInstructions: () => [
+                (0, instructions_js_1.createSessionUnwrapInstruction)(sessionPublicKey, walletPublicKey),
+            ],
             sendTransaction: (instructions, extraConfig) => context.sendTransaction(sessionKey, instructions, extraConfig),
             sessionInfo,
         };
@@ -354,7 +360,7 @@ const SymbolOrMint = {
         mint,
     }),
 };
-const getTokenInfo = async (context, limits) => {
+const getTokenInfo = (context, limits) => {
     const umi = (0, umi_bundle_defaults_1.createUmi)(context.connection.rpcEndpoint);
     return Promise.all(limits.entries().map(async ([mint, amount]) => {
         const metaplexMint = (0, umi_1.publicKey)(mint.toBase58());
@@ -588,6 +594,41 @@ const buildTransferIntentInstruction = async (program, options, symbol, feeToken
         nonce: nonce === null ? "1" : nonce.nonce.add(new bn_js_1.default(1)).toString(),
     });
 };
+const sendNativeTransfer = async (options) => {
+    const program = new sessions_idls_1.IntentTransferProgram(new anchor_1.AnchorProvider(options.context.connection, {}, {}));
+    return options.context.sendTransaction(undefined, [
+        await buildNativeTransferIntentInstruction(program, options, options.feeConfig.symbolOrMint, amountToString(options.feeConfig.fee, options.feeConfig.decimals)),
+        await program.methods
+            .sendNative()
+            .accounts({
+            feeMetadata: options.feeConfig.metadata,
+            feeMint: options.feeConfig.mint,
+            feeSource: (0, spl_token_1.getAssociatedTokenAddressSync)(options.feeConfig.mint, options.walletPublicKey),
+            source: options.walletPublicKey,
+            destination: options.recipient,
+            sponsor: options.context.internalPayer,
+        })
+            .instruction(),
+    ], {
+        variation: "Intent Transfer",
+        paymasterDomain: context_js_1.SESSIONS_INTERNAL_PAYMASTER_DOMAIN,
+    });
+};
+exports.sendNativeTransfer = sendNativeTransfer;
+const FOGO_DECIMALS = 9;
+const buildNativeTransferIntentInstruction = async (program, options, feeToken, feeAmount) => {
+    const nonce = await getNonce(program, options.walletPublicKey, NonceType.Transfer);
+    return buildIntentInstruction(options, TRANSFER_MESSAGE_HEADER, {
+        version: `${CURRENT_INTENT_TRANSFER_MAJOR}.${CURRENT_INTENT_TRANSFER_MINOR}`,
+        chain_id: options.context.chainId,
+        token: "FOGO",
+        amount: amountToString(options.amount, FOGO_DECIMALS),
+        recipient: options.recipient.toBase58(),
+        fee_token: feeToken,
+        fee_amount: feeAmount,
+        nonce: nonce === null ? "1" : nonce.nonce.add(new bn_js_1.default(1)).toString(),
+    });
+};
 const BRIDGE_OUT_MESSAGE_HEADER = `Fogo Bridge Transfer:
 Signing this intent will bridge out the tokens as described below.
 `;

package/cjs/instructions.d.ts

@@ -0,0 +1,18 @@
+import { type PublicKey, TransactionInstruction } from "@solana/web3.js";
+/**
+ * Creates the system program instruction `SessionWrap`, only available on Fogo, which allows a session key to transfer native token from its user's wallet to its user's wrapped token associated token account.
+ * This instruction may be combined with the `CreateAssociatedTokenAccountIdempotent` and `SyncNative` instructions for a session to wrap tokens on behalf of its user.
+ */
+export declare function createSystemProgramSessionWrapInstruction(sessionKey: PublicKey, walletPublicKey: PublicKey, amount: bigint): TransactionInstruction;
+/**
+ * Creates the sequence of instructions required to wrap native tokens within a session.
+ *
+ * Note: This function sets the session key as the payer for the `CreateAssociatedTokenAccountIdempotent` instruction, which is unconventional since the session key can't spend funds.
+ * It works because at the time `CreateAssociatedTokenAccountIdempotent` is called, the `userTokenAccount` has already been funded by the `SessionWrap` instruction.
+ * The paymaster will reject the transaction if the payer of the `CreateAssociatedTokenAccountIdempotent` is set to the paymaster payer to avoid the paymaster's funds getting drained.
+ */
+export declare function createSessionWrapInstructions(sessionKey: PublicKey, walletPublicKey: PublicKey, amount: bigint): TransactionInstruction[];
+/**
+ * Creates the instruction required to unwrap native tokens within a session.
+ */
+export declare function createSessionUnwrapInstruction(sessionKey: PublicKey, walletPublicKey: PublicKey): TransactionInstruction;

package/cjs/instructions.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSystemProgramSessionWrapInstruction = createSystemProgramSessionWrapInstruction;
+exports.createSessionWrapInstructions = createSessionWrapInstructions;
+exports.createSessionUnwrapInstruction = createSessionUnwrapInstruction;
+const spl_token_1 = require("@solana/spl-token");
+const web3_js_1 = require("@solana/web3.js");
+const SESSION_WRAP_DISCRIMINATOR = 4_000_000;
+function getNativeMintAssociatedTokenAddressSync(walletPublicKey) {
+    return (0, spl_token_1.getAssociatedTokenAddressSync)(spl_token_1.NATIVE_MINT, walletPublicKey);
+}
+/**
+ * Creates the system program instruction `SessionWrap`, only available on Fogo, which allows a session key to transfer native token from its user's wallet to its user's wrapped token associated token account.
+ * This instruction may be combined with the `CreateAssociatedTokenAccountIdempotent` and `SyncNative` instructions for a session to wrap tokens on behalf of its user.
+ */
+function createSystemProgramSessionWrapInstruction(sessionKey, walletPublicKey, amount) {
+    const data = new Uint8Array(12);
+    const view = new DataView(data.buffer);
+    view.setUint32(0, SESSION_WRAP_DISCRIMINATOR, true);
+    view.setBigUint64(4, amount, true);
+    return new web3_js_1.TransactionInstruction({
+        programId: web3_js_1.SystemProgram.programId,
+        keys: [
+            { pubkey: walletPublicKey, isSigner: false, isWritable: true },
+            {
+                pubkey: getNativeMintAssociatedTokenAddressSync(walletPublicKey),
+                isSigner: false,
+                isWritable: true,
+            },
+            { pubkey: sessionKey, isSigner: true, isWritable: false },
+        ],
+        data: Buffer.from(data),
+    });
+}
+/**
+ * Creates the sequence of instructions required to wrap native tokens within a session.
+ *
+ * Note: This function sets the session key as the payer for the `CreateAssociatedTokenAccountIdempotent` instruction, which is unconventional since the session key can't spend funds.
+ * It works because at the time `CreateAssociatedTokenAccountIdempotent` is called, the `userTokenAccount` has already been funded by the `SessionWrap` instruction.
+ * The paymaster will reject the transaction if the payer of the `CreateAssociatedTokenAccountIdempotent` is set to the paymaster payer to avoid the paymaster's funds getting drained.
+ */
+function createSessionWrapInstructions(sessionKey, walletPublicKey, amount) {
+    const userTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(spl_token_1.NATIVE_MINT, walletPublicKey);
+    return [
+        createSystemProgramSessionWrapInstruction(sessionKey, walletPublicKey, amount),
+        (0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(sessionKey, // This is unconventional! Read the note in the function's docs.
+        userTokenAccount, walletPublicKey, spl_token_1.NATIVE_MINT),
+        (0, spl_token_1.createSyncNativeInstruction)(userTokenAccount),
+    ];
+}
+/**
+ * Creates the instruction required to unwrap native tokens within a session.
+ */
+function createSessionUnwrapInstruction(sessionKey, walletPublicKey) {
+    return (0, spl_token_1.createCloseAccountInstruction)(getNativeMintAssociatedTokenAddressSync(walletPublicKey), walletPublicKey, sessionKey);
+}

package/esm/connection.d.ts

@@ -1,6 +1,6 @@
-import type { Transaction, Instruction, TransactionWithLifetime, Rpc, GetLatestBlockhashApi } from "@solana/kit";
+import type { GetLatestBlockhashApi, Instruction, Rpc, Transaction, TransactionWithLifetime } from "@solana/kit";
 import type { TransactionError } from "@solana/web3.js";
-import { Keypair, Connection as Web3Connection, TransactionInstruction, VersionedTransaction, PublicKey } from "@solana/web3.js";
+import { Keypair, PublicKey, TransactionInstruction, VersionedTransaction, Connection as Web3Connection } from "@solana/web3.js";
 export declare enum Network {
     Testnet = 0,
     Mainnet = 1

package/esm/connection.js

@@ -1,6 +1,6 @@
 import { fromLegacyKeypair, fromLegacyPublicKey, fromLegacyTransactionInstruction, fromVersionedTransaction, } from "@solana/compat";
-import { createSolanaRpc, getBase64EncodedWireTransaction, createTransactionMessage, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash, appendTransactionMessageInstructions, partiallySignTransactionMessageWithSigners, pipe, addSignersToTransactionMessage, compressTransactionMessageUsingAddressLookupTables, createSignerFromKeyPair, partiallySignTransaction, } from "@solana/kit";
-import { Keypair, Connection as Web3Connection, TransactionInstruction, VersionedTransaction, PublicKey, } from "@solana/web3.js";
+import { addSignersToTransactionMessage, appendTransactionMessageInstructions, compressTransactionMessageUsingAddressLookupTables, createSignerFromKeyPair, createSolanaRpc, createTransactionMessage, getBase64EncodedWireTransaction, partiallySignTransaction, partiallySignTransactionMessageWithSigners, pipe, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash, } from "@solana/kit";
+import { Keypair, PublicKey, TransactionInstruction, VersionedTransaction, Connection as Web3Connection, } from "@solana/web3.js";
 import { z } from "zod";
 export var Network;
 (function (Network) {

package/esm/context.js

@@ -1,6 +1,6 @@
 import { AnchorProvider } from "@coral-xyz/anchor";
 import { ChainIdProgram } from "@fogo/sessions-idls";
-import { Connection as Web3Connection, Keypair } from "@solana/web3.js";
+import { Keypair, Connection as Web3Connection } from "@solana/web3.js";
 // eslint-disable-next-line unicorn/no-typeof-undefined
 const IS_BROWSER = typeof globalThis.window !== "undefined";
 export const SESSIONS_INTERNAL_PAYMASTER_DOMAIN = "sessions";

package/esm/index.d.ts

@@ -1,12 +1,12 @@
-import type { TransactionError, VersionedTransaction } from "@solana/web3.js";
+import type { TransactionError, TransactionInstruction, VersionedTransaction } from "@solana/web3.js";
 import { Connection, PublicKey } from "@solana/web3.js";
 import type { Chain } from "@wormhole-foundation/sdk";
 import BN from "bn.js";
 import { z } from "zod";
 import type { TransactionOrInstructions, TransactionResult } from "./connection.js";
 import type { SendTransactionOptions, SessionContext } from "./context.js";
-export { type SessionContext, type SendTransactionOptions, createSessionContext, } from "./context.js";
-export { type TransactionResult, type Connection, type TransactionOrInstructions, Network, TransactionResultType, createSessionConnection, } from "./connection.js";
+export { type Connection, createSessionConnection, Network, type TransactionOrInstructions, type TransactionResult, TransactionResultType, } from "./connection.js";
+export { createSessionContext, type SendTransactionOptions, type SessionContext, } from "./context.js";
 type EstablishSessionOptions = {
     context: SessionContext;
     walletPublicKey: PublicKey;
@@ -2228,6 +2228,9 @@ export type Session = {
     sessionKey: CryptoKeyPair;
     walletPublicKey: PublicKey;
     payer: PublicKey;
+    getSystemProgramSessionWrapInstruction: (amount: bigint) => TransactionInstruction;
+    getSessionWrapInstructions: (amount: bigint) => TransactionInstruction[];
+    getSessionUnwrapInstructions: () => TransactionInstruction[];
     sendTransaction: (instructions: TransactionOrInstructions, extraConfig?: SendTransactionOptions) => Promise<TransactionResult>;
     sessionInfo: NonNullable<z.infer<typeof sessionInfoSchema>>;
 };
@@ -2258,6 +2261,18 @@ type SendTransferOptions = {
     feeConfig: Awaited<ReturnType<typeof getTransferFee>>;
 };
 export declare const sendTransfer: (options: SendTransferOptions) => Promise<TransactionResult>;
+type SendNativeTransferOptions = {
+    context: SessionContext;
+    walletPublicKey: PublicKey;
+    signMessage: (message: Uint8Array) => Promise<{
+        signedMessage: Uint8Array;
+        signature: Uint8Array;
+    }>;
+    amount: bigint;
+    recipient: PublicKey;
+    feeConfig: Awaited<ReturnType<typeof getTransferFee>>;
+};
+export declare const sendNativeTransfer: (options: SendNativeTransferOptions) => Promise<TransactionResult>;
 type SendBridgeOutOptions = {
     context: SessionContext;
     sessionKey: CryptoKeyPair;

package/esm/index.js

@@ -8,7 +8,7 @@ import { fromLegacyPublicKey } from "@solana/compat";
 import { generateKeyPair, getAddressFromPublicKey, getProgramDerivedAddress, } from "@solana/kit";
 import { getAssociatedTokenAddressSync, getMint } from "@solana/spl-token";
 import { ComputeBudgetProgram, Connection, Ed25519Program, Keypair, PublicKey, } from "@solana/web3.js";
-import { Wormhole, wormhole, routes } from "@wormhole-foundation/sdk";
+import { routes, Wormhole, wormhole } from "@wormhole-foundation/sdk";
 import solanaSdk from "@wormhole-foundation/sdk/solana";
 import { contracts } from "@wormhole-foundation/sdk-base";
 import { nttExecutorRoute } from "@wormhole-foundation/sdk-route-ntt";
@@ -20,15 +20,16 @@ import { z } from "zod";
 import { Network, TransactionResultType } from "./connection.js";
 import { SESSIONS_INTERNAL_PAYMASTER_DOMAIN } from "./context.js";
 import { importKey, signMessageWithKey, verifyMessageWithKey, } from "./crypto.js";
+import { createSessionUnwrapInstruction, createSessionWrapInstructions, createSystemProgramSessionWrapInstruction, } from "./instructions.js";
+export { createSessionConnection, Network, TransactionResultType, } from "./connection.js";
 export { createSessionContext, } from "./context.js";
-export { Network, TransactionResultType, createSessionConnection, } from "./connection.js";
 const MESSAGE_HEADER = `Fogo Sessions:
 Signing this intent will allow this app to interact with your on-chain balances. Please make sure you trust this app and the domain in the message matches the domain of the current web application.
 `;
 const UNLIMITED_TOKEN_PERMISSIONS_VALUE = "this app may spend any amount of any token";
 const TOKENLESS_PERMISSIONS_VALUE = "this app may not spend any tokens";
 const CURRENT_MAJOR = "0";
-const CURRENT_MINOR = "3";
+const CURRENT_MINOR = "4";
 const CURRENT_INTENT_TRANSFER_MAJOR = "0";
 const CURRENT_INTENT_TRANSFER_MINOR = "2";
 const CURRENT_BRIDGE_OUT_MAJOR = "0";
@@ -115,6 +116,11 @@ const createSession = async (context, walletPublicKey, sessionKey) => {
             walletPublicKey,
             sessionKey,
             payer: context.payer,
+            getSystemProgramSessionWrapInstruction: (amount) => createSystemProgramSessionWrapInstruction(sessionPublicKey, walletPublicKey, amount),
+            getSessionWrapInstructions: (amount) => createSessionWrapInstructions(sessionPublicKey, walletPublicKey, amount),
+            getSessionUnwrapInstructions: () => [
+                createSessionUnwrapInstruction(sessionPublicKey, walletPublicKey),
+            ],
             sendTransaction: (instructions, extraConfig) => context.sendTransaction(sessionKey, instructions, extraConfig),
             sessionInfo,
         };
@@ -339,7 +345,7 @@ const SymbolOrMint = {
         mint,
     }),
 };
-const getTokenInfo = async (context, limits) => {
+const getTokenInfo = (context, limits) => {
     const umi = createUmi(context.connection.rpcEndpoint);
     return Promise.all(limits.entries().map(async ([mint, amount]) => {
         const metaplexMint = metaplexPublicKey(mint.toBase58());
@@ -569,6 +575,40 @@ const buildTransferIntentInstruction = async (program, options, symbol, feeToken
         nonce: nonce === null ? "1" : nonce.nonce.add(new BN(1)).toString(),
     });
 };
+export const sendNativeTransfer = async (options) => {
+    const program = new IntentTransferProgram(new AnchorProvider(options.context.connection, {}, {}));
+    return options.context.sendTransaction(undefined, [
+        await buildNativeTransferIntentInstruction(program, options, options.feeConfig.symbolOrMint, amountToString(options.feeConfig.fee, options.feeConfig.decimals)),
+        await program.methods
+            .sendNative()
+            .accounts({
+            feeMetadata: options.feeConfig.metadata,
+            feeMint: options.feeConfig.mint,
+            feeSource: getAssociatedTokenAddressSync(options.feeConfig.mint, options.walletPublicKey),
+            source: options.walletPublicKey,
+            destination: options.recipient,
+            sponsor: options.context.internalPayer,
+        })
+            .instruction(),
+    ], {
+        variation: "Intent Transfer",
+        paymasterDomain: SESSIONS_INTERNAL_PAYMASTER_DOMAIN,
+    });
+};
+const FOGO_DECIMALS = 9;
+const buildNativeTransferIntentInstruction = async (program, options, feeToken, feeAmount) => {
+    const nonce = await getNonce(program, options.walletPublicKey, NonceType.Transfer);
+    return buildIntentInstruction(options, TRANSFER_MESSAGE_HEADER, {
+        version: `${CURRENT_INTENT_TRANSFER_MAJOR}.${CURRENT_INTENT_TRANSFER_MINOR}`,
+        chain_id: options.context.chainId,
+        token: "FOGO",
+        amount: amountToString(options.amount, FOGO_DECIMALS),
+        recipient: options.recipient.toBase58(),
+        fee_token: feeToken,
+        fee_amount: feeAmount,
+        nonce: nonce === null ? "1" : nonce.nonce.add(new BN(1)).toString(),
+    });
+};
 const BRIDGE_OUT_MESSAGE_HEADER = `Fogo Bridge Transfer:
 Signing this intent will bridge out the tokens as described below.
 `;

package/esm/instructions.d.ts

@@ -0,0 +1,18 @@
+import { type PublicKey, TransactionInstruction } from "@solana/web3.js";
+/**
+ * Creates the system program instruction `SessionWrap`, only available on Fogo, which allows a session key to transfer native token from its user's wallet to its user's wrapped token associated token account.
+ * This instruction may be combined with the `CreateAssociatedTokenAccountIdempotent` and `SyncNative` instructions for a session to wrap tokens on behalf of its user.
+ */
+export declare function createSystemProgramSessionWrapInstruction(sessionKey: PublicKey, walletPublicKey: PublicKey, amount: bigint): TransactionInstruction;
+/**
+ * Creates the sequence of instructions required to wrap native tokens within a session.
+ *
+ * Note: This function sets the session key as the payer for the `CreateAssociatedTokenAccountIdempotent` instruction, which is unconventional since the session key can't spend funds.
+ * It works because at the time `CreateAssociatedTokenAccountIdempotent` is called, the `userTokenAccount` has already been funded by the `SessionWrap` instruction.
+ * The paymaster will reject the transaction if the payer of the `CreateAssociatedTokenAccountIdempotent` is set to the paymaster payer to avoid the paymaster's funds getting drained.
+ */
+export declare function createSessionWrapInstructions(sessionKey: PublicKey, walletPublicKey: PublicKey, amount: bigint): TransactionInstruction[];
+/**
+ * Creates the instruction required to unwrap native tokens within a session.
+ */
+export declare function createSessionUnwrapInstruction(sessionKey: PublicKey, walletPublicKey: PublicKey): TransactionInstruction;

package/esm/instructions.js

@@ -0,0 +1,51 @@
+import { createAssociatedTokenAccountIdempotentInstruction, createCloseAccountInstruction, createSyncNativeInstruction, getAssociatedTokenAddressSync, NATIVE_MINT, } from "@solana/spl-token";
+import { SystemProgram, TransactionInstruction, } from "@solana/web3.js";
+const SESSION_WRAP_DISCRIMINATOR = 4_000_000;
+function getNativeMintAssociatedTokenAddressSync(walletPublicKey) {
+    return getAssociatedTokenAddressSync(NATIVE_MINT, walletPublicKey);
+}
+/**
+ * Creates the system program instruction `SessionWrap`, only available on Fogo, which allows a session key to transfer native token from its user's wallet to its user's wrapped token associated token account.
+ * This instruction may be combined with the `CreateAssociatedTokenAccountIdempotent` and `SyncNative` instructions for a session to wrap tokens on behalf of its user.
+ */
+export function createSystemProgramSessionWrapInstruction(sessionKey, walletPublicKey, amount) {
+    const data = new Uint8Array(12);
+    const view = new DataView(data.buffer);
+    view.setUint32(0, SESSION_WRAP_DISCRIMINATOR, true);
+    view.setBigUint64(4, amount, true);
+    return new TransactionInstruction({
+        programId: SystemProgram.programId,
+        keys: [
+            { pubkey: walletPublicKey, isSigner: false, isWritable: true },
+            {
+                pubkey: getNativeMintAssociatedTokenAddressSync(walletPublicKey),
+                isSigner: false,
+                isWritable: true,
+            },
+            { pubkey: sessionKey, isSigner: true, isWritable: false },
+        ],
+        data: Buffer.from(data),
+    });
+}
+/**
+ * Creates the sequence of instructions required to wrap native tokens within a session.
+ *
+ * Note: This function sets the session key as the payer for the `CreateAssociatedTokenAccountIdempotent` instruction, which is unconventional since the session key can't spend funds.
+ * It works because at the time `CreateAssociatedTokenAccountIdempotent` is called, the `userTokenAccount` has already been funded by the `SessionWrap` instruction.
+ * The paymaster will reject the transaction if the payer of the `CreateAssociatedTokenAccountIdempotent` is set to the paymaster payer to avoid the paymaster's funds getting drained.
+ */
+export function createSessionWrapInstructions(sessionKey, walletPublicKey, amount) {
+    const userTokenAccount = getAssociatedTokenAddressSync(NATIVE_MINT, walletPublicKey);
+    return [
+        createSystemProgramSessionWrapInstruction(sessionKey, walletPublicKey, amount),
+        createAssociatedTokenAccountIdempotentInstruction(sessionKey, // This is unconventional! Read the note in the function's docs.
+        userTokenAccount, walletPublicKey, NATIVE_MINT),
+        createSyncNativeInstruction(userTokenAccount),
+    ];
+}
+/**
+ * Creates the instruction required to unwrap native tokens within a session.
+ */
+export function createSessionUnwrapInstruction(sessionKey, walletPublicKey) {
+    return createCloseAccountInstruction(getNativeMintAssociatedTokenAddressSync(walletPublicKey), walletPublicKey, sessionKey);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fogo/sessions-sdk",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "A set of utilities for integrating with Fogo sessions",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
   "main": "./cjs/index.js",
   "types": "./cjs/index.d.ts",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "exports": {
     ".": {
@@ -49,6 +49,6 @@
     "bn.js": "^5.1.2",
     "bs58": "^6.0.0",
     "zod": "3.25.67",
-    "@fogo/sessions-idls": "^0.0.12"
+    "@fogo/sessions-idls": "^0.0.13"
   }
 }