@kehtus/proportion-sdk 0.4.2 → 1.1.0

package/dist/challenge/types.js

@@ -0,0 +1,64 @@
+// ── On-chain enums (order must match Solidity exactly) ──
+/** ChallengeAccount.Phase */
+export var ChallengePhase;
+(function (ChallengePhase) {
+    ChallengePhase[ChallengePhase["Uninitialized"] = 0] = "Uninitialized";
+    ChallengePhase[ChallengePhase["Challenge"] = 1] = "Challenge";
+    ChallengePhase[ChallengePhase["Passed"] = 2] = "Passed";
+    ChallengePhase[ChallengePhase["PaperFunded"] = 3] = "PaperFunded";
+    ChallengePhase[ChallengePhase["Failed"] = 4] = "Failed";
+    ChallengePhase[ChallengePhase["Closed"] = 5] = "Closed";
+    ChallengePhase[ChallengePhase["Promoted"] = 6] = "Promoted";
+})(ChallengePhase || (ChallengePhase = {}));
+/** ChallengeAccount.FailReason (annotates PhaseChanged; None on non-failure transitions). */
+export var ChallengeFailReason;
+(function (ChallengeFailReason) {
+    ChallengeFailReason[ChallengeFailReason["None"] = 0] = "None";
+    ChallengeFailReason[ChallengeFailReason["Drawdown"] = 1] = "Drawdown";
+    ChallengeFailReason[ChallengeFailReason["Expired"] = 2] = "Expired";
+})(ChallengeFailReason || (ChallengeFailReason = {}));
+/** ChallengeAccount.ExitOrderKind */
+export var ExitOrderKind;
+(function (ExitOrderKind) {
+    ExitOrderKind[ExitOrderKind["StopLoss"] = 0] = "StopLoss";
+    ExitOrderKind[ExitOrderKind["TakeProfit"] = 1] = "TakeProfit";
+})(ExitOrderKind || (ExitOrderKind = {}));
+/** ChallengePricingLib.ChallengeType */
+export var ChallengeType;
+(function (ChallengeType) {
+    ChallengeType[ChallengeType["OneStep"] = 0] = "OneStep";
+    ChallengeType[ChallengeType["TwoStep"] = 1] = "TwoStep";
+})(ChallengeType || (ChallengeType = {}));
+const phaseLabels = {
+    [ChallengePhase.Uninitialized]: "Uninitialized",
+    [ChallengePhase.Challenge]: "Challenge",
+    [ChallengePhase.Passed]: "Passed",
+    [ChallengePhase.PaperFunded]: "PaperFunded",
+    [ChallengePhase.Failed]: "Failed",
+    [ChallengePhase.Closed]: "Closed",
+    [ChallengePhase.Promoted]: "Promoted",
+};
+const labelPhases = {
+    Uninitialized: ChallengePhase.Uninitialized,
+    Challenge: ChallengePhase.Challenge,
+    Passed: ChallengePhase.Passed,
+    PaperFunded: ChallengePhase.PaperFunded,
+    Failed: ChallengePhase.Failed,
+    Closed: ChallengePhase.Closed,
+    Promoted: ChallengePhase.Promoted,
+};
+export function phaseToLabel(phase) {
+    return phaseLabels[phase];
+}
+export function labelToPhase(label) {
+    return labelPhases[label];
+}
+const failReasonLabels = {
+    [ChallengeFailReason.None]: "None",
+    [ChallengeFailReason.Drawdown]: "Drawdown",
+    [ChallengeFailReason.Expired]: "Expired",
+};
+export function failReasonToLabel(reason) {
+    return failReasonLabels[reason];
+}
+//# sourceMappingURL=types.js.map

