@pushchain/core 6.0.23 → 6.0.25

package/src/lib/constants/abi/universalReadRegistry.evm.d.ts

@@ -0,0 +1,247 @@
+/** UniversalReadRegistry ABI supplied with the Donut proxy deployment. */
+export declare const UNIVERSAL_READ_REGISTRY_EVM: readonly [{
+    readonly type: "function";
+    readonly name: "read";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "spec";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "account";
+            readonly type: "tuple";
+            readonly internalType: "struct UniversalAccountId";
+            readonly components: readonly [{
+                readonly name: "chainNamespace";
+                readonly type: "string";
+                readonly internalType: "string";
+            }, {
+                readonly name: "chainId";
+                readonly type: "string";
+                readonly internalType: "string";
+            }, {
+                readonly name: "owner";
+                readonly type: "bytes";
+                readonly internalType: "bytes";
+            }];
+        }, {
+            readonly name: "query";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "minConfirmations";
+            readonly type: "uint16";
+            readonly internalType: "uint16";
+        }, {
+            readonly name: "blockNumber";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "expiryPushChainHeight";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "maxFee";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "revertRecipient";
+            readonly type: "address";
+            readonly internalType: "address";
+        }];
+    }, {
+        readonly name: "queryKey";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "callbackGasLimit";
+        readonly type: "uint64";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "constructor";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "universalCallback_";
+    }];
+}, {
+    readonly name: "initialize";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "getLocalContext";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "requestId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bytes";
+    }];
+}, {
+    readonly name: "hasResult";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "requestId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "onUniversalData";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "requestId";
+    }, {
+        readonly type: "bytes";
+        readonly name: "resultData";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "queryKeyOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly name: "readerOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "requestOrderOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "universalCallback";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "resultByRequestId";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "requestId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint256";
+            readonly name: "requestId";
+        }, {
+            readonly type: "bytes";
+            readonly name: "resultData";
+        }, {
+            readonly type: "uint64";
+            readonly name: "updatedAtBlock";
+        }];
+    }];
+}, {
+    readonly name: "latestResult";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "reader";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "queryKey";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint256";
+            readonly name: "requestId";
+        }, {
+            readonly type: "bytes";
+            readonly name: "resultData";
+        }, {
+            readonly type: "uint64";
+            readonly name: "updatedAtBlock";
+        }];
+    }];
+}, {
+    readonly name: "Initialized";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint64";
+        readonly name: "version";
+    }];
+}, {
+    readonly name: "RegistryReadRequested";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "requestId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "reader";
+        readonly indexed: true;
+    }, {
+        readonly type: "bytes32";
+        readonly name: "queryKey";
+        readonly indexed: true;
+    }];
+}, {
+    readonly name: "RegistryReadStored";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "requestId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "reader";
+        readonly indexed: true;
+    }, {
+        readonly type: "bytes32";
+        readonly name: "queryKey";
+        readonly indexed: true;
+    }];
+}, {
+    readonly name: "InvalidInitialization";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "NotInitializing";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "UnauthorizedCaller";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}, {
+    readonly name: "ZeroAddressInit";
+    readonly type: "error";
+    readonly inputs: readonly [];
+}];

