@ercworldio/blockchain-shared 1.0.0-dev.4

package/build/services/solana/escrow/services/EscrowService.js

@@ -0,0 +1,155 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findEscrowConfigPda = findEscrowConfigPda;
+exports.findVaultAuthorityPda = findVaultAuthorityPda;
+exports.findVaultAta = findVaultAta;
+exports.findSolVaultPda = findSolVaultPda;
+exports.findNonceAccountPda = findNonceAccountPda;
+exports.getTokenDecimals = getTokenDecimals;
+exports.getWithdrawNonce = getWithdrawNonce;
+exports.initializeEscrowConfig = initializeEscrowConfig;
+const spl_token_1 = require("@solana/spl-token");
+const web3_js_1 = require("@solana/web3.js");
+const system_1 = require("@coral-xyz/anchor/dist/cjs/native/system");
+const Errors_1 = __importDefault(require("./Errors"));
+const TransactionsService = __importStar(require("./TransactionsService"));
+const EscrowUtility_1 = __importDefault(require("./EscrowUtility"));
+function findEscrowConfigPda(programId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('escrow-config-v2')], programId)[0];
+}
+function findVaultAuthorityPda(programId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from('escrow')], programId)[0];
+}
+function findVaultAta(mint, programId) {
+    const vaultAuthority = findVaultAuthorityPda(programId);
+    return (0, spl_token_1.getAssociatedTokenAddressSync)(mint, vaultAuthority, true);
+}
+// SOL uses the same vault authority as SPL tokens
+function findSolVaultPda(programId) {
+    return findVaultAuthorityPda(programId);
+}
+function findNonceAccountPda(programId, user_pubkey) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("withdraw-nonce"),
+        user_pubkey.toBuffer()
+    ], programId)[0];
+}
+function getTokenDecimals(token_mint, connection) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const token_details = yield connection.getParsedAccountInfo(token_mint, "confirmed");
+        if (!token_details || !token_details.value || !token_details.value)
+            throw new Error("Unexpected token error. Please try another token.");
+        // Get decimals from parsed data
+        const parsed_data = token_details.value.data;
+        const decimals = parsed_data.parsed.info.decimals;
+        if (!decimals)
+            throw new Error("Unexpected token error. Please try another token.");
+        return decimals;
+    });
+}
+// Get a user's withdrawal nonce count
+function getWithdrawNonce(program, userPubkey, provider, signer) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // Derive the user's nonce PDA
+            const nonce_pda = findNonceAccountPda(program.programId, userPubkey);
+            const escrow_utility = yield EscrowUtility_1.default.createWithCustomProgramId(provider, program.programId, program.idl);
+            // Check if the nonce account exists, create if not
+            const account = yield provider.connection.getAccountInfo(nonce_pda);
+            if (!account) {
+                // Create user's nonce account
+                const ix = yield program.methods
+                    .getNonce()
+                    .accountsPartial({
+                    nonceAccount: nonce_pda,
+                    user: userPubkey,
+                    systemProgram: system_1.SYSTEM_PROGRAM_ID
+                })
+                    .instruction();
+                const tx = new web3_js_1.Transaction().add(ix);
+                tx.feePayer = userPubkey;
+                tx.recentBlockhash = ((yield provider.connection.getLatestBlockhash()).blockhash);
+                // Use signer keypair
+                if (signer) {
+                    tx.sign(signer);
+                    const sig = yield provider.connection.sendRawTransaction(tx.serialize(), { skipPreflight: false, preflightCommitment: "confirmed" });
+                    yield escrow_utility.waitForConfirmation(sig, "finalized");
+                }
+                else {
+                    // Use browser wallet adapter to sign tx
+                    const sig = yield provider.sendAndConfirm(tx, undefined, { commitment: "confirmed" });
+                    yield escrow_utility.waitForConfirmation(sig, "finalized");
+                }
+            }
+            // Get the nonce value
+            const nonce_data = yield program.account.withdrawNonce.fetch(nonce_pda);
+            return nonce_data.nonce;
+        }
+        catch (error) {
+            throw Errors_1.default.decode(error);
+        }
+    });
+}
+// Admin method
+function initializeEscrowConfig(program, admin, provider) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const programId = program.programId;
+        const escrowConfig = findEscrowConfigPda(programId);
+        const sig = yield program.methods
+            .initializeEscrowConfig()
+            .accounts({
+            escrowConfig,
+            admin: admin.publicKey,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .signers([admin])
+            .rpc();
+        yield TransactionsService.waitForTransactionConfirmation(provider, sig, 'confirmed');
+        return { escrowConfig, signature: sig };
+    });
+}