package/dist/challenge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/challenge/types.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAE3D,6BAA6B;AAC7B,MAAM,CAAN,IAAY,cAQX;AARD,WAAY,cAAc;IACxB,qEAAa,CAAA;IACb,6DAAS,CAAA;IACT,uDAAM,CAAA;IACN,iEAAW,CAAA;IACX,uDAAM,CAAA;IACN,uDAAM,CAAA;IACN,2DAAQ,CAAA;AACV,CAAC,EARW,cAAc,KAAd,cAAc,QAQzB;AAED,6FAA6F;AAC7F,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,6DAAI,CAAA;IACJ,qEAAQ,CAAA;IACR,mEAAO,CAAA;AACT,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAED,qCAAqC;AACrC,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,yDAAQ,CAAA;IACR,6DAAU,CAAA;AACZ,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,wCAAwC;AACxC,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,uDAAO,CAAA;IACP,uDAAO,CAAA;AACT,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AA2BD,MAAM,WAAW,GAAgD;IAC/D,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,eAAe;IAC/C,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IACvC,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,QAAQ;IACjC,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,aAAa;IAC3C,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,QAAQ;IACjC,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,QAAQ;IACjC,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,UAAU;CACtC,CAAC;AAEF,MAAM,WAAW,GAAgD;IAC/D,aAAa,EAAE,cAAc,CAAC,aAAa;IAC3C,SAAS,EAAE,cAAc,CAAC,SAAS;IACnC,MAAM,EAAE,cAAc,CAAC,MAAM;IAC7B,WAAW,EAAE,cAAc,CAAC,WAAW;IACvC,MAAM,EAAE,cAAc,CAAC,MAAM;IAC7B,MAAM,EAAE,cAAc,CAAC,MAAM;IAC7B,QAAQ,EAAE,cAAc,CAAC,QAAQ;CAClC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAqB;IAChD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,gBAAgB,GAA0D;IAC9E,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM;IAClC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,UAAU;IAC1C,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS;CACzC,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAA2B;IAC3D,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/challenge/vault.d.ts

@@ -0,0 +1,87 @@
+import { type Address, type Chain, type Hash, type PublicClient, type WalletClient } from "viem";
+import type { BuilderBankStatus, PayoutState, QueuedPayout, RegisteredChallengeAccount } from "./types.js";
+type AddressResolver = Address | (() => Promise<Address>);
+/**
+ * ChallengeVault module — the sole USDC custodian of the B-book: builder banks,
+ * fee routing, and the FIFO payout queue.
+ *
+ * Writes here are builder-facing operations (bank deposits/withdrawals, A-book promotion,
+ * manual queue draining). Governance (upgrades, factory allow-list, setMainVault) is
+ * multisig territory and intentionally not covered.
+ */
+export declare class ChallengeVaultModule {
+    private publicClient;
+    private walletClient;
+    private chain;
+    private addressResolver;
+    private addressPromise;
+    private resolvedUsdc;
+    constructor(publicClient: PublicClient, walletClient: WalletClient | undefined, chain: Chain, addressResolver: AddressResolver, usdc?: Address);
+    /**
+     * Resolved ChallengeVault proxy address (lazy when constructed with a resolver).
+     * The in-flight promise is cached so concurrent callers share one RPC lookup;
+     * a failed resolution is cleared so the next call retries.
+     */
+    getAddress(): Promise<Address>;
+    private requireWallet;
+    private write;
+    /**
+     * Full builder bank snapshot: balance/debt/delinquency plus the coverage and
+     * anti-drain views the frontend must surface (pendingPassedAccounts blocks new
+     * sales at 50; pendingPayoutCount caps queued payouts at 30).
+     */
+    getBuilderBank(builder: Address): Promise<BuilderBankStatus>;
+    /** Per-account payout accounting (lifetime paid, in-flight pending, cooldown anchor, live queue entry). */
+    getPayoutState(account: Address): Promise<PayoutState>;
+    getRegisteredAccount(account: Address): Promise<RegisteredChallengeAccount>;
+    getQueuedPayout(queueId: bigint): Promise<QueuedPayout>;
+    /**
+     * The builder's live FIFO payout queue, head first (index 0 = next to be drained).
+     *
+     * On-chain the queue array is append-only: drained entries stay in place and
+     * `builderQueueHead` marks the live window start, so `builderQueueLength` counts
+     * every entry EVER queued and the live claims are `[head, length)`. Three dependent
+     * RPC round trips (head/length → ids → entries) — the live window is capped at
+     * MAX_PENDING_PAYOUTS = 30 so each is small; polling UIs should prefer
+     * `indexer.getPayoutQueue` (one GraphQL query) over this on-chain read.
+     */
+    getBuilderQueue(builder: Address): Promise<QueuedPayout[]>;
+    /** Off-chain solvency monitor: usdc.balanceOf(vault) >= totalBuilderBalance. */
+    isTokenSolvent(): Promise<boolean>;
+    /** Static vault wiring + protocol-wide totals and rule constants. */
+    getConfig(): Promise<{
+        usdc: Address;
+        mainVault: Address;
+        owner: Address;
+        pendingOwner: Address;
+        totalBuilderBalance: bigint;
+        factoryActivationDelay: bigint;
+        payoutCooldown: bigint;
+        maxPayoutTotalBps: bigint;
+        maxSinglePayoutBps: bigint;
+        maxDailyPayoutBps: bigint;
+        maxPendingPayouts: bigint;
+        maxPendingPassedAccounts: bigint;
+        coverageMultiplier: bigint;
+    }>;
+    private getUsdc;
+    /** Approve the ChallengeVault to pull USDC (needed before depositBuilderBalance). */
+    approveUsdc(amount: bigint): Promise<Hash>;
+    /** Fund a builder's B-book bank (anyone can deposit on a builder's behalf). */
+    depositBuilderBalance(builder: Address, amount: bigint): Promise<Hash>;
+    /** Instant withdrawal of the caller's available bank balance. */
+    withdrawBuilderBalance(amount: bigint): Promise<Hash>;
+    /**
+     * Atomic A-book promotion of a Passed challenge: debits the builder bank by the
+     * MainVault activation fee and calls MainVault.activateFundedFor. The single mutable
+     * B-book → A-book boundary.
+     */
+    promotePassedToAbook(account: Address): Promise<Hash>;
+    /**
+     * Drain the FIFO head as builder liquidity allows. Permissionless; the challenge-service
+     * keeper runs it automatically — this is the manual "process my queue now" button.
+     */
+    executeNextQueuedPayout(builder: Address): Promise<Hash>;
+}
+export {};
+//# sourceMappingURL=vault.d.ts.map

