torchsdk 1.0.0

package/dist/transactions.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Transaction builders
+ *
+ * Build unsigned transactions for buy, sell, create, vote, star, and message.
+ * Agents sign these locally and submit to the network.
+ */
+import { Connection } from '@solana/web3.js';
+import { BuyParams, SellParams, CreateTokenParams, VoteParams, StarParams, MessageParams, BorrowParams, RepayParams, LiquidateParams, TransactionResult, CreateTokenResult } from './types';
+/**
+ * Build an unsigned buy transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Buy parameters (mint, buyer, amount_sol in lamports, optional slippage_bps and vote)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildBuyTransaction: (connection: Connection, params: BuyParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned sell transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Sell parameters (mint, seller, amount_tokens in raw units, optional slippage_bps)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildSellTransaction: (connection: Connection, params: SellParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned create token transaction.
+ *
+ * Returns the transaction (partially signed by the mint keypair) and the mint keypair
+ * so the agent can extract the mint address.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Create parameters (creator, name, symbol, metadata_uri)
+ * @returns Partially-signed transaction, mint PublicKey, and mint Keypair
+ */
+export declare const buildCreateTokenTransaction: (connection: Connection, params: CreateTokenParams) => Promise<CreateTokenResult>;
+/**
+ * Build an unsigned vote transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Vote parameters (mint, voter, vote: "burn" | "return")
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildVoteTransaction: (connection: Connection, params: VoteParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned star transaction (costs 0.05 SOL).
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Star parameters (mint, user)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildStarTransaction: (connection: Connection, params: StarParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned message transaction (SPL Memo).
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Message parameters (mint, sender, message text)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildMessageTransaction: (connection: Connection, params: MessageParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned borrow transaction.
+ *
+ * Lock tokens as collateral in the collateral vault and receive SOL from treasury.
+ * Token must be migrated (has Raydium pool for price calculation).
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Borrow parameters (mint, borrower, collateral_amount, sol_to_borrow)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildBorrowTransaction: (connection: Connection, params: BorrowParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned repay transaction.
+ *
+ * Repay SOL debt. Interest is paid first, then principal.
+ * Full repay returns all collateral and closes the position.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Repay parameters (mint, borrower, sol_amount)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildRepayTransaction: (connection: Connection, params: RepayParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned liquidate transaction.
+ *
+ * Permissionless — anyone can call when a borrower's LTV exceeds the
+ * liquidation threshold. Liquidator pays SOL and receives collateral + bonus.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Liquidate parameters (mint, liquidator, borrower)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildLiquidateTransaction: (connection: Connection, params: LiquidateParams) => Promise<TransactionResult>;
+//# sourceMappingURL=transactions.d.ts.map

package/dist/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EAOX,MAAM,iBAAiB,CAAA;AA2BxB,OAAO,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,SAAS,CAAA;AA8BhB;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,UAAU,EACtB,QAAQ,SAAS,KAChB,OAAO,CAAC,iBAAiB,CAgG3B,CAAA;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,EACtB,QAAQ,UAAU,KACjB,OAAO,CAAC,iBAAiB,CAoE3B,CAAA;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,GACtC,YAAY,UAAU,EACtB,QAAQ,iBAAiB,KACxB,OAAO,CAAC,iBAAiB,CAiE3B,CAAA;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,EACtB,QAAQ,UAAU,KACjB,OAAO,CAAC,iBAAiB,CA4C3B,CAAA;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,EACtB,QAAQ,UAAU,KACjB,OAAO,CAAC,iBAAiB,CAiD3B,CAAA;AAQD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,UAAU,EACtB,QAAQ,aAAa,KACpB,OAAO,CAAC,iBAAiB,CAiC3B,CAAA;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,UAAU,EACtB,QAAQ,YAAY,KACnB,OAAO,CAAC,iBAAiB,CAuD3B,CAAA;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,UAAU,EACtB,QAAQ,WAAW,KAClB,OAAO,CAAC,iBAAiB,CA4C3B,CAAA;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACpC,YAAY,UAAU,EACtB,QAAQ,eAAe,KACtB,OAAO,CAAC,iBAAiB,CAmE3B,CAAA"}

package/dist/transactions.js

@@ -0,0 +1,550 @@
+"use strict";
+/**
+ * Transaction builders
+ *
+ * Build unsigned transactions for buy, sell, create, vote, star, and message.
+ * Agents sign these locally and submit to the network.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLiquidateTransaction = exports.buildRepayTransaction = exports.buildBorrowTransaction = exports.buildMessageTransaction = exports.buildStarTransaction = exports.buildVoteTransaction = exports.buildCreateTokenTransaction = exports.buildSellTransaction = exports.buildBuyTransaction = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const anchor_1 = require("@coral-xyz/anchor");
+const program_1 = require("./program");
+const constants_1 = require("./constants");
+const tokens_1 = require("./tokens");
+const torch_market_json_1 = __importDefault(require("./torch_market.json"));
+// ============================================================================
+// Helpers
+// ============================================================================
+const makeDummyProvider = (connection, payer) => {
+    const dummyWallet = {
+        publicKey: payer,
+        signTransaction: async (t) => t,
+        signAllTransactions: async (t) => t,
+    };
+    return new anchor_1.AnchorProvider(connection, dummyWallet, {});
+};
+const finalizeTransaction = async (connection, tx, feePayer) => {
+    const { blockhash } = await connection.getLatestBlockhash();
+    tx.recentBlockhash = blockhash;
+    tx.feePayer = feePayer;
+};
+// ============================================================================
+// Buy
+// ============================================================================
+/**
+ * Build an unsigned buy transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Buy parameters (mint, buyer, amount_sol in lamports, optional slippage_bps and vote)
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildBuyTransaction = async (connection, params) => {
+    const { mint: mintStr, buyer: buyerStr, amount_sol, slippage_bps = 100, vote } = params;
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const buyer = new web3_js_1.PublicKey(buyerStr);
+    const tokenData = await (0, tokens_1.fetchTokenRaw)(connection, mint);
+    if (!tokenData)
+        throw new Error(`Token not found: ${mintStr}`);
+    const { bondingCurve } = tokenData;
+    if (bondingCurve.bonding_complete)
+        throw new Error('Bonding curve complete, trade on DEX');
+    // Calculate expected output
+    const virtualSol = BigInt(bondingCurve.virtual_sol_reserves.toString());
+    const virtualTokens = BigInt(bondingCurve.virtual_token_reserves.toString());
+    const realSol = BigInt(bondingCurve.real_sol_reserves.toString());
+    const solAmount = BigInt(amount_sol);
+    const result = (0, program_1.calculateTokensOut)(solAmount, virtualSol, virtualTokens, realSol);
+    // Apply slippage
+    const slippage = Math.max(10, Math.min(1000, slippage_bps));
+    const minTokens = (result.tokensToUser * BigInt(10000 - slippage)) / BigInt(10000);
+    // Derive PDAs
+    const [bondingCurvePda] = (0, program_1.getBondingCurvePda)(mint);
+    const [treasuryPda] = (0, program_1.getTokenTreasuryPda)(mint);
+    const [userPositionPda] = (0, program_1.getUserPositionPda)(bondingCurvePda, buyer);
+    const [userStatsPda] = (0, program_1.getUserStatsPda)(buyer);
+    const [globalConfigPda] = (0, program_1.getGlobalConfigPda)();
+    const [protocolTreasuryPda] = (0, program_1.getProtocolTreasuryPda)();
+    const bondingCurveTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, bondingCurvePda, true, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    const treasuryTokenAccount = (0, program_1.getTreasuryTokenAccount)(mint, treasuryPda);
+    const userTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, buyer, false, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    const tx = new web3_js_1.Transaction();
+    // Create user ATA if needed
+    tx.add((0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(buyer, userTokenAccount, buyer, mint, spl_token_1.TOKEN_2022_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID));
+    const provider = makeDummyProvider(connection, buyer);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    // Fetch global config for dev wallet
+    const globalConfigAccount = (await program.account.globalConfig.fetch(globalConfigPda));
+    const buyIx = await program.methods
+        .buy({
+        solAmount: new anchor_1.BN(amount_sol.toString()),
+        minTokensOut: new anchor_1.BN(minTokens.toString()),
+        vote: vote === 'return' ? true : vote === 'burn' ? false : null,
+    })
+        .accounts({
+        buyer,
+        globalConfig: globalConfigPda,
+        devWallet: globalConfigAccount.devWallet || globalConfigAccount.dev_wallet,
+        protocolTreasury: protocolTreasuryPda,
+        mint,
+        bondingCurve: bondingCurvePda,
+        tokenVault: bondingCurveTokenAccount,
+        treasury: treasuryPda,
+        treasuryTokenAccount,
+        userTokenAccount,
+        userPosition: userPositionPda,
+        userStats: userStatsPda,
+        tokenProgram: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+        rent: web3_js_1.SYSVAR_RENT_PUBKEY,
+    })
+        .instruction();
+    tx.add(buyIx);
+    await finalizeTransaction(connection, tx, buyer);
+    return {
+        transaction: tx,
+        message: `Buy ${Number(result.tokensToUser) / 1e6} tokens for ${Number(solAmount) / 1e9} SOL`,
+    };
+};
+exports.buildBuyTransaction = buildBuyTransaction;
+// ============================================================================
+// Sell
+// ============================================================================
+/**
+ * Build an unsigned sell transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Sell parameters (mint, seller, amount_tokens in raw units, optional slippage_bps)
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildSellTransaction = async (connection, params) => {
+    const { mint: mintStr, seller: sellerStr, amount_tokens, slippage_bps = 100 } = params;
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const seller = new web3_js_1.PublicKey(sellerStr);
+    const tokenData = await (0, tokens_1.fetchTokenRaw)(connection, mint);
+    if (!tokenData)
+        throw new Error(`Token not found: ${mintStr}`);
+    const { bondingCurve } = tokenData;
+    if (bondingCurve.bonding_complete)
+        throw new Error('Bonding curve complete, trade on DEX');
+    // Calculate expected output
+    const virtualSol = BigInt(bondingCurve.virtual_sol_reserves.toString());
+    const virtualTokens = BigInt(bondingCurve.virtual_token_reserves.toString());
+    const tokenAmount = BigInt(amount_tokens);
+    const result = (0, program_1.calculateSolOut)(tokenAmount, virtualSol, virtualTokens);
+    // Apply slippage
+    const slippage = Math.max(10, Math.min(1000, slippage_bps));
+    const minSol = (result.solToUser * BigInt(10000 - slippage)) / BigInt(10000);
+    // Derive PDAs
+    const [bondingCurvePda] = (0, program_1.getBondingCurvePda)(mint);
+    const [treasuryPda] = (0, program_1.getTokenTreasuryPda)(mint);
+    const [userPositionPda] = (0, program_1.getUserPositionPda)(bondingCurvePda, seller);
+    const [userStatsPda] = (0, program_1.getUserStatsPda)(seller);
+    const [globalConfigPda] = (0, program_1.getGlobalConfigPda)();
+    const bondingCurveTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, bondingCurvePda, true, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    const userTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, seller, false, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    const tx = new web3_js_1.Transaction();
+    const provider = makeDummyProvider(connection, seller);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    const sellIx = await program.methods
+        .sell({
+        tokenAmount: new anchor_1.BN(amount_tokens.toString()),
+        minSolOut: new anchor_1.BN(minSol.toString()),
+    })
+        .accounts({
+        seller,
+        mint,
+        bondingCurve: bondingCurvePda,
+        tokenVault: bondingCurveTokenAccount,
+        sellerTokenAccount: userTokenAccount,
+        userPosition: userPositionPda,
+        userStats: userStatsPda,
+        tokenProgram: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    tx.add(sellIx);
+    await finalizeTransaction(connection, tx, seller);
+    return {
+        transaction: tx,
+        message: `Sell ${Number(tokenAmount) / 1e6} tokens for ${Number(result.solToUser) / 1e9} SOL`,
+    };
+};
+exports.buildSellTransaction = buildSellTransaction;
+// ============================================================================
+// Create Token
+// ============================================================================
+/**
+ * Build an unsigned create token transaction.
+ *
+ * Returns the transaction (partially signed by the mint keypair) and the mint keypair
+ * so the agent can extract the mint address.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Create parameters (creator, name, symbol, metadata_uri)
+ * @returns Partially-signed transaction, mint PublicKey, and mint Keypair
+ */
+const buildCreateTokenTransaction = async (connection, params) => {
+    const { creator: creatorStr, name, symbol, metadata_uri } = params;
+    const creator = new web3_js_1.PublicKey(creatorStr);
+    if (name.length > 32)
+        throw new Error('Name must be 32 characters or less');
+    if (symbol.length > 10)
+        throw new Error('Symbol must be 10 characters or less');
+    // Grind for vanity "tm" suffix
+    let mint;
+    const maxAttempts = 500000;
+    let attempts = 0;
+    while (true) {
+        mint = web3_js_1.Keypair.generate();
+        attempts++;
+        if (mint.publicKey.toBase58().endsWith('tm'))
+            break;
+        if (attempts >= maxAttempts)
+            break;
+    }
+    // Derive PDAs
+    const [globalConfig] = (0, program_1.getGlobalConfigPda)();
+    const [bondingCurve] = (0, program_1.getBondingCurvePda)(mint.publicKey);
+    const [treasury] = (0, program_1.getTokenTreasuryPda)(mint.publicKey);
+    const bondingCurveTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint.publicKey, bondingCurve, true, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    const treasuryTokenAccount = (0, program_1.getTreasuryTokenAccount)(mint.publicKey, treasury);
+    const tx = new web3_js_1.Transaction();
+    const provider = makeDummyProvider(connection, creator);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    const createIx = await program.methods
+        .createToken({ name, symbol, uri: metadata_uri })
+        .accounts({
+        creator,
+        globalConfig,
+        mint: mint.publicKey,
+        bondingCurve,
+        tokenVault: bondingCurveTokenAccount,
+        treasury,
+        treasuryTokenAccount,
+        token2022Program: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+        rent: web3_js_1.SYSVAR_RENT_PUBKEY,
+    })
+        .instruction();
+    tx.add(createIx);
+    await finalizeTransaction(connection, tx, creator);
+    // Partially sign with mint keypair
+    tx.partialSign(mint);
+    return {
+        transaction: tx,
+        mint: mint.publicKey,
+        mintKeypair: mint,
+        message: `Create token "${name}" ($${symbol})`,
+    };
+};
+exports.buildCreateTokenTransaction = buildCreateTokenTransaction;
+// ============================================================================
+// Vote
+// ============================================================================
+/**
+ * Build an unsigned vote transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Vote parameters (mint, voter, vote: "burn" | "return")
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildVoteTransaction = async (connection, params) => {
+    const { mint: mintStr, voter: voterStr, vote } = params;
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const voter = new web3_js_1.PublicKey(voterStr);
+    const tokenData = await (0, tokens_1.fetchTokenRaw)(connection, mint);
+    if (!tokenData)
+        throw new Error(`Token not found: ${mintStr}`);
+    const { bondingCurve } = tokenData;
+    if (!bondingCurve.bonding_complete)
+        throw new Error('Voting not open yet');
+    if (bondingCurve.vote_finalized)
+        throw new Error('Voting has ended');
+    // Derive PDAs
+    const [bondingCurvePda] = (0, program_1.getBondingCurvePda)(mint);
+    const [treasuryPda] = (0, program_1.getTokenTreasuryPda)(mint);
+    const [userPositionPda] = (0, program_1.getUserPositionPda)(bondingCurvePda, voter);
+    const [voteRecordPda] = (0, program_1.getVoteRecordPda)(bondingCurvePda, voter);
+    const tx = new web3_js_1.Transaction();
+    const provider = makeDummyProvider(connection, voter);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    const voteIx = await program.methods
+        .vote(vote === 'return')
+        .accounts({
+        user: voter,
+        mint,
+        bondingCurve: bondingCurvePda,
+        treasury: treasuryPda,
+        userPosition: userPositionPda,
+        voteRecord: voteRecordPda,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    tx.add(voteIx);
+    await finalizeTransaction(connection, tx, voter);
+    return {
+        transaction: tx,
+        message: `Vote to ${vote} treasury tokens`,
+    };
+};
+exports.buildVoteTransaction = buildVoteTransaction;
+// ============================================================================
+// Star
+// ============================================================================
+/**
+ * Build an unsigned star transaction (costs 0.05 SOL).
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Star parameters (mint, user)
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildStarTransaction = async (connection, params) => {
+    const { mint: mintStr, user: userStr } = params;
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const user = new web3_js_1.PublicKey(userStr);
+    const tokenData = await (0, tokens_1.fetchTokenRaw)(connection, mint);
+    if (!tokenData)
+        throw new Error(`Token not found: ${mintStr}`);
+    const { bondingCurve } = tokenData;
+    if (user.equals(bondingCurve.creator)) {
+        throw new Error('Cannot star your own token');
+    }
+    // Check if already starred
+    const [starRecordPda] = (0, program_1.getStarRecordPda)(user, mint);
+    const starRecord = await connection.getAccountInfo(starRecordPda);
+    if (starRecord)
+        throw new Error('Already starred this token');
+    // Derive PDAs
+    const [bondingCurvePda] = (0, program_1.getBondingCurvePda)(mint);
+    const [treasuryPda] = (0, program_1.getTokenTreasuryPda)(mint);
+    const tx = new web3_js_1.Transaction();
+    const provider = makeDummyProvider(connection, user);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    const starIx = await program.methods
+        .starToken()
+        .accounts({
+        user,
+        mint,
+        bondingCurve: bondingCurvePda,
+        treasury: treasuryPda,
+        creator: bondingCurve.creator,
+        starRecord: starRecordPda,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    tx.add(starIx);
+    await finalizeTransaction(connection, tx, user);
+    return {
+        transaction: tx,
+        message: 'Star token (costs 0.05 SOL)',
+    };
+};
+exports.buildStarTransaction = buildStarTransaction;
+// ============================================================================
+// Message
+// ============================================================================
+const MAX_MESSAGE_LENGTH = 500;
+/**
+ * Build an unsigned message transaction (SPL Memo).
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Message parameters (mint, sender, message text)
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildMessageTransaction = async (connection, params) => {
+    const { mint: mintStr, sender: senderStr, message } = params;
+    if (message.length > MAX_MESSAGE_LENGTH) {
+        throw new Error(`Message must be ${MAX_MESSAGE_LENGTH} characters or less`);
+    }
+    if (message.trim().length === 0) {
+        throw new Error('Message cannot be empty');
+    }
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const sender = new web3_js_1.PublicKey(senderStr);
+    const tokenData = await (0, tokens_1.fetchTokenRaw)(connection, mint);
+    if (!tokenData)
+        throw new Error(`Token not found: ${mintStr}`);
+    const tx = new web3_js_1.Transaction();
+    // Prefix memo with mint address for indexing
+    const prefixedMessage = `[${mintStr}] ${message}`;
+    const memoIx = new web3_js_1.TransactionInstruction({
+        programId: constants_1.MEMO_PROGRAM_ID,
+        keys: [{ pubkey: sender, isSigner: true, isWritable: false }],
+        data: Buffer.from(prefixedMessage, 'utf-8'),
+    });
+    tx.add(memoIx);
+    await finalizeTransaction(connection, tx, sender);
+    return {
+        transaction: tx,
+        message: `Post message on token page`,
+    };
+};
+exports.buildMessageTransaction = buildMessageTransaction;
+// ============================================================================
+// Borrow (V2.4)
+// ============================================================================
+/**
+ * Build an unsigned borrow transaction.
+ *
+ * Lock tokens as collateral in the collateral vault and receive SOL from treasury.
+ * Token must be migrated (has Raydium pool for price calculation).
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Borrow parameters (mint, borrower, collateral_amount, sol_to_borrow)
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildBorrowTransaction = async (connection, params) => {
+    const { mint: mintStr, borrower: borrowerStr, collateral_amount, sol_to_borrow } = params;
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const borrower = new web3_js_1.PublicKey(borrowerStr);
+    // Derive PDAs
+    const [bondingCurvePda] = (0, program_1.getBondingCurvePda)(mint);
+    const [treasuryPda] = (0, program_1.getTokenTreasuryPda)(mint);
+    const [collateralVaultPda] = (0, program_1.getCollateralVaultPda)(mint);
+    const [loanPositionPda] = (0, program_1.getLoanPositionPda)(mint, borrower);
+    const borrowerTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, borrower, false, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    // Get Raydium pool accounts for price calculation
+    const raydium = (0, program_1.getRaydiumMigrationAccounts)(mint);
+    const tx = new web3_js_1.Transaction();
+    const provider = makeDummyProvider(connection, borrower);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    const borrowIx = await program.methods
+        .borrow({
+        collateralAmount: new anchor_1.BN(collateral_amount.toString()),
+        solToBorrow: new anchor_1.BN(sol_to_borrow.toString()),
+    })
+        .accounts({
+        borrower,
+        mint,
+        bondingCurve: bondingCurvePda,
+        treasury: treasuryPda,
+        collateralVault: collateralVaultPda,
+        borrowerTokenAccount,
+        loanPosition: loanPositionPda,
+        poolState: raydium.poolState,
+        tokenVault0: raydium.token0Vault,
+        tokenVault1: raydium.token1Vault,
+        tokenProgram: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    tx.add(borrowIx);
+    await finalizeTransaction(connection, tx, borrower);
+    return {
+        transaction: tx,
+        message: `Borrow ${Number(sol_to_borrow) / 1e9} SOL with ${Number(collateral_amount) / 1e6} tokens as collateral`,
+    };
+};
+exports.buildBorrowTransaction = buildBorrowTransaction;
+// ============================================================================
+// Repay (V2.4)
+// ============================================================================
+/**
+ * Build an unsigned repay transaction.
+ *
+ * Repay SOL debt. Interest is paid first, then principal.
+ * Full repay returns all collateral and closes the position.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Repay parameters (mint, borrower, sol_amount)
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildRepayTransaction = async (connection, params) => {
+    const { mint: mintStr, borrower: borrowerStr, sol_amount } = params;
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const borrower = new web3_js_1.PublicKey(borrowerStr);
+    // Derive PDAs
+    const [treasuryPda] = (0, program_1.getTokenTreasuryPda)(mint);
+    const [collateralVaultPda] = (0, program_1.getCollateralVaultPda)(mint);
+    const [loanPositionPda] = (0, program_1.getLoanPositionPda)(mint, borrower);
+    const borrowerTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, borrower, false, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    const tx = new web3_js_1.Transaction();
+    const provider = makeDummyProvider(connection, borrower);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    const repayIx = await program.methods
+        .repay(new anchor_1.BN(sol_amount.toString()))
+        .accounts({
+        borrower,
+        mint,
+        treasury: treasuryPda,
+        collateralVault: collateralVaultPda,
+        borrowerTokenAccount,
+        loanPosition: loanPositionPda,
+        tokenProgram: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    tx.add(repayIx);
+    await finalizeTransaction(connection, tx, borrower);
+    return {
+        transaction: tx,
+        message: `Repay ${Number(sol_amount) / 1e9} SOL`,
+    };
+};
+exports.buildRepayTransaction = buildRepayTransaction;
+// ============================================================================
+// Liquidate (V2.4)
+// ============================================================================
+/**
+ * Build an unsigned liquidate transaction.
+ *
+ * Permissionless — anyone can call when a borrower's LTV exceeds the
+ * liquidation threshold. Liquidator pays SOL and receives collateral + bonus.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Liquidate parameters (mint, liquidator, borrower)
+ * @returns Unsigned transaction and descriptive message
+ */
+const buildLiquidateTransaction = async (connection, params) => {
+    const { mint: mintStr, liquidator: liquidatorStr, borrower: borrowerStr } = params;
+    const mint = new web3_js_1.PublicKey(mintStr);
+    const liquidator = new web3_js_1.PublicKey(liquidatorStr);
+    const borrower = new web3_js_1.PublicKey(borrowerStr);
+    // Derive PDAs
+    const [bondingCurvePda] = (0, program_1.getBondingCurvePda)(mint);
+    const [treasuryPda] = (0, program_1.getTokenTreasuryPda)(mint);
+    const [collateralVaultPda] = (0, program_1.getCollateralVaultPda)(mint);
+    const [loanPositionPda] = (0, program_1.getLoanPositionPda)(mint, borrower);
+    const liquidatorTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, liquidator, false, spl_token_1.TOKEN_2022_PROGRAM_ID);
+    // Get Raydium pool accounts for price calculation
+    const raydium = (0, program_1.getRaydiumMigrationAccounts)(mint);
+    const tx = new web3_js_1.Transaction();
+    // Create liquidator ATA if needed
+    tx.add((0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(liquidator, liquidatorTokenAccount, liquidator, mint, spl_token_1.TOKEN_2022_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID));
+    const provider = makeDummyProvider(connection, liquidator);
+    const program = new anchor_1.Program(torch_market_json_1.default, provider);
+    const liquidateIx = await program.methods
+        .liquidate()
+        .accounts({
+        liquidator,
+        borrower,
+        mint,
+        bondingCurve: bondingCurvePda,
+        treasury: treasuryPda,
+        collateralVault: collateralVaultPda,
+        liquidatorTokenAccount,
+        loanPosition: loanPositionPda,
+        poolState: raydium.poolState,
+        tokenVault0: raydium.token0Vault,
+        tokenVault1: raydium.token1Vault,
+        tokenProgram: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .instruction();
+    tx.add(liquidateIx);
+    await finalizeTransaction(connection, tx, liquidator);
+    return {
+        transaction: tx,
+        message: `Liquidate loan position for ${borrowerStr}`,
+    };
+};
+exports.buildLiquidateTransaction = buildLiquidateTransaction;
+//# sourceMappingURL=transactions.js.map