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

package/build/services/db/timelock/ScheduleTransactionService.js

@@ -52,8 +52,123 @@ ScheduleTransactionService.get_and_lock_available_jobs = (pool_1, ...args_1) =>
       `, [limit, ttlSeconds, lock_metadata.lock_owner, lock_metadata.lock_reason]);
     return res.rows;
 });
-/** Locks and returns available jobs with full withdrawal details via DB function. */
+/** Locks and returns available jobs with full withdrawal details via inline SQL (bypasses DB function). */
 ScheduleTransactionService.get_and_lock_available_jobs_with_details = (pool_1, ...args_1) => __awaiter(void 0, [pool_1, ...args_1], void 0, function* (pool, limit = 10, job_ttl_s = 120, lock_metadata = { lock_owner: "schedule-tx-worker", lock_reason: "process_queued" }) {
+    var _b, _c;
+    const result = yield pool.query(`
+WITH status_ids AS (
+    SELECT
+        MAX(CASE WHEN status = 'queued'     THEN id END) AS queued_id,
+        MAX(CASE WHEN status = 'processing' THEN id END) AS processing_id
+    FROM multisig.schedule_job_statuses
+),
+candidates AS (
+    SELECT id
+    FROM multisig.schedule_transaction_jobs, status_ids
+    WHERE status_id = status_ids.queued_id
+      AND (lock_expires_at IS NULL OR lock_expires_at < NOW())
+    ORDER BY blockchain, chain_id ASC
+    LIMIT $1
+    FOR UPDATE SKIP LOCKED
+),
+updated AS (
+    UPDATE multisig.schedule_transaction_jobs j
+    SET status_id       = si.processing_id,
+        locked_at       = NOW(),
+        lock_expires_at = NOW() + ($2 || ' seconds')::INTERVAL,
+        batch_group_id  = gen_random_uuid(),
+        metadata        = jsonb_set(
+                            jsonb_set(
+                                COALESCE(j.metadata, '{}'::jsonb),
+                                '{lock_owner}', to_jsonb($3::text)
+                            ),
+                            '{lock_reason}', to_jsonb($4::text)
+                          ),
+        updated_at      = NOW()
+    FROM candidates c, status_ids si
+    WHERE j.id = c.id
+    RETURNING j.*
+)
+SELECT COALESCE(json_agg(json_build_object(
+    'id',             u.id,
+    'requestId',      u.request_id,
+    'operationType',  u.operation_type,
+    'status',         sjs.status,
+    'blockchain',     u.blockchain,
+    'chainId',        u.chain_id,
+    'batchGroupId',   u.batch_group_id,
+    'lockExpiresAt',  u.lock_expires_at,
+    'lockedAt',       u.locked_at,
+    'txHash',         u.tx_hash,
+    'sentAt',         u.sent_at,
+    'confirmedAt',    u.confirmed_at,
+    'retryCount',     u.retry_count,
+    'errorMessage',   u.error_message,
+    'lastErrorAt',    u.last_error_at,
+    'metadata',       u.metadata,
+    'createdAt',      u.created_at,
+    'updatedAt',      u.updated_at,
+    'withdrawalDetails', json_build_object(
+        'id',                    cw.id,
+        'userId',                cw.user_id,
+        'status',                LOWER(cws.status),
+        'blockchain',            LOWER(cwbt.blockchain),
+        'receiver',              cw.receiver_address,
+        'receiverAddress',       cw.receiver_address,
+        'paymentType',           LOWER(cwpt.type),
+        'chainId',               cw.chain_id,
+        'token',                 cw.token_address,
+        'amount',                cw.amount,
+        'amountInUsd',           cw.amount * cr.rate,
+        'destinationChainId',    cw.destination_chain_id,
+        'destinationToken',      cw.destination_token_address,
+        'destinationBlockchain', cw.destination_blockchain,
+        'sigsExecutiveRequired', cw.sigs_executive_required,
+        'sigsManagerRequired',   cw.sigs_manager_required,
+        'timeLockSeconds',       cw.timelock_seconds,
+        'multisigSignatures', (
+            SELECT COALESCE(json_agg(json_build_object(
+                'name',            COALESCE(role.role_alias, ''),
+                'signerAddress',   cs.signer_address,
+                'contractAddress', cs.contract_address,
+                'createdAt',       cs.created_at,
+                'updatedAt',       cs.updated_at,
+                'operationType',   cs.operation_type,
+                'v',               cs.v,
+                'r',               cs.r,
+                's',               cs.s,
+                'signature',       cs.signature
+            )), '[]'::json)
+            FROM multisig.crypto_signatures cs
+            LEFT JOIN multisig.crypto_escrow_roles cer
+                   ON LOWER(cer.wallet_address)   = LOWER(cs.signer_address)
+                  AND LOWER(cer.blockchain)        = LOWER(cs.blockchain)
+                  AND cer.chain_id                 = cs.chain_id
+                  AND LOWER(cer.contract_address)  = LOWER(cs.contract_address)
+            LEFT JOIN multisig.crypto_role role ON role.id = cer.role_id
+            WHERE cs.reference_id   = cw.id
+              AND cs.operation_type = 1
+              AND (
+                  (cs.v IS NOT NULL AND cs.r IS NOT NULL AND cs.s IS NOT NULL)
+                  OR cs.signature IS NOT NULL
+              )
+        )
+    )
+)), '[]'::json) AS result
+FROM updated u
+JOIN multisig.schedule_job_statuses                      sjs  ON sjs.id  = u.status_id
+JOIN accounting.crypto_withdrawals                       cw   ON cw.id   = u.request_id
+LEFT JOIN accounting.crypto_withdrawal_status            cws  ON cws.id  = cw.status_id
+LEFT JOIN accounting.crypto_withdrawal_blockchain_types  cwbt ON cwbt.id = cw.blockchain_id
+LEFT JOIN accounting.crypto_withdrawal_payment_types     cwpt ON cwpt.id = cw.payment_type_id
+LEFT JOIN usersmanagement.user_currency_mappings         ucm  ON ucm.currency_specific_user_id = cw.currency_specific_user_id
+LEFT JOIN public.currencies                              cur  ON cur.currencyid  = ucm.currency_id
+LEFT JOIN accounting.currencyrates                       cr   ON cr.symbol = UPPER(cur.currency_code || 'USD')
+            `, [limit, job_ttl_s, lock_metadata.lock_owner, lock_metadata.lock_reason]);
+    return (_c = (_b = result.rows[0]) === null || _b === void 0 ? void 0 : _b.result) !== null && _c !== void 0 ? _c : [];
+});
+/** Locks and returns available jobs with full withdrawal details via DB function. */
+ScheduleTransactionService.get_and_lock_available_jobs_with_details_depr = (pool_1, ...args_1) => __awaiter(void 0, [pool_1, ...args_1], void 0, function* (pool, limit = 10, job_ttl_s = 120, lock_metadata = { lock_owner: "schedule-tx-worker", lock_reason: "process_queued" }) {
     var _b;
     const result = yield pool.query(`SELECT multisig.fn_get_available_schedule_jobs_with_details($1::int, $2::int, $3::text, $4::text)`, [limit, job_ttl_s, lock_metadata.lock_owner, lock_metadata.lock_reason]);
     return (_b = result.rows[0].fn_get_available_schedule_jobs_with_details) !== null && _b !== void 0 ? _b : [];
@@ -209,4 +324,153 @@ ScheduleTransactionService.mark_complete = (pool, payloads) => __awaiter(void 0,
               AND t.operation_type = c.operation_type
         `, [requestIds, operationTypes]);
 });