package/dist/challenge/vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/challenge/vault.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,KAAK,eAAe,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAK7B,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,eAAe;IAPzB,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAAsB;gBAGhC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,eAAe,EACxC,IAAI,CAAC,EAAE,OAAO;IAMhB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAWpC,OAAO,CAAC,aAAa;YASP,KAAK;IAWnB;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuClE,2GAA2G;IACrG,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAWtD,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAW3E,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAW7D;;;;;;;;;OASG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA4ChE,gFAAgF;IAC1E,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IASxC,qEAAqE;IAC/D,SAAS,IAAI,OAAO,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,wBAAwB,EAAE,MAAM,CAAC;QACjC,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;YAwCY,OAAO;IAWrB,qFAAqF;IAC/E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD,+EAA+E;IACzE,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5E,iEAAiE;IAC3D,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;;;OAIG;IACG,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;;OAGG;IACG,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAS/D"}

package/dist/challenge/vault.js

@@ -0,0 +1,299 @@
+import { erc20Abi, } from "viem";
+import { challengeVaultAbi } from "../abi/challengeVault.js";
+import { assertAllSuccess } from "../utils.js";
+/**
+ * ChallengeVault module — the sole USDC custodian of the B-book: builder banks,
+ * fee routing, and the FIFO payout queue.
+ *
+ * Writes here are builder-facing operations (bank deposits/withdrawals, A-book promotion,
+ * manual queue draining). Governance (upgrades, factory allow-list, setMainVault) is
+ * multisig territory and intentionally not covered.
+ */
+export class ChallengeVaultModule {
+    publicClient;
+    walletClient;
+    chain;
+    addressResolver;
+    addressPromise;
+    resolvedUsdc;
+    constructor(publicClient, walletClient, chain, addressResolver, usdc) {
+        this.publicClient = publicClient;
+        this.walletClient = walletClient;
+        this.chain = chain;
+        this.addressResolver = addressResolver;
+        if (typeof addressResolver === "string")
+            this.addressPromise = Promise.resolve(addressResolver);
+        this.resolvedUsdc = usdc;
+    }
+    /**
+     * Resolved ChallengeVault proxy address (lazy when constructed with a resolver).
+     * The in-flight promise is cached so concurrent callers share one RPC lookup;
+     * a failed resolution is cleared so the next call retries.
+     */
+    async getAddress() {
+        if (!this.addressPromise) {
+            const resolver = this.addressResolver;
+            this.addressPromise = resolver().catch((err) => {
+                this.addressPromise = undefined;
+                throw err;
+            });
+        }
+        return this.addressPromise;
+    }
+    requireWallet() {
+        if (!this.walletClient)
+            throw new Error("WalletClient required for write operations");
+        const walletChainId = this.walletClient.chain?.id;
+        if (walletChainId !== undefined && walletChainId !== this.chain.id) {
+            throw new Error(`WalletClient chain mismatch: expected ${this.chain.id}, got ${walletChainId}`);
+        }
+        return this.walletClient;
+    }
+    async write(params) {
+        const wallet = this.requireWallet();
+        const account = wallet.account;
+        if (!account)
+            throw new Error("WalletClient has no account");
+        return wallet.writeContract({ ...params, chain: this.chain, account });
+    }
+    // ── READS ───────────────────────────────────────────
+    /**
+     * Full builder bank snapshot: balance/debt/delinquency plus the coverage and
+     * anti-drain views the frontend must surface (pendingPassedAccounts blocks new
+     * sales at 50; pendingPayoutCount caps queued payouts at 30).
+     */
+    async getBuilderBank(builder) {
+        const address = await this.getAddress();
+        const contract = { address, abi: challengeVaultAbi };
+        const results = await this.publicClient.multicall({
+            contracts: [
+                { ...contract, functionName: "books", args: [builder] },
+                { ...contract, functionName: "builderRisks", args: [builder] },
+                { ...contract, functionName: "builderExposure", args: [builder] },
+                { ...contract, functionName: "requiredCoverage", args: [builder] },
+                { ...contract, functionName: "payoutLiquidity", args: [builder] },
+                { ...contract, functionName: "shortfall", args: [builder] },
+                { ...contract, functionName: "pendingPassedAccounts", args: [builder] },
+                { ...contract, functionName: "builderPendingPayoutCount", args: [builder] },
+            ],
+        });
+        const r = assertAllSuccess(results);
+        const book = r[0];
+        const risks = r[1];
+        return {
+            builder,
+            balance: book[0],
+            pendingPayouts: book[1],
+            delinquentSince: book[2],
+            exposure: r[2],
+            requiredCoverage: r[3],
+            payoutLiquidity: r[4],
+            shortfall: r[5],
+            pendingPassedAccounts: r[6],
+            pendingPayoutCount: r[7],
+            activeChallengeExposure6: risks[0],
+            passedExposure6: risks[1],
+            paperFundedExposure6: risks[2],
+            queuedPayoutExposure6: risks[3],
+            payoutDay: risks[4],
+            paidToday6: risks[5],
+        };
+    }
+    /** Per-account payout accounting (lifetime paid, in-flight pending, cooldown anchor, live queue entry). */
+    async getPayoutState(account) {
+        const address = await this.getAddress();
+        const [totalPaidGross6, pendingGross6, lastPayoutAt, queueId] = await this.publicClient.readContract({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "payoutState",
+            args: [account],
+        });
+        return { totalPaidGross6, pendingGross6, lastPayoutAt, queueId };
+    }
+    async getRegisteredAccount(account) {
+        const address = await this.getAddress();
+        const [builder, trader, allocation6, maxPayoutTotal6, registered] = await this.publicClient.readContract({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "accounts",
+            args: [account],
+        });
+        return { builder, trader, allocation6, maxPayoutTotal6, registered };
+    }
+    async getQueuedPayout(queueId) {
+        const address = await this.getAddress();
+        const [account, trader, remainingGross6, remainingExposure6] = await this.publicClient.readContract({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "queuedPayouts",
+            args: [queueId],
+        });
+        return { queueId, account, trader, remainingGross6, remainingExposure6 };
+    }
+    /**
+     * The builder's live FIFO payout queue, head first (index 0 = next to be drained).
+     *
+     * On-chain the queue array is append-only: drained entries stay in place and
+     * `builderQueueHead` marks the live window start, so `builderQueueLength` counts
+     * every entry EVER queued and the live claims are `[head, length)`. Three dependent
+     * RPC round trips (head/length → ids → entries) — the live window is capped at
+     * MAX_PENDING_PAYOUTS = 30 so each is small; polling UIs should prefer
+     * `indexer.getPayoutQueue` (one GraphQL query) over this on-chain read.
+     */
+    async getBuilderQueue(builder) {
+        const address = await this.getAddress();
+        const contract = { address, abi: challengeVaultAbi };
+        const headLength = await this.publicClient.multicall({
+            contracts: [
+                { ...contract, functionName: "builderQueueHead", args: [builder] },
+                { ...contract, functionName: "builderQueueLength", args: [builder] },
+            ],
+        });
+        const [head, length] = assertAllSuccess(headLength, ["builderQueueHead", "builderQueueLength"]);
+        if (head >= length)
+            return [];
+        const idResults = await this.publicClient.multicall({
+            contracts: Array.from({ length: Number(length - head) }, (_, i) => ({
+                ...contract,
+                functionName: "builderQueueAt",
+                args: [builder, head + BigInt(i)],
+            })),
+        });
+        const queueIds = assertAllSuccess(idResults);
+        const entryResults = await this.publicClient.multicall({
+            contracts: queueIds.map((queueId) => ({
+                ...contract,
+                functionName: "queuedPayouts",
+                args: [queueId],
+            })),
+        });
+        const entries = assertAllSuccess(entryResults);
+        return entries.map((raw, i) => {
+            const [account, trader, remainingGross6, remainingExposure6] = raw;
+            return {
+                queueId: queueIds[i],
+                account,
+                trader,
+                remainingGross6,
+                remainingExposure6,
+            };
+        });
+    }
+    /** Off-chain solvency monitor: usdc.balanceOf(vault) >= totalBuilderBalance. */
+    async isTokenSolvent() {
+        const address = await this.getAddress();
+        return this.publicClient.readContract({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "tokenSolvent",
+        });
+    }
+    /** Static vault wiring + protocol-wide totals and rule constants. */
+    async getConfig() {
+        const address = await this.getAddress();
+        const contract = { address, abi: challengeVaultAbi };
+        const results = await this.publicClient.multicall({
+            contracts: [
+                { ...contract, functionName: "usdc" },
+                { ...contract, functionName: "mainVault" },
+                { ...contract, functionName: "owner" },
+                { ...contract, functionName: "pendingOwner" },
+                { ...contract, functionName: "totalBuilderBalance" },
+                { ...contract, functionName: "factoryActivationDelay" },
+                { ...contract, functionName: "PAYOUT_COOLDOWN" },
+                { ...contract, functionName: "MAX_PAYOUT_TOTAL_BPS" },
+                { ...contract, functionName: "MAX_SINGLE_PAYOUT_BPS" },
+                { ...contract, functionName: "MAX_DAILY_PAYOUT_BPS" },
+                { ...contract, functionName: "MAX_PENDING_PAYOUTS" },
+                { ...contract, functionName: "MAX_PENDING_PASSED_ACCOUNTS" },
+                { ...contract, functionName: "COVERAGE_MULTIPLIER" },
+            ],
+        });
+        const r = assertAllSuccess(results);
+        return {
+            usdc: r[0],
+            mainVault: r[1],
+            owner: r[2],
+            pendingOwner: r[3],
+            totalBuilderBalance: r[4],
+            factoryActivationDelay: r[5],
+            payoutCooldown: r[6],
+            maxPayoutTotalBps: r[7],
+            maxSinglePayoutBps: r[8],
+            maxDailyPayoutBps: r[9],
+            maxPendingPayouts: r[10],
+            maxPendingPassedAccounts: r[11],
+            coverageMultiplier: r[12],
+        };
+    }
+    // ── BUILDER WRITES ──────────────────────────────────
+    async getUsdc() {
+        if (this.resolvedUsdc)
+            return this.resolvedUsdc;
+        const address = await this.getAddress();
+        this.resolvedUsdc = await this.publicClient.readContract({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "usdc",
+        });
+        return this.resolvedUsdc;
+    }
+    /** Approve the ChallengeVault to pull USDC (needed before depositBuilderBalance). */
+    async approveUsdc(amount) {
+        const [vault, usdc] = await Promise.all([this.getAddress(), this.getUsdc()]);
+        return this.write({
+            address: usdc,
+            abi: erc20Abi,
+            functionName: "approve",
+            args: [vault, amount],
+        });
+    }
+    /** Fund a builder's B-book bank (anyone can deposit on a builder's behalf). */
+    async depositBuilderBalance(builder, amount) {
+        const address = await this.getAddress();
+        return this.write({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "depositBuilderBalance",
+            args: [builder, amount],
+        });
+    }
+    /** Instant withdrawal of the caller's available bank balance. */
+    async withdrawBuilderBalance(amount) {
+        const address = await this.getAddress();
+        return this.write({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "withdrawBuilderBalance",
+            args: [amount],
+        });
+    }
+    /**
+     * Atomic A-book promotion of a Passed challenge: debits the builder bank by the
+     * MainVault activation fee and calls MainVault.activateFundedFor. The single mutable
+     * B-book → A-book boundary.
+     */
+    async promotePassedToAbook(account) {
+        const address = await this.getAddress();
+        return this.write({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "promotePassedToAbook",
+            args: [account],
+        });
+    }
+    /**
+     * Drain the FIFO head as builder liquidity allows. Permissionless; the challenge-service
+     * keeper runs it automatically — this is the manual "process my queue now" button.
+     */
+    async executeNextQueuedPayout(builder) {
+        const address = await this.getAddress();
+        return this.write({
+            address,
+            abi: challengeVaultAbi,
+            functionName: "executeNextQueuedPayout",
+            args: [builder],
+        });
+    }
+}
+//# sourceMappingURL=vault.js.map

