@glamsystems/glam-sdk 1.1.0-alpha.5 → 1.1.0

package/src/deser/kaminoLayouts.d.ts

@@ -0,0 +1,264 @@
+import { BN } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { BigFractionBytes } from "../utils";
+import { Decodable } from "./base";
+import Decimal from "decimal.js";
+export interface KVaultAllocation {
+    reserve: PublicKey;
+    ctokenVault: PublicKey;
+    targetAllocationWeight: BN;
+    tokenAllocationCap: BN;
+    ctokenVaultBump: BN;
+    configPadding: BN[];
+    ctokenAllocation: BN;
+    lastInvestSlot: BN;
+    tokenTargetAllocationSf: BN;
+    statePadding: BN[];
+}
+export declare class KVaultState extends Decodable {
+    discriminator: number[];
+    vaultAdminAuthority: PublicKey;
+    baseVaultAuthority: PublicKey;
+    baseVaultAuthorityBump: BN;
+    tokenMint: PublicKey;
+    tokenMintDecimals: BN;
+    tokenVault: PublicKey;
+    tokenProgram: PublicKey;
+    sharesMint: PublicKey;
+    sharesMintDecimals: BN;
+    tokenAvailable: BN;
+    sharesIssued: BN;
+    availableCrankFunds: BN;
+    padding0: BN;
+    performanceFeeBps: BN;
+    managementFeeBps: BN;
+    lastFeeChargeTimestamp: BN;
+    prevAumSf: BN;
+    pendingFeesSf: BN;
+    vaultAllocationStrategy: KVaultAllocation[];
+    padding1: BN[];
+    minDepositAmount: BN;
+    minWithdrawAmount: BN;
+    minInvestAmount: BN;
+    minInvestDelaySlots: BN;
+    crankFundFeePerReserve: BN;
+    pendingAdmin: PublicKey;
+    cumulativeEarnedInterestSf: BN;
+    cumulativeMgmtFeesSf: BN;
+    cumulativePerfFeesSf: BN;
+    name: number[];
+    vaultLookupTable: PublicKey;
+    vaultFarm: PublicKey;
+    creationTimestamp: BN;
+    padding2: BN;
+    allocationAdmin: PublicKey;
+    padding3: BN[];
+    static _layout: any;
+    get nameStr(): string;
+    get validAllocations(): KVaultAllocation[];
+}
+interface LastUpdate {
+    slot: BN;
+    stale: number;
+    priceStatus: number;
+    placeholder: number[];
+}
+interface PriceHeuristic {
+    lower: BN;
+    upper: BN;
+    exp: BN;
+}
+interface ScopeConfiguration {
+    priceFeed: PublicKey;
+    priceChain: number[];
+    twapChain: number[];
+}
+interface SwitchboardConfiguration {
+    priceAggregator: PublicKey;
+    twapAggregator: PublicKey;
+}
+interface PythConfiguration {
+    price: PublicKey;
+}
+interface TokenInfo {
+    name: number[];
+    heuristic: PriceHeuristic;
+    maxTwapDivergenceBps: BN;
+    maxAgePriceSeconds: BN;
+    maxAgeTwapSeconds: BN;
+    scopeConfiguration: ScopeConfiguration;
+    switchboardConfiguration: SwitchboardConfiguration;
+    pythConfiguration: PythConfiguration;
+    blockPriceUsage: number;
+    reserved: number[];
+    padding: BN[];
+}
+interface ReserveFees {
+    borrowFeeSf: BN;
+    flashLoanFeeSf: BN;
+    padding: number[];
+}
+interface CurvePoint {
+    utilizationRateBps: number;
+    borrowRateBps: number;
+}
+interface BorrowRateCurve {
+    points: CurvePoint[];
+}
+interface WithdrawalCaps {
+    configCapacity: BN;
+    currentTotal: BN;
+    lastIntervalStartTimestamp: BN;
+    configIntervalLengthSeconds: BN;
+}
+interface ReserveLiquidity {
+    mintPubkey: PublicKey;
+    supplyVault: PublicKey;
+    feeVault: PublicKey;
+    availableAmount: BN;
+    borrowedAmountSf: BN;
+    marketPriceSf: BN;
+    marketPriceLastUpdatedTs: BN;
+    mintDecimals: BN;
+    depositLimitCrossedTimestamp: BN;
+    borrowLimitCrossedTimestamp: BN;
+    cumulativeBorrowRateBsf: BigFractionBytes;
+    accumulatedProtocolFeesSf: BN;
+    accumulatedReferrerFeesSf: BN;
+    pendingReferrerFeesSf: BN;
+    absoluteReferralRateSf: BN;
+    tokenProgram: PublicKey;
+    padding2: BN[];
+    padding3: BN[];
+}
+interface ReserveCollateral {
+    mintPubkey: PublicKey;
+    mintTotalSupply: BN;
+    supplyVault: PublicKey;
+    padding1: BN[];
+    padding2: BN[];
+}
+interface ReserveConfig {
+    status: number;
+    assetTier: number;
+    hostFixedInterestRateBps: number;
+    reserved2: number[];
+    protocolOrderExecutionFeePct: number;
+    protocolTakeRatePct: number;
+    protocolLiquidationFeePct: number;
+    loanToValuePct: number;
+    liquidationThresholdPct: number;
+    minLiquidationBonusBps: number;
+    maxLiquidationBonusBps: number;
+    badDebtLiquidationBonusBps: number;
+    deleveragingMarginCallPeriodSecs: BN;
+    deleveragingThresholdDecreaseBpsPerDay: BN;
+    fees: ReserveFees;
+    borrowRateCurve: BorrowRateCurve;
+    borrowFactorPct: BN;
+    depositLimit: BN;
+    borrowLimit: BN;
+    tokenInfo: TokenInfo;
+    depositWithdrawalCap: WithdrawalCaps;
+    debtWithdrawalCap: WithdrawalCaps;
+    elevationGroups: number[];
+    disableUsageAsCollOutsideEmode: number;
+    utilizationLimitBlockBorrowingAbovePct: number;
+    autodeleverageEnabled: number;
+    reserved1: number[];
+    borrowLimitOutsideElevationGroup: BN;
+    borrowLimitAgainstThisCollateralInElevationGroup: BN[];
+}
+export declare class Reserve extends Decodable {
+    discriminator: number[];
+    version: BN;
+    lastUpdate: LastUpdate;
+    lendingMarket: PublicKey;
+    farmCollateral: PublicKey;
+    farmDebt: PublicKey;
+    liquidity: ReserveLiquidity;
+    reserveLiquidityPadding: BN[];
+    collateral: ReserveCollateral;
+    reserveCollateralPadding: BN[];
+    config: ReserveConfig;
+    configPadding: BN[];
+    borrowedAmountOutsideElevationGroup: BN;
+    borrowedAmountsAgainstThisReserveInElevationGroups: BN[];
+    padding: BN[];
+    static _layout: any;
+    get cumulativeBorrowRate(): Decimal;
+    /**
+     * @returns the stale exchange rate between the collateral tokens and the liquidity - this is a decimal number scaled by 1e18
+     */
+    get collateralExchangeRate(): Decimal;
+    get totalSupply(): Decimal;
+    get borrowedAmount(): Decimal;
+    get accumulatedProtocolFees(): Decimal;
+    get accumulatedReferrerFees(): Decimal;
+    get pendingReferrerFees(): Decimal;
+    get scopePriceFeed(): PublicKey;
+    get liquidityFeeReceiver(): PublicKey;
+    get farmDebtNullable(): PublicKey | null;
+    get farmCollateralNullable(): PublicKey | null;
+}
+interface ObligationCollateral {
+    depositReserve: PublicKey;
+    depositedAmount: BN;
+    marketValueSf: BN;
+    borrowedAmountAgainstThisCollateralInElevationGroup: BN;
+    padding: BN[];
+}
+interface ObligationLiquidity {
+    borrowReserve: PublicKey;
+    cumulativeBorrowRateBsf: BigFractionBytes;
+    padding: BN;
+    borrowedAmountSf: BN;
+    marketValueSf: BN;
+    borrowFactorAdjustedMarketValueSf: BN;
+    borrowedAmountOutsideElevationGroups: BN;
+    padding2: BN[];
+}
+interface ObligationOrder {
+    conditionThresholdSf: BN;
+    opportunityParameterSf: BN;
+    minExecutionBonusBps: number;
+    maxExecutionBonusBps: number;
+    conditionType: number;
+    opportunityType: number;
+    padding1: number[];
+    padding2: BN[];
+}
+export declare class Obligation extends Decodable {
+    discriminator: number[];
+    tag: BN;
+    lastUpdate: LastUpdate;
+    lendingMarket: PublicKey;
+    owner: PublicKey;
+    deposits: ObligationCollateral[];
+    lowestReserveDepositLiquidationLtv: BN;
+    depositedValueSf: BN;
+    borrows: ObligationLiquidity[];
+    borrowFactorAdjustedDebtValueSf: BN;
+    borrowedAssetsMarketValueSf: BN;
+    allowedBorrowValueSf: BN;
+    unhealthyBorrowValueSf: BN;
+    depositsAssetTiers: number[];
+    borrowsAssetTiers: number[];
+    elevationGroup: number;
+    numOfObsoleteDepositReserves: number;
+    hasDebt: number;
+    referrer: PublicKey;
+    borrowingDisabled: number;
+    autodeleverageTargetLtvPct: number;
+    lowestReserveDepositMaxLtvPct: number;
+    numOfObsoleteBorrowReserves: number;
+    reserved: number[];
+    highestBorrowFactorPct: BN;
+    autodeleverageMarginCallStartedTimestamp: BN;
+    orders: ObligationOrder[];
+    padding3: BN[];
+    static _layout: any;
+    get activeDeposits(): ObligationCollateral[];
+    get activeBorrows(): ObligationLiquidity[];
+}
+export {};

