@openzeppelin/guardian-client 0.16.1 → 0.17.0-rc.1

package/dist/types.d.ts

@@ -89,6 +89,17 @@ export interface ProposalMetadata {
     amount?: string;
     /** P2ID note visibility, "public" or "private" (issue #322). Absent => public. */
     noteType?: string;
+    /**
+     * Base64-serialized Miden `ChainAnchor` pinning the reference block the
+     * proposal's transaction summary was built at. Since protocol 0.16 the
+     * signed summary binds the reference block commitment, so cosigners and the
+     * executor need this anchor to reproduce the summary the proposer signed.
+     */
+    chainAnchor?: string;
+    /** P2IDE reclaim block height (issue #366). Presence of either height means a P2IDE note. */
+    reclaimHeight?: number;
+    /** P2IDE timelock block height (issue #366). */
+    timelockHeight?: number;
 }
 export interface DeltaObject {
     accountId: string;
@@ -229,4 +240,75 @@ export interface LookupAccount {
 export interface LookupResponse {
     accounts: LookupAccount[];
 }
+/** Note classification decoded from the on-chain note script. */
+export type HistoryNoteTag = 'p2id' | 'p2ide' | 'pswap' | 'mint' | 'burn' | 'custom';
+/** On-chain note visibility from the note metadata. */
+export type HistoryNoteVisibility = 'public' | 'private';
+/** Which section of the persisted payload failed to decode. */
+export type HistoryDecodeSection = 'tx_summary' | 'metadata' | 'input_notes' | 'output_notes' | 'vault' | 'storage';
+/**
+ * Delta lifecycle status of a history entry. Only `canonical` is
+ * emitted today; the set widens if the feed gains a status filter.
+ */
+export type HistoryEntryStatus = 'canonical';
+/**
+ * One decoded asset inside a history note. `amount` is a base-10
+ * string for fungible assets, absent for non-fungible ones.
+ */
+export interface HistoryNoteAsset {
+    assetId: string;
+    kind: 'fungible' | 'non_fungible';
+    amount?: string;
+}
+/**
+ * One decoded note attached to a history entry. `sender` / `recipient`
+ * are account IDs when the note script exposes them.
+ */
+export interface HistoryNote {
+    noteId: string;
+    tag: HistoryNoteTag;
+    /** On-chain visibility from the note metadata. */
+    noteType: HistoryNoteVisibility;
+    assets: HistoryNoteAsset[];
+    sender?: string;
+    recipient?: string;
+}
+/**
+ * Why a history entry's note sections are empty: the persisted payload
+ * could not be decoded server-side (schema drift). The entry itself is
+ * still returned.
+ */
+export interface HistoryDecodeWarning {
+    section: HistoryDecodeSection;
+    reason: string;
+}
+/** One canonical transaction in an account's history (issue #413). */
+export interface HistoryEntry {
+    nonce: number;
+    /** Delta lifecycle status; always `canonical` today. */
+    status: HistoryEntryStatus;
+    /** RFC 3339 UTC timestamp at which the delta became canonical. */
+    timestamp: string;
+    /**
+     * Account commitment after this transaction; `undefined` when the
+     * stored row predates commitment recording.
+     */
+    newCommitment?: string;
+    inputNotes: HistoryNote[];
+    outputNotes: HistoryNote[];
+    decodeWarnings: HistoryDecodeWarning[];
+}
+/** One page of canonical delta history, newest-first by nonce. */
+export interface HistoryPage {
+    entries: HistoryEntry[];
+    /** Opaque resume token; `undefined` when the feed is exhausted. */
+    nextCursor?: string;
+}
+/** Options for `getDeltaHistory`. */
+export interface HistoryOptions {
+    /** Page size in `[1, 500]`; server default 50 when omitted. */
+    limit?: number;
+    /** Opaque `nextCursor` from a previous page. */
+    cursor?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/guardian-client",
-  "version": "0.16.1",
+  "version": "0.17.0-rc.1",
   "description": "TypeScript HTTP client for Guardian server",
   "repository": {
     "type": "git",

package/src/conversion.test.ts

@@ -454,6 +454,21 @@ describe('conversion', () => {
       expect(result.salt).toBe(original.salt);
     });
 
+    it('chainAnchor survives roundtrip as chain_anchor on the wire', () => {
+      const original: ProposalMetadata = {
+        proposalType: 'add_signer',
+        targetThreshold: 2,
+        signerCommitments: ['0xabc'],
+        chainAnchor: 'bW9jay1jaGFpbi1hbmNob3I=',
+      };
+
+      const server = toServerProposalMetadata(original);
+      expect(server.chain_anchor).toBe('bW9jay1jaGFpbi1hbmNob3I=');
+
+      const result = fromServerProposalMetadata(server);
+      expect(result.chainAnchor).toBe('bW9jay1jaGFpbi1hbmNob3I=');
+    });
+
     it('p2id noteType survives roundtrip as note_type on the wire (issue #322)', () => {
       const original: ProposalMetadata = {
         proposalType: 'p2id',
@@ -469,5 +484,24 @@ describe('conversion', () => {
       const result = fromServerProposalMetadata(server);
       expect(result.noteType).toBe('private');
     });
+
+    it('p2ide heights survive roundtrip as reclaim_height/timelock_height on the wire (issue #366)', () => {
+      const original: ProposalMetadata = {
+        proposalType: 'p2id',
+        recipientId: '0xrecipient',
+        faucetId: '0xfaucet',
+        amount: '1000',
+        reclaimHeight: 12345,
+        timelockHeight: 700,
+      };
+
+      const server = toServerProposalMetadata(original);
+      expect(server.reclaim_height).toBe(12345);
+      expect(server.timelock_height).toBe(700);
+
+      const result = fromServerProposalMetadata(server);
+      expect(result.reclaimHeight).toBe(12345);
+      expect(result.timelockHeight).toBe(700);
+    });
   });
 });

package/src/conversion.ts

@@ -6,6 +6,9 @@ import type {
   DeltaProposalRequest,
   DeltaStatus,
   ExecutionDelta,
+  HistoryEntry,
+  HistoryNote,
+  HistoryPage,
   LookupResponse,
   ProposalSignature,
   ProposalMetadata,
@@ -20,6 +23,9 @@ import type {
   ServerDeltaProposalRequest,
   ServerDeltaStatus,
   ServerExecutionDelta,
+  ServerHistoryEntry,
+  ServerHistoryNote,
+  ServerHistoryPage,
   ServerLookupResponse,
   ServerProposalSignature,
   ServerProposalMetadata,
@@ -109,6 +115,9 @@ export function fromServerProposalMetadata(server: ServerProposalMetadata): Prop
     faucetId: server.faucet_id,
     amount: server.amount,
     noteType: server.note_type,
+    chainAnchor: server.chain_anchor,
+    reclaimHeight: server.reclaim_height,
+    timelockHeight: server.timelock_height,
   };
 }
 
@@ -221,6 +230,9 @@ export function toServerProposalMetadata(meta: ProposalMetadata): ServerProposal
     faucet_id: meta.faucetId,
     amount: meta.amount,
     note_type: meta.noteType,
+    chain_anchor: meta.chainAnchor,
+    reclaim_height: meta.reclaimHeight,
+    timelock_height: meta.timelockHeight,
   };
 }
 
@@ -266,3 +278,37 @@ export function toServerExecutionDelta(delta: ExecutionDelta): ServerExecutionDe
     status: toServerDeltaStatus(delta.status),
   };
 }