package/dist/challenge/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/challenge/vault.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -20,16 +20,26 @@ export declare const hyperEvm: {
 };
 export declare const ADDRESSES: {
     readonly MAIN_VAULT: "0xaC98618D06D0787D43353308286cDBa8A7aD4a8D";
-    readonly FORWARDER: "0x04f51e589Edeaa77ddC2dEe5d0D63fa78b0c1EdA";
+    readonly FORWARDER: "0xaf8370E399eb657114C4d82988169845b1B32694";
     readonly USDC: "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
 };
+export declare const CHALLENGE_ADDRESSES: {
+    readonly CHALLENGE_FACTORY: "0xc90Ab435B104e3E7eF580d5516d4F1B0912dFccC";
+    readonly CHALLENGE_VAULT: "0x405EFbC832323393a91127a1b83AE36B9eEC6b4D";
+    readonly CHALLENGE_PRICE_ORACLE: "0x1366f0954c601BAe7fB84b9242295293AE2C61F4";
+    readonly CHALLENGE_ACCOUNT_IMPL: "0x6DeA37698b1f8EdFCE1E86Db7EF5C3A6D13bBE2E";
+};
 export declare const BPS = 10000n;
 export declare const MIN_DRAWDOWN_BPS = 500;
 export declare const MAX_DRAWDOWN_BPS = 2500;