package/src/deser/loopscaleLayouts.d.ts

@@ -0,0 +1,157 @@
+import { BN } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { Decodable } from "./base";
+export declare const STRATEGY_DURATION_COUNT = 5;
+interface ExternalYieldAccounts {
+    externalYieldAccount: PublicKey;
+    externalYieldVault: PublicKey;
+}
+interface CapMonitor {
+    startTime1hr: BN;
+    startTime24hr: BN;
+    principal1hr: BN;
+    principal24hr: BN;
+}
+export declare const LOOPSCALE_STRATEGY_ACCOUNT_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare const LOOPSCALE_VAULT_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare const LOOPSCALE_VAULT_STAKE_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare function hasLoopscaleStrategyDiscriminator(data: Buffer): boolean;
+export declare class LoopscaleStrategy extends Decodable {
+    discriminator: number[];
+    version: number;
+    nonce: PublicKey;
+    bump: number;
+    principalMint: PublicKey;
+    lender: PublicKey;
+    originationsEnabled: number;
+    externalYieldSource: number;
+    interestPerSecond: number[];
+    lastAccruedTimestamp: BN;
+    liquidityBuffer: BN;
+    tokenBalance: BN;
+    interestFee: BN;
+    principalFee: BN;
+    originationFee: BN;
+    originationCap: BN;
+    externalYieldAmount: BN;
+    currentDeployedAmount: BN;
+    outstandingInterestAmount: BN;
+    feeClaimable: BN;
+    cumulativePrincipalOriginated: BN;
+    cumulativeInterestAccrued: BN;
+    cumulativeLoanCount: BN;
+    activeLoanCount: BN;
+    marketInformation: PublicKey;
+    collateralMap: BN[][];
+    externalYieldAccounts: ExternalYieldAccounts;
+    supplyMonitor: CapMonitor;
+    withdrawMonitor: CapMonitor;
+    borrowMonitor: CapMonitor;
+    static _layout: any;
+    /**
+     * Returns the duration index whose collateral term for the given asset
+     * matches `expectedApy`, or null if no populated slot matches.
+     */
+    durationIndexForApy(collateralAssetIndex: number, expectedApy: BN): number | null;
+    /** Duration indexes that have a populated collateral term for the asset. */
+    populatedDurationIndexes(collateralAssetIndex: number): number[];
+}
+export declare class LoopscaleVault extends Decodable {
+    discriminator: number[];
+    manager: PublicKey;
+    nonce: PublicKey;
+    bump: number;
+    lpSupply: BN;
+    lpMint: PublicKey;
+    principalMint: PublicKey;
+    cumulativePrincipalDeposited: BN;
+    depositsEnabled: number;
+    maxEarlyUnstakeFee: BN;
+    static _layout: any;
+}
+export declare function hasLoopscaleVaultDiscriminator(data: Buffer): boolean;
+export declare function hasLoopscaleVaultStakeDiscriminator(data: Buffer): boolean;
+export declare const LOOPSCALE_LOAN_LEDGER_COUNT = 5;
+export declare const LOOPSCALE_LOAN_COLLATERAL_COUNT = 5;
+export declare const LOOPSCALE_LOAN_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export declare function hasLoopscaleLoanDiscriminator(data: Buffer): boolean;
+export interface LoopscaleLoanDuration {
+    duration: number;
+    durationType: number;
+}
+export interface LoopscaleLedger {
+    status: number;
+    strategy: PublicKey;
+    principalMint: PublicKey;
+    marketInformation: PublicKey;
+    principalDue: BN;
+    principalRepaid: BN;
+    interestOutstanding: BN;
+    lastInterestUpdatedTime: BN;
+    duration: LoopscaleLoanDuration;
+    interestPerSecond: number[];
+    startTime: BN;
+    endTime: BN;
+    apy: BN;
+}
+export interface LoopscaleCollateral {
+    assetMint: PublicKey;
+    amount: BN;
+    assetType: number;
+    assetIdentifier: PublicKey;
+}
+export declare class LoopscaleLoan extends Decodable {
+    discriminator: number[];
+    version: number;
+    bump: number;
+    status: number;
+    borrower: PublicKey;
+    nonce: BN;
+    startTime: BN;
+    ledgers: LoopscaleLedger[];
+    collateral: LoopscaleCollateral[];
+    weightMatrix: number[][];
+    ltvMatrix: number[][];
+    lqtMatrix: number[][];
+    static _layout: any;
+    /** Ledgers that are not in the empty/unused (status 0) state. */
+    get activeLedgers(): LoopscaleLedger[];
+    /** Collateral entries that hold a non-zero amount or a set identifier. */
+    get activeCollateral(): LoopscaleCollateral[];
+}
+interface CollateralCaps {
+    maxAllocationPct: BN;
+    currentAllocationAmount: BN;
+}
+export interface LoopscaleAssetData {
+    assetIdentifier: PublicKey;
+    quoteMint: PublicKey;
+    oracleAccount: PublicKey;
+    oracleType: number;
+    maxUncertainty: BN;
+    maxAge: BN;
+    decimals: number;
+    ltv: BN;
+    liquidationThreshold: BN;
+    collateralCaps: CollateralCaps;
+}
+interface PrincipalCaps {
+    max1hr: BN;
+    max24hr: BN;
+    maxOutstanding: BN;
+}
+export declare class LoopscaleMarketInformation extends Decodable {
+    discriminator: number[];
+    authority: PublicKey;
+    delegate: PublicKey;
+    principalMint: PublicKey;
+    assetData: LoopscaleAssetData[];
+    borrowCaps: PrincipalCaps;
+    withdrawCaps: PrincipalCaps;
+    supplyCaps: PrincipalCaps;
+    version: number;
+    static _layout: any;
+    /** Index of `assetIdentifier` in the asset data table, or null if absent. */
+    findAssetIndex(assetIdentifier: PublicKey): number | null;
+}
+export {};