package/src/lib/constants/abi/universalReadRegistry.evm.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNIVERSAL_READ_REGISTRY_EVM = void 0;
+const viem_1 = require("viem");
+const universalCallback_evm_1 = require("./universalCallback.evm");
+/** UniversalReadRegistry ABI supplied with the Donut proxy deployment. */
+exports.UNIVERSAL_READ_REGISTRY_EVM = [
+    {
+        type: 'function', name: 'read', stateMutability: 'payable',
+        inputs: [
+            { name: 'spec', type: 'tuple', components: universalCallback_evm_1.READ_SPEC_COMPONENTS },
+            { name: 'queryKey', type: 'bytes32' },
+            { name: 'callbackGasLimit', type: 'uint64' },
+        ],
+        outputs: [{ name: 'requestId', type: 'uint256' }],
+    },
+    ...(0, viem_1.parseAbi)([
+        'constructor(address universalCallback_)',
+        'function initialize()',
+        'function getLocalContext(uint256 requestId) view returns (bytes)',
+        'function hasResult(uint256 requestId) view returns (bool)',
+        'function onUniversalData(uint256 requestId, bytes resultData)',
+        'function queryKeyOf(uint256) view returns (bytes32)',
+        'function readerOf(uint256) view returns (address)',
+        'function requestOrderOf(uint256) view returns (uint256)',
+        'function universalCallback() view returns (address)',
+        'function resultByRequestId(uint256 requestId) view returns ((uint256 requestId, bytes resultData, uint64 updatedAtBlock))',
+        'function latestResult(address reader, bytes32 queryKey) view returns ((uint256 requestId, bytes resultData, uint64 updatedAtBlock))',
+        'event Initialized(uint64 version)',
+        'event RegistryReadRequested(uint256 indexed requestId, address indexed reader, bytes32 indexed queryKey)',
+        'event RegistryReadStored(uint256 indexed requestId, address indexed reader, bytes32 indexed queryKey)',
+        'error InvalidInitialization()',
+        'error NotInitializing()',
+        'error UnauthorizedCaller()',
+        'error ZeroAddressInit()',
+    ]),
+];
+//# sourceMappingURL=universalReadRegistry.evm.js.map

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

@@ -15,6 +15,18 @@ export declare const UEA_PROXY: Record<PUSH_NETWORK, `0x${string}`>;
  * Used to read UEA_VERSION (minRequiredVersion) and UEA_MIGRATION_CONTRACT.
  */
 export declare const UEA_FACTORY: Record<PUSH_NETWORK, `0x${string}`>;