-export declare const DAILY_DD_DISCOUNT_BPS = 2000n;
-export declare const PROTOCOL_FEE_BPS = 1000n;
+export declare const PROTOCOL_FEE_BPS = 5000n;
 export declare const OWNER_PROFIT_BPS = 8000n;
 export declare const PROTOCOL_PROFIT_BPS = 700n;
+export declare const SUBSCRIPTION_PROTOCOL_BPS = 1500n;
+export declare const NON_OWNER_PROFIT_BPS = 2000n;
+export declare const BUILDER_PROFIT_BPS_DEFAULT = 1400n;
+export declare const BUILDER_PAYBACK_PROTOCOL_BPS_DEFAULT = 300n;
+export declare const BUILDER_PAYBACK_FRACTION_BPS_DEFAULT = 5000n;
 export declare const BUILDER_LEVERAGE = 10n;
 export declare const MAX_UTILIZATION_BPS = 8000n;
 export declare const MAX_SINGLE_ACCOUNT_BPS = 1000n;
@@ -41,7 +51,7 @@ export declare const BRIDGE_DELAY = 30;
 export declare const CHECKPOINT_INTERVAL = 86400;
 export declare const PROFITABLE_DAYS_REQUIRED = 3;
 export declare const MIN_PROFIT_BPS = 70;
