@pushchain/core 6.0.25 → 6.0.27-alpha.0

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

@@ -0,0 +1,11 @@
+/** Public section-7 discovery constants; deployment wiring stays internal. */
+export declare const AGENTIC: Readonly<{
+    WALLET: "agentic:wallet";
+    PRESETS: Readonly<{
+        CATEGORY: Readonly<{
+            DEXES: "DEXES";
+            LENDING: "LENDING";
+            PREDICTION: "PREDICTION";
+        }>;
+    }>;
+}>;

package/src/lib/agentic/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENTIC = void 0;
+/** Public section-7 discovery constants; deployment wiring stays internal. */
+exports.AGENTIC = Object.freeze({
+    WALLET: 'agentic:wallet',
+    PRESETS: Object.freeze({
+        CATEGORY: Object.freeze({
+            DEXES: 'DEXES',
+            LENDING: 'LENDING',
+            PREDICTION: 'PREDICTION',
+        }),
+    }),
+});
+//# sourceMappingURL=constants.js.map

package/src/lib/agentic/context.d.ts

@@ -0,0 +1,29 @@
+import { type Address } from 'viem';
+import { CHAIN } from '../constants/enums';
+import { type AgenticGeneration } from './deployments';
+import type { AgenticRuntime } from './runtime';
+import type { AgenticDoor } from './agentic.types';
+/**
+ * Identity of an agentic client. Three values stay separate:
+ *  - signerOrigin:        the key that signs (universal.origin)
+ *  - signerPushAccount:   its Push identity — EOA or UEA for its origin chain;
+ *                         pays Push gas and is the identity ownership checks use
+ *  - wallet:              the AGW, the execution account (universal.account)
+ */
+export interface AgenticExecutionContext {
+    wallet: Address;
+    door: AgenticDoor;
+    signerPushAccount: Address;
+    signerOrigin: {
+        chain: CHAIN;
+        address: string;
+    };
+    generation: AgenticGeneration;
+}
+/**
+ * Initialization-time resolution for `initialize(signer, { agenticWallet })`.
+ * Owner → owner door. Otherwise at least one ENABLED rule must name the
+ * signer's Push identity (expired-but-enabled still qualifies; expiry is an
+ * on-chain send check). Nothing here is cached for later sends.
+ */
+export declare function resolveAgenticContext(runtime: AgenticRuntime, walletInput: string): Promise<AgenticExecutionContext>;

package/src/lib/agentic/context.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAgenticContext = resolveAgenticContext;
+const viem_1 = require("viem");
+const capabilities_1 = require("./capabilities");
+const deployments_1 = require("./deployments");
+const errors_1 = require("./errors");
+const rules_1 = require("./reads/rules");
+const snapshot_1 = require("./reads/snapshot");
+/**
+ * Initialization-time resolution for `initialize(signer, { agenticWallet })`.
+ * Owner → owner door. Otherwise at least one ENABLED rule must name the
+ * signer's Push identity (expired-but-enabled still qualifies; expiry is an
+ * on-chain send check). Nothing here is cached for later sends.
+ */
+async function resolveAgenticContext(runtime, walletInput) {
+    let wallet;
+    try {
+        wallet = (0, viem_1.getAddress)(walletInput);
+    }
+    catch (cause) {
+        throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.NOT_AGENTIC_WALLET, `"${walletInput}" is not an address`, {
+            cause,
+        });
+    }
+    const generation = await (0, deployments_1.resolveWalletGeneration)(runtime.reader, runtime.network, wallet);
+    const signerPushAccount = runtime.signerPushAccount();
+    const snap = await snapshot_1.Snapshot.at(runtime.reader);
+    const owner = (0, viem_1.getAddress)(await snap.read(wallet, generation.contracts.abis.wallet, 'owner'));
+    let door;
+    if (owner === signerPushAccount) {
+        (0, capabilities_1.requireCapability)(generation.capabilities, capabilities_1.AgenticCapability.OWNER_EXECUTE);
+        door = 'owner';
+    }
+    else {
+        (0, capabilities_1.requireCapability)(generation.capabilities, capabilities_1.AgenticCapability.AGENT_EXECUTE);
+        const active = await (0, rules_1.readActiveRules)(snap, generation, wallet);
+        if (!active.some((r) => r.agent === signerPushAccount)) {
+            throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.NOT_OWNER_OR_AGENT, `${signerPushAccount} is neither the owner of ${wallet} nor the agent of an enabled rule`, {
+                hint: runtime.signerIsPushNative()
+                    ? 'Grant a rule to this Push address, or initialize with the owner signer.'
+                    : 'An external key acts through its UEA for the chain it was initialized on; grant the rule to that UEA (PushChain.utils.account.deriveExecutorAccount).',
+                details: { wallet, signerPushAccount, owner },
+            });
+        }
+        door = 'agent';
+    }
+    return {
+        wallet,
+        door,
+        signerPushAccount,
+        signerOrigin: runtime.signerOrigin(),
+        generation,
+    };
+}
+//# sourceMappingURL=context.js.map

