@pushchain/core 5.1.16 → 5.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "5.1.16",
+  "version": "5.1.18",
   "homepage": "https://push.org",
   "keywords": [
     "pushchain",

package/src/lib/constants/index.d.ts

@@ -14,4 +14,4 @@ export declare const CONSTANTS: {
 };
 export type { TypedDataDomain, TypedData };
 export { CHAIN_EXPLORERS, CEA_FACTORY_ADDRESSES, UNIVERSAL_GATEWAY_ADDRESSES, VAULT_ADDRESSES, getExplorerTxUrl, getExplorerAddressUrl, } from './chain';
-export { MULTICALL_SELECTOR, UEA_MULTICALL_SELECTOR, MIGRATION_SELECTOR, TX_TYPE, ZERO_ADDRESS, DEFAULT_OUTBOUND_GAS_LIMIT, } from './selectors';
+export { MULTICALL_SELECTOR, UEA_MULTICALL_SELECTOR, MIGRATION_SELECTOR, TX_TYPE, ZERO_ADDRESS, DEFAULT_OUTBOUND_GAS_LIMIT, DEFAULT_CEA_TO_PUSH_GAS_LIMIT, } from './selectors';

package/src/lib/constants/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_OUTBOUND_GAS_LIMIT = exports.ZERO_ADDRESS = exports.TX_TYPE = exports.MIGRATION_SELECTOR = exports.UEA_MULTICALL_SELECTOR = exports.MULTICALL_SELECTOR = exports.getExplorerAddressUrl = exports.getExplorerTxUrl = exports.VAULT_ADDRESSES = exports.UNIVERSAL_GATEWAY_ADDRESSES = exports.CEA_FACTORY_ADDRESSES = exports.CHAIN_EXPLORERS = exports.CONSTANTS = void 0;
+exports.DEFAULT_CEA_TO_PUSH_GAS_LIMIT = exports.DEFAULT_OUTBOUND_GAS_LIMIT = exports.ZERO_ADDRESS = exports.TX_TYPE = exports.MIGRATION_SELECTOR = exports.UEA_MULTICALL_SELECTOR = exports.MULTICALL_SELECTOR = exports.getExplorerAddressUrl = exports.getExplorerTxUrl = exports.VAULT_ADDRESSES = exports.UNIVERSAL_GATEWAY_ADDRESSES = exports.CEA_FACTORY_ADDRESSES = exports.CHAIN_EXPLORERS = exports.CONSTANTS = void 0;
 const enums_1 = require("./enums");
 const tokens_1 = require("./tokens");
 // NOTE - Only include enums & constants which need to be exported to end user.
@@ -27,4 +27,5 @@ Object.defineProperty(exports, "MIGRATION_SELECTOR", { enumerable: true, get: fu
 Object.defineProperty(exports, "TX_TYPE", { enumerable: true, get: function () { return selectors_1.TX_TYPE; } });
 Object.defineProperty(exports, "ZERO_ADDRESS", { enumerable: true, get: function () { return selectors_1.ZERO_ADDRESS; } });
 Object.defineProperty(exports, "DEFAULT_OUTBOUND_GAS_LIMIT", { enumerable: true, get: function () { return selectors_1.DEFAULT_OUTBOUND_GAS_LIMIT; } });
+Object.defineProperty(exports, "DEFAULT_CEA_TO_PUSH_GAS_LIMIT", { enumerable: true, get: function () { return selectors_1.DEFAULT_CEA_TO_PUSH_GAS_LIMIT; } });
 //# sourceMappingURL=index.js.map

package/src/lib/constants/selectors.d.ts

@@ -40,3 +40,11 @@ export declare const ZERO_ADDRESS: "0x0000000000000000000000000000000000000000";
  * Default gas limit for outbound transactions
  */
 export declare const DEFAULT_OUTBOUND_GAS_LIMIT: bigint;
+/**
+ * Default gas limit for EVM Route 3 (CEA -> Push) source-chain execution.
+ *
+ * This path can deploy the CEA and then execute sendUniversalTxToUEA with a
+ * nested Push payload. Live Sepolia traces estimate ~540k gas for that shape,
+ * so the generic 500k outbound default is too tight.
+ */
+export declare const DEFAULT_CEA_TO_PUSH_GAS_LIMIT: bigint;

package/src/lib/constants/selectors.js

@@ -3,7 +3,7 @@
  * Function selectors and constants for multi-chain transactions
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_OUTBOUND_GAS_LIMIT = exports.ZERO_ADDRESS = exports.TX_TYPE = exports.MIGRATION_SELECTOR = exports.UEA_MULTICALL_SELECTOR = exports.MULTICALL_SELECTOR = void 0;
+exports.DEFAULT_CEA_TO_PUSH_GAS_LIMIT = exports.DEFAULT_OUTBOUND_GAS_LIMIT = exports.ZERO_ADDRESS = exports.TX_TYPE = exports.MIGRATION_SELECTOR = exports.UEA_MULTICALL_SELECTOR = exports.MULTICALL_SELECTOR = void 0;
 /**
  * MULTICALL_SELECTOR
  * Selector for CEA multicall execution
@@ -42,4 +42,12 @@ exports.ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
  * Default gas limit for outbound transactions
  */
 exports.DEFAULT_OUTBOUND_GAS_LIMIT = BigInt(500000);
+/**
+ * Default gas limit for EVM Route 3 (CEA -> Push) source-chain execution.
+ *
+ * This path can deploy the CEA and then execute sendUniversalTxToUEA with a
+ * nested Push payload. Live Sepolia traces estimate ~540k gas for that shape,
+ * so the generic 500k outbound default is too tight.
+ */
+exports.DEFAULT_CEA_TO_PUSH_GAS_LIMIT = BigInt(750000);
 //# sourceMappingURL=selectors.js.map

package/src/lib/formatters.d.ts

@@ -0,0 +1 @@
+export declare function formatPc(valueWei: bigint, precision?: number): string;

package/src/lib/formatters.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPc = formatPc;
+const PC_DECIMALS = 18;
+function formatTokenUnits(value, decimals, precision) {
+    if (!Number.isInteger(decimals) || decimals < 0) {
+        throw new Error('decimals must be a non-negative integer');
+    }
+    if (precision !== undefined &&
+        (!Number.isInteger(precision) || precision < 0)) {
+        throw new Error('precision must be a non-negative integer');
+    }
+    const negative = value < BigInt(0);
+    const absolute = negative ? -value : value;
+    let scale = BigInt(1);
+    for (let i = 0; i < decimals; i++) {
+        scale *= BigInt(10);
+    }
+    const whole = absolute / scale;
+    const remainder = absolute % scale;
+    let fraction = decimals > 0 ? remainder.toString().padStart(decimals, '0') : '';
+    if (precision !== undefined) {
+        fraction = fraction.slice(0, precision);
+    }
+    fraction = fraction.replace(/0+$/, '');
+    const sign = negative ? '-' : '';
+    return `${sign}${whole.toString()}${fraction ? `.${fraction}` : ''}`;
+}
+function formatPc(valueWei, precision) {
+    return `${formatTokenUnits(valueWei, PC_DECIMALS, precision)} PC`;
+}
+//# sourceMappingURL=formatters.js.map

package/src/lib/orchestrator/internals/cascade.d.ts

@@ -7,9 +7,11 @@
 import { TransactionRoute } from '../route-detector';
 import type { HopDescriptor, CascadeSegment, CascadeSegmentType, PreparedUniversalTx, CascadedTxResponse, CascadeHopInfo, UniversalTxResponse, UniversalExecuteParams, MultiCall, WaitForOutboundOptions, OutboundTxDetails } from '../orchestrator.types';
 import type { OrchestratorContext } from './context';
+import { type InboundPushTxDetails, type WaitForInboundOptions } from './inbound-tracker';
 export interface CascadeCallbacks {
     executeFn: (params: any) => Promise<UniversalTxResponse>;
     waitForOutboundTxFn: (hash: string, opts?: WaitForOutboundOptions) => Promise<OutboundTxDetails>;
+    waitForInboundPushTxFn?: (outboundExternalTxHash: string, sourceChain: string, opts?: WaitForInboundOptions) => Promise<InboundPushTxDetails>;
     waitForAllOutboundTxsFn: (hash: string, hops: CascadeHopInfo[], opts: any) => Promise<{
         success: boolean;
         failedAt?: number;
@@ -35,7 +37,12 @@ export declare function prepareTransaction(ctx: OrchestratorContext, params: Uni
 export declare function buildHopDescriptor(ctx: OrchestratorContext, params: UniversalExecuteParams, route: TransactionRoute, ueaAddress: `0x${string}`): Promise<HopDescriptor>;
 export declare function classifyIntoSegments(hops: HopDescriptor[]): CascadeSegment[];
 export declare function getSegmentType(route: string): CascadeSegmentType;
+export interface ComposeCascadeResult {
+    multicalls: MultiCall[];
+    requiredNativeValue: bigint;
+}
+export declare function composeCascadeDetailed(ctx: OrchestratorContext, segments: CascadeSegment[], ueaAddress: `0x${string}`, ueaBalance?: bigint, ueaNonce?: bigint): Promise<ComposeCascadeResult>;
 export declare function composeCascade(ctx: OrchestratorContext, segments: CascadeSegment[], ueaAddress: `0x${string}`, ueaBalance?: bigint, ueaNonce?: bigint): Promise<MultiCall[]>;
-export declare function createCascadedBuilder(ctx: OrchestratorContext, preparedTxs: PreparedUniversalTx[], callbacks: CascadeCallbacks): {
+export declare function createCascadedBuilder(ctx: OrchestratorContext, preparedTxs: PreparedUniversalTx[], callbacks: CascadeCallbacks, defaultEventHook?: (event: import('../../progress-hook/progress-hook.types').ProgressEvent) => void): {
     send: () => Promise<CascadedTxResponse>;
 };