-export declare const INSTANT_WITHDRAW_PROFIT_BPS = 200;
+export declare const INSTANT_WITHDRAW_PROFIT_BPS = 100;
 export declare const MIN_WITHDRAW_AMOUNT = 1000000n;
 export declare const HWM_PROFIT_LOCK_BPS = 3000;
 export declare const MAX_LEVERAGE = 5;

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAQK,CAAC;AAE3B,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAGX,eAAO,MAAM,GAAG,SAAU,CAAC;AAC3B,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAG5C,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAIxC,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAC9C,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAGzC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,mBAAmB,WAAa,CAAC;AAC9C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,YAAY,IAAI,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAQK,CAAC;AAE3B,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAIX,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAGX,eAAO,MAAM,GAAG,SAAU,CAAC;AAC3B,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAI/C,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAC1C,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAChD,eAAO,MAAM,oCAAoC,OAAO,CAAC;AACzD,eAAO,MAAM,oCAAoC,QAAQ,CAAC;AAC1D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAG5C,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAIxC,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAC9C,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAGzC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,mBAAmB,WAAa,CAAC;AAC9C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,YAAY,IAAI,CAAC"}

package/dist/constants.js

@@ -10,17 +10,31 @@ export const hyperEvm = {
 };
 export const ADDRESSES = {
     MAIN_VAULT: "0xaC98618D06D0787D43353308286cDBa8A7aD4a8D",
-    FORWARDER: "0x04f51e589Edeaa77ddC2dEe5d0D63fa78b0c1EdA",
+    FORWARDER: "0xaf8370E399eb657114C4d82988169845b1B32694",
     USDC: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
 };
