@augustdigital/sdk 8.11.0 → 8.13.0

package/lib/adapters/evm/index.d.ts

@@ -1,5 +1,5 @@
 import { type IContractWriteOptions, type INativeDepositOptions, type ApproveResult } from '../../modules/vaults/write.actions';
-import type { ISwapAndDepositOptions, ISwapRouterDirectDepositOptions, ISwapRouterNativeDepositOptions, ISwapRouterDepositOptions } from '../../types';
+import type { ISwapAndDepositOptions, ISwapRouterDirectDepositOptions, ISwapRouterNativeDepositOptions, ISwapRouterDepositOptions, ISwapRouterDepositResultOptions } from '../../types';
 import { type IPreviewDepositOptions, type IPreviewRedeemOptions, type IAllowanceOptions, type IBalanceOfOptions, type IMaxDepositOptions } from '../../modules/vaults/read.actions';
 import { type CompatibleSigner } from '../../core/helpers/signer';
 import type { IAddress } from '../../types';
@@ -214,6 +214,22 @@ declare class EVMAdapter {
      * ```
      */
     swapRouterDeposit(options: ISwapRouterDepositOptions): Promise<string>;
+    /**
+     * Resolves the real, post-execution outcome of a SwapRouter deposit from
+     * its mined receipt — the actual amount that reached the vault (and shares
+     * minted), decoded from the vault's own `Deposit` event, rather than the
+     * pre-trade quote shown before submission.
+     *
+     * @param options - {@link ISwapRouterDepositResultOptions}.
+     * @returns The decoded {@link ISwapRouterDepositResult}, or `null` if the
+     *   receipt isn't found yet or carries no matching `Deposit` log.
+     * @example
+     * ```ts
+     * const hash = await augustSdk.evm.swapRouterDeposit({ ... });
+     * const result = await augustSdk.evm.getSwapRouterDepositResult({ txHash: hash, vault });
+     * ```
+     */
+    getSwapRouterDepositResult(options: ISwapRouterDepositResultOptions): Promise<import("../../types").ISwapRouterDepositResult>;
     /**
      * Claim assets from a matured redemption request on a dated-redemption
      * (RWA-style) vault. The `year`, `month`, `day`, and `receiverIndex` tuple

package/lib/adapters/evm/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const write_actions_1 = require("../../modules/vaults/write.actions");
+const swap_router_1 = require("../../core/helpers/swap-router");
 const read_actions_1 = require("../../modules/vaults/read.actions");
 const signer_1 = require("../../core/helpers/signer");
 __exportStar(require("./getters"), exports);
@@ -277,6 +278,25 @@ class EVMAdapter {
         const signer = await this.getSigner();
         return (0, write_actions_1.swapRouterDeposit)(signer, options);
     }
+    /**
+     * Resolves the real, post-execution outcome of a SwapRouter deposit from
+     * its mined receipt — the actual amount that reached the vault (and shares
+     * minted), decoded from the vault's own `Deposit` event, rather than the
+     * pre-trade quote shown before submission.
+     *
+     * @param options - {@link ISwapRouterDepositResultOptions}.
+     * @returns The decoded {@link ISwapRouterDepositResult}, or `null` if the
+     *   receipt isn't found yet or carries no matching `Deposit` log.
+     * @example
+     * ```ts
+     * const hash = await augustSdk.evm.swapRouterDeposit({ ... });
+     * const result = await augustSdk.evm.getSwapRouterDepositResult({ txHash: hash, vault });
+     * ```
+     */
+    async getSwapRouterDepositResult(options) {
+        const signer = await this.getSigner();
+        return (0, swap_router_1.getSwapRouterDepositResult)(signer, options);
+    }
     /**
      * Claim assets from a matured redemption request on a dated-redemption
      * (RWA-style) vault. The `year`, `month`, `day`, and `receiverIndex` tuple

package/lib/core/analytics/method-taxonomy.js

@@ -39,6 +39,9 @@ exports.METHOD_CATEGORIES = {
     getVaultBorrowerHealthFactor: 'read.vault',
     getYieldLastRealizedOn: 'read.vault',
     getVaultActivity: 'read.vault',
+    getSwapRouterDepositResult: 'read.vault',
+    getSwapRouterWhitelistedTokens: 'read.vault',
+    getSwapRouterEligibleVaults: 'read.vault',
     getVaultPositions: 'read.position',
     getVaultUserHistory: 'read.position',
     getUserHistory: 'read.position',

package/lib/core/analytics/version.d.ts

@@ -3,4 +3,4 @@
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-export declare const SDK_VERSION = "8.11.0";
+export declare const SDK_VERSION = "8.13.0";

package/lib/core/analytics/version.js

@@ -6,5 +6,5 @@ exports.SDK_VERSION = void 0;
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-exports.SDK_VERSION = '8.11.0';
+exports.SDK_VERSION = '8.13.0';
 //# sourceMappingURL=version.js.map

package/lib/core/constants/swap-router.d.ts

@@ -8,6 +8,20 @@ import type { IAddress } from '../../types';
  * @see {@link getSwapRouterAddress} for the typed lookup helper.
  */
 export declare const SWAP_ROUTER_ADDRESSES: Readonly<Record<number, IAddress>>;
+/**
+ * Human-readable display name of the `SwapRouter` periphery contract on each
+ * supported chain.
+ *
+ * The contract exposes no on-chain name (no `@title` accessor), so UIs that
+ * want to show *which contract* performed the swap-and-deposit — rather than a
+ * bare address — read it from here. Display metadata only: never derive
+ * routing or eligibility logic from it.
+ *
+ * Missing keys mean no SwapRouter is deployed on that chain.
+ *
+ * @see {@link getSwapRouterName} for the typed lookup helper.
+ */
+export declare const SWAP_ROUTER_NAMES: Readonly<Record<number, string>>;
 /**
  * Vaults whose UI **may offer the any-token SwapRouter deposit surface** —
  * i.e. the SwapRouter is `enableVault`-ed for them on-chain.
@@ -31,15 +45,41 @@ export declare const SWAP_ROUTER_ADDRESSES: Readonly<Record<number, IAddress>>;
  *
  * Lowercase comparison is required when checking — use
  * {@link isSwapRouterEligible} rather than reading this set directly.
+ *
+ * @deprecated Superseded by {@link getSwapRouterEligibleVaults}, which derives
+ * the eligible set from the router's on-chain `VaultEnabled` history and
+ * verifies each vault's current registration (`vaultInfo.referenceAsset != 0`)
+ * — so new enablements surface without an SDK release. This static set stays
+ * functional as the zero-RPC fallback seed (e.g. TanStack Query `initialData`)
+ * and for SDK-internal sync consumers.
  */
 export declare const SWAP_ROUTER_ELIGIBLE_VAULTS: ReadonlySet<string>;
 /**
- * @deprecated Renamed to {@link SWAP_ROUTER_ELIGIBLE_VAULTS}, and the semantics
- * changed: this set no longer drives `vaultDeposit` auto-routing (that branch
- * was removed) — it now only marks vaults whose UI may offer the swap-router
- * deposit surface. Kept as an alias for one release; migrate to the new name.
+ * @deprecated Renamed to {@link SWAP_ROUTER_ELIGIBLE_VAULTS} (itself now
+ * superseded by {@link getSwapRouterEligibleVaults}, the on-chain-derived
+ * resolver), and the semantics changed: this set no longer drives
+ * `vaultDeposit` auto-routing (that branch was removed) — it only marks vaults
+ * whose UI may offer the swap-router deposit surface. Kept as an alias for one
+ * release; migrate to the async resolver.
  */
 export declare const VAULTS_USING_SWAP_ROUTER: ReadonlySet<string>;
+/**
+ * Block at which each chain's `SwapRouter` was deployed/configured — the safe
+ * lower bound for scanning its `TokenEnabled` / `VaultEnabled` log history.
+ *
+ * The router stores its allowlist as `mapping(address => bool) whitelistedTokens`
+ * with no on-chain enumeration, so {@link getSwapRouterWhitelistedTokens} must
+ * reconstruct the candidate set from `TokenEnabled` events before verifying each
+ * against the current mapping. Starting the `eth_getLogs` scan here (rather than
+ * from genesis) bounds it to the router's own lifetime — a few chunks — instead
+ * of the whole chain.
+ *
+ * Mainnet value is the router's deployment block (its first emitted event, the
+ * constructor `OwnershipTransferred`). A too-low value only costs extra empty
+ * log ranges; a value ABOVE the first `TokenEnabled` would silently miss tokens,
+ * so err on the side of earlier.
+ */
+export declare const SWAP_ROUTER_DEPLOY_BLOCKS: Readonly<Record<number, number>>;
 /**
  * 32-byte origin codes registered on the `SwapRouter` via `addOrigin`.
  * Drives origin/referral-fee accrual. The on-chain admin must register a
@@ -105,4 +145,6 @@ export declare const SWAP_ROUTER_DEX_AGGREGATOR: Readonly<Record<number, {
     router: IAddress;
     contractMethod: string;
     selector: `0x${string}`;
+    /** Human-readable aggregator name — for display; never derive routing logic from it. */
+    name: string;
 }>>;

package/lib/core/constants/swap-router.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SWAP_ROUTER_DEX_AGGREGATOR = exports.SWAP_ROUTER_WRAPPED_NATIVE = exports.SWAP_ROUTER_MAX_SWAPS = exports.ORIGIN_CODES = exports.VAULTS_USING_SWAP_ROUTER = exports.SWAP_ROUTER_ELIGIBLE_VAULTS = exports.SWAP_ROUTER_ADDRESSES = void 0;
+exports.SWAP_ROUTER_DEX_AGGREGATOR = exports.SWAP_ROUTER_WRAPPED_NATIVE = exports.SWAP_ROUTER_MAX_SWAPS = exports.ORIGIN_CODES = exports.SWAP_ROUTER_DEPLOY_BLOCKS = exports.VAULTS_USING_SWAP_ROUTER = exports.SWAP_ROUTER_ELIGIBLE_VAULTS = exports.SWAP_ROUTER_NAMES = exports.SWAP_ROUTER_ADDRESSES = void 0;
 /**
  * Address of the `SwapRouter` periphery contract on each supported chain.
  *
@@ -12,6 +12,22 @@ exports.SWAP_ROUTER_DEX_AGGREGATOR = exports.SWAP_ROUTER_WRAPPED_NATIVE = export
 exports.SWAP_ROUTER_ADDRESSES = {
     1: '0xAC771209FF2b71EECfF6E85a9AD01db8Ff2618B0',
 };
+/**
+ * Human-readable display name of the `SwapRouter` periphery contract on each
+ * supported chain.
+ *
+ * The contract exposes no on-chain name (no `@title` accessor), so UIs that
+ * want to show *which contract* performed the swap-and-deposit — rather than a
+ * bare address — read it from here. Display metadata only: never derive
+ * routing or eligibility logic from it.
+ *
+ * Missing keys mean no SwapRouter is deployed on that chain.
+ *
+ * @see {@link getSwapRouterName} for the typed lookup helper.
+ */
+exports.SWAP_ROUTER_NAMES = {
+    1: 'Upshift Swap Router',
+};
 /**
  * Vaults whose UI **may offer the any-token SwapRouter deposit surface** —
  * i.e. the SwapRouter is `enableVault`-ed for them on-chain.
@@ -35,6 +51,13 @@ exports.SWAP_ROUTER_ADDRESSES = {
  *
  * Lowercase comparison is required when checking — use
  * {@link isSwapRouterEligible} rather than reading this set directly.
+ *
+ * @deprecated Superseded by {@link getSwapRouterEligibleVaults}, which derives
+ * the eligible set from the router's on-chain `VaultEnabled` history and
+ * verifies each vault's current registration (`vaultInfo.referenceAsset != 0`)
+ * — so new enablements surface without an SDK release. This static set stays
+ * functional as the zero-RPC fallback seed (e.g. TanStack Query `initialData`)
+ * and for SDK-internal sync consumers.
  */
 exports.SWAP_ROUTER_ELIGIBLE_VAULTS = new Set([
     // Sentora USD — native multi-asset Tokenized Vault V2 (reference asset
@@ -43,12 +66,33 @@ exports.SWAP_ROUTER_ELIGIBLE_VAULTS = new Set([
     '0x74ad2f789ed583dbd141bbdafc673fe1f033718b',
 ]);
 /**
- * @deprecated Renamed to {@link SWAP_ROUTER_ELIGIBLE_VAULTS}, and the semantics
- * changed: this set no longer drives `vaultDeposit` auto-routing (that branch
- * was removed) — it now only marks vaults whose UI may offer the swap-router
- * deposit surface. Kept as an alias for one release; migrate to the new name.
+ * @deprecated Renamed to {@link SWAP_ROUTER_ELIGIBLE_VAULTS} (itself now
+ * superseded by {@link getSwapRouterEligibleVaults}, the on-chain-derived
+ * resolver), and the semantics changed: this set no longer drives
+ * `vaultDeposit` auto-routing (that branch was removed) — it only marks vaults
+ * whose UI may offer the swap-router deposit surface. Kept as an alias for one
+ * release; migrate to the async resolver.
  */
 exports.VAULTS_USING_SWAP_ROUTER = exports.SWAP_ROUTER_ELIGIBLE_VAULTS;
+/**
+ * Block at which each chain's `SwapRouter` was deployed/configured — the safe
+ * lower bound for scanning its `TokenEnabled` / `VaultEnabled` log history.
+ *
+ * The router stores its allowlist as `mapping(address => bool) whitelistedTokens`
+ * with no on-chain enumeration, so {@link getSwapRouterWhitelistedTokens} must
+ * reconstruct the candidate set from `TokenEnabled` events before verifying each
+ * against the current mapping. Starting the `eth_getLogs` scan here (rather than
+ * from genesis) bounds it to the router's own lifetime — a few chunks — instead
+ * of the whole chain.
+ *
+ * Mainnet value is the router's deployment block (its first emitted event, the
+ * constructor `OwnershipTransferred`). A too-low value only costs extra empty
+ * log ranges; a value ABOVE the first `TokenEnabled` would silently miss tokens,
+ * so err on the side of earlier.
+ */
+exports.SWAP_ROUTER_DEPLOY_BLOCKS = {
+    1: 25237804,
+};
 /**
  * 32-byte origin codes registered on the `SwapRouter` via `addOrigin`.
  * Drives origin/referral-fee accrual. The on-chain admin must register a
@@ -119,6 +163,7 @@ exports.SWAP_ROUTER_DEX_AGGREGATOR = {
         router: '0x6A000F20005980200259B80c5102003040001068',
         contractMethod: 'swapExactAmountIn',
         selector: '0xe3ead59e',
+        name: 'ParaSwap',
     },
 };
 //# sourceMappingURL=swap-router.js.map

package/lib/core/constants/web3.d.ts

@@ -47,6 +47,25 @@ export declare const ORACLE_CONTRACTS: {
 };
 export declare const NETWORKS: Record<IChainId, IChainObj>;
 export declare const AVAILABLE_CHAINS: IChainId[];
+/**
+ * Canonical [Multicall3](https://github.com/mds1/multicall) address, deployed
+ * via the deterministic deployer to the same address on most EVM chains.
+ * @internal
+ */
+export declare const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+/**
+ * Chains where the canonical Multicall3 deployment was **verified on-chain**
+ * (`eth_getCode` returned the 3808-byte runtime at {@link MULTICALL3_ADDRESS};
+ * checked per chain on 2026-07-14, Tempo checked separately on 2026-07-15) —
+ * deterministic-deployer presence is NOT assumed. Chains outside this set
+ * keep the per-call read path.
+ *
+ * Deliberately excluded from `NETWORKS`:
+ * - 4114 (Citrea) — `eth_getCode` returned `0x` (not deployed).
+ * - -1 (Solana), -3 (Stellar) — non-EVM, no Multicall3.
+ * @internal
+ */
+export declare const MULTICALL3_VERIFIED_CHAINS: ReadonlySet<number>;
 /**
  * Fallbacks
  */

package/lib/core/constants/web3.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FALLBACK_RPC_URLS = exports.FALLBACK_CHAINID = exports.FALLBACK_DECIMALS = exports.AVAILABLE_CHAINS = exports.NETWORKS = exports.ORACLE_CONTRACTS = exports.MIN_ABIS = exports.EVM_NATIVE_DECIMALS = exports.NATIVE_ADDRESS = exports.SPECIAL_CHAINS = void 0;
+exports.FALLBACK_RPC_URLS = exports.FALLBACK_CHAINID = exports.FALLBACK_DECIMALS = exports.MULTICALL3_VERIFIED_CHAINS = exports.MULTICALL3_ADDRESS = exports.AVAILABLE_CHAINS = exports.NETWORKS = exports.ORACLE_CONTRACTS = exports.MIN_ABIS = exports.EVM_NATIVE_DECIMALS = exports.NATIVE_ADDRESS = exports.SPECIAL_CHAINS = void 0;
 // Special Chains
 exports.SPECIAL_CHAINS = {
     solana: {
@@ -141,6 +141,42 @@ exports.NETWORKS = {
     },
 };
 exports.AVAILABLE_CHAINS = Object.keys(exports.NETWORKS).map((c) => Number(c));
+/**
+ * Canonical [Multicall3](https://github.com/mds1/multicall) address, deployed
+ * via the deterministic deployer to the same address on most EVM chains.
+ * @internal
+ */
+exports.MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
+/**
+ * Chains where the canonical Multicall3 deployment was **verified on-chain**
+ * (`eth_getCode` returned the 3808-byte runtime at {@link MULTICALL3_ADDRESS};
+ * checked per chain on 2026-07-14, Tempo checked separately on 2026-07-15) —
+ * deterministic-deployer presence is NOT assumed. Chains outside this set
+ * keep the per-call read path.
+ *
+ * Deliberately excluded from `NETWORKS`:
+ * - 4114 (Citrea) — `eth_getCode` returned `0x` (not deployed).
+ * - -1 (Solana), -3 (Stellar) — non-EVM, no Multicall3.
+ * @internal
+ */
+exports.MULTICALL3_VERIFIED_CHAINS = new Set([
+    1, // Ethereum
+    42161, // Arbitrum One
+    8453, // Base
+    43114, // Avalanche
+    137, // Polygon
+    56, // BNB Smart Chain
+    999, // HyperEVM
+    130, // Unichain
+    31612, // Mezo
+    143, // Monad
+    9745, // Plasma
+    57073, // Ink
+    14, // Flare
+    747474, // Katana
+    25363, // Fluent
+    4217, // Tempo
+]);
 /**
  * Fallbacks
  */

package/lib/core/helpers/multicall.d.ts

@@ -0,0 +1,68 @@
+import { type InterfaceAbi } from 'ethers';
+import type { IAddress, IContractRunner } from '../../types';
+/**
+ * One read to fold into a Multicall3 `aggregate3` batch.
+ * @internal
+ */
+export interface IMulticall3Request {
+    /** Contract to call. */
+    target: IAddress;
+    /** ABI containing `functionName` (full or minimal fragment). */
+    abi: InterfaceAbi;
+    /** View function to encode. */
+    functionName: string;
+    /** Positional arguments for the function. */
+    args?: unknown[];
+}
+/**
+ * Per-call result of an `aggregate3` batch. `success: false` means that one
+ * call reverted (or its chunk failed at the transport level) — it never
+ * implies anything about the other calls in the batch.
+ * @internal
+ */
+export interface IMulticall3Result {
+    success: boolean;
+    /** First decoded return value; `undefined` when `success` is `false`. */
+    value?: unknown;
+}
+/**
+ * Calls per `aggregate3` chunk. Mirrors the `batchMaxCount: 10` cap on
+ * `createProvider` — some RPC providers (e.g. rpc.hypurrscan.io) enforce
+ * their own batch/response-size limits, so an unbounded batch for a wallet
+ * with many vaults risks exceeding response-size or `eth_call` gas ceilings.
+ * @internal
+ */
+export declare const MULTICALL3_BATCH_SIZE = 10;
+/**
+ * Whether Multicall3 read-aggregation is enabled for a chain. Only chains in
+ * {@link MULTICALL3_VERIFIED_CHAINS} (deployment verified via `eth_getCode`,
+ * never assumed) qualify — callers must fall back to individual reads for
+ * every other chain.
+ * @internal
+ */
+export declare function isMulticall3Supported(chainId: number | undefined): boolean;
+/**
+ * Aggregate independent view calls into chunked Multicall3 `aggregate3`
+ * batches (`allowFailure: true` per call).
+ *
+ * Failure semantics — the load-bearing detail:
+ * - A reverting inner call (paused/deprecated vault) yields `success: false`
+ *   for that call only; every other call in the batch decodes normally.
+ * - A transport-level failure of one chunk degrades that chunk's calls to
+ *   `success: false` instead of throwing, so a caller can always fall back
+ *   to its per-call path. This function never rejects for RPC reasons.
+ *
+ * RPC cost: `ceil(calls.length / batchSize)` `eth_call`s, versus
+ * `calls.length` without aggregation.
+ *
+ * @param provider Provider for the target chain.
+ * @param chainId Chain the provider is connected to — must be in the
+ *   verified allowlist; gate with {@link isMulticall3Supported} first.
+ * @param calls Reads to aggregate, in order.
+ * @param batchSize Max calls per `aggregate3` chunk.
+ * @returns One {@link IMulticall3Result} per request, index-aligned.
+ * @throws AugustValidationError when `chainId` is not on the verified
+ *   allowlist — programming error, not a runtime condition to swallow.
+ * @internal
+ */
+export declare function multicall3Aggregate(provider: IContractRunner, chainId: number, calls: IMulticall3Request[], batchSize?: number): Promise<IMulticall3Result[]>;

package/lib/core/helpers/multicall.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTICALL3_BATCH_SIZE = void 0;
+exports.isMulticall3Supported = isMulticall3Supported;
+exports.multicall3Aggregate = multicall3Aggregate;
+const ethers_1 = require("ethers");
+const Multicall3_1 = require("../../abis/Multicall3");
+const web3_1 = require("../constants/web3");
+const errors_1 = require("../errors");
+const logger_1 = require("../logger");
+/**
+ * Calls per `aggregate3` chunk. Mirrors the `batchMaxCount: 10` cap on
+ * `createProvider` — some RPC providers (e.g. rpc.hypurrscan.io) enforce
+ * their own batch/response-size limits, so an unbounded batch for a wallet
+ * with many vaults risks exceeding response-size or `eth_call` gas ceilings.
+ * @internal
+ */
+exports.MULTICALL3_BATCH_SIZE = 10;
+/**
+ * Whether Multicall3 read-aggregation is enabled for a chain. Only chains in
+ * {@link MULTICALL3_VERIFIED_CHAINS} (deployment verified via `eth_getCode`,
+ * never assumed) qualify — callers must fall back to individual reads for
+ * every other chain.
+ * @internal
+ */
+function isMulticall3Supported(chainId) {
+    return typeof chainId === 'number' && web3_1.MULTICALL3_VERIFIED_CHAINS.has(chainId);
+}
+/**
+ * Aggregate independent view calls into chunked Multicall3 `aggregate3`
+ * batches (`allowFailure: true` per call).
+ *
+ * Failure semantics — the load-bearing detail:
+ * - A reverting inner call (paused/deprecated vault) yields `success: false`
+ *   for that call only; every other call in the batch decodes normally.
+ * - A transport-level failure of one chunk degrades that chunk's calls to
+ *   `success: false` instead of throwing, so a caller can always fall back
+ *   to its per-call path. This function never rejects for RPC reasons.
+ *
+ * RPC cost: `ceil(calls.length / batchSize)` `eth_call`s, versus
+ * `calls.length` without aggregation.
+ *
+ * @param provider Provider for the target chain.
+ * @param chainId Chain the provider is connected to — must be in the
+ *   verified allowlist; gate with {@link isMulticall3Supported} first.
+ * @param calls Reads to aggregate, in order.
+ * @param batchSize Max calls per `aggregate3` chunk.
+ * @returns One {@link IMulticall3Result} per request, index-aligned.
+ * @throws AugustValidationError when `chainId` is not on the verified
+ *   allowlist — programming error, not a runtime condition to swallow.
+ * @internal
+ */
+async function multicall3Aggregate(provider, chainId, calls, batchSize = exports.MULTICALL3_BATCH_SIZE) {
+    if (!isMulticall3Supported(chainId)) {
+        throw new errors_1.AugustValidationError('INVALID_INPUT', `multicall3Aggregate: Multicall3 deployment is not verified on chain ${chainId} — use the per-call read path instead`);
+    }
+    if (calls.length === 0)
+        return [];
+    const encoded = calls.map((c) => {
+        const iface = new ethers_1.Interface(c.abi);
+        return {
+            target: c.target,
+            allowFailure: true,
+            callData: iface.encodeFunctionData(c.functionName, c.args ?? []),
+            iface,
+            functionName: c.functionName,
+        };
+    });
+    const chunks = [];
+    for (let i = 0; i < encoded.length; i += batchSize) {
+        chunks.push(encoded.slice(i, i + batchSize));
+    }
+    const multicall = new ethers_1.Contract(web3_1.MULTICALL3_ADDRESS, Multicall3_1.ABI_MULTICALL3, provider);
+    const chunkResults = await Promise.all(chunks.map(async (chunk) => {
+        try {
+            const returned = (await multicall.aggregate3(chunk.map((c) => ({
+                target: c.target,
+                allowFailure: c.allowFailure,
+                callData: c.callData,
+            }))));
+            return chunk.map((c, i) => {
+                const r = returned[i];
+                if (!r?.success || !r.returnData || r.returnData === '0x') {
+                    return { success: false, value: undefined };
+                }
+                try {
+                    const decoded = c.iface.decodeFunctionResult(c.functionName, r.returnData);
+                    return { success: true, value: decoded[0] };
+                }
+                catch (decodeError) {
+                    logger_1.Logger.log.warn('multicall3Aggregate', `failed to decode ${c.functionName} result for ${c.target}`, decodeError);
+                    return { success: false, value: undefined };
+                }
+            });
+        }
+        catch (chunkError) {
+            logger_1.Logger.log.warn('multicall3Aggregate', `aggregate3 chunk failed on chain ${chainId} (${chunk.length} calls) — callers fall back to per-call reads`, chunkError);
+            return chunk.map(() => ({ success: false, value: undefined }));
+        }
+    }));
+    return chunkResults.flat();
+}
+//# sourceMappingURL=multicall.js.map