+/**
+ * UniversalCore — genesis predeploy, identical on every network. The read path
+ * uses it for the destination-height ceiling (`chainHeightByChainNamespace`,
+ * CAIP-2 keyed) and the read protocol fee (`readBaseFeeByChainNamespace`).
+ */
+export declare const UNIVERSAL_CORE_ADDRESSES: Record<PUSH_NETWORK, `0x${string}`>;
+/**
+ * UniversalCallback — the read-request contract, genesis predeploy at 0x…C2.
+ * Apps call `requestExternalReadSelf` on it; the SDK reads `estimateFee`,
+ * `statusOf` and parses its events. Same address on every network.
+ */
+export declare const UNIVERSAL_CALLBACK_ADDRESSES: Record<PUSH_NETWORK, `0x${string}`>;
 /**
  * UEAMigration contract address on Push Chain.
  * Used in MsgMigrateUEA to specify which migration contract to delegatecall.

package/src/lib/constants/chain.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHAIN_EXPLORERS = exports.CEA_FACTORY_ADDRESSES = exports.VAULT_ADDRESSES = exports.SVM_PYTH_PRICE_FEED = exports.UNIVERSAL_GATEWAY_ADDRESSES = exports.PUSH_VIEM_CHAINS = exports.PUSH_CHAIN_INFO = exports.CHAIN_INFO = exports.PUSH_BATCH_EXECUTOR_ADDRESS = exports.SYNTHETIC_PUSH_ERC20 = exports.UEA_MIGRATION = exports.UEA_FACTORY = exports.UEA_PROXY = exports.VM_NAMESPACE = void 0;
+exports.CHAIN_EXPLORERS = exports.CEA_FACTORY_ADDRESSES = exports.VAULT_ADDRESSES = exports.SVM_PYTH_PRICE_FEED = exports.UNIVERSAL_GATEWAY_ADDRESSES = exports.PUSH_VIEM_CHAINS = exports.PUSH_CHAIN_INFO = exports.CHAIN_INFO = exports.PUSH_BATCH_EXECUTOR_ADDRESS = exports.SYNTHETIC_PUSH_ERC20 = exports.UEA_MIGRATION = exports.UNIVERSAL_CALLBACK_ADDRESSES = exports.UNIVERSAL_CORE_ADDRESSES = exports.UEA_FACTORY = exports.UEA_PROXY = exports.VM_NAMESPACE = void 0;
 exports.getBatchExecutorAddress = getBatchExecutorAddress;
 exports.getPushViemChain = getPushViemChain;
 exports.getExplorerTxUrl = getExplorerTxUrl;
@@ -36,6 +36,28 @@ exports.UEA_FACTORY = {
     [enums_1.PUSH_NETWORK.TESTNET]: '0x00000000000000000000000000000000000000eA',
     [enums_1.PUSH_NETWORK.LOCALNET]: '0x00000000000000000000000000000000000000eA',
 };
+/**
+ * UniversalCore — genesis predeploy, identical on every network. The read path
+ * uses it for the destination-height ceiling (`chainHeightByChainNamespace`,
+ * CAIP-2 keyed) and the read protocol fee (`readBaseFeeByChainNamespace`).
+ */
+exports.UNIVERSAL_CORE_ADDRESSES = {
+    [enums_1.PUSH_NETWORK.MAINNET]: '0x00000000000000000000000000000000000000C0',
+    [enums_1.PUSH_NETWORK.TESTNET_DONUT]: '0x00000000000000000000000000000000000000C0',
+    [enums_1.PUSH_NETWORK.TESTNET]: '0x00000000000000000000000000000000000000C0',
+    [enums_1.PUSH_NETWORK.LOCALNET]: '0x00000000000000000000000000000000000000C0',
+};
+/**
+ * UniversalCallback — the read-request contract, genesis predeploy at 0x…C2.
+ * Apps call `requestExternalReadSelf` on it; the SDK reads `estimateFee`,
+ * `statusOf` and parses its events. Same address on every network.
+ */
+exports.UNIVERSAL_CALLBACK_ADDRESSES = {
+    [enums_1.PUSH_NETWORK.MAINNET]: '0x00000000000000000000000000000000000000c2',
+    [enums_1.PUSH_NETWORK.TESTNET_DONUT]: '0x00000000000000000000000000000000000000c2',
+    [enums_1.PUSH_NETWORK.TESTNET]: '0x00000000000000000000000000000000000000c2',
+    [enums_1.PUSH_NETWORK.LOCALNET]: '0x00000000000000000000000000000000000000c2',
+};
 /**
  * UEAMigration contract address on Push Chain.
  * Used in MsgMigrateUEA to specify which migration contract to delegatecall.

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

@@ -26,6 +26,13 @@ export declare enum CHAIN {
     SOLANA_TESTNET = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z",
     SOLANA_DEVNET = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"
 }
+/**
+ * Read-only destination exposed with the OG `CHAIN.WEB2` spelling without
+ * widening the blockchain enum type accepted by transaction APIs.
+ */
+export declare namespace CHAIN {
+    const WEB2: "web2:https";
+}
 /**
  * Represents the virtual machine or execution environment for a chain.
  */

package/src/lib/constants/enums.js

@@ -34,6 +34,17 @@ var CHAIN;
     CHAIN["SOLANA_TESTNET"] = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
     CHAIN["SOLANA_DEVNET"] = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
 })(CHAIN || (exports.CHAIN = CHAIN = {}));
+/**
+ * Read-only destination exposed with the OG `CHAIN.WEB2` spelling without
+ * widening the blockchain enum type accepted by transaction APIs.
+ */
+// eslint-disable-next-line @typescript-eslint/no-namespace -- declaration merging keeps Web2 out of the transaction enum union
+(function (CHAIN) {
+    CHAIN.WEB2 = 'web2:https';
+})(CHAIN || (exports.CHAIN = CHAIN = {}));
+// Namespace properties are normally enumerable after TypeScript emits them.
+// Keep blockchain enumeration (`Object.values(CHAIN)`) blockchain-only.
+Object.defineProperty(CHAIN, 'WEB2', { value: CHAIN.WEB2, enumerable: false });
 /**
  * Represents the virtual machine or execution environment for a chain.
  */

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