+// Challenge / B-book deployment (hyperevm 2026-06-26, EVM/deployment-challenge-hyperevm.json).
+// CHALLENGE_FACTORY is the stable root: vault/oracle/implementation are read from it on-chain.
+export const CHALLENGE_ADDRESSES = {
+    CHALLENGE_FACTORY: "0xc90Ab435B104e3E7eF580d5516d4F1B0912dFccC",
+    CHALLENGE_VAULT: "0x405EFbC832323393a91127a1b83AE36B9eEC6b4D",
+    CHALLENGE_PRICE_ORACLE: "0x1366f0954c601BAe7fB84b9242295293AE2C61F4",
+    CHALLENGE_ACCOUNT_IMPL: "0x6DeA37698b1f8EdFCE1E86Db7EF5C3A6D13bBE2E",
+};
 // BPS
 export const BPS = 10000n;
 export const MIN_DRAWDOWN_BPS = 500;
 export const MAX_DRAWDOWN_BPS = 2500;
-export const DAILY_DD_DISCOUNT_BPS = 2000n;
-export const PROTOCOL_FEE_BPS = 1000n;
+export const PROTOCOL_FEE_BPS = 5000n;
 export const OWNER_PROFIT_BPS = 8000n;
 export const PROTOCOL_PROFIT_BPS = 700n;
+export const SUBSCRIPTION_PROTOCOL_BPS = 1500n; // 15% of subscription fee to protocol
+// Builder profit-share (activation-fee payback). Trader always keeps OWNER_PROFIT_BPS (80%);
+// during payback the builder cut + protocol cut must fit the 20% non-owner pool.
+export const NON_OWNER_PROFIT_BPS = 2000n; // 20% — owner+builder+protocol+vault cap for setters
+export const BUILDER_PROFIT_BPS_DEFAULT = 1400n; // 14% builder cut during payback
+export const BUILDER_PAYBACK_PROTOCOL_BPS_DEFAULT = 300n; // 3% protocol cut during payback (vs 7% normal)
+export const BUILDER_PAYBACK_FRACTION_BPS_DEFAULT = 5000n; // target = 50% of the activation fee
 export const BUILDER_LEVERAGE = 10n;
 export const MAX_UTILIZATION_BPS = 8000n;
 export const MAX_SINGLE_ACCOUNT_BPS = 1000n;
@@ -36,8 +50,13 @@ export const CHECKPOINT_INTERVAL = 86400;
 // Trading rules
 export const PROFITABLE_DAYS_REQUIRED = 3;
 export const MIN_PROFIT_BPS = 70;
