@pushchain/core 6.0.25 → 6.0.27-alpha.0

package/src/lib/agentic/contracts/donut-v5.d.ts

@@ -0,0 +1,11 @@
+/** Source 2e61e13; code/proxy wiring checked at Donut block 23991912. */
+export declare const V5_SOURCE_COMMIT = "2e61e133e641b4e0e1ddbdc9306b0903b60e4dbb";
+export declare const DONUT_V5_START_BLOCK: bigint;
+export declare const DONUT_V5_ADDRESSES: {
+    readonly factory: "0x8137F96A50EBF41d904e3678c84c391a0D1BCcc5";
+    readonly walletImplementation: "0x4D459Da499C14548aa16c46c57fD92880A88EBb4";
+    readonly sessionEngine: "0x165A5E6782f39D30B38c7D97e1303e4CB2aD102a";
+    readonly rulesPolicy: "0x603E7f0aF6e1aAFf46DDfb28b1e99364f8BC59af";
+    readonly sessionValidator: "0x068EE2388475A98EE1f5a434C58bFF3444fffFe6";
+    readonly gateway: "0x00000000000000000000000000000000000000C1";
+};

package/src/lib/agentic/contracts/donut-v5.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DONUT_V5_ADDRESSES = exports.DONUT_V5_START_BLOCK = exports.V5_SOURCE_COMMIT = void 0;
+/** Source 2e61e13; code/proxy wiring checked at Donut block 23991912. */
+exports.V5_SOURCE_COMMIT = '2e61e133e641b4e0e1ddbdc9306b0903b60e4dbb';
+exports.DONUT_V5_START_BLOCK = BigInt(23989983);
+exports.DONUT_V5_ADDRESSES = {
+    factory: '0x8137F96A50EBF41d904e3678c84c391a0D1BCcc5',
+    walletImplementation: '0x4D459Da499C14548aa16c46c57fD92880A88EBb4',
+    sessionEngine: '0x165A5E6782f39D30B38c7D97e1303e4CB2aD102a',
+    rulesPolicy: '0x603E7f0aF6e1aAFf46DDfb28b1e99364f8BC59af',
+    sessionValidator: '0x068EE2388475A98EE1f5a434C58bFF3444fffFe6',
+    gateway: '0x00000000000000000000000000000000000000C1',
+};
+//# sourceMappingURL=donut-v5.js.map

package/src/lib/agentic/contracts/prc20-metadata.d.ts

@@ -0,0 +1,26 @@
+import { type Address, type Hex } from 'viem';
+import type { Snapshot } from '../reads/snapshot';
+import { PUSH_NETWORK } from '../../constants/enums';
+export declare const PRC20_SOURCE_ABI: readonly [{
+    readonly name: "SOURCE_CHAIN_NAMESPACE";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly name: "SOURCE_TOKEN_ADDRESS";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}];
+/** Resolve the SVM source mint from metadata or the current chain-specific token registry. */
+export declare function readSvmSourceToken(snap: Snapshot, token: Address, chain: string, network?: PUSH_NETWORK): Promise<Hex>;
+export declare const CORE_ADDRESS: Address;
+export declare function readGasPrc20(snap: Snapshot, chain: string): Promise<Address>;
+/** Donut native precompile returns a zero word; ERC20 metadata is a dynamic string. */
+export declare function readOriginToken(snap: Snapshot, token: Address, chain: string): Promise<Address>;

