@ercworldio/blockchain-shared 1.0.5-dev.7-PROJ-1469.9 → 1.0.5-dev.7-PROJ-1469.10

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

@@ -6,6 +6,12 @@ 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;
@@ -83,6 +89,18 @@ declare class SolanaEscrowAdmin {
      */
     set_pause_state: (target_state: boolean) => Promise<string>;
     withdraw_batch: (chain_id: ChainId, token_address: string, receivers: BatchReceiver[]) => Promise<string>;
+    /**
+     * 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 | null>;
+    /** @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;AACtG,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAkB9C,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,UAAU,OAAO,EAAE,eAAe,MAAM,EAAE,WAAW,aAAa,EAAE,qBAElG;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;;;;;;;;OAQG;IACI,mBAAmB,GAAU,OAAO,MAAM,EAAE,4BAGlD;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

@@ -165,6 +165,23 @@ class SolanaEscrowAdmin {
         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);
         });
+        /**
+         * 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 ? table.toBase58() : null;
+        });
+        /** @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);
+        });
         /**
          *
          * @param token_address Address of the token to withdraw
@@ -205,7 +222,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;
     }

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

@@ -7,7 +7,43 @@ import { ChainId } from "../../../../interfaces";
 export declare class EscrowAdminUtility {
     program: Program<Escrow>;
     provider: anchor.AnchorProvider;
-    constructor(program: Program<Escrow>, provider: anchor.AnchorProvider);
+    /**
+     * Optional Address Lookup Table. When set, transactions are sent as v0 and the batch path's
+     * ~11 static accounts collapse from 32 bytes each to a 1-byte index — roughly 300 bytes back,
+     * which is what makes >2 treasury signatures fit under the 1232-byte limit.
+     */
+    private lookupTableAddress?;
+    private lookupTableCache?;
+    constructor(program: Program<Escrow>, provider: anchor.AnchorProvider, lookupTableAddress?: string);
+    /** Accounts that are identical on every batch withdrawal — the ALT payload. */
+    lookup_table_addresses(mints: string[]): PublicKey[];
+    /**
+     * Idempotently guarantees a lookup table covering `mints` exists and is usable.
+     *
+     * Deliberately keeps no external state: tables are discovered on-chain by their authority
+     * (the funding wallet), so there is nothing to persist, migrate, or keep in sync across
+     * environments and worker instances. Extends a table that is missing addresses, creates one
+     * when none exists, and returns the usable address.
+     *
+     * Returns null if provisioning fails — the lookup table is an optimisation, so callers fall
+     * back to legacy transactions rather than failing a withdrawal that would otherwise succeed.
+     */
+    ensure_lookup_table(mints: string[], signer?: Keypair): Promise<PublicKey | null>;
+    /** Back-compat wrapper for explicit one-time provisioning; prefer `ensure_lookup_table`. */
+    create_lookup_table(mints: string[], signer?: Keypair): Promise<string>;
+    private fetchLookupTable;
+    /**
+     * Finds a live table already owned by this authority. `getProgramAccounts` is filtered
+     * server-side on the authority pubkey, which sits at a fixed offset in the table header:
+     * u32 typeIndex + u64 deactivationSlot + u64 lastExtendedSlot + u8 startIndex + u8 option tag.
+     */
+    private discoverLookupTable;
+    private missingAddresses;
+    private createLookupTable;
+    private extendLookupTable;
+    private waitForLookupTableActivation;
+    /** Resolves (and caches) the configured lookup table; [] when none is set or it's missing. */
+    private resolveLookupTables;
     /**
      * Check if the escrow program is paused or running
      * @returns true/false. True: program is paused. False: Program is running
@@ -111,6 +147,8 @@ export declare class EscrowAdminUtility {
     getVaultBalance(): Promise<number>;
     getVaultTokenBalance(mint: PublicKey): Promise<number>;
     private sendTransaction;
+    private sendVersionedTransaction;
+    private sendLegacyTransaction;
     confirmTransaction(signature: string, commitment?: Commitment): Promise<void>;
     waitForConfirmation(signature: TransactionSignature, commitment?: 'confirmed' | 'finalized', timeoutMs?: number): Promise<void>;
     /**
@@ -127,7 +165,7 @@ export declare class EscrowAdminUtility {
      * @param idl IDL file - Escrow program idl
      * @returns
      */
-    static createWithCustomProgramId(provider: anchor.AnchorProvider, programId: PublicKey, idl: anchor.Idl): EscrowAdminUtility;
+    static createWithCustomProgramId(provider: anchor.AnchorProvider, programId: PublicKey, idl: anchor.Idl, lookupTableAddress?: string): EscrowAdminUtility;
 }
 export default EscrowAdminUtility;
 //# sourceMappingURL=EscrowAdminUtility.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EscrowAdminUtility.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/EscrowAdminUtility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EscrowAdminUtility.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/EscrowAdminUtility.ts"],"names":[],"mappings":"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"}

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