package/build/services/solana/escrow/services/EscrowUtility.d.ts

@@ -0,0 +1,58 @@
+import * as anchor from "@coral-xyz/anchor";
+import { Program } from "@coral-xyz/anchor";
+import { Commitment, Keypair, PublicKey, TransactionSignature } from "@solana/web3.js";
+import { Escrow } from "../types";
+import { WithdrawSignature } from "../types/types";
+export declare class EscrowUtility {
+    program: Program<Escrow>;
+    provider: anchor.AnchorProvider;
+    constructor(program: Program<Escrow>, provider: anchor.AnchorProvider);
+    /**
+     * Deposit SPL tokens to the escrow contract's vault program
+     * @param mint PublicKey - SPL token address
+     * @param amount number - Amount in lamports (based on token's decimals)
+     * @returns Promise<string> - Transaction signature
+     */
+    depositSplToken(mint: PublicKey, amount: number, bonus_code?: string, signer?: Keypair): Promise<string>;
+    /**
+     * Deposit SOL native tokens to the escrow's vault
+     * @param amountLamports number - Amount to deposit in lamports
+     * @returns - Transaction signature
+     */
+    depositSol(amountLamports: number, bonus_code?: string): Promise<string>;
+    /**
+     * Withdraw SOL native tokens to the specified receiver wallet address
+     * @param recipient PublicKey - Receiver of tokens
+     * @param amountLamports number - Amount to withdraw in lamports
+     * @returns - Transaction signature
+     */
+    withdrawSol(recipient: PublicKey, amountLamports: number, chainId: number, request_id: number, signature: WithdrawSignature): Promise<string>;
+    /**
+     * Withdraw SPL tokens to the specified wallet address
+     * @param mint PublicKey - Address of the SPL token to withdraw
+     * @param amount number - Amount in lamports calculated with the token's decimals
+     * @returns - Transaction signature
+     */
+    withdrawSplToken(mint: PublicKey, amount: number, chainId: number, request_id: number, signature: WithdrawSignature): Promise<string>;
+    getVaultBalance(): Promise<number>;
+    getVaultTokenBalance(mint: PublicKey): Promise<number>;
+    confirmTransaction(signature: string, commitment?: Commitment): Promise<void>;
+    waitForConfirmation(signature: TransactionSignature, commitment?: "confirmed" | "finalized", timeoutMs?: number): Promise<void>;
+    /**
+     *
+     * @param provider AnchorProvider - An anchor provider instance constructed with the user's public key and sign transactions handlers
+     * @param idl IDL file - Escrow program idl
+     * @returns
+     */
+    static create(provider: anchor.AnchorProvider, idl: anchor.Idl): Promise<EscrowUtility>;
+    /**
+     * Create an instance with the target escrow's program id
+     * @param provider AnchorProvider - An anchor provider instance constructed with the user's public key and sign transactions handlers
+     * @param programId PublicKey - Escrow program ID
+     * @param idl IDL file - Escrow program idl
+     * @returns
+     */
+    static createWithCustomProgramId(provider: anchor.AnchorProvider, programId: PublicKey, idl: anchor.Idl): Promise<EscrowUtility>;
+}
+export default EscrowUtility;
+//# sourceMappingURL=EscrowUtility.d.ts.map

package/build/services/solana/escrow/services/EscrowUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EscrowUtility.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/EscrowUtility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAkB,OAAO,EAAE,SAAS,EAA8B,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAInI,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,qBAAa,aAAa;IACjB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC;gBAE3B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,cAAc;IASrE;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,MAAW,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAoClH;;;;OAIG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBlF;;;;;OAKG;IACG,WAAW,CACf,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC;IA2ClB;;;;;OAKG;IACG,gBAAgB,CACpB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC;IAwDZ,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAKlC,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAU/C,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F,mBAAmB,CAC9B,SAAS,EAAE,oBAAoB,EAC/B,UAAU,GAAE,WAAW,GAAG,WAAyB,EACnD,SAAS,SAAS,GACjB,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;;OAKG;WACU,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC;IAK7F;;;;;;OAMG;WACU,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC;CAMvI;AAED,eAAe,aAAa,CAAC"}

