upshift-finance 1.0.0

package/lib/adapters/solana/utils.d.ts

@@ -0,0 +1,141 @@
+import { AnchorProvider, BN, Program, type web3 } from '@coral-xyz/anchor';
+import { PublicKey, type Transaction } from '@solana/web3.js';
+import type { ISolanaConnectionOptions, ISolanaVaultState } from './types';
+declare function getExplorerLink({ signature, type, network, }: {
+    signature: string;
+    type: 'tx' | 'address' | 'token';
+} & ISolanaConnectionOptions): string;
+import { isSolanaAddress } from '../../core/helpers/chain-address';
+export { isSolanaAddress };
+declare function isSolana(signature: string): boolean;
+declare function getProgram({ provider, idl, programId, network, }: {
+    idl?: any;
+    programId?: string;
+} & ISolanaConnectionOptions): Program<any>;
+declare function getBestRpcEndpoint({ endpoint, network, connection, }: ISolanaConnectionOptions): Promise<"http://127.0.0.1:8899" | `https://${string}`>;
+declare function getProvider({ connection, publicKey, signTransaction, }: {
+    publicKey: PublicKey;
+    signTransaction: (<T extends Transaction | web3.VersionedTransaction>(transaction: T) => Promise<T>) | undefined;
+} & ISolanaConnectionOptions): AnchorProvider;
+declare function getReadOnlyProvider({ connection }: ISolanaConnectionOptions): AnchorProvider;
+declare function deriveVaultStatePda(vaultProgramId: PublicKey | string): web3.PublicKey;
+declare function deriveShareMintPda(vaultProgramId: PublicKey | string): web3.PublicKey;
+declare function deriveVaultTokenAtaPda(vaultProgramId: PublicKey | string, depositMint: PublicKey, vaultVersion?: number): web3.PublicKey;
+declare function getVaultState({ provider, connection, vaultProgramId, vaultAddress, idl, }: {
+    vaultProgramId: PublicKey | string;
+    vaultAddress?: PublicKey | string;
+    idl: any;
+} & ISolanaConnectionOptions): Promise<{
+    vaultState: unknown | null;
+    depositMintDecimals: number | null;
+}>;
+declare function getVaultStateReadOnly({ vaultProgramId, vaultAddress, connection, idl, }: {
+    vaultProgramId: PublicKey | string;
+    vaultAddress?: PublicKey | string;
+    idl: any;
+} & ISolanaConnectionOptions): Promise<{
+    vaultState: ISolanaVaultState | null;
+    depositMintDecimals: number | null;
+}>;
+declare function getVaultMints({ vaultProgramId, vaultAddress, connection, idl, }: {
+    vaultProgramId: PublicKey | string;
+    vaultAddress?: PublicKey | string;
+    idl: any;
+} & ISolanaConnectionOptions): Promise<{
+    depositMint: string;
+    shareMint: string;
+    vaultVersion: number | undefined;
+}>;
+declare function getToken({ mintAddress, endpoint, connection, }: {
+    mintAddress: string | PublicKey;
+} & ISolanaConnectionOptions): Promise<{
+    address: string;
+    symbol: string;
+    decimals: number;
+    name: string;
+    image: string;
+} | null>;
+declare function getTokenSymbol({ endpoint, mintAddress, }: {
+    mintAddress: string | PublicKey;
+} & ISolanaConnectionOptions): Promise<string | null>;
+declare function fetchUserTokenBalance({ connection, publicKey, depositMint, }: {
+    publicKey: PublicKey | string;
+    depositMint?: PublicKey | string;
+} & ISolanaConnectionOptions): Promise<any>;
+declare function fetchUserShareBalance({ connection, publicKey, shareMint, }: {
+    publicKey: PublicKey | string;
+    shareMint?: PublicKey | string;
+} & ISolanaConnectionOptions): Promise<any>;
+/**
+ * Same on-chain lookup as `fetchUserShareBalance`, but returns the raw u64
+ * `amount` string and the mint's `decimals` — or `null` when the scale can't
+ * be determined (see Return shape) — instead of the floating-point `uiAmount`.
+ * Callers that feed the result into BigInt math (positions, redemptions,
+ * allowances) must use this — `uiAmount` is lossy and silently encodes with
+ * the wrong scale when passed back through `toNormalizedBn` without an
+ * explicit decimals argument.
+ *
+ * Return shape:
+ *   `{ amount: '<u64>', decimals: number }` — token account exists.
+ *   `{ amount: '0',     decimals: null   }` — no token account, missing
+ *      tokenAmount in the parsed response, missing args, or the RPC threw.
+ *
+ * `decimals === null` is the "scale unknown" signal — callers that need a
+ * normalized `INormalizedNumber` must substitute a known decimals value
+ * (typically the deposit mint's decimals from backend metadata) before
+ * normalizing. Never throws.
+ *
+ * RPC cost: 1 × `getParsedTokenAccountsByOwner`. Independent of how many
+ * other accounts the wallet owns (filter is mint-scoped).
+ */
+declare function fetchUserShareBalanceRaw({ connection, publicKey, shareMint, }: {
+    publicKey: PublicKey | string;
+    shareMint?: PublicKey | string;
+} & ISolanaConnectionOptions): Promise<{
+    amount: string;
+    decimals: number | null;
+}>;
+/**
+ * Resolve the on-chain program ID for a Solana vault.
+ * Prefers the explicit `program_id` from metadata; falls back to the vault address
+ * (for legacy vaults where address == program ID).
+ */
+declare function resolveProgramId(vaultAddress: string, solanaMetadata?: {
+    program_id?: string;
+} | null): string;
+/** @internal */
+export declare function uiAmountToRawBn(uiAmount: number, decimals: number): BN;
+export declare const SolanaUtils: {
+    getExplorerLink: typeof getExplorerLink;
+    isSolanaAddress: typeof isSolanaAddress;
+    isSolana: typeof isSolana;
+    getProgram: typeof getProgram;
+    getProvider: typeof getProvider;
+    getReadOnlyProvider: typeof getReadOnlyProvider;
+    deriveShareMintPda: typeof deriveShareMintPda;
+    deriveVaultStatePda: typeof deriveVaultStatePda;
+    deriveVaultTokenAtaPda: typeof deriveVaultTokenAtaPda;
+    getVaultState: typeof getVaultState;
+    getVaultStateReadOnly: typeof getVaultStateReadOnly;
+    getToken: typeof getToken;
+    getTokenSymbol: typeof getTokenSymbol;
+    fetchUserTokenBalance: typeof fetchUserTokenBalance;
+    fetchUserShareBalance: typeof fetchUserShareBalance;
+    fetchUserShareBalanceRaw: typeof fetchUserShareBalanceRaw;
+    getBestRpcEndpoint: typeof getBestRpcEndpoint;
+    fallbackDecimals: number;
+    fallbackNetwork: import("../..").ISolanaNetwork;
+    programIds: {
+        devnet: {
+            vault: string;
+        };
+        "mainnet-beta": {
+            vault: string;
+        };
+        localnet: {
+            vault: string;
+        };
+    };
+    getVaultMints: typeof getVaultMints;
+    resolveProgramId: typeof resolveProgramId;
+};