-export const INSTANT_WITHDRAW_PROFIT_BPS = 200; // 2% of accountSize
+export const INSTANT_WITHDRAW_PROFIT_BPS = 100; // 1% of accountSize
 export const MIN_WITHDRAW_AMOUNT = 1000000n; // $1 in 6dec
 export const HWM_PROFIT_LOCK_BPS = 3000; // lock 30% of profit growth into HWM
 export const MAX_LEVERAGE = 5;
+// Challenge / B-book rule constants are intentionally NOT mirrored here: ChallengeVault is
+// UUPS-upgradeable and the ChallengeAccount implementation is swappable on the factory, so
+// hardcoded copies would drift silently. Read them live instead:
+//   ChallengeVaultModule.getConfig()            — payout cooldown/caps, coverage, queue limits
+//   ChallengeAccountModule.getAccountConstants() — challenge duration, min profit bar, taker fee
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAE5B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,UAAU;IAChB,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC9D,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,iCAAiC,CAAC,EAAE,EAAE;IACnE,SAAS,EAAE;QACT,UAAU,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE;KACtE;CACuB,CAAC;AAE3B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,4CAA4C;IACxD,SAAS,EAAE,4CAA4C;IACvD,IAAI,EAAE,4CAA4C;CAC1C,CAAC;AAEX,MAAM;AACN,MAAM,CAAC,MAAM,GAAG,GAAG,MAAO,CAAC;AAC3B,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAE5C,WAAW;AACX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,+BAA+B;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,CAAC,2CAA2C;AACpF,kGAAkG;AAElG,iBAAiB;AACjB,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,KAAK,CAAC;AAC9C,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,gBAAgB;AAChB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC,CAAC,oBAAoB;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAU,CAAC,CAAC,aAAa;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,CAAC,qCAAqC;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/factory.d.ts

@@ -1,4 +1,4 @@
-import type { Address, PublicClient } from "viem";
+import { type Address, type PublicClient } from "viem";
 export declare class FactoryModule {
     private publicClient;
     private factoryAddress;

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIlD,qBAAa,aAAa;IAEtB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;gBADd,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YAG9C,iBAAiB;IAK/B,OAAO,CAAC,kBAAkB;YAKZ,eAAe;IAgBvB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU7C,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAU9C,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAO1D,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxE,gBAAgB,CAAC,OAAO,GAAE,MAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4E5D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA2B9D,SAAS,IAAI,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,KAAK,EAAE,OAAO,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;QACtB,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CAsBH"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAId,qBAAa,aAAa;IAEtB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;gBADd,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YAG9C,iBAAiB;IAW/B,OAAO,CAAC,kBAAkB;YAWZ,eAAe;IAgBvB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU7C,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAU9C,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAO1D,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxE,gBAAgB,CAAC,OAAO,GAAE,MAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4E5D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA2B9D,SAAS,IAAI,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,KAAK,EAAE,OAAO,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;QACtB,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CAsBH"}

package/dist/factory.js

@@ -1,3 +1,4 @@
+import { BaseError, ContractFunctionRevertedError, ContractFunctionZeroDataError, } from "viem";
 import { factoryAbi } from "./abi/factory.js";
 import { assertAllSuccess } from "./utils.js";
 export class FactoryModule {
@@ -12,7 +13,18 @@ export class FactoryModule {
             return this.factoryAddress;
         return this.factoryAddress();
     }
+    // allAccounts(uint256) is a plain public array getter — the only revert the CALL itself
+    // can produce is the out-of-bounds panic, so any decoded contract revert means "index past
+    // the end". Detect by viem error class (message text varies by RPC/viem version — e.g.
+    // 'The contract function "allAccounts" reverted.' matches none of the legacy patterns);
+    // transport/RPC failures produce neither cause class and still bubble. The message regex
+    // stays as a fallback for non-viem-shaped errors.
     isOutOfBoundsError(error) {
+        if (error instanceof BaseError) {
+            const revert = error.walk((e) => e instanceof ContractFunctionRevertedError || e instanceof ContractFunctionZeroDataError);
+            if (revert)
+                return true;
+        }
         const message = error instanceof Error ? error.message : String(error);
         return /out of bounds|execution reverted|returned no data|position out of bounds/i.test(message);
     }