package/src/deser/tokenAclLayouts.d.ts

@@ -0,0 +1,67 @@
+import { BN } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { Decodable } from "./base";
+/**
+ * Token ACL Gate ListConfig account layout.
+ *
+ * Onchain repr(C):
+ *   discriminator: u8
+ *   authority: Pubkey
+ *   seed: Pubkey
+ *   mode: u8
+ *   wallets_count: u64 (LE)
+ *
+ * PDA seeds: ["list_config", authority, seed]
+ * Program: Token ACL Gate
+ */
+export declare class TokenAclListConfig extends Decodable {
+    discriminator: number;
+    authority: PublicKey;
+    seed: PublicKey;
+    mode: number;
+    walletsCount: BN;
+    static _layout: any;
+    get modeName(): string;
+}
+/**
+ * Token ACL Gate WalletEntry account layout.
+ *
+ * Onchain repr(C):
+ *   discriminator: u8
+ *   wallet_address: Pubkey
+ *   list_config: Pubkey
+ *
+ * PDA seeds: ["wallet_entry", list_config, wallet]
+ * Program: Token ACL Gate
+ */
+export declare class TokenAclWalletEntry extends Decodable {
+    discriminator: number;
+    wallet: PublicKey;
+    listConfig: PublicKey;
+    static _layout: any;
+}
+/**
+ * Token ACL MintConfig account layout.
+ *
+ * Onchain repr(C):
+ *   discriminator: u8
+ *   bump: u8
+ *   enable_permissionless_thaw: PodBool (u8)
+ *   enable_permissionless_freeze: PodBool (u8)
+ *   mint: Pubkey
+ *   freeze_authority: Pubkey
+ *   gating_program: Pubkey
+ *
+ * PDA seeds: ["MINT_CONFIG", mint]
+ * Program: Token ACL
+ */
+export declare class TokenAclMintConfig extends Decodable {
+    discriminator: number;
+    bump: number;
+    enablePermissionlessThaw: number;
+    enablePermissionlessFreeze: number;
+    mint: PublicKey;
+    freezeAuthority: PublicKey;
+    gatingProgram: PublicKey;
+    static _layout: any;
+}

