@debridge-finance/solana-utils 2.3.0 → 3.0.0

package/dist/types/spl.d.ts

@@ -0,0 +1,114 @@
+/// <reference types="node" />
+import { AccountInfo, Connection, PublicKey, Transaction, TransactionInstruction } from "@solana/web3.js";
+import BN from "bn.js";
+import { Buffer } from "buffer";
+import { SolanaPubkey } from "./interfaces";
+type AmountType = string | number | BN | number[];
+declare enum AccountState {
+    Uninitialized = 0,
+    Initialized = 1,
+    Frozen = 2
+}
+type RawAccount = {
+    mint: PublicKey;
+    owner: PublicKey;
+    amount: bigint;
+    delegateOption: 1 | 0;
+    delegate: PublicKey;
+    state: AccountState;
+    isNativeOption: 1 | 0;
+    isNative: bigint;
+    delegatedAmount: bigint;
+    closeAuthorityOption: 1 | 0;
+    closeAuthority: PublicKey;
+};
+export declare enum AccountType {
+    System = 0,
+    Token = 1,
+    CorrectATA = 2,
+    Unknown = 3,
+    NotExists = 4
+}
+export interface WalletInfo {
+    /** Address of the account */
+    address: PublicKey;
+    /** Mint associated with the account */
+    mint: PublicKey;
+    /** Owner of the account */
+    owner: PublicKey;
+    /** Number of tokens the account holds */
+    amount: BN;
+    decimals: number;
+    /** True if the account is initialized */
+    isInitialized: boolean;
+    /** True if the account is a native token account */
+    isNative: boolean;
+}
+/**
+ * Builds instruction for creation of associated wallet for specified token
+ * @param tokenMint mint account of SPL-token
+ * @param associatedAccount associated account address
+ * @param owner owner of the associated account
+ * @param payer who pays for account creation
+ */
+export declare function createAssociatedWalletInstruction(tokenMint: SolanaPubkey, associatedAccount: PublicKey, owner: SolanaPubkey, payer: SolanaPubkey, associatedTokenProramId?: PublicKey): TransactionInstruction;
+export declare function parseSplAccount(data: Buffer): RawAccount | null;
+export declare function isWalletCorrectATA(walletAddress: SolanaPubkey, data: Buffer): boolean;
+/**
+ * Requests account from blockchain and returns result with account type
+ * @param account address of account
+ * @returns account info and account type
+ */
+export declare function getAccountWithType(connection: Connection, account: SolanaPubkey): Promise<[AccountInfo<Buffer> | null, AccountType]>;
+/**
+ * Returns balance of specified wallet in native tokens
+ * @param wallet wallet to inspect
+ */
+export declare function getNativeWalletBalance(connection: Connection, wallet: SolanaPubkey): Promise<BN>;
+/**
+ * Returns balance of associated wallet in SPL-tokens
+ * @param originalWallet native tokens wallet address
+ * @param tokenMint mint of SPL-Token
+ */
+export declare function getAssocSPLWalletBalance(connection: Connection, originalWallet: SolanaPubkey, tokenMint: SolanaPubkey): Promise<BN>;
+/**
+ * Returns balance of specified wallet in SPL-tokens
+ * @param wallet spl-tokens wallet address
+ */
+export declare function getSPLWalletBalance(connection: Connection, wallet: SolanaPubkey): Promise<BN>;
+/**
+ * Gets list of user's SPL-token accounts
+ * @param owner owner of the SPL wallets
+ * @returns list of accounts with amount on them
+ */
+export declare function getAllTokenAccountsWithBalances(connection: Connection, owner: SolanaPubkey): Promise<WalletInfo[]>;
+/**
+ * Gets list of user's tokenMint token accounts
+ * @param tokenMint
+ * @param owner owner of the wallets
+ * @returns list of accounts with amount on them
+ */
+export declare function getTokenAccountsWithBalance(connection: Connection, tokenMint: SolanaPubkey, owner: SolanaPubkey): Promise<WalletInfo[]>;
+/**
+ * Builds transaction to transfer&wrap native sol from src wallet to dst wallet
+ * @param amount number of lamports to transfer and wrap
+ * @param transferFrom source native account
+ * @param transferTo destination wallet
+ * @returns transaction to transfer&wrap sol
+ */
+export declare function buildReplenishWsolBalanceTransaction(amount: AmountType, transferFrom: SolanaPubkey, transferTo: SolanaPubkey): Transaction;
+/**
+ * Builds transaction that wraps specified amount of lamports into spl, if account is missing will create it
+ * @param amount lamports to wrap, ATA will contain exact amount of lamports
+ * @param owner owner of created wallet
+ */
+export declare function updateWsolBalance(connection: Connection, amount: AmountType, owner: SolanaPubkey): Promise<Transaction | null>;
+/**
+ * Checks existance of associated wallet for specified token
+ * @param mintAccount mint account of SPL-token
+ * @param originalWallet account of solana wallet
+ * @returns true if account exists
+ */
+export declare function checkIfAssociatedWalletExists(connection: Connection, mintAccount: PublicKey, originalWallet: PublicKey): Promise<boolean>;
+export {};
+//# sourceMappingURL=spl.d.ts.map

package/dist/types/spl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spl.d.ts","sourceRoot":"","sources":["../../src/spl.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@debridge-finance/solana-utils",
   "description": "Common utils package to power communication with Solana contracts at deBridge",
-  "version": "2.3.0",
+  "version": "3.0.0",
   "author": "deBridge",
   "license": "GPL-3.0-only",
   "homepage": "https://debridge.finance",
@@ -32,6 +32,7 @@
   "scripts": {
     "test:crypto": "mocha -r ts-node/register -b -t 200000 ./tests/crypto.test.ts",
     "test:accounts": "mocha -r ts-node/register -b -t 200000 ./tests/accounts.test.ts",
+    "test:spl": "mocha -r ts-node/register -b -t 200000 ./tests/spl.test.ts",
     "lint:fix": "prettier src/** tests/** -w",
     "lint": "prettier src/** tests/** --check",
     "build:esm": "tsc -p tsconfig.esm.json",
@@ -40,7 +41,9 @@
     "build": "rimraf dist && npm run build:esm && npm run build:node && npm run build:browser"
   },
   "dependencies": {
-    "@solana/web3.js": "1.73.0",
+    "@solana/web3.js": "1.73.2",
+    "@solana/buffer-layout": "4.0.0",
+    "@solana/buffer-layout-utils": "0.2.0",
     "bn.js": "5.2.1",
     "buffer": "6.0.3",
     "ethers": "5.7.1"