torchsdk 3.5.0 → 3.6.0

package/dist/transactions.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Transaction builders
+ *
+ * Build unsigned transactions for buy, sell, create, star, vault, and lending.
+ * Agents sign these locally and submit to the network.
+ */
+import { Connection } from '@solana/web3.js';
+import { BuyParams, DirectBuyParams, SellParams, CreateTokenParams, StarParams, BorrowParams, RepayParams, LiquidateParams, ClaimProtocolRewardsParams, VaultSwapParams, CreateVaultParams, DepositVaultParams, WithdrawVaultParams, WithdrawTokensParams, LinkWalletParams, UnlinkWalletParams, TransferAuthorityParams, TransactionResult, CreateTokenResult } from './types';
+/**
+ * Build an unsigned vault-funded buy transaction.
+ *
+ * The vault pays for the buy. This is the recommended path for AI agents.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Buy parameters with required vault creator pubkey
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildBuyTransaction: (connection: Connection, params: BuyParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned direct buy transaction (no vault).
+ *
+ * The buyer pays from their own wallet. Use this for human-operated wallets only.
+ * For AI agents, use buildBuyTransaction with a vault instead.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Buy parameters (no vault)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildDirectBuyTransaction: (connection: Connection, params: DirectBuyParams) => 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 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 create vault transaction.
+ *
+ * Creates a TorchVault PDA and auto-links the creator's wallet.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Creator public key
+ * @returns Unsigned transaction
+ */
+export declare const buildCreateVaultTransaction: (connection: Connection, params: CreateVaultParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned deposit vault transaction.
+ *
+ * Anyone can deposit SOL into any vault.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Depositor, vault creator, amount in lamports
+ * @returns Unsigned transaction
+ */
+export declare const buildDepositVaultTransaction: (connection: Connection, params: DepositVaultParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned withdraw vault transaction.
+ *
+ * Only the vault authority can withdraw.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Authority, vault creator, amount in lamports
+ * @returns Unsigned transaction
+ */
+export declare const buildWithdrawVaultTransaction: (connection: Connection, params: WithdrawVaultParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned link wallet transaction.
+ *
+ * Only the vault authority can link wallets.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Authority, vault creator, wallet to link
+ * @returns Unsigned transaction
+ */
+export declare const buildLinkWalletTransaction: (connection: Connection, params: LinkWalletParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned unlink wallet transaction.
+ *
+ * Only the vault authority can unlink wallets. Rent returns to authority.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Authority, vault creator, wallet to unlink
+ * @returns Unsigned transaction
+ */
+export declare const buildUnlinkWalletTransaction: (connection: Connection, params: UnlinkWalletParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned transfer authority transaction.
+ *
+ * Transfers vault admin control to a new wallet.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Current authority, vault creator, new authority
+ * @returns Unsigned transaction
+ */
+export declare const buildTransferAuthorityTransaction: (connection: Connection, params: TransferAuthorityParams) => 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>;
+/**
+ * Build an unsigned claim protocol rewards transaction.
+ *
+ * Claims the user's proportional share of protocol treasury rewards
+ * based on trading volume in the previous epoch. Requires >= 10 SOL volume.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Claim parameters (user, optional vault)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildClaimProtocolRewardsTransaction: (connection: Connection, params: ClaimProtocolRewardsParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned withdraw tokens transaction.
+ *
+ * Withdraw tokens from a vault ATA to any destination token account.
+ * Authority only. Composability escape hatch for external DeFi.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Authority, vault creator, mint, destination, amount in raw units
+ * @returns Unsigned transaction
+ */
+export declare const buildWithdrawTokensTransaction: (connection: Connection, params: WithdrawTokensParams) => Promise<TransactionResult>;
+/**
+ * Build an unsigned vault-routed DEX swap transaction.
+ *
+ * Executes a Raydium CPMM swap through the vault PDA for migrated Torch tokens.
+ * Full custody preserved — all value flows through the vault.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - Swap parameters (mint, signer, vault_creator, amount_in, minimum_amount_out, is_buy)
+ * @returns Unsigned transaction and descriptive message
+ */
+export declare const buildVaultSwapTransaction: (connection: Connection, params: VaultSwapParams) => 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":"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"}