@@ -58,9 +58,181 @@ const TokenAccountService_1 = require("./TokenAccountService");
 const SolanaTokenProgramCache_1 = require("./SolanaTokenProgramCache");
 const TreasuryWithdrawalSignature_1 = require("./TreasuryWithdrawalSignature");
 class EscrowAdminUtility {
-    constructor(program, provider) {
+    constructor(program, provider, lookupTableAddress) {
         this.program = program;
         this.provider = provider;
+        if (lookupTableAddress)
+            this.lookupTableAddress = new web3_js_1.PublicKey(lookupTableAddress);
+    }
+    /** Accounts that are identical on every batch withdrawal — the ALT payload. */
+    lookup_table_addresses(mints) {
+        const programId = this.program.programId;
+        const global = [
+            EscrowService.findEscrowConfigPda(programId),
+            EscrowService.findVaultAuthorityPda(programId),
+            web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("treasury-config")], programId)[0],
+            web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("timelock-config")], programId)[0],
+            spl_token_1.TOKEN_PROGRAM_ID,
+            web3_js_1.SystemProgram.programId,
+            web3_js_1.SYSVAR_INSTRUCTIONS_PUBKEY,
+        ];
+        const perMint = mints.flatMap(m => {
+            const mint = new web3_js_1.PublicKey(m);
+            return [
+                mint,
+                EscrowService.findVaultAta(mint, programId),
+                web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("token-threshold"), mint.toBytes()], programId)[0],
+                web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("token-timelock"), mint.toBytes()], programId)[0],
+            ];
+        });
+        return [...global, ...perMint];
+    }
+    /**
+     * Idempotently guarantees a lookup table covering `mints` exists and is usable.
+     *
+     * Deliberately keeps no external state: tables are discovered on-chain by their authority
+     * (the funding wallet), so there is nothing to persist, migrate, or keep in sync across
+     * environments and worker instances. Extends a table that is missing addresses, creates one
+     * when none exists, and returns the usable address.
+     *
+     * Returns null if provisioning fails — the lookup table is an optimisation, so callers fall
+     * back to legacy transactions rather than failing a withdrawal that would otherwise succeed.
+     */
+    ensure_lookup_table(mints, signer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const required = this.lookup_table_addresses(mints);
+                const existing = this.lookupTableAddress
+                    ? yield this.fetchLookupTable(this.lookupTableAddress)
+                    : yield this.discoverLookupTable();
+                if (existing) {
+                    const missing = this.missingAddresses(existing.state.addresses, required);
+                    if (missing.length)
+                        yield this.extendLookupTable(existing.key, missing, signer);
+                    this.lookupTableAddress = existing.key;
+                    this.lookupTableCache = undefined;
+                    return existing.key;
+                }
+                const table = yield this.createLookupTable(required, signer);
+                this.lookupTableAddress = table;
+                this.lookupTableCache = undefined;
+                return table;
+            }
+            catch (error) {
+                return null;
+            }
+        });
+    }
+    /** Back-compat wrapper for explicit one-time provisioning; prefer `ensure_lookup_table`. */
+    create_lookup_table(mints, signer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const table = yield this.ensure_lookup_table(mints, signer);
+            if (!table)
+                throw new Error("Failed to provision the escrow lookup table");
+            return table.toBase58();
+        });
+    }
+    fetchLookupTable(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { value } = yield this.provider.connection.getAddressLookupTable(key);
+            return value ? { key, state: value.state } : null;
+        });
+    }
+    /**
+     * Finds a live table already owned by this authority. `getProgramAccounts` is filtered
+     * server-side on the authority pubkey, which sits at a fixed offset in the table header:
+     * u32 typeIndex + u64 deactivationSlot + u64 lastExtendedSlot + u8 startIndex + u8 option tag.
+     */
+    discoverLookupTable() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const AUTHORITY_OFFSET = 22;
+            const authority = this.provider.wallet.publicKey;
+            const accounts = yield this.provider.connection.getProgramAccounts(web3_js_1.AddressLookupTableProgram.programId, { filters: [{ memcmp: { offset: AUTHORITY_OFFSET, bytes: authority.toBase58() } }] });
+            const live = accounts
+                .map(a => {
+                try {
+                    return { key: a.pubkey, state: web3_js_1.AddressLookupTableAccount.deserialize(a.account.data) };
+                }
+                catch (_a) {
+                    return null;
+                }
+            })
+                .filter((t) => t !== null)
+                // A deactivated table cannot be used; MAX u64 means "never deactivated".
+                .filter(t => t.state.deactivationSlot === BigInt("18446744073709551615"));
+            if (!live.length)
+                return null;
+            // Prefer the most complete table so repeated runs converge on one.
+            return live.sort((a, b) => b.state.addresses.length - a.state.addresses.length)[0];
+        });
+    }
+    missingAddresses(present, required) {
+        const have = new Set(present.map(a => a.toBase58()));
+        const seen = new Set();
+        return required.filter(a => {
+            const k = a.toBase58();
+            if (have.has(k) || seen.has(k))
+                return false;
+            seen.add(k);
+            return true;
+        });
+    }
+    createLookupTable(addresses, signer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const authority = this.provider.wallet.publicKey;
+            const slot = yield this.provider.connection.getSlot("finalized");
+            const [createIx, table] = web3_js_1.AddressLookupTableProgram.createLookupTable({
+                authority, payer: authority, recentSlot: slot,
+            });
+            yield this.sendLegacyTransaction([createIx], signer);
+            yield this.extendLookupTable(table, addresses, signer);
+            return table;
+        });
+    }
+    extendLookupTable(table, addresses, signer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const authority = this.provider.wallet.publicKey;
+            // Chunked so the extend instruction itself stays under the transaction size limit.
+            for (let i = 0; i < addresses.length; i += 20) {
+                yield this.sendLegacyTransaction([
+                    web3_js_1.AddressLookupTableProgram.extendLookupTable({
+                        payer: authority, authority, lookupTable: table, addresses: addresses.slice(i, i + 20),
+                    }),
+                ], signer);
+            }
+            // A table is only usable from the slot after it was written; wait so the first v0
+            // transaction referencing it can actually resolve the accounts.
+            yield this.waitForLookupTableActivation(table);
+        });
+    }
+    waitForLookupTableActivation(table_1) {
+        return __awaiter(this, arguments, void 0, function* (table, timeoutMs = 30000) {
+            const startSlot = yield this.provider.connection.getSlot("confirmed");
+            const deadline = Date.now() + timeoutMs;
+            while (Date.now() < deadline) {
+                const [{ value }, slot] = yield Promise.all([
+                    this.provider.connection.getAddressLookupTable(table),
+                    this.provider.connection.getSlot("confirmed"),
+                ]);
+                if (value && slot > startSlot)
+                    return;
+                yield new Promise(r => setTimeout(r, 1000));
+            }
+        });
+    }
+    /** Resolves (and caches) the configured lookup table; [] when none is set or it's missing. */
+    resolveLookupTables() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.lookupTableAddress)
+                return [];
+            if (this.lookupTableCache)
+                return [this.lookupTableCache];
+            const { value } = yield this.provider.connection.getAddressLookupTable(this.lookupTableAddress);
+            if (!value)
+                return [];
+            this.lookupTableCache = value;
+            return [value];
+        });
     }
     // ==========================
     // Admin View Methods
