@loyal-labs/private-transactions 0.2.0

package/dist/src/pda.d.ts

@@ -0,0 +1,59 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Derive the deposit PDA for a user and token mint
+ *
+ * @param user - The user's public key
+ * @param tokenMint - The SPL token mint
+ * @param programId - Optional program ID (defaults to PROGRAM_ID)
+ * @returns [PDA address, bump seed]
+ */
+export declare function findDepositPda(user: PublicKey, tokenMint: PublicKey, programId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the username deposit PDA for a username and token mint
+ *
+ * @param username - The Telegram username
+ * @param tokenMint - The SPL token mint
+ * @param programId - Optional program ID (defaults to PROGRAM_ID)
+ * @returns [PDA address, bump seed]
+ */
+export declare function findUsernameDepositPda(username: string, tokenMint: PublicKey, programId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the vault PDA
+ *
+ * @param tokenMint - The SPL token mint
+ * @param programId - Optional program ID (defaults to PROGRAM_ID)
+ * @returns [PDA address, bump seed]
+ */
+export declare function findVaultPda(tokenMint: PublicKey, programId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the permission PDA for an account
+ *
+ * @param account - The account to derive permission for
+ * @param permissionProgramId - Optional permission program ID (defaults to PERMISSION_PROGRAM_ID)
+ * @returns [PDA address, bump seed]
+ */
+export declare function findPermissionPda(account: PublicKey, permissionProgramId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the delegation record PDA for an account
+ *
+ * @param account - The delegated account
+ * @param delegationProgramId - Optional delegation program ID (defaults to DELEGATION_PROGRAM_ID)
+ * @returns [PDA address, bump seed]
+ */
+export declare function findDelegationRecordPda(account: PublicKey, delegationProgramId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the delegation metadata PDA for an account
+ *
+ * @param account - The delegated account
+ * @param delegationProgramId - Optional delegation program ID (defaults to DELEGATION_PROGRAM_ID)
+ * @returns [PDA address, bump seed]
+ */
+export declare function findDelegationMetadataPda(account: PublicKey, delegationProgramId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the buffer PDA for an account (used in delegation)
+ *
+ * @param account - The account to derive buffer for
+ * @param delegationProgramId - Optional delegation program ID (defaults to DELEGATION_PROGRAM_ID)
+ * @returns [PDA address, bump seed]
+ */
+export declare function findBufferPda(account: PublicKey, ownerProgramId?: PublicKey): [PublicKey, number];

package/dist/src/types.d.ts

@@ -0,0 +1,254 @@
+import type { PublicKey, Transaction, VersionedTransaction, Keypair, Commitment } from "@solana/web3.js";
+import type { AnchorProvider } from "@coral-xyz/anchor";
+/**
+ * Minimal wallet interface matching @solana/wallet-adapter-base
+ * Compatible with browser wallet adapters (Phantom, Solflare, etc.)
+ */
+export interface WalletLike {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
+}
+/**
+ * Union type supporting multiple wallet types:
+ * - WalletLike: Browser wallet adapters (Phantom, Solflare, etc.)
+ * - Keypair: Server-side scripts and testing
+ * - AnchorProvider: Existing Anchor projects
+ */
+export type WalletSigner = WalletLike | Keypair | AnchorProvider;
+/**
+ * RPC options for transactions
+ */
+export interface RpcOptions {
+    skipPreflight?: boolean;
+    preflightCommitment?: Commitment;
+    maxRetries?: number;
+}
+/**
+ * Configuration for creating an ephemeral client
+ */
+export interface ClientConfig {
+    signer: WalletSigner;
+    baseRpcEndpoint: string;
+    baseWsEndpoint?: string;
+    ephemeralRpcEndpoint: string;
+    ephemeralWsEndpoint?: string;
+    commitment?: Commitment;
+    authToken?: {
+        token: string;
+        expiresAt: number;
+    };
+}
+/**
+ * Data structure for a user deposit account
+ */
+export interface DepositData {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    amount: bigint;
+    address: PublicKey;
+}
+/**
+ * Data structure for a username-based deposit account
+ */
+export interface UsernameDepositData {
+    username: string;
+    tokenMint: PublicKey;
+    amount: bigint;
+    address: PublicKey;
+}
+/**
+ * Parameters for initializing a deposit account
+ */
+export interface InitializeDepositParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    payer: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+export interface InitializeUsernameDepositParams {
+    username: string;
+    tokenMint: PublicKey;
+    payer: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for modifying a deposit balance
+ */
+export interface ModifyBalanceParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    increase: boolean;
+    payer: PublicKey;
+    userTokenAccount: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Result of a balance modification
+ */
+export interface ModifyBalanceResult {
+    signature: string;
+    deposit: DepositData;
+}
+/**
+ * Parameters for depositing tokens for a username
+ */
+export interface DepositForUsernameParams {
+    username: string;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    depositor: PublicKey;
+    payer: PublicKey;
+    depositorTokenAccount: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for claiming tokens from a username deposit
+ */
+export interface ClaimUsernameDepositParams {
+    username: string;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    recipient: PublicKey;
+    recipientTokenAccount: PublicKey;
+    session: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+export interface ClaimUsernameDepositToDepositParams {
+    username: string;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    recipient: PublicKey;
+    session: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for creating a permission for a deposit
+ */
+export interface CreatePermissionParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    payer: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for creating a permission for a username deposit
+ */
+export interface CreateUsernamePermissionParams {
+    username: string;
+    tokenMint: PublicKey;
+    session: PublicKey;
+    authority: PublicKey;
+    payer: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for delegating a deposit to an ephemeral rollup
+ */
+export interface DelegateDepositParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    payer: PublicKey;
+    validator: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for delegating a username deposit to an ephemeral rollup
+ */
+export interface DelegateUsernameDepositParams {
+    username: string;
+    tokenMint: PublicKey;
+    payer: PublicKey;
+    validator: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for undelegating a deposit from an ephemeral rollup
+ */
+export interface UndelegateDepositParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    payer: PublicKey;
+    sessionToken?: PublicKey | null;
+    magicProgram: PublicKey;
+    magicContext: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for undelegating a username deposit from an ephemeral rollup
+ */
+export interface UndelegateUsernameDepositParams {
+    username: string;
+    tokenMint: PublicKey;
+    session: PublicKey;
+    payer: PublicKey;
+    magicProgram: PublicKey;
+    magicContext: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for transferring between user deposits
+ */
+export interface TransferDepositParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    destinationUser: PublicKey;
+    amount: number | bigint;
+    payer: PublicKey;
+    sessionToken?: PublicKey | null;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Parameters for transferring from a user deposit to a username deposit
+ */
+export interface TransferToUsernameDepositParams {
+    username: string;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    user: PublicKey;
+    payer: PublicKey;
+    sessionToken?: PublicKey | null;
+    rpcOptions?: RpcOptions;
+}
+/**
+ * Delegation record from MagicBlock router
+ */
+export interface DelegationRecord {
+    authority: string;
+    owner: string;
+    delegationSlot: number;
+    lamports: number;
+}
+/**
+ * Response from MagicBlock getDelegationStatus RPC call
+ */
+export interface DelegationStatusResult {
+    isDelegated: boolean;
+    fqdn?: string;
+    delegationRecord: DelegationRecord;
+}
+/**
+ * Full JSON-RPC response for getDelegationStatus
+ */
+export interface DelegationStatusResponse {
+    jsonrpc: "2.0";
+    id: number | string;
+    result?: DelegationStatusResult;
+    error?: {
+        code: number;
+        message: string;
+    } | null;
+}
+/**
+ * Check if signer is a raw Keypair
+ */
+export declare function isKeypair(signer: WalletSigner): signer is Keypair;
+/**
+ * Check if signer is an AnchorProvider
+ */
+export declare function isAnchorProvider(signer: WalletSigner): signer is AnchorProvider;
+/**
+ * Check if signer is a WalletLike (wallet adapter)
+ */
+export declare function isWalletLike(signer: WalletSigner): signer is WalletLike;

package/dist/src/wallet-adapter.d.ts

@@ -0,0 +1,31 @@
+import { PublicKey, Transaction, VersionedTransaction } from "@solana/web3.js";
+import { type WalletSigner, type WalletLike } from "./types";
+/**
+ * Internal wallet adapter that normalizes different wallet types
+ * to a common interface compatible with AnchorProvider
+ */
+export declare class InternalWalletAdapter implements WalletLike {
+    private readonly signer;
+    readonly publicKey: PublicKey;
+    private constructor();
+    /**
+     * Create an adapter from any supported wallet type
+     */
+    static from(signer: WalletSigner): InternalWalletAdapter;
+    /**
+     * Extract public key from any supported wallet type
+     */
+    static getPublicKey(signer: WalletSigner): PublicKey;
+    /**
+     * Sign a single transaction
+     */
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    /**
+     * Sign multiple transactions
+     */
+    signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
+    /**
+     * Sign a transaction with a Keypair
+     */
+    private signWithKeypair;
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@loyal-labs/private-transactions",
+  "version": "0.2.0",
+  "description": "SDK for Telegram-based private Solana deposits",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "bun run build:js && bun run build:types",
+    "build:js": "bun build ./index.ts --outdir ./dist --target browser --format esm --external @coral-xyz/anchor --external @solana/web3.js --external @solana/spl-token --external @magicblock-labs/ephemeral-rollups-sdk --external bn.js",
+    "build:types": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build",
+    "clean": "rm -rf dist",
+    "test": "bun test --timeout 60000"
+  },
+  "keywords": [
+    "solana",
+    "telegram",
+    "anchor",
+    "web3",
+    "crypto",
+    "blockchain",
+    "deposit",
+    "transfer"
+  ],
+  "author": "Loyal",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loyal/loyal-app.git",
+    "directory": "sdk/private-transactions"
+  },
+  "bugs": {
+    "url": "https://github.com/loyal/loyal-app/issues"
+  },
+  "homepage": "https://github.com/loyal/loyal-app/tree/main/sdk/private-transactions#readme",
+  "peerDependencies": {
+    "@coral-xyz/anchor": "^0.32.0",
+    "@magicblock-labs/ephemeral-rollups-sdk": "^0.8.5",
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.95.0"
+  },
+  "dependencies": {
+    "tweetnacl": "^1.0.3"
+  },
+  "devDependencies": {
+    "@coral-xyz/anchor": "^0.32.1",
+    "@solana/web3.js": "^1.95.0",
+    "@types/bun": "latest",
+    "typescript": "^5"
+  }
+}