package/src/lib/agentic/contracts/abi/v5/agent-validator.d.ts

@@ -0,0 +1,105 @@
+export declare const AGENT_VALIDATOR_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "isInitialized";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "isModuleType";
+    readonly inputs: readonly [{
+        readonly name: "moduleTypeId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "onInstall";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "onUninstall";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "validateConfig";
+    readonly inputs: readonly [{
+        readonly name: "data";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "validateSignatureWithData";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "sig";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "validSig";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "error";
+    readonly name: "AlreadyInitialized";
+    readonly inputs: readonly [{
+        readonly name: "smartAccount";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "MalformedConfig";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotInitialized";
+    readonly inputs: readonly [{
+        readonly name: "smartAccount";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}];

package/src/lib/agentic/contracts/abi/v5/agent-validator.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_VALIDATOR_ABI = void 0;
+// GENERATED by packages/core/scripts/agw-local/gen-abi.mjs — do not edit.
+// Source: packages/core/scripts/agw-local/abis/validator.json
+// push-agentic-wallets@2e61e133e641b4e0e1ddbdc9306b0903b60e4dbb
+// sha256(AgentValidator.json) = a4570ddc373241580de8742cbb3d9f2c837094c65bfd1cdd52243ca0c38196fd
+exports.AGENT_VALIDATOR_ABI = [
+    {
+        "type": "function",
+        "name": "isInitialized",
+        "inputs": [
+            {
+                "name": "",
+                "type": "address",
+                "internalType": "address"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "bool",
+                "internalType": "bool"
+            }
+        ],
+        "stateMutability": "pure"
+    },
+    {
+        "type": "function",
+        "name": "isModuleType",
+        "inputs": [
+            {
+                "name": "moduleTypeId",
+                "type": "uint256",
+                "internalType": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "bool",
+                "internalType": "bool"
+            }
+        ],
+        "stateMutability": "pure"
+    },
+    {
+        "type": "function",
+        "name": "onInstall",
+        "inputs": [
+            {
+                "name": "",
+                "type": "bytes",
+                "internalType": "bytes"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "pure"
+    },
+    {
+        "type": "function",
+        "name": "onUninstall",
+        "inputs": [
+            {
+                "name": "",
+                "type": "bytes",
+                "internalType": "bytes"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "pure"
+    },
+    {
+        "type": "function",
+        "name": "validateConfig",
+        "inputs": [
+            {
+                "name": "data",
+                "type": "bytes",
+                "internalType": "bytes"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "bool",
+                "internalType": "bool"
+            }
+        ],
+        "stateMutability": "pure"
+    },
+    {
+        "type": "function",
+        "name": "validateSignatureWithData",
+        "inputs": [
+            {
+                "name": "",
+                "type": "bytes32",
+                "internalType": "bytes32"
+            },
+            {
+                "name": "sig",
+                "type": "bytes",
+                "internalType": "bytes"
+            },
+            {
+                "name": "data",
+                "type": "bytes",
+                "internalType": "bytes"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "validSig",
+                "type": "bool",
+                "internalType": "bool"
+            }
+        ],
+        "stateMutability": "pure"
+    },
+    {
+        "type": "error",
+        "name": "AlreadyInitialized",
+        "inputs": [
+            {
+                "name": "smartAccount",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
+    },
+    {
+        "type": "error",
+        "name": "MalformedConfig",
+        "inputs": []
+    },
+    {
+        "type": "error",
+        "name": "NotInitialized",
+        "inputs": [
+            {
+                "name": "smartAccount",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
+    }
+];
+//# sourceMappingURL=agent-validator.js.map