+
+function fromServerHistoryNote(server: ServerHistoryNote): HistoryNote {
+  return {
+    noteId: server.note_id,
+    tag: server.tag,
+    noteType: server.note_type,
+    assets: server.assets.map((asset) => ({
+      assetId: asset.asset_id,
+      kind: asset.kind,
+      amount: asset.amount,
+    })),
+    sender: server.sender,
+    recipient: server.recipient,
+  };
+}
+
+export function fromServerHistoryEntry(server: ServerHistoryEntry): HistoryEntry {
+  return {
+    nonce: server.nonce,
+    status: server.status,
+    timestamp: server.timestamp,
+    newCommitment: server.new_commitment ?? undefined,
+    inputNotes: server.input_notes.map(fromServerHistoryNote),
+    outputNotes: server.output_notes.map(fromServerHistoryNote),
+    decodeWarnings: server.decode_warnings ?? [],
+  };
+}
+
+export function fromServerHistoryPage(server: ServerHistoryPage): HistoryPage {
+  return {
+    entries: server.items.map(fromServerHistoryEntry),
+    nextCursor: server.next_cursor ?? undefined,
+  };
+}

package/src/error-codes.ts

@@ -15,6 +15,7 @@ export const GUARDIAN_ERROR_CODES = [
   'account_paused',
   'account_released',
   'authentication_failed',
+  'authentication_replay',
   'authorization_failed',
   'candidate_landed',
   'commitment_mismatch',

package/src/http.test.ts

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs';
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { GuardianHttpClient, GuardianHttpError } from './http.js';
 import type { Signer, ConfigureResponse, StateObject, DeltaObject, DeltaProposalResponse } from './types.js';
@@ -60,6 +61,7 @@ describe('GuardianHttpClient', () => {
     it('should throw GuardianHttpError on non-ok response', async () => {
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 500,
         statusText: 'Internal Server Error',
         text: async () => 'Server error message',
@@ -77,6 +79,7 @@ describe('GuardianHttpClient', () => {
     it('exposes code and released_at from a GUARDIAN_ACCOUNT_RELEASED envelope', async () => {
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 409,
         statusText: 'Conflict',
         text: async () =>
@@ -98,6 +101,7 @@ describe('GuardianHttpClient', () => {
     it('exposes code without releasedAt for other envelope errors', async () => {
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 404,
         statusText: 'Not Found',
         text: async () =>
@@ -152,6 +156,7 @@ describe('GuardianHttpClient', () => {
     it('should throw GuardianHttpError on non-ok response', async () => {
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 503,
         statusText: 'Service Unavailable',
         text: async () => 'down',
@@ -227,6 +232,52 @@ describe('GuardianHttpClient', () => {
 
       await expect(client.configure(request)).rejects.toThrow('No signer configured');
     });
+
+    it('retries a configure replay rejection with fresh authentication', async () => {
+      client.setSigner(mockSigner);
+      const signRequest = mockSigner.signRequest;
+      if (!signRequest) {
+        throw new Error('test signer must implement signRequest');
+      }
+      const signRequestMock = vi.mocked(signRequest);
+      signRequestMock.mockImplementation(
+        (_accountId, timestamp) => `0x${timestamp.toString(16).padStart(128, '0')}`
+      );
+      mockFetch
+        .mockResolvedValueOnce({
+          ok: false,
+          headers: new Headers(),
+          status: 401,
+          statusText: 'Unauthorized',
+          text: async () =>
+            JSON.stringify({
+              code: 'authentication_replay',
+              message: 'Guardian received this request out of order. Please try again.',
+              meta: { retryable: true },
+            }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({ success: true, message: 'Account configured' }),
+        });
+
+      await client.configure({
+        accountId: '0x' + 'd'.repeat(30),
+        auth: {
+          MidenFalconRpo: {
+            cosigner_commitments: ['0x' + 'e'.repeat(64)],
+          },
+        },
+        initialState: { data: 'base64data', accountId: '0x' + 'd'.repeat(30) },
+      });
+
+      expect(mockFetch).toHaveBeenCalledTimes(2);
+      const timestamps = mockFetch.mock.calls.map((call) =>
+        Number((call[1].headers as Record<string, string>)['x-timestamp'])
+      );
+      expect(timestamps[1]).toBeGreaterThan(timestamps[0]);
+      expect(signRequestMock).toHaveBeenCalledTimes(2);
+    });
   });
 
   describe('getState', () => {
@@ -497,6 +548,7 @@ describe('GuardianHttpClient', () => {
 
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 409,
         statusText: 'Conflict',
         text: async () =>
@@ -521,6 +573,7 @@ describe('GuardianHttpClient', () => {
 
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 404,
         statusText: 'Not Found',
         text: async () =>
@@ -612,6 +665,7 @@ describe('GuardianHttpClient', () => {
 
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 404,
         statusText: 'Not Found',
         text: async () =>
@@ -840,6 +894,136 @@ describe('GuardianHttpClient', () => {
     });
   });
 
+  // --- getDeltaHistory (issue #413) -----
+
+  describe('getDeltaHistory', () => {
+    const accountId = '0x' + 'a'.repeat(30);
+
+    const serverPage = {
+      items: [
+        {
+          nonce: 5,
+          status: 'canonical',
+          timestamp: '2026-08-01T12:00:05Z',
+          new_commitment: '0x' + 'c'.repeat(64),
+          input_notes: [],
+          output_notes: [
+            {
+              note_id: '0x' + 'd'.repeat(64),
+              tag: 'p2id',
+              note_type: 'public',
+              assets: [
+                { asset_id: '0x' + 'e'.repeat(30), kind: 'fungible', amount: '100' },
+              ],
+              sender: accountId,
+              recipient: '0x' + 'f'.repeat(30),
+            },
+          ],
+        },
+        {
+          nonce: 4,
+          status: 'canonical',
+          timestamp: '2026-08-01T12:00:04Z',
+          new_commitment: null,
+          input_notes: [],
+          output_notes: [],
+          decode_warnings: [{ section: 'tx_summary', reason: 'malformed_tx_summary' }],
+        },
+      ],
+      next_cursor: 'opaque-cursor',
+    };
+
+    it('returns a camelCase page and maps notes and warnings', async () => {
+      client.setSigner(mockSigner);
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => serverPage,
+      });
+
+      const result = await client.getDeltaHistory(accountId, { limit: 2 });
+
+      expect(result.nextCursor).toBe('opaque-cursor');
+      expect(result.entries).toHaveLength(2);
+      expect(result.entries[0].nonce).toBe(5);
+      expect(result.entries[0].newCommitment).toBe('0x' + 'c'.repeat(64));
+      expect(result.entries[0].decodeWarnings).toEqual([]);
+      expect(result.entries[0].status).toBe('canonical');
+      expect(result.entries[0].outputNotes[0]).toEqual({
+        noteId: '0x' + 'd'.repeat(64),
+        tag: 'p2id',
+        noteType: 'public',
+        assets: [{ assetId: '0x' + 'e'.repeat(30), kind: 'fungible', amount: '100' }],
+        sender: accountId,
+        recipient: '0x' + 'f'.repeat(30),
+      });
+      expect(result.entries[1].newCommitment).toBeUndefined();
+      expect(result.entries[1].decodeWarnings).toEqual([
+        { section: 'tx_summary', reason: 'malformed_tx_summary' },
+      ]);
+
+      expect(mockFetch).toHaveBeenCalledWith(
+        `http://localhost:3000/delta/history?account_id=${accountId}&limit=2`,
+        expect.objectContaining({
+          method: 'GET',
+          headers: expect.objectContaining({
+            'x-pubkey': mockSigner.publicKey,
+          }),
+        })
+      );
+    });
+
+    it('signs the same key set it sends: omitted options stay omitted', async () => {
+      client.setSigner(mockSigner);
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ items: [], next_cursor: null }),
+      });
+
+      const result = await client.getDeltaHistory(accountId);
+
+      expect(result.entries).toEqual([]);
+      expect(result.nextCursor).toBeUndefined();
+      expect(mockFetch).toHaveBeenCalledWith(
+        `http://localhost:3000/delta/history?account_id=${accountId}`,
+        expect.anything()
+      );
+      // The signed payload must byte-match the server's canonical JSON
+      // of its query struct: only account_id when limit/cursor are
+      // omitted, and limit as a string when present.
+      const signRequest = mockSigner.signRequest as ReturnType<typeof vi.fn>;
+      const lastCall = signRequest.mock.calls.at(-1);
+      if (lastCall === undefined) {
+        throw new Error('Expected signRequest to be called');
+      }
+      const authPayload = lastCall[2];
+      expect(authPayload.toCanonicalJson()).toBe(JSON.stringify({ account_id: accountId }));
+    });
+
+    it('passes the cursor through query and signed payload', async () => {
+      client.setSigner(mockSigner);
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ items: [], next_cursor: null }),
+      });
+
+      await client.getDeltaHistory(accountId, { limit: 10, cursor: 'abc123' });
+
+      expect(mockFetch).toHaveBeenCalledWith(
+        `http://localhost:3000/delta/history?account_id=${accountId}&limit=10&cursor=abc123`,
+        expect.anything()
+      );
+      const signRequest = mockSigner.signRequest as ReturnType<typeof vi.fn>;
+      const lastCall = signRequest.mock.calls.at(-1);
+      if (lastCall === undefined) {
+        throw new Error('Expected signRequest to be called');
+      }
+      const authPayload = lastCall[2];
+      expect(authPayload.toCanonicalJson()).toBe(
+        JSON.stringify({ account_id: accountId, cursor: 'abc123', limit: '10' })
+      );
+    });
+  });
+
   // --- lookupAccountByKeyCommitment -----
 
   describe('lookupAccountByKeyCommitment', () => {
@@ -952,6 +1136,7 @@ describe('GuardianHttpClient', () => {
       client.setSigner(signer);
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 401,
         statusText: 'Unauthorized',
         text: async () => '{"code":"authentication_failed","error":"..."}',
@@ -1014,6 +1199,35 @@ describe('GuardianHttpError', () => {
     expect(plain.meta).toBeUndefined();
   });
 
+  describe('retry classification (shared fixture)', () => {
+    interface FixtureCase {
+      name: string;
+      body: Record<string, unknown> | null;
+      http: { status: number; retryAfterHeader?: string };
+      expected: { retryable: boolean; retryAfterSecs: number | null };
+    }
+
+    const fixture = JSON.parse(
+      readFileSync(
+        new URL('../../../fixtures/guardian-client/rate-limit-policy.json', import.meta.url),
+        'utf-8'
+      )
+    ) as { cases: FixtureCase[] };
+
+    it.each(fixture.cases.map((c) => [c.name, c] as const))('%s', (_name, c) => {
+      const body = c.body === null ? 'plain failure' : JSON.stringify(c.body);
+      const error = new GuardianHttpError(
+        c.http.status,
+        'error',
+        body,
+        c.http.retryAfterHeader ?? null
+      );
+
+      expect(error.isRetryable()).toBe(c.expected.retryable);
+      expect(error.retryAfterSecs()).toBe(c.expected.retryAfterSecs ?? undefined);
+    });
+  });
+
   describe('error envelope contract (account-paused path)', () => {
     let client: GuardianHttpClient;
     beforeEach(() => {
@@ -1040,6 +1254,7 @@ describe('GuardianHttpError', () => {
 
       mockFetch.mockResolvedValueOnce({
         ok: false,
+        headers: new Headers(),
         status: 409,
         statusText: 'Conflict',
         text: async () => JSON.stringify(envelope),
@@ -1075,19 +1290,16 @@ describe('GuardianHttpError', () => {
       expect(parsed.delta).toBeUndefined();
     });
 
-    it('surfaces 401 AUTHENTICATION_FAILED with a parseable error envelope', async () => {
+    it('does not retry a terminal 401 authentication_failed rejection', async () => {
       client.setSigner(mockSigner);
       const envelope = {
         code: 'authentication_failed',
-        message: 'Your session has expired. Please sign in again.',
+        message: 'Guardian could not authenticate this request.',
         meta: { retryable: false },
       };
-      // `authentication_failed` triggers the replay-retry path (the specific
-      // "Replay attack" detail is sanitized off the wire in feature 009, so we
-      // retry on the auth code). Use a persistent mock so the retries resolve
-      // and the final attempt throws the typed error.
       mockFetch.mockResolvedValue({
         ok: false,
+        headers: new Headers(),
         status: 401,
         statusText: 'Unauthorized',
         text: async () => JSON.stringify(envelope),
@@ -1106,9 +1318,103 @@ describe('GuardianHttpError', () => {
       expect(e.status).toBe(401);
       expect(e.code).toBe('authentication_failed');
       expect(typeof e.userMessage).toBe('string');
+      expect(mockFetch).toHaveBeenCalledTimes(1);
       const parsed = JSON.parse(e.body);
       expect(parsed.success).toBeUndefined();
       expect(parsed.delta).toBeUndefined();
     });
+
+    it('retries an authentication_replay rejection with a fresh timestamp and signature', async () => {
+      client.setSigner(mockSigner);
+      const signRequest = mockSigner.signRequest;
+      if (!signRequest) {
+        throw new Error('test signer must implement signRequest');
+      }
+      const signRequestMock = vi.mocked(signRequest);
+      signRequestMock.mockClear();
+      const signatureForTimestamp = (_accountId: string, timestamp: number) =>
+        `0x${timestamp.toString(16).padStart(128, '0')}`;
+      signRequestMock
+        .mockImplementationOnce(signatureForTimestamp)
+        .mockImplementationOnce(signatureForTimestamp);
+      const replayResponse = {
+        ok: false,
+        headers: new Headers(),
+        status: 401,
+        statusText: 'Unauthorized',
+        text: async () =>
+          JSON.stringify({
+            code: 'authentication_replay',
+            message: 'Guardian received this request out of order. Please try again.',
+            meta: { retryable: true },
+          }),
+      };
+      const serverResponse = {
+        delta: {
+          account_id: '0x' + 'a'.repeat(30),
+          nonce: 1,
+          prev_commitment: '0x' + 'b'.repeat(64),
+          delta_payload: { tx_summary: { data: '' }, signatures: [] },
+          status: {
+            status: 'pending',
+            timestamp: '2024-01-01T00:00:00Z',
+            proposer_id: '0x' + 'c'.repeat(64),
+            cosigner_sigs: [],
+          },
+        },
+        commitment: '0x' + 'd'.repeat(64),
+      };
+      mockFetch
+        .mockResolvedValueOnce(replayResponse)
+        .mockResolvedValueOnce({ ok: true, json: async () => serverResponse });
+
+      const result = await client.pushDeltaProposal({
+        accountId: '0x' + 'a'.repeat(30),
+        nonce: 1,
+        deltaPayload: { txSummary: { data: '' }, signatures: [] },
+      });
+
+      expect(result.commitment).toBe('0x' + 'd'.repeat(64));
+      expect(mockFetch).toHaveBeenCalledTimes(2);
+      const timestamps = mockFetch.mock.calls.map((call) =>
+        Number((call[1].headers as Record<string, string>)['x-timestamp'])
+      );
+      const signatures = mockFetch.mock.calls.map(
+        (call) => (call[1].headers as Record<string, string>)['x-signature']
+      );
+      expect(timestamps[1]).toBeGreaterThan(timestamps[0]);
+      expect(signatures[1]).not.toBe(signatures[0]);
+      expect(signRequestMock).toHaveBeenCalledTimes(2);
+    });
+
+    it('gives up after exhausting the bounded replay retry budget', async () => {
+      client.setSigner(mockSigner);
+      mockFetch.mockResolvedValue({
+        ok: false,
+        headers: new Headers(),
+        status: 401,
+        statusText: 'Unauthorized',
+        text: async () =>
+          JSON.stringify({
+            code: 'authentication_replay',
+            message: 'Guardian received this request out of order. Please try again.',
+            meta: { retryable: true },
+          }),
+      });
+
+      const error = await client
+        .pushDeltaProposal({
+          accountId: '0x' + 'a'.repeat(30),
+          nonce: 1,
+          deltaPayload: { txSummary: { data: '' }, signatures: [] },
+        })
+        .catch((e) => e as GuardianHttpError);
+
+      expect(error).toBeInstanceOf(GuardianHttpError);
+      const e = error as GuardianHttpError;
+      expect(e.code).toBe('authentication_replay');
+      expect(e.meta?.retryable).toBe(true);
+      expect(mockFetch).toHaveBeenCalledTimes(3);
+    });
   });
 });