@pushchain/core 6.0.26 → 6.0.27-alpha.1

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

@@ -1,10 +1,37 @@
 import { CHAIN, LIBRARY, PUSH_NETWORK } from './enums';
 import { TypedDataDomain, TypedData } from '../universal/signer/signer.types';
+import { WEB2_READ_CHAIN } from './read-state';
 import { UNIVERSAL_READ_STATUS, READ_STATUS, READ_ERROR_CODE, READ_OUTCOME } from '../read-state/read-state.types';
+/**
+ * `PushChain.CONSTANTS.READ.CHAIN` — every read source: all of `CHAIN` (same
+ * string values) plus the enumerable Web2 source. A superset of CHAIN, so
+ * `read({ chain: CHAIN.X })` keeps compiling.
+ */
+export declare const READ_CHAIN: Readonly<{ [K in keyof typeof CHAIN]: (typeof CHAIN)[K]; }> & {
+    readonly WEB2: typeof WEB2_READ_CHAIN;
+};
 /** `PushChain.CONSTANTS.READ` — cross-chain read state. Values verified against the deployed UniversalCallback. */
 export declare const READ_CONSTANTS: {
-    /** Read-only Web2 destination. Equivalent to `CHAIN.WEB2`. */
-    readonly WEB2: "web2:https";
+    /** Every read source, enumerable (spec page 5 §4). */
+    readonly CHAIN: Readonly<{
+        readonly PUSH_MAINNET: CHAIN.PUSH_MAINNET;
+        readonly PUSH_TESTNET: CHAIN.PUSH_TESTNET;
+        readonly PUSH_TESTNET_DONUT: CHAIN.PUSH_TESTNET;
+        readonly PUSH_LOCALNET: CHAIN.PUSH_LOCALNET;
+        readonly ETHEREUM_MAINNET: CHAIN.ETHEREUM_MAINNET;
+        readonly ETHEREUM_SEPOLIA: CHAIN.ETHEREUM_SEPOLIA;
+        readonly ARBITRUM_SEPOLIA: CHAIN.ARBITRUM_SEPOLIA;
+        readonly BASE_SEPOLIA: CHAIN.BASE_SEPOLIA;
+        readonly BNB_TESTNET: CHAIN.BNB_TESTNET;
+        readonly SOLANA_MAINNET: CHAIN.SOLANA_MAINNET;
+        readonly SOLANA_TESTNET: CHAIN.SOLANA_TESTNET;
+        readonly SOLANA_DEVNET: CHAIN.SOLANA_DEVNET;
+        readonly WEB2: "web2";
+    }> & {
+        readonly WEB2: typeof WEB2_READ_CHAIN;
+    };
+    /** @deprecated Use `READ.CHAIN.WEB2`. Same value (`'web2'`). */
+    readonly WEB2: "web2";
     readonly NAMESPACE: {
         readonly EVM: "eip155";
         readonly SVM: "solana";
@@ -39,8 +66,26 @@ export declare const CONSTANTS: {
         TOKEN: import("./tokens").PayableTokenConstantsMap;
     };
     READ: {
-        /** Read-only Web2 destination. Equivalent to `CHAIN.WEB2`. */
-        readonly WEB2: "web2:https";
+        /** Every read source, enumerable (spec page 5 §4). */
+        readonly CHAIN: Readonly<{
+            readonly PUSH_MAINNET: CHAIN.PUSH_MAINNET;
+            readonly PUSH_TESTNET: CHAIN.PUSH_TESTNET;
+            readonly PUSH_TESTNET_DONUT: CHAIN.PUSH_TESTNET;
+            readonly PUSH_LOCALNET: CHAIN.PUSH_LOCALNET;
+            readonly ETHEREUM_MAINNET: CHAIN.ETHEREUM_MAINNET;
+            readonly ETHEREUM_SEPOLIA: CHAIN.ETHEREUM_SEPOLIA;
+            readonly ARBITRUM_SEPOLIA: CHAIN.ARBITRUM_SEPOLIA;
+            readonly BASE_SEPOLIA: CHAIN.BASE_SEPOLIA;
+            readonly BNB_TESTNET: CHAIN.BNB_TESTNET;
+            readonly SOLANA_MAINNET: CHAIN.SOLANA_MAINNET;
+            readonly SOLANA_TESTNET: CHAIN.SOLANA_TESTNET;
+            readonly SOLANA_DEVNET: CHAIN.SOLANA_DEVNET;
+            readonly WEB2: "web2";
+        }> & {
+            readonly WEB2: typeof WEB2_READ_CHAIN;
+        };
+        /** @deprecated Use `READ.CHAIN.WEB2`. Same value (`'web2'`). */
+        readonly WEB2: "web2";
         readonly NAMESPACE: {
             readonly EVM: "eip155";
             readonly SVM: "solana";
@@ -63,6 +108,18 @@ export declare const CONSTANTS: {
         readonly ERROR_CODE: typeof READ_ERROR_CODE;
         readonly OUTCOME: typeof READ_OUTCOME;
     };
+    /** Checked v5 agentic wallet deployments by Push network (Donut only). */
+    AGENTIC: Readonly<{
+        WALLET: "agentic:wallet";
+        PRESETS: Readonly<{
+            CATEGORY: Readonly<{
+                DEXES: "DEXES";
+                LENDING: "LENDING";
+                STAKING: "STAKING";
+                PREDICTION: "PREDICTION";
+            }>;
+        }>;
+    }>;
 };
 export type { TypedDataDomain, TypedData };
 export { CHAIN_EXPLORERS, CEA_FACTORY_ADDRESSES, UNIVERSAL_GATEWAY_ADDRESSES, VAULT_ADDRESSES, getExplorerTxUrl, getExplorerAddressUrl, } from './chain';

package/src/lib/constants/index.js

@@ -1,16 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNIVERSAL_CALLBACK_ADDRESSES = exports.UNIVERSAL_CORE_ADDRESSES = 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 = exports.READ_CONSTANTS = void 0;
+exports.UNIVERSAL_CALLBACK_ADDRESSES = exports.UNIVERSAL_CORE_ADDRESSES = 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 = exports.READ_CONSTANTS = exports.READ_CHAIN = void 0;
 const tslib_1 = require("tslib");
 const enums_1 = require("./enums");
 const tokens_1 = require("./tokens");
 const chain_1 = require("./chain");
 const read_state_1 = require("./read-state");
 const read_state_types_1 = require("../read-state/read-state.types");
+const constants_1 = require("../agentic/constants");
+/**
+ * `PushChain.CONSTANTS.READ.CHAIN` — every read source: all of `CHAIN` (same
+ * string values) plus the enumerable Web2 source. A superset of CHAIN, so
+ * `read({ chain: CHAIN.X })` keeps compiling.
+ */
+exports.READ_CHAIN = Object.freeze({
+    ...enums_1.CHAIN,
+    WEB2: read_state_1.WEB2_READ_CHAIN,
+});
 /** `PushChain.CONSTANTS.READ` — cross-chain read state. Values verified against the deployed UniversalCallback. */
 exports.READ_CONSTANTS = {
-    /** Read-only Web2 destination. Equivalent to `CHAIN.WEB2`. */
-    WEB2: enums_1.CHAIN.WEB2,
+    /** Every read source, enumerable (spec page 5 §4). */
+    CHAIN: exports.READ_CHAIN,
+    /** @deprecated Use `READ.CHAIN.WEB2`. Same value (`'web2'`). */
+    WEB2: read_state_1.WEB2_READ_CHAIN,
     NAMESPACE: read_state_1.READ_NAMESPACE,
     MAX_CALLBACK_GAS_LIMIT: read_state_1.MAX_CALLBACK_GAS_LIMIT,
     MIN_CONFIRMATIONS_FLOOR: read_state_1.MIN_CONFIRMATIONS_FLOOR,
@@ -35,6 +47,8 @@ exports.CONSTANTS = {
     MOVEABLE: { TOKEN: tokens_1.MOVEABLE_TOKEN_CONSTANTS },
     PAYABLE: { TOKEN: tokens_1.PAYABLE_TOKEN_CONSTANTS },
     READ: exports.READ_CONSTANTS,
+    /** Checked v5 agentic wallet deployments by Push network (Donut only). */
+    AGENTIC: constants_1.AGENTIC,
 };
 // Multi-chain configuration exports
 var chain_2 = require("./chain");

package/src/lib/constants/read-state.d.ts

@@ -32,6 +32,15 @@ export declare const WEB2_MAX_TIMEOUT_MS = 15000;
  * Web2 is not a blockchain and is not a `CHAIN` enum member. Reads target it via
  * an explicit destination; the node routes on namespace `web2`, id `https`.
  */
+/** Public Web2 read source (`READ.CHAIN.WEB2`). */
+export declare const WEB2_READ_CHAIN: "web2";
+/**
+ * Legacy public spelling, and the unchanged CAIP-2 wire identity validators
+ * route on. Still accepted as read input.
+ */
+export declare const LEGACY_WEB2_READ_CHAIN: "web2:https";
+/** True for either public Web2 spelling. */
+export declare function isWeb2ReadChain(chain: unknown): chain is typeof WEB2_READ_CHAIN | typeof LEGACY_WEB2_READ_CHAIN;
 export declare const WEB2_DESTINATION: {
     readonly chainNamespace: "web2";
     readonly chainId: "https";

package/src/lib/constants/read-state.js

@@ -7,7 +7,8 @@
  * `read-state/__tests__/abi-selectors.spec.ts`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.READ_TRACK_LOOKUP_TIMEOUT_MS = exports.READ_EXPIRY_WARNING_BLOCKS = exports.READ_PREFLIGHT_STALE_MS = exports.READ_TRACK_MAX_TIMEOUT_MS = exports.READ_TRACK_MIN_POLL_INTERVAL_MS = exports.READ_TRACK_POLL_INTERVAL_MS = exports.PUSH_BLOCK_TIME_MS = exports.READ_NAMESPACE = exports.WEB2_DESTINATION = exports.WEB2_MAX_TIMEOUT_MS = exports.WEB2_DEFAULT_TIMEOUT_MS = exports.WEB2_MAX_EXTRACT_ENTRIES = exports.CALLBACK_BUDGET_BUFFER = exports.DEFAULT_EXPIRY_BLOCKS = exports.MIN_CONFIRMATIONS_FLOOR = exports.UNIVERSAL_READ_REGISTRY_ADDRESS = exports.REGISTRY_CALLBACK_GAS = exports.MAX_CALLBACK_GAS_LIMIT = void 0;
+exports.READ_TRACK_LOOKUP_TIMEOUT_MS = exports.READ_EXPIRY_WARNING_BLOCKS = exports.READ_PREFLIGHT_STALE_MS = exports.READ_TRACK_MAX_TIMEOUT_MS = exports.READ_TRACK_MIN_POLL_INTERVAL_MS = exports.READ_TRACK_POLL_INTERVAL_MS = exports.PUSH_BLOCK_TIME_MS = exports.READ_NAMESPACE = exports.WEB2_DESTINATION = exports.LEGACY_WEB2_READ_CHAIN = exports.WEB2_READ_CHAIN = exports.WEB2_MAX_TIMEOUT_MS = exports.WEB2_DEFAULT_TIMEOUT_MS = exports.WEB2_MAX_EXTRACT_ENTRIES = exports.CALLBACK_BUDGET_BUFFER = exports.DEFAULT_EXPIRY_BLOCKS = exports.MIN_CONFIRMATIONS_FLOOR = exports.UNIVERSAL_READ_REGISTRY_ADDRESS = exports.REGISTRY_CALLBACK_GAS = exports.MAX_CALLBACK_GAS_LIMIT = void 0;
+exports.isWeb2ReadChain = isWeb2ReadChain;
 /** Hard upper bound on the gas an app callback may declare — `ReadTypes.sol:50`. */
 exports.MAX_CALLBACK_GAS_LIMIT = 1000000n;
 /** Default callback gas (registry and custom targets); large results may need an explicit override up to the maximum. */
@@ -35,6 +36,17 @@ exports.WEB2_MAX_TIMEOUT_MS = 15_000;
  * Web2 is not a blockchain and is not a `CHAIN` enum member. Reads target it via
  * an explicit destination; the node routes on namespace `web2`, id `https`.
  */
+/** Public Web2 read source (`READ.CHAIN.WEB2`). */
+exports.WEB2_READ_CHAIN = 'web2';
+/**
+ * Legacy public spelling, and the unchanged CAIP-2 wire identity validators
+ * route on. Still accepted as read input.
+ */
+exports.LEGACY_WEB2_READ_CHAIN = 'web2:https';
+/** True for either public Web2 spelling. */
+function isWeb2ReadChain(chain) {
+    return chain === exports.WEB2_READ_CHAIN || chain === exports.LEGACY_WEB2_READ_CHAIN;
+}
 exports.WEB2_DESTINATION = {
     chainNamespace: 'web2',
     chainId: 'https',

package/src/lib/index.d.ts

@@ -7,17 +7,23 @@ export { isPC20Reference } from './orchestrator/orchestrator.types';
 export { PC20Error, InvalidPC20AddressError, PC20TokenChainMismatchError, PC20WrapperNotRegisteredError, PC20RegistryMismatchError, PC20FactoryMismatchError, InvalidPC20MetadataError, PC20ExpectedButPRC20Error, PC20AmbiguousAddressError, UnsupportedPC20DestinationError, InsufficientPC20BalanceError, PC20UnknownChainNamespaceError, PC20WrapperPredictionUnavailableError, PC20ExportRevertedError, PC20UnsafeEmptyPayloadError, } from './orchestrator/internals/pc20/errors';
 export type { ChainTarget, ChainSource, UniversalTo, TransactionRouteType, UniversalExecuteParams, UniversalOutboundTxRequest, PreparedUniversalTx, CascadedTxResponse, CascadeHopInfo, CascadeTrackOptions, CascadeProgressEvent, CascadeCompletionResult, MultiChainTxResponse, OutboundTxDetails, WaitForOutboundOptions, SvmGatewayAccountMeta, SvmExecutePayloadFields, AccountStatus, UEAStatus, RescueFundsParams, } from './orchestrator/orchestrator.types';
 export { parseUEAVersion } from './orchestrator/orchestrator.types';
-export { TransactionRoute, detectRoute, isChainTarget } from './orchestrator/route-detector';
+export { TransactionRoute, detectRoute, isChainTarget, } from './orchestrator/route-detector';
 export { DEFAULT_MAX_PC_FOR_GAS_BUFFER_BPS, MAX_PC_FOR_GAS_BUFFER_BPS_LIMIT, quoteMaxPCForGasCap, quoteMaxPCForGasCapFromNativeValue, } from './orchestrator/max-pc-for-gas';
 export type { MaxPCForGasCapInput, MaxPCForGasCapFromNativeValueInput, MaxPCForGasCapQuote, } from './orchestrator/max-pc-for-gas';
 export { getCEAAddress, getPushAccountForCEA, isCEA, chainSupportsCEA, chainSupportsOutbound, getCEAFactoryAddress, getAllCEAAddresses, } from './orchestrator/cea-utils';
 export { encodeSvmExecutePayload, isSvmChain, isValidSolanaHexAddress, buildMigrationPayload, buildErc20WithdrawalMulticall, } from './orchestrator/payload-builders';
 export type { ReadChain, ReadDestination, ResolvedDestination, ReadQuery, EvmReadQuery, SvmReadQuery, Web2ReadQuery, Web2Extract, Web2ValueType, EncodedReadQuery, ReadResultShape, DecodedReadResult, ReadPreflight, ReadSpec, ReadSpecTuple, BuildReadSpecParams, PreparedRead, ReadCallback, SimulateReadResult, ParsedReadRequest, FulfilOutcome, ReceiptLike, ReadRef, ReadLifecycleOptions, ReadFees, UniversalReadResponse, ReadResponseTuple, BatchReadResponse, } from './read-state/read-state.types';
-export type { ReadOptions, ReadPrepareOptions, ReadQueryOptions, ReadCallbackOptions, ReadValue, ValidateReadCall, ReadWeb2Options, ReadTrackOptions, ReadExecuteOptions } from './read-state/read-params';
+export type { ReadOptions, ReadPrepareOptions, ReadQueryOptions, ReadCallbackOptions, ReadValue, ValidateReadCall, ReadWeb2Options, ReadTrackOptions, ReadExecuteOptions, } from './read-state/read-params';
 export { UNIVERSAL_READ_STATUS, READ_STATUS, READ_ERROR_CODE, READ_OUTCOME, CONTRACT_REQUEST_STATUS, TERMINAL_READ_STATUSES, } from './read-state/read-state.types';
 export { ReadStateError, InvalidReadQueryError, InvalidReadSpecError, ReadHeightUnavailableError, UnsupportedReadDestinationError, ReadDecodeError, ReadTimeoutError, ReadNotFoundError, ReadRegistryUnavailableError, } from './read-state/errors';
 export type { ReadSpecViolation } from './read-state/errors';
 export { resolveDestination, encodeReadQuery, decodeReadResult, parseReadRequestsFromReceipt, parseFulfilOutcome, buildReadSpecFromPreflight, validateReadSpec, toCallData, sizeCallbackBudget, inferResultShape, toRequestIdHex, toReadQuery, } from './read-state';
 export { UNIVERSAL_CALLBACK_EVM } from './constants/abi/universalCallback.evm';
 export { UNIVERSAL_READ_REGISTRY_EVM } from './constants/abi/universalReadRegistry.evm';
+export { PushChainExecutionError, PushChainBatchExecutionError, } from './orchestrator/internals/errors';
+export type { DecodedErrorPayload } from './orchestrator/internals/errors';
+export type { PushChainInitializeOptions } from './push-chain/push-chain';
+export { AGENTIC_ERROR_CODE, AgenticError, AgenticRevertError, } from './agentic';
+export type { AgenticAddress, AgenticDoor, AgenticErrorCode, AgenticHex, AgenticNamespace, AgenticProgressHook, AgenticTxMetadata, AgenticWallet, AllowedCall, AssetCap, Checkpoint, CheckpointKind, CreateOptions, CreateResult, ForeignChainNamespace, DecodedSolanaRule, Rule, RuleInput, Pin, Spent, WalletMarker, ArgumentPath, RulesRecord, Selector, WalletInfo, WalletSummary, } from './agentic';
 export { PushChain };
+export type { Preset, PresetCategory, PresetAsset, PresetOptions, ReadyPresetOptions, PresetRuleTemplate, AgenticPresets, } from './agentic';

package/src/lib/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReadTimeoutError = exports.ReadDecodeError = exports.UnsupportedReadDestinationError = exports.ReadHeightUnavailableError = exports.InvalidReadSpecError = exports.InvalidReadQueryError = exports.ReadStateError = exports.TERMINAL_READ_STATUSES = exports.CONTRACT_REQUEST_STATUS = exports.READ_OUTCOME = exports.READ_ERROR_CODE = exports.READ_STATUS = exports.UNIVERSAL_READ_STATUS = exports.buildErc20WithdrawalMulticall = exports.buildMigrationPayload = exports.isValidSolanaHexAddress = exports.isSvmChain = exports.encodeSvmExecutePayload = exports.getAllCEAAddresses = exports.getCEAFactoryAddress = exports.chainSupportsOutbound = exports.chainSupportsCEA = exports.isCEA = exports.getPushAccountForCEA = exports.getCEAAddress = exports.quoteMaxPCForGasCapFromNativeValue = exports.quoteMaxPCForGasCap = exports.MAX_PC_FOR_GAS_BUFFER_BPS_LIMIT = exports.DEFAULT_MAX_PC_FOR_GAS_BUFFER_BPS = exports.isChainTarget = exports.detectRoute = exports.TransactionRoute = exports.parseUEAVersion = exports.PC20UnsafeEmptyPayloadError = exports.PC20ExportRevertedError = exports.PC20WrapperPredictionUnavailableError = exports.PC20UnknownChainNamespaceError = exports.InsufficientPC20BalanceError = exports.UnsupportedPC20DestinationError = exports.PC20AmbiguousAddressError = exports.PC20ExpectedButPRC20Error = exports.InvalidPC20MetadataError = exports.PC20FactoryMismatchError = exports.PC20RegistryMismatchError = exports.PC20WrapperNotRegisteredError = exports.PC20TokenChainMismatchError = exports.InvalidPC20AddressError = exports.PC20Error = exports.isPC20Reference = exports.CHAIN = void 0;
-exports.PushChain = exports.UNIVERSAL_READ_REGISTRY_EVM = exports.UNIVERSAL_CALLBACK_EVM = exports.toReadQuery = exports.toRequestIdHex = exports.inferResultShape = exports.sizeCallbackBudget = exports.toCallData = exports.validateReadSpec = exports.buildReadSpecFromPreflight = exports.parseFulfilOutcome = exports.parseReadRequestsFromReceipt = exports.decodeReadResult = exports.encodeReadQuery = exports.resolveDestination = exports.ReadRegistryUnavailableError = exports.ReadNotFoundError = void 0;
+exports.PushChain = exports.AgenticRevertError = exports.AgenticError = exports.AGENTIC_ERROR_CODE = exports.PushChainBatchExecutionError = exports.PushChainExecutionError = exports.UNIVERSAL_READ_REGISTRY_EVM = exports.UNIVERSAL_CALLBACK_EVM = exports.toReadQuery = exports.toRequestIdHex = exports.inferResultShape = exports.sizeCallbackBudget = exports.toCallData = exports.validateReadSpec = exports.buildReadSpecFromPreflight = exports.parseFulfilOutcome = exports.parseReadRequestsFromReceipt = exports.decodeReadResult = exports.encodeReadQuery = exports.resolveDestination = exports.ReadRegistryUnavailableError = exports.ReadNotFoundError = void 0;
 const push_chain_1 = require("./push-chain/push-chain");
 Object.defineProperty(exports, "PushChain", { enumerable: true, get: function () { return push_chain_1.PushChain; } });
 var enums_1 = require("./constants/enums");
@@ -88,4 +88,12 @@ var universalCallback_evm_1 = require("./constants/abi/universalCallback.evm");
 Object.defineProperty(exports, "UNIVERSAL_CALLBACK_EVM", { enumerable: true, get: function () { return universalCallback_evm_1.UNIVERSAL_CALLBACK_EVM; } });
 var universalReadRegistry_evm_1 = require("./constants/abi/universalReadRegistry.evm");
 Object.defineProperty(exports, "UNIVERSAL_READ_REGISTRY_EVM", { enumerable: true, get: function () { return universalReadRegistry_evm_1.UNIVERSAL_READ_REGISTRY_EVM; } });
+// Structured execution errors (base class of AgenticRevertError)
+var errors_3 = require("./orchestrator/internals/errors");
+Object.defineProperty(exports, "PushChainExecutionError", { enumerable: true, get: function () { return errors_3.PushChainExecutionError; } });
+Object.defineProperty(exports, "PushChainBatchExecutionError", { enumerable: true, get: function () { return errors_3.PushChainBatchExecutionError; } });
+var agentic_1 = require("./agentic");
+Object.defineProperty(exports, "AGENTIC_ERROR_CODE", { enumerable: true, get: function () { return agentic_1.AGENTIC_ERROR_CODE; } });
+Object.defineProperty(exports, "AgenticError", { enumerable: true, get: function () { return agentic_1.AgenticError; } });
+Object.defineProperty(exports, "AgenticRevertError", { enumerable: true, get: function () { return agentic_1.AgenticRevertError; } });
 //# sourceMappingURL=index.js.map

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

@@ -39,11 +39,18 @@ export declare class PushChainExecutionError extends Error {
     readonly code: "PUSH_CHAIN_EXECUTION_FAILED";
     readonly gatewayTxHash?: string;
     readonly decodedError?: DecodedErrorPayload;
+    /** Underlying transport/RPC error, kept so raw revert data is not lost. */
+    readonly cause?: unknown;
     constructor(message: string, opts?: {
         gatewayTxHash?: string;
         decodedError?: DecodedErrorPayload;
+        cause?: unknown;
     });
 }
+/** @internal A caller required an atomic native batch; sequential fallback is forbidden. */
+export declare class AtomicBatchUnavailableError extends PushChainExecutionError {
+    constructor(message: string, cause?: unknown);
+}
 /** Recovery metadata for a non-atomic Push batch. A pending hash is broadcast but unconfirmed. */
 export declare class PushChainBatchExecutionError extends PushChainExecutionError {
     readonly transactionHashes: `0x${string}`[];

package/src/lib/orchestrator/internals/errors.js

@@ -10,7 +10,7 @@
  * callers.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InsufficientUEABalanceError = exports.PushChainBatchExecutionError = exports.PushChainExecutionError = void 0;
+exports.InsufficientUEABalanceError = exports.PushChainBatchExecutionError = exports.AtomicBatchUnavailableError = exports.PushChainExecutionError = void 0;
 const formatters_1 = require("../../formatters");
 /**
  * Typed error for Route 1 Push Chain tx failures. Thrown by
@@ -31,14 +31,26 @@ class PushChainExecutionError extends Error {
     code = 'PUSH_CHAIN_EXECUTION_FAILED';
     gatewayTxHash;
     decodedError;
+    /** Underlying transport/RPC error, kept so raw revert data is not lost. */
+    cause;
     constructor(message, opts = {}) {
         super((0, formatters_1.normalizePublicErrorMessage)(message));
         this.name = 'PushChainExecutionError';
         this.gatewayTxHash = opts.gatewayTxHash;
         this.decodedError = opts.decodedError;
+        if (opts.cause !== undefined)
+            this.cause = opts.cause;
     }
 }
 exports.PushChainExecutionError = PushChainExecutionError;
+/** @internal A caller required an atomic native batch; sequential fallback is forbidden. */
+class AtomicBatchUnavailableError extends PushChainExecutionError {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = 'AtomicBatchUnavailableError';
+    }
+}
+exports.AtomicBatchUnavailableError = AtomicBatchUnavailableError;
 /** Recovery metadata for a non-atomic Push batch. A pending hash is broadcast but unconfirmed. */
 class PushChainBatchExecutionError extends PushChainExecutionError {
     transactionHashes;

package/src/lib/orchestrator/internals/execute-standard.d.ts

@@ -3,4 +3,6 @@ import type { ExecuteParams, UniversalTxResponse } from '../orchestrator.types';
 import type { OrchestratorContext } from './context';
 import { type ResponseBuilderCallbacks } from './response-builder';
 export declare function resolveRequiredFunds(requiredGasFee: bigint, executeValue: bigint, requiredFundsOverride?: bigint): bigint;
-export declare function executeStandardPayload(ctx: OrchestratorContext, execute: ExecuteParams, eventBuffer: ProgressEvent[], getResponseCallbacks: () => ResponseBuilderCallbacks): Promise<UniversalTxResponse>;
+export declare function executeStandardPayload(ctx: OrchestratorContext, execute: ExecuteParams, eventBuffer: ProgressEvent[], getResponseCallbacks: () => ResponseBuilderCallbacks, policy?: {
+    requireAtomicBatch: boolean;
+}): Promise<UniversalTxResponse>;

package/src/lib/orchestrator/internals/execute-standard.js

@@ -83,7 +83,7 @@ function resolveRequiredFunds(requiredGasFee, executeValue, requiredFundsOverrid
         ? requiredFundsOverride
         : baseRequiredFunds;
 }
-async function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks) {
+async function executeStandardPayload(ctx, execute, eventBuffer, getResponseCallbacks, policy) {
     const transformFn = (tx, buf = []) => (0, response_builder_1.transformToUniversalTxResponse)(ctx, tx, buf, getResponseCallbacks());
     // Set default value for value if undefined
     if (execute.value === undefined) {
@@ -104,7 +104,7 @@ async function executeStandardPayload(ctx, execute, eventBuffer, getResponseCall
         (0, context_1.fireProgressHook)(ctx, progress_hook_types_1.PROGRESS_HOOK.SEND_TX_107);
         let tx;
         try {
-            tx = await (0, push_chain_tx_1.sendPushTx)(ctx, execute, eventBuffer, transformFn);
+            tx = await (0, push_chain_tx_1.sendPushTx)(ctx, execute, eventBuffer, transformFn, policy?.requireAtomicBatch);
         }
         catch (err) {
             // Push Chain broadcast failed. Wallet rejection surfaces as 104-04;
@@ -116,7 +116,7 @@ async function executeStandardPayload(ctx, execute, eventBuffer, getResponseCall
             // outer orchestrator catch doesn't emit a second 199-02 on top.
             ctx._routeTerminalEmitted = true;
             if (!isUserDecline && !(err instanceof push_chain_tx_1.PushChainExecutionError)) {
-                throw new push_chain_tx_1.PushChainExecutionError(errMsg);
+                throw new push_chain_tx_1.PushChainExecutionError(errMsg, { cause: err });
             }
             throw err;
         }

package/src/lib/orchestrator/internals/outbound-sync.js

@@ -9,8 +9,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OutboundFailedError = exports.OutboundTimeoutError = exports.INBOUND_INITIAL_WAIT_MS = exports.INBOUND_MAX_TIMEOUT_MS = exports.OUTBOUND_MAX_TIMEOUT_MS = exports.OUTBOUND_POLL_INTERVAL_MS = exports.OUTBOUND_INITIAL_WAIT_MS = void 0;
 exports.waitForOutboundTx = waitForOutboundTx;
 exports.waitForAllOutboundTxsV2 = waitForAllOutboundTxsV2;
+const tslib_1 = require("tslib");
 const tracking_1 = require("./pc20/tracking");
 const viem_1 = require("viem");
+const web3_js_1 = require("@solana/web3.js");
+const bs58_1 = tslib_1.__importDefault(require("bs58"));
 const chain_1 = require("../../constants/chain");
 const enums_1 = require("../../constants/enums");
 const types_1 = require("../../generated/uexecutor/v1/types");
@@ -90,11 +93,11 @@ exports.OutboundFailedError = OutboundFailedError;
  * (preserves the silent-success bug fix); if no receipt yet or RPC failure,
  * we keep polling.
  *
- * EVM-only — SVM tiebreaker would need a separate signature lookup path.
+ * EVM receipts and confirmed/finalized Solana signatures are supported.
  */
-async function verifyExternalEvmReceipt(ctx, destinationChain, externalTxHash) {
+async function verifyExternalReceipt(ctx, destinationChain, externalTxHash) {
     const chainInfo = chain_1.CHAIN_INFO[destinationChain];
-    if (!chainInfo || chainInfo.vm !== enums_1.VM.EVM) {
+    if (!chainInfo || (chainInfo.vm !== enums_1.VM.EVM && chainInfo.vm !== enums_1.VM.SVM)) {
         return 'unsupported';
     }
     // Guard against unit-test contexts that don't pass a real rpcUrls map —
@@ -106,6 +109,45 @@ async function verifyExternalEvmReceipt(ctx, destinationChain, externalTxHash) {
         : chainInfo.defaultRPC;
     if (!rpcUrls?.length)
         return 'unsupported';
+    if (chainInfo.vm === enums_1.VM.SVM) {
+        let signature;
+        try {
+            const bytes = externalTxHash.startsWith('0x')
+                ? /^0x[0-9a-fA-F]{128}$/.test(externalTxHash)
+                    ? Buffer.from(externalTxHash.slice(2), 'hex')
+                    : new Uint8Array()
+                : bs58_1.default.decode(externalTxHash);
+            if (bytes.length !== 64)
+                return 'pending';
+            signature = bs58_1.default.encode(bytes);
+        }
+        catch {
+            return 'pending';
+        }
+        for (const url of rpcUrls) {
+            try {
+                const connection = new web3_js_1.Connection(url, 'confirmed');
+                if (`solana:${(await connection.getGenesisHash()).slice(0, 32)}` !==
+                    destinationChain)
+                    continue;
+                const result = await connection.getSignatureStatuses([signature], {
+                    searchTransactionHistory: true,
+                });
+                const status = result.value[0];
+                // A processed vote can still disappear. Never report success/failure
+                // before the signature is confirmed or finalized on the right cluster.
+                if (!status ||
+                    (status.confirmationStatus !== 'confirmed' &&
+                        status.confirmationStatus !== 'finalized'))
+                    return 'pending';
+                return status.err ? 'reverted' : 'success';
+            }
+            catch (error) {
+                (0, context_1.printLog)(ctx, `[verifyExternalReceipt] SVM RPC unavailable: ${error instanceof Error ? error.name : 'unknown'}`);
+            }
+        }
+        return 'pending';
+    }
     try {
         const client = (0, viem_1.createPublicClient)({
             transport: (0, viem_1.fallback)(rpcUrls.map((url) => (0, viem_1.http)(url))),
@@ -128,7 +170,7 @@ async function verifyExternalEvmReceipt(ctx, destinationChain, externalTxHash) {
         if (/not found|TransactionReceiptNotFound|could not be found/i.test(msg)) {
             return 'pending';
         }
-        (0, context_1.printLog)(ctx, `[verifyExternalEvmReceipt] RPC error for ${destinationChain} tx ${externalTxHash}: ${msg}`);
+        (0, context_1.printLog)(ctx, `[verifyExternalReceipt] RPC error for ${destinationChain} tx ${externalTxHash}: ${msg}`);
         return 'pending';
     }
 }
@@ -268,7 +310,7 @@ async function waitForOutboundTx(ctx, pushChainTxHash, options = {}) {
                     const isCosmosObserved = ob.outboundStatus === types_2.OutboundStatus.OBSERVED;
                     if (!isCosmosObserved) {
                         // Tiebreaker: ask the destination-chain RPC directly.
-                        const verdict = await verifyExternalEvmReceipt(ctx, chain, ob.observedTx.txHash);
+                        const verdict = await verifyExternalReceipt(ctx, chain, ob.observedTx.txHash);
                         if (verdict === 'reverted') {
                             (0, context_1.printLog)(ctx, `[waitForOutboundTx] Source-chain RPC reports REVERTED for ${ob.destinationChain} tx ${ob.observedTx.txHash} (cosmos still ${types_1.UniversalTxStatus[statusNum] ?? statusNum})`);
                             progressHook?.({
@@ -313,7 +355,10 @@ async function waitForOutboundTx(ctx, pushChainTxHash, options = {}) {
                         // created, and a repeat export deploys no wrapper so nothing is
                         // ever observed to backfill it. Resolve from UniversalCore instead,
                         // keyed by the Push-native source token.
-                        const pc20Wrapper = await (0, tracking_1.resolvePC20WrapperForReceipt)(ctx, ob, { network: ctx.pushNetwork, rpcUrls: ctx.rpcUrls });
+                        const pc20Wrapper = await (0, tracking_1.resolvePC20WrapperForReceipt)(ctx, ob, {
+                            network: ctx.pushNetwork,
+                            rpcUrls: ctx.rpcUrls,
+                        });
                         const details = {
                             externalTxHash: ob.observedTx.txHash,
                             destinationChain: chain,
@@ -477,7 +522,7 @@ async function waitForAllOutboundTxsV2(ctx, pushChainTxHash, outboundHops, optio
                             continue;
                         const isCosmosObserved = ob.outboundStatus === types_2.OutboundStatus.OBSERVED;
                         if (!isCosmosObserved) {
-                            const verdict = await verifyExternalEvmReceipt(ctx, chain, externalTxHash);
+                            const verdict = await verifyExternalReceipt(ctx, chain, externalTxHash);
                             if (verdict === 'reverted') {
                                 for (const targetHop of pendingTargetHops) {
                                     targetHop.status = 'failed';

package/src/lib/orchestrator/internals/push-chain-tx.d.ts

@@ -20,7 +20,7 @@ type TransformToResponseFn = (tx: TxResponse, eventBuffer: ProgressEvent[]) => P
  * For multicall arrays: executes each call as a separate transaction with
  * local nonce management and per-tx receipt confirmation.
  */
-export declare function sendPushTx(ctx: OrchestratorContext, execute: ExecuteParams, eventBuffer: ProgressEvent[], transformFn: TransformToResponseFn): Promise<UniversalTxResponse>;
+export declare function sendPushTx(ctx: OrchestratorContext, execute: ExecuteParams, eventBuffer: ProgressEvent[], transformFn: TransformToResponseFn, requireAtomicBatch?: boolean): Promise<UniversalTxResponse>;
 export type ResignUniversalPayloadFn = () => Promise<{
     universalPayload: UniversalPayload;
     verificationData: `0x${string}`;

package/src/lib/orchestrator/internals/push-chain-tx.js

@@ -66,7 +66,7 @@ async function getIndexedPushTransaction(ctx, txHash, label) {
  * For multicall arrays: executes each call as a separate transaction with
  * local nonce management and per-tx receipt confirmation.
  */
-async function sendPushTx(ctx, execute, eventBuffer, transformFn) {
+async function sendPushTx(ctx, execute, eventBuffer, transformFn, requireAtomicBatch = false) {
     if (Array.isArray(execute.data)) {
         const calls = execute.data;
         // Reject a zero `to` BEFORE route selection so behaviour is identical
@@ -82,6 +82,15 @@ async function sendPushTx(ctx, execute, eventBuffer, transformFn) {
         // (b) a wallet that can sign a 7702 authorization. When either is missing we
         // fall back to the legacy non-atomic per-call loop below.
         const executor = (0, chain_1.getBatchExecutorAddress)(ctx.universalSigner.account.chain);
+        if (requireAtomicBatch) {
+            if (!executor || !ctx.universalSigner.signAuthorization) {
+                throw new errors_1.AtomicBatchUnavailableError('This operation requires a sender-preserving atomic batch; the signer/network does not support EIP-7702.');
+            }
+            const code = await ctx.pushClient.publicClient.getCode({ address: executor });
+            if (!code || code === '0x') {
+                throw new errors_1.AtomicBatchUnavailableError(`Atomic batch executor ${executor} is not deployed on the connected network.`);
+            }
+        }
         if (executor && ctx.universalSigner.signAuthorization) {
             try {
                 (0, context_1.printLog)(ctx, `sendPushTx — executing ${calls.length} call(s) atomically via EIP-7702 (executor: ${executor})`);
@@ -100,6 +109,9 @@ async function sendPushTx(ctx, execute, eventBuffer, transformFn) {
                 // (e.g. a real revert) must surface.
                 if (!(err instanceof evm_client_1.EIP7702NotSupportedError))
                     throw err;
+                if (requireAtomicBatch) {
+                    throw new errors_1.AtomicBatchUnavailableError('The signer could not authorize EIP-7702; no sequential transactions were sent.', err);
+                }
                 (0, context_1.printLog)(ctx, `sendPushTx — wallet cannot sign EIP-7702 authorization; falling back to sequential execution`);
                 // eslint-disable-next-line no-console
                 console.warn('[push-chain] Wallet cannot produce an EIP-7702 authorization — batch ' +

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

@@ -97,6 +97,9 @@ export declare class Orchestrator {
      * Route 1 (Push Chain) dispatches to extracted sub-flow modules.
      */
     execute(params: ExecuteParams | UniversalExecuteParams, options?: TransactionExecutionOptions): Promise<UniversalTxResponse>;
+    /** @internal Sender-preserving batch. Never uses the native sequential fallback. */
+    executeAtomicBatch(params: ExecuteParams, options?: TransactionExecutionOptions): Promise<UniversalTxResponse>;
+    private executeWithPolicy;
     /**
      * Prepare a universal transaction without executing it.
      * Returns a PreparedUniversalTx that can be chained with thenOn() or sent with send().

package/src/lib/orchestrator/orchestrator.js

@@ -157,6 +157,16 @@ class Orchestrator {
      * Route 1 (Push Chain) dispatches to extracted sub-flow modules.
      */
     async execute(params, options) {
+        return this.executeWithPolicy(params, options, false);
+    }
+    /** @internal Sender-preserving batch. Never uses the native sequential fallback. */
+    async executeAtomicBatch(params, options) {
+        if (typeof params.to !== 'string' || !Array.isArray(params.data) || params.data.length < 2 || params.funds) {
+            throw new Error('executeAtomicBatch requires multiple Push calls and no signer funds');
+        }
+        return this.executeWithPolicy(params, options, true);
+    }
+    async executeWithPolicy(params, options, requireAtomicBatch) {
         const inlineProgressHook = params.progressHook;
         if (options || inlineProgressHook) {
             params = {
@@ -312,7 +322,9 @@ class Orchestrator {
                         ? await (0, internals_1.executeFundsOnly)(this.ctx, legacy, eventBuffer, rcb)
                         : await (0, internals_1.executeFundsWithPayload)(this.ctx, legacy, eventBuffer, rcb));
                 }
-                return attachPerCallHookForWait(await (0, internals_1.executeStandardPayload)(this.ctx, execute, eventBuffer, rcb));
+                return attachPerCallHookForWait(await (requireAtomicBatch
+                    ? (0, internals_1.executeStandardPayload)(this.ctx, execute, eventBuffer, rcb, { requireAtomicBatch: true })
+                    : (0, internals_1.executeStandardPayload)(this.ctx, execute, eventBuffer, rcb)));
             }
             catch (err) {
                 const errMessage = (0, formatters_1.normalizePublicErrorMessage)(err);

package/src/lib/orchestrator/orchestrator.types.d.ts

@@ -374,6 +374,14 @@ export interface UniversalTxResponse {
     childTxHash?: string;
     /** Transaction route (UOA_TO_PUSH, UOA_TO_CEA, CEA_TO_PUSH, CEA_TO_CEA) */
     route?: TransactionRouteType;
+    /**
+     * Agentic wallet (AGW) context, present when the transaction executed
+     * through an AGW. `from` is then the wallet and `origin` stays the signer;
+     * `agentic.rawTo` / `rawData` hold the wrapped call the signer sent.
+     * Outbound to/data/value summarize the first encoded destination call;
+     * `agentic.destinationCalls` retains the complete ordered call list.
+     */
+    agentic?: import('../agentic/agentic.types').AgenticTxMetadata;
     /**
      * @internal True when this response was produced by `trackTransaction` and
      * its progress events have already been replayed via the registered hook.

package/src/lib/orchestrator/route-detector.js

@@ -19,6 +19,7 @@ exports.detectRoute = detectRoute;
 exports.validateRouteParams = validateRouteParams;
 exports.getRouteInfo = getRouteInfo;
 const enums_1 = require("../constants/enums");
+const read_state_1 = require("../constants/read-state");
 const tokens_1 = require("../constants/tokens");
 const orchestrator_types_1 = require("./orchestrator.types");
 const payload_builders_1 = require("./payload-builders");
@@ -215,8 +216,8 @@ function detectRoute(params) {
  */
 function validateRouteParams(params, context) {
     const toChain = isChainTarget(params.to) ? String(params.to.chain) : undefined;
-    if (String(params.from?.chain ?? '') === enums_1.CHAIN.WEB2 || toChain === enums_1.CHAIN.WEB2) {
-        throw new RouteValidationError('CHAIN.WEB2 is a read-only destination and cannot be used with transaction APIs');
+    if ((0, read_state_1.isWeb2ReadChain)(String(params.from?.chain ?? '')) || (0, read_state_1.isWeb2ReadChain)(toChain)) {
+        throw new RouteValidationError('READ.CHAIN.WEB2 is a read-only destination and cannot be used with transaction APIs');
     }
     const route = detectRoute(params);
     // Validate from.chain is supported external chain (Routes 3, 4)

package/src/lib/orchestrator/svm-idl/resolve.d.ts

@@ -12,3 +12,5 @@ export interface ResolvedSvmCall {
     ixData: Uint8Array;
 }
 export declare function resolveSvmCall(input: ResolveInput): ResolvedSvmCall;
+/** Internal AGW seam: use its registry-derived authority, not the signer's CEA. */
+export declare function resolveSvmCallForCea(input: ResolveInput, ceaAuthority: `0x${string}`): ResolvedSvmCall;

package/src/lib/orchestrator/svm-idl/resolve.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveSvmCall = resolveSvmCall;
+exports.resolveSvmCallForCea = resolveSvmCallForCea;
 const web3_js_1 = require("@solana/web3.js");
 const buffer_1 = require("buffer");
 const account_1 = require("../../universal/account/account");
@@ -13,6 +14,15 @@ const CEA_AUTHORITY_NAMES = new Set([
     'ceaSigner',
 ]);
 function resolveSvmCall(input) {
+    return resolveCall(input);
+}
+/** Internal AGW seam: use its registry-derived authority, not the signer's CEA. */
+function resolveSvmCallForCea(input, ceaAuthority) {
+    if (!/^0x[0-9a-fA-F]{64}$/.test(ceaAuthority))
+        throw new Error('SVM CEA authority must be 32 bytes');
+    return resolveCall(input, ceaAuthority);
+}
+function resolveCall(input, authority) {
     const idl = (0, registry_1.getIdl)(input.programAddress);
     if (!idl) {
         throw new Error(`resolveSvmCall: no IDL found for ${input.programAddress}. ` +
@@ -30,7 +40,7 @@ function resolveSvmCall(input) {
         throw new Error(`resolveSvmCall: no instruction in IDL '${idl.metadata?.name ?? idl.address}' matches discriminator [${Array.from(disc).join(',')}]`);
     }
     const programPk = new web3_js_1.PublicKey(buffer_1.Buffer.from(input.programAddress.slice(2), 'hex'));
-    const { address: ceaPdaHex } = (0, account_1.deriveSvmCeaPda)(input.senderUea, input.targetChain, true);
+    const ceaPdaHex = authority ?? (0, account_1.deriveSvmCeaPda)(input.senderUea, input.targetChain, true).address;
     const accounts = [];
     for (const item of ix.accounts) {
         if ('accounts' in item) {