package/src/error.d.ts

@@ -0,0 +1,29 @@
+import { TransactionError } from "@solana/web3.js";
+export declare class GlamError extends Error {
+    message: string;
+    rawError: TransactionError | null | undefined;
+    programLogs?: string[];
+    constructor(message: string, rawError: TransactionError | null | undefined, programLogs?: string[]);
+}
+/**
+ * Extract the program ID that failed from transaction logs.
+ * Looks for "Program <ID> failed:" log lines and returns the first match,
+ * which corresponds to the innermost CPI that produced the root cause.
+ */
+export declare function extractFailedProgramId(logs?: string[] | null): string | undefined;
+/**
+ * Resolve a custom program error code to a human-readable message.
+ * When programId is provided, matches against the specific program's IDL
+ * to avoid collisions between programs using the same error code range.
+ * Accepts either a decimal number or a hex string (e.g. "0xBB80").
+ */
+export declare function resolveErrorCode(code: number | string, programId?: string, staging?: boolean): string | undefined;
+/**
+ * Parse the error message from a transaction error.
+ * Environment-agnostic: handles Anchor errors, program error codes,
+ * simulation failures, and common RPC/network errors.
+ *
+ * Callers (GUI, CLI) can handle environment-specific error types
+ * (e.g. WalletSignTransactionError) before delegating to this function.
+ */
+export declare function parseTxError(error: any): string;