package/build/services/solana/escrow/services/EscrowUtility.js

@@ -0,0 +1,318 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EscrowUtility = void 0;
+const anchor = __importStar(require("@coral-xyz/anchor"));
+const anchor_1 = require("@coral-xyz/anchor");
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const EscrowService = __importStar(require("./EscrowService"));
+const TokenAccountService = __importStar(require("./TokenAccountService"));
+// import { WithdrawSignature } from "../SolanaEscrowInteraction";
+const Errors_1 = __importDefault(require("./Errors"));
+class EscrowUtility {
+    constructor(program, provider) {
+        this.program = program;
+        this.provider = provider;
+    }
+    // ==========================
+    // SPL Token Methods
+    // ==========================
+    /**
+     * Deposit SPL tokens to the escrow contract's vault program
+     * @param mint PublicKey - SPL token address
+     * @param amount number - Amount in lamports (based on token's decimals)
+     * @returns Promise<string> - Transaction signature
+     */
+    depositSplToken(mint_1, amount_1) {
+        return __awaiter(this, arguments, void 0, function* (mint, amount, bonus_code = "", signer) {
+            try {
+                // Ensure the user's ATA is created and initialized
+                const userTokenAccount = yield TokenAccountService.ensureTokenAccount(this.provider, mint, this.provider.wallet.publicKey);
+                // Get the escrow's vault ATA
+                const vaultTokenAccount = EscrowService.findVaultAta(new web3_js_1.PublicKey(mint), this.program.programId);
+                const programId = this.program.programId;
+                const vaultAuthority = EscrowService.findVaultAuthorityPda(programId);
+                const ix = yield this.program.methods
+                    .depositSpl(new anchor.BN(amount), bonus_code)
+                    .accountsPartial({
+                    mint: mint,
+                    user: this.provider.wallet.publicKey,
+                    vaultTokenAccount,
+                    vaultAuthority,
+                    userTokenAccount,
+                    tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+                    systemProgram: web3_js_1.SystemProgram.programId
+                })
+                    .signers(signer ? [signer] : [])
+                    .instruction();
+                const tx = new web3_js_1.Transaction().add(ix);
+                const sig = yield this.provider.sendAndConfirm(tx, undefined, { commitment: "finalized" });
+                return sig;
+            }
+            catch (error) {
+                throw Errors_1.default.decode(error);
+            }
+        });
+    }
+    // ==========================
+    // Native SOL Methods
+    // ==========================
+    /**
+     * Deposit SOL native tokens to the escrow's vault
+     * @param amountLamports number - Amount to deposit in lamports
+     * @returns - Transaction signature
+     */
+    depositSol(amountLamports_1) {
+        return __awaiter(this, arguments, void 0, function* (amountLamports, bonus_code = "") {
+            try {
+                const programId = this.program.programId;
+                const escrowConfig = EscrowService.findEscrowConfigPda(programId);
+                const vaultAuthority = EscrowService.findVaultAuthorityPda(programId);
+                const ix = yield this.program.methods
+                    .depositSol(new anchor.BN(amountLamports), bonus_code)
+                    .accountsPartial({
+                    escrowConfig,
+                    depositor: this.provider.wallet.publicKey,
+                    vaultAuthority,
+                    systemProgram: web3_js_1.SystemProgram.programId
+                })
+                    .instruction();
+                const tx = new web3_js_1.Transaction().add(ix);
+                const sig = yield this.provider.sendAndConfirm(tx, undefined, { commitment: "finalized" });
+                return sig;
+            }
+            catch (error) {
+                throw Errors_1.default.decode(error);
+            }
+        });
+    }
+    /**
+     * Withdraw SOL native tokens to the specified receiver wallet address
+     * @param recipient PublicKey - Receiver of tokens
+     * @param amountLamports number - Amount to withdraw in lamports
+     * @returns - Transaction signature
+     */
+    withdrawSol(recipient, amountLamports, chainId, request_id, signature) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const programId = this.program.programId;
+                const escrowConfigPda = EscrowService.findEscrowConfigPda(programId);
+                const vaultAuthorityPda = EscrowService.findVaultAuthorityPda(programId);
+                // Get nonce PDA
+                const noncePda = EscrowService.findNonceAccountPda(this.program.programId, this.provider.wallet.publicKey);
+                // Create the Ed25519 program signature instruction
+                const ed25519_ix = web3_js_1.Ed25519Program.createInstructionWithPublicKey({
+                    publicKey: signature.signer.toBytes(),
+                    message: signature.message,
+                    signature: signature.signature
+                });
+                // Create withdraw tx
+                const withdraw_ix = yield this.program.methods
+                    .withdrawSolWithSig(new anchor.BN(amountLamports), new anchor.BN(chainId), new anchor.BN(request_id))
+                    .accountsPartial({
+                    escrowConfig: escrowConfigPda,
+                    vaultAuthority: vaultAuthorityPda,
+                    user: this.provider.wallet.publicKey,
+                    recipient: recipient,
+                    tokenAddress: new web3_js_1.PublicKey(web3_js_1.SystemProgram.programId),
+                    withdrawNonce: noncePda,
+                    systemProgram: web3_js_1.SystemProgram.programId,
+                    instructions: anchor.web3.SYSVAR_INSTRUCTIONS_PUBKEY
+                })
+                    .transaction();
+                const tx = new web3_js_1.Transaction().add(ed25519_ix, withdraw_ix);
+                tx.feePayer = this.provider.wallet.publicKey;
+                tx.recentBlockhash = (yield this.provider.connection.getLatestBlockhash()).blockhash;
+                const tx_sig = yield this.provider.sendAndConfirm(tx, undefined, { commitment: "finalized" });
+                return tx_sig;
+            }
+            catch (error) {
+                throw Errors_1.default.decode(error);
+            }
+        });
+    }
+    /**
+     * Withdraw SPL tokens to the specified wallet address
+     * @param mint PublicKey - Address of the SPL token to withdraw
+     * @param amount number - Amount in lamports calculated with the token's decimals
+     * @returns - Transaction signature
+     */
+    withdrawSplToken(mint, amount, chainId, request_id, signature) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const programId = this.program.programId;
+                // Derive required PDAs
+                const vaultAuthorityPda = EscrowService.findVaultAuthorityPda(programId);
+                const vaultTokenAccount = EscrowService.findVaultAta(mint, programId);
+                const escrowConfigPda = EscrowService.findEscrowConfigPda(programId);
+                const noncePda = EscrowService.findNonceAccountPda(this.program.programId, this.provider.wallet.publicKey);
+                // Ensure user has a token account
+                const userTokenAccount = yield TokenAccountService.ensureTokenAccount(this.provider, mint, this.provider.wallet.publicKey);
+                // Create the Ed25519 program signature instruction
+                const ed25519_ix = web3_js_1.Ed25519Program.createInstructionWithPublicKey({
+                    publicKey: signature.signer.toBytes(),
+                    message: signature.message,
+                    signature: signature.signature
+                });
+                // Create withdrawal instruciton
+                const withdraw_ix = yield this.program.methods
+                    .withdrawSplWithSig(new anchor.BN(amount), new anchor.BN(chainId), new anchor.BN(request_id))
+                    .accountsPartial({
+                    escrowConfig: escrowConfigPda,
+                    mint: mint,
+                    vaultAuthority: vaultAuthorityPda,
+                    vaultTokenAccount: vaultTokenAccount,
+                    user: this.provider.wallet.publicKey,
+                    recipient: this.provider.wallet.publicKey,
+                    withdrawNonce: noncePda,
+                    userTokenAccount: userTokenAccount,
+                    tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+                    systemProgram: web3_js_1.SystemProgram.programId,
+                    instructions: anchor.web3.SYSVAR_INSTRUCTIONS_PUBKEY
+                })
+                    .instruction();
+                // Add instructions to tx
+                const tx = new web3_js_1.Transaction().add(ed25519_ix, withdraw_ix);
+                tx.feePayer = this.provider.wallet.publicKey;
+                tx.recentBlockhash = (yield this.provider.connection.getLatestBlockhash()).blockhash;
+                // Send tx
+                const sig = yield this.provider.sendAndConfirm(tx, undefined, { commitment: "finalized" });
+                return sig;
+            }
+            catch (error) {
+                const parsedError = Errors_1.default.decode(error);
+                throw parsedError;
+            }
+        });
+    }
+    // ==========================
+    // Utility Methods
+    // ==========================
+    getVaultBalance() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const vaultAuthority = EscrowService.findVaultAuthorityPda(this.program.programId);
+            return yield this.provider.connection.getBalance(vaultAuthority);
+        });
+    }
+    getVaultTokenBalance(mint) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const vaultTokenAccount = EscrowService.findVaultAta(mint, this.program.programId);
+            try {
+                const accountInfo = yield this.provider.connection.getTokenAccountBalance(vaultTokenAccount);
+                return accountInfo.value.uiAmount || 0;
+            }
+            catch (_a) {
+                return 0;
+            }
+        });
+    }
+    confirmTransaction(signature_1) {
+        return __awaiter(this, arguments, void 0, function* (signature, commitment = "finalized") {
+            yield this.provider.connection.confirmTransaction(signature, commitment);
+        });
+    }
+    waitForConfirmation(signature_1) {
+        return __awaiter(this, arguments, void 0, function* (signature, commitment = "confirmed", timeoutMs = 60000) {
+            try {
+                const start = Date.now();
+                while (Date.now() - start < timeoutMs) {
+                    const status = yield this.provider.connection.getSignatureStatus(signature, {
+                        searchTransactionHistory: true
+                    });
+                    const confirmation = status.value;
+                    if (confirmation) {
+                        if (commitment === "finalized" && confirmation.confirmationStatus === "finalized") {
+                            return;
+                        }
+                        if (commitment === "confirmed" && confirmation.confirmationStatus !== "processed") {
+                            return;
+                        }
+                    }
+                    // Wait before polling again
+                    yield new Promise(r => setTimeout(r, 1000));
+                }
+                throw new Error(`Transaction ${signature} not confirmed within ${timeoutMs}ms`);
+            }
+            catch (error) {
+                throw Errors_1.default.decode(error);
+            }
+        });
+    }
+    // ==========================
+    // Factory Methods
+    // ==========================
+    /**
+     *
+     * @param provider AnchorProvider - An anchor provider instance constructed with the user's public key and sign transactions handlers
+     * @param idl IDL file - Escrow program idl
+     * @returns
+     */
+    static create(provider, idl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const program = new anchor_1.Program(idl, provider);
+            return new EscrowUtility(program, provider);
+        });
+    }
+    /**
+     * Create an instance with the target escrow's program id
+     * @param provider AnchorProvider - An anchor provider instance constructed with the user's public key and sign transactions handlers
+     * @param programId PublicKey - Escrow program ID
+     * @param idl IDL file - Escrow program idl
+     * @returns
+     */
+    static createWithCustomProgramId(provider, programId, idl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Override the program ID in the IDL
+            const modifiedIdl = Object.assign(Object.assign({}, idl), { address: programId.toBase58() });
+            const program = new anchor_1.Program(modifiedIdl, provider);
+            return new EscrowUtility(program, provider);
+        });
+    }
+}
+exports.EscrowUtility = EscrowUtility;
+exports.default = EscrowUtility;

package/build/services/solana/escrow/services/TokenAccountService.d.ts

@@ -0,0 +1,10 @@
+import * as anchor from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+export declare function ensureTokenAccount(provider: anchor.AnchorProvider, mintAddress: anchor.web3.PublicKey, owner: PublicKey): Promise<anchor.web3.PublicKey>;
+export declare function getTokenAccountDetails(provider: anchor.AnchorProvider, tokenAccountPubkey: anchor.web3.PublicKey): Promise<{
+    tokenAccountData: any;
+    delegate: any;
+    delegateAmount: any;
+} | null | undefined>;
+export declare function ensureWrappedSolWithAmount(provider: anchor.AnchorProvider, ownerKeypair: anchor.web3.Keypair, amountLamports: number): Promise<anchor.web3.PublicKey>;
+//# sourceMappingURL=TokenAccountService.d.ts.map

package/build/services/solana/escrow/services/TokenAccountService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenAccountService.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/TokenAccountService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAO5C,OAAO,EAAE,SAAS,EAA8B,MAAM,iBAAiB,CAAC;AAGxE,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,kCA0C7H;AAED,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS;;;;sBAyBtH;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EACjC,cAAc,EAAE,MAAM,kCAuCvB"}