@loyal-labs/private-transactions 0.2.0

package/dist/src/LoyalPrivateTransactionsClient.d.ts

@@ -0,0 +1,139 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+import { Program } from "@coral-xyz/anchor";
+import type { TelegramPrivateTransfer } from "./idl/telegram_private_transfer.ts";
+import type { WalletLike, ClientConfig, DepositData, UsernameDepositData, InitializeDepositParams, ModifyBalanceParams, ModifyBalanceResult, DepositForUsernameParams, ClaimUsernameDepositParams, CreatePermissionParams, CreateUsernamePermissionParams, DelegateDepositParams, DelegateUsernameDepositParams, UndelegateDepositParams, UndelegateUsernameDepositParams, TransferDepositParams, TransferToUsernameDepositParams, InitializeUsernameDepositParams, ClaimUsernameDepositToDepositParams } from "./types";
+export declare function waitForAccountOwnerChange(connection: Connection, account: PublicKey, expectedOwner: PublicKey, timeoutMs?: number, intervalMs?: number): {
+    wait: () => Promise<void>;
+    cancel: () => Promise<void>;
+};
+/**
+ * LoyalPrivateTransactionsClient - SDK for interacting with the Telegram Private Transfer program
+ * with MagicBlock PER (Private Ephemeral Rollups) support
+ *
+ * @example
+ * // Base layer client with keypair
+ * const client = LoyalPrivateTransactionsClient.from(connection, keypair);
+ *
+ * // Ephemeral rollup client
+ * const ephemeralClient = await LoyalPrivateTransactionsClient.fromEphemeral({
+ *   signer: keypair,
+ *   rpcEndpoint: "http://localhost:7799",
+ *   wsEndpoint: "ws://localhost:7800",
+ * });
+ *
+ * // Deposit tokens and delegate to PER
+ * await client.initializeDeposit({ user, tokenMint, payer });
+ * await client.modifyBalance({ user, tokenMint, amount: 1000000, increase: true, ... });
+ * await client.createPermission({ user, tokenMint, payer });
+ * await client.delegateDeposit({ user, tokenMint, payer, validator });
+ *
+ * // Execute private transfers on ephemeral rollup
+ * await ephemeralClient.transferToUsernameDeposit({ username, tokenMint, amount, ... });
+ *
+ * // Commit and undelegate
+ * await ephemeralClient.undelegateDeposit({ user, tokenMint, ... });
+ */
+export declare class LoyalPrivateTransactionsClient {
+    readonly baseProgram: Program<TelegramPrivateTransfer>;
+    readonly ephemeralProgram: Program<TelegramPrivateTransfer>;
+    readonly wallet: WalletLike;
+    private constructor();
+    /**
+     * Create client connected to an ephemeral rollup endpoint with PER auth token.
+     * Verifies TEE RPC integrity and obtains an auth token automatically.
+     */
+    static fromConfig(config: ClientConfig): Promise<LoyalPrivateTransactionsClient>;
+    /**
+     * Initialize a deposit account for a user and token mint
+     */
+    initializeDeposit(params: InitializeDepositParams): Promise<string>;
+    initializeUsernameDeposit(params: InitializeUsernameDepositParams): Promise<string>;
+    /**
+     * Modify the balance of a user's deposit account
+     */
+    modifyBalance(params: ModifyBalanceParams): Promise<ModifyBalanceResult>;
+    /**
+     * Deposit tokens for a Telegram username
+     */
+    depositForUsername(params: DepositForUsernameParams): Promise<string>;
+    /**
+     * Claim tokens from a username-based deposit
+     */
+    claimUsernameDeposit(params: ClaimUsernameDepositParams): Promise<string>;
+    claimUsernameDepositToDeposit(params: ClaimUsernameDepositToDepositParams): Promise<string>;
+    /**
+     * Create a permission for a deposit account (required for PER)
+     */
+    createPermission(params: CreatePermissionParams): Promise<string | null>;
+    /**
+     * Create a permission for a username-based deposit account
+     */
+    createUsernamePermission(params: CreateUsernamePermissionParams): Promise<string | null>;
+    /**
+     * Delegate a deposit account to the ephemeral rollup
+     */
+    delegateDeposit(params: DelegateDepositParams): Promise<string>;
+    /**
+     * Delegate a username-based deposit account to the ephemeral rollup
+     */
+    delegateUsernameDeposit(params: DelegateUsernameDepositParams): Promise<string>;
+    /**
+     * Undelegate a deposit account from the ephemeral rollup.
+     * Waits for both base and ephemeral connections to confirm the deposit
+     * is owned by PROGRAM_ID before returning.
+     */
+    undelegateDeposit(params: UndelegateDepositParams): Promise<string>;
+    /**
+     * Undelegate a username-based deposit account from the ephemeral rollup
+     */
+    undelegateUsernameDeposit(params: UndelegateUsernameDepositParams): Promise<string>;
+    /**
+     * Transfer between two user deposits
+     */
+    transferDeposit(params: TransferDepositParams): Promise<string>;
+    /**
+     * Transfer from a user deposit to a username deposit
+     */
+    transferToUsernameDeposit(params: TransferToUsernameDepositParams): Promise<string>;
+    /**
+     * Get deposit data for a user and token mint
+     */
+    getBaseDeposit(user: PublicKey, tokenMint: PublicKey): Promise<DepositData | null>;
+    getEphemeralDeposit(user: PublicKey, tokenMint: PublicKey): Promise<DepositData | null>;
+    /**
+     * Get username deposit data
+     */
+    getBaseUsernameDeposit(username: string, tokenMint: PublicKey): Promise<UsernameDepositData | null>;
+    getEphemeralUsernameDeposit(username: string, tokenMint: PublicKey): Promise<UsernameDepositData | null>;
+    /**
+     * Find the deposit PDA for a user and token mint
+     */
+    findDepositPda(user: PublicKey, tokenMint: PublicKey): [PublicKey, number];
+    /**
+     * Find the username deposit PDA
+     */
+    findUsernameDepositPda(username: string, tokenMint: PublicKey): [PublicKey, number];
+    /**
+     * Find the vault PDA
+     */
+    findVaultPda(tokenMint: PublicKey): [PublicKey, number];
+    /**
+     * Get the connected wallet's public key
+     */
+    get publicKey(): PublicKey;
+    /**
+     * Get the underlying Anchor program instance
+     */
+    getBaseProgram(): Program<TelegramPrivateTransfer>;
+    getEphemeralProgram(): Program<TelegramPrivateTransfer>;
+    /**
+     * Get the program ID
+     */
+    getProgramId(): PublicKey;
+    private validateUsername;
+    private permissionAccountExists;
+    private isAccountAlreadyInUse;
+    private ensureNotDelegated;
+    private ensureDelegated;
+    private getDelegationStatus;
+}

