@ercworldio/blockchain-shared 1.0.5-dev.7.PROJ-1464.0 → 1.0.5-dev.8

package/build/services/rpc/RPC.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("../../constants");
+const Provider_1 = require("../../chains/Provider");
+// export var default_archival_connection_provider: RpcProviderType = RpcProviderType.ALCHEMY;
+// export var default_evm_rpc_provider: RpcProviderType = RpcProviderType.ALCHEMY;
+class RPC {
+    constructor() {
+        this.initialized = false;
+        this.currentProvider = new Map();
+        // const config = Config.getInstance();
+        // const evmProvider = config.config.defaultEvmRpcProviderType ? config.config.defaultEvmRpcProviderType : RpcProviderType.ALCHEMY;
+        // const solanaProvider = config.config.defaultSolRpcProviderType ? config.config.defaultSolRpcProviderType : RpcProviderType.ALCHEMY;
+        // const tronProvider = config.config.defaultTronRpcProviderType ? config.config.defaultTronRpcProviderType : RpcProviderType.ALCHEMY;
+        // this.updateDefault(BLOCKCHAINS.EVM, evmProvider);
+        // this.updateDefault(BLOCKCHAINS.SOLANA, solanaProvider);
+        // this.updateDefault(BLOCKCHAINS.TRON, tronProvider);
+    }
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new RPC();
+        }
+        return this.instance;
+    }
+    initialize(config) {
+        var _a, _b, _c;
+        if (this.initialized)
+            throw new Error(`RPC provider manager is already initialized. Use 'updateDefault' instead.`);
+        const evmProvider = ((_a = config === null || config === void 0 ? void 0 : config.config) === null || _a === void 0 ? void 0 : _a.defaultEvmRpcProviderType) ? config.config.defaultEvmRpcProviderType : Provider_1.RpcProviderType.ALCHEMY;
+        const solanaProvider = ((_b = config === null || config === void 0 ? void 0 : config.config) === null || _b === void 0 ? void 0 : _b.defaultSolRpcProviderType) ? config.config.defaultSolRpcProviderType : Provider_1.RpcProviderType.ALCHEMY;
+        const tronProvider = ((_c = config === null || config === void 0 ? void 0 : config.config) === null || _c === void 0 ? void 0 : _c.defaultTronRpcProviderType) ? config.config.defaultTronRpcProviderType : Provider_1.RpcProviderType.ALCHEMY;
+        this.updateDefault(constants_1.BLOCKCHAINS.EVM, evmProvider);
+        this.updateDefault(constants_1.BLOCKCHAINS.SOLANA, solanaProvider);
+        this.updateDefault(constants_1.BLOCKCHAINS.TRON, tronProvider);
+        this.initialized = true;
+    }
+    updateDefault(blockchainType, targetProvider) {
+        this.currentProvider.set(blockchainType, targetProvider);
+    }
+    getCurrentDefault(blockchainType) {
+        if (!this.initialized)
+            throw new Error(`RPC provider manager is not initialized`);
+        const current = this.currentProvider.get(blockchainType);
+        if (!current)
+            throw new Error(`RPC provider manager is not initialized`);
+        return current;
+    }
+}
+exports.default = RPC;

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

@@ -2,9 +2,16 @@ import { Connection, Keypair, PublicKey } from "@solana/web3.js";
 import * as anchor from "@coral-xyz/anchor";
 import { Escrow } from "./types/escrow";
 import { BatchReceiver, SignAllTransactionsInterface, SignTransactionInterface } from "./types/types";