+// ── BO read views ────────────────────────────────────────────────────────
+/**
+ * Paginated list of current schedule-transaction jobs, newest first, with the
+ * status resolved to text and (for withdrawal operation types) the receiver/token/
+ * amount joined in. All filters are optional and combine with AND.
+ */
+ScheduleTransactionService.list_jobs_paginated = (pool_1, page_1, ...args_1) => __awaiter(void 0, [pool_1, page_1, ...args_1], void 0, function* (pool, page, page_size = 20, filters = {}) {
+    var _b, _c;
+    if (page < 1)
+        page = 1;
+    const clauses = [];
+    const params = [];
+    let i = 1;
+    if (filters.status) {
+        clauses.push(`sjs.status = $${i++}`);
+        params.push(filters.status);
+    }
+    if (filters.blockchain) {
+        clauses.push(`j.blockchain = $${i++}`);
+        params.push(filters.blockchain);
+    }
+    if (filters.chainId) {
+        clauses.push(`j.chain_id = $${i++}`);
+        params.push(filters.chainId);
+    }
+    if (filters.operationType !== undefined) {
+        clauses.push(`j.operation_type = $${i++}`);
+        params.push(filters.operationType);
+    }
+    if (filters.requestId !== undefined) {
+        clauses.push(`j.request_id = $${i++}`);
+        params.push(filters.requestId);
+    }
+    if (filters.txHash) {
+        clauses.push(`j.tx_hash = $${i++}`);
+        params.push(filters.txHash);
+    }
+    const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
+    const countRes = yield pool.query(`SELECT COUNT(*)::bigint AS count
+             FROM multisig.schedule_transaction_jobs j
+             JOIN multisig.schedule_job_statuses sjs ON sjs.id = j.status_id
+             ${where}`, params);
+    const total_count = Number((_c = (_b = countRes.rows[0]) === null || _b === void 0 ? void 0 : _b.count) !== null && _c !== void 0 ? _c : 0);
+    const limitParam = i++;
+    const offsetParam = i++;
+    const rowsRes = yield pool.query(`SELECT
+                j.id,
+                j.request_id      AS "requestId",
+                j.operation_type  AS "operationType",
+                sjs.status        AS status,
+                j.blockchain,
+                j.chain_id        AS "chainId",
+                j.tx_hash         AS "txHash",
+                j.locked_at       AS "lockedAt",
+                j.lock_expires_at AS "lockExpiresAt",
+                j.sent_at         AS "sentAt",
+                j.confirmed_at    AS "confirmedAt",
+                j.retry_count     AS "retryCount",
+                j.error_message   AS "errorMessage",
+                j.last_error_at   AS "lastErrorAt",
+                j.metadata,
+                j.created_at      AS "createdAt",
+                j.updated_at      AS "updatedAt",
+                cw.receiver_address AS "receiverAddress",
+                cw.token_address    AS "tokenAddress",
+                cw.amount           AS "amount"
+             FROM multisig.schedule_transaction_jobs j
+             JOIN multisig.schedule_job_statuses sjs ON sjs.id = j.status_id
+             LEFT JOIN accounting.crypto_withdrawals cw
+                    ON cw.id = j.request_id AND j.operation_type IN (1, 3)
+             ${where}
+             ORDER BY j.created_at DESC
+             LIMIT $${limitParam} OFFSET $${offsetParam}`, [...params, page_size, (page - 1) * page_size]);
+    return {
+        total_count,
+        pages_count: Math.ceil(total_count / page_size),
+        current_page: page,
+        has_next: total_count > page * page_size,
+        items: rowsRes.rows
+    };
+});
+/**
+ * Paginated schedule-transaction job history (append-only status transitions),
+ * newest first. All filters are optional and combine with AND.
+ */
+ScheduleTransactionService.list_history_paginated = (pool_1, page_1, ...args_1) => __awaiter(void 0, [pool_1, page_1, ...args_1], void 0, function* (pool, page, page_size = 20, filters = {}) {
+    var _b, _c;
+    if (page < 1)
+        page = 1;
+    const clauses = [];
+    const params = [];
+    let i = 1;
+    if (filters.jobId !== undefined) {
+        clauses.push(`h.job_id = $${i++}`);
+        params.push(filters.jobId);
+    }
+    if (filters.requestId !== undefined) {
+        clauses.push(`h.request_id = $${i++}`);
+        params.push(filters.requestId);
+    }
+    if (filters.operationType !== undefined) {
+        clauses.push(`h.operation_type = $${i++}`);
+        params.push(filters.operationType);
+    }
+    if (filters.status) {
+        clauses.push(`sjs.status = $${i++}`);
+        params.push(filters.status);
+    }
+    if (filters.blockchain) {
+        clauses.push(`h.blockchain = $${i++}`);
+        params.push(filters.blockchain);
+    }
+    if (filters.chainId) {
+        clauses.push(`h.chain_id = $${i++}`);
+        params.push(filters.chainId);
+    }
+    const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
+    const countRes = yield pool.query(`SELECT COUNT(*)::bigint AS count
+             FROM multisig.schedule_transaction_jobs_history h
+             JOIN multisig.schedule_job_statuses sjs ON sjs.id = h.status_id
+             ${where}`, params);
+    const total_count = Number((_c = (_b = countRes.rows[0]) === null || _b === void 0 ? void 0 : _b.count) !== null && _c !== void 0 ? _c : 0);
+    const limitParam = i++;
+    const offsetParam = i++;
+    const rowsRes = yield pool.query(`SELECT
+                h.id,
+                h.job_id         AS "jobId",
+                h.request_id     AS "requestId",
+                h.operation_type AS "operationType",
+                sjs.status       AS status,
+                h.blockchain,
+                h.chain_id       AS "chainId",
+                h.tx_hash        AS "txHash",
+                h.retry_count    AS "retryCount",
+                h.error_message  AS "errorMessage",
+                h.created_at     AS "createdAt"
+             FROM multisig.schedule_transaction_jobs_history h
+             JOIN multisig.schedule_job_statuses sjs ON sjs.id = h.status_id
+             ${where}
+             ORDER BY h.created_at DESC
+             LIMIT $${limitParam} OFFSET $${offsetParam}`, [...params, page_size, (page - 1) * page_size]);
+    return {
+        total_count,
+        pages_count: Math.ceil(total_count / page_size),
+        current_page: page,
+        has_next: total_count > page * page_size,
+        items: rowsRes.rows
+    };
+});
 exports.default = ScheduleTransactionService;