@@ -368,6 +540,13 @@ class EscrowAdminUtility {
     withdraw_batch(chain_id, token_address, recipients, signer) {
         return __awaiter(this, void 0, void 0, function* () {
             const token_pubkey = new web3_js_1.PublicKey(token_address);
+            // A batch carrying treasury signatures only fits in 1232 bytes as a v0 transaction, so make
+            // sure the lookup table exists before building it. This is idempotent and self-healing: the
+            // first signature-gated withdrawal provisions the table, every later one reuses it, and a
+            // failure here simply leaves us on legacy transactions rather than blocking the withdrawal.
+            if (recipients.some(r => { var _a; return (_a = r.signatures) === null || _a === void 0 ? void 0 : _a.length; })) {
+                yield this.ensure_lookup_table([token_address], signer);
+            }
             switch (token_pubkey.toBase58()) {
                 case (web3_js_1.SystemProgram.programId.toBase58()):
                     return this.batch_withdraw_sol(chain_id, recipients, signer);
@@ -623,29 +802,59 @@ class EscrowAdminUtility {
     sendTransaction(ixs, signer) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const tx = new web3_js_1.Transaction();
-                for (let ix of ixs) {
-                    tx.add(ix);
-                }
-                tx.feePayer = this.provider.wallet.publicKey;
-                tx.recentBlockhash = (yield this.provider.connection.getLatestBlockhash()).blockhash;
-                let signature = "";
-                if (signer) {
-                    tx.sign(signer);
-                    signature = yield this.provider.connection.sendRawTransaction(tx.serialize());
-                    yield (0, TransactionsService_1.waitForTransactionConfirmation)(this.provider, signature, "confirmed");
+                // Prefer a v0 transaction when a lookup table is configured — it is the only way a
+                // batch carrying more than two treasury signatures fits in 1232 bytes.
+                const lookupTables = yield this.resolveLookupTables();
+                if (lookupTables.length) {
+                    return yield this.sendVersionedTransaction(ixs, lookupTables, signer);
                 }
-                else {
-                    signature = yield this.provider.sendAndConfirm(tx);
-                    yield (0, TransactionsService_1.waitForTransactionConfirmation)(this.provider, signature, "confirmed");
-                }
-                return signature;
+                return yield this.sendLegacyTransaction(ixs, signer);
             }
             catch (error) {
                 throw Errors_1.default.decode(error);
             }
         });
     }
+    sendVersionedTransaction(ixs, lookupTables, signer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const message = new web3_js_1.TransactionMessage({
+                payerKey: this.provider.wallet.publicKey,
+                recentBlockhash: (yield this.provider.connection.getLatestBlockhash()).blockhash,
+                instructions: ixs,
+            }).compileToV0Message(lookupTables);
+            const tx = new web3_js_1.VersionedTransaction(message);
+            if (signer) {
+                tx.sign([signer]);
+            }
+            else {
+                yield this.provider.wallet.signTransaction(tx);
+            }
+            const signature = yield this.provider.connection.sendRawTransaction(tx.serialize());
+            yield (0, TransactionsService_1.waitForTransactionConfirmation)(this.provider, signature, "confirmed");
+            return signature;
+        });
+    }
+    sendLegacyTransaction(ixs, signer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const tx = new web3_js_1.Transaction();
+            for (let ix of ixs) {
+                tx.add(ix);
+            }
+            tx.feePayer = this.provider.wallet.publicKey;
+            tx.recentBlockhash = (yield this.provider.connection.getLatestBlockhash()).blockhash;
+            let signature = "";
+            if (signer) {
+                tx.sign(signer);
+                signature = yield this.provider.connection.sendRawTransaction(tx.serialize());
+                yield (0, TransactionsService_1.waitForTransactionConfirmation)(this.provider, signature, "confirmed");
+            }
+            else {
+                signature = yield this.provider.sendAndConfirm(tx);
+                yield (0, TransactionsService_1.waitForTransactionConfirmation)(this.provider, signature, "confirmed");
+            }
+            return signature;
+        });
+    }
     confirmTransaction(signature_1) {
         return __awaiter(this, arguments, void 0, function* (signature, commitment = "finalized") {
             yield this.provider.connection.confirmTransaction(signature, commitment);
@@ -698,11 +907,11 @@ class EscrowAdminUtility {
      * @param idl IDL file - Escrow program idl
      * @returns
      */
-    static createWithCustomProgramId(provider, programId, idl) {
+    static createWithCustomProgramId(provider, programId, idl, lookupTableAddress) {
         // 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 EscrowAdminUtility(program, provider);
+        return new EscrowAdminUtility(program, provider, lookupTableAddress);
     }
 }
 exports.EscrowAdminUtility = EscrowAdminUtility;

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

@@ -48,6 +48,11 @@ export interface Ed25519Entry {
  * (each entry's pubkey, signature and message live in this instruction's own data). This is the
  * compact layout the program scans in `verify_treasury_threshold`; one instruction for the whole
  * batch keeps the transaction far smaller than one instruction per signature.
+ *
+ * Identical messages are stored ONCE and shared by every signature over them, since the offsets
+ * table lets multiple entries point at the same message region. This matters: the N signers who
+ * approve one withdrawal all sign the same ~194-byte payload, so without sharing, a 2-of-N
+ * approval would spend an extra ~194 bytes and overflow Solana's 1232-byte transaction limit.
  */
 export declare function buildTreasuryEd25519Instruction(entries: Ed25519Entry[]): TransactionInstruction;
 //# sourceMappingURL=TreasuryWithdrawalSignature.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TreasuryWithdrawalSignature.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/TreasuryWithdrawalSignature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGpF;;;;;GAKG;AAEH,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACnC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACnD,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAUT;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAU5D;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAmC/F"}
+{"version":3,"file":"TreasuryWithdrawalSignature.d.ts","sourceRoot":"","sources":["../../../../../src/services/solana/escrow/services/TreasuryWithdrawalSignature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGpF;;;;;GAKG;AAEH,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACnC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACnD,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAUT;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAU5D;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAoD/F"}

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

@@ -55,6 +55,11 @@ function decodeEd25519Signature(s) {
  * (each entry's pubkey, signature and message live in this instruction's own data). This is the
  * compact layout the program scans in `verify_treasury_threshold`; one instruction for the whole
  * batch keeps the transaction far smaller than one instruction per signature.
+ *
+ * Identical messages are stored ONCE and shared by every signature over them, since the offsets
+ * table lets multiple entries point at the same message region. This matters: the N signers who
+ * approve one withdrawal all sign the same ~194-byte payload, so without sharing, a 2-of-N
+ * approval would spend an extra ~194 bytes and overflow Solana's 1232-byte transaction limit.
  */
 function buildTreasuryEd25519Instruction(entries) {
     const N = entries.length;
@@ -62,28 +67,43 @@ function buildTreasuryEd25519Instruction(entries) {
     const ENTRY_SIZE = 32 + 64; // pubkey + signature
     const header = 2 + N * OFFSETS_SIZE;
     const msgStart = header + N * ENTRY_SIZE;
-    const totalMsg = entries.reduce((s, e) => s + e.message.length, 0);
-    const data = Buffer.alloc(msgStart + totalMsg);
+    // Deduplicate message blobs by content; remember where each unique one lands.
+    const uniqueMessages = [];
+    const messageOffsets = [];
+    const seen = new Map();
+    let cursor = msgStart;
+    for (const entry of entries) {
+        const key = Buffer.from(entry.message).toString("base64");
+        let offset = seen.get(key);
+        if (offset === undefined) {
+            offset = cursor;
+            seen.set(key, offset);
+            uniqueMessages.push(entry.message);
+            cursor += entry.message.length;
+        }
+        messageOffsets.push(offset);
+    }
+    const data = Buffer.alloc(cursor);
     data[0] = N; // number of signatures
     data[1] = 0; // padding
-    let msgCursor = msgStart;
     for (let i = 0; i < N; i++) {
         const base = 2 + i * OFFSETS_SIZE;
         const pkOffset = header + i * ENTRY_SIZE;
         const sigOffset = pkOffset + 32;
-        const msgOffset = msgCursor;
-        const msgLen = entries[i].message.length;
         data.writeUInt16LE(sigOffset, base + 0); // signature_offset
         data.writeUInt16LE(0xffff, base + 2); // signature_instruction_index (self)
         data.writeUInt16LE(pkOffset, base + 4); // public_key_offset
         data.writeUInt16LE(0xffff, base + 6); // public_key_instruction_index (self)
-        data.writeUInt16LE(msgOffset, base + 8); // message_data_offset
-        data.writeUInt16LE(msgLen, base + 10); // message_data_size
+        data.writeUInt16LE(messageOffsets[i], base + 8); // message_data_offset (may be shared)
+        data.writeUInt16LE(entries[i].message.length, base + 10); // message_data_size
         data.writeUInt16LE(0xffff, base + 12); // message_instruction_index (self)
         data.set(entries[i].publicKey, pkOffset);
         data.set(entries[i].signature, sigOffset);
-        data.set(entries[i].message, msgOffset);
-        msgCursor += msgLen;
+    }
+    // Write each unique message once, at the offset its first referrer recorded.
+    for (let i = 0, offset = msgStart; i < uniqueMessages.length; i++) {
+        data.set(uniqueMessages[i], offset);
+        offset += uniqueMessages[i].length;
     }
     return new web3_js_1.TransactionInstruction({ keys: [], programId: web3_js_1.Ed25519Program.programId, data });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ercworldio/blockchain-shared",
-  "version": "1.0.5-dev.7-PROJ-1469.9",
+  "version": "1.0.5-dev.7-PROJ-1469.10",
   "description": "Shared library for blockchain projects",
   "main": "build/index.js",
   "types": "build/index.d.ts",