package/src/lib/agentic/contracts/prc20-metadata.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_ADDRESS = exports.PRC20_SOURCE_ABI = void 0;
+exports.readSvmSourceToken = readSvmSourceToken;
+exports.readGasPrc20 = readGasPrc20;
+exports.readOriginToken = readOriginToken;
+const viem_1 = require("viem");
+const prc20_evm_1 = require("../../constants/abi/prc20.evm");
+const errors_1 = require("../errors");
+const enums_1 = require("../../constants/enums");
+const tokens_1 = require("../../constants/tokens");
+const prc20_address_1 = require("../../universal/prc20-address");
+const svm_accounts_1 = require("../codec/svm-accounts");
+exports.PRC20_SOURCE_ABI = (0, viem_1.parseAbi)([
+    'function SOURCE_CHAIN_NAMESPACE() view returns (string)',
+    'function SOURCE_TOKEN_ADDRESS() view returns (string)',
+]);
+const NATIVE_SOURCE_ABI = (0, viem_1.parseAbi)([
+    'function SOURCE_TOKEN_ADDRESS() view returns (address)',
+]);
+const SVM_SOURCE_WORD_ABI = (0, viem_1.parseAbi)([
+    'function SOURCE_TOKEN_ADDRESS() view returns (bytes32)',
+]);
+/** Resolve the SVM source mint from metadata or the current chain-specific token registry. */
+async function readSvmSourceToken(snap, token, chain, network = enums_1.PUSH_NETWORK.TESTNET_DONUT) {
+    let source;
+    try {
+        source = await snap.read(token, exports.PRC20_SOURCE_ABI, 'SOURCE_TOKEN_ADDRESS');
+    }
+    catch (cause) {
+        try {
+            source = await snap.read(token, SVM_SOURCE_WORD_ABI, 'SOURCE_TOKEN_ADDRESS');
+        }
+        catch {
+            throw cause;
+        }
+    }
+    const zeroKey = `0x${'00'.repeat(32)}`;
+    if (source === '' ||
+        source.toLowerCase() === viem_1.zeroAddress ||
+        source.toLowerCase() === zeroKey) {
+        if ((0, viem_1.getAddress)(token) === (await readGasPrc20(snap, chain)))
+            return zeroKey;
+        // Current Donut SVM synthetic metadata exposes a zero word for SPL assets.
+        // Ordinary Route 2 already resolves these through the same token registry.
+        // Match both full origin chain and exact PRC20; never infer an unknown mint.
+        for (const asset of tokens_1.MOVEABLE_TOKENS[chain] ?? []) {
+            if (asset.mechanism === 'native')
+                continue;
+            try {
+                const resolved = (0, prc20_address_1.getPRC20Address)({ chain, address: asset.address }, { network });
+                if ((0, viem_1.getAddress)(resolved.address) === (0, viem_1.getAddress)(token))
+                    return (0, svm_accounts_1.svmKey)(asset.address);
+            }
+            catch {
+                // A token without a deployment in this network is not a candidate.
+            }
+        }
+        throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, `source mint unavailable for PRC20 ${token} on ${chain}; no registered mapping matches`);
+    }
+    return (0, svm_accounts_1.svmKey)(source);
+}
+exports.CORE_ADDRESS = '0x00000000000000000000000000000000000000C0';
+async function readGasPrc20(snap, chain) {
+    return (0, viem_1.getAddress)(await snap.read(exports.CORE_ADDRESS, prc20_evm_1.UNIVERSAL_CORE_EVM, 'gasTokenPRC20ByChainNamespace', [chain]));
+}
+/** Donut native precompile returns a zero word; ERC20 metadata is a dynamic string. */
+async function readOriginToken(snap, token, chain) {
+    let source;
+    try {
+        source = await snap.read(token, exports.PRC20_SOURCE_ABI, 'SOURCE_TOKEN_ADDRESS');
+    }
+    catch (cause) {
+        if ((await readGasPrc20(snap, chain)) !== (0, viem_1.getAddress)(token))
+            throw cause;
+        const native = await snap.read(token, NATIVE_SOURCE_ABI, 'SOURCE_TOKEN_ADDRESS');
+        if ((0, viem_1.getAddress)(native) === viem_1.zeroAddress)
+            return viem_1.zeroAddress;
+        throw cause;
+    }
+    if ((0, viem_1.isAddress)(source, { strict: false }))
+        return (0, viem_1.getAddress)(source);
+    if (source === '' && (await readGasPrc20(snap, chain)) === (0, viem_1.getAddress)(token))
+        return viem_1.zeroAddress;
+    throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.RULE_READ_FAILED, `PRC20 ${token} has an invalid source token address`);
+}
+//# sourceMappingURL=prc20-metadata.js.map

package/src/lib/agentic/contracts/reader.d.ts

@@ -0,0 +1,35 @@
+import type { Abi, AbiEvent, Address, Hex, Log, PublicClient, TransactionReceipt } from 'viem';
+/**
+ * The narrow chain-read surface the AGW module needs. Tests mock it; the SDK
+ * adapts the Push client's viem PublicClient. Every snapshot read passes an
+ * explicit `blockNumber` so dependent reads observe one state.
+ */
+export interface ChainReader {
+    readContract(args: {
+        address: Address;
+        abi: Abi | readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+        blockNumber?: bigint;
+    }): Promise<unknown>;
+    getBlockNumber(): Promise<bigint>;
+    getCode(args: {
+        address: Address;
+        blockNumber?: bigint;
+    }): Promise<Hex | undefined>;
+    getBalance(args: {
+        address: Address;
+        blockNumber?: bigint;
+    }): Promise<bigint>;
+    getLogs(args: {
+        address: Address;
+        event: AbiEvent;
+        args?: Record<string, unknown>;
+        fromBlock: bigint;
+        toBlock: bigint;
+    }): Promise<Log[]>;
+    getTransactionReceipt(args: {
+        hash: Hex;
+    }): Promise<TransactionReceipt>;
+}
+export declare function chainReaderFromPublicClient(client: PublicClient): ChainReader;

package/src/lib/agentic/contracts/reader.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainReaderFromPublicClient = chainReaderFromPublicClient;
+function chainReaderFromPublicClient(client) {
+    // viem's generics are narrower than this module's needs; the casts are
+    // confined to this adapter.
+    return {
+        readContract: (args) => client.readContract(args),
+        getBlockNumber: () => client.getBlockNumber({ cacheTime: 0 }),
+        getCode: (args) => client.getCode(args),
+        getBalance: (args) => client.getBalance(args),
+        getLogs: (args) => client.getLogs(args),
+        getTransactionReceipt: (args) => client.getTransactionReceipt(args),
+    };
+}
+//# sourceMappingURL=reader.js.map