@pushchain/core 6.0.27-alpha.3 → 6.0.27-alpha.5

package/src/lib/agentic/presets/index.js

@@ -99,11 +99,10 @@ function buildPresetApi(catalog) {
                 throw invalid('preset options must be an object');
             const now = Math.floor(Date.now() / 1000);
             const network = options.network ?? enums_1.PUSH_NETWORK.TESTNET_DONUT;
-            const funding = options.funding ?? 'push';
             if (!Object.values(enums_1.PUSH_NETWORK).includes(network))
                 throw invalid('unknown preset Push network');
-            if (funding !== 'push' && funding !== 'destination')
-                throw invalid('preset funding must be push or destination');
+            if ('funding' in options)
+                throw invalid('The preset funding option is no longer supported. Remove it; preset assets and limits are always preserved.');
             if (options.agent !== undefined &&
                 (!(0, viem_1.isAddress)(options.agent, { strict: false }) ||
                     (0, viem_1.getAddress)(options.agent) === viem_1.zeroAddress))
@@ -281,8 +280,9 @@ function buildPresetApi(catalog) {
                 }
                 if (!calls.length || calls.length > 32)
                     throw (0, errors_1.capabilityUnavailable)('presetCalls', 'preset must contain 1..32 allowed calls including approvals');
-                if (calls.reduce((n, c) => n + (c.pins?.length ?? 0), 0) > 32)
-                    throw (0, errors_1.capabilityUnavailable)('presetPins', 'preset expansion exceeds 32 pins; reduce the token list or split rules across wallets');
+                const conditionCount = calls.reduce((n, c) => n + (c.pins?.length ?? 0), 0);
+                if (conditionCount > 32)
+                    throw (0, errors_1.ruleConstraintLimit)(conditionCount, calls.length, chain.chainNamespace);
                 const pairs = new Map();
                 for (const call of calls) {
                     if (!/^[A-Za-z_$][\w$]*\(.*\)$/.test(call.selector))
@@ -313,7 +313,7 @@ function buildPresetApi(catalog) {
                 if (!selectedAssets.length)
                     issues.push({
                         code: 'ASSETS_REQUIRED',
-                        message: 'Choose tokens and their limits, then regenerate this preset.',
+                        message: 'No tokens selected: transfers from Push are disabled, not unrestricted. Choose explicit tokens and limits, then regenerate this preset.',
                     });
                 if (chain.swapRouters?.length && selectedAssets.length < 2)
                     issues.push({
@@ -326,14 +326,13 @@ function buildPresetApi(catalog) {
                         message: 'No asset operation has a positive per-call limit.',
                     });
                 const configurationReady = issues.length === 0;
-                const routes = (0, routes_1.presetRoutes)(chain.chainNamespace, selectedAssets, network, funding);
+                const routes = (0, routes_1.presetRoutes)(chain.chainNamespace, selectedAssets, network);
                 issues.push(...routes.issues);
-                const bridgeAssets = funding === 'destination' ? [] : selectedAssets;
+                const bridgeAssets = selectedAssets;
                 readiness.push({
                     chainNamespace: chain.chainNamespace,
                     ready: issues.length === 0,
                     configurationReady,
-                    funding,
                     selectedAssets: selectedAssets.map((a) => ({
                         ...a,
                         token: typeof a.token === 'string' ? a.token : { ...a.token },

package/src/lib/agentic/presets/routes.d.ts

@@ -3,7 +3,7 @@ import type { RuleAsset } from '../agentic.types';
 import type { PresetChainReadiness, PresetConfigurationIssue } from './types';
 /** Offline registry checks only. Grant preparation still verifies source metadata
  * and wiring against chain state before any signature or transaction. */
-export declare function presetRoutes(chain: string, assets: RuleAsset[], network: PUSH_NETWORK, funding: 'push' | 'destination'): {
+export declare function presetRoutes(chain: string, assets: RuleAsset[], network: PUSH_NETWORK): {
     bridgeAssets: PresetChainReadiness['bridgeAssets'];
     issues: PresetConfigurationIssue[];
 };

package/src/lib/agentic/presets/routes.js

@@ -9,7 +9,7 @@ const deployments_1 = require("../deployments");
 const operation_limits_1 = require("./operation-limits");
 /** Offline registry checks only. Grant preparation still verifies source metadata
  * and wiring against chain state before any signature or transaction. */
-function presetRoutes(chain, assets, network, funding) {
+function presetRoutes(chain, assets, network) {
     const issues = [];
     network =
         network === enums_1.PUSH_NETWORK.TESTNET ? enums_1.PUSH_NETWORK.TESTNET_DONUT : network;
@@ -37,12 +37,11 @@ function presetRoutes(chain, assets, network, funding) {
             };
         }
         catch {
-            if (funding === 'push')
-                issues.push({
-                    code: 'BRIDGE_ASSET_UNAVAILABLE',
-                    token,
-                    message: `No SDK PRC20 mapping for ${chain}:${token} on ${network}. Use a supported source asset or explicitly choose destination funding for assets already at the CEA.`,
-                });
+            issues.push({
+                code: 'BRIDGE_ASSET_UNAVAILABLE',
+                token,
+                message: `No SDK PRC20 mapping for ${chain}:${token} on ${network}. This preset cannot be created with this token until its Push route is verified. Choose a routed token only if the selected app supports that exact token address.`,
+            });
             return { token, status: 'unavailable' };
         }
     });

package/src/lib/agentic/presets/types.d.ts

@@ -25,10 +25,6 @@ export interface PresetAsset {
 export interface PresetOptions {
     /** Offline route/deployment checks; defaults to TESTNET_DONUT. */
     network?: PUSH_NETWORK;
-    /** Push funding requires PRC20 routes. Destination funding explicitly emits
-     * empty bridge assets while preserving selected token/call limits in metadata.
-     * The CEA must already hold the required destination assets. Default: push. */
-    funding?: 'push' | 'destination';
     /** Push-PC budget ceiling per outbound; omitted uses the catalog policy (20 PC).
      * Explicit zero is preserved. This is not the fee charged. */
     maxGasPerCall?: bigint;
@@ -63,8 +59,7 @@ export interface PresetChainReadiness {
     chainNamespace: ForeignChainNamespace;
     ready: boolean;
     configurationReady: boolean;
-    funding: 'push' | 'destination';
-    /** Selected destination permissions, retained even when bridge assets is empty. */
+    /** Selected assets and caps, matching the returned rule assets. */
     selectedAssets: RuleAsset[];
     /** Registry presence only; grant preparation verifies exact on-chain identity. */
     bridgeAssets: {

package/src/lib/agentic/public-rule.js

@@ -36,6 +36,7 @@ const selectors_1 = require("./codec/selectors");
 const abi_layout_1 = require("./codec/abi-layout");
 const defaults_1 = require("./codec/defaults");
 const svm_accounts_1 = require("./codec/svm-accounts");
+const destination_1 = require("./management/destination");
 exports.WALLET = 'agentic:wallet';
 const PUBLIC_INPUT = Symbol('AGW public rule');
 /** Mark authored inputs for normalization after the wallet address is fixed. */
@@ -94,6 +95,11 @@ async function normalizePublicRule(input, wallet, runtime) {
     if ('format' in rule && rule.format === 'decoded')
         return input;
     const r = rule;
+    if (!(0, viem_1.isAddress)(r.agent, { strict: false }) || /^0x0{40}$/i.test(r.agent))
+        throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, 'Enter a valid agent wallet address.', {
+            userMessage: 'Enter a valid agent wallet address.',
+            details: { field: 'agent' },
+        });
     rejectFields(r, [
         'target',
         'selector',
@@ -111,6 +117,11 @@ async function normalizePublicRule(input, wallet, runtime) {
         r.validUntil <= runtime.nowSeconds() ||
         r.validUntil >= 2 ** 48)
         throw invalid('validUntil must be a future uint48 timestamp');
+    if (r.allowedCalls === undefined ||
+        (Array.isArray(r.allowedCalls) && !r.allowedCalls.length))
+        throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, 'Add at least one allowed function. Selecting tokens and limits alone does not authorize transfers.', {
+            details: { reason: 'ALLOWED_FUNCTION_REQUIRED', field: 'allowedCalls' },
+        });
     if (!Array.isArray(r.allowedCalls) ||
         r.allowedCalls.length < 1 ||
         r.allowedCalls.length > 32)
@@ -158,10 +169,15 @@ async function normalizePublicRule(input, wallet, runtime) {
         throw invalid('native rules do not carry assets or maxGasPerCall');
     const own = native
         ? wallet
-        : (0, viem_1.getAddress)((await runtime.resolveCEA(wallet, r.chainNamespace)).cea);
+        : await (0, destination_1.resolveRuleDestination)(runtime, wallet, r.chainNamespace);
     const nativeActions = [];
     const calls = [];
-    for (const call of r.allowedCalls) {
+    for (const [callIndex, call] of r.allowedCalls.entries()) {
+        if (!(0, viem_1.isAddress)(call.target, { strict: false }))
+            throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, 'An allowed function has an invalid app address.', {
+                userMessage: 'An allowed function has an invalid app address. Select the app again.',
+                details: { field: `allowedCalls[${callIndex}].target`, callIndex },
+            });
         const pins = call.pins ?? [];
         const wirePins = [];
         const occupied = new Set();

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

@@ -111,6 +111,41 @@ export declare const CONSTANTS: {
     /** Checked v5 agentic wallet deployments by Push network (Donut only). */
     AGENTIC: Readonly<{
         WALLET: "agentic:wallet";
+        PRINCIPAL: "agentic:principal";
+        JOB: Readonly<{
+            ADDRESS: Readonly<{
+                'eip155:42101': Readonly<{
+                    KERNEL: "0x977cf1AC973E9eC4332791d531507575006157Ed";
+                    HOOK: "0xDe7A94e510b6C571DE7880d441349689F73A32b3";
+                    EVALUATOR: "0x1afC81396f1bb36F91f74506284952b81e4bd47c";
+                }>;
+            }>;
+            EVALUATION: Readonly<{
+                readonly BOOLEAN: "BOOLEAN";
+                readonly COMPARE: "COMPARE";
+                readonly NUMBER: "NUMBER";
+                readonly PERCENTAGE: "PERCENTAGE";
+            }>;
+            OPERATION: Readonly<{
+                readonly EQUAL: "EQUAL";
+                readonly NOT_EQUAL: "NOT_EQUAL";
+                readonly GREATER_THAN: "GREATER_THAN";
+                readonly GREATER_OR_EQUAL: "GREATER_OR_EQUAL";
+                readonly LESS_THAN: "LESS_THAN";
+                readonly LESS_OR_EQUAL: "LESS_OR_EQUAL";
+            }>;
+            LOGIC: Readonly<{
+                readonly ALL: "ALL";
+                readonly ANY: "ANY";
+                readonly AT_LEAST: "AT_LEAST";
+            }>;
+            ALLOWED_MUTABILITY: Readonly<{
+                readonly NONE: "NONE";
+                readonly CLIENT: "CLIENT";
+                readonly PROVIDER: "PROVIDER";
+                readonly BOTH: "BOTH";
+            }>;
+        }>;
         PRESETS: Readonly<{
             CATEGORY: Readonly<{
                 DEXES: "DEXES";

package/src/lib/index.d.ts

@@ -1,4 +1,8 @@
 import { PushChain } from './push-chain/push-chain';
+export { MarketError, JobError, JobSpecError } from './market';
+export type { AgentCardRules, MarketAssetToken, MarketPin, AgentCard, AgentCardInput, AgentCardSummary, MarketNamespace, MarketPreviewOptions, MarketWriteOptions, MarketOpenOptions, MarketDepositOptions, MarketDepositResult, MarketDepositStep, JobPlan, OwnerIntent, } from './market';
+export type { JobNamespace, Job, JobStatus, JobEvent, JobWatchCursor, JobWatchOptions, CreateJobOptions, FundJobOptions, } from './job/types';
+export type { JobSpec, JobSpecTemplate, JobRead, PreparedJobRead, JobReadInput, JobCheck, JobCheckTemplate, LogicTree, Evaluation, Operation, LogicKind, AllowedMutability, PrincipalMarker, PrepareJobReadOptions, ExecuteJobReadOptions, BuildJobSpecOptions, BuildJobSpecTemplateOptions, JobSpecPreview, PreviewJobSpecOptions, } from './job-spec';
 export { CHAIN } from './constants/enums';
 export type { ConversionQuote } from './constants/tokens';
 export type { UniversalSigner, UniversalAccount, UniversalSignerSkeleton, SignAuthorizationParams, SignedAuthorization, DerivedExecutorAccount, ResolvedAccount, ResolvedControllerAccounts, AccountType, AccountRole, } from './universal/universal.types';

package/src/lib/index.js

@@ -1,9 +1,13 @@
 "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.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;
+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 = exports.JobSpecError = exports.JobError = exports.MarketError = 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 = exports.ReadTimeoutError = exports.ReadDecodeError = exports.UnsupportedReadDestinationError = 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 market_1 = require("./market");
+Object.defineProperty(exports, "MarketError", { enumerable: true, get: function () { return market_1.MarketError; } });
+Object.defineProperty(exports, "JobError", { enumerable: true, get: function () { return market_1.JobError; } });
+Object.defineProperty(exports, "JobSpecError", { enumerable: true, get: function () { return market_1.JobSpecError; } });
 var enums_1 = require("./constants/enums");
 Object.defineProperty(exports, "CHAIN", { enumerable: true, get: function () { return enums_1.CHAIN; } });
 var orchestrator_types_1 = require("./orchestrator/orchestrator.types");

package/src/lib/job/job.d.ts

@@ -0,0 +1,35 @@
+import { type Address, type Hex } from 'viem';
+import { type StackRuntime } from '../market/runtime';
+import type { CreateJobOptions, FundJobOptions, Job, JobEvent, JobNamespace, JobStatus, JobWriteOptions, JobWatchOptions } from './types';
+export declare class JobNamespaceImpl implements JobNamespace {
+    private readonly rt;
+    constructor(rt: StackRuntime);
+    private raw;
+    private jobAt;
+    status(jobId: bigint): Promise<Job>;
+    list(options?: {
+        client?: Address;
+        provider?: Address;
+        status?: JobStatus;
+        fromJobId?: bigint;
+    }): Promise<{
+        jobs: Job[];
+    }>;
+    create(options: CreateJobOptions): Promise<{
+        jobId: bigint;
+        tx: import("../orchestrator/orchestrator.types").UniversalTxResponse;
+    }>;
+    private provider;
+    private open;
+    setBudget(jobId: bigint, budget: bigint, options?: JobWriteOptions & {
+        jobSpec?: Hex;
+    }): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    fund(jobId: bigint, options?: FundJobOptions): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    submit(jobId: bigint, options: JobWriteOptions & {
+        deliverable: Hex | string;
+    }): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    cancel(jobId: bigint, options?: JobWriteOptions): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    claimRefund(jobId: bigint, options?: JobWriteOptions): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    verify(_jobId: bigint, _options?: JobWriteOptions): Promise<never>;
+    watch(jobId: bigint, callback: (event: JobEvent) => void, options?: JobWatchOptions): () => void;
+}