package/build/services/rpc/RPC.d.ts

@@ -0,0 +1,20 @@
+import { BlockchainType } from "../../interfaces";
+import { RpcProviderType } from "../../chains/Provider";
+declare class RPC {
+    static instance: RPC;
+    private currentProvider;
+    initialized: boolean;
+    private constructor();
+    static getInstance(): RPC;
+    initialize(config: Partial<{
+        config: Partial<{
+            defaultEvmRpcProviderType: RpcProviderType;
+            defaultSolRpcProviderType: RpcProviderType;
+            defaultTronRpcProviderType: RpcProviderType;
+        }>;
+    }>): void;
+    updateDefault(blockchainType: BlockchainType, targetProvider: RpcProviderType): void;
+    getCurrentDefault(blockchainType: BlockchainType): RpcProviderType;
+}
+export default RPC;
+//# sourceMappingURL=RPC.d.ts.map

package/build/services/rpc/RPC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RPC.d.ts","sourceRoot":"","sources":["../../../src/services/rpc/RPC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD,cAAM,GAAG;IACL,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC;IACrB,OAAO,CAAC,eAAe,CAAuC;IACvD,WAAW,EAAE,OAAO,CAAS;IAEpC,OAAO;IAaP,MAAM,CAAC,WAAW;IAQlB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;YAAC,yBAAyB,EAAE,eAAe,CAAC;YAAC,yBAAyB,EAAE,eAAe,CAAC;YAAC,0BAA0B,EAAE,eAAe,CAAA;SAAC,CAAC,CAAA;KAAC,CAAC;IAcpL,aAAa,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe;IAI7E,iBAAiB,CAAC,cAAc,EAAE,cAAc;CAQnD;AAED,eAAe,GAAG,CAAC"}

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;
     }