@loyal-labs/private-transactions 0.2.8 → 0.2.9

package/dist/src/types.d.ts

@@ -1,4 +1,4 @@
-import type { PublicKey, Transaction, VersionedTransaction, Keypair, Commitment } from "@solana/web3.js";
+import type { PublicKey, Transaction, VersionedTransaction, Keypair, Commitment, TransactionInstruction } from "@solana/web3.js";
 import type { AnchorProvider } from "@coral-xyz/anchor";
 /**
  * Minimal wallet interface matching @solana/wallet-adapter-base
@@ -16,6 +16,162 @@ export interface WalletLike {
  * - AnchorProvider: Existing Anchor projects
  */
 export type WalletSigner = WalletLike | Keypair | AnchorProvider;
+export type InstructionCheck = {
+    address: PublicKey;
+    delegated: boolean;
+    passNotExist: boolean;
+    label: string;
+};
+export type CheckedTransactionInstruction = {
+    ix: TransactionInstruction;
+    ensure: InstructionCheck[];
+};
+export type ShieldFlowKind = "shield" | "unshield";
+export type FeeEstimateCluster = "base" | "ephemeral";
+export interface BuildShieldFlowTransactionPlanParams {
+    kind: ShieldFlowKind;
+    user: PublicKey;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    payer?: PublicKey;
+    validator?: PublicKey;
+    sessionToken?: PublicKey | null;
+    magicProgram?: PublicKey;
+    magicContext?: PublicKey;
+}
+export type BuildShieldTokensTransactionPlanParams = Omit<BuildShieldFlowTransactionPlanParams, "kind">;
+export type BuildUnshieldTokensTransactionPlanParams = Omit<BuildShieldFlowTransactionPlanParams, "kind">;
+export interface EstimateShieldFlowFeeParams {
+    plan: ShieldFlowPlan;
+    commitment?: Commitment;
+}
+export interface EstimateShieldTokensFeeParams extends EstimateShieldFlowFeeParams {
+}
+export interface EstimateUnshieldTokensFeeParams extends EstimateShieldFlowFeeParams {
+}
+export interface ExecuteShieldFlowTransactionPlanParams {
+    plan: ShieldFlowPlan;
+    rpcOptions?: RpcOptions;
+}
+export interface ExecuteShieldTokensTransactionPlanParams extends ExecuteShieldFlowTransactionPlanParams {
+}
+export interface ExecuteUnshieldTokensTransactionPlanParams extends ExecuteShieldFlowTransactionPlanParams {
+}
+export interface ShieldTokensClientParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    payer?: PublicKey;
+    validator?: PublicKey;
+    sessionToken?: PublicKey | null;
+    magicProgram?: PublicKey;
+    magicContext?: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+export interface UnshieldTokensClientParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    amount: number | bigint;
+    payer?: PublicKey;
+    validator?: PublicKey;
+    sessionToken?: PublicKey | null;
+    magicProgram?: PublicKey;
+    magicContext?: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+export interface InstructionCostEstimate {
+    transactionIndex: number;
+    instructionIndex: number;
+    label: string;
+    programId: PublicKey;
+    /**
+     * Net rent impact for this instruction.
+     * Positive values are newly locked rent; negative values are reclaimed rent.
+     */
+    rentLamports: number;
+    /**
+     * Net native-SOL value movement caused by token semantics, excluding fees and rent.
+     * Positive values debit the payer/user, negative values credit them.
+     */
+    nativeLamports: number;
+}
+export interface ShieldFlowInstructionPlan {
+    label: string;
+    ix: TransactionInstruction;
+    /**
+     * Net rent impact for this instruction.
+     * Positive values are newly locked rent; negative values are reclaimed rent.
+     */
+    rentLamports?: number;
+    /**
+     * Net native-SOL value movement caused by token semantics, excluding fees and rent.
+     * Positive values debit the payer/user, negative values credit them.
+     */
+    nativeLamports?: number;
+}
+export interface ShieldFlowOwnerChangeWait {
+    address: PublicKey;
+    owner: PublicKey;
+    bestEffort?: boolean;
+}
+export interface ShieldFlowTransactionPlan {
+    label: string;
+    cluster: FeeEstimateCluster;
+    instructions: ShieldFlowInstructionPlan[];
+    checks?: InstructionCheck[];
+    postSendOwnerChange?: ShieldFlowOwnerChangeWait;
+}
+export interface ShieldFlowPlan {
+    kind: ShieldFlowKind;
+    user: PublicKey;
+    payer: PublicKey;
+    tokenMint: PublicKey;
+    amount: bigint;
+    transactions: ShieldFlowTransactionPlan[];
+}
+export interface ShieldFlowTransactionFeeEstimate {
+    index: number;
+    label: string;
+    cluster: FeeEstimateCluster;
+    feePayer: PublicKey;
+    blockhash: string;
+    lastValidBlockHeight: number;
+    instructionCount: number;
+    feeLamports: number;
+    rentLamports: number;
+    nativeLamports: number;
+    totalLamports: number;
+    instructions: InstructionCostEstimate[];
+}
+export interface ShieldFlowFeeEstimate {
+    kind: ShieldFlowKind;
+    user: PublicKey;
+    payer: PublicKey;
+    tokenMint: PublicKey;
+    amount: bigint;
+    totalFeeLamports: number;
+    totalRentLamports: number;
+    totalNativeLamports: number;
+    feeAndRentLamports: number;
+    totalLamports: number;
+    transactions: ShieldFlowTransactionFeeEstimate[];
+    instructions: InstructionCostEstimate[];
+    note: string;
+}
+export interface ShieldFlowTransactionExecutionResult {
+    index: number;
+    label: string;
+    cluster: FeeEstimateCluster;
+    signature: string;
+}
+export interface ShieldFlowExecutionResult {
+    kind: ShieldFlowKind;
+    user: PublicKey;
+    payer: PublicKey;
+    tokenMint: PublicKey;
+    amount: bigint;
+    signatures: ShieldFlowTransactionExecutionResult[];
+}
 /**
  * RPC options for transactions
  */
