@fogo/sessions-sdk 0.0.9 → 0.0.11

package/cjs/adapter.d.ts

@@ -6,7 +6,7 @@ export type SessionAdapter = {
     connection: Connection;
     payer: PublicKey;
     domain: string;
-    sendTransaction: (sessionKey: CryptoKeyPair, instructions: (TransactionInstruction | IInstruction)[] | VersionedTransaction | Transaction) => Promise<TransactionResult>;
+    sendTransaction: (sessionKey: CryptoKeyPair | undefined, instructions: (TransactionInstruction | IInstruction)[] | VersionedTransaction | Transaction) => Promise<TransactionResult>;
 };
 export declare enum TransactionResultType {
     Success = 0,
@@ -31,7 +31,7 @@ export declare const createSolanaWalletAdapter: (options: {
 } & ({
     paymaster?: string | URL | undefined;
 } | {
-    sendToPaymaster: (transaction: Transaction) => Promise<string>;
+    sendToPaymaster: (transaction: Transaction) => Promise<TransactionResult>;
     sponsor: PublicKey;
 })) => Promise<SessionAdapter>;
 export {};

package/cjs/adapter.js

@@ -29,7 +29,8 @@ const TransactionResult = {
 };
 const createSolanaWalletAdapter = async (options) => {
     const addressLookupTables = await getAddressLookupTables(options.connection, options.addressLookupTableAddress);
-    const sponsor = await getSponsor(options);
+    const domain = getDomain(options.domain);
+    const sponsor = await getSponsor(options, domain);
     return {
         connection: options.connection,
         payer: sponsor,
@@ -38,46 +39,71 @@ const createSolanaWalletAdapter = async (options) => {
         sendTransaction: async (sessionKey, instructions) => {
             const rpc = (0, kit_1.createSolanaRpc)(options.connection.rpcEndpoint);
             const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
-            const sessionKeySigner = await (0, kit_1.createSignerFromKeyPair)(sessionKey);
-            const transaction = Array.isArray(instructions)
-                ? await (0, kit_1.partiallySignTransactionMessageWithSigners)((0, kit_1.pipe)((0, kit_1.createTransactionMessage)({ version: 0 }), (tx) => (0, kit_1.setTransactionMessageFeePayer)((0, compat_1.fromLegacyPublicKey)(sponsor), tx), (tx) => (0, kit_1.setTransactionMessageLifetimeUsingBlockhash)(latestBlockhash, tx), (tx) => (0, kit_1.appendTransactionMessageInstructions)(instructions.map((instruction) => instruction instanceof web3_js_1.TransactionInstruction
-                    ? (0, compat_1.fromLegacyTransactionInstruction)(instruction)
-                    : instruction), tx), (tx) => (0, kit_1.compressTransactionMessageUsingAddressLookupTables)(tx, Object.fromEntries(addressLookupTables?.map((table) => [
-                    (0, compat_1.fromLegacyPublicKey)(table.key),
-                    table.state.addresses.map((address) => (0, compat_1.fromLegacyPublicKey)(address)),
-                ]) ?? [])), (tx) => (0, kit_1.addSignersToTransactionMessage)([sessionKeySigner], tx)))
-                : await (0, kit_1.partiallySignTransaction)([sessionKey], instructions instanceof web3_js_1.VersionedTransaction
-                    ? (0, compat_1.fromVersionedTransaction)(instructions)
-                    : instructions);
-            const signature = await sendToPaymaster(options, transaction);
-            const lastValidBlockHeight = await rpc.getSlot().send();
-            const confirmationResult = await options.connection.confirmTransaction({
-                signature,
-                blockhash: latestBlockhash.blockhash.toString(),
-                lastValidBlockHeight: Number(lastValidBlockHeight),
-            });
-            return confirmationResult.value.err === null
-                ? TransactionResult.Success(signature)
-                : TransactionResult.Failed(signature, confirmationResult.value.err);
+            return await sendToPaymaster(options, await buildTransaction(latestBlockhash, sessionKey, sponsor, instructions, addressLookupTables), domain);
         },
     };
 };
 exports.createSolanaWalletAdapter = createSolanaWalletAdapter;
-const getSponsor = async (options) => {
+const buildTransaction = async (latestBlockhash, sessionKey, sponsor, instructions, addressLookupTables) => {
+    const sessionKeySigner = sessionKey
+        ? await (0, kit_1.createSignerFromKeyPair)(sessionKey)
+        : undefined;
+    if (Array.isArray(instructions)) {
+        return (0, kit_1.partiallySignTransactionMessageWithSigners)((0, kit_1.pipe)((0, kit_1.createTransactionMessage)({ version: 0 }), (tx) => (0, kit_1.setTransactionMessageFeePayer)((0, compat_1.fromLegacyPublicKey)(sponsor), tx), (tx) => (0, kit_1.setTransactionMessageLifetimeUsingBlockhash)(latestBlockhash, tx), (tx) => (0, kit_1.appendTransactionMessageInstructions)(instructions.map((instruction) => instruction instanceof web3_js_1.TransactionInstruction
+            ? (0, compat_1.fromLegacyTransactionInstruction)(instruction)
+            : instruction), tx), (tx) => (0, kit_1.compressTransactionMessageUsingAddressLookupTables)(tx, Object.fromEntries(addressLookupTables?.map((table) => [
+            (0, compat_1.fromLegacyPublicKey)(table.key),
+            table.state.addresses.map((address) => (0, compat_1.fromLegacyPublicKey)(address)),
+        ]) ?? [])), (tx) => sessionKeySigner === undefined
+            ? tx
+            : (0, kit_1.addSignersToTransactionMessage)([sessionKeySigner], tx)));
+    }
+    else {
+        const tx = instructions instanceof web3_js_1.VersionedTransaction
+            ? (0, compat_1.fromVersionedTransaction)(instructions)
+            : instructions;
+        return sessionKey === undefined
+            ? tx
+            : (0, kit_1.partiallySignTransaction)([sessionKey], tx);
+    }
+};
+const getSponsor = async (options, domain) => {
     if ("sponsor" in options) {
         return options.sponsor;
     }
     else {
-        const response = await fetch(new URL("/api/sponsor_pubkey", options.paymaster ?? DEFAULT_PAYMASTER));
+        const url = new URL("/api/sponsor_pubkey", options.paymaster ?? DEFAULT_PAYMASTER);
+        url.searchParams.set("domain", domain);
+        const response = await fetch(url);
         return new web3_js_1.PublicKey(zod_1.z.string().parse(await response.text()));
     }
 };
-const sendToPaymaster = async (options, transaction) => {
+const sponsorAndSendResponseSchema = zod_1.z
+    .discriminatedUnion("type", [
+    zod_1.z.object({
+        type: zod_1.z.literal("success"),
+        signature: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("failed"),
+        signature: zod_1.z.string(),
+        error: zod_1.z.object({}),
+    }),
+])
+    .transform((data) => {
+    return data.type === "success"
+        ? TransactionResult.Success(data.signature)
+        : TransactionResult.Failed(data.signature, data.error);
+});
+const sendToPaymaster = async (options, transaction, domain) => {
     if ("sendToPaymaster" in options) {
         return options.sendToPaymaster(transaction);
     }
     else {
-        const response = await fetch(new URL("/api/sponsor_and_send", options.paymaster ?? DEFAULT_PAYMASTER), {
+        const url = new URL("/api/sponsor_and_send", options.paymaster ?? DEFAULT_PAYMASTER);
+        url.searchParams.set("confirm", "true");
+        url.searchParams.set("domain", domain);
+        const response = await fetch(url, {
             method: "POST",
             headers: {
                 "Content-Type": "application/json",
@@ -87,7 +113,7 @@ const sendToPaymaster = async (options, transaction) => {
             }),
         });
         if (response.status === 200) {
-            return response.text();
+            return sponsorAndSendResponseSchema.parse(await response.json());
         }
         else {
             throw new PaymasterResponseError(response.status, await response.text());

package/cjs/index.d.ts

@@ -290,3 +290,12 @@ export type Session = {
     sendTransaction: (instructions: Parameters<SessionAdapter["sendTransaction"]>[1]) => Promise<TransactionResult>;
     sessionInfo: z.infer<typeof sessionInfoSchema>;
 };
+type SendTransferOptions = {
+    adapter: SessionAdapter;
+    walletPublicKey: PublicKey;
+    signMessage: (message: Uint8Array) => Promise<Uint8Array>;
+    mint: PublicKey;
+    amount: bigint;
+    recipient: PublicKey;
+};
+export declare const sendTransfer: (options: SendTransferOptions) => Promise<TransactionResult>;

package/cjs/index.js

@@ -3,13 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionResultType = exports.getDomainRecordAddress = exports.AuthorizedTokens = exports.AuthorizedProgramsType = exports.getSessionAccount = exports.reestablishSession = exports.replaceSession = exports.establishSession = exports.createSolanaWalletAdapter = exports.TransactionResultType = void 0;
+exports.sendTransfer = exports.SessionResultType = exports.getDomainRecordAddress = exports.AuthorizedTokens = exports.AuthorizedProgramsType = exports.getSessionAccount = exports.reestablishSession = exports.replaceSession = exports.establishSession = exports.createSolanaWalletAdapter = exports.TransactionResultType = 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");
 const umi_1 = require("@metaplex-foundation/umi");
 const umi_bundle_defaults_1 = require("@metaplex-foundation/umi-bundle-defaults");
 const sha2_1 = require("@noble/hashes/sha2");
+const compat_1 = require("@solana/compat");
 const kit_1 = require("@solana/kit");
 const spl_token_1 = require("@solana/spl-token");
 const web3_js_1 = require("@solana/web3.js");
@@ -26,6 +27,8 @@ const UNLIMITED_TOKEN_PERMISSIONS_VALUE = "this app may spend any amount of any
 const TOKENLESS_PERMISSIONS_VALUE = "this app may not spend any tokens";
 const CURRENT_MAJOR = "0";
 const CURRENT_MINOR = "1";
+const CURRENT_INTENT_TRANSFER_MAJOR = "0";
+const CURRENT_INTENT_TRANSFER_MINOR = "1";
 const establishSession = async (options) => {
     const sessionKey = await (0, kit_1.generateKeyPair)();
     if (options.unlimited) {
@@ -155,10 +158,11 @@ var AuthorizedTokens;
     AuthorizedTokens[AuthorizedTokens["All"] = 0] = "All";
     AuthorizedTokens[AuthorizedTokens["Specific"] = 1] = "Specific";
 })(AuthorizedTokens || (exports.AuthorizedTokens = AuthorizedTokens = {}));
-const SymbolOrMintType = {
-    Symbol: "Symbol",
-    Mint: "Mint",
-};
+var SymbolOrMintType;
+(function (SymbolOrMintType) {
+    SymbolOrMintType[SymbolOrMintType["Symbol"] = 0] = "Symbol";
+    SymbolOrMintType[SymbolOrMintType["Mint"] = 1] = "Mint";
+})(SymbolOrMintType || (SymbolOrMintType = {}));
 const SymbolOrMint = {
     Symbol: (symbol) => ({
         type: SymbolOrMintType.Symbol,
@@ -303,3 +307,62 @@ const EstablishSessionResult = {
         error,
     }),
 };
+const TRANSFER_MESSAGE_HEADER = `Fogo Transfer:
+Signing this intent will transfer the tokens as described below.
+`;
+const sendTransfer = async (options) => {
+    const sourceAta = (0, spl_token_1.getAssociatedTokenAddressSync)(options.mint, options.walletPublicKey);
+    const destinationAta = (0, spl_token_1.getAssociatedTokenAddressSync)(options.mint, options.recipient);
+    const program = new sessions_idls_1.IntentTransferProgram(new anchor_1.AnchorProvider(options.adapter.connection, {}, {}));
+    const umi = (0, umi_bundle_defaults_1.createUmi)(options.adapter.connection.rpcEndpoint);
+    const metaplexMint = (0, umi_1.publicKey)(options.mint.toBase58());
+    const metadataAddress = (0, mpl_token_metadata_1.findMetadataPda)(umi, { mint: metaplexMint })[0];
+    const metadata = await (0, mpl_token_metadata_1.safeFetchMetadata)(umi, metadataAddress);
+    const symbol = metadata?.symbol ?? undefined;
+    return options.adapter.sendTransaction(undefined, [
+        (0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(options.adapter.payer, destinationAta, options.recipient, options.mint),
+        await buildTransferIntentInstruction(program, options, symbol),
+        await program.methods
+            .sendTokens()
+            .accounts({
+            destination: destinationAta,
+            mint: options.mint,
+            source: sourceAta,
+            sponsor: options.adapter.payer,
+            // eslint-disable-next-line unicorn/no-null
+            metadata: symbol === undefined ? null : new web3_js_1.PublicKey(metadataAddress),
+        })
+            .instruction(),
+    ]);
+};
+exports.sendTransfer = sendTransfer;
+const buildTransferIntentInstruction = async (program, options, symbol) => {
+    const [nonce, { decimals }] = await Promise.all([
+        getNonce(program, options.walletPublicKey),
+        (0, spl_token_1.getMint)(options.adapter.connection, options.mint),
+    ]);
+    const message = new TextEncoder().encode([
+        TRANSFER_MESSAGE_HEADER,
+        serializeKV({
+            version: `${CURRENT_INTENT_TRANSFER_MAJOR}.${CURRENT_INTENT_TRANSFER_MINOR}`,
+            chain_id: options.adapter.chainId,
+            token: symbol ?? options.mint.toBase58(),
+            amount: amountToString(options.amount, decimals),
+            recipient: options.recipient.toBase58(),
+            nonce: nonce === null ? "1" : nonce.nonce.add(new bn_js_1.default(1)).toString(),
+        }),
+    ].join("\n"));
+    const intentSignature = await options.signMessage(message);
+    return web3_js_1.Ed25519Program.createInstructionWithPublicKey({
+        publicKey: options.walletPublicKey.toBytes(),
+        signature: intentSignature,
+        message: message,
+    });
+};
+const getNonce = async (program, walletPublicKey) => {
+    const [noncePda] = await (0, kit_1.getProgramDerivedAddress)({
+        programAddress: (0, compat_1.fromLegacyPublicKey)(program.programId),
+        seeds: [Buffer.from("nonce"), walletPublicKey.toBuffer()],
+    });
+    return program.account.nonce.fetchNullable(noncePda);
+};

package/esm/adapter.d.ts

@@ -6,7 +6,7 @@ export type SessionAdapter = {
     connection: Connection;
     payer: PublicKey;
     domain: string;
-    sendTransaction: (sessionKey: CryptoKeyPair, instructions: (TransactionInstruction | IInstruction)[] | VersionedTransaction | Transaction) => Promise<TransactionResult>;
+    sendTransaction: (sessionKey: CryptoKeyPair | undefined, instructions: (TransactionInstruction | IInstruction)[] | VersionedTransaction | Transaction) => Promise<TransactionResult>;
 };
 export declare enum TransactionResultType {
     Success = 0,
@@ -31,7 +31,7 @@ export declare const createSolanaWalletAdapter: (options: {
 } & ({
     paymaster?: string | URL | undefined;
 } | {
-    sendToPaymaster: (transaction: Transaction) => Promise<string>;
+    sendToPaymaster: (transaction: Transaction) => Promise<TransactionResult>;
     sponsor: PublicKey;
 })) => Promise<SessionAdapter>;
 export {};

package/esm/adapter.js

@@ -26,7 +26,8 @@ const TransactionResult = {
 };
 export const createSolanaWalletAdapter = async (options) => {
     const addressLookupTables = await getAddressLookupTables(options.connection, options.addressLookupTableAddress);
-    const sponsor = await getSponsor(options);
+    const domain = getDomain(options.domain);
+    const sponsor = await getSponsor(options, domain);
     return {
         connection: options.connection,
         payer: sponsor,
@@ -35,45 +36,70 @@ export const createSolanaWalletAdapter = async (options) => {
         sendTransaction: async (sessionKey, instructions) => {
             const rpc = createSolanaRpc(options.connection.rpcEndpoint);
             const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
-            const sessionKeySigner = await createSignerFromKeyPair(sessionKey);
-            const transaction = Array.isArray(instructions)
-                ? await partiallySignTransactionMessageWithSigners(pipe(createTransactionMessage({ version: 0 }), (tx) => setTransactionMessageFeePayer(fromLegacyPublicKey(sponsor), tx), (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx), (tx) => appendTransactionMessageInstructions(instructions.map((instruction) => instruction instanceof TransactionInstruction
-                    ? fromLegacyTransactionInstruction(instruction)
-                    : instruction), tx), (tx) => compressTransactionMessageUsingAddressLookupTables(tx, Object.fromEntries(addressLookupTables?.map((table) => [
-                    fromLegacyPublicKey(table.key),
-                    table.state.addresses.map((address) => fromLegacyPublicKey(address)),
-                ]) ?? [])), (tx) => addSignersToTransactionMessage([sessionKeySigner], tx)))
-                : await partiallySignTransaction([sessionKey], instructions instanceof VersionedTransaction
-                    ? fromVersionedTransaction(instructions)
-                    : instructions);
-            const signature = await sendToPaymaster(options, transaction);
-            const lastValidBlockHeight = await rpc.getSlot().send();
-            const confirmationResult = await options.connection.confirmTransaction({
-                signature,
-                blockhash: latestBlockhash.blockhash.toString(),
-                lastValidBlockHeight: Number(lastValidBlockHeight),
-            });
-            return confirmationResult.value.err === null
-                ? TransactionResult.Success(signature)
-                : TransactionResult.Failed(signature, confirmationResult.value.err);
+            return await sendToPaymaster(options, await buildTransaction(latestBlockhash, sessionKey, sponsor, instructions, addressLookupTables), domain);
         },
     };
 };
-const getSponsor = async (options) => {
+const buildTransaction = async (latestBlockhash, sessionKey, sponsor, instructions, addressLookupTables) => {
+    const sessionKeySigner = sessionKey
+        ? await createSignerFromKeyPair(sessionKey)
+        : undefined;
+    if (Array.isArray(instructions)) {
+        return partiallySignTransactionMessageWithSigners(pipe(createTransactionMessage({ version: 0 }), (tx) => setTransactionMessageFeePayer(fromLegacyPublicKey(sponsor), tx), (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx), (tx) => appendTransactionMessageInstructions(instructions.map((instruction) => instruction instanceof TransactionInstruction
+            ? fromLegacyTransactionInstruction(instruction)
+            : instruction), tx), (tx) => compressTransactionMessageUsingAddressLookupTables(tx, Object.fromEntries(addressLookupTables?.map((table) => [
+            fromLegacyPublicKey(table.key),
+            table.state.addresses.map((address) => fromLegacyPublicKey(address)),
+        ]) ?? [])), (tx) => sessionKeySigner === undefined
+            ? tx
+            : addSignersToTransactionMessage([sessionKeySigner], tx)));
+    }
+    else {
+        const tx = instructions instanceof VersionedTransaction
+            ? fromVersionedTransaction(instructions)
+            : instructions;
+        return sessionKey === undefined
+            ? tx
+            : partiallySignTransaction([sessionKey], tx);
+    }
+};
+const getSponsor = async (options, domain) => {
     if ("sponsor" in options) {
         return options.sponsor;
     }
     else {
-        const response = await fetch(new URL("/api/sponsor_pubkey", options.paymaster ?? DEFAULT_PAYMASTER));
+        const url = new URL("/api/sponsor_pubkey", options.paymaster ?? DEFAULT_PAYMASTER);
+        url.searchParams.set("domain", domain);
+        const response = await fetch(url);
         return new PublicKey(z.string().parse(await response.text()));
     }
 };
-const sendToPaymaster = async (options, transaction) => {
+const sponsorAndSendResponseSchema = z
+    .discriminatedUnion("type", [
+    z.object({
+        type: z.literal("success"),
+        signature: z.string(),
+    }),
+    z.object({
+        type: z.literal("failed"),
+        signature: z.string(),
+        error: z.object({}),
+    }),
+])
+    .transform((data) => {
+    return data.type === "success"
+        ? TransactionResult.Success(data.signature)
+        : TransactionResult.Failed(data.signature, data.error);
+});
+const sendToPaymaster = async (options, transaction, domain) => {
     if ("sendToPaymaster" in options) {
         return options.sendToPaymaster(transaction);
     }
     else {
-        const response = await fetch(new URL("/api/sponsor_and_send", options.paymaster ?? DEFAULT_PAYMASTER), {
+        const url = new URL("/api/sponsor_and_send", options.paymaster ?? DEFAULT_PAYMASTER);
+        url.searchParams.set("confirm", "true");
+        url.searchParams.set("domain", domain);
+        const response = await fetch(url, {
             method: "POST",
             headers: {
                 "Content-Type": "application/json",
@@ -83,7 +109,7 @@ const sendToPaymaster = async (options, transaction) => {
             }),
         });
         if (response.status === 200) {
-            return response.text();
+            return sponsorAndSendResponseSchema.parse(await response.json());
         }
         else {
             throw new PaymasterResponseError(response.status, await response.text());

package/esm/index.d.ts

@@ -290,3 +290,12 @@ export type Session = {
     sendTransaction: (instructions: Parameters<SessionAdapter["sendTransaction"]>[1]) => Promise<TransactionResult>;
     sessionInfo: z.infer<typeof sessionInfoSchema>;
 };
+type SendTransferOptions = {
+    adapter: SessionAdapter;
+    walletPublicKey: PublicKey;
+    signMessage: (message: Uint8Array) => Promise<Uint8Array>;
+    mint: PublicKey;
+    amount: bigint;
+    recipient: PublicKey;
+};
+export declare const sendTransfer: (options: SendTransferOptions) => Promise<TransactionResult>;

package/esm/index.js

@@ -1,10 +1,11 @@
 import { AnchorProvider, BorshAccountsCoder } from "@coral-xyz/anchor";
-import { DomainRegistryIdl, SessionManagerProgram, SessionManagerIdl, } from "@fogo/sessions-idls";
+import { DomainRegistryIdl, SessionManagerProgram, SessionManagerIdl, IntentTransferProgram, } from "@fogo/sessions-idls";
 import { findMetadataPda, safeFetchMetadata, } from "@metaplex-foundation/mpl-token-metadata";
 import { publicKey as metaplexPublicKey } from "@metaplex-foundation/umi";
 import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
 import { sha256 } from "@noble/hashes/sha2";
-import { generateKeyPair, getAddressFromPublicKey } from "@solana/kit";
+import { fromLegacyPublicKey } from "@solana/compat";
+import { generateKeyPair, getAddressFromPublicKey, getProgramDerivedAddress, } from "@solana/kit";
 import { createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddressSync, getMint, } from "@solana/spl-token";
 import { Ed25519Program, PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
@@ -18,6 +19,8 @@ const UNLIMITED_TOKEN_PERMISSIONS_VALUE = "this app may spend any amount of any
 const TOKENLESS_PERMISSIONS_VALUE = "this app may not spend any tokens";
 const CURRENT_MAJOR = "0";
 const CURRENT_MINOR = "1";
+const CURRENT_INTENT_TRANSFER_MAJOR = "0";
+const CURRENT_INTENT_TRANSFER_MINOR = "1";
 export const establishSession = async (options) => {
     const sessionKey = await generateKeyPair();
     if (options.unlimited) {
@@ -143,10 +146,11 @@ export var AuthorizedTokens;
     AuthorizedTokens[AuthorizedTokens["All"] = 0] = "All";
     AuthorizedTokens[AuthorizedTokens["Specific"] = 1] = "Specific";
 })(AuthorizedTokens || (AuthorizedTokens = {}));
-const SymbolOrMintType = {
-    Symbol: "Symbol",
-    Mint: "Mint",
-};
+var SymbolOrMintType;
+(function (SymbolOrMintType) {
+    SymbolOrMintType[SymbolOrMintType["Symbol"] = 0] = "Symbol";
+    SymbolOrMintType[SymbolOrMintType["Mint"] = 1] = "Mint";
+})(SymbolOrMintType || (SymbolOrMintType = {}));
 const SymbolOrMint = {
     Symbol: (symbol) => ({
         type: SymbolOrMintType.Symbol,
@@ -290,3 +294,61 @@ const EstablishSessionResult = {
         error,
     }),
 };
+const TRANSFER_MESSAGE_HEADER = `Fogo Transfer:
+Signing this intent will transfer the tokens as described below.
+`;
+export const sendTransfer = async (options) => {
+    const sourceAta = getAssociatedTokenAddressSync(options.mint, options.walletPublicKey);
+    const destinationAta = getAssociatedTokenAddressSync(options.mint, options.recipient);
+    const program = new IntentTransferProgram(new AnchorProvider(options.adapter.connection, {}, {}));
+    const umi = createUmi(options.adapter.connection.rpcEndpoint);
+    const metaplexMint = metaplexPublicKey(options.mint.toBase58());
+    const metadataAddress = findMetadataPda(umi, { mint: metaplexMint })[0];
+    const metadata = await safeFetchMetadata(umi, metadataAddress);
+    const symbol = metadata?.symbol ?? undefined;
+    return options.adapter.sendTransaction(undefined, [
+        createAssociatedTokenAccountIdempotentInstruction(options.adapter.payer, destinationAta, options.recipient, options.mint),
+        await buildTransferIntentInstruction(program, options, symbol),
+        await program.methods
+            .sendTokens()
+            .accounts({
+            destination: destinationAta,
+            mint: options.mint,
+            source: sourceAta,
+            sponsor: options.adapter.payer,
+            // eslint-disable-next-line unicorn/no-null
+            metadata: symbol === undefined ? null : new PublicKey(metadataAddress),
+        })
+            .instruction(),
+    ]);
+};
+const buildTransferIntentInstruction = async (program, options, symbol) => {
+    const [nonce, { decimals }] = await Promise.all([
+        getNonce(program, options.walletPublicKey),
+        getMint(options.adapter.connection, options.mint),
+    ]);
+    const message = new TextEncoder().encode([
+        TRANSFER_MESSAGE_HEADER,
+        serializeKV({
+            version: `${CURRENT_INTENT_TRANSFER_MAJOR}.${CURRENT_INTENT_TRANSFER_MINOR}`,
+            chain_id: options.adapter.chainId,
+            token: symbol ?? options.mint.toBase58(),
+            amount: amountToString(options.amount, decimals),
+            recipient: options.recipient.toBase58(),
+            nonce: nonce === null ? "1" : nonce.nonce.add(new BN(1)).toString(),
+        }),
+    ].join("\n"));
+    const intentSignature = await options.signMessage(message);
+    return Ed25519Program.createInstructionWithPublicKey({
+        publicKey: options.walletPublicKey.toBytes(),
+        signature: intentSignature,
+        message: message,
+    });
+};
+const getNonce = async (program, walletPublicKey) => {
+    const [noncePda] = await getProgramDerivedAddress({
+        programAddress: fromLegacyPublicKey(program.programId),
+        seeds: [Buffer.from("nonce"), walletPublicKey.toBuffer()],
+    });
+    return program.account.nonce.fetchNullable(noncePda);
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fogo/sessions-sdk",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "A set of utilities for integrating with Fogo sessions",
   "keywords": [
     "fogo",
@@ -48,6 +48,6 @@
     "bn.js": "^5.1.2",
     "bs58": "^6.0.0",
     "zod": "^3.25.62",
-    "@fogo/sessions-idls": "^0.0.3"
+    "@fogo/sessions-idls": "^0.0.4"
   }
 }