+import { ChainId } from "../../../interfaces";
 interface AdditionalConstructorParams {
     signer_keypair?: Keypair;
     localnet: boolean;
+    /**
+     * Address Lookup Table holding the batch path's static accounts. Supply it to send v0
+     * transactions, which is required for batches carrying more than two treasury signatures.
+     * Create it once with `create_lookup_table` and persist the returned address.
+     */
+    lookup_table_address?: string;
 }
 declare class SolanaEscrowAdmin {
     provider: anchor.AnchorProvider;
@@ -81,7 +88,40 @@ declare class SolanaEscrowAdmin {
      * @returns string - transaction signature
      */
     set_pause_state: (target_state: boolean) => Promise<string>;
-    withdraw_batch: (token_address: string, receivers: BatchReceiver[]) => Promise<string>;
+    withdraw_batch: (chain_id: ChainId, token_address: string, receivers: BatchReceiver[]) => Promise<string>;
+    /**
+     * Executes previously-scheduled (timelocked) withdrawals whose delay has elapsed. Amounts and
+     * recipients are read from each on-chain commitment, so only request ids + recipients are passed.
+     */
+    batch_execute_withdrawal: (chain_id: ChainId, token_address: string, receivers: Array<{
+        request_id: number;
+        receiver_pubkey: PublicKey | string;
+    }>) => Promise<string>;
+    /** Simulate a batch withdraw (schedule/immediate) to detect requests that would revert. */
+    simulate_withdraw_batch: (chain_id: ChainId, token_address: string, receivers: BatchReceiver[]) => Promise<{
+        ok: boolean;
+        error: string | null;
+    }>;
+    /** Simulate a batch execute to detect requests that would revert (timelock, already executed). */
+    simulate_batch_execute_withdrawal: (chain_id: ChainId, token_address: string, receivers: Array<{
+        request_id: number;
+        receiver_pubkey: PublicKey | string;
+    }>) => Promise<{
+        ok: boolean;
+        error: string | null;
+    }>;
+    /**
+     * Idempotently ensures the batch path's Address Lookup Table exists and covers `mints`.
+     * Safe to call on every startup: it discovers an existing table on-chain, extends it when
+     * addresses are missing, and only creates one when none exists. Returns the address, or null
+     * when provisioning failed (callers then run on legacy transactions).
+     *
+     * `withdraw_batch` calls this automatically for signature-carrying batches, so wiring it into
+     * startup is about observability and warming, not correctness.
+     */
+    ensure_lookup_table: (mints: string[]) => Promise<string>;
+    /** @deprecated prefer `ensure_lookup_table` — this throws instead of degrading gracefully. */
+    create_lookup_table: (mints: string[]) => Promise<string>;
     /**
      *
      * @param token_address Address of the token to withdraw

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

@@ -1 +1 @@
-{"version":3,"file":"SolanaEscrowAdmin.d.ts","sourceRoot":"","sources":["../../../../src/services/solana/escrow/SolanaEscrowAdmin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAqC,MAAM,iBAAiB,CAAC;AAEpG,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAkBtG,UAAU,2BAA2B;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,cAAM,iBAAiB;IACZ,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAU;IAClB,UAAU,EAAE,UAAU,CAAC;gBAG1B,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,SAAS,EAC1B,eAAe,EAAE,wBAAwB,EACzC,mBAAmB,EAAE,4BAA4B,EACjD,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,2BAA2B,EAC9C,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;IAkCvC;;;OAGG;IACH,OAAO,CAAC,OAAO,CAGb;IAEF;;;OAGG;IACI,kBAAkB,wBAGvB;IAKF;;;OAGG;IACI,SAAS,yBAEf;IAED;;;;OAIG;IACI,QAAQ,GAAU,gBAAgB,MAAM,sBAE9C;IAED;;;;OAIG;IACI,gBAAgB,GAAU,eAAe,MAAM,sBAErD;IAEM,YAAY,oCAElB;IAGD;;;OAGG;IACI,kBAAkB,0BAExB;IAED;;;OAGG;IACI,UAAU,0BAEhB;IAED;;;;OAIG;IACI,iBAAiB,GAAU,eAAe,MAAM,qBAEtD;IAED;;;;OAIG;IACI,oBAAoB,GAAU,eAAe,MAAM,qBAEzD;IAED;;;;OAIG;IACI,SAAS,GAAU,gBAAgB,MAAM,qBAE/C;IAGD;;;;OAIG;IACI,YAAY,GAAU,gBAAgB,MAAM,qBAElD;IAED;;;;OAIG;IACI,eAAe,GAAU,cAAc,OAAO,qBAEpD;IAIM,cAAc,GAAU,eAAe,MAAM,EAAE,WAAW,aAAa,EAAE,qBAE/E;IAGD;;;;;;OAMG;IACI,QAAQ,GAAU,eAAe,MAAM,EAAE,oBAAoB,MAAM,EAAE,kBAAkB,MAAM,iCAEnG;IAED;;;;;OAKG;IACI,OAAO,GAAU,eAAe,MAAM,EAAE,oBAAoB,MAAM,qBAExE;CAKJ;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"SolanaEscrowAdmin.d.ts","sourceRoot":"","sources":["../../../../src/services/solana/escrow/SolanaEscrowAdmin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAqC,MAAM,iBAAiB,CAAC;AAEpG,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAkB9C,UAAU,2BAA2B;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,cAAM,iBAAiB;IACZ,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAU;IAClB,UAAU,EAAE,UAAU,CAAC;gBAG1B,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,SAAS,EAC1B,eAAe,EAAE,wBAAwB,EACzC,mBAAmB,EAAE,4BAA4B,EACjD,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,2BAA2B,EAC9C,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;IAkCvC;;;OAGG;IACH,OAAO,CAAC,OAAO,CAGb;IAEF;;;OAGG;IACI,kBAAkB,wBAGvB;IAKF;;;OAGG;IACI,SAAS,yBAEf;IAED;;;;OAIG;IACI,QAAQ,GAAU,gBAAgB,MAAM,sBAE9C;IAED;;;;OAIG;IACI,gBAAgB,GAAU,eAAe,MAAM,sBAErD;IAEM,YAAY,oCAElB;IAGD;;;OAGG;IACI,kBAAkB,0BAExB;IAED;;;OAGG;IACI,UAAU,0BAEhB;IAED;;;;OAIG;IACI,iBAAiB,GAAU,eAAe,MAAM,qBAEtD;IAED;;;;OAIG;IACI,oBAAoB,GAAU,eAAe,MAAM,qBAEzD;IAED;;;;OAIG;IACI,SAAS,GAAU,gBAAgB,MAAM,qBAE/C;IAGD;;;;OAIG;IACI,YAAY,GAAU,gBAAgB,MAAM,qBAElD;IAED;;;;OAIG;IACI,eAAe,GAAU,cAAc,OAAO,qBAEpD;IAIM,cAAc,GAAU,UAAU,OAAO,EAAE,eAAe,MAAM,EAAE,WAAW,aAAa,EAAE,qBAElG;IAED;;;OAGG;IACI,wBAAwB,GAC3B,UAAU,OAAO,EACjB,eAAe,MAAM,EACrB,WAAW,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAA;KAAE,CAAC,qBAGhF;IAED,2FAA2F;IACpF,uBAAuB,GAAU,UAAU,OAAO,EAAE,eAAe,MAAM,EAAE,WAAW,aAAa,EAAE;;;OAE3G;IAED,kGAAkG;IAC3F,iCAAiC,GACpC,UAAU,OAAO,EACjB,eAAe,MAAM,EACrB,WAAW,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAA;KAAE,CAAC;;;OAGhF;IAED;;;;;;;;OAQG;IACI,mBAAmB,GAAU,OAAO,MAAM,EAAE,qBAGlD;IAED,8FAA8F;IACvF,mBAAmB,GAAU,OAAO,MAAM,EAAE,qBAElD;IAGD;;;;;;OAMG;IACI,QAAQ,GAAU,eAAe,MAAM,EAAE,oBAAoB,MAAM,EAAE,kBAAkB,MAAM,iCAEnG;IAED;;;;;OAKG;IACI,OAAO,GAAU,eAAe,MAAM,EAAE,oBAAoB,MAAM,qBAExE;CAKJ;AAED,eAAe,iBAAiB,CAAC"}

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

@@ -162,8 +162,40 @@ class SolanaEscrowAdmin {
         this.set_pause_state = (target_state) => __awaiter(this, void 0, void 0, function* () {
             return this.adminUtility.set_pause_state(target_state, this.signer);
         });
-        this.withdraw_batch = (token_address, receivers) => __awaiter(this, void 0, void 0, function* () {
-            return this.adminUtility.withdraw_batch(token_address, receivers, this.signer);
+        this.withdraw_batch = (chain_id, token_address, receivers) => __awaiter(this, void 0, void 0, function* () {
+            return this.adminUtility.withdraw_batch(chain_id, token_address, receivers, this.signer);
+        });
+        /**
+         * Executes previously-scheduled (timelocked) withdrawals whose delay has elapsed. Amounts and
+         * recipients are read from each on-chain commitment, so only request ids + recipients are passed.
+         */
+        this.batch_execute_withdrawal = (chain_id, token_address, receivers) => __awaiter(this, void 0, void 0, function* () {
+            return this.adminUtility.batch_execute_withdrawal(chain_id, token_address, receivers, this.signer);
+        });
+        /** Simulate a batch withdraw (schedule/immediate) to detect requests that would revert. */
+        this.simulate_withdraw_batch = (chain_id, token_address, receivers) => __awaiter(this, void 0, void 0, function* () {
+            return this.adminUtility.simulate_withdraw_batch(chain_id, token_address, receivers);
+        });
+        /** Simulate a batch execute to detect requests that would revert (timelock, already executed). */
+        this.simulate_batch_execute_withdrawal = (chain_id, token_address, receivers) => __awaiter(this, void 0, void 0, function* () {
+            return this.adminUtility.simulate_batch_execute_withdrawal(chain_id, token_address, receivers);
+        });
+        /**
+         * Idempotently ensures the batch path's Address Lookup Table exists and covers `mints`.
+         * Safe to call on every startup: it discovers an existing table on-chain, extends it when
+         * addresses are missing, and only creates one when none exists. Returns the address, or null
+         * when provisioning failed (callers then run on legacy transactions).
+         *
+         * `withdraw_batch` calls this automatically for signature-carrying batches, so wiring it into
+         * startup is about observability and warming, not correctness.
+         */
+        this.ensure_lookup_table = (mints) => __awaiter(this, void 0, void 0, function* () {
+            const table = yield this.adminUtility.ensure_lookup_table(mints, this.signer);
+            return table.toBase58();
+        });
+        /** @deprecated prefer `ensure_lookup_table` — this throws instead of degrading gracefully. */
+        this.create_lookup_table = (mints) => __awaiter(this, void 0, void 0, function* () {
+            return this.adminUtility.create_lookup_table(mints, this.signer);
         });
         /**
          *
@@ -205,7 +237,7 @@ class SolanaEscrowAdmin {
         const program = new anchor.Program(target_idl, provider);
         this.program = program;
         this.provider = provider;
-        this.adminUtility = EscrowAdminUtility_1.default.createWithCustomProgramId(provider, new web3_js_1.PublicKey(escrowAddress), this.get_idl());
+        this.adminUtility = EscrowAdminUtility_1.default.createWithCustomProgramId(provider, new web3_js_1.PublicKey(escrowAddress), this.get_idl(), additionalParams === null || additionalParams === void 0 ? void 0 : additionalParams.lookup_table_address);
         if (additionalParams === null || additionalParams === void 0 ? void 0 : additionalParams.signer_keypair)
             this.signer = additionalParams.signer_keypair;
     }