@loyal-labs/private-transactions 0.2.6 → 0.2.8

package/dist/src/LoyalPrivateTransactionsClient.d.ts

@@ -1,7 +1,7 @@
 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, CreatePermissionParams, CreateUsernamePermissionParams, DelegateDepositParams, DelegateUsernameDepositParams, UndelegateDepositParams, UndelegateUsernameDepositParams, TransferDepositParams, TransferToUsernameDepositParams, InitializeUsernameDepositParams, ClaimUsernameDepositToDepositParams, DelegationStatusResponse } from "./types";
+import type { WalletLike, ClientConfig, DepositData, UsernameDepositData, InitializeDepositParams, ModifyBalanceParams, ModifyBalanceResult, GetKaminoShieldedBalanceQuoteParams, GetKaminoCollateralSharesForLiquidityAmountParams, KaminoReserveSnapshot, KaminoShieldedBalanceQuote, CreatePermissionParams, CreateUsernamePermissionParams, DelegateDepositParams, DelegateUsernameDepositParams, UndelegateDepositParams, UndelegateUsernameDepositParams, TransferDepositParams, TransferToUsernameDepositParams, InitializeUsernameDepositParams, ClaimUsernameDepositToDepositParams, DelegationStatusResponse } from "./types";
 export declare function waitForAccountOwnerChange(connection: Connection, account: PublicKey, expectedOwner: PublicKey, timeoutMs?: number, intervalMs?: number): {
     wait: () => Promise<void>;
     cancel: () => Promise<void>;
@@ -93,23 +93,38 @@ export declare class LoyalPrivateTransactionsClient {
      */
     getBaseDeposit(user: PublicKey, tokenMint: PublicKey): Promise<DepositData | null>;
     getEphemeralDeposit(user: PublicKey, tokenMint: PublicKey): Promise<DepositData | null>;
+    /**
+     * Enumerate every Deposit account owned by a user across both the base
+     * program and the ephemeral program. Used by the wallet UI to discover
+     * shielded holdings even when the user no longer has a matching base-chain
+     * token balance.
+     *
+     * Delegated deposits only exist on the ephemeral chain (on base the PDA is
+     * owned by the delegation program and Anchor cannot deserialize it as a
+     * `Deposit`). Undelegated deposits only exist on base. We query both and
+     * merge by PDA address, preferring the ephemeral amount when both return
+     * an entry because ephemeral reflects the live balance.
+     */
+    getAllDepositsByUser(user: PublicKey): Promise<DepositData[]>;
     /**
      * 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 live base lending APY for the configured Kamino reserve in basis points.
+     * This is reserve supply APY only and does not include farm reward APY.
+     * Returns null when the token mint has no hardcoded Kamino reserve config.
+     * Devnet reserves intentionally return 0 because the UI APY source is mainnet-only.
+     */
+    getKaminoLendingApyBps(tokenMint: PublicKey): Promise<number | null>;
+    getKaminoReserveSnapshot(tokenMint: PublicKey): Promise<KaminoReserveSnapshot | null>;
+    getKaminoShieldedBalanceQuote(params: GetKaminoShieldedBalanceQuoteParams): Promise<KaminoShieldedBalanceQuote | null>;
+    getKaminoCollateralSharesForLiquidityAmount(params: GetKaminoCollateralSharesForLiquidityAmountParams): Promise<bigint | null>;
+    calculateKaminoCollateralExchangeRateSfFromAmounts(args: {
+        collateralAmountRaw: number | bigint;
+        liquidityAmountRaw: number | bigint;
+    }): bigint | null;
     /**
      * Get the connected wallet's public key
      */

package/dist/src/constants.d.ts

@@ -10,10 +10,25 @@ export declare const ER_VALIDATOR_MAINNET: PublicKey;
 export declare const ER_VALIDATOR: PublicKey;
 export declare function getErValidatorForSolanaEnv(env: string): PublicKey;
 export declare function getErValidatorForRpcEndpoint(rpcEndpoint: string): PublicKey;
+export declare function getKaminoModifyBalanceAccountsForTokenMint(tokenMint: PublicKey): KaminoModifyBalanceAccounts | null;
 /**
  * Telegram Private Transfer program ID
  */
 export declare const PROGRAM_ID: PublicKey;
+export declare const USDC_MINT_DEVNET: PublicKey;
+export declare const USDC_MINT_MAINNET: PublicKey;
+export declare const KLEND_PROGRAM_ID: PublicKey;
+export interface KaminoModifyBalanceAccounts {
+    lendingMarket: PublicKey;
+    lendingMarketAuthority: PublicKey;
+    reserve: PublicKey;
+    reserveLiquiditySupply: PublicKey;
+    reserveCollateralMint: PublicKey;
+    liquidityDecimals: number;
+    instructionSysvarAccount: PublicKey;
+    klendProgram: PublicKey;
+}
+export declare function isKaminoMainnetModifyBalanceAccounts(accounts: KaminoModifyBalanceAccounts): boolean;
 /**
  * MagicBlock Delegation Program ID
  */
@@ -38,7 +53,7 @@ export declare const DEPOSIT_SEED_BYTES: Buffer<ArrayBuffer>;
 /**
  * PDA seed for username deposit accounts
  */
-export declare const USERNAME_DEPOSIT_SEED = "username_deposit";
+export declare const USERNAME_DEPOSIT_SEED = "username_deposit_v2";
 export declare const USERNAME_DEPOSIT_SEED_BYTES: Buffer<ArrayBuffer>;
 /**
  * PDA seed for vault account

package/dist/src/idl/telegram_private_transfer.d.ts

@@ -38,41 +38,6 @@ export type TelegramPrivateTransfer = {
                 {
                     "name": "sourceUsernameDeposit";
                     "writable": true;
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "const";
-                                "value": [
-                                    117,
-                                    115,
-                                    101,
-                                    114,
-                                    110,
-                                    97,
-                                    109,
-                                    101,
-                                    95,
-                                    100,
-                                    101,
-                                    112,
-                                    111,
-                                    115,
-                                    105,
-                                    116
-                                ];
-                            },
-                            {
-                                "kind": "account";
-                                "path": "source_username_deposit.username";
-                                "account": "usernameDeposit";
-                            },
-                            {
-                                "kind": "account";
-                                "path": "source_username_deposit.token_mint";
-                                "account": "usernameDeposit";
-                            }
-                        ];
-                    };
                 },
                 {
                     "name": "destinationDeposit";
@@ -228,41 +193,6 @@ export type TelegramPrivateTransfer = {
                 },
                 {
                     "name": "deposit";
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "const";
-                                "value": [
-                                    117,
-                                    115,
-                                    101,
-                                    114,
-                                    110,
-                                    97,
-                                    109,
-                                    101,
-                                    95,
-                                    100,
-                                    101,
-                                    112,
-                                    111,
-                                    115,
-                                    105,
-                                    116
-                                ];
-                            },
-                            {
-                                "kind": "account";
-                                "path": "deposit.username";
-                                "account": "usernameDeposit";
-                            },
-                            {
-                                "kind": "account";
-                                "path": "deposit.token_mint";
-                                "account": "usernameDeposit";
-                            }
-                        ];
-                    };
                 },
                 {
                     "name": "session";
@@ -673,12 +603,15 @@ export type TelegramPrivateTransfer = {
                                     111,
                                     115,
                                     105,
-                                    116
+                                    116,
+                                    95,
+                                    118,
+                                    50
                                 ];
                             },
                             {
                                 "kind": "arg";
-                                "path": "username";
+                                "path": "usernameHash";
                             },
                             {
                                 "kind": "arg";
@@ -702,8 +635,13 @@ export type TelegramPrivateTransfer = {
             ];
             "args": [
                 {
-                    "name": "username";
-                    "type": "string";
+                    "name": "usernameHash";
+                    "type": {
+                        "array": [
+                            "u8",
+                            32
+                        ];
+                    };
                 },
                 {
                     "name": "tokenMint";
@@ -824,12 +762,15 @@ export type TelegramPrivateTransfer = {
                                     111,
                                     115,
                                     105,
-                                    116
+                                    116,
+                                    95,
+                                    118,
+                                    50
                                 ];
                             },
                             {
                                 "kind": "arg";
-                                "path": "username";
+                                "path": "usernameHash";
                             },
                             {
                                 "kind": "account";
@@ -852,8 +793,13 @@ export type TelegramPrivateTransfer = {
             ];
             "args": [
                 {
-                    "name": "username";
-                    "type": "string";
+                    "name": "usernameHash";
+                    "type": {
+                        "array": [
+                            "u8",
+                            32
+                        ];
+                    };
                 }
             ];
         },
@@ -1378,41 +1324,6 @@ export type TelegramPrivateTransfer = {
                 {
                     "name": "destinationDeposit";
                     "writable": true;
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "const";
-                                "value": [
-                                    117,
-                                    115,
-                                    101,
-                                    114,
-                                    110,
-                                    97,
-                                    109,
-                                    101,
-                                    95,
-                                    100,
-                                    101,
-                                    112,
-                                    111,
-                                    115,
-                                    105,
-                                    116
-                                ];
-                            },
-                            {
-                                "kind": "account";
-                                "path": "destination_deposit.username";
-                                "account": "usernameDeposit";
-                            },
-                            {
-                                "kind": "account";
-                                "path": "destination_deposit.token_mint";
-                                "account": "usernameDeposit";
-                            }
-                        ];
-                    };
                 },
                 {
                     "name": "tokenMint";
@@ -1554,12 +1465,15 @@ export type TelegramPrivateTransfer = {
                                     111,
                                     115,
                                     105,
-                                    116
+                                    116,
+                                    95,
+                                    118,
+                                    50
                                 ];
                             },
                             {
                                 "kind": "arg";
-                                "path": "username";
+                                "path": "usernameHash";
                             },
                             {
                                 "kind": "arg";
@@ -1580,8 +1494,13 @@ export type TelegramPrivateTransfer = {
             ];
             "args": [
                 {
-                    "name": "username";
-                    "type": "string";
+                    "name": "usernameHash";
+                    "type": {
+                        "array": [
+                            "u8",
+                            32
+                        ];
+                    };
                 },
                 {
                     "name": "tokenMint";
@@ -1717,6 +1636,16 @@ export type TelegramPrivateTransfer = {
             "code": 6011;
             "name": "invalidDepositor";
             "msg": "Invalid Depositor";
+        },
+        {
+            "code": 6012;
+            "name": "invalidKaminoAccounts";
+            "msg": "Invalid Kamino accounts";
+        },
+        {
+            "code": 6013;
+            "name": "invalidAmount";
+            "msg": "Invalid amount";
         }
     ];
     "types": [
@@ -1738,6 +1667,10 @@ export type TelegramPrivateTransfer = {
                     },
                     {
                         "name": "amount";
+                        "docs": [
+                            "For USDC deposits, this stores the Kamino share token amount.",
+                            "For all other mints, this stores the deposited liquidity token amount."
+                        ];
                         "type": "u64";
                     }
                 ];
@@ -1793,8 +1726,13 @@ export type TelegramPrivateTransfer = {
                         "type": "pubkey";
                     },
                     {
-                        "name": "username";
-                        "type": "string";
+                        "name": "usernameHash";
+                        "type": {
+                            "array": [
+                                "u8",
+                                32
+                            ];
+                        };
                     },
                     {
                         "name": "validationBytes";
@@ -1820,16 +1758,19 @@ export type TelegramPrivateTransfer = {
         {
             "name": "usernameDeposit";
             "docs": [
-                "A deposit account for a telegram username and token mint.",
-                "",
-                "Telegram username is always lowercase (a-z, 0-9 and underscores)"
+                "A deposit account for a telegram username sha256 hash and token mint."
             ];
             "type": {
                 "kind": "struct";
                 "fields": [
                     {
-                        "name": "username";
-                        "type": "string";
+                        "name": "usernameHash";
+                        "type": {
+                            "array": [
+                                "u8",
+                                32
+                            ];
+                        };
                     },
                     {
                         "name": "tokenMint";
@@ -1837,6 +1778,10 @@ export type TelegramPrivateTransfer = {
                     },
                     {
                         "name": "amount";
+                        "docs": [
+                            "For USDC deposits, this stores the Kamino share token amount.",
+                            "For all other mints, this stores the deposited liquidity token amount."
+                        ];
                         "type": "u64";
                     }
                 ];

package/dist/src/kamino.d.ts

@@ -0,0 +1,44 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+import { type KaminoModifyBalanceAccounts } from "./constants";
+import type { KaminoPositionYieldInfo, KaminoReserveSnapshot } from "./types";
+export declare function parseKaminoReserveSnapshotFromAccountData(args: {
+    data: Buffer;
+    reserve: PublicKey;
+    tokenMint: PublicKey;
+}): KaminoReserveSnapshot;
+export declare function calculateKaminoRedeemableLiquidityAmountRaw(snapshot: KaminoReserveSnapshot, shareAmountRaw: bigint | number): bigint;
+export declare function calculateKaminoShareAmountForLiquidityAmountRaw(args: {
+    snapshot: KaminoReserveSnapshot;
+    liquidityAmountRaw: bigint | number;
+    rounding?: "floor" | "ceil";
+}): bigint;
+export declare function calculateKaminoTrackedLiquidityCostBasisRaw(args: {
+    currentShareAmountRaw: bigint | number;
+    trackedShareAmountRaw?: bigint | number | null;
+    trackedLiquidityAmountRaw?: bigint | number | null;
+}): bigint | null;
+export declare function calculateKaminoCollateralExchangeRateSfFromAmounts(args: {
+    collateralAmount: bigint | number;
+    liquidityAmount: bigint | number;
+}): bigint | null;
+export declare function calculateKaminoCollateralValuation(args: {
+    snapshot: KaminoReserveSnapshot;
+    collateralAmount: bigint | number;
+    principalLiquidityAmount?: bigint | number | null;
+    shieldCollateralExchangeRateSf?: bigint | number | null;
+}): {
+    currentLiquidityAmount: bigint;
+    principalLiquidityAmount: bigint | null;
+    earnedLiquidityAmount: bigint | null;
+};
+export declare function calculateKaminoPositionYieldInfoFromSnapshot(args: {
+    snapshot: KaminoReserveSnapshot;
+    shareAmountRaw: bigint | number;
+    trackedShareAmountRaw?: bigint | number | null;
+    trackedLiquidityAmountRaw?: bigint | number | null;
+}): KaminoPositionYieldInfo;
+export declare function fetchKaminoReserveSnapshot(args: {
+    connection: Connection;
+    tokenMint: PublicKey;
+    kaminoAccounts?: KaminoModifyBalanceAccounts;
+}): Promise<KaminoReserveSnapshot | null>;

package/dist/src/pda.d.ts

@@ -16,7 +16,7 @@ export declare function findDepositPda(user: PublicKey, tokenMint: PublicKey, pr
  * @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];
+export declare function findUsernameDepositPda(username: string, tokenMint: PublicKey, programId?: PublicKey): Promise<[PublicKey, number]>;
 /**
  * Derive the vault PDA
  *

package/dist/src/types.d.ts

@@ -48,11 +48,34 @@ export interface DepositData {
     amount: bigint;
     address: PublicKey;
 }
+export interface KaminoReserveSnapshot {
+    reserve: PublicKey;
+    tokenMint: PublicKey;
+    liquidityDecimals: number;
+    collateralSupplyRaw: bigint;
+    totalLiquiditySupplyScaled: bigint;
+    collateralExchangeRateSf: bigint;
+}
+export interface KaminoTrackedBalanceCostBasis {
+    trackedShareAmountRaw: bigint;
+    trackedLiquidityAmountRaw: bigint;
+}
+export interface KaminoPositionYieldInfo {
+    reserve: PublicKey;
+    tokenMint: PublicKey;
+    liquidityDecimals: number;
+    shareAmountRaw: bigint;
+    currentLiquidityAmountRaw: bigint;
+    trackedShareAmountRaw: bigint | null;
+    trackedLiquidityAmountRaw: bigint | null;
+    currentTrackedLiquidityCostBasisRaw: bigint | null;
+    earnedLiquidityAmountRaw: bigint | null;
+}
 /**
  * Data structure for a username-based deposit account
  */
 export interface UsernameDepositData {
-    username: string;
+    usernameHash: number[];
     tokenMint: PublicKey;
     amount: bigint;
     address: PublicKey;
@@ -91,6 +114,24 @@ export interface ModifyBalanceResult {
     signature: string;
     deposit: DepositData;
 }
+export interface GetKaminoShieldedBalanceQuoteParams {
+    tokenMint: PublicKey;
+    collateralSharesAmountRaw: number | bigint;
+    principalLiquidityAmountRaw?: number | bigint | null;
+    shieldCollateralExchangeRateSf?: number | bigint | null;
+}
+export interface GetKaminoCollateralSharesForLiquidityAmountParams {
+    tokenMint: PublicKey;
+    liquidityAmountRaw: number | bigint;
+}
+export interface KaminoShieldedBalanceQuote {
+    snapshot: KaminoReserveSnapshot;
+    collateralSharesAmountRaw: bigint;
+    redeemableLiquidityAmountRaw: bigint;
+    principalLiquidityAmountRaw: bigint | null;
+    earnedLiquidityAmountRaw: bigint | null;
+    shieldCollateralExchangeRateSf: bigint | null;
+}
 export interface ClaimUsernameDepositToDepositParams {
     username: string;
     tokenMint: PublicKey;

package/dist/src/utils.d.ts

@@ -0,0 +1 @@
+export declare function sha256hash(data: string): Promise<number[]>;

package/dist/src/webcrypto.d.ts

@@ -0,0 +1,2 @@
+import type { Keypair } from "@solana/web3.js";
+export declare function createKeypairMessageSigner(keypair: Keypair): (message: Uint8Array) => Promise<Uint8Array>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loyal-labs/private-transactions",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "SDK for Telegram-based private Solana deposits",
   "type": "module",
   "main": "./dist/index.js",
@@ -51,9 +51,6 @@
     "@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",