@openzeppelin/miden-multisig-client 0.16.1 → 0.16.2

package/dist/retry/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/retry/runtime.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,YAAY,GAAG,KAAK,CAAC;AAO3B,MAAM,CAAC,MAAM,sBAAsB,GAAiB;IAClD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1E,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;CAChC,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,UAAkB;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,aAAa,GAAG,CAAC,IAAI,QAAQ,CAAC;IAC1C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;IACpE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,aAAa,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAA2B,EAC3B,WAAmB,EACnB,WAAwC,EACxC,OAAqB;IAErB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,GAAG,CAAC,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC7C,CAAC"}

package/dist/rpc/config.d.ts

@@ -0,0 +1,11 @@
+export interface RpcRetryPolicy {
+    maxAttempts?: number;
+}
+export interface RpcConfig {
+    retry?: RpcRetryPolicy;
+}
+export interface ResolvedRpcConfig {
+    readonly maxAttempts: number;
+}
+export declare function resolveRpcConfig(config: RpcConfig | undefined): ResolvedRpcConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/rpc/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/rpc/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAeD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAIjF"}

package/dist/rpc/config.js

@@ -0,0 +1,17 @@
+const DEFAULT_MAX_ATTEMPTS = 2;
+const MAX_U32 = 4_294_967_295;
+function normalizeMaxAttempts(value) {
+    if (value === undefined) {
+        return DEFAULT_MAX_ATTEMPTS;
+    }
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0 || value > MAX_U32) {
+        throw new Error('rpc.retry.maxAttempts must be an integer between 0 and 4294967295');
+    }
+    return Math.max(1, value);
+}
+export function resolveRpcConfig(config) {
+    return {
+        maxAttempts: normalizeMaxAttempts(config?.retry?.maxAttempts),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/rpc/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/rpc/config.ts"],"names":[],"mappings":"AAYA,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,OAAO,GAAG,aAAa,CAAC;AAE9B,SAAS,oBAAoB,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA6B;IAC5D,OAAO;QACL,WAAW,EAAE,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/dist/rpc/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/rpc/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/rpc/config.test.ts"],"names":[],"mappings":""}

package/dist/rpc/config.test.js

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import { describe, expect, it } from 'vitest';
+import { resolveRpcConfig } from './config.js';
+function fixtures() {
+    return JSON.parse(readFileSync(new URL('../../../../fixtures/miden-multisig-client/rpc-policy-fixtures.json', import.meta.url), 'utf8'));
+}
+describe('resolveRpcConfig', () => {
+    it('matches shared attempt-budget vectors', () => {
+        for (const fixture of fixtures().attemptBudgets) {
+            const retry = fixture.input === null ? undefined : { maxAttempts: fixture.input };
+            expect(resolveRpcConfig({ retry }).maxAttempts).toBe(fixture.normalized);
+        }
+    });
+    it('defaults to one retry when no config is given', () => {
+        expect(resolveRpcConfig(undefined).maxAttempts).toBe(2);
+    });
+    it('treats an explicit single attempt as a full opt-out', () => {
+        expect(resolveRpcConfig({ retry: { maxAttempts: 1 } }).maxAttempts).toBe(1);
+    });
+    it.each([-1, 1.5, Number.NaN, Number.POSITIVE_INFINITY, 4_294_967_296])('rejects invalid maxAttempts value %s', (maxAttempts) => {
+        expect(() => resolveRpcConfig({ retry: { maxAttempts } })).toThrow('rpc.retry.maxAttempts');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/rpc/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/rpc/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,SAAS,QAAQ;IACf,OAAO,IAAI,CAAC,KAAK,CACf,YAAY,CACV,IAAI,GAAG,CACL,qEAAqE,EACrE,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,EACD,MAAM,CACP,CACU,CAAC;AAChB,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC,cAAc,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAClF,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CACrE,sCAAsC,EACtC,CAAC,WAAW,EAAE,EAAE;QACd,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAChE,uBAAuB,CACxB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/rpc/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function isTransientRpcError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/rpc/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/rpc/errors.ts"],"names":[],"mappings":"AASA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE3D"}

package/dist/rpc/errors.js

@@ -0,0 +1,11 @@
+import { isTransientError } from '../retry/classify.js';
+/**
+ * The node's transport layer renders dropped connections with wording the
+ * prover policy deliberately rejects, so these extras apply to node-RPC
+ * classification only. Guarded by the negative classification fixtures.
+ */
+const RPC_TRANSPORT_SIGNALS = ['connection error', 'transport error'];
+export function isTransientRpcError(error) {
+    return isTransientError(error, RPC_TRANSPORT_SIGNALS);
+}
+//# sourceMappingURL=errors.js.map

package/dist/rpc/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/rpc/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;AAEtE,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;AACxD,CAAC"}

package/dist/rpc/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/rpc/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/rpc/errors.test.ts"],"names":[],"mappings":""}

package/dist/rpc/errors.test.js

@@ -0,0 +1,34 @@
+import { readFileSync } from 'node:fs';
+import { describe, expect, it } from 'vitest';
+import { isTransientRpcError } from './errors.js';
+function fixtures() {
+    return JSON.parse(readFileSync(new URL('../../../../fixtures/miden-multisig-client/rpc-policy-fixtures.json', import.meta.url), 'utf8'));
+}
+describe('isTransientRpcError', () => {
+    it('matches every shared classification vector', () => {
+        for (const fixture of fixtures().classifications) {
+            const error = fixture.chain.reduceRight((cause, item) => ({ ...item, cause }), undefined);
+            expect(isTransientRpcError(error), fixture.name).toBe(fixture.transient);
+        }
+    });
+    it('stops safely on cyclic cause graphs', () => {
+        const error = { code: 'Unknown', message: 'not retryable' };
+        error.cause = error;
+        expect(isTransientRpcError(error)).toBe(false);
+    });
+    it('recognizes numeric gRPC status codes', () => {
+        expect(isTransientRpcError({ code: 14, message: 'unavailable' })).toBe(true);
+        expect(isTransientRpcError({ code: 3, message: 'timeout text' })).toBe(false);
+    });
+    it('keeps permanent status evidence ahead of transport wording', () => {
+        expect(isTransientRpcError({
+            code: 'FailedPrecondition',
+            message: 'transport error while checking preconditions',
+        })).toBe(false);
+    });
+    it('reads grpc code wording out of plain message text', () => {
+        expect(isTransientRpcError(new Error('grpc code: InvalidArgument; request timeout'))).toBe(false);
+        expect(isTransientRpcError(new Error('grpc code: Unavailable'))).toBe(true);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/rpc/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/rpc/errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAiBlD,SAAS,QAAQ;IACf,OAAO,IAAI,CAAC,KAAK,CACf,YAAY,CACV,IAAI,GAAG,CACL,qEAAqE,EACrE,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,EACD,MAAM,CACP,CACU,CAAC;AAChB,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC,eAAe,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CACrC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EACrC,SAAS,CACV,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAC1E,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,MAAM,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CACJ,mBAAmB,CAAC;YAClB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,8CAA8C;SACxD,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC,CAAC,CAAC,IAAI,CACxF,KAAK,CACN,CAAC;QACF,MAAM,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/rpc/retry.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedRpcConfig } from './config.js';
+import type { RetryRuntime } from '../retry/runtime.js';
+export declare function retryRpcRead<T>(operation: () => Promise<T>, config: ResolvedRpcConfig, runtime?: RetryRuntime): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/rpc/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/rpc/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,wBAAsB,YAAY,CAAC,CAAC,EAClC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,YAAqC,GAC7C,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/rpc/retry.js

@@ -0,0 +1,6 @@
+import { isTransientRpcError } from './errors.js';
+import { productionRetryRuntime, retryTransient } from '../retry/runtime.js';
+export async function retryRpcRead(operation, config, runtime = productionRetryRuntime) {
+    return retryTransient(operation, config.maxAttempts, isTransientRpcError, runtime);
+}
+//# sourceMappingURL=retry.js.map

package/dist/rpc/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/rpc/retry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAA2B,EAC3B,MAAyB,EACzB,UAAwB,sBAAsB;IAE9C,OAAO,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACrF,CAAC"}

package/dist/rpc/retry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retry.test.d.ts.map

package/dist/rpc/retry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.test.d.ts","sourceRoot":"","sources":["../../src/rpc/retry.test.ts"],"names":[],"mappings":""}

package/dist/rpc/retry.test.js

@@ -0,0 +1,98 @@
+import { readFileSync } from 'node:fs';
+import { describe, expect, it, vi } from 'vitest';
+import { resolveRpcConfig } from './config.js';
+import { retryRpcRead } from './retry.js';
+import { retryDelay } from '../retry/runtime.js';
+function fixtures() {
+    return JSON.parse(readFileSync(new URL('../../../../fixtures/miden-multisig-client/rpc-policy-fixtures.json', import.meta.url), 'utf8'));
+}
+function recordingRuntime() {
+    const sleeps = [];
+    return {
+        sleeps,
+        sleep: (delayMs) => {
+            sleeps.push(delayMs);
+            return Promise.resolve();
+        },
+        unitRandom: () => 0.5,
+    };
+}
+function rateLimitError() {
+    return Object.assign(new Error('Too Many Requests!'), {
+        code: 'ResourceExhausted',
+    });
+}
+describe('retryRpcRead', () => {
+    it('matches every shared delay vector', () => {
+        for (const fixture of fixtures().delays) {
+            expect(retryDelay(fixture.retryIndex, fixture.unitRandom)).toBe(fixture.delayMs);
+        }
+    });
+    it('waits out rate limiting and returns the eventual result', async () => {
+        const runtime = recordingRuntime();
+        const operation = vi
+            .fn()
+            .mockRejectedValueOnce(rateLimitError())
+            .mockRejectedValueOnce(rateLimitError())
+            .mockResolvedValueOnce('synced');
+        const result = await retryRpcRead(operation, resolveRpcConfig({ retry: { maxAttempts: 3 } }), runtime);
+        expect(result).toBe('synced');
+        expect(operation).toHaveBeenCalledTimes(3);
+        expect(runtime.sleeps).toEqual([retryDelay(0, 0.5), retryDelay(1, 0.5)]);
+    });
+    it('throws a permanent error immediately without sleeping', async () => {
+        const runtime = recordingRuntime();
+        const permanent = Object.assign(new Error('malformed account id'), {
+            code: 'InvalidArgument',
+        });
+        const operation = vi.fn().mockRejectedValue(permanent);
+        await expect(retryRpcRead(operation, resolveRpcConfig({ retry: { maxAttempts: 5 } }), runtime)).rejects.toBe(permanent);
+        expect(operation).toHaveBeenCalledTimes(1);
+        expect(runtime.sleeps).toEqual([]);
+    });
+    it('rethrows the final upstream error unchanged after budget exhaustion', async () => {
+        const runtime = recordingRuntime();
+        const final = Object.assign(new Error('still rate limited'), {
+            code: 'ResourceExhausted',
+        });
+        const operation = vi
+            .fn()
+            .mockRejectedValueOnce(rateLimitError())
+            .mockRejectedValueOnce(final);
+        await expect(retryRpcRead(operation, resolveRpcConfig({ retry: { maxAttempts: 2 } }), runtime)).rejects.toBe(final);
+        expect(operation).toHaveBeenCalledTimes(2);
+        expect(runtime.sleeps).toHaveLength(1);
+    });
+    it('retries a transient read once under the default config', async () => {
+        const runtime = recordingRuntime();
+        const operation = vi
+            .fn()
+            .mockRejectedValueOnce(rateLimitError())
+            .mockResolvedValueOnce('synced');
+        await expect(retryRpcRead(operation, resolveRpcConfig(undefined), runtime)).resolves.toBe('synced');
+        expect(operation).toHaveBeenCalledTimes(2);
+        expect(runtime.sleeps).toHaveLength(1);
+    });
+    it('never retries under an explicit single-attempt config', async () => {
+        const runtime = recordingRuntime();
+        const operation = vi.fn().mockRejectedValue(rateLimitError());
+        await expect(retryRpcRead(operation, resolveRpcConfig({ retry: { maxAttempts: 1 } }), runtime)).rejects.toThrow('Too Many Requests!');
+        expect(operation).toHaveBeenCalledTimes(1);
+        expect(runtime.sleeps).toEqual([]);
+    });
+    it('completes 64 concurrent reads against a rate-limited node', async () => {
+        const runtime = recordingRuntime();
+        let rejected = 0;
+        const operation = () => {
+            if (rejected < 40) {
+                rejected += 1;
+                return Promise.reject(rateLimitError());
+            }
+            return Promise.resolve('synced');
+        };
+        const results = await Promise.all(Array.from({ length: 64 }, () => retryRpcRead(operation, resolveRpcConfig({ retry: { maxAttempts: 4 } }), runtime)));
+        expect(results).toEqual(Array.from({ length: 64 }, () => 'synced'));
+        expect(rejected).toBe(40);
+    });
+});
+//# sourceMappingURL=retry.test.js.map

package/dist/rpc/retry.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/miden-multisig-client",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "description": "TypeScript SDK for Miden multisig accounts with GUARDIAN integration",
   "repository": {
     "type": "git",
@@ -39,7 +39,7 @@
     "@miden-sdk/miden-sdk": "^0.15.8",
     "@noble/curves": "^1.9.7",
     "@noble/hashes": "^2.0.1",
-    "@openzeppelin/guardian-client": "^0.16.1"
+    "@openzeppelin/guardian-client": "^0.16.2"
   },
   "devDependencies": {
     "typescript": "^5.7.2",

package/src/client.test.ts

@@ -239,12 +239,18 @@ describe('MultisigClient', () => {
         ok: false,
         status: 404,
         statusText: 'Not Found',
-        text: async () => 'Account not found',
+        headers: new Headers(),
+        text: async () =>
+          JSON.stringify({
+            code: 'GUARDIAN_ACCOUNT_NOT_FOUND',
+            message: 'Account not found',
+            meta: { retryable: false },
+          }),
       });
 
       await expect(
         client.load('0xnonexistent', mockSigner)
-      ).rejects.toThrow();
+      ).rejects.toThrow('Account not found');
     });
 
     it('should allow registerOnGuardian after load without explicit initial state', async () => {

package/src/client.ts

@@ -18,6 +18,11 @@ import {
   type ProverConfig,
   type ResolvedProverConfig,
 } from './prover/config.js';
+import {
+  resolveRpcConfig,
+  type RpcConfig,
+  type ResolvedRpcConfig,
+} from './rpc/config.js';
 
 interface AccountKeyBindingSigner {
   bindAccountKey?(midenClient: MidenClient, accountId: string): Promise<void>;
@@ -48,6 +53,8 @@ export interface MultisigClientConfig {
   midenRpcEndpoint: string;
   /** Multisig-owned remote prover override and proof retry policy. */
   prover?: ProverConfig;
+  /** Retry policy for idempotent Miden node reads; submission is never retried. */
+  rpc?: RpcConfig;
 }
 
 /**
@@ -95,12 +102,14 @@ export class MultisigClient {
   private readonly midenClient: MidenClient;
   private readonly midenRpcEndpoint: string;
   private readonly proverConfig: ResolvedProverConfig;
+  private readonly rpcConfig: ResolvedRpcConfig;
   private _guardianClient: GuardianHttpClient;
 
   constructor(midenClient: MidenClient, config: MultisigClientConfig) {
     this.midenClient = midenClient;
     this.midenRpcEndpoint = requireMidenRpcEndpoint(config?.midenRpcEndpoint);
     this.proverConfig = resolveProverConfig(config?.prover, midenClient.defaultProver);
+    this.rpcConfig = resolveRpcConfig(config?.rpc);
     this._guardianClient = new GuardianHttpClient(
       requireConfigValue('guardianEndpoint', config?.guardianEndpoint),
     );
@@ -176,6 +185,7 @@ export class MultisigClient {
       undefined,
       this.midenRpcEndpoint,
       this.proverConfig,
+      this.rpcConfig,
     );
   }
 
@@ -229,6 +239,7 @@ export class MultisigClient {
       accountId,
       this.midenRpcEndpoint,
       this.proverConfig,
+      this.rpcConfig,
     );
   }
 }

package/src/index.ts

@@ -50,6 +50,7 @@ export {
   type RecoveredAccount,
 } from './client.js';
 export type { ProverConfig, ProverRetryPolicy } from './prover/config.js';
+export type { RpcConfig, RpcRetryPolicy } from './rpc/config.js';
 export { lookupAuthDigest } from './lookupAuth.js';
 export { Multisig, type AccountState } from './multisig.js';
 export { AccountInspector, type DetectedMultisigConfig, type VaultBalance } from './inspector.js';

package/src/multisig.test.ts

@@ -2293,6 +2293,7 @@ describe('Multisig', () => {
         ok: false,
         status: 404,
         statusText: 'Not Found',
+        headers: new Headers(),
         // Feature 009: only a conforming { code, message, meta } envelope is
         // folded into the error message; raw text bodies are dropped.
         text: async () =>

package/src/multisig.ts

@@ -88,6 +88,11 @@ import {
   type ResolvedProverConfig,
 } from './prover/config.js';
 import { ProverWorkflow } from './prover/workflow.js';
+import {
+  resolveRpcConfig,
+  type ResolvedRpcConfig,
+} from './rpc/config.js';
+import { retryRpcRead } from './rpc/retry.js';
 
 /**
  * Result of fetching account state from GUARDIAN.
@@ -151,6 +156,7 @@ export class Multisig {
   private readonly midenClient: MidenClient;
   private readonly rawClientPromise: Promise<WasmWebClient>;
   private readonly proverWorkflow: ProverWorkflow;
+  private readonly rpcConfig: ResolvedRpcConfig;
   private readonly _accountId: string;
   private readonly midenRpcEndpoint: string;
   private proposals: Map<string, Proposal> = new Map();
@@ -164,6 +170,7 @@ export class Multisig {
     accountId: string | undefined,
     midenRpcEndpoint: string,
     proverConfig?: ResolvedProverConfig,
+    rpcConfig?: ResolvedRpcConfig,
   ) {
     this.account = account;
     this.threshold = config.threshold;
@@ -183,6 +190,7 @@ export class Multisig {
       this.midenClient,
       proverConfig ?? resolveProverConfig(undefined, getTransactionProver(midenClient)),
     );
+    this.rpcConfig = rpcConfig ?? resolveRpcConfig(undefined);
   }
 
   private getMidenRpcEndpoint(): string {
@@ -238,7 +246,11 @@ export class Multisig {
    */
   async getStoreAccount(): Promise<Account> {
     const webClient = await this.getRawClient();
-    return (await webClient.getAccount(AccountId.fromHex(this._accountId))) ?? this.account;
+    const stored = await retryRpcRead(
+      () => webClient.getAccount(AccountId.fromHex(this._accountId)),
+      this.rpcConfig,
+    );
+    return stored ?? this.account;
   }
 
   /**
@@ -326,7 +338,10 @@ export class Multisig {
     const state = await this.fetchState();
     const accountId = AccountId.fromHex(this._accountId);
     const webClient = await this.getRawClient();
-    const localAccount = await webClient.getAccount(accountId);
+    const localAccount = await retryRpcRead(
+      () => webClient.getAccount(accountId),
+      this.rpcConfig,
+    );
     let accountForConfigRefresh: Account | null = localAccount ?? null;
 
     const guardianCommitment = normalizeHexWord(state.commitment);
@@ -351,7 +366,10 @@ export class Multisig {
   async verifyStateCommitment(): Promise<AccountStateVerificationResult> {
     const accountId = AccountId.fromHex(this._accountId);
     const webClient = await this.getRawClient();
-    const localAccount = await webClient.getAccount(accountId);
+    const localAccount = await retryRpcRead(
+      () => webClient.getAccount(accountId),
+      this.rpcConfig,
+    );
 
     if (!localAccount) {
       throw new Error(
@@ -434,7 +452,10 @@ export class Multisig {
     const rpcClient = new RpcClient(new Endpoint(this.getMidenRpcEndpoint()));
 
     try {
-      const accountDetails = await rpcClient.getAccountDetails(accountId);
+      const accountDetails = await retryRpcRead(
+        () => rpcClient.getAccountDetails(accountId),
+        this.rpcConfig,
+      );
       // If the account is not found or its commitment is zero, means that the account is not deployed yet
       if (!accountDetails) {
         return null;
@@ -1228,15 +1249,25 @@ export class Multisig {
           ...switchDelta,
           deltaPayload: switchDelta.deltaPayload.txSummary,
         });
-      } catch {
-        // best-effort; see above
+      } catch (error) {
+        // Best-effort — see above — but the failure must be visible: a
+        // silently lost push leaves the pre-switch GUARDIAN serving this
+        // account (split-brain, issue #305) with nothing to diagnose by.
+        console.warn(
+          'SwitchGuardian delta push to the pre-switch GUARDIAN failed; it ' +
+            'will keep serving this account until reconciliation',
+          error,
+        );
       }
 
       try {
         const webClient = await this.getRawClient();
-        await webClient.syncState();
+        await retryRpcRead(() => webClient.syncState(), this.rpcConfig);
 
-        const updatedAccount = await webClient.getAccount(accountId);
+        const updatedAccount = await retryRpcRead(
+          () => webClient.getAccount(accountId),
+          this.rpcConfig,
+        );
         if (!updatedAccount) {
           throw new Error(
             `Updated account ${this._accountId} is missing from local client`

package/src/prover/errors.test.ts

@@ -50,4 +50,12 @@ describe('isTransientProverError', () => {
     expect(isTransientProverError({ code: 14, message: 'unavailable' })).toBe(true);
     expect(isTransientProverError({ code: 3, message: 'timeout text' })).toBe(false);
   });
+
+  it('reads grpc code wording out of plain message text', () => {
+    expect(isTransientProverError(new Error('grpc code: NotFound'))).toBe(false);
+    expect(
+      isTransientProverError(new Error('grpc code: Internal; nested timeout')),
+    ).toBe(false);
+    expect(isTransientProverError(new Error('grpc code: Unavailable'))).toBe(true);
+  });
 });