@@ -1,5 +1,31 @@
 import { CHAIN, LIBRARY, PUSH_NETWORK } from './enums';
 import { TypedDataDomain, TypedData } from '../universal/signer/signer.types';
+import { UNIVERSAL_READ_STATUS, READ_STATUS, READ_ERROR_CODE } from '../read-state/read-state.types';
+/** `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";
+    readonly NAMESPACE: {
+        readonly EVM: "eip155";
+        readonly SVM: "solana";
+        readonly WEB2: "web2";
+    };
+    readonly MAX_CALLBACK_GAS_LIMIT: 1000000n;
+    readonly MIN_CONFIRMATIONS_FLOOR: 1;
+    readonly DEFAULT_EXPIRY_BLOCKS: 300n;
+    readonly CALLBACK_BUDGET_BUFFER: 3;
+    readonly REGISTRY_CALLBACK_GAS: 500000n;
+    readonly UNIVERSAL_READ_REGISTRY_ADDRESS: {
+        readonly TESTNET_DONUT: "0x91b09DAd1774bAfDE679F9ebB5F9046AE2b928C8";
+    };
+    readonly WEB2_MAX_EXTRACT_ENTRIES: 16;
+    readonly WEB2_DEFAULT_TIMEOUT_MS: 5000;
+    readonly UNIVERSAL_CORE_ADDRESSES: Record<PUSH_NETWORK, `0x${string}`>;
+    readonly UNIVERSAL_CALLBACK_ADDRESSES: Record<PUSH_NETWORK, `0x${string}`>;
+    readonly STATUS: typeof UNIVERSAL_READ_STATUS;
+    readonly RESULT_STATUS: typeof READ_STATUS;
+    readonly ERROR_CODE: typeof READ_ERROR_CODE;
+};
 export type { MoveableToken, PayableToken, PushChainMoveableToken, ChainSuffixAccessor, UsdcChainSuffixAccessor, PushChainMoveableTokenAccessor, MoveableTokenConstantsMap, PayableTokenConstantsMap, } from './tokens';
 export declare const CONSTANTS: {
     PUSH_NETWORK: typeof PUSH_NETWORK;
@@ -11,7 +37,33 @@ export declare const CONSTANTS: {
     PAYABLE: {
         TOKEN: import("./tokens").PayableTokenConstantsMap;
     };
+    READ: {
+        /** Read-only Web2 destination. Equivalent to `CHAIN.WEB2`. */
+        readonly WEB2: "web2:https";
+        readonly NAMESPACE: {
+            readonly EVM: "eip155";
+            readonly SVM: "solana";
+            readonly WEB2: "web2";
+        };
+        readonly MAX_CALLBACK_GAS_LIMIT: 1000000n;
+        readonly MIN_CONFIRMATIONS_FLOOR: 1;
+        readonly DEFAULT_EXPIRY_BLOCKS: 300n;
+        readonly CALLBACK_BUDGET_BUFFER: 3;
+        readonly REGISTRY_CALLBACK_GAS: 500000n;
+        readonly UNIVERSAL_READ_REGISTRY_ADDRESS: {
+            readonly TESTNET_DONUT: "0x91b09DAd1774bAfDE679F9ebB5F9046AE2b928C8";
+        };
+        readonly WEB2_MAX_EXTRACT_ENTRIES: 16;
+        readonly WEB2_DEFAULT_TIMEOUT_MS: 5000;
+        readonly UNIVERSAL_CORE_ADDRESSES: Record<PUSH_NETWORK, `0x${string}`>;
+        readonly UNIVERSAL_CALLBACK_ADDRESSES: Record<PUSH_NETWORK, `0x${string}`>;
+        readonly STATUS: typeof UNIVERSAL_READ_STATUS;
+        readonly RESULT_STATUS: typeof READ_STATUS;
+        readonly ERROR_CODE: typeof READ_ERROR_CODE;
+    };
 };
 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, DEFAULT_CEA_TO_PUSH_GAS_LIMIT, } from './selectors';
