@atomiqlabs/chain-solana 12.0.13 → 12.0.15

package/src/solana/chain/modules/SolanaTokens.ts

@@ -1,308 +1,308 @@
-import {SolanaModule} from "../SolanaModule";
-import {PublicKey, SystemProgram} from "@solana/web3.js";
-import {
-    Account, createAssociatedTokenAccountInstruction,
-    createCloseAccountInstruction, createSyncNativeInstruction, createTransferInstruction,
-    getAccount, getAssociatedTokenAddressSync,
-    TokenAccountNotFoundError
-} from "@solana/spl-token";
-import {SolanaTx} from "./SolanaTransactions";
-import {SolanaAction} from "../SolanaAction";
-import {tryWithRetries} from "../../../utils/Utils";
-
-export class SolanaTokens extends SolanaModule {
-
-    public static readonly CUCosts = {
-        WRAP_SOL: 10000,
-        ATA_CLOSE: 10000,
-        ATA_INIT: 40000,
-        TRANSFER: 50000,
-        TRANSFER_SOL: 5000
-    };
-
-    /**
-     * Creates an ATA for a specific public key & token, the ATA creation is paid for by the underlying provider's
-     *  public key
-     *
-     * @param signer
-     * @param publicKey public key address of the user for which to initiate the ATA
-     * @param token token identification for which the ATA should be initialized
-     * @param requiredAta optional required ata address to use, if the address doesn't match it returns null
-     * @constructor
-     */
-    public InitAta(signer: PublicKey, publicKey: PublicKey, token: PublicKey, requiredAta?: PublicKey): SolanaAction | null {
-        const ata = getAssociatedTokenAddressSync(token, publicKey, true);
-        if(requiredAta!=null && !ata.equals(requiredAta)) return null;
-        return new SolanaAction(
-            signer,
-            this.root,
-            createAssociatedTokenAccountInstruction(
-                signer,
-                ata,
-                publicKey,
-                token
-            ),
-            SolanaTokens.CUCosts.ATA_INIT
-        )
-    }
-
-    /**
-     * Action for wrapping SOL to WSOL for a specific public key
-     *
-     * @param publicKey public key of the user for which to wrap the SOL
-     * @param amount amount of SOL in lamports (smallest unit) to wrap
-     * @param initAta whether we should also initialize the ATA before depositing SOL
-     * @constructor
-     */
-    public Wrap(publicKey: PublicKey, amount: bigint, initAta: boolean): SolanaAction {
-        const ata = getAssociatedTokenAddressSync(SolanaTokens.WSOL_ADDRESS, publicKey, true);
-        const action = new SolanaAction(publicKey, this.root);
-        if(initAta) action.addIx(
-            createAssociatedTokenAccountInstruction(publicKey, ata, publicKey, SolanaTokens.WSOL_ADDRESS),
-            SolanaTokens.CUCosts.ATA_INIT
-        );
-        action.addIx(
-            SystemProgram.transfer({
-                fromPubkey: publicKey,
-                toPubkey: ata,
-                lamports: amount
-            }),
-            SolanaTokens.CUCosts.WRAP_SOL
-        );
-        action.addIx(createSyncNativeInstruction(ata));
-        return action;
-    }
-
-    /**
-     * Action for unwrapping WSOL to SOL for a specific public key
-     *
-     * @param publicKey public key of the user for which to unwrap the sol
-     * @constructor
-     */
-    public Unwrap(publicKey: PublicKey): SolanaAction {
-        const ata = getAssociatedTokenAddressSync(SolanaTokens.WSOL_ADDRESS, publicKey, true);
-        return new SolanaAction(
-            publicKey,
-            this.root,
-            createCloseAccountInstruction(ata, publicKey, publicKey),
-            SolanaTokens.CUCosts.ATA_CLOSE
-        );
-    }
-
-    public static readonly WSOL_ADDRESS = new PublicKey("So11111111111111111111111111111111111111112");
-    public static readonly SPL_ATA_RENT_EXEMPT = 2039280;
-
-    /**
-     * Action for transferring the native SOL token, uses provider's public key as a sender
-     *
-     * @param signer
-     * @param recipient
-     * @param amount
-     * @constructor
-     * @private
-     */
-    private SolTransfer(signer: PublicKey, recipient: PublicKey, amount: bigint): SolanaAction {
-        return new SolanaAction(signer, this.root,
-            SystemProgram.transfer({
-                fromPubkey: signer,
-                toPubkey: recipient,
-                lamports: amount
-            }),
-            SolanaTokens.CUCosts.TRANSFER_SOL
-        );
-    }
-
-    /**
-     * Action for transferring the SPL token, uses provider's public key as a sender
-     *
-     * @param signer
-     * @param recipient
-     * @param token
-     * @param amount
-     * @constructor
-     * @private
-     */
-    private Transfer(signer: PublicKey, recipient: PublicKey, token: PublicKey, amount: bigint): SolanaAction {
-        const srcAta = getAssociatedTokenAddressSync(token, signer, true)
-        const dstAta = getAssociatedTokenAddressSync(token, recipient, true);
-        return new SolanaAction(signer, this.root,
-            createTransferInstruction(
-                srcAta,
-                dstAta,
-                signer,
-                amount
-            ),
-            SolanaTokens.CUCosts.TRANSFER
-        );
-    }
-
-    /**
-     * Creates transactions for sending SOL (the native token)
-     *
-     * @param signer
-     * @param amount amount of the SOL in lamports (smallest unit) to send
-     * @param recipient recipient's address
-     * @param feeRate fee rate to use for the transactions
-     * @private
-     */
-    private async txsTransferSol(signer: PublicKey, amount: bigint, recipient: PublicKey, feeRate?: string): Promise<SolanaTx[]> {
-        const wsolAta = getAssociatedTokenAddressSync(SolanaTokens.WSOL_ADDRESS, signer, true);
-
-        const shouldUnwrap = await this.ataExists(wsolAta);
-        const action = new SolanaAction(signer, this.root);
-        if(shouldUnwrap) {
-            feeRate = feeRate || await this.root.Fees.getFeeRate([signer, recipient, wsolAta]);
-            action.add(this.Unwrap(signer));
-        } else {
-            feeRate = feeRate || await this.root.Fees.getFeeRate([signer, recipient]);
-        }
-        action.add(this.SolTransfer(signer, recipient, amount));
-
-        this.logger.debug("txsTransferSol(): transfer native solana TX created, recipient: "+recipient.toString()+
-             " amount: "+amount.toString(10)+" unwrapping: "+shouldUnwrap);
-
-        return [await action.tx(feeRate)];
-    }
-
-    /**
-     * Creates transactions for sending the over the tokens
-     *
-     * @param signer
-     * @param token token to send
-     * @param amount amount of the token to send
-     * @param recipient recipient's address
-     * @param feeRate fee rate to use for the transactions
-     * @private
-     */
-    private async txsTransferTokens(signer: PublicKey, token: PublicKey, amount: bigint, recipient: PublicKey, feeRate?: string) {
-        const srcAta = getAssociatedTokenAddressSync(token, signer, true);
-        const dstAta = getAssociatedTokenAddressSync(token, recipient, true);
-
-        feeRate = feeRate || await this.root.Fees.getFeeRate([signer, srcAta, dstAta]);
-
-        const initAta = !await this.ataExists(dstAta);
-        const action = new SolanaAction(signer, this.root);
-        if(initAta) {
-            action.add(this.InitAta(signer, recipient, token));
-        }
-        action.add(this.Transfer(signer, recipient, token, amount));
-
-        this.logger.debug("txsTransferTokens(): transfer TX created, recipient: "+recipient.toString()+
-            " token: "+token.toString()+ " amount: "+amount.toString(10)+" initAta: "+initAta);
-
-        return [await action.tx(feeRate)];
-    }
-
-    ///////////////////
-    //// Tokens
-    /**
-     * Checks if the provided string is a valid solana token
-     *
-     * @param token
-     */
-    public isValidToken(token: string) {
-        try {
-            new PublicKey(token);
-            return true;
-        } catch (e) {
-            return false;
-        }
-    }
-
-    /**
-     * Returns the specific ATA or null if it doesn't exist
-     *
-     * @param ata
-     */
-    public getATAOrNull(ata: PublicKey): Promise<Account | null> {
-        return getAccount(this.connection, ata).catch(e => {
-            if(e instanceof TokenAccountNotFoundError) return null;
-            throw e;
-        });
-    }
-
-    /**
-     * Checks whether the specific ATA exists, uses tryWithRetries so retries on failure
-     *
-     * @param ata
-     */
-    public async ataExists(ata: PublicKey) {
-        const account = await tryWithRetries<Account>(
-            () => this.getATAOrNull(ata),
-            this.retryPolicy
-        );
-        return account!=null;
-    }
-
-    /**
-     * Returns the rent exempt deposit required to initiate the ATA
-     */
-    public getATARentExemptLamports(): Promise<bigint> {
-        return Promise.resolve(BigInt(SolanaTokens.SPL_ATA_RENT_EXEMPT));
-    }
-
-    /**
-     * Returns the token balance of the public key
-     *
-     * @param publicKey
-     * @param token
-     */
-    public async getTokenBalance(publicKey: PublicKey, token: PublicKey): Promise<{balance: bigint, ataExists: boolean}> {
-        const ata: PublicKey = getAssociatedTokenAddressSync(token, publicKey, true);
-        const [ataAccount, balance] = await Promise.all<[Promise<Account>, Promise<number>]>([
-            this.getATAOrNull(ata),
-            (token!=null && token.equals(SolanaTokens.WSOL_ADDRESS)) ? this.connection.getBalance(publicKey) : Promise.resolve(null)
-        ]);
-
-        let ataExists: boolean = ataAccount!=null;
-        let sum: bigint = 0n;
-        if(ataExists) {
-            sum += ataAccount.amount;
-        }
-
-        if(balance!=null) {
-            let balanceLamports: bigint = BigInt(balance);
-            if(!ataExists) balanceLamports = balanceLamports - await this.getATARentExemptLamports();
-            if(balanceLamports >= 0n) sum += balanceLamports;
-        }
-
-        this.logger.debug("getTokenBalance(): token balance fetched, token: "+token.toString()+
-            " address: "+publicKey.toString()+" amount: "+sum.toString());
-
-        return {balance: sum, ataExists};
-    }
-
-    /**
-     * Returns the native currency address, we use WSOL address as placeholder for SOL
-     */
-    public getNativeCurrencyAddress(): PublicKey {
-        return SolanaTokens.WSOL_ADDRESS;
-    }
-
-    /**
-     * Parses string base58 representation of the token address to a PublicKey object
-     * @param address
-     */
-    public toTokenAddress(address: string): PublicKey {
-        return new PublicKey(address);
-    }
-
-    ///////////////////
-    //// Transfers
-    /**
-     * Create transactions for sending a specific token to a destination address
-     *
-     * @param signer
-     * @param token token to use for the transfer
-     * @param amount amount of token in base units to transfer
-     * @param dstAddress destination address of the recipient
-     * @param feeRate fee rate to use for the transaction
-     */
-    public txsTransfer(signer:PublicKey, token: PublicKey, amount: bigint, dstAddress: PublicKey, feeRate?: string): Promise<SolanaTx[]> {
-        if(SolanaTokens.WSOL_ADDRESS.equals(token)) {
-            return this.txsTransferSol(signer, amount, dstAddress, feeRate);
-        }
-        return this.txsTransferTokens(signer, token, amount, dstAddress, feeRate);
-    }
-
+import {SolanaModule} from "../SolanaModule";
+import {PublicKey, SystemProgram} from "@solana/web3.js";
+import {
+    Account, createAssociatedTokenAccountInstruction,
+    createCloseAccountInstruction, createSyncNativeInstruction, createTransferInstruction,
+    getAccount, getAssociatedTokenAddressSync,
+    TokenAccountNotFoundError
+} from "@solana/spl-token";
+import {SolanaTx} from "./SolanaTransactions";
+import {SolanaAction} from "../SolanaAction";
+import {tryWithRetries} from "../../../utils/Utils";
+
+export class SolanaTokens extends SolanaModule {
+
+    public static readonly CUCosts = {
+        WRAP_SOL: 10000,
+        ATA_CLOSE: 10000,
+        ATA_INIT: 40000,
+        TRANSFER: 50000,
+        TRANSFER_SOL: 5000
+    };
+
+    /**
+     * Creates an ATA for a specific public key & token, the ATA creation is paid for by the underlying provider's
+     *  public key
+     *
+     * @param signer
+     * @param publicKey public key address of the user for which to initiate the ATA
+     * @param token token identification for which the ATA should be initialized
+     * @param requiredAta optional required ata address to use, if the address doesn't match it returns null
+     * @constructor
+     */
+    public InitAta(signer: PublicKey, publicKey: PublicKey, token: PublicKey, requiredAta?: PublicKey): SolanaAction | null {
+        const ata = getAssociatedTokenAddressSync(token, publicKey, true);
+        if(requiredAta!=null && !ata.equals(requiredAta)) return null;
+        return new SolanaAction(
+            signer,
+            this.root,
+            createAssociatedTokenAccountInstruction(
+                signer,
+                ata,
+                publicKey,
+                token
+            ),
+            SolanaTokens.CUCosts.ATA_INIT
+        )
+    }
+
+    /**
+     * Action for wrapping SOL to WSOL for a specific public key
+     *
+     * @param publicKey public key of the user for which to wrap the SOL
+     * @param amount amount of SOL in lamports (smallest unit) to wrap
+     * @param initAta whether we should also initialize the ATA before depositing SOL
+     * @constructor
+     */
+    public Wrap(publicKey: PublicKey, amount: bigint, initAta: boolean): SolanaAction {
+        const ata = getAssociatedTokenAddressSync(SolanaTokens.WSOL_ADDRESS, publicKey, true);
+        const action = new SolanaAction(publicKey, this.root);
+        if(initAta) action.addIx(
+            createAssociatedTokenAccountInstruction(publicKey, ata, publicKey, SolanaTokens.WSOL_ADDRESS),
+            SolanaTokens.CUCosts.ATA_INIT
+        );
+        action.addIx(
+            SystemProgram.transfer({
+                fromPubkey: publicKey,
+                toPubkey: ata,
+                lamports: amount
+            }),
+            SolanaTokens.CUCosts.WRAP_SOL
+        );
+        action.addIx(createSyncNativeInstruction(ata));
+        return action;
+    }
+
+    /**
+     * Action for unwrapping WSOL to SOL for a specific public key
+     *
+     * @param publicKey public key of the user for which to unwrap the sol
+     * @constructor
+     */
+    public Unwrap(publicKey: PublicKey): SolanaAction {
+        const ata = getAssociatedTokenAddressSync(SolanaTokens.WSOL_ADDRESS, publicKey, true);
+        return new SolanaAction(
+            publicKey,
+            this.root,
+            createCloseAccountInstruction(ata, publicKey, publicKey),
+            SolanaTokens.CUCosts.ATA_CLOSE
+        );
+    }
+
+    public static readonly WSOL_ADDRESS = new PublicKey("So11111111111111111111111111111111111111112");
+    public static readonly SPL_ATA_RENT_EXEMPT = 2039280;
+
+    /**
+     * Action for transferring the native SOL token, uses provider's public key as a sender
+     *
+     * @param signer
+     * @param recipient
+     * @param amount
+     * @constructor
+     * @private
+     */
+    private SolTransfer(signer: PublicKey, recipient: PublicKey, amount: bigint): SolanaAction {
+        return new SolanaAction(signer, this.root,
+            SystemProgram.transfer({
+                fromPubkey: signer,
+                toPubkey: recipient,
+                lamports: amount
+            }),
+            SolanaTokens.CUCosts.TRANSFER_SOL
+        );
+    }
+
+    /**
+     * Action for transferring the SPL token, uses provider's public key as a sender
+     *
+     * @param signer
+     * @param recipient
+     * @param token
+     * @param amount
+     * @constructor
+     * @private
+     */
+    private Transfer(signer: PublicKey, recipient: PublicKey, token: PublicKey, amount: bigint): SolanaAction {
+        const srcAta = getAssociatedTokenAddressSync(token, signer, true)
+        const dstAta = getAssociatedTokenAddressSync(token, recipient, true);
+        return new SolanaAction(signer, this.root,
+            createTransferInstruction(
+                srcAta,
+                dstAta,
+                signer,
+                amount
+            ),
+            SolanaTokens.CUCosts.TRANSFER
+        );
+    }
+
+    /**
+     * Creates transactions for sending SOL (the native token)
+     *
+     * @param signer
+     * @param amount amount of the SOL in lamports (smallest unit) to send
+     * @param recipient recipient's address
+     * @param feeRate fee rate to use for the transactions
+     * @private
+     */
+    private async txsTransferSol(signer: PublicKey, amount: bigint, recipient: PublicKey, feeRate?: string): Promise<SolanaTx[]> {
+        const wsolAta = getAssociatedTokenAddressSync(SolanaTokens.WSOL_ADDRESS, signer, true);
+
+        const shouldUnwrap = await this.ataExists(wsolAta);
+        const action = new SolanaAction(signer, this.root);
+        if(shouldUnwrap) {
+            feeRate = feeRate || await this.root.Fees.getFeeRate([signer, recipient, wsolAta]);
+            action.add(this.Unwrap(signer));
+        } else {
+            feeRate = feeRate || await this.root.Fees.getFeeRate([signer, recipient]);
+        }
+        action.add(this.SolTransfer(signer, recipient, amount));
+
+        this.logger.debug("txsTransferSol(): transfer native solana TX created, recipient: "+recipient.toString()+
+             " amount: "+amount.toString(10)+" unwrapping: "+shouldUnwrap);
+
+        return [await action.tx(feeRate)];
+    }
+
+    /**
+     * Creates transactions for sending the over the tokens
+     *
+     * @param signer
+     * @param token token to send
+     * @param amount amount of the token to send
+     * @param recipient recipient's address
+     * @param feeRate fee rate to use for the transactions
+     * @private
+     */
+    private async txsTransferTokens(signer: PublicKey, token: PublicKey, amount: bigint, recipient: PublicKey, feeRate?: string) {
+        const srcAta = getAssociatedTokenAddressSync(token, signer, true);
+        const dstAta = getAssociatedTokenAddressSync(token, recipient, true);
+
+        feeRate = feeRate || await this.root.Fees.getFeeRate([signer, srcAta, dstAta]);
+
+        const initAta = !await this.ataExists(dstAta);
+        const action = new SolanaAction(signer, this.root);
+        if(initAta) {
+            action.add(this.InitAta(signer, recipient, token));
+        }
+        action.add(this.Transfer(signer, recipient, token, amount));
+
+        this.logger.debug("txsTransferTokens(): transfer TX created, recipient: "+recipient.toString()+
+            " token: "+token.toString()+ " amount: "+amount.toString(10)+" initAta: "+initAta);
+
+        return [await action.tx(feeRate)];
+    }
+
+    ///////////////////
+    //// Tokens
+    /**
+     * Checks if the provided string is a valid solana token
+     *
+     * @param token
+     */
+    public isValidToken(token: string) {
+        try {
+            new PublicKey(token);
+            return true;
+        } catch (e) {
+            return false;
+        }
+    }
+
+    /**
+     * Returns the specific ATA or null if it doesn't exist
+     *
+     * @param ata
+     */
+    public getATAOrNull(ata: PublicKey): Promise<Account | null> {
+        return getAccount(this.connection, ata).catch(e => {
+            if(e instanceof TokenAccountNotFoundError) return null;
+            throw e;
+        });
+    }
+
+    /**
+     * Checks whether the specific ATA exists, uses tryWithRetries so retries on failure
+     *
+     * @param ata
+     */
+    public async ataExists(ata: PublicKey) {
+        const account = await tryWithRetries<Account>(
+            () => this.getATAOrNull(ata),
+            this.retryPolicy
+        );
+        return account!=null;
+    }
+
+    /**
+     * Returns the rent exempt deposit required to initiate the ATA
+     */
+    public getATARentExemptLamports(): Promise<bigint> {
+        return Promise.resolve(BigInt(SolanaTokens.SPL_ATA_RENT_EXEMPT));
+    }
+
+    /**
+     * Returns the token balance of the public key
+     *
+     * @param publicKey
+     * @param token
+     */
+    public async getTokenBalance(publicKey: PublicKey, token: PublicKey): Promise<{balance: bigint, ataExists: boolean}> {
+        const ata: PublicKey = getAssociatedTokenAddressSync(token, publicKey, true);
+        const [ataAccount, balance] = await Promise.all<[Promise<Account>, Promise<number>]>([
+            this.getATAOrNull(ata),
+            (token!=null && token.equals(SolanaTokens.WSOL_ADDRESS)) ? this.connection.getBalance(publicKey) : Promise.resolve(null)
+        ]);
+
+        let ataExists: boolean = ataAccount!=null;
+        let sum: bigint = 0n;
+        if(ataExists) {
+            sum += ataAccount.amount;
+        }
+
+        if(balance!=null) {
+            let balanceLamports: bigint = BigInt(balance);
+            if(!ataExists) balanceLamports = balanceLamports - await this.getATARentExemptLamports();
+            if(balanceLamports >= 0n) sum += balanceLamports;
+        }
+
+        this.logger.debug("getTokenBalance(): token balance fetched, token: "+token.toString()+
+            " address: "+publicKey.toString()+" amount: "+sum.toString());
+
+        return {balance: sum, ataExists};
+    }
+
+    /**
+     * Returns the native currency address, we use WSOL address as placeholder for SOL
+     */
+    public getNativeCurrencyAddress(): PublicKey {
+        return SolanaTokens.WSOL_ADDRESS;
+    }
+
+    /**
+     * Parses string base58 representation of the token address to a PublicKey object
+     * @param address
+     */
+    public toTokenAddress(address: string): PublicKey {
+        return new PublicKey(address);
+    }
+
+    ///////////////////
+    //// Transfers
+    /**
+     * Create transactions for sending a specific token to a destination address
+     *
+     * @param signer
+     * @param token token to use for the transfer
+     * @param amount amount of token in base units to transfer
+     * @param dstAddress destination address of the recipient
+     * @param feeRate fee rate to use for the transaction
+     */
+    public txsTransfer(signer:PublicKey, token: PublicKey, amount: bigint, dstAddress: PublicKey, feeRate?: string): Promise<SolanaTx[]> {
+        if(SolanaTokens.WSOL_ADDRESS.equals(token)) {
+            return this.txsTransferSol(signer, amount, dstAddress, feeRate);
+        }
+        return this.txsTransferTokens(signer, token, amount, dstAddress, feeRate);
+    }
+
 }