@@ -95,6 +251,23 @@ export interface InitializeUsernameDepositParams {
     payer: PublicKey;
     rpcOptions?: RpcOptions;
 }
+export interface CloseDepositParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+export interface CloseUsernameDepositParams {
+    username: string;
+    tokenMint: PublicKey;
+    authority: PublicKey;
+    session: PublicKey;
+    rpcOptions?: RpcOptions;
+}
+export interface ClosePermissionParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    rpcOptions?: RpcOptions;
+}
 /**
  * Parameters for modifying a deposit balance
  */
@@ -104,8 +277,8 @@ export interface ModifyBalanceParams {
     amount: number | bigint;
     increase: boolean;
     payer: PublicKey;
-    userTokenAccount: PublicKey;
     rpcOptions?: RpcOptions;
+    passNotExist?: boolean;
 }
 /**
  * Result of a balance modification
@@ -148,6 +321,7 @@ export interface CreatePermissionParams {
     tokenMint: PublicKey;
     payer: PublicKey;
     rpcOptions?: RpcOptions;
+    passNotExist?: boolean;
 }
 /**
  * Parameters for creating a permission for a username deposit
@@ -169,6 +343,7 @@ export interface DelegateDepositParams {
     payer: PublicKey;
     validator: PublicKey;
     rpcOptions?: RpcOptions;
+    passNotExist?: boolean;
 }
 /**
  * Parameters for delegating a username deposit to an ephemeral rollup
@@ -204,6 +379,11 @@ export interface UndelegateUsernameDepositParams {
     magicContext: PublicKey;
     rpcOptions?: RpcOptions;
 }
+export interface UndelegatePermissionParams {
+    user: PublicKey;
+    tokenMint: PublicKey;
+    rpcOptions?: RpcOptions;
+}
 /**
  * Parameters for transferring between user deposits
  */

package/dist/src/utils.d.ts

@@ -1 +1,8 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+export declare function prettyStringify(obj: unknown): string;
+export declare function waitForAccountOwnerChange(connection: Connection, account: PublicKey, expectedOwner: PublicKey, timeoutMs?: number, intervalMs?: number): {
+    wait: () => Promise<void>;
+    cancel: () => Promise<void>;
+};
 export declare function sha256hash(data: string): Promise<number[]>;
+export declare function validateUsername(username: string): void;

package/dist/src/wsol.d.ts

@@ -0,0 +1,14 @@
+import { type PublicKey, type TransactionInstruction } from "@solana/web3.js";
+export declare function wrapSolToWsolIx({ user, payer, lamports, }: {
+    user: PublicKey;
+    payer: PublicKey;
+    lamports: bigint;
+}): TransactionInstruction[];
+export declare function createWsolAta({ user, payer, }: {
+    user: PublicKey;
+    payer: PublicKey;
+}): TransactionInstruction;
+export declare function closeWsolAta({ user, destination, }: {
+    user: PublicKey;
+    destination: PublicKey;
+}): TransactionInstruction;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loyal-labs/private-transactions",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "SDK for Telegram-based private Solana deposits",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/loyal/loyal-app.git",
+    "url": "https://github.com/loyal-labs/loyal-app.git",
     "directory": "sdk/private-transactions"
   },
   "bugs": {
@@ -47,7 +47,7 @@
   "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",
+    "@magicblock-labs/ephemeral-rollups-sdk": "^0.11.1",
     "@solana/spl-token": "^0.4.14",
     "@solana/web3.js": "^1.95.0"
   },
@@ -56,5 +56,8 @@
     "@solana/web3.js": "^1.95.0",
     "@types/bun": "latest",
     "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }