@ercworldio/blockchain-shared 1.0.0-dev.10

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

@@ -0,0 +1,5 @@
+export * from "./SolanaEscrowInteraction";
+export * from "./SolanaEscrowAdmin";
+export * from "./services/index";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/solana/escrow/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,20 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./SolanaEscrowInteraction"), exports);
+__exportStar(require("./SolanaEscrowAdmin"), exports);
+__exportStar(require("./services/index"), exports);
+__exportStar(require("./types"), exports);

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

@@ -0,0 +1,19 @@
+export interface Err {
+    logs: string[];
+    signature: string;
+    transactionError: string;
+    transactionLogs: string[];
+    transactionMessage: string;
+    message?: string;
+    stack?: string;
+}
+export interface ParsedErr {
+    name: SolanaEscrowErrorNames;
+    message: string;
+}
+export type SolanaEscrowErrorNames = "Unauthorized" | "InvalidInstructionData" | "InvalidAccountData" | "InvalidSignature" | "InvalidSignatureCount" | "InvalidOffset" | "MessageOutOfBounds" | "UnexpectedMessage" | "PubKeyOutOfBounds" | "InvalidSigner" | "AlreadyExists" | "NotFound" | "InvalidPaymenToken" | "Paused" | "SameState" | "MaxPaymentTokenCount" | "MaxAdminCount" | "InsufficientSOLReserves" | "InsufficientSPLReserves" | "Unknown";
+declare class SolanaErrors {
+    static decode(_error: unknown): ParsedErr;
+}
+export default SolanaErrors;
+//# sourceMappingURL=Errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/Errors.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,MAAM,sBAAsB,GAC5B,cAAc,GACd,wBAAwB,GACxB,oBAAoB,GACpB,kBAAkB,GAClB,uBAAuB,GACvB,eAAe,GACf,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,UAAU,GACV,oBAAoB,GACpB,QAAQ,GACR,WAAW,GACX,sBAAsB,GACtB,eAAe,GACf,yBAAyB,GACzB,yBAAyB,GACzB,SAAS,CAAC;AAGhB,cAAM,YAAY;IACd,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS;CA0B5C;AAED,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const anchor_1 = require("@coral-xyz/anchor");
+class SolanaErrors {
+    static decode(_error) {
+        try {
+            const error = _error;
+            const errorLogs = error.logs || error.transactionLogs;
+            // Not a solana program error
+            if (!errorLogs)
+                return { message: (error === null || error === void 0 ? void 0 : error.message) ? error.message : "Unexpected error", name: "Unknown" };
+            // Decode anchor error
+            const anchorError = anchor_1.AnchorError.parse(errorLogs);
+            // Return anchor error message
+            if (anchorError) {
+                return { message: anchorError.error.errorMessage, name: anchorError.error.errorCode.code };
+            }
+            else {
+                // Error is not an anchor type
+                return { message: (error === null || error === void 0 ? void 0 : error.message) ? error.message : "Unexpected error.", name: "Unknown" };
+            }
+        }
+        catch (err) {
+            const typedError = _error;
+            return { message: typedError.message ? typedError.message : "Unexpected error.", name: "Unknown" };
+        }
+    }
+}
+exports.default = SolanaErrors;

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

@@ -0,0 +1,122 @@
+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/escrow";
+import { BatchReceiver } from "../types/types";
+export declare class EscrowAdminUtility {
+    program: Program<Escrow>;
+    provider: anchor.AnchorProvider;
+    constructor(program: Program<Escrow>, provider: anchor.AnchorProvider);
+    /**
+     * Check if the escrow program is paused or running
+     * @returns true/false. True: program is paused. False: Program is running
+     */
+    is_paused(): Promise<boolean>;
+    /**
+     * Check if a wallet has the admin role
+     * @param target_address address of the wallet
+     * @returns
+     */
+    is_admin(target_address: string): Promise<boolean>;
+    /**
+     * Check if a token is included in the allowed payment tokens list
+     * @param target_address address of the token
+     * @returns
+     */
+    is_payment_token(target_address: string): Promise<boolean>;
+    get_balances(): Promise<[string, number][]>;
+    /**
+     * Gets the list of allowed payment tokens registered in the escrow program
+     * @returns string[] - array of payment token addresses
+     */
+    get_payment_tokens(): Promise<string[]>;
+    /**
+     * Gets the list of admins registered in the escrow program
+     * @returns string[] - array of payment token addresses
+     */
+    get_admins(): Promise<string[]>;
+    /**
+     * Add a new token to the allowed payment tokens list
+     * @param token_mint address of the token to add
+     * @param signer optional signer keypair
+     * @returns string - transaction signature
+     */
+    add_payment_token(token_mint: string, signer?: Keypair): Promise<string>;
+    remove_payment_token(token_mint: string, signer?: Keypair): Promise<string>;
+    /**
+     * Assigns the admin role to the specified wallet address
+     * @param new_admin_address wallet address of the new admin
+     * @param signer optional signer keypair
+     * @returns string - transaction signature
+     */
+    add_admin(new_admin_address: string, signer?: Keypair): Promise<string>;
+    /**
+     * Remove the admin role for a given wallet address
+     * @param target_address address of the admin to remove
+     * @param signer optional signer keypair
+     * @returns
+     */
+    remove_admin(target_address: string, signer?: Keypair): Promise<string>;
+    /**
+     * Pause or unpause the program state
+     * @param target_state true/false - True: Pause program. False: unpause program
+     * @param signer optional signer keypair
+     * @returns string - transaction signature
+     */
+    set_pause_state(target_state: boolean, signer?: Keypair): Promise<string>;
+    /**
+     * Deposit tokens (SOL or SPL) to the escrow program vault
+     * @param token_address Address of the token to withdraw
+     * @param amount_in_decimals amount to deposit in decimals
+     * @param signer optional signer keypair
+     * @returns
+     */
+    deposit(token_address: string, amount_in_decimals: number, signer?: Keypair): Promise<string>;
+    /**
+     * Withdraw tokens from the escrow program vault by admin to the specified receiver
+     * @param token_address Address of the token to withdraw
+     * @param amount_in_decimals amount to withdraw in decimals
+     * @param receiver_address Address of the receiver of tokens
+     * @param signer optional signer keypair
+     * @returns string - transaction signature
+     */
+    withdraw(token_address: string, amount_in_decimals: number, receiver_address: string, signer?: Keypair): Promise<string | undefined>;
+    /**
+     *  Accepts an array of receivers and amounts and performs a batch withdrawal to the specified receivers
+     * for the specified token (SOL or SPL)
+     * @param token_address Address of the token to withdraw
+     * @param recipients Array of receivers and their amounts
+     * @param signer optional signer keypair
+     * @returns string - signature
+     */
+    withdraw_batch(token_address: string, recipients: BatchReceiver[], signer?: Keypair): Promise<string>;
+    /** @dev this might fail if the recipient does not have an ATA - take care of it in funding worker task */
+    private batch_withdraw_spl;
+    private batch_withdraw_sol;
+    private withdraw_sol;
+    private withdraw_spl;
+    private deposit_sol;
+    private deposit_spl;
+    getVaultBalance(): Promise<number>;
+    getVaultTokenBalance(mint: PublicKey): Promise<number>;
+    private sendTransaction;
+    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): EscrowAdminUtility;
+    /**
+     * 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): EscrowAdminUtility;
+}
+export default EscrowAdminUtility;
+//# sourceMappingURL=EscrowAdminUtility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EscrowAdminUtility.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/EscrowAdminUtility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAoB,SAAS,EAA0E,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGjL,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAKzC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,kBAAkB;IACpB,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;IAWrE;;;OAGG;IACU,SAAS;IAYtB;;;;OAIG;IACU,QAAQ,CAAC,cAAc,EAAE,MAAM;IAgB5C;;;;OAIG;IACU,gBAAgB,CAAC,cAAc,EAAE,MAAM;IAgBvC,YAAY;IA2BzB;;;OAGG;IACU,kBAAkB;IAY/B;;;OAGG;IACU,UAAU;IAiBvB;;;;;OAKG;IACU,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAkCtD,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAmBtE;;;;;OAKG;IACU,SAAS,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAmBlE;;;;;OAKG;IACU,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAoBlE;;;;;OAKG;IACU,eAAe,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO;IAqBpE;;;;;;OAMG;IACU,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAUxF;;;;;;;OAOG;IACU,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAWnH;;;;;;;OAOG;IACU,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO;IAUhG,0GAA0G;YAC5F,kBAAkB;YAsClB,kBAAkB;YA2ClB,YAAY;YAyBZ,YAAY;YAgCZ,WAAW;YAwBX,WAAW;IAuCnB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAUlC,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YAU9C,eAAe;IA0BhB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F,mBAAmB,CAC5B,SAAS,EAAE,oBAAoB,EAC/B,UAAU,GAAE,WAAW,GAAG,WAAyB,EACnD,SAAS,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC;IAkChB;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,GAAG,kBAAkB;IAKnF;;;;;;OAMG;IACH,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,GAAG,kBAAkB;CAM/H;AAED,eAAe,kBAAkB,CAAC"}