package/dist/src/constants.d.ts

@@ -0,0 +1,58 @@
+/// <reference types="node" />
+import { LAMPORTS_PER_SOL } from "@solana/web3.js";
+/**
+ * TEE ER Validator
+ */
+export declare const ER_VALIDATOR: any;
+/**
+ * Telegram Private Transfer program ID
+ */
+export declare const PROGRAM_ID: any;
+/**
+ * MagicBlock Delegation Program ID
+ */
+export declare const DELEGATION_PROGRAM_ID: any;
+/**
+ * MagicBlock Permission Program ID (ACL)
+ */
+export declare const PERMISSION_PROGRAM_ID: any;
+/**
+ * MagicBlock Magic Program ID (for undelegation)
+ */
+export declare const MAGIC_PROGRAM_ID: any;
+/**
+ * MagicBlock Magic Context Account (for undelegation)
+ */
+export declare const MAGIC_CONTEXT_ID: any;
+/**
+ * PDA seed for deposit accounts
+ */
+export declare const DEPOSIT_SEED = "deposit";
+export declare const DEPOSIT_SEED_BYTES: Buffer;
+/**
+ * PDA seed for username deposit accounts
+ */
+export declare const USERNAME_DEPOSIT_SEED = "username_deposit";
+export declare const USERNAME_DEPOSIT_SEED_BYTES: Buffer;
+/**
+ * PDA seed for vault account
+ */
+export declare const VAULT_SEED = "vault";
+export declare const VAULT_SEED_BYTES: Buffer;
+/**
+ * PDA seed for permission accounts
+ */
+export declare const PERMISSION_SEED = "permission:";
+export declare const PERMISSION_SEED_BYTES: Buffer;
+/**
+ * Re-export LAMPORTS_PER_SOL for convenience
+ */
+export { LAMPORTS_PER_SOL };
+/**
+ * Convert SOL to lamports
+ */
+export declare function solToLamports(sol: number): number;
+/**
+ * Convert lamports to SOL
+ */
+export declare function lamportsToSol(lamports: number): number;