+export { UNIVERSAL_CORE_ADDRESSES, UNIVERSAL_CALLBACK_ADDRESSES } from './chain';
+export * from './read-state';

package/src/lib/constants/index.js

@@ -1,8 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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;
+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");
+/** `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,
+    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,
+    DEFAULT_EXPIRY_BLOCKS: read_state_1.DEFAULT_EXPIRY_BLOCKS,
+    CALLBACK_BUDGET_BUFFER: read_state_1.CALLBACK_BUDGET_BUFFER,
+    REGISTRY_CALLBACK_GAS: read_state_1.REGISTRY_CALLBACK_GAS,
+    UNIVERSAL_READ_REGISTRY_ADDRESS: read_state_1.UNIVERSAL_READ_REGISTRY_ADDRESS,
+    WEB2_MAX_EXTRACT_ENTRIES: read_state_1.WEB2_MAX_EXTRACT_ENTRIES,
+    WEB2_DEFAULT_TIMEOUT_MS: read_state_1.WEB2_DEFAULT_TIMEOUT_MS,
+    UNIVERSAL_CORE_ADDRESSES: chain_1.UNIVERSAL_CORE_ADDRESSES,
+    UNIVERSAL_CALLBACK_ADDRESSES: chain_1.UNIVERSAL_CALLBACK_ADDRESSES,
+    STATUS: read_state_types_1.UNIVERSAL_READ_STATUS,
+    RESULT_STATUS: read_state_types_1.READ_STATUS,
+    ERROR_CODE: read_state_types_1.READ_ERROR_CODE,
+};
 // NOTE - Only include enums & constants which need to be exported to end user.
 exports.CONSTANTS = {
     PUSH_NETWORK: enums_1.PUSH_NETWORK,
@@ -10,15 +33,16 @@ exports.CONSTANTS = {
     LIBRARY: enums_1.LIBRARY,
     MOVEABLE: { TOKEN: tokens_1.MOVEABLE_TOKEN_CONSTANTS },
     PAYABLE: { TOKEN: tokens_1.PAYABLE_TOKEN_CONSTANTS },
+    READ: exports.READ_CONSTANTS,
 };
 // Multi-chain configuration exports
-var chain_1 = require("./chain");
-Object.defineProperty(exports, "CHAIN_EXPLORERS", { enumerable: true, get: function () { return chain_1.CHAIN_EXPLORERS; } });
-Object.defineProperty(exports, "CEA_FACTORY_ADDRESSES", { enumerable: true, get: function () { return chain_1.CEA_FACTORY_ADDRESSES; } });
-Object.defineProperty(exports, "UNIVERSAL_GATEWAY_ADDRESSES", { enumerable: true, get: function () { return chain_1.UNIVERSAL_GATEWAY_ADDRESSES; } });
-Object.defineProperty(exports, "VAULT_ADDRESSES", { enumerable: true, get: function () { return chain_1.VAULT_ADDRESSES; } });
-Object.defineProperty(exports, "getExplorerTxUrl", { enumerable: true, get: function () { return chain_1.getExplorerTxUrl; } });
-Object.defineProperty(exports, "getExplorerAddressUrl", { enumerable: true, get: function () { return chain_1.getExplorerAddressUrl; } });
+var chain_2 = require("./chain");
+Object.defineProperty(exports, "CHAIN_EXPLORERS", { enumerable: true, get: function () { return chain_2.CHAIN_EXPLORERS; } });
+Object.defineProperty(exports, "CEA_FACTORY_ADDRESSES", { enumerable: true, get: function () { return chain_2.CEA_FACTORY_ADDRESSES; } });
+Object.defineProperty(exports, "UNIVERSAL_GATEWAY_ADDRESSES", { enumerable: true, get: function () { return chain_2.UNIVERSAL_GATEWAY_ADDRESSES; } });
+Object.defineProperty(exports, "VAULT_ADDRESSES", { enumerable: true, get: function () { return chain_2.VAULT_ADDRESSES; } });
+Object.defineProperty(exports, "getExplorerTxUrl", { enumerable: true, get: function () { return chain_2.getExplorerTxUrl; } });
+Object.defineProperty(exports, "getExplorerAddressUrl", { enumerable: true, get: function () { return chain_2.getExplorerAddressUrl; } });
 // Selectors and constants for multi-chain transactions
 var selectors_1 = require("./selectors");
 Object.defineProperty(exports, "MULTICALL_SELECTOR", { enumerable: true, get: function () { return selectors_1.MULTICALL_SELECTOR; } });
@@ -28,4 +52,9 @@ Object.defineProperty(exports, "TX_TYPE", { enumerable: true, get: function () {
 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; } });
+// Read state (cross-chain reads)
+var chain_3 = require("./chain");
+Object.defineProperty(exports, "UNIVERSAL_CORE_ADDRESSES", { enumerable: true, get: function () { return chain_3.UNIVERSAL_CORE_ADDRESSES; } });
+Object.defineProperty(exports, "UNIVERSAL_CALLBACK_ADDRESSES", { enumerable: true, get: function () { return chain_3.UNIVERSAL_CALLBACK_ADDRESSES; } });
+tslib_1.__exportStar(require("./read-state"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,53 @@
+/**
+ * Read-state (cross-chain read) constants.
+ *
+ * Contract-derived values are pinned to the deployed `UniversalCallback`
+ * (push-chain-core-contracts@feat-read-state, f8d1a0c) and verified by
+ * `read-state/__tests__/abi-selectors.spec.ts`.
+ */
+/** Hard upper bound on the gas an app callback may declare — `ReadTypes.sol:50`. */
+export declare const MAX_CALLBACK_GAS_LIMIT = 1000000n;
+/** Registry default; large results may need an explicit override up to the maximum. */
+export declare const REGISTRY_CALLBACK_GAS = 500000n;
+/** Verified proxy on Donut. Other networks intentionally have no default receiver. */
+export declare const UNIVERSAL_READ_REGISTRY_ADDRESS: {
+    readonly TESTNET_DONUT: "0x91b09DAd1774bAfDE679F9ebB5F9046AE2b928C8";
+};
+/** Contract rejects anything below this — `ReadTypes.sol:43`. */
+export declare const MIN_CONFIRMATIONS_FLOOR = 1;
+/** Default lifetime of a request in Push blocks (~1.3 s each on Donut). */
+export declare const DEFAULT_EXPIRY_BLOCKS = 300n;
+/**
+ * Multiple of `callbackGasLimit × pushGasPrice` escrowed as the callback budget.
+ * The node refuses to fulfil a read whose budget cannot cover its callback, so
+ * this errs high; the unspent remainder is refunded to `refundTo`.
+ */
+export declare const CALLBACK_BUDGET_BUFFER = 3;
+/** `universalClient/externalchains/web2/read_envelope.go` — maxExtractEntries. */
+export declare const WEB2_MAX_EXTRACT_ENTRIES = 16;
+export declare const WEB2_DEFAULT_TIMEOUT_MS = 5000;
+/** Validators clamp anything above this. */
+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`.
+ */
+export declare const WEB2_DESTINATION: {
+    readonly chainNamespace: "web2";
+    readonly chainId: "https";
+};
+/** CAIP-2 namespaces the read path understands, keyed by how the node routes them. */
+export declare const READ_NAMESPACE: {
+    readonly EVM: "eip155";
+    readonly SVM: "solana";
+    readonly WEB2: "web2";
+};
+export type ReadNamespace = (typeof READ_NAMESPACE)[keyof typeof READ_NAMESPACE];
+/** Donut block time, measured over 100 blocks on 2026-09-09 (134 s / 100). Used to size the default wait. */
+export declare const PUSH_BLOCK_TIME_MS = 1340;
+export declare const READ_TRACK_POLL_INTERVAL_MS = 2000;
+export declare const READ_TRACK_MIN_POLL_INTERVAL_MS = 500;
+/** Default `wait()` timeout is `expiryBlocks × PUSH_BLOCK_TIME_MS`, capped here. */
+export declare const READ_TRACK_MAX_TIMEOUT_MS = 180000;
+/** How long `trackRead` keeps looking for a record the node has not ingested yet. */
+export declare const READ_TRACK_LOOKUP_TIMEOUT_MS = 30000;

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

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Read-state (cross-chain read) constants.
+ *
+ * Contract-derived values are pinned to the deployed `UniversalCallback`
+ * (push-chain-core-contracts@feat-read-state, f8d1a0c) and verified by
+ * `read-state/__tests__/abi-selectors.spec.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.READ_TRACK_LOOKUP_TIMEOUT_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;
+/** Hard upper bound on the gas an app callback may declare — `ReadTypes.sol:50`. */
+exports.MAX_CALLBACK_GAS_LIMIT = 1000000n;
+/** Registry default; large results may need an explicit override up to the maximum. */
+exports.REGISTRY_CALLBACK_GAS = 500000n;
+/** Verified proxy on Donut. Other networks intentionally have no default receiver. */
+exports.UNIVERSAL_READ_REGISTRY_ADDRESS = {
+    TESTNET_DONUT: '0x91b09DAd1774bAfDE679F9ebB5F9046AE2b928C8',
+};
+/** Contract rejects anything below this — `ReadTypes.sol:43`. */
+exports.MIN_CONFIRMATIONS_FLOOR = 1;
+/** Default lifetime of a request in Push blocks (~1.3 s each on Donut). */
+exports.DEFAULT_EXPIRY_BLOCKS = 300n;
+/**
+ * Multiple of `callbackGasLimit × pushGasPrice` escrowed as the callback budget.
+ * The node refuses to fulfil a read whose budget cannot cover its callback, so
+ * this errs high; the unspent remainder is refunded to `refundTo`.
+ */
+exports.CALLBACK_BUDGET_BUFFER = 3;
+/** `universalClient/externalchains/web2/read_envelope.go` — maxExtractEntries. */
+exports.WEB2_MAX_EXTRACT_ENTRIES = 16;
+exports.WEB2_DEFAULT_TIMEOUT_MS = 5_000;
+/** Validators clamp anything above this. */
+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`.
+ */
+exports.WEB2_DESTINATION = {
+    chainNamespace: 'web2',
+    chainId: 'https',
+};
+/** CAIP-2 namespaces the read path understands, keyed by how the node routes them. */
+exports.READ_NAMESPACE = {
+    EVM: 'eip155',
+    SVM: 'solana',
+    WEB2: 'web2',
+};
+// ---------------------------------------------------------------------------
+// Tracking (trackRead / wait)
+// ---------------------------------------------------------------------------
+/** Donut block time, measured over 100 blocks on 2026-09-09 (134 s / 100). Used to size the default wait. */
+exports.PUSH_BLOCK_TIME_MS = 1_340;
+exports.READ_TRACK_POLL_INTERVAL_MS = 2_000;
+exports.READ_TRACK_MIN_POLL_INTERVAL_MS = 500;
+/** Default `wait()` timeout is `expiryBlocks × PUSH_BLOCK_TIME_MS`, capped here. */
+exports.READ_TRACK_MAX_TIMEOUT_MS = 180_000;
+/** How long `trackRead` keeps looking for a record the node has not ingested yet. */
+exports.READ_TRACK_LOOKUP_TIMEOUT_MS = 30_000;
+//# sourceMappingURL=read-state.js.map

package/src/lib/generated/ucallback/v1/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './query';

package/src/lib/generated/ucallback/v1/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./query"), exports);
+//# sourceMappingURL=index.js.map